@mui/x-charts 9.7.0 → 9.9.0

package/internals/createGetBarDimensions.mjs

@@ -1,5 +1,8 @@
 import { findMinMax } from "./findMinMax.mjs";
 import { getBandSize } from "./getBandSize.mjs";
+
+/** Minimum on-screen gap (px) kept between merged (sampled) bars so they stay distinguishable. */
+const MIN_SAMPLED_BAR_GAP_PX = 2;
 function shouldInvertStartCoordinate(verticalLayout, baseValue, reverse) {
   const isVerticalAndPositive = verticalLayout && baseValue > 0;
   const isHorizontalAndNegative = !verticalLayout && baseValue < 0;
@@ -52,4 +55,46 @@ export function createGetBarDimensions(params) {
       width: verticalLayout ? barWidth : barSize
     };
   };
+}
+
+/** Like {@link createGetBarDimensions}, but for a sampled bucket spanning several categories. */
+export function createGetBucketBarDimensions(params) {
+  const {
+    verticalLayout,
+    xAxisConfig,
+    yAxisConfig,
+    series,
+    numberOfGroups
+  } = params;
+  const baseScaleConfig = verticalLayout ? xAxisConfig : yAxisConfig;
+  const baseScale = baseScaleConfig.scale;
+  const bandwidth = baseScale.bandwidth();
+  const step = baseScale.step();
+  const valueScale = verticalLayout ? yAxisConfig.scale : xAxisConfig.scale;
+  return function getBucketBarDimensions(startIndex, endIndex, min, max, groupIndex) {
+    const spanStart = baseScale(baseScaleConfig.data[startIndex]);
+    const bucketCount = endIndex - startIndex + 1;
+    const bucketStride = bucketCount * step;
+
+    // Keep the gap between buckets proportional to the bucket (same ratio as an unsampled chart),
+    // but never thinner than MIN_SAMPLED_BAR_GAP_PX so it stays visible at every level and zoom.
+    const gap = Math.min(bucketStride / 2, Math.max(bucketCount * (step - bandwidth), MIN_SAMPLED_BAR_GAP_PX));
+    const {
+      barWidth,
+      offset
+    } = getBandSize(bucketStride - gap, numberOfGroups, baseScaleConfig.barGapRatio);
+    const barOffset = groupIndex * (barWidth + offset);
+    const valueCoordinates = [valueScale(min), valueScale(max)];
+    const [minValueCoord, maxValueCoord] = findMinMax(valueCoordinates).map(v => Math.round(v));
+    let barSize = maxValueCoord - minValueCoord;
+    if (!series.hidden && barSize > 0) {
+      barSize = Math.max(series.minBarSize, barSize);
+    }
+    return {
+      x: verticalLayout ? spanStart + barOffset : minValueCoord,
+      y: verticalLayout ? minValueCoord : spanStart + barOffset,
+      height: verticalLayout ? barSize : barWidth,
+      width: verticalLayout ? barWidth : barSize
+    };
+  };
 }

package/internals/geometry.js

@@ -18,7 +18,7 @@ const ANGLE_APPROX = 5; // Angle (in deg) for which we approximate the rectangle
  */
 function getMinXTranslation(width, height, angle = 0) {
   if (process.env.NODE_ENV !== 'production') {
-    if (angle > 90 && angle < -90) {
+    if (angle > 90 || angle < -90) {
       (0, _warning.warnOnce)([`MUI X Charts: It seems you applied an angle larger than 90° or smaller than -90° to an axis text.`, `This could cause some text overlapping.`, `If you encounter a use case where it's needed, please open an issue.`]);
     }
   }

package/internals/geometry.mjs

@@ -12,7 +12,7 @@ const ANGLE_APPROX = 5; // Angle (in deg) for which we approximate the rectangle
  */
 export function getMinXTranslation(width, height, angle = 0) {
   if (process.env.NODE_ENV !== 'production') {
-    if (angle > 90 && angle < -90) {
+    if (angle > 90 || angle < -90) {
       warnOnce([`MUI X Charts: It seems you applied an angle larger than 90° or smaller than -90° to an axis text.`, `This could cause some text overlapping.`, `If you encounter a use case where it's needed, please open an issue.`]);
     }
   }

package/internals/getGroupingConfig.d.mts

@@ -0,0 +1,6 @@
+import type { AxisGroup } from "../models/axis.mjs";
+export declare const getGroupingConfig: (groups: AxisGroup[], groupIndex: number, tickSize: number | undefined, computedGroupTickSizes?: number[]) => {
+  tickSize: number;
+  getValue: (value: any, dataIndex: number) => string | number | Date;
+  tickLabelStyle?: import("../index.mjs").ChartsTextProps["style"];
+};

package/internals/getGroupingConfig.d.ts

@@ -0,0 +1,6 @@
+import type { AxisGroup } from "../models/axis.js";
+export declare const getGroupingConfig: (groups: AxisGroup[], groupIndex: number, tickSize: number | undefined, computedGroupTickSizes?: number[]) => {
+  tickSize: number;
+  getValue: (value: any, dataIndex: number) => string | number | Date;
+  tickLabelStyle?: import("../index.js").ChartsTextProps["style"];
+};

package/internals/getGroupingConfig.js

@@ -0,0 +1,20 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getGroupingConfig = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+const DEFAULT_GROUPING_CONFIG = {
+  tickSize: 6
+};
+const getGroupingConfig = (groups, groupIndex, tickSize, computedGroupTickSizes) => {
+  const config = groups[groupIndex] ?? {};
+  const defaultTickSize = tickSize ?? DEFAULT_GROUPING_CONFIG.tickSize;
+  const calculatedTickSize = defaultTickSize * groupIndex * 2 + defaultTickSize;
+  return (0, _extends2.default)({}, DEFAULT_GROUPING_CONFIG, config, {
+    tickSize: computedGroupTickSizes?.[groupIndex] ?? config.tickSize ?? calculatedTickSize
+  });
+};
+exports.getGroupingConfig = getGroupingConfig;

package/internals/getGroupingConfig.mjs

@@ -0,0 +1,12 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+const DEFAULT_GROUPING_CONFIG = {
+  tickSize: 6
+};
+export const getGroupingConfig = (groups, groupIndex, tickSize, computedGroupTickSizes) => {
+  const config = groups[groupIndex] ?? {};
+  const defaultTickSize = tickSize ?? DEFAULT_GROUPING_CONFIG.tickSize;
+  const calculatedTickSize = defaultTickSize * groupIndex * 2 + defaultTickSize;
+  return _extends({}, DEFAULT_GROUPING_CONFIG, config, {
+    tickSize: computedGroupTickSizes?.[groupIndex] ?? config.tickSize ?? calculatedTickSize
+  });
+};

package/internals/index.d.mts

@@ -20,6 +20,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";
 export * from "./plugins/corePlugins/useChartId/index.mjs";
@@ -37,8 +38,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/index.d.ts

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

package/internals/index.js

@@ -1,7 +1,6 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -20,8 +19,6 @@ var _exportNames = {
   useRadarChartProps: true,
   useSkipAnimation: true,
   useRegisterPointerInteractions: true,
-  useGeoProjectionSelectors: true,
-  useGeoProjectionTypes: true,
   getCartesianAxisTriggerTooltip: true,
   getCartesianAxisIndex: true,
   getRotationAxisIndex: true,
@@ -165,7 +162,6 @@ Object.defineProperty(exports, "useDrawingArea", {
     return _useDrawingArea.useDrawingArea;
   }
 });
-exports.useGeoProjectionTypes = exports.useGeoProjectionSelectors = void 0;
 Object.defineProperty(exports, "useInteractionItemProps", {
   enumerable: true,
   get: function () {
@@ -351,6 +347,18 @@ Object.keys(_seriesSelectorOfType).forEach(function (key) {
     }
   });
 });
+var _createGetBarDimensions = require("./createGetBarDimensions");
+Object.keys(_createGetBarDimensions).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _createGetBarDimensions[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _createGetBarDimensions[key];
+    }
+  });
+});
 var _useSkipAnimation = require("../hooks/useSkipAnimation");
 var _useRegisterPointerInteractions = require("./plugins/featurePlugins/shared/useRegisterPointerInteractions");
 var _useChartId = require("./plugins/corePlugins/useChartId");
@@ -533,10 +541,6 @@ Object.keys(_useChartBrush).forEach(function (key) {
     }
   });
 });
-var _useGeoProjectionSelectors = _interopRequireWildcard(require("./plugins/featurePlugins/useGeoProjection/useGeoProjection.selectors"));
-exports.useGeoProjectionSelectors = _useGeoProjectionSelectors;
-var _useGeoProjectionTypes = _interopRequireWildcard(require("./plugins/featurePlugins/useGeoProjection/useGeoProjection.types"));
-exports.useGeoProjectionTypes = _useGeoProjectionTypes;
 var _useChartItemClick = require("./plugins/featurePlugins/useChartItemClick");
 Object.keys(_useChartItemClick).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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,12 +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<"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,12 +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<"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/colorProcessor.types.d.mts

@@ -6,7 +6,7 @@ import type { ChartSeriesType } from "../../../../../models/seriesType/config.mj
  * Map data index to a color.
  * If dataIndex is not defined, it falls back to the series color when defined.
  */
-export type ColorGetter<SeriesType extends ChartSeriesType> = SeriesType extends 'pie' | 'funnel' ? (dataIndex: number) => string : SeriesType extends 'heatmap' ? (value: number | null) => string : SeriesType extends 'mapShape' ? (dataIndex?: number) => string | null : (dataIndex?: number) => string;
+export type ColorGetter<SeriesType extends ChartSeriesType> = SeriesType extends 'pie' | 'funnel' ? (dataIndex: number) => string : SeriesType extends 'heatmap' ? (value: number | null) => string : SeriesType extends 'mapShape' ? (name?: string) => string | null : (dataIndex?: number) => string;
 export type ColorProcessor<SeriesType extends ChartSeriesType> = (series: DefaultizedSeriesType<SeriesType>,
 /**
  * Either the x-axis or rotation-axis, depending on the coordinate system.

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

@@ -6,7 +6,7 @@ import type { ChartSeriesType } from "../../../../../models/seriesType/config.js
  * Map data index to a color.
  * If dataIndex is not defined, it falls back to the series color when defined.
  */
-export type ColorGetter<SeriesType extends ChartSeriesType> = SeriesType extends 'pie' | 'funnel' ? (dataIndex: number) => string : SeriesType extends 'heatmap' ? (value: number | null) => string : SeriesType extends 'mapShape' ? (dataIndex?: number) => string | null : (dataIndex?: number) => string;
+export type ColorGetter<SeriesType extends ChartSeriesType> = SeriesType extends 'pie' | 'funnel' ? (dataIndex: number) => string : SeriesType extends 'heatmap' ? (value: number | null) => string : SeriesType extends 'mapShape' ? (name?: string) => string | null : (dataIndex?: number) => string;
 export type ColorProcessor<SeriesType extends ChartSeriesType> = (series: DefaultizedSeriesType<SeriesType>,
 /**
  * Either the x-axis or rotation-axis, depending on the coordinate system.

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 } 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,7 +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 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<SeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<SeriesType>;
   keyboardFocusHandler?: KeyboardFocusHandler<SeriesType>;
   /**
@@ -50,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 } 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,7 +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 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<SeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<SeriesType>;
   keyboardFocusHandler?: KeyboardFocusHandler<SeriesType>;
   /**
@@ -50,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>;