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

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

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.selectorChartRotationAxis = exports.selectorChartRawRotationAxis = exports.selectorChartRawRadiusAxis = exports.selectorChartRadiusAxis = exports.selectorChartPolarAxisState = void 0;
+var _useChartDimensions = require("../../corePlugins/useChartDimensions");
+var _useChartSeries = require("../../corePlugins/useChartSeries");
+var _selectors = require("../../utils/selectors");
+var _computeAxisValue = require("./computeAxisValue");
+const selectorChartPolarAxisState = state => state.polarAxis;
+exports.selectorChartPolarAxisState = selectorChartPolarAxisState;
+const selectorChartRawRotationAxis = exports.selectorChartRawRotationAxis = (0, _selectors.createSelector)(selectorChartPolarAxisState, axis => axis?.rotation);
+const selectorChartRawRadiusAxis = exports.selectorChartRawRadiusAxis = (0, _selectors.createSelector)(selectorChartPolarAxisState, axis => axis?.radius);
+
+/**
+ * The only interesting selectors that merge axis data and zoom if provided.
+ */
+
+const selectorChartRotationAxis = exports.selectorChartRotationAxis = (0, _selectors.createSelector)([selectorChartRawRotationAxis, _useChartDimensions.selectorChartDrawingArea, _useChartSeries.selectorChartSeriesProcessed, _useChartSeries.selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => (0, _computeAxisValue.computeAxisValue)({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'rotation'
+}));
+const selectorChartRadiusAxis = exports.selectorChartRadiusAxis = (0, _selectors.createSelector)([selectorChartRawRadiusAxis, _useChartDimensions.selectorChartDrawingArea, _useChartSeries.selectorChartSeriesProcessed, _useChartSeries.selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => (0, _computeAxisValue.computeAxisValue)({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'radius'
+}));

package/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/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/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/internals/plugins/models/seriesConfig/cartesianExtremumGetter.types.js

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

package/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/internals/plugins/models/seriesConfig/getSeriesWithDefaultValues.types.js

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

package/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/internals/plugins/models/seriesConfig/index.js

@@ -14,14 +14,25 @@ Object.keys(_colorProcessor).forEach(function (key) {
     }
   });
 });
-var _extremumGetter = require("./extremumGetter.types");
-Object.keys(_extremumGetter).forEach(function (key) {
+var _cartesianExtremumGetter = require("./cartesianExtremumGetter.types");
+Object.keys(_cartesianExtremumGetter).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _extremumGetter[key]) return;
+  if (key in exports && exports[key] === _cartesianExtremumGetter[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _extremumGetter[key];
+      return _cartesianExtremumGetter[key];
+    }
+  });
+});
+var _polarExtremumGetter = require("./polarExtremumGetter.types");
+Object.keys(_polarExtremumGetter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _polarExtremumGetter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _polarExtremumGetter[key];
     }
   });
 });
@@ -68,4 +79,15 @@ Object.keys(_legendGetter).forEach(function (key) {
       return _legendGetter[key];
     }
   });
+});
+var _getSeriesWithDefaultValues = require("./getSeriesWithDefaultValues.types");
+Object.keys(_getSeriesWithDefaultValues).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getSeriesWithDefaultValues[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getSeriesWithDefaultValues[key];
+    }
+  });
 });

package/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/internals/plugins/models/seriesConfig/polarExtremumGetter.types.js

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

package/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/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/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/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/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/internals/store/useCharts.js

@@ -42,14 +42,6 @@ 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/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/internals/store/useSelector.js

@@ -4,7 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useSelector = void 0;
-var _withSelector = require("use-sync-external-store/with-selector");
+var _withSelector = require("use-sync-external-store/with-selector.js");
+// use-sync-external-store has no exports field defined
+// See https://github.com/facebook/react/issues/30698
+// eslint-disable-next-line import/extensions
+
 const defaultCompare = Object.is;
 const useSelector = (store, selector, args = undefined, equals = defaultCompare) => {
   const selectorWithArgs = state => selector(state, args);

package/internals/store/useStore.js

@@ -9,7 +9,7 @@ var _ChartProvider = require("../../context/ChartProvider");
 function useStore() {
   const context = (0, _ChartProvider.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/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/models/axis.js

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

package/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/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/models/index.js

@@ -14,17 +14,6 @@ Object.keys(_seriesType).forEach(function (key) {
     }
   });
 });
-var _layout = require("./layout");
-Object.keys(_layout).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _layout[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _layout[key];
-    }
-  });
-});
 var _stacking = require("./stacking");
 Object.keys(_stacking).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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