@mui/x-charts 9.0.1 → 9.0.3

package/internals/plugins/featurePlugins/useChartPolarAxis/computeAxisValue.mjs

@@ -1,27 +1,33 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import { isBandScaleConfig, isPointScaleConfig, isContinuousScaleConfig } from "../../../../models/axis.mjs";
 import { getColorScale, getOrdinalColorScale } from "../../../colorScale.mjs";
-import { getDefaultTickNumber, getTickNumber, scaleTickNumberByRange } from "../../../ticks.mjs";
+import { getDefaultTickNumber, getTickNumber } from "../../../ticks.mjs";
 import { getScale } from "../../../getScale.mjs";
 import { isDateData, createDateFormatter } from "../../../dateHelpers.mjs";
 import { getAxisExtremum } from "./getAxisExtremum.mjs";
 import { deg2rad } from "../../../angleConversion.mjs";
 import { getAxisTriggerTooltip } from "./getAxisTriggerTooltip.mjs";
 import { scaleBand, scalePoint } from "../../../scales/index.mjs";
+import { EPSILON } from "../../../../utils/epsilon.mjs";
 function getRange(drawingArea, axisDirection, axis) {
   if (axisDirection === 'rotation') {
-    if (axis.scaleType === 'point') {
-      const angles = [deg2rad(axis.startAngle, 0), deg2rad(axis.endAngle, 2 * Math.PI)];
-      const diff = angles[1] - angles[0];
-      if (diff > Math.PI * 2 - 0.1) {
-        // If we cover a full circle, we remove a slice to avoid having data point at the same place.
-        angles[1] -= diff / axis.data.length;
-      }
-      return angles;
+    const angles = [deg2rad(axis.startAngle, 0), deg2rad(axis.endAngle, 2 * Math.PI)];
+    const diff = angles[1] - angles[0];
+    const isFullCircle = diff >= Math.PI * 2 - EPSILON;
+    if (axis.scaleType === 'point' && isFullCircle) {
+      // For point scale, remove a slice to avoid overlapping first and last points.
+      angles[1] -= diff / axis.data.length;
     }
-    return [deg2rad(axis.startAngle, 0), deg2rad(axis.endAngle, 2 * Math.PI)];
+    return {
+      range: angles,
+      isFullCircle
+    };
   }
-  return [0, Math.min(drawingArea.height, drawingArea.width) / 2];
+  const availableRadius = Math.min(drawingArea.height, drawingArea.width) / 2;
+  return {
+    range: [axis.minRadius ?? 0, axis.maxRadius ?? availableRadius],
+    isFullCircle: false
+  };
 }
 const DEFAULT_CATEGORY_GAP_RATIO = 0.2;
 const DEFAULT_BAR_GAP_RATIO = 0.1;
@@ -42,7 +48,10 @@ export function computeAxisValue({
   const completeAxis = {};
   allAxis.forEach((eachAxis, axisIndex) => {
     const axis = eachAxis;
-    const range = getRange(drawingArea, axisDirection, axis);
+    const {
+      range,
+      isFullCircle
+    } = getRange(drawingArea, axisDirection, axis);
     const [minData, maxData] = getAxisExtremum(axis, axisDirection, seriesConfig, axisIndex, formattedSeries);
     const triggerTooltip = !axis.ignoreTooltip && axisIdsTriggeringTooltip.has(axis.id);
     const data = axis.data ?? [];
@@ -60,7 +69,8 @@ export function computeAxisValue({
         tickNumber: axis.data.length,
         colorScale: axis.colorMap && (axis.colorMap.type === 'ordinal' ? getOrdinalColorScale(_extends({
           values: axis.data
-        }, axis.colorMap)) : getColorScale(axis.colorMap))
+        }, axis.colorMap)) : getColorScale(axis.colorMap)),
+        isFullCircle
       });
       if (isDateData(axis.data)) {
         const dateFormatter = createDateFormatter(axis.data, range, axis.tickNumber);
@@ -77,7 +87,8 @@ export function computeAxisValue({
         tickNumber: axis.data.length,
         colorScale: axis.colorMap && (axis.colorMap.type === 'ordinal' ? getOrdinalColorScale(_extends({
           values: axis.data
-        }, axis.colorMap)) : getColorScale(axis.colorMap))
+        }, axis.colorMap)) : getColorScale(axis.colorMap)),
+        isFullCircle
       });
       if (isDateData(axis.data)) {
         const dateFormatter = createDateFormatter(axis.data, range, axis.tickNumber);
@@ -99,10 +110,12 @@ export function computeAxisValue({
       axisExtremums[0] = min;
       axisExtremums[1] = max;
     }
-    const rawTickNumber = getTickNumber(axis, axisExtremums, getDefaultTickNumber(Math.abs(range[1] - range[0])));
-    const tickNumber = scaleTickNumberByRange(rawTickNumber, range);
+
+    // Use degrees to display more ticks by default
+    const ratio = axisDirection === 'rotation' ? 180 / 3 : 1;
+    const tickNumber = axis.tickNumber ?? getTickNumber(axis, axisExtremums, getDefaultTickNumber(ratio * Math.abs(range[1] - range[0])));
     const scale = getScale(scaleType, axisExtremums, range);
-    const finalScale = domainLimit === 'nice' ? scale.nice(rawTickNumber) : scale;
+    const finalScale = domainLimit === 'nice' ? scale.nice(tickNumber) : scale;
     const [minDomain, maxDomain] = finalScale.domain();
     const domain = [axis.min ?? minDomain, axis.max ?? maxDomain];
     completeAxis[axis.id] = _extends({

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

@@ -16,17 +16,17 @@ function defaultizeAxis(inAxis, dataset, axisName) {
   return inputAxes.map((axisConfig, index) => {
     const id = `defaultized-${axisName}-axis-${index}`;
     const dataKey = axisConfig.dataKey;
-    if (dataKey === undefined || axisConfig.data !== undefined) {
+    if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
       return (0, _extends2.default)({
         id
       }, axisConfig);
     }
     if (dataset === undefined) {
-      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: The ${axisName}-axis uses \`dataKey\` but no \`dataset\` is provided. ` + 'When using dataKey, a dataset must be provided to retrieve the axis data. ' + `Either provide a dataset prop or use the data property directly on the ${axisName}-axis.` : (0, _formatErrorMessage2.default)(39, axisName, axisName));
+      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: The ${axisName}-axis uses \`dataKey\` or \`valueGetter\` but no \`dataset\` is provided. ` + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + `Either provide a dataset prop or use the data property directly on the ${axisName}-axis.` : (0, _formatErrorMessage2.default)(39, axisName, axisName));
     }
     return (0, _extends2.default)({
       id,
-      data: dataset.map(d => d[dataKey])
+      data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
     }, axisConfig);
   });
 }

package/internals/plugins/featurePlugins/useChartPolarAxis/defaultizeAxis.mjs

@@ -9,17 +9,17 @@ export function defaultizeAxis(inAxis, dataset, axisName) {
   return inputAxes.map((axisConfig, index) => {
     const id = `defaultized-${axisName}-axis-${index}`;
     const dataKey = axisConfig.dataKey;
-    if (dataKey === undefined || axisConfig.data !== undefined) {
+    if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
       return _extends({
         id
       }, axisConfig);
     }
     if (dataset === undefined) {
-      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: The ${axisName}-axis uses \`dataKey\` but no \`dataset\` is provided. ` + 'When using dataKey, a dataset must be provided to retrieve the axis data. ' + `Either provide a dataset prop or use the data property directly on the ${axisName}-axis.` : _formatErrorMessage(39, axisName, axisName));
+      throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Charts: The ${axisName}-axis uses \`dataKey\` or \`valueGetter\` but no \`dataset\` is provided. ` + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + `Either provide a dataset prop or use the data property directly on the ${axisName}-axis.` : _formatErrorMessage(39, axisName, axisName));
     }
     return _extends({
       id,
-      data: dataset.map(d => d[dataKey])
+      data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
     }, axisConfig);
   });
 }

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.d.mts

@@ -1,12 +1,12 @@
 export declare const selectorChartsTooltipPointerItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useChartTooltip.types.mjs").UseChartTooltipState<keyof import("../../../index.mjs").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => import("../../../../index.mjs").LineItemIdentifier | import("../../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
+}) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
 export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useChartTooltip.types.mjs").UseChartTooltipState<keyof import("../../../index.mjs").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
 }) => boolean;
 export declare const selectorChartsTooltipItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => import("../../../../index.mjs").LineItemIdentifier | import("../../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
+}) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
 export declare const selectorChartsTooltipItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
 }) => boolean;

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.d.ts

@@ -1,12 +1,12 @@
 export declare const selectorChartsTooltipPointerItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useChartTooltip.types.js").UseChartTooltipState<keyof import("../../../index.js").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => import("../../../../index.js").LineItemIdentifier | import("../../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
+}) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
 export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useChartTooltip.types.js").UseChartTooltipState<keyof import("../../../index.js").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 }) => boolean;
 export declare const selectorChartsTooltipItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => import("../../../../index.js").LineItemIdentifier | import("../../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
+}) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
 export declare const selectorChartsTooltipItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 }) => boolean;

package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.js

@@ -44,16 +44,16 @@ function getZAxisState(zAxis, dataset) {
   zAxis.forEach((axisConfig, index) => {
     const dataKey = axisConfig.dataKey;
     const defaultizedId = axisConfig.id ?? `defaultized-z-axis-${index}`;
-    if (dataKey === undefined || axisConfig.data !== undefined) {
+    if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
       zAxisLookup[defaultizedId] = processColorMap(addDefaultId(axisConfig, defaultizedId));
       axisIds.push(defaultizedId);
       return;
     }
     if (dataset === undefined) {
-      throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` but no `dataset` is provided. ' + 'When using dataKey, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : (0, _formatErrorMessage2.default)(41));
+      throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` or `valueGetter` but no `dataset` is provided. ' + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : (0, _formatErrorMessage2.default)(41));
     }
     zAxisLookup[defaultizedId] = processColorMap(addDefaultId((0, _extends2.default)({}, axisConfig, {
-      data: dataset.map(d => d[dataKey])
+      data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
     }), defaultizedId));
     axisIds.push(defaultizedId);
   });

package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.mjs

@@ -37,16 +37,16 @@ function getZAxisState(zAxis, dataset) {
   zAxis.forEach((axisConfig, index) => {
     const dataKey = axisConfig.dataKey;
     const defaultizedId = axisConfig.id ?? `defaultized-z-axis-${index}`;
-    if (dataKey === undefined || axisConfig.data !== undefined) {
+    if (axisConfig.data !== undefined || dataKey === undefined && !axisConfig.valueGetter) {
       zAxisLookup[defaultizedId] = processColorMap(addDefaultId(axisConfig, defaultizedId));
       axisIds.push(defaultizedId);
       return;
     }
     if (dataset === undefined) {
-      throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` but no `dataset` is provided. ' + 'When using dataKey, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : _formatErrorMessage(41));
+      throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: The z-axis uses `dataKey` or `valueGetter` but no `dataset` is provided. ' + 'When using dataKey or valueGetter, a dataset must be provided to retrieve the axis data. ' + 'Either provide a dataset prop or use the data property directly on the z-axis.' : _formatErrorMessage(41));
     }
     zAxisLookup[defaultizedId] = processColorMap(addDefaultId(_extends({}, axisConfig, {
-      data: dataset.map(d => d[dataKey])
+      data: axisConfig.valueGetter ? dataset.map(d => axisConfig.valueGetter(d)) : dataset.map(d => d[dataKey])
     }), defaultizedId));
     axisIds.push(defaultizedId);
   });

package/models/axis.d.mts

@@ -2,6 +2,7 @@ import type * as React from 'react';
 import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime, ScaleSymLog, NumberValue } from '@mui/x-charts-vendor/d3-scale';
 import { type SxProps } from '@mui/system/styleFunctionSx';
 import { type HasProperty, type MakeOptional, type MakeRequired } from '@mui/x-internals/types';
+import { type DatasetElementType } from "./seriesType/config.mjs";
 import type { DefaultizedZoomOptions } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.mjs";
 import { type ChartsAxisClasses } from "../ChartsAxis/axisClasses.mjs";
 import type { TickParams } from "../hooks/useTicks.mjs";
@@ -446,6 +447,14 @@ type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
    * The key used to retrieve `data` from the `dataset` prop.
    */
   dataKey?: string;
+  /**
+   * A function to extract and transform the value from the `dataset` item.
+   * It receives the full dataset item and should return the axis value.
+   * Can be used as an alternative to `dataKey`.
+   * @param {DatasetElementType<unknown>} item The full dataset item.
+   * @returns {V} The transformed value.
+   */
+  valueGetter?: (item: DatasetElementType<unknown>) => V;
   /**
    * Formats the axis value.
    * @param {V} value The value to format.
@@ -513,6 +522,8 @@ export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps ext
    * Indicate if the axis should be consider by a tooltip with `trigger='axis'`.
    */
   triggerTooltip?: boolean;
+  /** @ignore - internal. True when a rotation axis covers a full circle. */
+  isFullCircle?: boolean;
 } & (AxisProps extends ChartsXAxisProps ? AxisSideConfig<AxisProps> & {
   height: number;
 } : AxisProps extends ChartsYAxisProps ? AxisSideConfig<AxisProps> & {
@@ -564,8 +575,8 @@ export interface AxisItemIdentifier {
 }
 export type XAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsXAxisProps>, 'id'> : never;
 export type YAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsYAxisProps>, 'id'> : never;
-export type RotationAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? AxisConfig<S, V, ChartsRotationAxisProps> : never;
-export type RadiusAxis<S extends 'linear' = 'linear', V = any> = S extends 'linear' ? AxisConfig<S, V, ChartsRadiusAxisProps> : never;
+export type RotationAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsRotationAxisProps>, 'id'> : never;
+export type RadiusAxis<S extends 'linear' = 'linear', V = any> = S extends 'linear' ? MakeOptional<AxisConfig<S, V, ChartsRadiusAxisProps>, 'id'> : never;
 /**
  * The axis configuration with missing values filled with default values.
  */

package/models/axis.d.ts

@@ -2,6 +2,7 @@ import type * as React from 'react';
 import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime, ScaleSymLog, NumberValue } from '@mui/x-charts-vendor/d3-scale';
 import { type SxProps } from '@mui/system/styleFunctionSx';
 import { type HasProperty, type MakeOptional, type MakeRequired } from '@mui/x-internals/types';
+import { type DatasetElementType } from "./seriesType/config.js";
 import type { DefaultizedZoomOptions } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
 import { type ChartsAxisClasses } from "../ChartsAxis/axisClasses.js";
 import type { TickParams } from "../hooks/useTicks.js";
@@ -446,6 +447,14 @@ type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
    * The key used to retrieve `data` from the `dataset` prop.
    */
   dataKey?: string;
+  /**
+   * A function to extract and transform the value from the `dataset` item.
+   * It receives the full dataset item and should return the axis value.
+   * Can be used as an alternative to `dataKey`.
+   * @param {DatasetElementType<unknown>} item The full dataset item.
+   * @returns {V} The transformed value.
+   */
+  valueGetter?: (item: DatasetElementType<unknown>) => V;
   /**
    * Formats the axis value.
    * @param {V} value The value to format.
@@ -513,6 +522,8 @@ export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps ext
    * Indicate if the axis should be consider by a tooltip with `trigger='axis'`.
    */
   triggerTooltip?: boolean;
+  /** @ignore - internal. True when a rotation axis covers a full circle. */
+  isFullCircle?: boolean;
 } & (AxisProps extends ChartsXAxisProps ? AxisSideConfig<AxisProps> & {
   height: number;
 } : AxisProps extends ChartsYAxisProps ? AxisSideConfig<AxisProps> & {
@@ -564,8 +575,8 @@ export interface AxisItemIdentifier {
 }
 export type XAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsXAxisProps>, 'id'> : never;
 export type YAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsYAxisProps>, 'id'> : never;
-export type RotationAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? AxisConfig<S, V, ChartsRotationAxisProps> : never;
-export type RadiusAxis<S extends 'linear' = 'linear', V = any> = S extends 'linear' ? AxisConfig<S, V, ChartsRadiusAxisProps> : never;
+export type RotationAxis<S extends ScaleName = ScaleName, V = any> = S extends ScaleName ? MakeOptional<AxisConfig<S, V, ChartsRotationAxisProps>, 'id'> : never;
+export type RadiusAxis<S extends 'linear' = 'linear', V = any> = S extends 'linear' ? MakeOptional<AxisConfig<S, V, ChartsRadiusAxisProps>, 'id'> : never;
 /**
  * The axis configuration with missing values filled with default values.
  */

package/models/seriesType/bar.d.mts

@@ -1,10 +1,13 @@
 import { type DefaultizedProps } from '@mui/x-internals/types';
 import type { StackOffsetType } from "../stacking.mjs";
 import { type CartesianSeriesType, type CommonSeriesType, type CommonDefaultizedProps, type StackableSeriesType, type SeriesId } from "./common.mjs";
+import { type DatasetElementType } from "./config.mjs";
 import { type BarItem, type BarLabelContext } from "../../BarChart/index.mjs";
 export type BarValueType = number;
-export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'bar'>, CartesianSeriesType, StackableSeriesType {
-  type: 'bar';
+/**
+ * @internal The series type shared by the bar and radialBar charts
+ */
+export interface CommonBarSeriesType {
   /**
    * Data associated to each bar.
    */
@@ -13,6 +16,14 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * The key used to retrieve data from the dataset.
    */
   dataKey?: string;
+  /**
+   * A function to extract and transform the value from the `dataset` item.
+   * It receives the full dataset item and should return the series value.
+   * Can be used as an alternative to `dataKey`.
+   * @param {DatasetElementType<unknown>} item The full dataset item.
+   * @returns {BarValueType | null} The transformed value.
+   */
+  valueGetter?: (item: DatasetElementType<unknown>) => BarValueType | null;
   /**
    * The label to display on the tooltip or the legend. It can be a string or a function.
    */
@@ -22,11 +33,6 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @default 'vertical'
    */
   layout?: 'horizontal' | 'vertical';
-  /**
-   * Defines how stacked series handle negative values.
-   * @default 'diverging'
-   */
-  stackOffset?: StackOffsetType;
   /**
    * If provided, the value will be used as the minimum size of the bar in pixels.
    * This is useful to avoid bars with a size of 0.
@@ -45,6 +51,9 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @returns {string} The formatted label.
    */
   barLabel?: 'value' | ((item: BarItem, context: BarLabelContext) => string | null | undefined);
+}
+export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'bar'>, CartesianSeriesType, StackableSeriesType, CommonBarSeriesType {
+  type: 'bar';
   /**
    * The placement of the bar label. It accepts the following values:
    * - 'center': the label is centered on the bar
@@ -52,6 +61,11 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @default 'center'
    */
   barLabelPlacement?: 'center' | 'outside';
+  /**
+   * Defines how stacked series handle negative values.
+   * @default 'diverging'
+   */
+  stackOffset?: StackOffsetType;
 }
 /**
  * An object that allows to identify a single bar.

package/models/seriesType/bar.d.ts

@@ -1,10 +1,13 @@
 import { type DefaultizedProps } from '@mui/x-internals/types';
 import type { StackOffsetType } from "../stacking.js";
 import { type CartesianSeriesType, type CommonSeriesType, type CommonDefaultizedProps, type StackableSeriesType, type SeriesId } from "./common.js";
+import { type DatasetElementType } from "./config.js";
 import { type BarItem, type BarLabelContext } from "../../BarChart/index.js";
 export type BarValueType = number;
-export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'bar'>, CartesianSeriesType, StackableSeriesType {
-  type: 'bar';
+/**
+ * @internal The series type shared by the bar and radialBar charts
+ */
+export interface CommonBarSeriesType {
   /**
    * Data associated to each bar.
    */
@@ -13,6 +16,14 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * The key used to retrieve data from the dataset.
    */
   dataKey?: string;
+  /**
+   * A function to extract and transform the value from the `dataset` item.
+   * It receives the full dataset item and should return the series value.
+   * Can be used as an alternative to `dataKey`.
+   * @param {DatasetElementType<unknown>} item The full dataset item.
+   * @returns {BarValueType | null} The transformed value.
+   */
+  valueGetter?: (item: DatasetElementType<unknown>) => BarValueType | null;
   /**
    * The label to display on the tooltip or the legend. It can be a string or a function.
    */
@@ -22,11 +33,6 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @default 'vertical'
    */
   layout?: 'horizontal' | 'vertical';
-  /**
-   * Defines how stacked series handle negative values.
-   * @default 'diverging'
-   */
-  stackOffset?: StackOffsetType;
   /**
    * If provided, the value will be used as the minimum size of the bar in pixels.
    * This is useful to avoid bars with a size of 0.
@@ -45,6 +51,9 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @returns {string} The formatted label.
    */
   barLabel?: 'value' | ((item: BarItem, context: BarLabelContext) => string | null | undefined);
+}
+export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'bar'>, CartesianSeriesType, StackableSeriesType, CommonBarSeriesType {
+  type: 'bar';
   /**
    * The placement of the bar label. It accepts the following values:
    * - 'center': the label is centered on the bar
@@ -52,6 +61,11 @@ export interface BarSeriesType extends CommonSeriesType<BarValueType | null, 'ba
    * @default 'center'
    */
   barLabelPlacement?: 'center' | 'outside';
+  /**
+   * Defines how stacked series handle negative values.
+   * @default 'diverging'
+   */
+  stackOffset?: StackOffsetType;
 }
 /**
  * An object that allows to identify a single bar.

package/models/seriesType/common.d.mts

@@ -67,6 +67,16 @@ export type CartesianSeriesType = {
    */
   yAxisId?: AxisId;
 };
+export type RadialSeriesType = {
+  /**
+   * The id of the rotation-axis used to render the series.
+   */
+  rotationAxisId?: AxisId;
+  /**
+   * The id of the radius-axis used to render the series.
+   */
+  radiusAxisId?: AxisId;
+};
 export type StackableSeriesType = {
   /**
    * The key that identifies the stacking group.

package/models/seriesType/common.d.ts

@@ -67,6 +67,16 @@ export type CartesianSeriesType = {
    */
   yAxisId?: AxisId;
 };
+export type RadialSeriesType = {
+  /**
+   * The id of the rotation-axis used to render the series.
+   */
+  rotationAxisId?: AxisId;
+  /**
+   * The id of the radius-axis used to render the series.
+   */
+  radiusAxisId?: AxisId;
+};
 export type StackableSeriesType = {
   /**
    * The key that identifies the stacking group.

package/models/seriesType/composition.d.mts

@@ -1,4 +1,6 @@
 import type { ChartSeriesType, ChartsSeriesConfig } from "./config.mjs";
 export type ComposableCartesianChartSeriesType = 'bar' | 'line' | 'scatter' | (ChartsSeriesConfig['rangeBar'] extends undefined ? never : 'rangeBar') | (ChartsSeriesConfig['ohlc'] extends undefined ? never : 'ohlc');
 export declare const composableCartesianSeriesTypes: Set<ComposableCartesianChartSeriesType>;
-export type ComposableChartSeriesType<SeriesType extends ChartSeriesType> = SeriesType extends ComposableCartesianChartSeriesType ? ComposableCartesianChartSeriesType : SeriesType;
+export type ComposableRadialChartSeriesType = 'radialLine' | 'radialBar';
+export declare const composableRadialSeriesTypes: Set<ComposableRadialChartSeriesType>;
+export type ComposableChartSeriesType<SeriesType extends ChartSeriesType> = SeriesType extends ComposableCartesianChartSeriesType ? ComposableCartesianChartSeriesType : SeriesType extends ComposableRadialChartSeriesType ? ComposableRadialChartSeriesType : SeriesType;

package/models/seriesType/composition.d.ts

@@ -1,4 +1,6 @@
 import type { ChartSeriesType, ChartsSeriesConfig } from "./config.js";
 export type ComposableCartesianChartSeriesType = 'bar' | 'line' | 'scatter' | (ChartsSeriesConfig['rangeBar'] extends undefined ? never : 'rangeBar') | (ChartsSeriesConfig['ohlc'] extends undefined ? never : 'ohlc');
 export declare const composableCartesianSeriesTypes: Set<ComposableCartesianChartSeriesType>;
-export type ComposableChartSeriesType<SeriesType extends ChartSeriesType> = SeriesType extends ComposableCartesianChartSeriesType ? ComposableCartesianChartSeriesType : SeriesType;
+export type ComposableRadialChartSeriesType = 'radialLine' | 'radialBar';
+export declare const composableRadialSeriesTypes: Set<ComposableRadialChartSeriesType>;
+export type ComposableChartSeriesType<SeriesType extends ChartSeriesType> = SeriesType extends ComposableCartesianChartSeriesType ? ComposableCartesianChartSeriesType : SeriesType extends ComposableRadialChartSeriesType ? ComposableRadialChartSeriesType : SeriesType;

package/models/seriesType/composition.js

@@ -3,5 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.composableCartesianSeriesTypes = void 0;
-const composableCartesianSeriesTypes = exports.composableCartesianSeriesTypes = new Set(['bar', 'line', 'scatter', 'rangeBar', 'ohlc']);
+exports.composableRadialSeriesTypes = exports.composableCartesianSeriesTypes = void 0;
+const composableCartesianSeriesTypes = exports.composableCartesianSeriesTypes = new Set(['bar', 'line', 'scatter', 'rangeBar', 'ohlc']);
+
+// Idem for radial series
+
+const composableRadialSeriesTypes = exports.composableRadialSeriesTypes = new Set(['radialLine', 'radialBar']);

package/models/seriesType/composition.mjs

@@ -1 +1,5 @@
-export const composableCartesianSeriesTypes = new Set(['bar', 'line', 'scatter', 'rangeBar', 'ohlc']);
+export const composableCartesianSeriesTypes = new Set(['bar', 'line', 'scatter', 'rangeBar', 'ohlc']);
+
+// Idem for radial series
+
+export const composableRadialSeriesTypes = new Set(['radialLine', 'radialBar']);

package/models/seriesType/index.d.mts

@@ -10,11 +10,11 @@ export type SeriesItemIdentifierWithData<SeriesType extends ChartSeriesType> = S
  */
 export type HighlightItemIdentifier<SeriesType extends ChartSeriesType> = SeriesType extends any ? DistributiveOmit<ChartsSeriesConfig[SeriesType]['highlightIdentifier'], 'type'> : never;
 export type HighlightItemIdentifierWithType<SeriesType extends ChartSeriesType> = SeriesType extends any ? ChartsSeriesConfig[SeriesType]['highlightIdentifier'] : never;
-export type FocusedItemIdentifier<SeriesType extends ChartSeriesType = ChartSeriesType> = SeriesType extends 'line' | 'radar' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'dataIndex'> : SeriesType extends 'heatmap' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'xIndex' | 'yIndex'> : ChartsSeriesConfig[SeriesType]['itemIdentifier'];
+export type FocusedItemIdentifier<SeriesType extends ChartSeriesType = ChartSeriesType> = SeriesType extends 'line' | 'radar' | 'radialLine' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'dataIndex'> : SeriesType extends 'heatmap' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'xIndex' | 'yIndex'> : ChartsSeriesConfig[SeriesType]['itemIdentifier'];
 export { type SeriesId } from "./common.mjs";
 export type { CartesianChartSeriesType, StackableChartSeriesType } from "./config.mjs";
-export * from "./line.mjs";
-export * from "./bar.mjs";
+export type { ShowMarkParams, MarkShape, LineSeriesType, LineItemIdentifier, DefaultizedLineSeriesType } from "./line.mjs";
+export type { BarValueType, BarSeriesType, BarItemIdentifier, DefaultizedBarSeriesType } from "./bar.mjs";
 export * from "./scatter.mjs";
 export * from "./pie.mjs";
 export * from "./radar.mjs";

package/models/seriesType/index.d.ts

@@ -10,11 +10,11 @@ export type SeriesItemIdentifierWithData<SeriesType extends ChartSeriesType> = S
  */
 export type HighlightItemIdentifier<SeriesType extends ChartSeriesType> = SeriesType extends any ? DistributiveOmit<ChartsSeriesConfig[SeriesType]['highlightIdentifier'], 'type'> : never;
 export type HighlightItemIdentifierWithType<SeriesType extends ChartSeriesType> = SeriesType extends any ? ChartsSeriesConfig[SeriesType]['highlightIdentifier'] : never;
-export type FocusedItemIdentifier<SeriesType extends ChartSeriesType = ChartSeriesType> = SeriesType extends 'line' | 'radar' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'dataIndex'> : SeriesType extends 'heatmap' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'xIndex' | 'yIndex'> : ChartsSeriesConfig[SeriesType]['itemIdentifier'];
+export type FocusedItemIdentifier<SeriesType extends ChartSeriesType = ChartSeriesType> = SeriesType extends 'line' | 'radar' | 'radialLine' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'dataIndex'> : SeriesType extends 'heatmap' ? DefaultizedProps<ChartsSeriesConfig[SeriesType]['itemIdentifier'], 'xIndex' | 'yIndex'> : ChartsSeriesConfig[SeriesType]['itemIdentifier'];
 export { type SeriesId } from "./common.js";
 export type { CartesianChartSeriesType, StackableChartSeriesType } from "./config.js";
-export * from "./line.js";
-export * from "./bar.js";
+export type { ShowMarkParams, MarkShape, LineSeriesType, LineItemIdentifier, DefaultizedLineSeriesType } from "./line.js";
+export type { BarValueType, BarSeriesType, BarItemIdentifier, DefaultizedBarSeriesType } from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
 export * from "./radar.js";

package/models/seriesType/index.js

@@ -3,28 +3,6 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _line = require("./line");
-Object.keys(_line).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _line[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _line[key];
-    }
-  });
-});
-var _bar = require("./bar");
-Object.keys(_bar).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _bar[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _bar[key];
-    }
-  });
-});
 var _scatter = require("./scatter");
 Object.keys(_scatter).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/models/seriesType/index.mjs

@@ -9,8 +9,6 @@
  * Identifies an highlighted item or series.
  */
 
-export * from "./line.mjs";
-export * from "./bar.mjs";
 export * from "./scatter.mjs";
 export * from "./pie.mjs";
 export * from "./radar.mjs";