@mui/x-charts 8.20.0 → 8.22.0

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

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.d.ts

@@ -1,3 +1,3 @@
-import { ChartPlugin } from "../../models/index.js";
-import { UseChartZAxisSignature } from "./useChartZAxis.types.js";
+import { type ChartPlugin } from "../../models/index.js";
+import { type UseChartZAxisSignature } from "./useChartZAxis.types.js";
 export declare const useChartZAxis: ChartPlugin<UseChartZAxisSignature>;

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

@@ -1,8 +1,8 @@
-import { MakeOptional } from '@mui/x-internals/types';
-import { ChartPluginSignature } from "../../models/index.js";
-import { DatasetType } from "../../../../models/seriesType/config.js";
-import { AxisId } from "../../../../models/axis.js";
-import { ZAxisConfig, ZAxisDefaultized } from "../../../../models/z-axis.js";
+import { type MakeOptional } from '@mui/x-internals/types';
+import { type ChartPluginSignature } from "../../models/index.js";
+import { type DatasetType } from "../../../../models/seriesType/config.js";
+import { type AxisId } from "../../../../models/axis.js";
+import { type ZAxisConfig, type ZAxisDefaultized } from "../../../../models/z-axis.js";
 type DefaultizedZAxisConfig = {
   [axisId: string]: ZAxisDefaultized;
 };

package/internals/plugins/models/plugin.d.ts

@@ -1,9 +1,9 @@
-import * as React from 'react';
-import { Store } from '@mui/x-internals/store';
+import type * as React from 'react';
+import { type Store } from '@mui/x-internals/store';
 import type { MergeSignaturesProperty, OptionalIfEmpty } from "./helpers.js";
 import type { ChartCorePluginSignatures } from "../corePlugins/index.js";
-import { ChartSeriesConfig } from "./seriesConfig/index.js";
-import { ChartState } from "./chart.js";
+import { type ChartSeriesConfig } from "./seriesConfig/index.js";
+import { type ChartState } from "./chart.js";
 export interface ChartPluginOptions<TSignature extends ChartAnyPluginSignature> {
   /**
    * An imperative api available for internal use.

package/internals/plugins/models/seriesConfig/index.d.ts

@@ -3,6 +3,7 @@ export * from "./cartesianExtremumGetter.types.js";
 export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
+export * from "./seriesLayout.types.js";
 export * from "./tooltipGetter.types.js";
 export * from "./tooltipItemPositionGetter.types.js";
 export * from "./legendGetter.types.js";

package/internals/plugins/models/seriesConfig/index.js

@@ -58,6 +58,17 @@ Object.keys(_seriesProcessor).forEach(function (key) {
     }
   });
 });
+var _seriesLayout = require("./seriesLayout.types");
+Object.keys(_seriesLayout).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _seriesLayout[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _seriesLayout[key];
+    }
+  });
+});
 var _tooltipGetter = require("./tooltipGetter.types");
 Object.keys(_tooltipGetter).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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

@@ -4,11 +4,16 @@ 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 { 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>;
+  /**
+   * A processor to add series layout when the layout does not depend from other series.
+   */
+  seriesLayout?: SeriesLayoutGetter<TSeriesType>;
   colorProcessor: ColorProcessor<TSeriesType>;
   legendGetter: LegendGetter<TSeriesType>;
   tooltipGetter: TooltipGetter<TSeriesType>;

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

@@ -0,0 +1,6 @@
+import type { ChartSeriesType, ChartSeriesLayout } from "../../../../models/seriesType/config.js";
+import { type ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
+import type { SeriesId } from "../../../../models/seriesType/common.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/internals/plugins/models/seriesConfig/seriesLayout.types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/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/internals/plugins/models/seriesConfig/tooltipItemPositionGetter.types.d.ts

@@ -1,18 +1,20 @@
-import type { ChartItemIdentifierWithData, ChartSeriesType } from "../../../../models/seriesType/config.js";
-import { ChartsRotationAxisProps, ChartsRadiusAxisProps, PolarAxisDefaultized, ComputedXAxis, ComputedYAxis } from "../../../../models/axis.js";
-import { ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
-import { ProcessedSeries } from "../../corePlugins/useChartSeries/index.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;
-  rotation?: PolarAxisDefaultized<any, any, ChartsRotationAxisProps>;
-  radius?: PolarAxisDefaultized<any, any, ChartsRadiusAxisProps>;
+  rotationAxes?: ComputeResult<ChartsRotationAxisProps>;
+  radiusAxes?: ComputeResult<ChartsRadiusAxisProps>;
 }
 export type TooltipItemPositionGetter<TSeriesType extends ChartSeriesType> = (params: {
   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.
    * @default 'top'

package/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/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/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/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/internals/seriesSelectorOfType.d.ts

@@ -1,5 +1,5 @@
-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;
@@ -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/internals/seriesSelectorOfType.js

@@ -11,7 +11,7 @@ var _useStore = require("./store/useStore");
 var _useSelector = require("./store/useSelector");
 const selectorAllSeriesOfType = exports.selectorAllSeriesOfType = (0, _store.createSelector)(_useChartSeries.selectorChartSeriesProcessed, (processedSeries, seriesType) => processedSeries[seriesType]);
 const selectorSeriesOfType = exports.selectorSeriesOfType = (0, _store.createSelectorMemoized)(_useChartSeries.selectorChartSeriesProcessed, (processedSeries, seriesType, ids) => {
-  if (!ids || Array.isArray(ids) && ids.length === 0) {
+  if (ids === undefined || Array.isArray(ids) && ids.length === 0) {
     return processedSeries[seriesType]?.seriesOrder?.map(seriesId => processedSeries[seriesType]?.series[seriesId]) ?? [];
   }
   if (!Array.isArray(ids)) {

package/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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;
@@ -77,6 +78,11 @@ export interface ChartsAxisProps extends TickParams {
    * @default 'auto'
    */
   tickLabelInterval?: 'auto' | ((value: any, index: number) => boolean);
+  /**
+   * The minimum space between ticks when using an ordinal scale. It defines the minimum distance in pixels between two ticks.
+   * @default 0
+   */
+  tickSpacing?: number;
   /**
    * The label of the axis.
    */
@@ -224,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;
     }>;
@@ -243,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;
     }>;
@@ -537,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/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/models/seriesType/bar.d.ts

@@ -1,13 +1,14 @@
-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";
-export interface BarSeriesType extends CommonSeriesType<number | null>, CartesianSeriesType, StackableSeriesType {
+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';
   /**
    * Data associated to each bar.
    */
-  data?: readonly (number | null)[];
+  data?: ReadonlyArray<BarValueType | null>;
   /**
    * The key used to retrieve data from the dataset.
    */

package/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/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: {
     /**
@@ -15,6 +15,11 @@ export interface ChartsSeriesConfig {
      * Series type when stored in the context (with all the preprocessing added))
      */
     series: DefaultizedBarSeriesType;
+    /**
+     * Additional data computed from the series plus drawing area.
+     * Useful for special charts like sankey where the series data is not sufficient to draw the series.
+     * */
+    seriesLayout: {};
     /**
      * Series typing such that the one user need to provide
      */
@@ -28,6 +33,7 @@ export interface ChartsSeriesConfig {
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & MakeRequired<SeriesColor<number | null>, 'color'>;
     series: DefaultizedLineSeriesType;
+    seriesLayout: {};
     seriesProp: LineSeriesType;
     itemIdentifier: LineItemIdentifier;
     itemIdentifierWithData: LineItemIdentifier;
@@ -38,6 +44,7 @@ export interface ChartsSeriesConfig {
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & MakeRequired<SeriesColor<ScatterValueType | null>, 'color'>;
     series: DefaultizedScatterSeriesType;
+    seriesLayout: {};
     seriesProp: ScatterSeriesType;
     valueType: ScatterValueType;
     itemIdentifier: ScatterItemIdentifier;
@@ -49,6 +56,7 @@ export interface ChartsSeriesConfig {
       data: Array<MakeOptional<PieValueType, 'id'> & MakeRequired<SeriesColor<PieValueType | null>, 'color'>>;
     };
     series: DefaultizedPieSeriesType;
+    seriesLayout: PieSeriesLayout;
     seriesProp: PieSeriesType<MakeOptional<PieValueType, 'id'>>;
     itemIdentifier: PieItemIdentifier;
     itemIdentifierWithData: PieItemIdentifier;
@@ -57,6 +65,7 @@ export interface ChartsSeriesConfig {
   radar: {
     seriesInput: DefaultizedProps<RadarSeriesType, 'id'> & MakeRequired<SeriesColor<number>, 'color'>;
     series: DefaultizedRadarSeriesType;
+    seriesLayout: {};
     seriesProp: RadarSeriesType;
     itemIdentifier: RadarItemIdentifier;
     itemIdentifierWithData: RadarItemIdentifier;
@@ -80,6 +89,7 @@ export type ChartSeriesDefaultized<T extends ChartSeriesType> = ChartsSeriesConf
 } ? ChartsSeriesConfig[T]['series'] & {
   stackedData: [number, number][];
 } : ChartsSeriesConfig[T]['series'];
+export type ChartSeriesLayout<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends any ? ChartsSeriesConfig[T]['seriesLayout'] : never;
 export type ChartItemIdentifier<T extends ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifier'];
 export type ChartItemIdentifierWithData<T extends ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifierWithData'];
 export type DatasetElementType<T> = {

package/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.
@@ -19,6 +19,7 @@ type DefaultizedCartesianSeriesType = DefaultizedSeriesType<CartesianChartSeries
 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 SeriesId } from "./common.js";
 export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";

package/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.