@mui/x-charts 8.22.1 → 8.24.0

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

@@ -0,0 +1,16 @@
+import type { VisibilityIdentifier } from "./useChartVisibilityManager.types.js";
+import type { ChartSeriesConfig } from "../../models/index.js";
+import type { ChartSeriesType } from "../../../../models/seriesType/config.js";
+export declare const EMPTY_VISIBILITY_MAP: Map<any, any>;
+/**
+ * Selector to get the hidden identifiers from the visibility manager.
+ */
+export declare const selectorVisibilityMap: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & 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("./useChartVisibilityManager.types.js").UseChartVisibilityManagerState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => Map<any, any>;
+/**
+ * Selector that returns a function which returns whether an item is visible.
+ */
+export declare const selectorIsItemVisibleGetter: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & 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("./useChartVisibilityManager.types.js").UseChartVisibilityManagerState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}) => (seriesConfig: ChartSeriesConfig<ChartSeriesType>, identifier: VisibilityIdentifier) => boolean;

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

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.selectorVisibilityMap = exports.selectorIsItemVisibleGetter = exports.EMPTY_VISIBILITY_MAP = void 0;
+var _store = require("@mui/x-internals/store");
+var _isIdentifierVisible = require("./isIdentifierVisible");
+/**
+ * Selector to get the visibility manager state.
+ */
+const selectVisibilityManager = state => state.visibilityManager;
+const EMPTY_VISIBILITY_MAP = exports.EMPTY_VISIBILITY_MAP = new Map();
+
+/**
+ * Selector to get the hidden identifiers from the visibility manager.
+ */
+const selectorVisibilityMap = exports.selectorVisibilityMap = (0, _store.createSelector)(selectVisibilityManager, visibilityManager => visibilityManager?.visibilityMap ?? EMPTY_VISIBILITY_MAP);
+
+/**
+ * Selector that returns a function which returns whether an item is visible.
+ */
+const selectorIsItemVisibleGetter = exports.selectorIsItemVisibleGetter = (0, _store.createSelectorMemoized)(selectorVisibilityMap, visibilityMap => {
+  return (seriesConfig, identifier) => (0, _isIdentifierVisible.isIdentifierVisible)(visibilityMap, identifier, seriesConfig);
+});

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

@@ -0,0 +1,90 @@
+import { type ChartPluginSignature } from "../../models/index.js";
+import { type UseChartSeriesSignature } from "../../corePlugins/useChartSeries/index.js";
+import { type SeriesItemIdentifier } from "../../../../models/index.js";
+import { type ChartSeriesType } from "../../../../models/seriesType/config.js";
+export type VisibilityIdentifier<T extends ChartSeriesType = ChartSeriesType> = Partial<SeriesItemIdentifier<T>> & (SeriesItemIdentifier<T> extends {
+  subType?: infer U;
+} ? {
+  type: T;
+  subType: U;
+} : {
+  type: T;
+});
+export type VisibilityMap = Map<string, VisibilityIdentifier>;
+export type IsItemVisibleFunction = {
+  /**
+   * Function to check if an item is visible based on its identifier.
+   *
+   * @param {VisibilityIdentifier} identifier The identifier of the item to check.
+   * @returns {boolean} Whether the item is visible.
+   */
+  (identifier: VisibilityIdentifier): boolean;
+};
+export interface UseChartVisibilityManagerInstance<T extends ChartSeriesType> {
+  /**
+   * Hide an item by its identifier.
+   *
+   * @param {VisibilityIdentifier} identifier The identifier of the item to hide.
+   */
+  hideItem(identifier: VisibilityIdentifier<T>): void;
+  /**
+   * Show an item by its identifier.
+   *
+   * @param {VisibilityIdentifier} identifier The identifier of the item to show.
+   */
+  showItem(identifier: VisibilityIdentifier<T>): void;
+  /**
+   * Toggle the visibility of an item by its identifier.
+   *
+   * @param {VisibilityIdentifier} identifier The identifier of the item to toggle.
+   */
+  toggleItemVisibility(identifier: VisibilityIdentifier<T>): void;
+}
+export interface UseChartVisibilityManagerParameters<T extends ChartSeriesType> {
+  /**
+   * Callback fired when any hidden identifiers change.
+   * @param {VisibilityIdentifier[]} hiddenItems The new list of hidden identifiers.
+   */
+  onHiddenItemsChange?: (hiddenItems: VisibilityIdentifier<T>[]) => void;
+  /**
+   * List of hidden series and/or items.
+   *
+   * Different chart types use different keys.
+   *
+   * @example
+   * ```ts
+   * [
+   *   {
+   *     type: 'pie',
+   *     seriesId: 'series-1',
+   *     dataIndex: 3,
+   *   },
+   *   {
+   *     type: 'line',
+   *     seriesId: 'series-2',
+   *   }
+   * ]
+   * ```
+   */
+  hiddenItems?: VisibilityIdentifier<T>[];
+}
+export type UseChartVisibilityManagerDefaultizedParameters<T extends ChartSeriesType> = UseChartVisibilityManagerParameters<T>;
+export interface UseChartVisibilityManagerState {
+  visibilityManager: {
+    /**
+     * Map of hidden identifiers by their serialized form.
+     */
+    visibilityMap: VisibilityMap;
+    /**
+     * Internal information to know if the user controls the state or not.
+     */
+    isControlled: boolean;
+  };
+}
+export type UseChartVisibilityManagerSignature<T extends ChartSeriesType = ChartSeriesType> = ChartPluginSignature<{
+  instance: UseChartVisibilityManagerInstance<T>;
+  state: UseChartVisibilityManagerState;
+  params: UseChartVisibilityManagerParameters<T>;
+  defaultizedParams: UseChartVisibilityManagerDefaultizedParameters<T>;
+  dependencies: [UseChartSeriesSignature];
+}>;

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

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

package/internals/plugins/featurePlugins/useChartVisibilityManager/visibilityParamToMap.d.ts

@@ -0,0 +1,4 @@
+import type { ChartSeriesType } from "../../../../models/seriesType/config.js";
+import type { ChartSeriesConfig } from "../../models/index.js";
+import type { VisibilityIdentifier, VisibilityMap } from "./useChartVisibilityManager.types.js";
+export declare const visibilityParamToMap: (hiddenItems: VisibilityIdentifier[] | undefined, seriesConfig: ChartSeriesConfig<ChartSeriesType>) => VisibilityMap;

package/internals/plugins/featurePlugins/useChartVisibilityManager/visibilityParamToMap.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.visibilityParamToMap = void 0;
+var _serializeIdentifier = require("../../corePlugins/useChartSeries/serializeIdentifier");
+const visibilityParamToMap = (hiddenItems, seriesConfig) => {
+  const visibilityMap = new Map();
+  if (hiddenItems) {
+    hiddenItems.forEach(identifier => {
+      const uniqueId = (0, _serializeIdentifier.serializeIdentifier)(seriesConfig, identifier);
+      visibilityMap.set(uniqueId, identifier);
+    });
+  }
+  return visibilityMap;
+};
+exports.visibilityParamToMap = visibilityParamToMap;

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

@@ -0,0 +1,2 @@
+import type { ChartSeriesType, ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
+export type IdentifierSerializer<TSeriesType extends ChartSeriesType> = (identifier: ChartsSeriesConfig[TSeriesType]['itemIdentifier']) => string;

package/internals/plugins/models/seriesConfig/identifierSerializer.types.js

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

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

@@ -7,4 +7,5 @@ export * from "./seriesLayout.types.js";
 export * from "./tooltipGetter.types.js";
 export * from "./tooltipItemPositionGetter.types.js";
 export * from "./legendGetter.types.js";
-export * from "./getSeriesWithDefaultValues.types.js";
+export * from "./getSeriesWithDefaultValues.types.js";
+export * from "./identifierSerializer.types.js";

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

@@ -112,4 +112,15 @@ Object.keys(_getSeriesWithDefaultValues).forEach(function (key) {
       return _getSeriesWithDefaultValues[key];
     }
   });
+});
+var _identifierSerializer = require("./identifierSerializer.types");
+Object.keys(_identifierSerializer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _identifierSerializer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _identifierSerializer[key];
+    }
+  });
 });

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

@@ -8,6 +8,8 @@ import { type PolarExtremumGetter } from "./polarExtremumGetter.types.js";
 import { type GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
 import { type TooltipItemPositionGetter } from "./tooltipItemPositionGetter.types.js";
 import { type SeriesLayoutGetter } from "./seriesLayout.types.js";
+import { type KeyboardFocusHandler } from "../../featurePlugins/useChartKeyboardNavigation/keyboardFocusHandler.types.js";
+import { type IdentifierSerializer } from "./identifierSerializer.types.js";
 export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   seriesProcessor: SeriesProcessor<TSeriesType>;
   /**
@@ -19,6 +21,13 @@ export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   tooltipGetter: TooltipGetter<TSeriesType>;
   tooltipItemPositionGetter?: TooltipItemPositionGetter<TSeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<TSeriesType>;
+  keyboardFocusHandler?: KeyboardFocusHandler<TSeriesType>;
+  /**
+   * A function to serialize the series item identifier into a unique string.
+   * @param {ChartsSeriesConfig[TSeriesType]['itemIdentifier']} identifier The series item identifier.
+   * @returns {string} A unique string representation of the identifier.
+   */
+  identifierSerializer: IdentifierSerializer<TSeriesType>;
 } & (TSeriesType extends CartesianChartSeriesType ? {
   xExtremumGetter: CartesianExtremumGetter<TSeriesType>;
   yExtremumGetter: CartesianExtremumGetter<TSeriesType>;

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

@@ -1,6 +1,6 @@
 import type { ChartSeriesDefaultized, ChartSeriesType, ChartsSeriesConfig, DatasetType } from "../../../../models/seriesType/config.js";
 import type { SeriesId } from "../../../../models/seriesType/common.js";
-import type { StackingGroupsType } from "../../../stackSeries.js";
+import type { StackingGroupsType } from "../../../stacking/index.js";
 export type SeriesProcessorParams<TSeriesType extends ChartSeriesType> = {
   series: Record<SeriesId, ChartsSeriesConfig[TSeriesType]['seriesInput']>;
   seriesOrder: SeriesId[];

package/internals/seriesHasData.d.ts

@@ -0,0 +1,4 @@
+import type { SeriesId } from "../models/seriesType/common.js";
+import type { ChartSeriesType, ChartsSeriesConfig } from "../models/seriesType/config.js";
+import type { ProcessedSeries } from "./plugins/corePlugins/useChartSeries/index.js";
+export declare function seriesHasData(series: ProcessedSeries<keyof ChartsSeriesConfig>, type: ChartSeriesType, seriesId: SeriesId): boolean;

package/internals/seriesHasData.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.seriesHasData = seriesHasData;
+function seriesHasData(series, type, seriesId) {
+  // @ts-ignore sankey is not in MIT version
+  if (type === 'sankey') {
+    return false;
+  }
+  const data = series[type]?.series[seriesId]?.data;
+  return data != null && data.length > 0;
+}

package/internals/stacking/index.d.ts

@@ -0,0 +1 @@
+export * from "./stackSeries.js";

package/internals/stacking/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _stackSeries = require("./stackSeries");
+Object.keys(_stackSeries).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _stackSeries[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _stackSeries[key];
+    }
+  });
+});

package/internals/stacking/offset/index.d.ts

@@ -0,0 +1 @@
+export * from "./offsetDiverging.js";

package/internals/stacking/offset/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _offsetDiverging = require("./offsetDiverging");
+Object.keys(_offsetDiverging).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _offsetDiverging[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _offsetDiverging[key];
+    }
+  });
+});

package/internals/stacking/offset/offsetDiverging.d.ts

@@ -0,0 +1,8 @@
+import type { Series } from '@mui/x-charts-vendor/d3-shape';
+/**
+ * Positive values are stacked above zero, while negative values are stacked below zero.
+ *
+ * @param series A series generated by a stack generator.
+ * @param order An array of numeric indexes representing the stack order.
+ */
+export declare function offsetDiverging(series: Series<any, any>[], order: Iterable<number>): void;

package/internals/stacking/offset/offsetDiverging.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.offsetDiverging = offsetDiverging;
+// Adapted from D3.js's offsetDiverging function https://github.com/d3/d3-shape/blob/main/src/offset/diverging.js
+// Hidden series (with all zero values) affect the stacking in a different way in our implementation compared to the D3 behavior.
+// The D3 stacking keep those values at the 0 "line", which creates issues when animating between hidden and visible states.
+// In our modification, we stack them on top/below already stacked items according to the sign of their original value.
+// A hidden negative value will be placed below all the already stacked negative values
+
+/**
+ * Positive values are stacked above zero, while negative values are stacked below zero.
+ *
+ * @param series A series generated by a stack generator.
+ * @param order An array of numeric indexes representing the stack order.
+ */
+function offsetDiverging(series, order) {
+  if (series.length === 0) {
+    return;
+  }
+  const seriesCount = series.length;
+  const numericOrder = order;
+  const pointCount = series[numericOrder[0]].length;
+  for (let pointIndex = 0; pointIndex < pointCount; pointIndex += 1) {
+    let positiveSum = 0;
+    let negativeSum = 0;
+    for (let seriesIndex = 0; seriesIndex < seriesCount; seriesIndex += 1) {
+      const currentSeries = series[numericOrder[seriesIndex]];
+      const dataPoint = currentSeries[pointIndex];
+      const difference = dataPoint[1] - dataPoint[0];
+      if (difference > 0) {
+        dataPoint[0] = positiveSum;
+        positiveSum += difference;
+        dataPoint[1] = positiveSum;
+      } else if (difference < 0) {
+        dataPoint[1] = negativeSum;
+        negativeSum += difference;
+        dataPoint[0] = negativeSum;
+      } else if (dataPoint.data[currentSeries.key] > 0) {
+        dataPoint[0] = positiveSum;
+        dataPoint[1] = positiveSum;
+      } else if (dataPoint.data[currentSeries.key] < 0) {
+        dataPoint[1] = negativeSum;
+        dataPoint[0] = negativeSum;
+      } else {
+        dataPoint[0] = 0;
+        dataPoint[1] = 0;
+      }
+    }
+  }
+}

package/internals/{stackSeries.d.ts → stacking/stackSeries.d.ts}

@@ -1,6 +1,6 @@
-import { stackOrderAppearance as d3StackOrderAppearance, stackOrderAscending as d3StackOrderAscending, stackOrderDescending as d3StackOrderDescending, stackOrderInsideOut as d3StackOrderInsideOut, stackOrderNone as d3StackOrderNone, stackOrderReverse as d3StackOrderReverse, stackOffsetExpand as d3StackOffsetExpand, stackOffsetDiverging as d3StackOffsetDiverging, stackOffsetNone as d3StackOffsetNone, stackOffsetSilhouette as d3StackOffsetSilhouette, stackOffsetWiggle as d3StackOffsetWiggle, type Series } from '@mui/x-charts-vendor/d3-shape';
-import type { StackOffsetType, StackOrderType } from "../models/stacking.js";
-import { type SeriesId, type StackableSeriesType } from "../models/seriesType/common.js";
+import { stackOrderNone as d3StackOrderNone, stackOrderReverse as d3StackOrderReverse, stackOrderAppearance as d3OrderAppearance, stackOrderAscending as d3OrderAscending, stackOrderDescending as d3OrderDescending, stackOrderInsideOut as d3OrderInsideOut, stackOffsetExpand as d3StackOffsetExpand, stackOffsetNone as d3StackOffsetNone, stackOffsetSilhouette as d3StackOffsetSilhouette, stackOffsetWiggle as d3StackOffsetWiggle, type Series } from '@mui/x-charts-vendor/d3-shape';
+import type { StackOffsetType, StackOrderType } from "../../models/stacking.js";
+import { type SeriesId, type StackableSeriesType } from "../../models/seriesType/common.js";
 type FormatterParams<T> = {
   series: Record<SeriesId, T>;
   seriesOrder: SeriesId[];
@@ -18,19 +18,19 @@ export declare const StackOrder: {
   /**
    * Series order such that the earliest series (according to the maximum value) is at the bottom.
    * */
-  appearance: typeof d3StackOrderAppearance;
+  appearance: typeof d3OrderAppearance;
   /**
    *  Series order such that the smallest series (according to the sum of values) is at the bottom.
    * */
-  ascending: typeof d3StackOrderAscending;
+  ascending: typeof d3OrderAscending;
   /**
    * Series order such that the largest series (according to the sum of values) is at the bottom.
    */
-  descending: typeof d3StackOrderDescending;
+  descending: typeof d3OrderDescending;
   /**
    * Series order such that the earliest series (according to the maximum value) are on the inside and the later series are on the outside. This order is recommended for streamgraphs in conjunction with the wiggle offset. See Stacked Graphs—Geometry & Aesthetics by Byron & Wattenberg for more information.
    */
-  insideOut: typeof d3StackOrderInsideOut;
+  insideOut: typeof d3OrderInsideOut;
   /**
    * Given series order [0, 1, … n - 1] where n is the number of elements in series. Thus, the stack order is given by the key accessor.
    */
@@ -48,7 +48,7 @@ export declare const StackOffset: {
   /**
    * Positive values are stacked above zero, negative values are stacked below zero, and zero values are stacked at zero.
    * */
-  diverging: typeof d3StackOffsetDiverging;
+  diverging: (series: Series<any, any>, order: Iterable<number>) => void;
   /**
    * Applies a zero baseline.
    * */

package/internals/{stackSeries.js → stacking/stackSeries.js}

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.getStackingGroups = exports.StackOrder = exports.StackOffset = void 0;
 var _d3Shape = require("@mui/x-charts-vendor/d3-shape");
+var _offset = require("./offset");
 const StackOrder = exports.StackOrder = {
   /**
    * Series order such that the earliest series (according to the maximum value) is at the bottom.
@@ -39,7 +40,8 @@ const StackOffset = exports.StackOffset = {
   /**
    * Positive values are stacked above zero, negative values are stacked below zero, and zero values are stacked at zero.
    * */
-  diverging: _d3Shape.stackOffsetDiverging,
+  // @ts-expect-error, d3 types are wrong, our custom function implements the correct signature
+  diverging: _offset.offsetDiverging,
   /**
    * Applies a zero baseline.
    * */

package/models/axis.d.ts

@@ -1,12 +1,13 @@
 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 MakeOptional, type MakeRequired } from '@mui/x-internals/types';
+import { type HasProperty, type MakeOptional, type MakeRequired } from '@mui/x-internals/types';
 import type { DefaultizedZoomOptions } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
 import { type ChartsAxisClasses } from "../ChartsAxis/axisClasses.js";
 import type { TickParams } from "../hooks/useTicks.js";
 import type { ChartsTextProps } from "../ChartsText/index.js";
 import type { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
 import type { OrdinalTimeTicks } from "./timeTicks.js";
+import { type ChartsTypeFeatureFlags } from "./featureFlags.js";
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
   toString(): string;
@@ -133,7 +134,7 @@ type AxisSideConfig<AxisProps extends ChartsAxisProps> = AxisProps extends Chart
   position?: 'top' | 'bottom' | 'none';
   /**
    * The height of the axis.
-   * @default 30
+   * @default 45 if an axis label is provided, 25 otherwise.
    */
   height?: number;
 } : AxisProps extends ChartsYAxisProps ? {
@@ -149,7 +150,7 @@ type AxisSideConfig<AxisProps extends ChartsAxisProps> = AxisProps extends Chart
   position?: 'left' | 'right' | 'none';
   /**
    * The width of the axis.
-   * @default 30
+   * @default 65 if an axis label is provided, 45 otherwise.
    */
   width?: number;
 } : {
@@ -521,7 +522,7 @@ export interface ChartsAxisData {
   /**
    * The mapping of series ids to their value for this particular axis index.
    */
-  seriesValues: Record<string, number | null | undefined>;
+  seriesValues: Record<string, HasProperty<ChartsTypeFeatureFlags, 'seriesValueOverride'> extends true ? ChartsTypeFeatureFlags['seriesValuesOverride'] : number | null | undefined>;
 }
 export type CartesianDirection = 'x' | 'y';
 export type PolarDirection = 'rotation' | 'radius';

package/models/featureFlags.d.ts

@@ -0,0 +1 @@
+export interface ChartsTypeFeatureFlags {}

package/models/featureFlags.js

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

package/models/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./seriesType/index.js";
 export * from "./stacking.js";
 export * from "./slots/index.js";
+export * from "./featureFlags.js";
 export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, ChartsAxisData, XAxis, YAxis, RadiusAxis, RotationAxis, AxisItemIdentifier, AxisValueFormatterContext } from "./axis.js";
 export type { PropsFromSlot } from '@mui/x-internals/slots';
 export type { Position } from "./position.js";

package/models/index.js

@@ -35,4 +35,15 @@ Object.keys(_slots).forEach(function (key) {
       return _slots[key];
     }
   });
+});
+var _featureFlags = require("./featureFlags");
+Object.keys(_featureFlags).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _featureFlags[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _featureFlags[key];
+    }
+  });
 });

package/models/seriesType/index.d.ts

@@ -1,4 +1,5 @@
-import { type BarSeriesType, type DefaultizedBarSeriesType } from "./bar.js";
+import type { DefaultizedProps } from '@mui/x-internals/types';
+import type { BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
 import { type CartesianChartSeriesType, type ChartSeriesType, type ChartsSeriesConfig, type StackableChartSeriesType } from "./config.js";
 type AllSeriesType<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['seriesProp'];
 /**
@@ -19,6 +20,7 @@ type DefaultizedCartesianSeriesType = DefaultizedSeriesType<CartesianChartSeries
 type StackableSeriesType = DefaultizedSeriesType<StackableChartSeriesType>;
 export type SeriesItemIdentifier<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifier'];
 export type SeriesItemIdentifierWithData<T extends ChartSeriesType = ChartSeriesType> = ChartsSeriesConfig[T]['itemIdentifierWithData'];
+export type FocusedItemIdentifier<T extends ChartSeriesType = ChartSeriesType> = T extends 'line' ? DefaultizedProps<ChartsSeriesConfig[T]['itemIdentifier'], 'dataIndex'> : ChartsSeriesConfig[T]['itemIdentifier'];
 export { type SeriesId } from "./common.js";
 export * from "./line.js";
 export * from "./bar.js";

package/moduleAugmentation/barChartBatchRendererOnItemClick.d.ts

@@ -0,0 +1,13 @@
+import type * as React from 'react';
+import type { BarItemIdentifier } 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.
+     *        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;
+  }
+}

package/moduleAugmentation/barChartBatchRendererOnItemClick.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "8.22.1",
+  "version": "8.24.0",
   "author": "MUI Team",
   "description": "The community edition of MUI X Charts components.",
   "license": "MIT",
@@ -34,9 +34,9 @@
     "prop-types": "^15.8.1",
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.6.0",
-    "@mui/x-charts-vendor": "8.22.0",
-    "@mui/x-internals": "8.22.0",
-    "@mui/x-internal-gestures": "0.3.6"
+    "@mui/x-charts-vendor": "8.23.0",
+    "@mui/x-internal-gestures": "0.4.0",
+    "@mui/x-internals": "8.24.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",
@@ -82,6 +82,16 @@
         "default": "./esm/*/index.js"
       }
     },
+    "./moduleAugmentation/*": {
+      "require": {
+        "types": "./moduleAugmentation/*.d.ts",
+        "default": "./moduleAugmentation/*.js"
+      },
+      "default": {
+        "types": "./esm/moduleAugmentation/*.d.ts",
+        "default": "./esm/moduleAugmentation/*.js"
+      }
+    },
     "./esm": null
   }
 }

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/isFocusableSeriesType.d.ts

@@ -1,3 +0,0 @@
-import { type ChartSeriesType } from "../../../../models/seriesType/config.js";
-import { type FocusableSeriesTypes } from "./useChartKeyboardNavigation.types.js";
-export declare function isFocusableSeriesType(type: ChartSeriesType): type is FocusableSeriesTypes;

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/isFocusableSeriesType.js

@@ -1,4 +0,0 @@
-const FOCUSABLE_SERIES_TYPES = new Set(['bar', 'line', 'scatter', 'pie']);
-export function isFocusableSeriesType(type) {
-  return FOCUSABLE_SERIES_TYPES.has(type);
-}

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.helpers.d.ts

@@ -1,21 +0,0 @@
-import { type ChartSeriesType, type ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
-import { type SeriesId } from "../../../../models/seriesType/common.js";
-import { type ProcessedSeries } from "../../corePlugins/useChartSeries/index.js";
-import { type FocusableSeriesTypes } from "./useChartKeyboardNavigation.types.js";
-/**
- * Returns the next series type and id that contains some data.
- * Returns `null` if no other series have data.
- */
-export declare function getNextSeriesWithData(series: ProcessedSeries<keyof ChartsSeriesConfig>, type?: FocusableSeriesTypes, seriesId?: SeriesId): {
-  type: FocusableSeriesTypes;
-  seriesId: SeriesId;
-} | null;
-/**
- * Returns the previous series type and id that contains some data.
- * Returns `null` if no other series have data.
- */
-export declare function getPreviousSeriesWithData(series: ProcessedSeries<keyof ChartsSeriesConfig>, type?: FocusableSeriesTypes, seriesId?: SeriesId): {
-  type: FocusableSeriesTypes;
-  seriesId: SeriesId;
-} | null;
-export declare function seriesHasData(series: ProcessedSeries<keyof ChartsSeriesConfig>, type: ChartSeriesType, seriesId: SeriesId): boolean | undefined;