@mui/x-charts 8.27.0 → 9.0.0-alpha.0

package/internals/store/useCharts.js

@@ -22,9 +22,8 @@ let globalId = 0;
  *
  * @param inPlugins All the plugins that will be used in the chart.
  * @param props The props passed to the chart.
- * @param seriesConfig The set of helpers used for series-specific computation.
  */
-function useCharts(inPlugins, props, seriesConfig) {
+function useCharts(inPlugins, props) {
   const chartId = (0, _useId.default)();
   const plugins = React.useMemo(() => [..._corePlugins.CHART_CORE_PLUGINS, ...inPlugins], [inPlugins]);
   const pluginParams = (0, _extractPluginParamsFromProps.extractPluginParamsFromProps)({
@@ -35,8 +34,6 @@ function useCharts(inPlugins, props, seriesConfig) {
   const instanceRef = React.useRef({});
   const instance = instanceRef.current;
   const publicAPI = useChartApiInitialization(props.apiRef);
-  const innerChartRootRef = React.useRef(null);
-  const innerSvgRef = React.useRef(null);
   const storeRef = React.useRef(null);
   if (storeRef.current == null) {
     // eslint-disable-next-line react-compiler/react-compiler
@@ -48,7 +45,7 @@ function useCharts(inPlugins, props, seriesConfig) {
     };
     plugins.forEach(plugin => {
       if (plugin.getInitialState) {
-        Object.assign(initialState, plugin.getInitialState(pluginParams, initialState, seriesConfig));
+        Object.assign(initialState, plugin.getInitialState(pluginParams, initialState));
       }
     });
     storeRef.current = new _store.Store(initialState);
@@ -58,10 +55,7 @@ function useCharts(inPlugins, props, seriesConfig) {
       instance,
       params: pluginParams,
       plugins: plugins,
-      store: storeRef.current,
-      svgRef: innerSvgRef,
-      chartRootRef: innerChartRootRef,
-      seriesConfig
+      store: storeRef.current
     });
     if (pluginResponse.publicAPI) {
       Object.assign(publicAPI.current, pluginResponse.publicAPI);
@@ -74,9 +68,7 @@ function useCharts(inPlugins, props, seriesConfig) {
   const contextValue = React.useMemo(() => ({
     store: storeRef.current,
     publicAPI: publicAPI.current,
-    instance,
-    svgRef: innerSvgRef,
-    chartRootRef: innerChartRootRef
+    instance
   }), [instance, publicAPI]);
   return {
     contextValue

package/internals/store/useCharts.types.d.ts

@@ -1,5 +1,11 @@
 import type * as React from 'react';
 import { type ChartAnyPluginSignature, type ChartPublicAPI } from "../plugins/models/index.js";
+import type { ChartSeriesConfig } from "../plugins/corePlugins/useChartSeriesConfig/index.js";
 export interface UseChartBaseProps<TSignatures extends readonly ChartAnyPluginSignature[]> {
   apiRef?: React.RefObject<ChartPublicAPI<TSignatures> | undefined>;
+  /**
+   * The configuration for the series types.
+   * This is used to define how each series type should be processed, colored, and displayed.
+   */
+  seriesConfig?: ChartSeriesConfig<any>;
 }

package/models/axis.d.ts

@@ -1,3 +1,4 @@
+import type * as React from 'react';
 import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime, ScaleSymLog, NumberValue } from '@mui/x-charts-vendor/d3-scale';
 import { type SxProps } from '@mui/system/styleFunctionSx';
 import { type HasProperty, type MakeOptional, type MakeRequired } from '@mui/x-internals/types';
@@ -41,12 +42,24 @@ export interface ChartsAxisSlots {
    * @default ChartsText
    */
   axisLabel?: React.JSXElementConstructor<ChartsTextProps>;
+  /**
+   * Custom component for the x-axis.
+   * @default ChartsXAxis
+   */
+  xAxis?: React.JSXElementConstructor<ChartsXAxisProps>;
+  /**
+   * Custom component for the y-axis.
+   * @default ChartsYAxis
+   */
+  yAxis?: React.JSXElementConstructor<ChartsYAxisProps>;
 }
 export interface ChartsAxisSlotProps {
   axisLine?: Partial<React.SVGAttributes<SVGPathElement>>;
   axisTick?: Partial<React.SVGAttributes<SVGPathElement>>;
   axisTickLabel?: Partial<ChartsTextProps>;
   axisLabel?: Partial<ChartsTextProps>;
+  xAxis?: Partial<ChartsXAxisProps>;
+  yAxis?: Partial<ChartsYAxisProps>;
 }
 export interface ChartsAxisProps extends TickParams {
   /**
@@ -448,9 +461,9 @@ type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
    * - 'strict': Set the domain to the min/max value provided. No extra space is added.
    * - function: Receives the calculated extremums as parameters, and should return the axis domain.
    */
-  domainLimit?: 'nice' | 'strict' | ((min: number, max: number) => {
-    min: number;
-    max: number;
+  domainLimit?: 'nice' | 'strict' | ((min: NumberValue, max: NumberValue) => {
+    min: NumberValue;
+    max: NumberValue;
   });
   /**
    * If `true`, the axis will be ignored by the tooltip with `trigger='axis'`.

package/models/index.d.ts

@@ -3,6 +3,7 @@ export * from "./stacking.js";
 export * from "./slots/index.js";
 export * from "./featureFlags.js";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData, XAxis, YAxis, RadiusAxis, RotationAxis, AxisItemIdentifier, AxisValueFormatterContext } from "./axis.js";
+export type { NumberValue } from '@mui/x-charts-vendor/d3-scale';
 export type { PropsFromSlot } from '@mui/x-internals/slots';
 export type { Position } from "./position.js";
 export type { CurveType } from "./curve.js";

package/models/seriesType/bar.d.ts

@@ -3,7 +3,7 @@ import type { StackOffsetType } from "../stacking.js";
 import { type CartesianSeriesType, type CommonSeriesType, type CommonDefaultizedProps, type StackableSeriesType, type SeriesId } from "./common.js";
 import { type BarItem, type BarLabelContext } from "../../BarChart/index.js";
 export type BarValueType = number;
-export interface BarSeriesType extends CommonSeriesType<BarValueType | null>, CartesianSeriesType, StackableSeriesType {
+export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'bar'>, CartesianSeriesType, StackableSeriesType {
   type: 'bar';
   /**
    * Data associated to each bar.

package/models/seriesType/common.d.ts

@@ -1,11 +1,11 @@
-import { type HighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.js";
 import type { StackOffsetType, StackOrderType } from "../stacking.js";
 import type { ChartsLabelMarkType } from "../../ChartsLabel/ChartsLabelMark.js";
-import { type AxisId } from "../axis.js";
+import type { AxisId } from "../axis.js";
+import type { ChartSeriesType, HighlightScope } from "./config.js";
 /**
  * The unique identifier of a series.
  */
-export type SeriesId = number | string;
+export type SeriesId = string;
 export type SeriesValueFormatterContext = {
   /**
    * The index of the value in the data array.
@@ -33,7 +33,7 @@ export interface SeriesColor<TValue> {
    */
   colorGetter?: (data: ColorCallbackValue<TValue>) => string;
 }
-export interface CommonSeriesType<TValue> extends SeriesColor<TValue> {
+export interface CommonSeriesType<TValue, SeriesType extends ChartSeriesType> extends SeriesColor<TValue> {
   /**
    * The id of this series.
    */
@@ -48,7 +48,7 @@ export interface CommonSeriesType<TValue> extends SeriesColor<TValue> {
   /**
    * The scope to apply when the series is highlighted.
    */
-  highlightScope?: HighlightScope;
+  highlightScope?: HighlightScope<SeriesType>;
   /**
    * Defines the mark type for the series.
    *

package/models/seriesType/config.d.ts

@@ -5,6 +5,7 @@ import type { BarItemIdentifier, BarSeriesType, DefaultizedBarSeriesType } from
 import type { PieSeriesType, DefaultizedPieSeriesType, PieItemIdentifier, PieValueType, DefaultizedPieValueType, PieSeriesLayout } from "./pie.js";
 import type { DefaultizedRadarSeriesType, RadarItemIdentifier, RadarSeriesType } from "./radar.js";
 import type { SeriesColor } from "./common.js";
+import type { CommonHighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.js";
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -29,6 +30,7 @@ export interface ChartsSeriesConfig {
     valueType: number | null;
     canBeStacked: true;
     axisType: 'cartesian';
+    highlightScope: CommonHighlightScope;
   };
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & MakeRequired<SeriesColor<number | null>, 'color'>;
@@ -40,6 +42,7 @@ export interface ChartsSeriesConfig {
     valueType: number | null;
     canBeStacked: true;
     axisType: 'cartesian';
+    highlightScope: CommonHighlightScope;
   };
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & MakeRequired<SeriesColor<ScatterValueType | null>, 'color'>;
@@ -50,6 +53,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: ScatterItemIdentifier;
     itemIdentifierWithData: ScatterItemIdentifier;
     axisType: 'cartesian';
+    highlightScope: CommonHighlightScope;
   };
   pie: {
     seriesInput: Omit<DefaultizedProps<PieSeriesType, 'id'>, 'data'> & {
@@ -61,6 +65,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: PieItemIdentifier;
     itemIdentifierWithData: PieItemIdentifier;
     valueType: DefaultizedPieValueType;
+    highlightScope: CommonHighlightScope;
   };
   radar: {
     seriesInput: DefaultizedProps<RadarSeriesType, 'id'> & MakeRequired<SeriesColor<number>, 'color'>;
@@ -71,6 +76,7 @@ export interface ChartsSeriesConfig {
     itemIdentifierWithData: RadarItemIdentifier;
     valueType: number;
     axisType: 'polar';
+    highlightScope: CommonHighlightScope;
   };
 }
 export type ChartSeriesType = keyof ChartsSeriesConfig;
@@ -94,4 +100,5 @@ export type ChartSeriesLayout<T extends ChartSeriesType> = ChartsSeriesConfig[T]
 export type DatasetElementType<T> = {
   [key: string]: T;
 };
-export type DatasetType<T = unknown> = DatasetElementType<T>[];
+export type DatasetType<T = unknown> = DatasetElementType<T>[];
+export type HighlightScope<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends any ? ChartsSeriesConfig[T]['highlightScope'] : never;

package/models/seriesType/index.d.ts

@@ -1,40 +1,15 @@
 import type { DefaultizedProps } from '@mui/x-internals/types';
-import type { BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
-import { type CartesianChartSeriesType, type ChartSeriesType, type ChartsSeriesConfig, type StackableChartSeriesType } from "./config.js";
+import { type ChartSeriesType, type ChartsSeriesConfig } from "./config.js";
 type AllSeriesType<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['seriesProp'];
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-type CartesianSeriesType = AllSeriesType<CartesianChartSeriesType>;
 type DefaultizedSeriesType<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['series'];
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-type DefaultizedCartesianSeriesType = DefaultizedSeriesType<CartesianChartSeriesType>;
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-type StackableSeriesType = DefaultizedSeriesType<StackableChartSeriesType>;
-export type SeriesItemIdentifier<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifier'];
-export type SeriesItemIdentifierWithData<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifierWithData'];
+export type SeriesItemIdentifier<T extends ChartSeriesType> = T extends ChartSeriesType ? ChartsSeriesConfig[T]['itemIdentifier'] : never;
+export type SeriesItemIdentifierWithData<T extends ChartSeriesType> = T extends ChartSeriesType ? ChartsSeriesConfig[T]['itemIdentifierWithData'] : never;
 export type FocusedItemIdentifier<T extends ChartSeriesType = ChartSeriesType> = T extends 'line' | 'radar' ? DefaultizedProps<ChartsSeriesConfig[T]['itemIdentifier'], 'dataIndex'> : T extends 'heatmap' ? DefaultizedProps<ChartsSeriesConfig[T]['itemIdentifier'], 'xIndex' | 'yIndex'> : ChartsSeriesConfig[T]['itemIdentifier'];
 export { type SeriesId } from "./common.js";
+export type { CartesianChartSeriesType, StackableChartSeriesType } from "./config.js";
 export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
 export * from "./radar.js";
-export type { AllSeriesType, DefaultizedSeriesType, CartesianSeriesType, DefaultizedCartesianSeriesType, StackableSeriesType };
-/**
- * @deprecated We do not use this function in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-export declare function isDefaultizedBarSeries(series: DefaultizedSeriesType): series is DefaultizedBarSeriesType;
-/**
- * @deprecated We do not use this function in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-export declare function isBarSeries(series: AllSeriesType): series is BarSeriesType;
+export type { AllSeriesType, DefaultizedSeriesType };

package/models/seriesType/index.js

@@ -3,16 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _exportNames = {
-  isDefaultizedBarSeries: true,
-  isBarSeries: true
-};
-exports.isBarSeries = isBarSeries;
-exports.isDefaultizedBarSeries = isDefaultizedBarSeries;
 var _line = require("./line");
 Object.keys(_line).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _line[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -24,7 +17,6 @@ Object.keys(_line).forEach(function (key) {
 var _bar = require("./bar");
 Object.keys(_bar).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _bar[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -36,7 +28,6 @@ Object.keys(_bar).forEach(function (key) {
 var _scatter = require("./scatter");
 Object.keys(_scatter).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _scatter[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -48,7 +39,6 @@ Object.keys(_scatter).forEach(function (key) {
 var _pie = require("./pie");
 Object.keys(_pie).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _pie[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -60,7 +50,6 @@ Object.keys(_pie).forEach(function (key) {
 var _radar = require("./radar");
 Object.keys(_radar).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _radar[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -68,40 +57,4 @@ Object.keys(_radar).forEach(function (key) {
       return _radar[key];
     }
   });
-});
-// Series definition
-
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-
-/**
- * @deprecated We do not use this type in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-
-// item identifier
-
-// Helpers
-
-/**
- * @deprecated We do not use this function in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-function isDefaultizedBarSeries(series) {
-  return series.type === 'bar';
-}
-
-/**
- * @deprecated We do not use this function in v8. If it's useful for you use case, please open an issue explaining why.
- * Otherwise, it will be removed in next major.
- */
-function isBarSeries(series) {
-  return series.type === 'bar';
-}
+});

package/models/seriesType/line.d.ts

@@ -24,7 +24,7 @@ export interface ShowMarkParams<AxisValue = number | Date> {
    */
   value: number;
 }
-export interface LineSeriesType extends CommonSeriesType<number | null>, CartesianSeriesType, StackableSeriesType {
+export interface LineSeriesType extends CommonSeriesType<number | null, 'line'>, CartesianSeriesType, StackableSeriesType {
   type: 'line';
   /**
    * Data associated to the line.

package/models/seriesType/pie.d.ts

@@ -26,7 +26,7 @@ export type DefaultizedPieValueType = PieValueType & Omit<D3PieArcDatum<any>, 'd
   hidden: boolean;
 };
 export type ChartsPieSorting = 'none' | 'asc' | 'desc' | ((a: number, b: number) => number);
-export interface PieSeriesType<TData = PieValueType> extends CommonSeriesType<TData> {
+export interface PieSeriesType<TData = PieValueType> extends CommonSeriesType<TData, 'pie'> {
   type: 'pie';
   data: Readonly<TData[]>;
   /**

package/models/seriesType/radar.d.ts

@@ -1,6 +1,6 @@
 import { type DefaultizedProps } from '@mui/x-internals/types';
 import { type CommonDefaultizedProps, type CommonSeriesType, type SeriesId } from "./common.js";
-export interface RadarSeriesType extends CommonSeriesType<number> {
+export interface RadarSeriesType extends CommonSeriesType<number, 'radar'> {
   type: 'radar';
   data: number[];
   /**

package/models/seriesType/scatter.d.ts

@@ -9,7 +9,7 @@ export type ScatterValueType = {
    */
   id?: string | number;
 };
-export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType | null>, CartesianSeriesType {
+export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType | null, 'scatter'>, CartesianSeriesType {
   type: 'scatter';
   data?: readonly ScatterValueType[];
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "8.27.0",
+  "version": "9.0.0-alpha.0",
   "author": "MUI Team",
   "description": "The community edition of MUI X Charts components.",
   "license": "MIT",
@@ -27,16 +27,16 @@
     "directory": "packages/x-charts"
   },
   "dependencies": {
-    "@babel/runtime": "^7.28.4",
-    "@mui/utils": "^7.3.5",
+    "@babel/runtime": "^7.28.6",
+    "@mui/utils": "^7.3.7",
     "bezier-easing": "^2.1.0",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.6.0",
-    "@mui/x-charts-vendor": "8.26.0",
+    "@mui/x-charts-vendor": "9.0.0-alpha.0",
     "@mui/x-internal-gestures": "0.4.0",
-    "@mui/x-internals": "8.26.0"
+    "@mui/x-internals": "9.0.0-alpha.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",

package/ChartsTooltip/useAxisTooltip.d.ts

@@ -1,42 +0,0 @@
-import { type SeriesId } from "../models/seriesType/common.js";
-import { type CartesianChartSeriesType, type ChartsSeriesConfig, type PolarChartSeriesType } from "../models/seriesType/config.js";
-import { type ComputedAxis, type PolarAxisDefaultized, type AxisId } from "../models/axis.js";
-import { type ChartsLabelMarkProps } from "../ChartsLabel/index.js";
-export interface UseAxisTooltipReturnValue<SeriesT extends CartesianChartSeriesType | PolarChartSeriesType = CartesianChartSeriesType | PolarChartSeriesType, AxisValueT extends string | number | Date = string | number | Date> {
-  axisDirection: SeriesT extends CartesianChartSeriesType ? 'x' | 'y' : 'rotation' | 'radius';
-  mainAxis: SeriesT extends CartesianChartSeriesType ? ComputedAxis : PolarAxisDefaultized;
-  axisId: AxisId;
-  axisValue: AxisValueT;
-  axisFormattedValue: string;
-  dataIndex: number;
-  seriesItems: SeriesItem<SeriesT>[];
-}
-export interface UseAxisTooltipParams {
-  /**
-   * If `true`, the hook returns an array with an object per active axis.
-   */
-  multipleAxes?: boolean;
-  /**
-   * The axis directions to consider.
-   * If not defined, all directions are considered
-   */
-  directions?: ('x' | 'y' | 'rotation')[];
-}
-interface SeriesItem<T extends CartesianChartSeriesType | PolarChartSeriesType> {
-  seriesId: SeriesId;
-  color: string;
-  value: ChartsSeriesConfig[T]['valueType'];
-  formattedValue: string;
-  formattedLabel: string | null;
-  markType: ChartsLabelMarkProps['type'];
-}
-/**
- * @deprecated Use `useAxesTooltip` instead.
- */
-export declare function useAxisTooltip(params: UseAxisTooltipParams & {
-  multipleAxes: true;
-}): UseAxisTooltipReturnValue[] | null;
-export declare function useAxisTooltip(params?: UseAxisTooltipParams & {
-  multipleAxes?: false;
-}): UseAxisTooltipReturnValue | null;
-export {};

package/ChartsTooltip/useAxisTooltip.js

@@ -1,181 +0,0 @@
-"use strict";
-'use client';
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useAxisTooltip = useAxisTooltip;
-var _useSeries = require("../hooks/useSeries");
-var _useColorProcessor = require("../internals/plugins/corePlugins/useChartSeries/useColorProcessor");
-var _useStore = require("../internals/store/useStore");
-var _getLabel = require("../internals/getLabel");
-var _isCartesian = require("../internals/isCartesian");
-var _utils = require("./utils");
-var _useAxis = require("../hooks/useAxis");
-var _useZAxis = require("../hooks/useZAxis");
-var _useChartCartesianAxis = require("../internals/plugins/featurePlugins/useChartCartesianAxis");
-var _useChartPolarInteraction = require("../internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarInteraction.selectors");
-var _isPolar = require("../internals/isPolar");
-function defaultAxisTooltipConfig(axis, dataIndex, axisDirection) {
-  const axisValue = axis.data?.[dataIndex] ?? null;
-  const axisFormatter = axis.valueFormatter ?? (v => axis.scaleType === 'utc' ? (0, _utils.utcFormatter)(v) : v.toLocaleString());
-  const axisFormattedValue = axisFormatter(axisValue, {
-    location: 'tooltip',
-    scale: axis.scale
-  });
-  return {
-    axisDirection,
-    axisId: axis.id,
-    mainAxis: axis,
-    dataIndex,
-    axisValue,
-    axisFormattedValue,
-    seriesItems: []
-  };
-}
-
-/**
- * @deprecated Use `useAxesTooltip` instead.
- */
-
-function useAxisTooltip(params = {}) {
-  const {
-    multipleAxes,
-    directions
-  } = params;
-  const defaultXAxis = (0, _useAxis.useXAxis)();
-  const defaultYAxis = (0, _useAxis.useYAxis)();
-  const defaultRotationAxis = (0, _useAxis.useRotationAxis)();
-  const store = (0, _useStore.useStore)();
-  const tooltipXAxes = store.use(_useChartCartesianAxis.selectorChartsInteractionTooltipXAxes);
-  const tooltipYAxes = store.use(_useChartCartesianAxis.selectorChartsInteractionTooltipYAxes);
-  const tooltipRotationAxes = store.use(_useChartPolarInteraction.selectorChartsInteractionTooltipRotationAxes);
-  const series = (0, _useSeries.useSeries)();
-  const {
-    xAxis
-  } = (0, _useAxis.useXAxes)();
-  const {
-    yAxis
-  } = (0, _useAxis.useYAxes)();
-  const {
-    zAxis,
-    zAxisIds
-  } = (0, _useZAxis.useZAxes)();
-  const {
-    rotationAxis
-  } = (0, _useAxis.useRotationAxes)();
-  const colorProcessors = (0, _useColorProcessor.useColorProcessor)();
-  if (tooltipXAxes.length === 0 && tooltipYAxes.length === 0 && tooltipRotationAxes.length === 0) {
-    return null;
-  }
-  const tooltipAxes = [];
-  if (directions === undefined || directions.includes('x')) {
-    tooltipXAxes.forEach(({
-      axisId,
-      dataIndex
-    }) => {
-      if (!multipleAxes && tooltipAxes.length > 1) {
-        return;
-      }
-      tooltipAxes.push(defaultAxisTooltipConfig(xAxis[axisId], dataIndex, 'x'));
-    });
-  }
-  if (directions === undefined || directions.includes('y')) {
-    tooltipYAxes.forEach(({
-      axisId,
-      dataIndex
-    }) => {
-      if (!multipleAxes && tooltipAxes.length > 1) {
-        return;
-      }
-      tooltipAxes.push(defaultAxisTooltipConfig(yAxis[axisId], dataIndex, 'y'));
-    });
-  }
-  if (directions === undefined || directions.includes('rotation')) {
-    tooltipRotationAxes.forEach(({
-      axisId,
-      dataIndex
-    }) => {
-      if (!multipleAxes && tooltipAxes.length > 1) {
-        return;
-      }
-      tooltipAxes.push(defaultAxisTooltipConfig(rotationAxis[axisId], dataIndex, 'rotation'));
-    });
-  }
-  Object.keys(series).filter(_isCartesian.isCartesianSeriesType).forEach(seriesType => {
-    const seriesOfType = series[seriesType];
-    if (!seriesOfType) {
-      return [];
-    }
-    return seriesOfType.seriesOrder.forEach(seriesId => {
-      const seriesToAdd = seriesOfType.series[seriesId];
-      const providedXAxisId = seriesToAdd.xAxisId ?? defaultXAxis.id;
-      const providedYAxisId = seriesToAdd.yAxisId ?? defaultYAxis.id;
-      const tooltipItemIndex = tooltipAxes.findIndex(({
-        axisDirection,
-        axisId
-      }) => axisDirection === 'x' && axisId === providedXAxisId || axisDirection === 'y' && axisId === providedYAxisId);
-      // Test if the series uses the default axis
-      if (tooltipItemIndex >= 0) {
-        const zAxisId = 'zAxisId' in seriesToAdd ? seriesToAdd.zAxisId : zAxisIds[0];
-        const {
-          dataIndex
-        } = tooltipAxes[tooltipItemIndex];
-        const color = colorProcessors[seriesType]?.(seriesToAdd, xAxis[providedXAxisId], yAxis[providedYAxisId], zAxisId ? zAxis[zAxisId] : undefined)(dataIndex) ?? '';
-        const value = seriesToAdd.data[dataIndex] ?? null;
-        const formattedValue = seriesToAdd.valueFormatter(value, {
-          dataIndex
-        });
-        const formattedLabel = (0, _getLabel.getLabel)(seriesToAdd.label, 'tooltip') ?? null;
-        tooltipAxes[tooltipItemIndex].seriesItems.push({
-          seriesId,
-          color,
-          value,
-          formattedValue,
-          formattedLabel,
-          markType: seriesToAdd.labelMarkType
-        });
-      }
-    });
-  });
-  Object.keys(series).filter(_isPolar.isPolarSeriesType).forEach(seriesType => {
-    const seriesOfType = series[seriesType];
-    if (!seriesOfType) {
-      return [];
-    }
-    return seriesOfType.seriesOrder.forEach(seriesId => {
-      const seriesToAdd = seriesOfType.series[seriesId];
-      const providedRotationAxisId =
-      // @ts-expect-error Should be fixed when we introduce a polar series with a rotationAxisId
-      seriesToAdd.rotationAxisId ?? defaultRotationAxis?.id;
-      const tooltipItemIndex = tooltipAxes.findIndex(({
-        axisDirection,
-        axisId
-      }) => axisDirection === 'rotation' && axisId === providedRotationAxisId);
-      // Test if the series uses the default axis
-      if (tooltipItemIndex >= 0) {
-        const {
-          dataIndex
-        } = tooltipAxes[tooltipItemIndex];
-        const color = colorProcessors[seriesType]?.(seriesToAdd)(dataIndex) ?? '';
-        const value = seriesToAdd.data[dataIndex] ?? null;
-        const formattedValue = seriesToAdd.valueFormatter(value, {
-          dataIndex
-        });
-        const formattedLabel = (0, _getLabel.getLabel)(seriesToAdd.label, 'tooltip') ?? null;
-        tooltipAxes[tooltipItemIndex].seriesItems.push({
-          seriesId,
-          color,
-          value,
-          formattedValue,
-          formattedLabel,
-          markType: seriesToAdd.labelMarkType
-        });
-      }
-    });
-  });
-  if (!multipleAxes) {
-    return tooltipAxes.length === 0 ? tooltipAxes[0] : null;
-  }
-  return tooltipAxes;
-}