@mui/x-charts 9.10.0 → 9.11.0

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

@@ -12,7 +12,7 @@ import { generatePolar2svg, generateSvg2polar, generateSvg2radius, generateSvg2r
 import { getRadiusAxisIndex, getRotationAxisIndex } from "./getAxisIndex.mjs";
 import { selectorChartSeriesProcessed } from "../../corePlugins/useChartSeries/index.mjs";
 import { checkHasInteractionPlugin } from "../useChartInteraction/checkHasInteractionPlugin.mjs";
-import { isPolarSeriesType } from "../../../isPolar.mjs";
+import { getPolarAxisClickPayload } from "./getPolarAxisClickPayload.mjs";
 export const useChartPolarAxis = ({
   params,
   store,
@@ -167,34 +167,33 @@ export const useChartPolarAxis = ({
       return () => {};
     }
     const axisClickHandler = instance.addInteractionListener('tap', event => {
-      let dataIndex = null;
-      let isRotationAxis = false;
       const svgPoint = getChartPoint(element, event.detail.srcEvent);
       const rotation = generateSvg2rotation(center)(svgPoint.x, svgPoint.y);
       const rotationIndex = getRotationAxisIndex(rotationAxisWithScale[usedRotationAxisId], rotation);
       const radius = generateSvg2radius(center)(svgPoint.x, svgPoint.y);
       const radiusIndex = getRadiusAxisIndex(radiusAxisWithScale[usedRadiusAxisId], radius);
-      isRotationAxis = rotationIndex !== -1;
-      dataIndex = isRotationAxis ? rotationIndex : radiusIndex;
-      const USED_AXIS_ID = isRotationAxis ? usedRotationAxisId : usedRadiusAxisId;
-      if (dataIndex == null || dataIndex === -1) {
+      const isRotationAxis = rotationIndex !== -1;
+      const dataIndex = isRotationAxis ? rotationIndex : radiusIndex;
+      if (dataIndex === -1) {
         return;
       }
-
-      // The .data exist because otherwise the dataIndex would be null or -1.
-      const axisValue = (isRotationAxis ? rotationAxisWithScale : radiusAxisWithScale)[USED_AXIS_ID].data[dataIndex];
-      const seriesValues = {};
-      Object.keys(processedSeries).filter(isPolarSeriesType).forEach(seriesType => {
-        processedSeries[seriesType]?.seriesOrder.forEach(seriesId => {
-          const seriesItem = processedSeries[seriesType].series[seriesId];
-          seriesValues[seriesId] = seriesItem.data[dataIndex];
-        });
-      });
-      onAxisClick(event.detail.srcEvent, {
+      const payload = getPolarAxisClickPayload({
         dataIndex,
-        axisValue,
-        seriesValues
+        isRotationAxis,
+        rotationAxes: {
+          axis: rotationAxisWithScale,
+          axisIds: [usedRotationAxisId]
+        },
+        radiusAxes: {
+          axis: radiusAxisWithScale,
+          axisIds: [usedRadiusAxisId]
+        },
+        processedSeries
       });
+      if (payload === null) {
+        return;
+      }
+      onAxisClick(event.detail.srcEvent, payload);
     });
     return () => {
       axisClickHandler.cleanup();

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

@@ -2,8 +2,8 @@ import type { UseChartPolarAxisSignature } from "./useChartPolarAxis.types.mjs";
 import type { ChartState } from "../../models/chart.mjs";
 import type { ChartDrawingArea } from "../../../../hooks/useDrawingArea.mjs";
 export declare const selectorChartPolarAxisState: (state: ChartState<[], [UseChartPolarAxisSignature]>) => {
-  rotation: import("../../../index.mjs").PolarAxisConfig<import("../../../index.mjs").ScaleName, any, import("../../../index.mjs").ChartsRotationAxisProps>[];
-  radius: import("../../../index.mjs").PolarAxisConfig<import("../../../index.mjs").ScaleName, any, import("../../../index.mjs").ChartsRadiusAxisProps>[];
+  rotation: import("../../../index.mjs").PolarAxisConfig<import("@mui/x-charts/models").ScaleName, any, import("../../../index.mjs").ChartsRotationAxisProps>[];
+  radius: import("../../../index.mjs").PolarAxisConfig<import("@mui/x-charts/models").ScaleName, any, import("../../../index.mjs").ChartsRadiusAxisProps>[];
 } | undefined;
 export declare const selectorChartRawRotationAxis: (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("./useChartPolarAxis.types.mjs").UseChartPolarAxisState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;

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

@@ -2,8 +2,8 @@ import type { UseChartPolarAxisSignature } from "./useChartPolarAxis.types.js";
 import type { ChartState } from "../../models/chart.js";
 import type { ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
 export declare const selectorChartPolarAxisState: (state: ChartState<[], [UseChartPolarAxisSignature]>) => {
-  rotation: import("../../../index.js").PolarAxisConfig<import("../../../index.js").ScaleName, any, import("../../../index.js").ChartsRotationAxisProps>[];
-  radius: import("../../../index.js").PolarAxisConfig<import("../../../index.js").ScaleName, any, import("../../../index.js").ChartsRadiusAxisProps>[];
+  rotation: import("../../../index.js").PolarAxisConfig<import("@mui/x-charts/models").ScaleName, any, import("../../../index.js").ChartsRotationAxisProps>[];
+  radius: import("../../../index.js").PolarAxisConfig<import("@mui/x-charts/models").ScaleName, any, import("../../../index.js").ChartsRadiusAxisProps>[];
 } | undefined;
 export declare const selectorChartRawRotationAxis: (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("./useChartPolarAxis.types.js").UseChartPolarAxisState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;

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

@@ -1,7 +1,7 @@
 import type { SeriesItemIdentifierWithType } from "../../../../models/index.mjs";
 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").BarItemIdentifier | import("../../../index.mjs").LineItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | null;
+}) => import("@mui/x-charts/models").BarItemIdentifier | import("@mui/x-charts/models").LineItemIdentifier | import("@mui/x-charts/models").PieItemIdentifier | import("@mui/x-charts/models").RadarItemIdentifier | import("@mui/x-charts/models").ScatterItemIdentifier | 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;

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

@@ -1,7 +1,7 @@
 import type { SeriesItemIdentifierWithType } from "../../../../models/index.js";
 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").BarItemIdentifier | import("../../../index.js").LineItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | null;
+}) => import("@mui/x-charts/models").BarItemIdentifier | import("@mui/x-charts/models").LineItemIdentifier | import("@mui/x-charts/models").PieItemIdentifier | import("@mui/x-charts/models").RadarItemIdentifier | import("@mui/x-charts/models").ScatterItemIdentifier | 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;

package/internals/seriesSelectorOfType.d.mts

@@ -4,17 +4,17 @@ import type { ProcessedSeries } from "./plugins/corePlugins/useChartSeries/index
 export declare const selectorAllSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("./index.mjs").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.mjs").ChartStateCacheKey;
 }, seriesType: keyof ChartsSeriesConfig) => {
-  series: Record<string, import("../index.mjs").DefaultizedPieSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedPieSeriesType>;
   seriesOrder: SeriesId[];
 } | {
-  series: Record<string, import("../index.mjs").DefaultizedRadarSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedRadarSeriesType>;
   seriesOrder: SeriesId[];
 } | {
-  series: Record<string, import("../index.mjs").DefaultizedScatterSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedScatterSeriesType>;
   seriesOrder: SeriesId[];
 } | import("./index.mjs").SeriesProcessorResult<"bar"> | import("./index.mjs").SeriesProcessorResult<"line"> | undefined;
 export declare const selectorSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("./index.mjs").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.mjs").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig, ids: string | string[] | undefined) => (import("../index.mjs").DefaultizedBarSeriesType | import("../index.mjs").DefaultizedLineSeriesType | import("../index.mjs").DefaultizedPieSeriesType | import("../index.mjs").DefaultizedRadarSeriesType | import("../index.mjs").DefaultizedScatterSeriesType | undefined)[] | import("../index.mjs").DefaultizedBarSeriesType | import("../index.mjs").DefaultizedLineSeriesType | import("../index.mjs").DefaultizedPieSeriesType | import("../index.mjs").DefaultizedRadarSeriesType | import("../index.mjs").DefaultizedScatterSeriesType | undefined;
+}, seriesType: keyof ChartsSeriesConfig, ids: string | string[] | undefined) => (import("@mui/x-charts/models").DefaultizedBarSeriesType | import("@mui/x-charts/models").DefaultizedLineSeriesType | import("@mui/x-charts/models").DefaultizedPieSeriesType | import("@mui/x-charts/models").DefaultizedRadarSeriesType | import("@mui/x-charts/models").DefaultizedScatterSeriesType | undefined)[] | import("@mui/x-charts/models").DefaultizedBarSeriesType | import("@mui/x-charts/models").DefaultizedLineSeriesType | import("@mui/x-charts/models").DefaultizedPieSeriesType | import("@mui/x-charts/models").DefaultizedRadarSeriesType | import("@mui/x-charts/models").DefaultizedScatterSeriesType | undefined;
 export declare const useAllSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T) => ProcessedSeries[T];
 export declare const useSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T, seriesId?: SeriesId | SeriesId[]) => ChartSeriesDefaultized<T> | ChartSeriesDefaultized<T>[] | undefined;

package/internals/seriesSelectorOfType.d.ts

@@ -4,17 +4,17 @@ import type { ProcessedSeries } from "./plugins/corePlugins/useChartSeries/index
 export declare const selectorAllSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
 }, seriesType: keyof ChartsSeriesConfig) => {
-  series: Record<string, import("../index.js").DefaultizedPieSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedPieSeriesType>;
   seriesOrder: SeriesId[];
 } | {
-  series: Record<string, import("../index.js").DefaultizedRadarSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedRadarSeriesType>;
   seriesOrder: SeriesId[];
 } | {
-  series: Record<string, import("../index.js").DefaultizedScatterSeriesType>;
+  series: Record<string, import("@mui/x-charts/models").DefaultizedScatterSeriesType>;
   seriesOrder: SeriesId[];
 } | import("./index.js").SeriesProcessorResult<"bar"> | import("./index.js").SeriesProcessorResult<"line"> | undefined;
 export declare const selectorSeriesOfType: (args_0: import("./plugins/corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("./plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("./plugins/corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("./plugins/corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof ChartsSeriesConfig> & import("./plugins/corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("./index.js").UseChartInteractionListenerState & Partial<{}> & {
   cacheKey: import("./index.js").ChartStateCacheKey;
-}, seriesType: keyof ChartsSeriesConfig, ids: string | string[] | undefined) => (import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | import("../index.js").DefaultizedScatterSeriesType | undefined)[] | import("../index.js").DefaultizedBarSeriesType | import("../index.js").DefaultizedLineSeriesType | import("../index.js").DefaultizedPieSeriesType | import("../index.js").DefaultizedRadarSeriesType | import("../index.js").DefaultizedScatterSeriesType | undefined;
+}, seriesType: keyof ChartsSeriesConfig, ids: string | string[] | undefined) => (import("@mui/x-charts/models").DefaultizedBarSeriesType | import("@mui/x-charts/models").DefaultizedLineSeriesType | import("@mui/x-charts/models").DefaultizedPieSeriesType | import("@mui/x-charts/models").DefaultizedRadarSeriesType | import("@mui/x-charts/models").DefaultizedScatterSeriesType | undefined)[] | import("@mui/x-charts/models").DefaultizedBarSeriesType | import("@mui/x-charts/models").DefaultizedLineSeriesType | import("@mui/x-charts/models").DefaultizedPieSeriesType | import("@mui/x-charts/models").DefaultizedRadarSeriesType | import("@mui/x-charts/models").DefaultizedScatterSeriesType | undefined;
 export declare const useAllSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T) => ProcessedSeries[T];
 export declare const useSeriesOfType: <T extends keyof ChartsSeriesConfig>(seriesType: T, seriesId?: SeriesId | SeriesId[]) => ChartSeriesDefaultized<T> | ChartSeriesDefaultized<T>[] | undefined;

package/internals/snapEndAngleToFullCircle.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Snaps the end angle of an arc to create a full circle when the arc spans almost, but not
+ * exactly, the full circle.
+ *
+ * When an arc spans almost the full circle (e.g., when the remaining slices of a pie are
+ * extremely small compared to the largest one), its start and end points are so close that they
+ * can round to the same path coordinates. SVG omits arcs whose end point equals their start
+ * point, which makes the quasi-full-circle arc invisible.
+ * See https://github.com/mui/mui-x/issues/14167
+ *
+ * The end angle is only snapped when the gap left by the arc is smaller than the precision of
+ * the serialized path, so the snapping is visually lossless.
+ *
+ * @param startAngle The start angle of the arc, in radians.
+ * @param endAngle The end angle of the arc, in radians.
+ * @param outerRadius The outer radius of the arc.
+ * @param padAngle The pad angle of the arc, in radians.
+ * @returns The end angle, snapped to `startAngle ± 2 * Math.PI` when applicable.
+ */
+export declare function snapEndAngleToFullCircle(startAngle: number, endAngle: number, outerRadius: number, padAngle?: number): number;

package/internals/snapEndAngleToFullCircle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Snaps the end angle of an arc to create a full circle when the arc spans almost, but not
+ * exactly, the full circle.
+ *
+ * When an arc spans almost the full circle (e.g., when the remaining slices of a pie are
+ * extremely small compared to the largest one), its start and end points are so close that they
+ * can round to the same path coordinates. SVG omits arcs whose end point equals their start
+ * point, which makes the quasi-full-circle arc invisible.
+ * See https://github.com/mui/mui-x/issues/14167
+ *
+ * The end angle is only snapped when the gap left by the arc is smaller than the precision of
+ * the serialized path, so the snapping is visually lossless.
+ *
+ * @param startAngle The start angle of the arc, in radians.
+ * @param endAngle The end angle of the arc, in radians.
+ * @param outerRadius The outer radius of the arc.
+ * @param padAngle The pad angle of the arc, in radians.
+ * @returns The end angle, snapped to `startAngle ± 2 * Math.PI` when applicable.
+ */
+export declare function snapEndAngleToFullCircle(startAngle: number, endAngle: number, outerRadius: number, padAngle?: number): number;

package/internals/snapEndAngleToFullCircle.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.snapEndAngleToFullCircle = snapEndAngleToFullCircle;
+const TAU = 2 * Math.PI;
+
+/* `d3-shape` serializes paths with a precision of 3 digits, i.e., a resolution of 1e-3. */
+const PATH_PRECISION = 1e-3;
+/* If the distance between the start and end points of an arc is at least twice the path
+ * precision, at least one of their coordinates is guaranteed to round to a different value. */
+const MIN_DISTINCT_CHORD_LENGTH = 2 * PATH_PRECISION;
+
+/**
+ * Snaps the end angle of an arc to create a full circle when the arc spans almost, but not
+ * exactly, the full circle.
+ *
+ * When an arc spans almost the full circle (e.g., when the remaining slices of a pie are
+ * extremely small compared to the largest one), its start and end points are so close that they
+ * can round to the same path coordinates. SVG omits arcs whose end point equals their start
+ * point, which makes the quasi-full-circle arc invisible.
+ * See https://github.com/mui/mui-x/issues/14167
+ *
+ * The end angle is only snapped when the gap left by the arc is smaller than the precision of
+ * the serialized path, so the snapping is visually lossless.
+ *
+ * @param startAngle The start angle of the arc, in radians.
+ * @param endAngle The end angle of the arc, in radians.
+ * @param outerRadius The outer radius of the arc.
+ * @param padAngle The pad angle of the arc, in radians.
+ * @returns The end angle, snapped to `startAngle ± 2 * Math.PI` when applicable.
+ */
+function snapEndAngleToFullCircle(startAngle, endAngle, outerRadius, padAngle = 0) {
+  const sweep = Math.abs(endAngle - startAngle);
+  if (sweep === 0 || sweep >= TAU) {
+    return endAngle;
+  }
+
+  // Chord between the start and end points of the arc, once the padding is applied.
+  // For such small angles, the chord length is approximately `radius * angle`.
+  const gapChordLength = (TAU - sweep + Math.abs(padAngle)) * outerRadius;
+  if (gapChordLength >= MIN_DISTINCT_CHORD_LENGTH) {
+    return endAngle;
+  }
+  return startAngle + Math.sign(endAngle - startAngle) * TAU;
+}

package/internals/snapEndAngleToFullCircle.mjs

@@ -0,0 +1,41 @@
+const TAU = 2 * Math.PI;
+
+/* `d3-shape` serializes paths with a precision of 3 digits, i.e., a resolution of 1e-3. */
+const PATH_PRECISION = 1e-3;
+/* If the distance between the start and end points of an arc is at least twice the path
+ * precision, at least one of their coordinates is guaranteed to round to a different value. */
+const MIN_DISTINCT_CHORD_LENGTH = 2 * PATH_PRECISION;
+
+/**
+ * Snaps the end angle of an arc to create a full circle when the arc spans almost, but not
+ * exactly, the full circle.
+ *
+ * When an arc spans almost the full circle (e.g., when the remaining slices of a pie are
+ * extremely small compared to the largest one), its start and end points are so close that they
+ * can round to the same path coordinates. SVG omits arcs whose end point equals their start
+ * point, which makes the quasi-full-circle arc invisible.
+ * See https://github.com/mui/mui-x/issues/14167
+ *
+ * The end angle is only snapped when the gap left by the arc is smaller than the precision of
+ * the serialized path, so the snapping is visually lossless.
+ *
+ * @param startAngle The start angle of the arc, in radians.
+ * @param endAngle The end angle of the arc, in radians.
+ * @param outerRadius The outer radius of the arc.
+ * @param padAngle The pad angle of the arc, in radians.
+ * @returns The end angle, snapped to `startAngle ± 2 * Math.PI` when applicable.
+ */
+export function snapEndAngleToFullCircle(startAngle, endAngle, outerRadius, padAngle = 0) {
+  const sweep = Math.abs(endAngle - startAngle);
+  if (sweep === 0 || sweep >= TAU) {
+    return endAngle;
+  }
+
+  // Chord between the start and end points of the arc, once the padding is applied.
+  // For such small angles, the chord length is approximately `radius * angle`.
+  const gapChordLength = (TAU - sweep + Math.abs(padAngle)) * outerRadius;
+  if (gapChordLength >= MIN_DISTINCT_CHORD_LENGTH) {
+    return endAngle;
+  }
+  return startAngle + Math.sign(endAngle - startAngle) * TAU;
+}

package/internals/useRegisterItemActivation.d.mts

@@ -0,0 +1,23 @@
+import type { ChartSeriesType } from "../models/seriesType/config.mjs";
+import type { SeriesId } from "../models/seriesType/common.mjs";
+import type { FocusedItemIdentifier } from "../models/seriesType/index.mjs";
+/**
+ * Registers a handler fired when the keyboard-focused item is activated with <kbd>Enter</kbd> or
+ * <kbd>Space</kbd>. It is a no-op when the `keyboardActivation` experimental feature is off.
+ *
+ * Scope the registration as tightly as the caller knows: when several plots handle the same item,
+ * the most specific scope wins, `priority` breaks ties, `canActivate` can decline an item, and the
+ * handler runs once.
+ *
+ * The handler receives the `KeyboardEvent`, typed as `any` because the click callbacks it forwards
+ * to only describe the pointer event unless the user augments `keyboardActivationOverride`.
+ *
+ * @param scope The items covered by the handler. Omit `seriesId` to cover a whole series type.
+ * @param handler The handler to call on activation, or `undefined` to register nothing.
+ */
+export declare function useRegisterItemActivation<SeriesType extends ChartSeriesType = ChartSeriesType>(scope: {
+  type?: SeriesType;
+  seriesId?: SeriesId;
+  priority?: number;
+  canActivate?: (item: FocusedItemIdentifier<SeriesType>) => boolean;
+}, handler: ((event: any, item: FocusedItemIdentifier<SeriesType>) => void) | undefined): void;

package/internals/useRegisterItemActivation.d.ts

@@ -0,0 +1,23 @@
+import type { ChartSeriesType } from "../models/seriesType/config.js";
+import type { SeriesId } from "../models/seriesType/common.js";
+import type { FocusedItemIdentifier } from "../models/seriesType/index.js";
+/**
+ * Registers a handler fired when the keyboard-focused item is activated with <kbd>Enter</kbd> or
+ * <kbd>Space</kbd>. It is a no-op when the `keyboardActivation` experimental feature is off.
+ *
+ * Scope the registration as tightly as the caller knows: when several plots handle the same item,
+ * the most specific scope wins, `priority` breaks ties, `canActivate` can decline an item, and the
+ * handler runs once.
+ *
+ * The handler receives the `KeyboardEvent`, typed as `any` because the click callbacks it forwards
+ * to only describe the pointer event unless the user augments `keyboardActivationOverride`.
+ *
+ * @param scope The items covered by the handler. Omit `seriesId` to cover a whole series type.
+ * @param handler The handler to call on activation, or `undefined` to register nothing.
+ */
+export declare function useRegisterItemActivation<SeriesType extends ChartSeriesType = ChartSeriesType>(scope: {
+  type?: SeriesType;
+  seriesId?: SeriesId;
+  priority?: number;
+  canActivate?: (item: FocusedItemIdentifier<SeriesType>) => boolean;
+}, handler: ((event: any, item: FocusedItemIdentifier<SeriesType>) => void) | undefined): void;

package/internals/useRegisterItemActivation.js

@@ -0,0 +1,53 @@
+"use strict";
+'use client';
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRegisterItemActivation = useRegisterItemActivation;
+var React = _interopRequireWildcard(require("react"));
+var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
+var _ChartsProvider = require("../context/ChartsProvider");
+/**
+ * Registers a handler fired when the keyboard-focused item is activated with <kbd>Enter</kbd> or
+ * <kbd>Space</kbd>. It is a no-op when the `keyboardActivation` experimental feature is off.
+ *
+ * Scope the registration as tightly as the caller knows: when several plots handle the same item,
+ * the most specific scope wins, `priority` breaks ties, `canActivate` can decline an item, and the
+ * handler runs once.
+ *
+ * The handler receives the `KeyboardEvent`, typed as `any` because the click callbacks it forwards
+ * to only describe the pointer event unless the user augments `keyboardActivationOverride`.
+ *
+ * @param scope The items covered by the handler. Omit `seriesId` to cover a whole series type.
+ * @param handler The handler to call on activation, or `undefined` to register nothing.
+ */
+function useRegisterItemActivation(scope, handler) {
+  const {
+    instance
+  } = (0, _ChartsProvider.useChartsContext)();
+  const {
+    type,
+    seriesId,
+    priority,
+    canActivate
+  } = scope;
+  const hasHandler = handler !== undefined;
+  const stableHandler = (0, _useEventCallback.default)((event, item) => handler?.(event, item));
+  const hasCanActivate = canActivate !== undefined;
+  const stableCanActivate = (0, _useEventCallback.default)(item => canActivate ? canActivate(item) : true);
+  const registerItemActivationHandler = instance.registerItemActivationHandler;
+  React.useEffect(() => {
+    if (!hasHandler || !registerItemActivationHandler) {
+      return undefined;
+    }
+    return registerItemActivationHandler({
+      type,
+      seriesId,
+      priority,
+      canActivate: hasCanActivate ? stableCanActivate : undefined
+    }, stableHandler);
+  }, [registerItemActivationHandler, hasHandler, type, seriesId, priority, hasCanActivate, stableCanActivate, stableHandler]);
+}

package/internals/useRegisterItemActivation.mjs

@@ -0,0 +1,46 @@
+'use client';
+
+import * as React from 'react';
+import useEventCallback from '@mui/utils/useEventCallback';
+import { useChartsContext } from "../context/ChartsProvider/index.mjs";
+/**
+ * Registers a handler fired when the keyboard-focused item is activated with <kbd>Enter</kbd> or
+ * <kbd>Space</kbd>. It is a no-op when the `keyboardActivation` experimental feature is off.
+ *
+ * Scope the registration as tightly as the caller knows: when several plots handle the same item,
+ * the most specific scope wins, `priority` breaks ties, `canActivate` can decline an item, and the
+ * handler runs once.
+ *
+ * The handler receives the `KeyboardEvent`, typed as `any` because the click callbacks it forwards
+ * to only describe the pointer event unless the user augments `keyboardActivationOverride`.
+ *
+ * @param scope The items covered by the handler. Omit `seriesId` to cover a whole series type.
+ * @param handler The handler to call on activation, or `undefined` to register nothing.
+ */
+export function useRegisterItemActivation(scope, handler) {
+  const {
+    instance
+  } = useChartsContext();
+  const {
+    type,
+    seriesId,
+    priority,
+    canActivate
+  } = scope;
+  const hasHandler = handler !== undefined;
+  const stableHandler = useEventCallback((event, item) => handler?.(event, item));
+  const hasCanActivate = canActivate !== undefined;
+  const stableCanActivate = useEventCallback(item => canActivate ? canActivate(item) : true);
+  const registerItemActivationHandler = instance.registerItemActivationHandler;
+  React.useEffect(() => {
+    if (!hasHandler || !registerItemActivationHandler) {
+      return undefined;
+    }
+    return registerItemActivationHandler({
+      type,
+      seriesId,
+      priority,
+      canActivate: hasCanActivate ? stableCanActivate : undefined
+    }, stableHandler);
+  }, [registerItemActivationHandler, hasHandler, type, seriesId, priority, hasCanActivate, stableCanActivate, stableHandler]);
+}

package/models/axis.d.mts

@@ -627,7 +627,7 @@ export interface ChartsAxisData {
   /**
    * The mapping of series ids to their value for this particular axis index.
    */
-  seriesValues: Record<string, HasProperty<ChartsTypeFeatureFlags, 'seriesValueOverride'> extends true ? ChartsTypeFeatureFlags['seriesValuesOverride'] : number | null | undefined>;
+  seriesValues: Record<string, HasProperty<ChartsTypeFeatureFlags, 'seriesValuesOverride'> extends true ? ChartsTypeFeatureFlags['seriesValuesOverride'] : number | null | undefined>;
 }
 export type CartesianDirection = 'x' | 'y';
 export type PolarDirection = 'rotation' | 'radius';

package/models/axis.d.ts

@@ -627,7 +627,7 @@ export interface ChartsAxisData {
   /**
    * The mapping of series ids to their value for this particular axis index.
    */
-  seriesValues: Record<string, HasProperty<ChartsTypeFeatureFlags, 'seriesValueOverride'> extends true ? ChartsTypeFeatureFlags['seriesValuesOverride'] : number | null | undefined>;
+  seriesValues: Record<string, HasProperty<ChartsTypeFeatureFlags, 'seriesValuesOverride'> extends true ? ChartsTypeFeatureFlags['seriesValuesOverride'] : number | null | undefined>;
 }
 export type CartesianDirection = 'x' | 'y';
 export type PolarDirection = 'rotation' | 'radius';

package/models/events.d.mts

@@ -0,0 +1,11 @@
+import type * as React from 'react';
+import type { HasProperty } from '@mui/x-internals/types';
+import type { ChartsTypeFeatureFlags } from "./featureFlags.mjs";
+/**
+ * The event a click callback receives.
+ *
+ * It only describes the pointer event by default. Add
+ * `import type {} from '@mui/x-charts/moduleAugmentation/keyboardActivation'` to also get the
+ * `KeyboardEvent` fired by the `keyboardActivation` experimental feature.
+ */
+export type ChartsActivationEvent<Element = never> = ([Element] extends [never] ? MouseEvent : React.MouseEvent<Element, MouseEvent>) | (HasProperty<ChartsTypeFeatureFlags, 'keyboardActivationOverride'> extends true ? ChartsTypeFeatureFlags['keyboardActivationOverride'] : never);

package/models/events.d.ts

@@ -0,0 +1,11 @@
+import type * as React from 'react';
+import type { HasProperty } from '@mui/x-internals/types';
+import type { ChartsTypeFeatureFlags } from "./featureFlags.js";
+/**
+ * The event a click callback receives.
+ *
+ * It only describes the pointer event by default. Add
+ * `import type {} from '@mui/x-charts/moduleAugmentation/keyboardActivation'` to also get the
+ * `KeyboardEvent` fired by the `keyboardActivation` experimental feature.
+ */
+export type ChartsActivationEvent<Element = never> = ([Element] extends [never] ? MouseEvent : React.MouseEvent<Element, MouseEvent>) | (HasProperty<ChartsTypeFeatureFlags, 'keyboardActivationOverride'> extends true ? ChartsTypeFeatureFlags['keyboardActivationOverride'] : never);

package/models/events.js

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

package/models/events.mjs

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

package/models/index.d.mts

@@ -2,6 +2,7 @@ export * from "./seriesType/index.mjs";
 export * from "./stacking.mjs";
 export * from "./slots/index.mjs";
 export * from "./featureFlags.mjs";
+export type { ChartsActivationEvent } from "./events.mjs";
 export * from "./chartsSlotsComponentsProps.mjs";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData, XAxis, YAxis, RadiusAxis, RotationAxis, AxisItemIdentifier, AxisValueFormatterContext } from "./axis.mjs";
 export type { NumberValue } from '@mui/x-charts-vendor/d3-scale';

package/models/index.d.ts

@@ -2,6 +2,7 @@ export * from "./seriesType/index.js";
 export * from "./stacking.js";
 export * from "./slots/index.js";
 export * from "./featureFlags.js";
+export type { ChartsActivationEvent } from "./events.js";
 export * from "./chartsSlotsComponentsProps.js";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData, XAxis, YAxis, RadiusAxis, RotationAxis, AxisItemIdentifier, AxisValueFormatterContext } from "./axis.js";
 export type { NumberValue } from '@mui/x-charts-vendor/d3-scale';

package/moduleAugmentation/barChartBatchRendererOnItemClick.d.mts

@@ -1,13 +1,12 @@
-import type * as React from 'react';
-import type { BarItemIdentifier } from "../models/index.mjs";
+import type { BarItemIdentifier, ChartsActivationEvent } from "../models/index.mjs";
 declare module '@mui/x-charts/BarChart' {
   interface BarPlotProps {
     /**
      * Callback fired when a bar item is clicked.
-     * @param {MouseEvent | React.MouseEvent<SVGElement, MouseEvent>} event The event source of the callback.
+     * @param {ChartsActivationEvent | ChartsActivationEvent<SVGElement>} event The event source of the callback.
      *        It is a native MouseEvent for `svg-batch` renderer and a React MouseEvent for `svg-single` renderer.
      * @param {BarItemIdentifier} barItemIdentifier The bar item identifier.
      */
-    onItemClick?(event: MouseEvent | React.MouseEvent<SVGElement, MouseEvent>, barItemIdentifier: BarItemIdentifier): void;
+    onItemClick?(event: ChartsActivationEvent | ChartsActivationEvent<SVGElement>, barItemIdentifier: BarItemIdentifier): void;
   }
 }

package/moduleAugmentation/barChartBatchRendererOnItemClick.d.ts

@@ -1,13 +1,12 @@
-import type * as React from 'react';
-import type { BarItemIdentifier } from "../models/index.js";
+import type { BarItemIdentifier, ChartsActivationEvent } from "../models/index.js";
 declare module '@mui/x-charts/BarChart' {
   interface BarPlotProps {
     /**
      * Callback fired when a bar item is clicked.
-     * @param {MouseEvent | React.MouseEvent<SVGElement, MouseEvent>} event The event source of the callback.
+     * @param {ChartsActivationEvent | ChartsActivationEvent<SVGElement>} event The event source of the callback.
      *        It is a native MouseEvent for `svg-batch` renderer and a React MouseEvent for `svg-single` renderer.
      * @param {BarItemIdentifier} barItemIdentifier The bar item identifier.
      */
-    onItemClick?(event: MouseEvent | React.MouseEvent<SVGElement, MouseEvent>, barItemIdentifier: BarItemIdentifier): void;
+    onItemClick?(event: ChartsActivationEvent | ChartsActivationEvent<SVGElement>, barItemIdentifier: BarItemIdentifier): void;
   }
 }

package/moduleAugmentation/keyboardActivation.d.mts

@@ -0,0 +1,7 @@
+declare module '@mui/x-charts/models' {
+  interface ChartsTypeFeatureFlags {
+    keyboardActivationOverride: KeyboardEvent;
+  }
+}
+declare const _default: {};
+export default _default;

package/moduleAugmentation/keyboardActivation.d.ts

@@ -0,0 +1,7 @@
+declare module '@mui/x-charts/models' {
+  interface ChartsTypeFeatureFlags {
+    keyboardActivationOverride: KeyboardEvent;
+  }
+}
+declare const _default: {};
+export default _default;

package/moduleAugmentation/keyboardActivation.js

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+// Required to make this file into a module
+var _default = exports.default = {};

package/moduleAugmentation/keyboardActivation.mjs

@@ -0,0 +1,2 @@
+// Required to make this file into a module
+export default {};