@mui/x-charts 8.23.0 → 8.24.0

package/esm/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/esm/internals/plugins/featurePlugins/useChartVisibilityManager/useChartVisibilityManager.types.js

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

package/esm/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/esm/internals/plugins/featurePlugins/useChartVisibilityManager/visibilityParamToMap.js

@@ -0,0 +1,11 @@
+import { serializeIdentifier } from "../../corePlugins/useChartSeries/serializeIdentifier.js";
+export const visibilityParamToMap = (hiddenItems, seriesConfig) => {
+  const visibilityMap = new Map();
+  if (hiddenItems) {
+    hiddenItems.forEach(identifier => {
+      const uniqueId = serializeIdentifier(seriesConfig, identifier);
+      visibilityMap.set(uniqueId, identifier);
+    });
+  }
+  return visibilityMap;
+};

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

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

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

@@ -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/esm/internals/plugins/models/seriesConfig/seriesConfig.types.d.ts

@@ -9,6 +9,7 @@ import { type GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.ty
 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>;
   /**
@@ -21,6 +22,12 @@ export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   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/esm/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/esm/models/featureFlags.d.ts

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

package/esm/models/featureFlags.js

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

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

@@ -1,6 +1,7 @@
 export * from "./seriesType/index.js";
 export * from "./stacking.js";
 export * from "./slots/index.js";
+export * from "./featureFlags.js";
 
 // Utils shared across the X packages
 export {};

package/esm/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/esm/moduleAugmentation/barChartBatchRendererOnItemClick.js

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

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v8.23.0
+ * @mui/x-charts v8.24.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/appendAtKey.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Given a map of arrays, appends a value to the array at the given key.
+ * If no array exists at that key, one is created and the value appended.
+ * @param map Map of arrays
+ * @param key Key to append the value at
+ * @param value Value to append
+ */
+export declare function appendAtKey<K, V>(map: Map<K, V[]>, key: K, value: V): V[];

package/internals/appendAtKey.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.appendAtKey = appendAtKey;
+/**
+ * Given a map of arrays, appends a value to the array at the given key.
+ * If no array exists at that key, one is created and the value appended.
+ * @param map Map of arrays
+ * @param key Key to append the value at
+ * @param value Value to append
+ */
+function appendAtKey(map, key, value) {
+  let bucket = map.get(key);
+  if (!bucket) {
+    bucket = [value];
+    map.set(key, bucket);
+  } else {
+    bucket.push(value);
+  }
+  return bucket;
+}

package/internals/commonNextFocusItem.js

@@ -8,6 +8,7 @@ exports.createGetNextSeriesFocusedItem = createGetNextSeriesFocusedItem;
 exports.createGetPreviousIndexFocusedItem = createGetPreviousIndexFocusedItem;
 exports.createGetPreviousSeriesFocusedItem = createGetPreviousSeriesFocusedItem;
 var _getPreviousNonEmptySeries = require("./plugins/featurePlugins/useChartKeyboardNavigation/utils/getPreviousNonEmptySeries");
+var _getMaxSeriesLength = require("./plugins/featurePlugins/useChartKeyboardNavigation/utils/getMaxSeriesLength");
 var _useChartSeries = require("./plugins/corePlugins/useChartSeries");
 var _getNextNonEmptySeries = require("./plugins/featurePlugins/useChartKeyboardNavigation/utils/getNextNonEmptySeries");
 var _seriesHasData = require("./seriesHasData");
@@ -24,11 +25,12 @@ function createGetNextIndexFocusedItem(compatibleSeriesTypes) {
       type = nextSeries.type;
       seriesId = nextSeries.seriesId;
     }
-    const dataLength = processedSeries[type].series[seriesId].data.length;
+    const maxLength = (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
+    const dataIndex = Math.min(maxLength - 1, currentItem?.dataIndex == null ? 0 : currentItem.dataIndex + 1);
     return {
       type,
       seriesId,
-      dataIndex: ((currentItem?.dataIndex ?? -1) + 1) % dataLength
+      dataIndex
     };
   };
 }
@@ -45,11 +47,12 @@ function createGetPreviousIndexFocusedItem(compatibleSeriesTypes) {
       type = previousSeries.type;
       seriesId = previousSeries.seriesId;
     }
-    const dataLength = processedSeries[type].series[seriesId].data.length;
+    const maxLength = (0, _getMaxSeriesLength.getMaxSeriesLength)(processedSeries, compatibleSeriesTypes);
+    const dataIndex = Math.max(0, currentItem?.dataIndex == null ? maxLength - 1 : currentItem.dataIndex - 1);
     return {
       type,
       seriesId,
-      dataIndex: (dataLength + (currentItem?.dataIndex ?? 1) - 1) % dataLength
+      dataIndex
     };
   };
 }
@@ -64,11 +67,11 @@ function createGetNextSeriesFocusedItem(compatibleSeriesTypes) {
     }
     type = nextSeries.type;
     seriesId = nextSeries.seriesId;
-    const dataLength = processedSeries[type].series[seriesId].data.length;
+    const dataIndex = currentItem?.dataIndex == null ? 0 : currentItem.dataIndex;
     return {
       type,
       seriesId,
-      dataIndex: Math.min(dataLength - 1, currentItem?.dataIndex ?? 0)
+      dataIndex
     };
   };
 }
@@ -83,11 +86,12 @@ function createGetPreviousSeriesFocusedItem(compatibleSeriesTypes) {
     }
     type = previousSeries.type;
     seriesId = previousSeries.seriesId;
-    const dataLength = processedSeries[type].series[seriesId].data.length;
+    const data = processedSeries[type].series[seriesId].data;
+    const dataIndex = currentItem?.dataIndex == null ? data.length - 1 : currentItem.dataIndex;
     return {
       type,
       seriesId,
-      dataIndex: Math.min(dataLength - 1, currentItem?.dataIndex ?? 0)
+      dataIndex
     };
   };
 }

package/internals/getBarDimensions.d.ts

@@ -1,5 +1,4 @@
-import type { ScaleName, ChartsXAxisProps, ChartsYAxisProps } from "../models/index.js";
-import type { ComputedAxis } from "../models/axis.js";
+import type { ChartsXAxisProps, ChartsYAxisProps, ComputedAxis, ScaleName } from "../models/axis.js";
 import type { ChartSeriesDefaultized } from "../models/seriesType/config.js";
 export declare function getBarDimensions(params: {
   verticalLayout: boolean;

package/internals/identifierSerializer.d.ts

@@ -0,0 +1,9 @@
+import type { SeriesId } from "../models/index.js";
+export declare const typeSerializer: (type: string) => string;
+export declare const seriesIdSerializer: (id: SeriesId) => string;
+export declare const dataIndexSerializer: (dataIndex?: number) => string;
+export declare const identifierSerializerSeriesIdDataIndex: (identifier: {
+  type: string;
+  seriesId: SeriesId;
+  dataIndex?: number;
+}) => string;

package/internals/identifierSerializer.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.typeSerializer = exports.seriesIdSerializer = exports.identifierSerializerSeriesIdDataIndex = exports.dataIndexSerializer = void 0;
+const typeSerializer = type => `Type(${type})`;
+exports.typeSerializer = typeSerializer;
+const seriesIdSerializer = id => `Series(${id})`;
+exports.seriesIdSerializer = seriesIdSerializer;
+const dataIndexSerializer = dataIndex => dataIndex === undefined ? '' : `Index(${dataIndex})`;
+exports.dataIndexSerializer = dataIndexSerializer;
+const identifierSerializerSeriesIdDataIndex = identifier => {
+  return `${typeSerializer(identifier.type)}${seriesIdSerializer(identifier.seriesId)}${dataIndexSerializer(identifier.dataIndex)}`;
+};
+exports.identifierSerializerSeriesIdDataIndex = identifierSerializerSeriesIdDataIndex;

package/internals/index.d.ts

@@ -12,13 +12,14 @@ export { scatterSeriesConfig } from "../ScatterChart/seriesConfig/index.js";
 export { useLineChartProps } from "../LineChart/useLineChartProps.js";
 export { useAreaPlotData } from "../LineChart/useAreaPlotData.js";
 export { useLinePlotData } from "../LineChart/useLinePlotData.js";
-export { useBarChartProps } from "../BarChart/useBarChartProps.js";
+export * from "../BarChart/useBarChartProps.js";
 export { useBarPlotData } from "../BarChart/useBarPlotData.js";
 export { useRadarChartProps } from "../RadarChart/useRadarChartProps.js";
 export * from "../ChartContainer/useChartContainerProps.js";
 export * from "../ChartDataProvider/useChartDataProviderProps.js";
 export * from "./seriesSelectorOfType.js";
 export { useSkipAnimation } from "../hooks/useSkipAnimation.js";
+export { useRegisterPointerInteractions } from "./plugins/featurePlugins/shared/useRegisterPointerInteractions.js";
 export * from "./plugins/corePlugins/useChartId/index.js";
 export * from "./plugins/corePlugins/useChartSeries/index.js";
 export * from "./plugins/corePlugins/useChartDimensions/index.js";
@@ -29,6 +30,7 @@ export * from "./plugins/featurePlugins/useChartPolarAxis/index.js";
 export * from "./plugins/featurePlugins/useChartTooltip/index.js";
 export * from "./plugins/featurePlugins/useChartInteraction/index.js";
 export * from "./plugins/featurePlugins/useChartHighlight/index.js";
+export * from "./plugins/featurePlugins/useChartVisibilityManager/index.js";
 export * from "./plugins/featurePlugins/useChartKeyboardNavigation/index.js";
 export * from "./plugins/featurePlugins/useChartClosestPoint/index.js";
 export * from "./plugins/featurePlugins/useChartBrush/index.js";
@@ -58,6 +60,7 @@ export * from "./dateHelpers.js";
 export * from "./invertScale.js";
 export * from "./scaleGuards.js";
 export * from "./findMinMax.js";
+export { getSeriesColorFn } from "./getSeriesColorFn.js";
 export { checkBarChartScaleErrors } from "../BarChart/checkBarChartScaleErrors.js";
 export { getBandSize } from "./getBandSize.js";
 export { getAxisExtrema } from "./plugins/featurePlugins/useChartCartesianAxis/getAxisExtrema.js";
@@ -71,4 +74,5 @@ export * from "./plugins/models/index.js";
 export * from "./material/index.js";
 export * from "./createSvgIcon.js";
 export * from "./constants.js";
-export * from "./scales/index.js";
+export * from "./scales/index.js";
+export * from "./identifierSerializer.js";

package/internals/index.js

@@ -13,12 +13,13 @@ var _exportNames = {
   useLineChartProps: true,
   useAreaPlotData: true,
   useLinePlotData: true,
-  useBarChartProps: true,
   useBarPlotData: true,
   useRadarChartProps: true,
   useSkipAnimation: true,
+  useRegisterPointerInteractions: true,
   getCartesianAxisTriggerTooltip: true,
   getCartesianAxisIndex: true,
+  getSeriesColorFn: true,
   checkBarChartScaleErrors: true,
   getBandSize: true,
   getAxisExtrema: true
@@ -53,22 +54,22 @@ Object.defineProperty(exports, "getCartesianAxisTriggerTooltip", {
     return _getAxisTriggerTooltip.getAxisTriggerTooltip;
   }
 });
-Object.defineProperty(exports, "scatterSeriesConfig", {
+Object.defineProperty(exports, "getSeriesColorFn", {
   enumerable: true,
   get: function () {
-    return _seriesConfig.scatterSeriesConfig;
+    return _getSeriesColorFn.getSeriesColorFn;
   }
 });
-Object.defineProperty(exports, "useAreaPlotData", {
+Object.defineProperty(exports, "scatterSeriesConfig", {
   enumerable: true,
   get: function () {
-    return _useAreaPlotData.useAreaPlotData;
+    return _seriesConfig.scatterSeriesConfig;
   }
 });
-Object.defineProperty(exports, "useBarChartProps", {
+Object.defineProperty(exports, "useAreaPlotData", {
   enumerable: true,
   get: function () {
-    return _useBarChartProps.useBarChartProps;
+    return _useAreaPlotData.useAreaPlotData;
   }
 });
 Object.defineProperty(exports, "useBarPlotData", {
@@ -107,6 +108,12 @@ Object.defineProperty(exports, "useRadarChartProps", {
     return _useRadarChartProps.useRadarChartProps;
   }
 });
+Object.defineProperty(exports, "useRegisterPointerInteractions", {
+  enumerable: true,
+  get: function () {
+    return _useRegisterPointerInteractions.useRegisterPointerInteractions;
+  }
+});
 Object.defineProperty(exports, "useScatterChartProps", {
   enumerable: true,
   get: function () {
@@ -201,6 +208,17 @@ var _useLineChartProps = require("../LineChart/useLineChartProps");
 var _useAreaPlotData = require("../LineChart/useAreaPlotData");
 var _useLinePlotData = require("../LineChart/useLinePlotData");
 var _useBarChartProps = require("../BarChart/useBarChartProps");
+Object.keys(_useBarChartProps).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useBarChartProps[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useBarChartProps[key];
+    }
+  });
+});
 var _useBarPlotData = require("../BarChart/useBarPlotData");
 var _useRadarChartProps = require("../RadarChart/useRadarChartProps");
 var _useChartContainerProps = require("../ChartContainer/useChartContainerProps");
@@ -240,6 +258,7 @@ Object.keys(_seriesSelectorOfType).forEach(function (key) {
   });
 });
 var _useSkipAnimation = require("../hooks/useSkipAnimation");
+var _useRegisterPointerInteractions = require("./plugins/featurePlugins/shared/useRegisterPointerInteractions");
 var _useChartId = require("./plugins/corePlugins/useChartId");
 Object.keys(_useChartId).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -360,6 +379,18 @@ Object.keys(_useChartHighlight).forEach(function (key) {
     }
   });
 });
+var _useChartVisibilityManager = require("./plugins/featurePlugins/useChartVisibilityManager");
+Object.keys(_useChartVisibilityManager).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useChartVisibilityManager[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useChartVisibilityManager[key];
+    }
+  });
+});
 var _useChartKeyboardNavigation = require("./plugins/featurePlugins/useChartKeyboardNavigation");
 Object.keys(_useChartKeyboardNavigation).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -686,6 +717,7 @@ Object.keys(_findMinMax).forEach(function (key) {
     }
   });
 });
+var _getSeriesColorFn = require("./getSeriesColorFn");
 var _checkBarChartScaleErrors = require("../BarChart/checkBarChartScaleErrors");
 var _getBandSize = require("./getBandSize");
 var _getAxisExtrema = require("./plugins/featurePlugins/useChartCartesianAxis/getAxisExtrema");
@@ -820,4 +852,16 @@ Object.keys(_scales).forEach(function (key) {
       return _scales[key];
     }
   });
+});
+var _identifierSerializer = require("./identifierSerializer");
+Object.keys(_identifierSerializer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _identifierSerializer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _identifierSerializer[key];
+    }
+  });
 });

package/internals/invertScale.d.ts

@@ -1,2 +1,6 @@
-import { type D3Scale } from "../models/axis.js";
-export declare function invertScale<T>(scale: D3Scale, data: readonly T[], value: number): number | Date | T;
+import { type D3OrdinalScale, type D3Scale } from "../models/axis.js";
+export declare function invertScale<T>(scale: D3Scale, data: readonly T[], value: number): number | Date | T;
+/**
+ * Get the data index for a given value on an ordinal scale.
+ */
+export declare function getDataIndexForOrdinalScaleValue(scale: D3OrdinalScale, value: number): number;

package/internals/invertScale.js

@@ -3,12 +3,21 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.getDataIndexForOrdinalScaleValue = getDataIndexForOrdinalScaleValue;
 exports.invertScale = invertScale;
 var _scaleGuards = require("./scaleGuards");
 function invertScale(scale, data, value) {
   if ((0, _scaleGuards.isOrdinalScale)(scale)) {
-    const dataIndex = scale.bandwidth() === 0 ? Math.floor((value - Math.min(...scale.range()) + scale.step() / 2) / scale.step()) : Math.floor((value - Math.min(...scale.range())) / scale.step());
+    const dataIndex = getDataIndexForOrdinalScaleValue(scale, value);
     return data[dataIndex];
   }
   return scale.invert(value);
+}
+
+/**
+ * Get the data index for a given value on an ordinal scale.
+ */
+function getDataIndexForOrdinalScaleValue(scale, value) {
+  const dataIndex = scale.bandwidth() === 0 ? Math.floor((value - Math.min(...scale.range()) + scale.step() / 2) / scale.step()) : Math.floor((value - Math.min(...scale.range())) / scale.step());
+  return dataIndex;
 }

package/internals/plugins/allPlugins.d.ts

@@ -7,7 +7,8 @@ import { type UseChartPolarAxisSignature } from "./featurePlugins/useChartPolarA
 import { type UseChartClosestPointSignature } from "./featurePlugins/useChartClosestPoint/index.js";
 import { type UseChartZAxisSignature } from "./featurePlugins/useChartZAxis/index.js";
 import { type UseChartBrushSignature } from "./featurePlugins/useChartBrush/index.js";
+import { type UseChartVisibilityManagerSignature } from "./featurePlugins/useChartVisibilityManager/index.js";
 import { type UseChartTooltipSignature } from "./featurePlugins/useChartTooltip/index.js";
-export type AllPluginSignatures<TSeries extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<TSeries>, UseChartPolarAxisSignature, UseChartTooltipSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export type DefaultPluginSignatures<TSeries extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature, UseChartInteractionSignature, UseChartCartesianAxisSignature<TSeries>, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
-export declare const DEFAULT_PLUGINS: readonly [import("./models/index.js").ChartPlugin<UseChartZAxisSignature>, import("./models/index.js").ChartPlugin<UseChartBrushSignature>, import("./models/index.js").ChartPlugin<UseChartTooltipSignature>, import("./models/index.js").ChartPlugin<UseChartInteractionSignature>, import("./models/index.js").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.js").ChartPlugin<UseChartHighlightSignature>, import("./models/index.js").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.js").ChartPlugin<UseChartKeyboardNavigationSignature>];
+export type AllPluginSignatures<TSeries extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<TSeries>, UseChartPolarAxisSignature, UseChartTooltipSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartVisibilityManagerSignature<TSeries>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
+export type DefaultPluginSignatures<TSeries extends ChartSeriesType = ChartSeriesType> = [UseChartZAxisSignature, UseChartBrushSignature, UseChartTooltipSignature, UseChartInteractionSignature, UseChartCartesianAxisSignature<TSeries>, UseChartHighlightSignature, UseChartVisibilityManagerSignature<TSeries>, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature];
+export declare const DEFAULT_PLUGINS: readonly [import("./models/index.js").ChartPlugin<UseChartZAxisSignature>, import("./models/index.js").ChartPlugin<UseChartBrushSignature>, import("./models/index.js").ChartPlugin<UseChartTooltipSignature>, import("./models/index.js").ChartPlugin<UseChartInteractionSignature>, import("./models/index.js").ChartPlugin<UseChartCartesianAxisSignature<any>>, import("./models/index.js").ChartPlugin<UseChartHighlightSignature>, import("./models/index.js").ChartPlugin<UseChartVisibilityManagerSignature<any>>, import("./models/index.js").ChartPlugin<UseChartClosestPointSignature>, import("./models/index.js").ChartPlugin<UseChartKeyboardNavigationSignature>];

package/internals/plugins/allPlugins.js

@@ -11,7 +11,8 @@ var _useChartKeyboardNavigation = require("./featurePlugins/useChartKeyboardNavi
 var _useChartClosestPoint = require("./featurePlugins/useChartClosestPoint");
 var _useChartZAxis = require("./featurePlugins/useChartZAxis");
 var _useChartBrush = require("./featurePlugins/useChartBrush");
+var _useChartVisibilityManager = require("./featurePlugins/useChartVisibilityManager");
 var _useChartTooltip = require("./featurePlugins/useChartTooltip");
 // This file should be removed after creating all plugins in favor of a file per chart type.
 
-const DEFAULT_PLUGINS = exports.DEFAULT_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartBrush.useChartBrush, _useChartTooltip.useChartTooltip, _useChartInteraction.useChartInteraction, _useChartCartesianAxis.useChartCartesianAxis, _useChartHighlight.useChartHighlight, _useChartClosestPoint.useChartClosestPoint, _useChartKeyboardNavigation.useChartKeyboardNavigation];
+const DEFAULT_PLUGINS = exports.DEFAULT_PLUGINS = [_useChartZAxis.useChartZAxis, _useChartBrush.useChartBrush, _useChartTooltip.useChartTooltip, _useChartInteraction.useChartInteraction, _useChartCartesianAxis.useChartCartesianAxis, _useChartHighlight.useChartHighlight, _useChartVisibilityManager.useChartVisibilityManager, _useChartClosestPoint.useChartClosestPoint, _useChartKeyboardNavigation.useChartKeyboardNavigation];

package/internals/plugins/corePlugins/useChartSeries/serializeIdentifier.d.ts

@@ -0,0 +1,14 @@
+import type { ChartSeriesType } from "../../../../models/seriesType/config.js";
+import type { ChartSeriesConfig } from "../../models/index.js";
+/**
+ * Serializes a series item identifier into a unique string using the appropriate serializer
+ * from the provided series configuration.
+ *
+ * @param {ChartSeriesConfig<ChartSeriesType>} seriesConfig - The configuration object for chart series.
+ * @param {SeriesItemIdentifier<ChartSeriesType>} identifier - The series item identifier to serialize.
+ * @returns {string} A unique string representation of the identifier.
+ * @throws Will throw an error if no serializer is found for the given series type.
+ */
+export declare const serializeIdentifier: <T extends ChartSeriesType, U extends {
+  type: T;
+}>(seriesConfig: ChartSeriesConfig<T>, identifier: U) => string;