@mui/x-charts 9.8.0 → 9.9.0

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

@@ -0,0 +1,93 @@
+import type { SeriesId } from "../../../../models/seriesType/common.js";
+import type { ChartSeriesType, ChartSeriesDefaultized, ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
+import type { ZoomData } from "./zoom.types.js";
+/** 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;
+}

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

@@ -6,6 +6,7 @@ import type { ZoomData, ZoomOptions, ZoomSliderPreviewOptions, ZoomSliderShowToo
 import type { UseChartInteractionSignature } from "../useChartInteraction/index.mjs";
 import type { ChartsAxisProps } from "../../../../ChartsAxis/index.mjs";
 import type { UseChartBrushSignature } from "../useChartBrush/index.mjs";
+import type { SamplingState } from "./sampling.types.mjs";
 /**
  * The axes' configuration after computing.
  * An axis in this state already contains a scale function and all the necessary properties to be rendered.
@@ -97,6 +98,10 @@ export interface UseChartCartesianAxisState {
     isInteracting: boolean;
     zoomData: readonly ZoomData[];
   };
+  /**
+   * @ignore - state populated by the useChartProSampling plugin
+   */
+  sampling?: SamplingState;
   cartesianAxis: {
     axesGap: number;
     x: DefaultedXAxis[];

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

@@ -6,6 +6,7 @@ import type { ZoomData, ZoomOptions, ZoomSliderPreviewOptions, ZoomSliderShowToo
 import type { UseChartInteractionSignature } from "../useChartInteraction/index.js";
 import type { ChartsAxisProps } from "../../../../ChartsAxis/index.js";
 import type { UseChartBrushSignature } from "../useChartBrush/index.js";
+import type { SamplingState } from "./sampling.types.js";
 /**
  * The axes' configuration after computing.
  * An axis in this state already contains a scale function and all the necessary properties to be rendered.
@@ -97,6 +98,10 @@ export interface UseChartCartesianAxisState {
     isInteracting: boolean;
     zoomData: readonly ZoomData[];
   };
+  /**
+   * @ignore - state populated by the useChartProSampling plugin
+   */
+  sampling?: SamplingState;
   cartesianAxis: {
     axesGap: number;
     x: DefaultedXAxis[];

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

@@ -1,3 +1,4 @@
+import type { SeriesItemIdentifierWithType } from "../../../../models/index.mjs";
 export declare const selectorChartsTooltipPointerItem: (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("./useChartTooltip.types.mjs").UseChartTooltipState<keyof import("../../../index.mjs").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
 }) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
@@ -6,13 +7,7 @@ export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import(
 }) => boolean;
 export declare const selectorChartsTooltipItem: (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("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
+}) => SeriesItemIdentifierWithType<keyof import("../../../index.mjs").ChartsSeriesConfig> | null;
 export declare const selectorChartsTooltipItemIsDefined: (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("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => boolean;
-export declare const selectorChartsTooltipItemPosition: (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("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}, placement: "bottom" | "left" | "right" | "top" | undefined) => {
-  x: number;
-  y: number;
-} | null;
+}) => boolean;

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

@@ -1,3 +1,4 @@
+import type { SeriesItemIdentifierWithType } from "../../../../models/index.js";
 export declare const selectorChartsTooltipPointerItem: (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("./useChartTooltip.types.js").UseChartTooltipState<keyof import("../../../index.js").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 }) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
@@ -6,13 +7,7 @@ export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import(
 }) => boolean;
 export declare const selectorChartsTooltipItem: (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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
+}) => SeriesItemIdentifierWithType<keyof import("../../../index.js").ChartsSeriesConfig> | null;
 export declare const selectorChartsTooltipItemIsDefined: (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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => boolean;
-export declare const selectorChartsTooltipItemPosition: (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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
-  cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}, placement: "bottom" | "left" | "right" | "top" | undefined) => {
-  x: number;
-  y: number;
-} | null;
+}) => boolean;

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.js

@@ -3,63 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItem = exports.selectorChartsTooltipItemPosition = exports.selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItem = void 0;
+exports.selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItem = exports.selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItem = void 0;
 var _store = require("@mui/x-internals/store");
-var _useChartSeries = require("../../corePlugins/useChartSeries");
-var _useChartSeriesConfig = require("../../corePlugins/useChartSeriesConfig");
-var _useChartCartesianAxisRendering = require("../useChartCartesianAxis/useChartCartesianAxisRendering.selectors");
 var _useChartKeyboardNavigation = require("../useChartKeyboardNavigation");
 var _useChartInteraction = require("../useChartInteraction/useChartInteraction.selectors");
-var _useChartDimensions = require("../../corePlugins/useChartDimensions/useChartDimensions.selectors");
-var _isCartesian = require("../../../isCartesian");
-var _useChartPolarAxis = require("../useChartPolarAxis/useChartPolarAxis.selectors");
 const selectTooltip = state => state.tooltip;
 const selectorChartsTooltipPointerItem = exports.selectorChartsTooltipPointerItem = (0, _store.createSelector)(selectTooltip, tooltip => tooltip?.item ?? null);
 const selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItemIsDefined = (0, _store.createSelector)(selectorChartsTooltipPointerItem, item => item !== null);
 const selectorChartsTooltipItem = exports.selectorChartsTooltipItem = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItem, _useChartKeyboardNavigation.selectorChartsKeyboardItem, (lastInteraction, pointerItem, keyboardItem) => lastInteraction === 'keyboard' ? keyboardItem : pointerItem ?? null);
-const selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItemIsDefined = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, _useChartKeyboardNavigation.selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);
-const selectorChartsTooltipAxisConfig = (0, _store.createSelectorMemoized)(selectorChartsTooltipItem, _useChartCartesianAxisRendering.selectorChartXAxis, _useChartCartesianAxisRendering.selectorChartYAxis, _useChartPolarAxis.selectorChartRotationAxis, _useChartPolarAxis.selectorChartRadiusAxis, _useChartSeries.selectorChartSeriesProcessed, function selectorChartsTooltipAxisConfig(identifier, {
-  axis: xAxis,
-  axisIds: xAxisIds
-}, {
-  axis: yAxis,
-  axisIds: yAxisIds
-}, rotationAxes, radiusAxes, series) {
-  if (!identifier) {
-    return {};
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return {};
-  }
-  const axesConfig = {
-    rotationAxes,
-    radiusAxes
-  };
-  const xAxisId = (0, _isCartesian.isCartesianSeries)(itemSeries) ? itemSeries.xAxisId ?? xAxisIds[0] : undefined;
-  const yAxisId = (0, _isCartesian.isCartesianSeries)(itemSeries) ? itemSeries.yAxisId ?? yAxisIds[0] : undefined;
-  if (xAxisId !== undefined) {
-    axesConfig.x = xAxis[xAxisId];
-  }
-  if (yAxisId !== undefined) {
-    axesConfig.y = yAxis[yAxisId];
-  }
-  return axesConfig;
-});
-const selectorChartsTooltipItemPosition = exports.selectorChartsTooltipItemPosition = (0, _store.createSelectorMemoized)(selectorChartsTooltipItem, _useChartDimensions.selectorChartDrawingArea, _useChartSeriesConfig.selectorChartSeriesConfig, _useChartSeries.selectorChartSeriesProcessed, _useChartSeries.selectorChartSeriesLayout, selectorChartsTooltipAxisConfig, function selectorChartsTooltipItemPosition(identifier, drawingArea, seriesConfig, series, seriesLayout, axesConfig, placement) {
-  if (!identifier) {
-    return null;
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return null;
-  }
-  return seriesConfig[itemSeries.type].tooltipItemPositionGetter?.({
-    series,
-    seriesLayout,
-    drawingArea,
-    axesConfig,
-    identifier,
-    placement: placement ?? 'top'
-  }) ?? null;
-});
+const selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItemIsDefined = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, _useChartKeyboardNavigation.selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.mjs

@@ -1,59 +1,8 @@
-import { createSelector, createSelectorMemoized } from '@mui/x-internals/store';
-import { selectorChartSeriesProcessed, selectorChartSeriesLayout } from "../../corePlugins/useChartSeries/index.mjs";
-import { selectorChartSeriesConfig } from "../../corePlugins/useChartSeriesConfig/index.mjs";
-import { selectorChartXAxis, selectorChartYAxis } from "../useChartCartesianAxis/useChartCartesianAxisRendering.selectors.mjs";
+import { createSelector } from '@mui/x-internals/store';
 import { selectorChartsKeyboardItem, selectorChartsHasFocusedItem } from "../useChartKeyboardNavigation/index.mjs";
 import { selectorChartsLastInteraction } from "../useChartInteraction/useChartInteraction.selectors.mjs";
-import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/useChartDimensions.selectors.mjs";
-import { isCartesianSeries } from "../../../isCartesian.mjs";
-import { selectorChartRadiusAxis, selectorChartRotationAxis } from "../useChartPolarAxis/useChartPolarAxis.selectors.mjs";
 const selectTooltip = state => state.tooltip;
 export const selectorChartsTooltipPointerItem = createSelector(selectTooltip, tooltip => tooltip?.item ?? null);
 export const selectorChartsTooltipPointerItemIsDefined = createSelector(selectorChartsTooltipPointerItem, item => item !== null);
 export const selectorChartsTooltipItem = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItem, selectorChartsKeyboardItem, (lastInteraction, pointerItem, keyboardItem) => lastInteraction === 'keyboard' ? keyboardItem : pointerItem ?? null);
-export const selectorChartsTooltipItemIsDefined = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);
-const selectorChartsTooltipAxisConfig = createSelectorMemoized(selectorChartsTooltipItem, selectorChartXAxis, selectorChartYAxis, selectorChartRotationAxis, selectorChartRadiusAxis, selectorChartSeriesProcessed, function selectorChartsTooltipAxisConfig(identifier, {
-  axis: xAxis,
-  axisIds: xAxisIds
-}, {
-  axis: yAxis,
-  axisIds: yAxisIds
-}, rotationAxes, radiusAxes, series) {
-  if (!identifier) {
-    return {};
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return {};
-  }
-  const axesConfig = {
-    rotationAxes,
-    radiusAxes
-  };
-  const xAxisId = isCartesianSeries(itemSeries) ? itemSeries.xAxisId ?? xAxisIds[0] : undefined;
-  const yAxisId = isCartesianSeries(itemSeries) ? itemSeries.yAxisId ?? yAxisIds[0] : undefined;
-  if (xAxisId !== undefined) {
-    axesConfig.x = xAxis[xAxisId];
-  }
-  if (yAxisId !== undefined) {
-    axesConfig.y = yAxis[yAxisId];
-  }
-  return axesConfig;
-});
-export const selectorChartsTooltipItemPosition = createSelectorMemoized(selectorChartsTooltipItem, selectorChartDrawingArea, selectorChartSeriesConfig, selectorChartSeriesProcessed, selectorChartSeriesLayout, selectorChartsTooltipAxisConfig, function selectorChartsTooltipItemPosition(identifier, drawingArea, seriesConfig, series, seriesLayout, axesConfig, placement) {
-  if (!identifier) {
-    return null;
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return null;
-  }
-  return seriesConfig[itemSeries.type].tooltipItemPositionGetter?.({
-    series,
-    seriesLayout,
-    drawingArea,
-    axesConfig,
-    identifier,
-    placement: placement ?? 'top'
-  }) ?? null;
-});
+export const selectorChartsTooltipItemIsDefined = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);

package/models/seriesType/config.d.mts

@@ -7,6 +7,10 @@ import type { DefaultizedRadarSeriesType, RadarItemIdentifier, RadarSeriesType }
 import type { SeriesColor, SeriesId } from "./common.mjs";
 import type { ChartsRadiusAxisProps, ChartsRotationAxisProps, ComputedXAxis, ComputedYAxis, PolarAxisDefaultized } from "../axis.mjs";
 import type { CommonHighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.mjs";
+/** Bar series-config extension point. Empty in community; pro augments it. */
+export interface BarSeriesExtension {}
+/** Line series-config extension point. Empty in community; pro augments it. */
+export interface LineSeriesExtension {}
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -49,7 +53,7 @@ export interface ChartsSeriesConfig {
       seriesId: SeriesId;
       dataIndex?: number | undefined;
     };
-  };
+  } & BarSeriesExtension;
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & MakeRequired<SeriesColor<number | null>, 'color'>;
     series: DefaultizedLineSeriesType;
@@ -72,7 +76,7 @@ export interface ChartsSeriesConfig {
       seriesId: SeriesId;
       dataIndex?: number;
     };
-  };
+  } & LineSeriesExtension;
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & MakeRequired<SeriesColor<ScatterValueType>, 'color'>;
     series: DefaultizedScatterSeriesType;

package/models/seriesType/config.d.ts

@@ -7,6 +7,10 @@ import type { DefaultizedRadarSeriesType, RadarItemIdentifier, RadarSeriesType }
 import type { SeriesColor, SeriesId } from "./common.js";
 import type { ChartsRadiusAxisProps, ChartsRotationAxisProps, ComputedXAxis, ComputedYAxis, PolarAxisDefaultized } from "../axis.js";
 import type { CommonHighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.js";
+/** Bar series-config extension point. Empty in community; pro augments it. */
+export interface BarSeriesExtension {}
+/** Line series-config extension point. Empty in community; pro augments it. */
+export interface LineSeriesExtension {}
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -49,7 +53,7 @@ export interface ChartsSeriesConfig {
       seriesId: SeriesId;
       dataIndex?: number | undefined;
     };
-  };
+  } & BarSeriesExtension;
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & MakeRequired<SeriesColor<number | null>, 'color'>;
     series: DefaultizedLineSeriesType;
@@ -72,7 +76,7 @@ export interface ChartsSeriesConfig {
       seriesId: SeriesId;
       dataIndex?: number;
     };
-  };
+  } & LineSeriesExtension;
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & MakeRequired<SeriesColor<ScatterValueType>, 'color'>;
     series: DefaultizedScatterSeriesType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "9.8.0",
+  "version": "9.9.0",
   "author": "MUI Team",
   "description": "The community edition of MUI X Charts components.",
   "license": "MIT",
@@ -28,15 +28,15 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.29.7",
-    "@mui/utils": "^9.1.1",
+    "@mui/utils": "^9.2.0",
     "bezier-easing": "^3.0.1",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "reselect": "^5.2.0",
     "use-sync-external-store": "^1.6.0",
-    "@mui/x-charts-vendor": "^9.4.0",
-    "@mui/x-internal-gestures": "^9.8.0",
-    "@mui/x-internals": "^9.8.0"
+    "@mui/x-internal-gestures": "^9.9.0",
+    "@mui/x-internals": "^9.9.0",
+    "@mui/x-charts-vendor": "^9.4.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",

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

@@ -1,45 +0,0 @@
-import type { SeriesItemIdentifierWithType } from "../../../../../models/seriesType/index.mjs";
-import type { ChartSeriesType } from "../../../../../models/seriesType/config.mjs";
-import type { ChartsRotationAxisProps, ChartsRadiusAxisProps, ComputedXAxis, ComputedYAxis } from "../../../../../models/axis.mjs";
-import type { ChartDrawingArea } from "../../../../../hooks/useDrawingArea.mjs";
-import type { ProcessedSeries, SeriesLayout } from "../../useChartSeries/index.mjs";
-import type { ComputeResult } from "../../../featurePlugins/useChartPolarAxis/computeAxisValue.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";
-export interface TooltipPositionGetterAxesConfig {
-  x?: ComputedXAxis;
-  y?: ComputedYAxis;
-  rotationAxes?: ComputeResult<ChartsRotationAxisProps>;
-  radiusAxes?: ComputeResult<ChartsRadiusAxisProps>;
-}
-export type TooltipItemPositionGetter<SeriesType extends ChartSeriesType> = (params: {
-  series: ProcessedSeries<SeriesType>;
-  axesConfig: TooltipPositionGetterAxesConfig;
-  drawingArea: ChartDrawingArea;
-  identifier: SeriesItemIdentifierWithType<SeriesType> | null;
-  seriesLayout: SeriesLayout<SeriesType>;
-  /**
-   * The preferred placement of the tooltip related to the element.
-   * @default 'top'
-   */
-  placement: 'top' | 'bottom' | 'left' | 'right';
-}) => {
-  x: number;
-  y: number;
-} | null;
-/**
- * Computes the anchor position of an item tooltip from the chart state. Series
- * types whose position depends on state the core tooltip plugin doesn't track
- * (e.g. the geo projection for map series) provide one of these instead of a
- * `tooltipItemPositionGetter`, so the dependency is memoized correctly 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 = (state: ChartState<[UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartTooltipSignature]>, position: 'top' | 'bottom' | 'left' | 'right' | undefined) => {
-  x: number;
-  y: number;
-} | null;

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

@@ -1,45 +0,0 @@
-import type { SeriesItemIdentifierWithType } from "../../../../../models/seriesType/index.js";
-import type { ChartSeriesType } from "../../../../../models/seriesType/config.js";
-import type { ChartsRotationAxisProps, ChartsRadiusAxisProps, ComputedXAxis, ComputedYAxis } from "../../../../../models/axis.js";
-import type { ChartDrawingArea } from "../../../../../hooks/useDrawingArea.js";
-import type { ProcessedSeries, SeriesLayout } from "../../useChartSeries/index.js";
-import type { ComputeResult } from "../../../featurePlugins/useChartPolarAxis/computeAxisValue.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";
-export interface TooltipPositionGetterAxesConfig {
-  x?: ComputedXAxis;
-  y?: ComputedYAxis;
-  rotationAxes?: ComputeResult<ChartsRotationAxisProps>;
-  radiusAxes?: ComputeResult<ChartsRadiusAxisProps>;
-}
-export type TooltipItemPositionGetter<SeriesType extends ChartSeriesType> = (params: {
-  series: ProcessedSeries<SeriesType>;
-  axesConfig: TooltipPositionGetterAxesConfig;
-  drawingArea: ChartDrawingArea;
-  identifier: SeriesItemIdentifierWithType<SeriesType> | null;
-  seriesLayout: SeriesLayout<SeriesType>;
-  /**
-   * The preferred placement of the tooltip related to the element.
-   * @default 'top'
-   */
-  placement: 'top' | 'bottom' | 'left' | 'right';
-}) => {
-  x: number;
-  y: number;
-} | null;
-/**
- * Computes the anchor position of an item tooltip from the chart state. Series
- * types whose position depends on state the core tooltip plugin doesn't track
- * (e.g. the geo projection for map series) provide one of these instead of a
- * `tooltipItemPositionGetter`, so the dependency is memoized correctly 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 = (state: ChartState<[UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartTooltipSignature]>, position: 'top' | 'bottom' | 'left' | 'right' | undefined) => {
-  x: number;
-  y: number;
-} | null;

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

@@ -1,48 +0,0 @@
-import type { ExtendedFeatureCollection, GeoProjection, GeoPath } from '@mui/x-charts-vendor/d3-geo';
-import type { D3NamedProjection, GeoProjectionInput, GeoTooltipPosition, UseGeoProjectionSignature, UseGeoProjectionState } from "./useGeoProjection.types.mjs";
-import type { ChartState } from "../../models/chart.mjs";
-export declare const selectorChartGeoProjectionState: (state: ChartState<[], [UseGeoProjectionSignature]>) => UseGeoProjectionState["geoProjection"] | undefined;
-export declare const selectorChartGeoData: (state: ChartState<[], [UseGeoProjectionSignature]>) => ExtendedFeatureCollection | null;
-export declare const selectorChartGeoFeatureKey: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => string | ((feature: ExtendedFeatureCollection["features"][number]) => string | null);
-export declare const selectorChartRawProjection: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => GeoProjectionInput | null;
-export declare const selectorChartProjectionFactory: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => Record<D3NamedProjection, (() => GeoProjection) | undefined> | null;
-export declare const selectorChartRawScale: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => number | null;
-/**
- * Map a feature's `properties.name` to its index in `geoData.features`,
- * for fast lookup by name when joining series rows to features.
- *
- * Features without a string `properties.name` are skipped; on duplicates,
- * the first occurrence wins.
- */
-export declare const selectorChartGeoFeatureIndexesByName: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => ReadonlyMap<string, number[]>;
-/**
- * Resolves the raw `projection` input into a ready-to-use `GeoProjection` instance
- * fitted to the chart's drawing area.
- *
- * - String inputs (e.g. `'mercator'`) are mapped to the matching d3-geo factory.
- * - `GeoProjection` instances are used as-is, then fitted.
- * - Returns `null` when no projection is registered or the name is unknown.
- */
-export declare const selectorChartProjection: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => GeoProjection | null;
-/**
- * Resolves the raw `projection` input into a ready-to-use `GeoPath` instance
- * fitted to the chart's drawing area.
- */
-export declare const selectorChartGeoPath: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => GeoPath<any, import("@mui/x-charts-vendor/d3-geo").GeoPermissibleObjects> | null;
-export declare const selectorGeoTooltipPosition: (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<UseGeoProjectionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => GeoTooltipPosition;