@mui/x-charts 8.21.0 → 8.22.0

package/esm/internals/plugins/models/seriesConfig/seriesConfig.types.d.ts

@@ -4,10 +4,10 @@ import type { ColorProcessor } from "./colorProcessor.types.js";
 import type { CartesianExtremumGetter } from "./cartesianExtremumGetter.types.js";
 import type { LegendGetter } from "./legendGetter.types.js";
 import type { AxisTooltipGetter, TooltipGetter } from "./tooltipGetter.types.js";
-import { PolarExtremumGetter } from "./polarExtremumGetter.types.js";
-import { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
-import { TooltipItemPositionGetter } from "./tooltipItemPositionGetter.types.js";
-import { SeriesLayoutGetter } from "./seriesLayout.types.js";
+import { type PolarExtremumGetter } from "./polarExtremumGetter.types.js";
+import { type GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
+import { type TooltipItemPositionGetter } from "./tooltipItemPositionGetter.types.js";
+import { type SeriesLayoutGetter } from "./seriesLayout.types.js";
 export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   seriesProcessor: SeriesProcessor<TSeriesType>;
   /**

package/esm/internals/plugins/models/seriesConfig/seriesLayout.types.d.ts

@@ -1,6 +1,6 @@
 import type { ChartSeriesType, ChartSeriesLayout } from "../../../../models/seriesType/config.js";
-import { ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
+import { type ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
 import type { SeriesId } from "../../../../models/seriesType/common.js";
-import { SeriesProcessorResult } from "./seriesProcessor.types.js";
+import { type SeriesProcessorResult } from "./seriesProcessor.types.js";
 export type SeriesLayoutGetterResult<TSeriesType extends ChartSeriesType> = Record<SeriesId, ChartSeriesLayout<TSeriesType>>;
 export type SeriesLayoutGetter<TSeriesType extends ChartSeriesType> = (params: SeriesProcessorResult<TSeriesType>, drawingArea: Readonly<ChartDrawingArea>) => SeriesLayoutGetterResult<TSeriesType>;

package/esm/internals/plugins/models/seriesConfig/tooltipGetter.types.d.ts

@@ -1,13 +1,13 @@
-import type { ChartItemIdentifierWithData, ChartSeriesDefaultized, ChartSeriesType, ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
-import { SeriesId } from "../../../../models/seriesType/common.js";
-import { AxisId, ChartsRotationAxisProps, ChartsRadiusAxisProps, PolarAxisDefaultized, ComputedXAxis, ComputedYAxis } from "../../../../models/axis.js";
-import { ChartsLabelMarkProps } from "../../../../ChartsLabel/ChartsLabelMark.js";
-import { ColorGetter } from "./colorProcessor.types.js";
+import type { ChartItemIdentifier, ChartSeriesDefaultized, ChartSeriesType, ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
+import { type SeriesId } from "../../../../models/seriesType/common.js";
+import { type AxisId, type ChartsRotationAxisProps, type ChartsRadiusAxisProps, type PolarAxisDefaultized, type ComputedXAxis, type ComputedYAxis } from "../../../../models/axis.js";
+import { type ChartsLabelMarkProps } from "../../../../ChartsLabel/ChartsLabelMark.js";
+import { type ColorGetter } from "./colorProcessor.types.js";
 export interface ItemTooltip<T extends ChartSeriesType> {
   /**
    * An object that identifies the item to display.
    */
-  identifier: ChartItemIdentifierWithData<T>;
+  identifier: ChartItemIdentifier<T>;
   /**
    * The color associated with the item.
    */
@@ -59,7 +59,7 @@ export type TooltipGetter<TSeriesType extends ChartSeriesType> = (params: {
   series: ChartSeriesDefaultized<TSeriesType>;
   axesConfig: TooltipGetterAxesConfig;
   getColor: ColorGetter<TSeriesType>;
-  identifier: ChartItemIdentifierWithData<TSeriesType> | null;
+  identifier: ChartItemIdentifier<TSeriesType> | null;
 }) => (TSeriesType extends 'radar' ? ItemTooltipWithMultipleValues<TSeriesType> : ItemTooltip<TSeriesType>) | null;
 /**
  * If `axisId` is set to undefined, the default axis will be used.

package/esm/internals/plugins/models/seriesConfig/tooltipItemPositionGetter.types.d.ts

@@ -1,8 +1,8 @@
-import type { ChartItemIdentifierWithData, ChartSeriesType } from "../../../../models/seriesType/config.js";
-import { ChartsRotationAxisProps, ChartsRadiusAxisProps, ComputedXAxis, ComputedYAxis } from "../../../../models/axis.js";
-import { ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
-import { ProcessedSeries, SeriesLayout } from "../../corePlugins/useChartSeries/index.js";
-import { ComputeResult } from "../../featurePlugins/useChartPolarAxis/computeAxisValue.js";
+import type { ChartItemIdentifier, ChartSeriesType } from "../../../../models/seriesType/config.js";
+import { type ChartsRotationAxisProps, type ChartsRadiusAxisProps, type ComputedXAxis, type ComputedYAxis } from "../../../../models/axis.js";
+import { type ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
+import { type ProcessedSeries, type SeriesLayout } from "../../corePlugins/useChartSeries/index.js";
+import { type ComputeResult } from "../../featurePlugins/useChartPolarAxis/computeAxisValue.js";
 export interface TooltipPositionGetterAxesConfig {
   x?: ComputedXAxis;
   y?: ComputedYAxis;
@@ -13,7 +13,7 @@ export type TooltipItemPositionGetter<TSeriesType extends ChartSeriesType> = (pa
   series: ProcessedSeries<TSeriesType>;
   axesConfig: TooltipPositionGetterAxesConfig;
   drawingArea: ChartDrawingArea;
-  identifier: ChartItemIdentifierWithData<TSeriesType> | null;
+  identifier: ChartItemIdentifier<TSeriesType> | null;
   seriesLayout: SeriesLayout<TSeriesType>;
   /**
    * The preferred placement of the tooltip related to the element.

package/esm/internals/plugins/utils/selectors.d.ts

@@ -1,5 +1,5 @@
 import type { Selector } from 'reselect';
-import { ChartAnyPluginSignature } from "../models/plugin.js";
-import { ChartState } from "../models/chart.js";
+import { type ChartAnyPluginSignature } from "../models/plugin.js";
+import { type ChartState } from "../models/chart.js";
 export type ChartRootSelector<TSignature extends ChartAnyPluginSignature, T extends keyof TSignature['state'] = keyof TSignature['state']> = Selector<ChartState<[TSignature]>, TSignature['state'][T]>;
 export type ChartOptionalRootSelector<TSignature extends ChartAnyPluginSignature> = Selector<ChartState<[], [TSignature]>, TSignature['state'][keyof TSignature['state']] | undefined>;

package/esm/internals/plugins/utils/useLazySelectorEffect.d.ts

@@ -1,5 +1,5 @@
 import type { Store } from '@mui/x-internals/store';
-import { ChartAnyPluginSignature, ChartState } from "../models/index.js";
+import { type ChartAnyPluginSignature, type ChartState } from "../models/index.js";
 export declare function useLazySelectorEffect<TSignatures extends readonly ChartAnyPluginSignature[], Value>(store: Store<ChartState<TSignatures>>, selector: (state: ChartState<TSignatures>) => Value, effect: (previous: Value, next: Value) => void,
 /**
  * If true, the selector will be ignored.

package/esm/internals/scaleGuards.d.ts

@@ -1,5 +1,5 @@
 import type { ScaleBand } from '@mui/x-charts-vendor/d3-scale';
-import { D3OrdinalScale, D3Scale } from "../models/axis.js";
+import { type D3OrdinalScale, type D3Scale } from "../models/axis.js";
 export declare function isOrdinalScale<Domain extends {
   toString(): string;
 } = {

package/esm/internals/scales/scaleSymlog.d.ts

@@ -1,4 +1,4 @@
-import { NumberValue, ScaleSymLog } from '@mui/x-charts-vendor/d3-scale';
+import { type NumberValue, type ScaleSymLog } from '@mui/x-charts-vendor/d3-scale';
 /**
  * Constructs a new continuous scale with the specified range, the constant 1, the default interpolator and clamping disabled.
  * The domain defaults to [0, 1].

package/esm/internals/seriesSelectorOfType.d.ts

@@ -1,12 +1,12 @@
-import { ChartSeriesDefaultized, ChartsSeriesConfig } from "../models/seriesType/config.js";
-import { SeriesId } from "../models/seriesType/common.js";
+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<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig) => import("./index.js").SeriesProcessorResult<"line"> | {
+}, seriesType: keyof ChartsSeriesConfig) => import("./index.js").SeriesProcessorResult<"line"> | import("./index.js").SeriesProcessorResult<"bar"> | {
   series: Record<SeriesId, import("../index.js").DefaultizedScatterSeriesType>;
   seriesOrder: SeriesId[];
-} | import("./index.js").SeriesProcessorResult<"bar"> | {
+} | {
   series: Record<SeriesId, import("../index.js").DefaultizedPieSeriesType>;
   seriesOrder: SeriesId[];
 } | {
@@ -15,6 +15,6 @@ export declare const selectorAllSeriesOfType: (args_0: import("./plugins/corePlu
 } | 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<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig, ids?: SeriesId | SeriesId[] | undefined) => import("../index.js").DefaultizedRadarSeriesType | 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 | undefined)[] | undefined;
+}, 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;
 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/stackSeries.d.ts

@@ -1,6 +1,6 @@
-import { Series } from '@mui/x-charts-vendor/d3-shape';
+import { stackOrderAppearance as d3StackOrderAppearance, stackOrderAscending as d3StackOrderAscending, stackOrderDescending as d3StackOrderDescending, stackOrderInsideOut as d3StackOrderInsideOut, stackOrderNone as d3StackOrderNone, stackOrderReverse as d3StackOrderReverse, stackOffsetExpand as d3StackOffsetExpand, stackOffsetDiverging as d3StackOffsetDiverging, 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 { SeriesId, StackableSeriesType } from "../models/seriesType/common.js";
+import { type SeriesId, type StackableSeriesType } from "../models/seriesType/common.js";
 type FormatterParams<T> = {
   series: Record<SeriesId, T>;
   seriesOrder: SeriesId[];
@@ -14,8 +14,54 @@ export type StackingGroupsType = {
   stackingOrder: (series: Series<any, any>) => number[];
   stackingOffset: (series: Series<any, any>, order: Iterable<number>) => void;
 }[];
-export declare const StackOrder: { [key in StackOrderType]: (series: Series<any, any>) => number[] };
-export declare const StackOffset: { [key in StackOffsetType]: (series: Series<any, any>, order: Iterable<number>) => void };
+export declare const StackOrder: {
+  /**
+   * Series order such that the earliest series (according to the maximum value) is at the bottom.
+   * */
+  appearance: typeof d3StackOrderAppearance;
+  /**
+   *  Series order such that the smallest series (according to the sum of values) is at the bottom.
+   * */
+  ascending: typeof d3StackOrderAscending;
+  /**
+   * Series order such that the largest series (according to the sum of values) is at the bottom.
+   */
+  descending: typeof d3StackOrderDescending;
+  /**
+   * Series order such that the earliest series (according to the maximum value) are on the inside and the later series are on the outside. This order is recommended for streamgraphs in conjunction with the wiggle offset. See Stacked Graphs—Geometry & Aesthetics by Byron & Wattenberg for more information.
+   */
+  insideOut: typeof d3StackOrderInsideOut;
+  /**
+   * Given series order [0, 1, … n - 1] where n is the number of elements in series. Thus, the stack order is given by the key accessor.
+   */
+  none: typeof d3StackOrderNone;
+  /**
+   * Reverse of the given series order [n - 1, n - 2, … 0] where n is the number of elements in series. Thus, the stack order is given by the reverse of the key accessor.
+   */
+  reverse: typeof d3StackOrderReverse;
+};
+export declare const StackOffset: {
+  /**
+   * Applies a zero baseline and normalizes the values for each point such that the topline is always one.
+   * */
+  expand: typeof d3StackOffsetExpand;
+  /**
+   * Positive values are stacked above zero, negative values are stacked below zero, and zero values are stacked at zero.
+   * */
+  diverging: typeof d3StackOffsetDiverging;
+  /**
+   * Applies a zero baseline.
+   * */
+  none: typeof d3StackOffsetNone;
+  /**
+   * Shifts the baseline down such that the center of the streamgraph is always at zero.
+   * */
+  silhouette: typeof d3StackOffsetSilhouette;
+  /**
+   * Shifts the baseline so as to minimize the weighted wiggle of layers. This offset is recommended for streamgraphs in conjunction with the inside-out order. See Stacked Graphs—Geometry & Aesthetics by Bryon & Wattenberg for more information.
+   * */
+  wiggle: typeof d3StackOffsetWiggle;
+};
 /**
  * Takes a set of series and groups their ids
  * @param series the object of all bars series

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

@@ -1,6 +1,6 @@
-import { ChartCorePluginSignatures } from "../plugins/corePlugins/index.js";
-import { ChartPluginSignature, ConvertSignaturesIntoPlugins, MergeSignaturesProperty } from "../plugins/models/index.js";
-import { UseChartBaseProps } from "./useCharts.types.js";
+import { type ChartCorePluginSignatures } from "../plugins/corePlugins/index.js";
+import { type ChartPluginSignature, type ConvertSignaturesIntoPlugins, type MergeSignaturesProperty } from "../plugins/models/index.js";
+import { type UseChartBaseProps } from "./useCharts.types.js";
 export declare const extractPluginParamsFromProps: <TSignatures extends readonly ChartPluginSignature<any>[], TProps extends Partial<UseChartBaseProps<TSignatures>>>({
   props: {
     apiRef,

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

@@ -1,9 +1,9 @@
 import * as React from 'react';
 import { Store } from '@mui/x-internals/store';
-import { ChartAnyPluginSignature, ChartInstance, ChartPublicAPI, ChartState, ConvertSignaturesIntoPlugins } from "../plugins/models/index.js";
-import { UseChartBaseProps } from "./useCharts.types.js";
-import { ChartSeriesType } from "../../models/seriesType/config.js";
-import { ChartSeriesConfig } from "../plugins/models/seriesConfig/index.js";
+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.
  *

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

@@ -1,5 +1,5 @@
-import * as React from 'react';
-import { ChartAnyPluginSignature, ChartPublicAPI } from "../plugins/models/index.js";
+import type * as React from 'react';
+import { type ChartAnyPluginSignature, type ChartPublicAPI } from "../plugins/models/index.js";
 export interface UseChartBaseProps<TSignatures extends readonly ChartAnyPluginSignature[]> {
   apiRef?: React.RefObject<ChartPublicAPI<TSignatures> | undefined>;
 }

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

@@ -1,3 +1,3 @@
-import { Store } from '@mui/x-internals/store';
-import { ChartAnyPluginSignature, ChartState } from "../plugins/models/index.js";
+import { type Store } from '@mui/x-internals/store';
+import { type ChartAnyPluginSignature, type ChartState } from "../plugins/models/index.js";
 export declare function useStore<TSignatures extends ChartAnyPluginSignature[] = []>(): Store<ChartState<TSignatures>>;

package/esm/locales/elGR.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const elGRLocaleText: Partial<ChartsLocaleText>;
 export declare const elGR: {
   components: {

package/esm/locales/enUS.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const enUSLocaleText: ChartsLocaleText;
 export declare const DEFAULT_LOCALE: ChartsLocaleText;
 export declare const enUS: {

package/esm/locales/frFR.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const frFRLocalText: Partial<ChartsLocaleText>;
 export declare const frFR: {
   components: {

package/esm/locales/nbNO.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const nbNOLocaleText: Partial<ChartsLocaleText>;
 export declare const nbNO: {
   components: {

package/esm/locales/ptBR.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const ptBRLocaleText: Partial<ChartsLocaleText>;
 export declare const ptBR: {
   components: {

package/esm/locales/ptPT.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const ptPTLocaleText: Partial<ChartsLocaleText>;
 export declare const ptPT: {
   components: {

package/esm/locales/svSE.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./utils/chartsLocaleTextApi.js";
 export declare const svSELocaleText: Partial<ChartsLocaleText>;
 export declare const svSE: {
   components: {

package/esm/locales/utils/chartsLocaleTextApi.d.ts

@@ -1,4 +1,4 @@
-import { ChartImageExportMimeType } from "./imageMimeTypes.js";
+import { type ChartImageExportMimeType } from "./imageMimeTypes.js";
 export interface ChartsLocaleText {
   /**
    * Title displayed in the overlay if `loading` is `true`.

package/esm/locales/utils/getChartsLocalization.d.ts

@@ -1,4 +1,4 @@
-import { ChartsLocaleText } from "./chartsLocaleTextApi.js";
+import { type ChartsLocaleText } from "./chartsLocaleTextApi.js";
 /**
  * Helper to pass translation to all charts thanks to the MUI theme.
  * @param chartsTranslations The translation object.

package/esm/models/axis.d.ts

@@ -1,11 +1,12 @@
 import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime, ScaleSymLog, NumberValue } from '@mui/x-charts-vendor/d3-scale';
-import { SxProps } from '@mui/system/styleFunctionSx';
-import { type MakeOptional, MakeRequired } from '@mui/x-internals/types';
+import { type SxProps } from '@mui/system/styleFunctionSx';
+import { type MakeOptional, type MakeRequired } from '@mui/x-internals/types';
 import type { DefaultizedZoomOptions } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
-import { ChartsAxisClasses } from "../ChartsAxis/axisClasses.js";
+import { type ChartsAxisClasses } from "../ChartsAxis/axisClasses.js";
 import type { TickParams } from "../hooks/useTicks.js";
-import { ChartsTextProps } from "../ChartsText/index.js";
-import { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
+import type { ChartsTextProps } from "../ChartsText/index.js";
+import type { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
+import type { OrdinalTimeTicks } from "./timeTicks.js";
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
   toString(): string;
@@ -229,6 +230,10 @@ export type AxisGroups = {
 export interface AxisScaleConfig {
   band: {
     scaleType: 'band';
+    /**
+     * Definition of the tick placements with date data.
+     */
+    ordinalTimeTicks?: OrdinalTimeTicks;
     scale: ScaleBand<{
       toString(): string;
     }>;
@@ -248,6 +253,10 @@ export interface AxisScaleConfig {
   } & AxisGroups & Pick<TickParams, 'tickPlacement' | 'tickLabelPlacement'>;
   point: {
     scaleType: 'point';
+    /**
+     * Definition of the tick placements with date data.
+     */
+    ordinalTimeTicks?: OrdinalTimeTicks;
     scale: ScalePoint<{
       toString(): string;
     }>;
@@ -542,7 +551,7 @@ export type DefaultedAxis<S extends ScaleName = ScaleName, V = any, AxisProps ex
 /**
  * The x-axis configuration with missing values filled with default values.
  */
-export type DefaultedXAxis<S extends ScaleName = ScaleName, V = any> = DefaultedAxis<S, V, ChartsXAxisProps>;
+export type DefaultedXAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? DefaultedAxis<S, V, ChartsXAxisProps> : never;
 /**
  * The y-axis configuration with missing values filled with default values.
  */

package/esm/models/index.d.ts

@@ -4,4 +4,5 @@ export * from "./slots/index.js";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData, XAxis, YAxis, RadiusAxis, RotationAxis, AxisItemIdentifier, AxisValueFormatterContext } from "./axis.js";
 export type { PropsFromSlot } from '@mui/x-internals/slots';
 export type { Position } from "./position.js";
-export type { CurveType } from "./curve.js";
+export type { CurveType } from "./curve.js";
+export type { TickFrequency, OrdinalTimeTicks, TickFrequencyDefinition } from "./timeTicks.js";

package/esm/models/seriesType/bar.d.ts

@@ -1,7 +1,7 @@
-import { DefaultizedProps } from '@mui/x-internals/types';
+import { type DefaultizedProps } from '@mui/x-internals/types';
 import type { StackOffsetType } from "../stacking.js";
-import { CartesianSeriesType, CommonSeriesType, CommonDefaultizedProps, StackableSeriesType, SeriesId } from "./common.js";
-import { BarItem, BarLabelContext } from "../../BarChart/index.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 {
   type: 'bar';

package/esm/models/seriesType/common.d.ts

@@ -1,7 +1,10 @@
-import { HighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.js";
+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 { AxisId } from "../axis.js";
+import { type AxisId } from "../axis.js";
+/**
+ * The unique identifier of a series.
+ */
 export type SeriesId = number | string;
 export type SeriesValueFormatterContext = {
   /**

package/esm/models/seriesType/config.d.ts

@@ -1,10 +1,10 @@
-import { DefaultizedProps, MakeOptional, MakeRequired } from '@mui/x-internals/types';
-import { ScatterSeriesType, DefaultizedScatterSeriesType, ScatterItemIdentifier, ScatterValueType } from "./scatter.js";
-import { LineSeriesType, DefaultizedLineSeriesType, LineItemIdentifier } from "./line.js";
-import { BarItemIdentifier, BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
-import { PieSeriesType, DefaultizedPieSeriesType, PieItemIdentifier, PieValueType, DefaultizedPieValueType } from "./pie.js";
-import { DefaultizedRadarSeriesType, RadarItemIdentifier, RadarSeriesType } from "./radar.js";
-import { SeriesColor } from "./common.js";
+import type { DefaultizedProps, MakeOptional, MakeRequired } from '@mui/x-internals/types';
+import type { ScatterSeriesType, DefaultizedScatterSeriesType, ScatterItemIdentifier, ScatterValueType } from "./scatter.js";
+import type { LineSeriesType, DefaultizedLineSeriesType, LineItemIdentifier } from "./line.js";
+import type { BarItemIdentifier, BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
+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";
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -56,7 +56,7 @@ export interface ChartsSeriesConfig {
       data: Array<MakeOptional<PieValueType, 'id'> & MakeRequired<SeriesColor<PieValueType | null>, 'color'>>;
     };
     series: DefaultizedPieSeriesType;
-    seriesLayout: {};
+    seriesLayout: PieSeriesLayout;
     seriesProp: PieSeriesType<MakeOptional<PieValueType, 'id'>>;
     itemIdentifier: PieItemIdentifier;
     itemIdentifierWithData: PieItemIdentifier;

package/esm/models/seriesType/index.d.ts

@@ -1,5 +1,5 @@
-import { BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
-import { CartesianChartSeriesType, ChartSeriesType, ChartsSeriesConfig, StackableChartSeriesType } from "./config.js";
+import { type BarSeriesType, type DefaultizedBarSeriesType } from "./bar.js";
+import { type CartesianChartSeriesType, type ChartSeriesType, type ChartsSeriesConfig, type StackableChartSeriesType } 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.

package/esm/models/seriesType/line.d.ts

@@ -1,7 +1,7 @@
-import { DefaultizedProps } from '@mui/x-internals/types';
+import { type DefaultizedProps } from '@mui/x-internals/types';
 import type { StackOffsetType } from "../stacking.js";
-import { CartesianSeriesType, CommonDefaultizedProps, CommonSeriesType, SeriesId, StackableSeriesType } from "./common.js";
-import { CurveType } from "../curve.js";
+import { type CartesianSeriesType, type CommonDefaultizedProps, type CommonSeriesType, type SeriesId, type StackableSeriesType } from "./common.js";
+import { type CurveType } from "../curve.js";
 export interface ShowMarkParams<AxisValue = number | Date> {
   /**
    * The item index.

package/esm/models/seriesType/pie.d.ts

@@ -1,6 +1,6 @@
-import { PieArcDatum as D3PieArcDatum } from '@mui/x-charts-vendor/d3-shape';
-import { DefaultizedProps } from '@mui/x-internals/types';
-import { CommonDefaultizedProps, CommonSeriesType, SeriesId } from "./common.js";
+import { type PieArcDatum as D3PieArcDatum } from '@mui/x-charts-vendor/d3-shape';
+import { type DefaultizedProps } from '@mui/x-internals/types';
+import { type CommonDefaultizedProps, type CommonSeriesType, type SeriesId } from "./common.js";
 import type { ChartsLabelMarkProps } from "../../ChartsLabel/index.js";
 export type PieItemId = string | number;
 export type PieValueType = {
@@ -163,4 +163,39 @@ export interface ComputedPieRadius {
    * @default (innerRadius - outerRadius) / 2
    */
   arcLabelRadius?: number;
-}
+}
+/**
+ * Layout information computed from the pie series and the drawing area.
+ */
+export type PieSeriesLayout = {
+  /**
+   * The pie center coordinate in px.
+   */
+  center: {
+    x: number;
+    y: number;
+  };
+  /**
+   * The pie radius in px.
+   * Computed based on the drawing area and the center placement.
+   */
+  radius: {
+    /**
+     * The maximum available radius in px.
+     * Correspond to radius='100%'.
+     */
+    available: number;
+    /**
+     * The pie inner radius in px, except if overridden by item state (highlight/faded).
+     */
+    inner: number;
+    /**
+     * The pie outer radius in px, except if overridden by item state (highlight/faded).
+     */
+    outer: number;
+    /**
+     * The pie label radius in px, except if overridden by item state (highlight/faded).
+     */
+    label: number;
+  };
+};

package/esm/models/seriesType/radar.d.ts

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

package/esm/models/seriesType/scatter.d.ts

@@ -1,5 +1,5 @@
-import { DefaultizedProps, MakeRequired } from '@mui/x-internals/types';
-import { CartesianSeriesType, CommonDefaultizedProps, CommonSeriesType, SeriesId } from "./common.js";
+import { type DefaultizedProps, type MakeRequired } from '@mui/x-internals/types';
+import { type CartesianSeriesType, type CommonDefaultizedProps, type CommonSeriesType, type SeriesId } from "./common.js";
 export type ScatterValueType = {
   x: number;
   y: number;

package/esm/models/slots/chartsBaseSlots.d.ts

@@ -1,5 +1,5 @@
-import * as React from 'react';
-import { ChartBaseButtonProps, ChartBaseIconButtonProps } from "./chartsBaseSlotProps.js";
+import type * as React from 'react';
+import { type ChartBaseButtonProps, type ChartBaseIconButtonProps } from "./chartsBaseSlotProps.js";
 export interface ChartsBaseSlots {
   baseButton: React.ComponentType<ChartBaseButtonProps>;
   baseIconButton: React.ComponentType<ChartBaseIconButtonProps>;

package/esm/models/timeTicks.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Definition of a tick frequency for time ordinal axes.
+ */
+export type TickFrequencyDefinition = {
+  /**
+   * Returns the number of ticks in the given date range for this tick frequency.
+   * @param {Date} from The first date of the range.
+   * @param {Date} to The last date of the range.
+   * @returns {number} The number of ticks in the [from, to] range.
+   */
+  getTickNumber: (from: Date, to: Date) => number;
+  /**
+   * Decides if the current date should be shown as a tick.
+   * @param {Date} prev The date before the current date.
+   * @param {Date} value The current date to check.
+   * @returns {boolean} Whether the current date is a tick or not.
+   */
+  isTick: (prev: Date, value: Date) => boolean;
+  /**
+   * Format the tick value for display.
+   * @param {Date} date The tick value to format.
+   * @returns {string} The formatted date string.
+   */
+  format: (date: Date) => string;
+};
+/**
+ * The predefined tick frequencies for time ordinal axes.
+ * - 'years': displays the year, placing ticks at the start of each year
+ * - 'quarterly': displays the month, placing ticks at the start of each quarter
+ * - 'months': displays the month, placing ticks at the start of each month
+ * - 'biweekly': displays the day, placing ticks every two weeks
+ * - 'weeks': displays the day, placing ticks at the start of each week
+ * - 'days': displays the day, placing ticks at the start of each day
+ * - 'hours': displays the hour and minutes, placing ticks at the start of each hour
+ */
+export type TickFrequency = 'years' | 'quarterly' | 'months' | 'biweekly' | 'weeks' | 'days' | 'hours';
+export type OrdinalTimeTicks = (TickFrequencyDefinition | TickFrequency)[];

package/esm/models/timeTicks.js

@@ -0,0 +1 @@
+export {};

package/esm/models/z-axis.d.ts

@@ -1,5 +1,5 @@
 import type { ScaleOrdinal, ScaleSequential, ScaleThreshold } from '@mui/x-charts-vendor/d3-scale';
-import { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
+import { type ContinuousColorConfig, type OrdinalColorConfig, type PiecewiseColorConfig } from "./colorMapping.js";
 export interface ZAxisConfig<V = any> {
   id: string;
   data?: readonly V[];

package/esm/plugins/index.d.ts

@@ -1,5 +1,6 @@
 export { useChartCartesianAxis, type UseChartCartesianAxisSignature } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
 export { useChartHighlight, type UseChartHighlightSignature } from "../internals/plugins/featurePlugins/useChartHighlight/index.js";
+export { useChartTooltip, type UseChartTooltipSignature } from "../internals/plugins/featurePlugins/useChartTooltip/index.js";
 export { useChartInteraction, type UseChartInteractionSignature } from "../internals/plugins/featurePlugins/useChartInteraction/index.js";
 export { useChartPolarAxis, type UseChartPolarAxisSignature } from "../internals/plugins/featurePlugins/useChartPolarAxis/index.js";
 export { useChartClosestPoint, type UseChartClosestPointSignature } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";

package/esm/plugins/index.js

@@ -6,6 +6,7 @@
 // Feature plugins
 export { useChartCartesianAxis } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
 export { useChartHighlight } from "../internals/plugins/featurePlugins/useChartHighlight/index.js";
+export { useChartTooltip } from "../internals/plugins/featurePlugins/useChartTooltip/index.js";
 export { useChartInteraction } from "../internals/plugins/featurePlugins/useChartInteraction/index.js";
 export { useChartPolarAxis } from "../internals/plugins/featurePlugins/useChartPolarAxis/index.js";
 export { useChartClosestPoint } from "../internals/plugins/featurePlugins/useChartClosestPoint/index.js";

package/esm/themeAugmentation/components.d.ts

@@ -1,4 +1,4 @@
-import { ComponentsProps, ComponentsOverrides } from '@mui/material/styles';
+import { type ComponentsProps, type ComponentsOverrides } from '@mui/material/styles';
 export interface ChartsComponents<Theme = unknown> {
   MuiChartsAxis?: {
     styleOverrides?: ComponentsOverrides<Theme>['MuiChartsAxis'];