@mui/x-charts 8.0.0-alpha.12 → 8.0.0-alpha.14

package/esm/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarAxis.selectors.js

@@ -0,0 +1,26 @@
+import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/index.js";
+import { selectorChartSeriesConfig, selectorChartSeriesProcessed } from "../../corePlugins/useChartSeries/index.js";
+import { createSelector } from "../../utils/selectors.js";
+import { computeAxisValue } from "./computeAxisValue.js";
+export const selectorChartPolarAxisState = state => state.polarAxis;
+export const selectorChartRawRotationAxis = createSelector(selectorChartPolarAxisState, axis => axis?.rotation);
+export const selectorChartRawRadiusAxis = createSelector(selectorChartPolarAxisState, axis => axis?.radius);
+
+/**
+ * The only interesting selectors that merge axis data and zoom if provided.
+ */
+
+export const selectorChartRotationAxis = createSelector([selectorChartRawRotationAxis, selectorChartDrawingArea, selectorChartSeriesProcessed, selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => computeAxisValue({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'rotation'
+}));
+export const selectorChartRadiusAxis = createSelector([selectorChartRawRadiusAxis, selectorChartDrawingArea, selectorChartSeriesProcessed, selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => computeAxisValue({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'radius'
+}));

package/esm/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarAxis.types.d.ts

@@ -0,0 +1,55 @@
+import { ChartPluginSignature } from "../../models/index.js";
+import { ChartSeriesType, DatasetType } from "../../../../models/seriesType/config.js";
+import { ScaleName, AxisId, AxisConfig, ChartsRotationAxisProps, ChartsRadiusAxisProps } from "../../../../models/axis.js";
+import { UseChartSeriesSignature } from "../../corePlugins/useChartSeries/index.js";
+import { DefaultizedAxisConfig } from "../useChartCartesianAxis/index.js";
+export type PolarAxisState = {
+  /**
+   * Mapping from rotation-axis key to scaling configuration.
+   */
+  rotationAxis: DefaultizedAxisConfig<ChartsRotationAxisProps>;
+  /**
+   * Mapping from radius-axis key to scaling configuration.
+   */
+  radiusAxis: DefaultizedAxisConfig<ChartsRadiusAxisProps>;
+  /**
+   * The rotation-axes IDs sorted by order they were provided.
+   */
+  rotationAxisIds: AxisId[];
+  /**
+   * The radius-axes IDs sorted by order they were provided.
+   */
+  radiusAxisIds: AxisId[];
+};
+export interface UseChartPolarAxisParameters {
+  /**
+   * The configuration of the rotation-axes.
+   * If not provided, a default axis config is used.
+   * An array of [[AxisConfig]] objects.
+   */
+  rotationAxis?: AxisConfig<ScaleName, any, ChartsRotationAxisProps>[];
+  /**
+   * The configuration of the radial-axes.
+   * If not provided, a default axis config is used.
+   * An array of [[AxisConfig]] objects.
+   */
+  radiusAxis?: AxisConfig<'linear', any, ChartsRadiusAxisProps>[];
+  /**
+   * An array of objects that can be used to populate series and axes data using their `dataKey` property.
+   */
+  dataset?: Readonly<DatasetType>;
+}
+export type UseChartPolarAxisDefaultizedParameters = UseChartPolarAxisParameters & {};
+export interface UseChartPolarAxisState {
+  polarAxis: {
+    rotation: AxisConfig<ScaleName, any, ChartsRotationAxisProps>[];
+    radius: AxisConfig<'linear', any, ChartsRadiusAxisProps>[];
+  };
+}
+export interface UseChartPolarAxisInstance {}
+export type UseChartPolarAxisSignature<SeriesType extends ChartSeriesType = ChartSeriesType> = ChartPluginSignature<{
+  params: UseChartPolarAxisParameters;
+  defaultizedParams: UseChartPolarAxisDefaultizedParameters;
+  state: UseChartPolarAxisState;
+  dependencies: [UseChartSeriesSignature<SeriesType>];
+}>;

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

@@ -10,11 +10,11 @@ export interface UseChartZAxisParameters {
   /**
    * The configuration of the z-axes.
    */
-  zAxis?: MakeOptional<ZAxisConfig, 'id'>[];
+  zAxis?: readonly MakeOptional<ZAxisConfig, 'id'>[];
   /**
    * An array of objects that can be used to populate series and axes data using their `dataKey` property.
    */
-  dataset?: DatasetType;
+  dataset?: Readonly<DatasetType>;
 }
 export type UseChartZAxisDefaultizedParameters = UseChartZAxisParameters;
 export interface UseChartZAxisState {

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

@@ -128,7 +128,7 @@ export interface ChartControlModel<TValue> {
 }
 type RemoveSetValue<Models extends Record<string, ChartControlModel<any>>> = { [K in keyof Models]: Omit<Models[K], 'setValue'> };
 export type ChartUsedControlModels<TSignature extends ChartAnyPluginSignature> = TSignature['models'] & RemoveSetValue<MergeSignaturesProperty<ChartRequiredPlugins<TSignature>, 'models'>>;
-export type ChartUsedStore<TSignature extends ChartAnyPluginSignature> = ChartStore<[TSignature, ...TSignature['dependencies']]>;
+export type ChartUsedStore<TSignature extends ChartAnyPluginSignature> = ChartStore<[TSignature, ...TSignature['dependencies']], TSignature['optionalDependencies']>;
 export type ChartPlugin<TSignature extends ChartAnyPluginSignature> = {
   /**
    * The main function of the plugin that will be executed by the chart.

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

@@ -0,0 +1,3 @@
+import type { ChartSeries, ChartSeriesType } from '../../../../models/seriesType/config';
+import type { AllSeriesType } from '../../../../models/seriesType';
+export type GetSeriesWithDefaultValues<T extends ChartSeriesType> = (series: AllSeriesType<T>, seriesIndex: number, colors: string[]) => ChartSeries<T>;

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

@@ -1,6 +1,8 @@
 export * from "./colorProcessor.types.js";
-export * from "./extremumGetter.types.js";
+export * from "./cartesianExtremumGetter.types.js";
+export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
-export * from "./legendGetter.types.js";
+export * from "./legendGetter.types.js";
+export * from "./getSeriesWithDefaultValues.types.js";

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

@@ -1,6 +1,8 @@
 export * from "./colorProcessor.types.js";
-export * from "./extremumGetter.types.js";
+export * from "./cartesianExtremumGetter.types.js";
+export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
-export * from "./legendGetter.types.js";
+export * from "./legendGetter.types.js";
+export * from "./getSeriesWithDefaultValues.types.js";

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

@@ -0,0 +1,16 @@
+import type { PolarChartSeriesType, ChartSeriesDefaultized } from '../../../../models/seriesType/config';
+import type { AxisConfig } from '../../../../models/axis';
+import type { SeriesId } from '../../../../models/seriesType/common';
+type PolarExtremumGetterParams<TSeriesType extends PolarChartSeriesType> = {
+  series: Record<SeriesId, ChartSeriesDefaultized<TSeriesType>>;
+  axis: AxisConfig;
+  axisIndex: number;
+  isDefaultAxis: boolean;
+};
+export type PolarExtremumGetterResult = [number, number];
+export type PolarExtremumGetter<TSeriesType extends PolarChartSeriesType> = (params: PolarExtremumGetterParams<TSeriesType>) => PolarExtremumGetterResult;
+export type PolarExtremumFilter = (value: {
+  x: number | Date | string | null;
+  y: number | Date | string | null;
+}, dataIndex: number) => boolean;
+export {};

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

@@ -1,16 +1,22 @@
 import type { SeriesProcessor } from './seriesProcessor.types';
-import type { CartesianChartSeriesType, ChartSeriesType } from '../../../../models/seriesType/config';
+import type { CartesianChartSeriesType, ChartSeriesType, PolarChartSeriesType } from '../../../../models/seriesType/config';
 import type { ColorProcessor } from './colorProcessor.types';
-import type { CartesianExtremumGetter } from './extremumGetter.types';
+import type { CartesianExtremumGetter } from './cartesianExtremumGetter.types';
 import type { LegendGetter } from './legendGetter.types';
 import type { TooltipGetter } from './tooltipGetter.types';
+import { PolarExtremumGetter } from "./polarExtremumGetter.types.js";
+import { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
 export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   seriesProcessor: SeriesProcessor<TSeriesType>;
   colorProcessor: ColorProcessor<TSeriesType>;
   legendGetter: LegendGetter<TSeriesType>;
   tooltipGetter: TooltipGetter<TSeriesType>;
+  getSeriesWithDefaultValues: GetSeriesWithDefaultValues<TSeriesType>;
 } & (TSeriesType extends CartesianChartSeriesType ? {
   xExtremumGetter: CartesianExtremumGetter<TSeriesType>;
   yExtremumGetter: CartesianExtremumGetter<TSeriesType>;
+} : {}) & (TSeriesType extends PolarChartSeriesType ? {
+  rotationExtremumGetter: PolarExtremumGetter<TSeriesType>;
+  radiusExtremumGetter: PolarExtremumGetter<TSeriesType>;
 } : {});
 export type ChartSeriesConfig<TSeriesType extends ChartSeriesType> = { [Key in TSeriesType]: ChartSeriesTypeConfig<Key> };

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

@@ -13,4 +13,4 @@ export type SeriesProcessorResult<TSeriesType extends ChartSeriesType> = {
 } ? {
   stackingGroups: StackingGroupsType;
 } : {});
-export type SeriesProcessor<TSeriesType extends ChartSeriesType> = (params: SeriesProcessorParams<TSeriesType>, dataset?: DatasetType) => SeriesProcessorResult<TSeriesType>;
+export type SeriesProcessor<TSeriesType extends ChartSeriesType> = (params: SeriesProcessorParams<TSeriesType>, dataset?: Readonly<DatasetType>) => SeriesProcessorResult<TSeriesType>;

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

@@ -1,13 +1,13 @@
 import type { ChartState } from '../models/chart';
 import type { ChartAnyPluginSignature } from '../models/plugin';
 type Listener<T> = (value: T) => void;
-export type StoreUpdater<TSignatures extends readonly ChartAnyPluginSignature[]> = (prevState: ChartState<TSignatures>) => ChartState<TSignatures>;
-export declare class ChartStore<TSignatures extends readonly ChartAnyPluginSignature[]> {
-  value: ChartState<TSignatures>;
+export type StoreUpdater<TSignatures extends readonly ChartAnyPluginSignature[], TOptionalSignatures extends readonly ChartAnyPluginSignature[] = []> = (prevState: ChartState<TSignatures, TOptionalSignatures>) => ChartState<TSignatures, TOptionalSignatures>;
+export declare class ChartStore<TSignatures extends readonly ChartAnyPluginSignature[], TOptionalSignatures extends readonly ChartAnyPluginSignature[] = []> {
+  value: ChartState<TSignatures, TOptionalSignatures>;
   private listeners;
-  constructor(value: ChartState<TSignatures>);
-  subscribe: (fn: Listener<ChartState<TSignatures>>) => () => void;
-  getSnapshot: () => ChartState<TSignatures>;
-  update: (updater: StoreUpdater<TSignatures>) => void;
+  constructor(value: ChartState<TSignatures, TOptionalSignatures>);
+  subscribe: (fn: Listener<ChartState<TSignatures, TOptionalSignatures>>) => () => void;
+  getSnapshot: () => ChartState<TSignatures, TOptionalSignatures>;
+  update: (updater: StoreUpdater<TSignatures, TOptionalSignatures>) => void;
 }
 export {};

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

@@ -1,6 +1,7 @@
 import { CreateSelectorFunction } from 'reselect';
 import { ChartAnyPluginSignature, ChartState } from "../models/index.js";
 export type ChartRootSelector<TSignature extends ChartAnyPluginSignature> = <TSignatures extends [TSignature]>(state: ChartState<TSignatures>) => TSignature['state'][keyof TSignature['state']];
+export type ChartOptionalRootSelector<TSignature extends ChartAnyPluginSignature> = <TSignatures extends [TSignature]>(state: ChartState<[], TSignatures>) => TSignature['state'][keyof TSignature['state']] | undefined;
 export type ChartsSelector<TState, TArgs, TResult> = (state: TState, args: TArgs) => TResult;
 /**
  * Method wrapping reselect's createSelector to provide caching for chart instances.

package/esm/internals/stackSeries.d.ts

@@ -1,10 +1,8 @@
 import { Series } from '@mui/x-charts-vendor/d3-shape';
-import type { BarSeriesType, LineSeriesType } from '../models/seriesType';
 import type { StackOffsetType, StackOrderType } from '../models/stacking';
-import { SeriesId } from "../models/seriesType/common.js";
-type StackableSeries = Record<SeriesId, BarSeriesType> | Record<SeriesId, LineSeriesType>;
-type FormatterParams = {
-  series: StackableSeries;
+import { SeriesId, StackableSeriesType } from "../models/seriesType/common.js";
+type FormatterParams<T> = {
+  series: Record<SeriesId, T>;
   seriesOrder: SeriesId[];
   defaultStrategy?: {
     stackOrder?: StackOrderType;
@@ -23,5 +21,5 @@ export declare const StackOffset: { [key in StackOffsetType]: (series: Series<an
  * @param series the object of all bars series
  * @returns an array of groups, including the ids, the stacking order, and the stacking offset.
  */
-export declare const getStackingGroups: (params: FormatterParams) => StackingGroupsType;
+export declare const getStackingGroups: <T extends StackableSeriesType>(params: FormatterParams<T>) => StackingGroupsType;
 export {};

package/esm/internals/store/useCharts.js

@@ -33,14 +33,6 @@ export function useCharts(inPlugins, props, seriesConfig) {
     // eslint-disable-next-line react-compiler/react-compiler
     globalId += 1;
     const initialState = {
-      // TODO remove when the interaction moves to plugin
-      interaction: {
-        item: null,
-        axis: {
-          x: null,
-          y: null
-        }
-      },
       cacheKey: {
         id: globalId
       }

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

@@ -1,4 +1,4 @@
 import { ChartAnyPluginSignature, ChartState } from "../plugins/models/index.js";
 import { ChartsSelector } from "../plugins/utils/selectors.js";
 import { ChartStore } from "../plugins/utils/ChartStore.js";
-export declare const useSelector: <TSignatures extends readonly ChartAnyPluginSignature[], TArgs, TValue>(store: ChartStore<TSignatures>, selector: ChartsSelector<ChartState<TSignatures>, TArgs, TValue>, args?: TArgs, equals?: (a: TValue, b: TValue) => boolean) => TValue;
+export declare const useSelector: <TSignatures extends readonly ChartAnyPluginSignature[], TOptionalSignatures extends readonly ChartAnyPluginSignature[], TArgs, TValue>(store: ChartStore<TSignatures, TOptionalSignatures>, selector: ChartsSelector<ChartState<TSignatures, TOptionalSignatures>, TArgs, TValue>, args?: TArgs, equals?: (a: TValue, b: TValue) => boolean) => TValue;

package/esm/internals/store/useSelector.js

@@ -1,4 +1,7 @@
-import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/with-selector';
+// use-sync-external-store has no exports field defined
+// See https://github.com/facebook/react/issues/30698
+// eslint-disable-next-line import/extensions
+import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/with-selector.js';
 const defaultCompare = Object.is;
 export const useSelector = (store, selector, args = undefined, equals = defaultCompare) => {
   const selectorWithArgs = state => selector(state, args);

package/esm/internals/store/useStore.js

@@ -3,7 +3,7 @@ import { useChartContext } from "../../context/ChartProvider/index.js";
 export function useStore() {
   const context = useChartContext();
   if (!context) {
-    throw new Error(['MUI X: Could not find the charts context.', 'It looks like you rendered your component outside of a ChartsContainer parent component.'].join('\n'));
+    throw new Error(['MUI X: Could not find the charts context.', 'It looks like you rendered your component outside of a ChartContainer parent component.'].join('\n'));
   }
   return context.store;
 }

package/esm/models/axis.d.ts

@@ -1,5 +1,6 @@
 import type { ScaleBand, ScaleLogarithmic, ScalePower, ScaleTime, ScaleLinear, ScalePoint, ScaleOrdinal, ScaleSequential, ScaleThreshold } from '@mui/x-charts-vendor/d3-scale';
 import { SxProps } from '@mui/system/styleFunctionSx';
+import { MakeRequired } from '@mui/x-internals/types';
 import { ChartsAxisClasses } from "../ChartsAxis/axisClasses.js";
 import type { TickParams } from '../hooks/useTicks';
 import { ChartsTextProps } from "../ChartsText/index.js";
@@ -104,17 +105,54 @@ export interface ChartsAxisProps extends TickParams {
   sx?: SxProps;
 }
 export interface ChartsYAxisProps extends ChartsAxisProps {
+  axis?: 'y';
+}
+export interface ChartsXAxisProps extends ChartsAxisProps {
+  axis?: 'x';
   /**
-   * Position of the axis.
+   * The minimum gap in pixels between two tick labels.
+   * If two tick labels are closer than this minimum gap, one of them will be hidden.
+   * @default 4
    */
-  position?: 'left' | 'right';
+  tickLabelMinGap?: number;
 }
-export interface ChartsXAxisProps extends ChartsAxisProps {
+type AxisSideConfig<AxisProps extends ChartsAxisProps> = AxisProps extends ChartsXAxisProps ? {
   /**
    * Position of the axis.
+   *
+   * When set, the space for the axis is reserved, even if the axis is not displayed due to missing data.
+   *
+   * Set to 'none' to hide the axis.
+   *
+   * The first axis in the list will always have a default position.
    */
-  position?: 'top' | 'bottom';
-}
+  position?: 'top' | 'bottom' | 'none';
+  /**
+   * The height of the axis.
+   * @default 30
+   */
+  height?: number;
+} : AxisProps extends ChartsYAxisProps ? {
+  /**
+   * Position of the axis.
+   *
+   * When set, the space for the axis is reserved, even if the axis is not displayed due to missing data.
+   *
+   * Set to 'none' to hide the axis.
+   *
+   * The first axis in the list will always have a default position.
+   */
+  position?: 'left' | 'right' | 'none';
+  /**
+   * The width of the axis.
+   * @default 30
+   */
+  width?: number;
+} : {
+  position?: 'top' | 'bottom' | 'left' | 'right' | 'none';
+  height?: number;
+  width?: number;
+};
 export interface ChartsRotationAxisProps extends ChartsAxisProps {
   /**
    * The start angle (in deg).
@@ -242,7 +280,10 @@ export type AxisValueFormatterContext<S extends ScaleName = ScaleName> = {
    */
   scale: AxisScaleConfig[S]['scale'];
 };
-export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+/**
+ * Config that is shared between cartesian and polar axes.
+ */
+type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
   /**
    * Id used to identify the axis.
    */
@@ -260,7 +301,7 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps = Cha
   /**
    * The data used by `'band'` and `'point'` scales.
    */
-  data?: V[];
+  data?: readonly V[];
   /**
    * The key used to retrieve `data` from the `dataset` prop.
    */
@@ -283,21 +324,40 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps = Cha
   /**
    * Defines the axis scale domain based on the min/max values of series linked to it.
    * - 'nice': Rounds the domain at human friendly values.
-   * - 'strict': Set the domain to the min/max value provided. No extras space is added.
+   * - '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;
   });
-} & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & TickParams & AxisConfigExtension;
+};
+export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = {
+  /**
+   * The offset of the axis in pixels. It can be used to move the axis from its default position.
+   * X-axis: A top axis will move up, and a bottom axis will move down.
+   * Y-axis: A left axis will move left, and a right axis will move right.
+   * @default 0
+   */
+  offset?: number;
+} & CommonAxisConfig<S, V> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisConfigExtension;
+export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+  /**
+   * The offset of the axis in pixels. It can be used to move the axis from its default position.
+   * X-axis: A top axis will move up, and a bottom axis will move down.
+   * Y-axis: A left axis will move left, and a right axis will move right.
+   * @default 0
+   */
+  offset?: number;
+} & CommonAxisConfig<S, V> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisSideConfig<AxisProps> & TickParams & AxisConfigExtension;
 export interface AxisConfigExtension {}
-export type AxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps = ChartsXAxisProps | ChartsYAxisProps> = Omit<AxisConfig<S, V, AxisProps>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
+export type PolarAxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = Omit<PolarAxisConfig<S, V, AxisProps>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S];
+export type AxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = MakeRequired<Omit<AxisConfig<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * An indication of the expected number of ticks.
    */
   tickNumber: number;
-};
+} & (AxisProps extends ChartsXAxisProps ? MakeRequired<AxisSideConfig<AxisProps>, 'height'> : AxisProps extends ChartsYAxisProps ? MakeRequired<AxisSideConfig<AxisProps>, 'width'> : AxisSideConfig<AxisProps>);
 export declare function isBandScaleConfig(scaleConfig: AxisConfig<ScaleName>): scaleConfig is AxisConfig<'band'> & {
   scaleType: 'band';
 };
@@ -320,4 +380,5 @@ export interface ChartsAxisData {
    * The mapping of series ids to their value for this particular axis index.
    */
   seriesValues: Record<string, number | null | undefined>;
-}
+}
+export {};

package/esm/models/axis.js

@@ -3,6 +3,10 @@
  * shouldn't be provided by the user.
  */
 
+/**
+ * Config that is shared between cartesian and polar axes.
+ */
+
 export function isBandScaleConfig(scaleConfig) {
   return scaleConfig.scaleType === 'band';
 }

package/esm/models/colorMapping.d.ts

@@ -33,7 +33,7 @@ export interface OrdinalColorConfig<Value = number | Date | string> {
    * The value to map.
    * If undefined, it will be integers from 0 to the number of colors.
    */
-  values?: Value[];
+  values?: readonly Value[];
   /**
    * The color palette.
    * Items equal to `values[k]` will get the color of `colors[k]`.

package/esm/models/index.d.ts

@@ -1,5 +1,4 @@
 export * from "./seriesType/index.js";
-export * from "./layout.js";
 export * from "./stacking.js";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData } from './axis';
 export type { PropsFromSlot } from '@mui/x-internals/slots';

package/esm/models/index.js

@@ -1,5 +1,4 @@
 export * from "./seriesType/index.js";
-export * from "./layout.js";
 export * from "./stacking.js";
 
 // Utils shared across the X packages

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

@@ -6,7 +6,7 @@ export interface BarSeriesType extends CommonSeriesType<number | null>, Cartesia
   /**
    * Data associated to each bar.
    */
-  data?: (number | null)[];
+  data?: readonly (number | null)[];
   /**
    * The key used to retrieve data from the dataset.
    */

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

@@ -3,6 +3,7 @@ import { ScatterSeriesType, DefaultizedScatterSeriesType, ScatterItemIdentifier,
 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";
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -22,7 +23,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: BarItemIdentifier;
     valueType: number | null;
     canBeStacked: true;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & {
@@ -33,7 +34,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: LineItemIdentifier;
     valueType: number | null;
     canBeStacked: true;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & {
@@ -43,7 +44,7 @@ export interface ChartsSeriesConfig {
     seriesProp: ScatterSeriesType;
     valueType: ScatterValueType;
     itemIdentifier: ScatterItemIdentifier;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   pie: {
     seriesInput: Omit<DefaultizedProps<PieSeriesType, 'id'>, 'data'> & {
@@ -56,19 +57,28 @@ export interface ChartsSeriesConfig {
     itemIdentifier: PieItemIdentifier;
     valueType: DefaultizedPieValueType;
   };
+  radar: {
+    seriesInput: DefaultizedProps<RadarSeriesType, 'id'> & {
+      color: string;
+    };
+    series: DefaultizedRadarSeriesType;
+    seriesProp: RadarSeriesType;
+    itemIdentifier: RadarItemIdentifier;
+    valueType: number;
+    axisType: 'polar';
+  };
 }
 export type ChartSeriesType = keyof ChartsSeriesConfig;
 export type CartesianChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
-  cartesian: true;
+  axisType: 'cartesian';
+} ? Key : never }[ChartSeriesType]>;
+export type PolarChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
+  axisType: 'polar';
 } ? Key : never }[ChartSeriesType]>;
 export type StackableChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
   canBeStacked: true;
 } ? Key : never }[ChartSeriesType]>;
-export type ChartSeries<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends {
-  canBeStacked: true;
-} ? ChartsSeriesConfig[T]['seriesInput'] & {
-  stackedData: [number, number][];
-} : ChartsSeriesConfig[T]['seriesInput'];
+export type ChartSeries<T extends ChartSeriesType> = ChartsSeriesConfig[T]['seriesInput'];
 export type ChartSeriesDefaultized<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends {
   canBeStacked: true;
 } ? ChartsSeriesConfig[T]['series'] & {
@@ -76,6 +86,6 @@ export type ChartSeriesDefaultized<T extends ChartSeriesType> = ChartsSeriesConf
 } : ChartsSeriesConfig[T]['series'];
 export type ChartItemIdentifier<T extends ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifier'];
 export type DatasetElementType<T> = {
-  [key: string]: T;
+  [key: string]: Readonly<T>;
 };
 export type DatasetType<T = number | string | Date | null | undefined> = DatasetElementType<T>[];

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

@@ -10,6 +10,7 @@ export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
+export * from "./radar.js";
 export type { AllSeriesType, CartesianSeriesType, DefaultizedSeriesType, DefaultizedCartesianSeriesType, StackableSeriesType };
 export declare function isDefaultizedBarSeries(series: DefaultizedSeriesType): series is DefaultizedBarSeriesType;
 export declare function isBarSeries(series: AllSeriesType): series is BarSeriesType;

package/esm/models/seriesType/index.js

@@ -6,6 +6,7 @@ export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
+export * from "./radar.js";
 // Helpers
 
 export function isDefaultizedBarSeries(series) {

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

@@ -29,7 +29,7 @@ export interface LineSeriesType extends CommonSeriesType<number | null>, Cartesi
   /**
    * Data associated to the line.
    */
-  data?: (number | null)[];
+  data?: readonly (number | null)[];
   /**
    * The key used to retrieve data from the dataset.
    */

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

@@ -27,7 +27,7 @@ export type DefaultizedPieValueType = PieValueType & Omit<D3PieArcDatum<any>, 'd
 export type ChartsPieSorting = 'none' | 'asc' | 'desc' | ((a: number, b: number) => number);
 export interface PieSeriesType<TData = PieValueType> extends CommonSeriesType<TData> {
   type: 'pie';
-  data: TData[];
+  data: Readonly<TData[]>;
   /**
    * The radius between circle center and the beginning of the arc.
    * Can be a number (in px) or a string with a percentage such as '50%'.

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

@@ -0,0 +1,24 @@
+import { DefaultizedProps } from '@mui/x-internals/types';
+import { CommonDefaultizedProps, CommonSeriesType, SeriesId } from "./common.js";
+export interface RadarSeriesType extends CommonSeriesType<number> {
+  type: 'radar';
+  data: number[];
+  /**
+   * The label to display on the tooltip or the legend. It can be a string or a function.
+   */
+  label?: string | ((location: 'tooltip' | 'legend') => string);
+  /**
+   * If `true` show marks at value position.
+   */
+  showMark?: boolean;
+}
+/**
+ * An object that allows to identify either a radar series or a radar point (if dataIndex is defined).
+ * Used for item interaction
+ */
+export type RadarItemIdentifier = {
+  type: 'radar';
+  seriesId: SeriesId;
+  dataIndex?: number;
+};
+export interface DefaultizedRadarSeriesType extends DefaultizedProps<RadarSeriesType, CommonDefaultizedProps | 'color'> {}

package/esm/models/seriesType/radar.js

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

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

@@ -11,7 +11,7 @@ export type ScatterValueType = {
 };
 export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType | null>, CartesianSeriesType {
   type: 'scatter';
-  data?: ScatterValueType[];
+  data?: readonly ScatterValueType[];
   markerSize?: number;
   /**
    * The label to display on the tooltip or the legend. It can be a string or a function.

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

@@ -2,7 +2,7 @@ import type { ScaleOrdinal, ScaleSequential, ScaleThreshold } from '@mui/x-chart
 import { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
 export interface ZAxisConfig<V = any> {
   id: string;
-  data?: V[];
+  data?: readonly V[];
   /**
    * The key used to retrieve `data` from the `dataset` prop.
    */