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

package/esm/internals/seriesSelectorOfType.d.ts

@@ -1,20 +1,20 @@
 import { type ChartSeriesDefaultized, type ChartsSeriesConfig } from "../models/seriesType/config.js";
 import { type SeriesId } from "../models/seriesType/common.js";
 import type { ProcessedSeries } from "./plugins/corePlugins/useChartSeries/index.js";
-export declare const selectorAllSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
+export declare const selectorAllSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig) => import("./index.js").SeriesProcessorResult<"line"> | import("./index.js").SeriesProcessorResult<"bar"> | {
-  series: Record<SeriesId, import("../index.js").DefaultizedScatterSeriesType>;
+}, seriesType: keyof ChartsSeriesConfig) => import("./index.js").SeriesProcessorResult<"line"> | {
+  series: Record<string, import("../index.js").DefaultizedScatterSeriesType>;
   seriesOrder: SeriesId[];
-} | {
-  series: Record<SeriesId, import("../index.js").DefaultizedPieSeriesType>;
+} | import("./index.js").SeriesProcessorResult<"bar"> | {
+  series: Record<string, import("../index.js").DefaultizedPieSeriesType>;
   seriesOrder: SeriesId[];
 } | {
-  series: Record<SeriesId, import("../index.js").DefaultizedRadarSeriesType>;
+  series: Record<string, import("../index.js").DefaultizedRadarSeriesType>;
   seriesOrder: SeriesId[];
 } | undefined;
-export declare const selectorSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
+export declare const selectorSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig, ids?: SeriesId | SeriesId[] | undefined) => import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedScatterSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | (import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedScatterSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | undefined)[] | undefined;
+}, seriesType: keyof ChartsSeriesConfig, ids?: string | string[] | undefined) => import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedScatterSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | (import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedScatterSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | undefined)[] | undefined;
 export declare const useAllSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T) => ProcessedSeries[T];
 export declare const useSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T, seriesId?: SeriesId | SeriesId[]) => ChartSeriesDefaultized<T> | ChartSeriesDefaultized<T>[] | undefined;

package/esm/internals/seriesSelectorOfType.js

@@ -4,7 +4,7 @@ import { selectorChartSeriesProcessed } from "./plugins/corePlugins/useChartSeri
 import { useStore } from "./store/useStore.js";
 export const selectorAllSeriesOfType = createSelector(selectorChartSeriesProcessed, (processedSeries, seriesType) => processedSeries[seriesType]);
 export const selectorSeriesOfType = createSelectorMemoized(selectorChartSeriesProcessed, (processedSeries, seriesType, ids) => {
-  if (ids === undefined || Array.isArray(ids) && ids.length === 0) {
+  if (ids === undefined) {
     return processedSeries[seriesType]?.seriesOrder?.map(seriesId => processedSeries[seriesType]?.series[seriesId]) ?? [];
   }
   if (!Array.isArray(ids)) {

package/esm/internals/sliceUntil.js

@@ -1,4 +1,6 @@
-const segmenter = typeof window !== 'undefined' && 'Intl' in window && 'Segmenter' in Intl ? new Intl.Segmenter(undefined, {
+const segmenter = typeof window !== 'undefined' && 'Intl' in window && 'Segmenter' in Intl ?
+// eslint-disable-next-line compat/compat
+new Intl.Segmenter(undefined, {
   granularity: 'grapheme'
 }) : null;
 function sliceUntilFallback(text, endIndex) {

package/esm/internals/stacking/stackSeries.d.ts

@@ -1,6 +1,7 @@
 import { stackOrderNone as d3StackOrderNone, stackOrderReverse as d3StackOrderReverse, stackOrderAppearance as d3OrderAppearance, stackOrderAscending as d3OrderAscending, stackOrderDescending as d3OrderDescending, stackOrderInsideOut as d3OrderInsideOut, stackOffsetExpand as d3StackOffsetExpand, stackOffsetNone as d3StackOffsetNone, stackOffsetSilhouette as d3StackOffsetSilhouette, stackOffsetWiggle as d3StackOffsetWiggle, type Series } from '@mui/x-charts-vendor/d3-shape';
 import type { StackOffsetType, StackOrderType } from "../../models/stacking.js";
 import { type SeriesId, type StackableSeriesType } from "../../models/seriesType/common.js";
+import { offsetDiverging } from "./offset/index.js";
 type FormatterParams<T> = {
   series: Record<SeriesId, T>;
   seriesOrder: SeriesId[];
@@ -12,7 +13,7 @@ type FormatterParams<T> = {
 export type StackingGroupsType = {
   ids: SeriesId[];
   stackingOrder: (series: Series<any, any>) => number[];
-  stackingOffset: (series: Series<any, any>, order: Iterable<number>) => void;
+  stackingOffset: (series: Series<any, any>[], order: Iterable<number>) => void;
 }[];
 export declare const StackOrder: {
   /**
@@ -48,7 +49,7 @@ export declare const StackOffset: {
   /**
    * Positive values are stacked above zero, negative values are stacked below zero, and zero values are stacked at zero.
    * */
-  diverging: (series: Series<any, any>, order: Iterable<number>) => void;
+  diverging: typeof offsetDiverging;
   /**
    * Applies a zero baseline.
    * */

package/esm/internals/stacking/stackSeries.js

@@ -34,7 +34,6 @@ export const StackOffset = {
   /**
    * Positive values are stacked above zero, negative values are stacked below zero, and zero values are stacked at zero.
    * */
-  // @ts-expect-error, d3 types are wrong, our custom function implements the correct signature
   diverging: offsetDiverging,
   /**
    * Applies a zero baseline.

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

@@ -2,8 +2,6 @@ import * as React from 'react';
 import { Store } from '@mui/x-internals/store';
 import { type ChartAnyPluginSignature, type ChartInstance, type ChartPublicAPI, type ChartState, type ConvertSignaturesIntoPlugins } from "../plugins/models/index.js";
 import { type UseChartBaseProps } from "./useCharts.types.js";
-import { type ChartSeriesType } from "../../models/seriesType/config.js";
-import { type ChartSeriesConfig } from "../plugins/models/seriesConfig/index.js";
 /**
  * This is the main hook that setups the plugin system for the chart.
  *
@@ -11,15 +9,12 @@ import { type ChartSeriesConfig } from "../plugins/models/seriesConfig/index.js"
  *
  * @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.
  */
-export declare function useCharts<TSeriesType extends ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[]>(inPlugins: ConvertSignaturesIntoPlugins<TSignatures>, props: Partial<UseChartBaseProps<TSignatures>>, seriesConfig: ChartSeriesConfig<TSeriesType>): {
+export declare function useCharts<TSignatures extends readonly ChartAnyPluginSignature[] = []>(inPlugins: ConvertSignaturesIntoPlugins<TSignatures>, props: Partial<UseChartBaseProps<TSignatures>>): {
   contextValue: {
-    store: Store<ChartState<readonly [import("../index.js").UseChartIdSignature, import("../plugins/corePlugins/useChartExperimentalFeature/index.js").UseChartExperimentalFeaturesSignature, import("../index.js").UseChartDimensionsSignature, import("../index.js").UseChartSeriesSignature<keyof import("../index.js").ChartsSeriesConfig>, import("../plugins/corePlugins/useChartAnimation/index.js").UseChartAnimationSignature, import("../index.js").UseChartInteractionListenerSignature, ...TSignatures]>>;
+    store: Store<ChartState<readonly [import("../plugins/corePlugins/index.js").UseChartElementRefSignature, import("../index.js").UseChartIdSignature, import("../index.js").UseChartSeriesConfigSignature<keyof import("../index.js").ChartsSeriesConfig>, import("../plugins/corePlugins/useChartExperimentalFeature/index.js").UseChartExperimentalFeaturesSignature, import("../index.js").UseChartDimensionsSignature, import("../index.js").UseChartSeriesSignature<keyof import("../index.js").ChartsSeriesConfig>, import("../plugins/corePlugins/useChartAnimation/index.js").UseChartAnimationSignature, import("../index.js").UseChartInteractionListenerSignature, ...TSignatures]>>;
     publicAPI: ChartPublicAPI<TSignatures>;
     instance: ChartInstance<TSignatures>;
-    svgRef: React.RefObject<SVGSVGElement | null>;
-    chartRootRef: React.RefObject<HTMLDivElement | null>;
   };
 };
 export declare function useChartApiInitialization<T>(inputApiRef: React.RefObject<T | undefined> | undefined): React.RefObject<T>;

package/esm/internals/store/useCharts.js

@@ -14,9 +14,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.
  */
-export function useCharts(inPlugins, props, seriesConfig) {
+export function useCharts(inPlugins, props) {
   const chartId = useId();
   const plugins = React.useMemo(() => [...CHART_CORE_PLUGINS, ...inPlugins], [inPlugins]);
   const pluginParams = extractPluginParamsFromProps({
@@ -27,8 +26,6 @@ export 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
@@ -40,7 +37,7 @@ export 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(initialState);
@@ -50,10 +47,7 @@ export 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);
@@ -66,9 +60,7 @@ export 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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/models/seriesType/index.d.ts

@@ -1,40 +1,18 @@
 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 ? Omit<ChartsSeriesConfig[T]['itemIdentifier'], 'type'> & {
+  type?: T;
+} : never;
+export type SeriesItemIdentifierWithType<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/esm/models/seriesType/index.js

@@ -1,20 +1,5 @@
 // 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
 
 export * from "./line.js";
@@ -22,20 +7,4 @@ export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
 export * from "./radar.js";
-// 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.
- */
-export 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.
- */
-export function isBarSeries(series) {
-  return series.type === 'bar';
-}
+export {};

package/esm/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/esm/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/esm/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/esm/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/hooks/getValueToPositionMapper.d.ts

@@ -0,0 +1,12 @@
+import type { D3Scale } from "../models/axis.js";
+/**
+ * For a given scale return a function that map value to their position.
+ * Useful when dealing with specific scale such as band.
+ * @param {D3Scale} scale The scale to use
+ * @returns {(value: any) => number} A function that map value to their position
+ */
+export declare function getValueToPositionMapper<Domain extends {
+  toString(): string;
+} = {
+  toString(): string;
+}, Range = number>(scale: D3Scale<Domain, Range>): (value: any) => number;

package/hooks/getValueToPositionMapper.js

@@ -0,0 +1,26 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getValueToPositionMapper = getValueToPositionMapper;
+var _scaleGuards = require("../internals/scaleGuards");
+/**
+ * For a given scale return a function that map value to their position.
+ * Useful when dealing with specific scale such as band.
+ * @param {D3Scale} scale The scale to use
+ * @returns {(value: any) => number} A function that map value to their position
+ */
+function getValueToPositionMapper(scale) {
+  if ((0, _scaleGuards.isOrdinalScale)(scale)) {
+    return value => (scale(value) ?? 0) + scale.bandwidth() / 2;
+  }
+  const domain = scale.domain();
+
+  // Fixes https://github.com/mui/mui-x/issues/18999#issuecomment-3173787401
+  if (domain[0] === domain[1]) {
+    return value => value === domain[0] ? scale(value) : NaN;
+  }
+  return value => scale(value);
+}

package/hooks/index.d.ts

@@ -20,4 +20,8 @@ export * from "./animation/index.js";
 export * from "./useChartRootRef.js";
 export * from "./useChartsLocalization.js";
 export * from "./useBrush.js";
-export * from "./useFocusedItem.js";
+export * from "./useFocusedItem.js";
+export { useXAxisCoordinates, useYAxisCoordinates, type AxisCoordinates } from "./useAxisCoordinates.js";
+export * from "./useAxisTicks.js";
+export { type TickItem } from "./useTicks.js";
+export * from "./getValueToPositionMapper.js";

package/hooks/index.js

@@ -7,7 +7,9 @@ var _exportNames = {
   usePieSeries: true,
   usePieSeriesContext: true,
   useChartGradientId: true,
-  useChartGradientIdObjectBound: true
+  useChartGradientIdObjectBound: true,
+  useXAxisCoordinates: true,
+  useYAxisCoordinates: true
 };
 Object.defineProperty(exports, "useChartGradientId", {
   enumerable: true,
@@ -33,6 +35,18 @@ Object.defineProperty(exports, "usePieSeriesContext", {
     return _usePieSeries.usePieSeriesContext;
   }
 });
+Object.defineProperty(exports, "useXAxisCoordinates", {
+  enumerable: true,
+  get: function () {
+    return _useAxisCoordinates.useXAxisCoordinates;
+  }
+});
+Object.defineProperty(exports, "useYAxisCoordinates", {
+  enumerable: true,
+  get: function () {
+    return _useAxisCoordinates.useYAxisCoordinates;
+  }
+});
 var _useDrawingArea = require("./useDrawingArea");
 Object.keys(_useDrawingArea).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -286,4 +300,29 @@ Object.keys(_useFocusedItem).forEach(function (key) {
       return _useFocusedItem[key];
     }
   });
+});
+var _useAxisCoordinates = require("./useAxisCoordinates");
+var _useAxisTicks = require("./useAxisTicks");
+Object.keys(_useAxisTicks).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useAxisTicks[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useAxisTicks[key];
+    }
+  });
+});
+var _getValueToPositionMapper = require("./getValueToPositionMapper");
+Object.keys(_getValueToPositionMapper).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _getValueToPositionMapper[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getValueToPositionMapper[key];
+    }
+  });
 });

package/hooks/useAxisCoordinates.d.ts

@@ -0,0 +1,30 @@
+import { type ChartDrawingArea } from "./useDrawingArea.js";
+import { type AxisId, type ComputedXAxis, type ComputedYAxis } from "../models/axis.js";
+export interface AxisCoordinates {
+  left: number;
+  top: number;
+  right: number;
+  bottom: number;
+}
+export declare function getXAxisCoordinates(drawingArea: ChartDrawingArea, computedAxis: {
+  position?: ComputedXAxis['position'];
+  offset: number;
+  height: number;
+}): AxisCoordinates | null;
+/**
+ * Get the coordinates of the given X axis. The coordinates are relative to the SVG's origin.
+ * @param axisId The id of the X axis.
+ * @returns {AxisCoordinates | null} The coordinates of the X axis or null if the axis does not exist or has position: 'none'.
+ */
+export declare function useXAxisCoordinates(axisId: AxisId): AxisCoordinates | null;
+export declare function getYAxisCoordinates(drawingArea: ChartDrawingArea, computedAxis: {
+  position?: ComputedYAxis['position'];
+  offset: number;
+  width: number;
+}): AxisCoordinates | null;
+/**
+ * Returns the coordinates of the given Y axis. The coordinates are relative to the SVG's origin.
+ * @param axisId The id of the Y axis.
+ * @returns {AxisCoordinates | null} The coordinates of the Y axis or null if the axis does not exist or has position: 'none'.
+ */
+export declare function useYAxisCoordinates(axisId: AxisId): AxisCoordinates | null;