@mui/x-charts-pro 8.14.0 → 8.15.0

package/SankeyChart/plugins/useSankeyHighlight.js

@@ -0,0 +1,76 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSankeyHighlight = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _useAssertModelConsistency = require("@mui/x-internals/useAssertModelConsistency");
+var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallback"));
+var _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedEffect"));
+var _fastObjectShallowCompare = require("@mui/x-internals/fastObjectShallowCompare");
+/**
+ * Custom highlight plugin for Sankey charts that uses SankeyItemIdentifier
+ * instead of the standard HighlightItemData.
+ */
+const useSankeyHighlight = ({
+  store,
+  params
+}) => {
+  (0, _useAssertModelConsistency.useAssertModelConsistency)({
+    warningPrefix: 'MUI X Charts',
+    componentName: 'SankeyChart',
+    propName: 'highlightedItem',
+    controlled: params.highlightedItem,
+    defaultValue: null
+  });
+  (0, _useEnhancedEffect.default)(() => {
+    store.update(prevState => prevState.highlight.item === params.highlightedItem ? prevState : (0, _extends2.default)({}, prevState, {
+      highlight: (0, _extends2.default)({}, prevState.highlight, {
+        item: params.highlightedItem
+      })
+    }));
+  }, [store, params.highlightedItem]);
+  const clearHighlight = (0, _useEventCallback.default)(() => {
+    params.onHighlightChange?.(null);
+    store.update(prev => (0, _extends2.default)({}, prev, {
+      highlight: {
+        item: null
+      }
+    }));
+  });
+  const setHighlight = (0, _useEventCallback.default)(newItem => {
+    const prevItem = store.getSnapshot().highlight.item;
+    if ((0, _fastObjectShallowCompare.fastObjectShallowCompare)(prevItem, newItem)) {
+      return;
+    }
+    params.onHighlightChange?.(newItem);
+    store.update(prev => (0, _extends2.default)({}, prev, {
+      highlight: {
+        item: newItem
+      }
+    }));
+  });
+  return {
+    instance: {
+      clearHighlight,
+      setHighlight
+    }
+  };
+};
+exports.useSankeyHighlight = useSankeyHighlight;
+useSankeyHighlight.getDefaultizedParams = ({
+  params
+}) => (0, _extends2.default)({}, params, {
+  highlightedItem: params.highlightedItem ?? null
+});
+useSankeyHighlight.getInitialState = params => ({
+  highlight: {
+    item: params.highlightedItem
+  }
+});
+useSankeyHighlight.params = {
+  highlightedItem: true,
+  onHighlightChange: true
+};

package/SankeyChart/plugins/useSankeyHighlight.selectors.d.ts

@@ -0,0 +1,68 @@
+import type { SankeyLayoutLink, SankeyLayoutNode } from "../sankey.types.js";
+import type { SankeyLinkFade, SankeyLinkHighlight, SankeyNodeFade, SankeyNodeHighlight } from "../sankey.highlight.types.js";
+/**
+ * Get the node highlight configuration from the Sankey series.
+ * Defaults to 'nodes' if not specified.
+ */
+export declare const selectorNodeHighlightConfig: import("reselect").Selector<import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+} & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}, SankeyNodeHighlight, any[]>;
+/**
+ * Get the node fade configuration from the Sankey series.
+ * Defaults to 'none' if not specified.
+ */
+export declare const selectorNodeFadeConfig: import("reselect").Selector<import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+} & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}, SankeyNodeFade, any[]>;
+/**
+ * Get the link highlight configuration from the Sankey series.
+ * Defaults to 'links' if not specified.
+ */
+export declare const selectorLinkHighlightConfig: import("reselect").Selector<import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+} & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}, SankeyLinkHighlight, any[]>;
+/**
+ * Get the link fade configuration from the Sankey series.
+ * Defaults to 'none' if not specified.
+ */
+export declare const selectorLinkFadeConfig: import("reselect").Selector<import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<{}> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+} & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}, SankeyLinkFade, any[]>;
+/**
+ * Get the currently highlighted item in the Sankey chart.
+ * @param {UseSankeyHighlightSignature['state']} state The state of the chart.
+ * @returns {SankeyItemIdentifier | null} The highlighted item identifier or null.
+ */
+export declare const selectorSankeyHighlightedItem: import("reselect").Selector<import("./useSankeyHighlight.types.js").UseSankeyHighlightState & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}, import("../index.js").SankeyItemIdentifier | null, []>;
+/**
+ * Determines if a specific node should be highlighted.
+ * A node is highlighted if:
+ * - It's the highlighted node (unless highlight mode is 'none')
+ * - It's connected to a highlighted link (based on linkOptions.highlight)
+ */
+export declare const selectorIsNodeHighlighted: import("reselect").Selector<any, boolean, [node: SankeyLayoutNode]>;
+/**
+ * Selector that determines if a specific link should be highlighted.
+ * A link is highlighted if:
+ * - It's the highlighted link (unless highlight mode is 'none')
+ * - It's connected to a highlighted node (based on nodeOptions.highlight)
+ */
+export declare const selectorIsLinkHighlighted: import("reselect").Selector<any, boolean, [link: SankeyLayoutLink]>;
+/**
+ * Selector that determines if an item should be faded.
+ * An item is faded if:
+ * - There's a highlighted item
+ * - This item is not highlighted
+ * - The fade mode is 'global' for the highlighted element type
+ */
+export declare const selectorIsSankeyItemFaded: import("reselect").Selector<any, boolean, [isHighlighted: any]>;

package/SankeyChart/plugins/useSankeyHighlight.selectors.js

@@ -0,0 +1,126 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.selectorSankeyHighlightedItem = exports.selectorNodeHighlightConfig = exports.selectorNodeFadeConfig = exports.selectorLinkHighlightConfig = exports.selectorLinkFadeConfig = exports.selectorIsSankeyItemFaded = exports.selectorIsNodeHighlighted = exports.selectorIsLinkHighlighted = void 0;
+var _internals = require("@mui/x-charts/internals");
+const selectorSankeyHighlight = state => state.highlight;
+const selectSeries = state => state.series;
+const selectorSankeySeries = (0, _internals.createSelector)([selectSeries], series => series.processedSeries.sankey?.series[series.processedSeries.sankey?.seriesOrder[0]] || null);
+const DEFAULT_NODE_HIGHLIGHT = 'links';
+const DEFAULT_LINK_HIGHLIGHT = 'links';
+const DEFAULT_FADE = 'none';
+
+/**
+ * Get the node highlight configuration from the Sankey series.
+ * Defaults to 'nodes' if not specified.
+ */
+const selectorNodeHighlightConfig = exports.selectorNodeHighlightConfig = (0, _internals.createSelector)([selectorSankeySeries], series => series?.nodeOptions?.highlight ?? DEFAULT_NODE_HIGHLIGHT);
+
+/**
+ * Get the node fade configuration from the Sankey series.
+ * Defaults to 'none' if not specified.
+ */
+const selectorNodeFadeConfig = exports.selectorNodeFadeConfig = (0, _internals.createSelector)([selectorSankeySeries], series => series?.nodeOptions?.fade ?? DEFAULT_FADE);
+
+/**
+ * Get the link highlight configuration from the Sankey series.
+ * Defaults to 'links' if not specified.
+ */
+const selectorLinkHighlightConfig = exports.selectorLinkHighlightConfig = (0, _internals.createSelector)([selectorSankeySeries], series => series?.linkOptions?.highlight ?? DEFAULT_LINK_HIGHLIGHT);
+
+/**
+ * Get the link fade configuration from the Sankey series.
+ * Defaults to 'none' if not specified.
+ */
+const selectorLinkFadeConfig = exports.selectorLinkFadeConfig = (0, _internals.createSelector)([selectorSankeySeries], series => series?.linkOptions?.fade ?? DEFAULT_FADE);
+
+/**
+ * Get the currently highlighted item in the Sankey chart.
+ * @param {UseSankeyHighlightSignature['state']} state The state of the chart.
+ * @returns {SankeyItemIdentifier | null} The highlighted item identifier or null.
+ */
+const selectorSankeyHighlightedItem = exports.selectorSankeyHighlightedItem = (0, _internals.createSelector)([selectorSankeyHighlight], highlight => highlight.item);
+
+/**
+ * Determines if a specific node should be highlighted.
+ * A node is highlighted if:
+ * - It's the highlighted node (unless highlight mode is 'none')
+ * - It's connected to a highlighted link (based on linkOptions.highlight)
+ */
+const selectorIsNodeHighlighted = exports.selectorIsNodeHighlighted = (0, _internals.createSelector)([selectorSankeyHighlightedItem, selectorNodeHighlightConfig, selectorLinkHighlightConfig, (_, node) => node.id], (highlightedItem, nodeHighlight, linkHighlight, nodeId) => {
+  if (!highlightedItem) {
+    return false;
+  }
+  if (highlightedItem.subType === 'node' && highlightedItem.nodeId === nodeId) {
+    return nodeHighlight !== 'none';
+  }
+  if (highlightedItem.subType === 'link') {
+    if (!linkHighlight || linkHighlight === 'none' || linkHighlight === 'links') {
+      return false;
+    }
+    const {
+      sourceId,
+      targetId
+    } = highlightedItem;
+    switch (linkHighlight) {
+      case 'nodes':
+        return nodeId === sourceId || nodeId === targetId;
+      case 'source':
+        return nodeId === sourceId;
+      case 'target':
+        return nodeId === targetId;
+      default:
+        return false;
+    }
+  }
+  return false;
+});
+
+/**
+ * Selector that determines if a specific link should be highlighted.
+ * A link is highlighted if:
+ * - It's the highlighted link (unless highlight mode is 'none')
+ * - It's connected to a highlighted node (based on nodeOptions.highlight)
+ */
+const selectorIsLinkHighlighted = exports.selectorIsLinkHighlighted = (0, _internals.createSelector)([selectorSankeyHighlightedItem, selectorNodeHighlightConfig, selectorLinkHighlightConfig, (_, link) => link], (highlightedItem, nodeHighlight, linkHighlight, link) => {
+  if (!highlightedItem) {
+    return false;
+  }
+  if (highlightedItem.subType === 'link' && highlightedItem.sourceId === link.source.id && highlightedItem.targetId === link.target.id) {
+    return linkHighlight !== 'none';
+  }
+  if (highlightedItem.subType === 'node') {
+    if (!nodeHighlight || nodeHighlight === 'none' || nodeHighlight === 'nodes') {
+      return false;
+    }
+    const highlightedNodeId = highlightedItem.nodeId;
+    switch (nodeHighlight) {
+      case 'links':
+        return link.source.id === highlightedNodeId || link.target.id === highlightedNodeId;
+      case 'incoming':
+        return link.target.id === highlightedNodeId;
+      case 'outgoing':
+        return link.source.id === highlightedNodeId;
+      default:
+        return false;
+    }
+  }
+  return false;
+});
+
+/**
+ * Selector that determines if an item should be faded.
+ * An item is faded if:
+ * - There's a highlighted item
+ * - This item is not highlighted
+ * - The fade mode is 'global' for the highlighted element type
+ */
+const selectorIsSankeyItemFaded = exports.selectorIsSankeyItemFaded = (0, _internals.createSelector)([selectorSankeyHighlightedItem, selectorNodeFadeConfig, selectorLinkFadeConfig, (_, isHighlighted) => isHighlighted], (highlightedItem, nodeFade, linkFade, isHighlighted) => {
+  if (!highlightedItem || isHighlighted) {
+    return false;
+  }
+  const fadeMode = highlightedItem.subType === 'node' ? nodeFade : linkFade;
+  return fadeMode === 'global';
+});

package/SankeyChart/plugins/useSankeyHighlight.types.d.ts

@@ -0,0 +1,55 @@
+import { DefaultizedProps } from '@mui/x-internals/types';
+import { ChartPluginSignature } from '@mui/x-charts/internals';
+import { SankeyItemIdentifier } from "../sankey.types.js";
+/**
+ * The data of the highlighted item in a Sankey chart.
+ * Can be either a node or a link.
+ *
+ * @example
+ * // Highlight a node
+ * { type: 'sankey', seriesId: 'series-1', subType: 'node', nodeId: 'A' }
+ *
+ * // Highlight a link
+ * { type: 'sankey', seriesId: 'series-1', subType: 'link', sourceId: 'A', targetId: 'B' }
+ *
+ * // Clear the highlight
+ * null
+ */
+export type SankeyHighlightItemData = SankeyItemIdentifier;
+export interface UseSankeyHighlightInstance {
+  /**
+   * Remove all highlight.
+   */
+  clearHighlight: () => void;
+  /**
+   * Set the highlighted item.
+   * @param {SankeyHighlightItemData} item The item to highlight.
+   */
+  setHighlight: (item: SankeyHighlightItemData) => void;
+}
+export interface UseSankeyHighlightParameters {
+  /**
+   * The highlighted item.
+   * Used when the highlight is controlled.
+   */
+  highlightedItem?: SankeyHighlightItemData | null;
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {SankeyHighlightItemData | null} highlightedItem The newly highlighted item.
+   */
+  onHighlightChange?: (highlightedItem: SankeyHighlightItemData | null) => void;
+}
+export type UseSankeyHighlightDefaultizedParameters = DefaultizedProps<UseSankeyHighlightParameters, 'highlightedItem'>;
+export interface UseSankeyHighlightState {
+  highlight: {
+    item: SankeyHighlightItemData | null;
+  };
+}
+export type UseSankeyHighlightSignature = ChartPluginSignature<{
+  instance: UseSankeyHighlightInstance;
+  state: UseSankeyHighlightState;
+  params: UseSankeyHighlightParameters;
+  defaultizedParams: UseSankeyHighlightDefaultizedParameters;
+  modelNames: 'highlightedItem';
+}>;

package/SankeyChart/plugins/useSankeyHighlight.types.js

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

package/SankeyChart/sankey.highlight.types.d.ts

@@ -0,0 +1,42 @@
+export type SankeyNodeHighlight = 'nodes' | 'links' | 'incoming' | 'outgoing' | 'none';
+export type SankeyNodeFade = 'global' | 'none';
+export type SankeyLinkHighlight = 'links' | 'nodes' | 'source' | 'target' | 'none';
+export type SankeyLinkFade = 'global' | 'none';
+export type SankeyNodeHighlightScope = {
+  /**
+   * Highlight mode for nodes
+   * - 'nodes': Highlight hovered node
+   * - 'links': Highlight links connected to hovered node
+   * - 'incoming': Highlight incoming links to hovered node
+   * - 'outgoing': Highlight outgoing links from hovered node
+   * - 'none': No highlighting
+   * @default 'links'
+   */
+  highlight?: SankeyNodeHighlight;
+  /**
+   * Fade mode for nodes
+   * - 'global': Fade all non-highlighted items
+   * - 'none': No fading
+   * @default 'none'
+   */
+  fade?: SankeyNodeFade;
+};
+export type SankeyLinkHighlightScope = {
+  /**
+   * Highlight mode for links
+   * - 'links': Highlight hovered link
+   * - 'nodes': Highlight nodes connected to hovered link
+   * - 'source': Highlight source node of hovered link
+   * - 'target': Highlight target node of hovered link
+   * - 'none': No highlighting
+   * @default 'links'
+   */
+  highlight?: SankeyLinkHighlight;
+  /**
+   * Fade mode for links
+   * - 'global': Fade all non-highlighted items
+   * - 'none': No fading
+   * @default 'none'
+   */
+  fade?: SankeyLinkFade;
+};

package/SankeyChart/sankey.highlight.types.js

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

package/SankeyChart/sankey.types.d.ts

@@ -1,6 +1,7 @@
 import type { HighlightScope, SeriesId } from '@mui/x-charts/internals';
 import type { DefaultizedProps, MakeRequired } from '@mui/x-internals/types';
 import type { SankeyLink as D3SankeyLink, SankeyNode as D3SankeyNode } from '@mui/x-charts-vendor/d3-sankey';
+import type { SankeyLinkHighlightScope, SankeyNodeHighlightScope } from "./sankey.highlight.types.js";
 export type SankeyNodeId = string | number;
 export interface SankeyNode {
   /**
@@ -79,7 +80,7 @@ export type SankeyNodeOptions = {
    * @returns {number} Comparison result
    */
   sort?: (a: SankeyLayoutNode, b: SankeyLayoutNode) => number | null;
-};
+} & SankeyNodeHighlightScope;
 export type SankeyLinkOptions = {
   /**
    * Default color for links without specified colors.
@@ -111,7 +112,7 @@ export type SankeyLinkOptions = {
    * @default 10
    */
   curveCorrection?: number;
-};
+} & SankeyLinkHighlightScope;
 export interface SankeyData {
   /**
    * An array of node configs for the Sankey diagram

package/SankeyChart/sankeyClasses.d.ts

@@ -12,4 +12,4 @@ export declare function getSankeyPlotUtilityClass(slot: string): string;
 export declare const sankeyPlotClasses: SankeyPlotClasses;
 export declare const useUtilityClasses: (ownerState: {
   classes?: Partial<SankeyPlotClasses>;
-}) => Record<"root" | "nodes" | "links" | "linkLabels", string>;
+}) => Record<"nodes" | "links" | "root" | "linkLabels", string>;

package/SankeyChart/useSankeyChartProps.js

@@ -10,7 +10,7 @@ var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runt
 var _constants = require("@mui/x-charts/constants");
 var _internals = require("@mui/x-charts/internals");
 var _SankeyChart = require("./SankeyChart.plugins");
-const _excluded = ["series", "width", "height", "margin", "colors", "sx", "children", "slots", "slotProps", "loading", "className", "apiRef", "onNodeClick", "onLinkClick"];
+const _excluded = ["series", "width", "height", "margin", "colors", "sx", "children", "slots", "slotProps", "loading", "highlightedItem", "onHighlightChange", "className", "apiRef", "onNodeClick", "onLinkClick"];
 /**
  * A helper function that extracts SankeyChartProps from the input props
  * and returns an object with props for the children components of SankeyChart.
@@ -30,8 +30,8 @@ const useSankeyChartProps = props => {
       slots,
       slotProps,
       loading,
-      // highlightedItem,
-      // onHighlightChange,
+      highlightedItem,
+      onHighlightChange,
       className,
       apiRef,
       onNodeClick,
@@ -48,8 +48,8 @@ const useSankeyChartProps = props => {
     margin,
     colors,
     sx,
-    // highlightedItem,
-    // onHighlightChange,
+    highlightedItem,
+    onHighlightChange,
     className,
     apiRef,
     plugins: _SankeyChart.SANKEY_CHART_PLUGINS

package/ScatterChartPro/ScatterChartPro.js

@@ -111,6 +111,14 @@ process.env.NODE_ENV !== "production" ? ScatterChartPro.propTypes = {
     x: _propTypes.default.oneOf(['band', 'line', 'none']),
     y: _propTypes.default.oneOf(['band', 'line', 'none'])
   }),
+  /**
+   * Configuration for the brush interaction.
+   */
+  brushConfig: _propTypes.default.shape({
+    enabled: _propTypes.default.bool,
+    preventHighlight: _propTypes.default.bool,
+    preventTooltip: _propTypes.default.bool
+  }),
   children: _propTypes.default.node,
   className: _propTypes.default.string,
   /**

package/ScatterChartPro/ScatterChartPro.plugins.d.ts

@@ -1,5 +1,5 @@
-import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
+import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseChartBrushSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
 import { UseChartProExportSignature } from "../internals/plugins/useChartProExport/index.js";
 import { UseChartProZoomSignature } from "../internals/plugins/useChartProZoom/index.js";
-export type ScatterChartProPluginSignatures = [UseChartZAxisSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
+export type ScatterChartProPluginSignatures = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<'scatter'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartClosestPointSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
 export declare const SCATTER_CHART_PRO_PLUGINS: ConvertSignaturesIntoPlugins<ScatterChartProPluginSignatures>;

package/ScatterChartPro/ScatterChartPro.plugins.js

@@ -7,4 +7,4 @@ exports.SCATTER_CHART_PRO_PLUGINS = void 0;
 var _internals = require("@mui/x-charts/internals");
 var _useChartProExport = require("../internals/plugins/useChartProExport");
 var _useChartProZoom = require("../internals/plugins/useChartProZoom");
-const SCATTER_CHART_PRO_PLUGINS = exports.SCATTER_CHART_PRO_PLUGINS = [_internals.useChartZAxis, _internals.useChartCartesianAxis, _internals.useChartInteraction, _internals.useChartHighlight, _internals.useChartClosestPoint, _internals.useChartKeyboardNavigation, _useChartProZoom.useChartProZoom, _useChartProExport.useChartProExport];
+const SCATTER_CHART_PRO_PLUGINS = exports.SCATTER_CHART_PRO_PLUGINS = [_internals.useChartZAxis, _internals.useChartBrush, _internals.useChartCartesianAxis, _internals.useChartInteraction, _internals.useChartHighlight, _internals.useChartClosestPoint, _internals.useChartKeyboardNavigation, _useChartProZoom.useChartProZoom, _useChartProExport.useChartProExport];

package/esm/BarChartPro/BarChartPro.js

@@ -118,6 +118,14 @@ process.env.NODE_ENV !== "production" ? BarChartPro.propTypes = {
    * Defines the border radius of the bar element.
    */
   borderRadius: PropTypes.number,
+  /**
+   * Configuration for the brush interaction.
+   */
+  brushConfig: PropTypes.shape({
+    enabled: PropTypes.bool,
+    preventHighlight: PropTypes.bool,
+    preventTooltip: PropTypes.bool
+  }),
   children: PropTypes.node,
   className: PropTypes.string,
   /**

package/esm/BarChartPro/BarChartPro.plugins.d.ts

@@ -1,5 +1,5 @@
-import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
+import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartBrushSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
 import { UseChartProExportSignature } from "../internals/plugins/useChartProExport/index.js";
 import { UseChartProZoomSignature } from "../internals/plugins/useChartProZoom/index.js";
-export type BarChartProPluginSignatures = [UseChartZAxisSignature, UseChartCartesianAxisSignature<'bar'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
+export type BarChartProPluginSignatures = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<'bar'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
 export declare const BAR_CHART_PRO_PLUGINS: ConvertSignaturesIntoPlugins<BarChartProPluginSignatures>;

package/esm/BarChartPro/BarChartPro.plugins.js

@@ -1,4 +1,4 @@
-import { useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation } from '@mui/x-charts/internals';
+import { useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartBrush } from '@mui/x-charts/internals';
 import { useChartProExport } from "../internals/plugins/useChartProExport/index.js";
 import { useChartProZoom } from "../internals/plugins/useChartProZoom/index.js";
-export const BAR_CHART_PRO_PLUGINS = [useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartProZoom, useChartProExport];
+export const BAR_CHART_PRO_PLUGINS = [useChartZAxis, useChartBrush, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartProZoom, useChartProExport];

package/esm/ChartDataProviderPro/ChartDataProviderPro.js

@@ -11,7 +11,7 @@ import { defaultSlotsMaterial } from "../internals/material/index.js";
 import { DEFAULT_PLUGINS } from "../internals/plugins/allPlugins.js";
 import { useChartDataProviderProProps } from "./useChartDataProviderProProps.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const releaseInfo = "MTc1OTk2ODAwMDAwMA==";
+const releaseInfo = "MTc2MTE3NzYwMDAwMA==";
 const packageIdentifier = 'x-charts-pro';
 /**
  * Orchestrates the data providers for the chart components and hooks.

package/esm/ChartsBrushOverlay/index.d.ts

@@ -0,0 +1 @@
+export * from '@mui/x-charts/ChartsBrushOverlay';

package/esm/ChartsBrushOverlay/index.js

@@ -0,0 +1,2 @@
+// Re-export automatically generated, to customize, simply remove this line.
+export * from '@mui/x-charts/ChartsBrushOverlay';

package/esm/LineChartPro/LineChartPro.js

@@ -110,6 +110,14 @@ process.env.NODE_ENV !== "production" ? LineChartPro.propTypes = {
     x: PropTypes.oneOf(['band', 'line', 'none']),
     y: PropTypes.oneOf(['band', 'line', 'none'])
   }),
+  /**
+   * Configuration for the brush interaction.
+   */
+  brushConfig: PropTypes.shape({
+    enabled: PropTypes.bool,
+    preventHighlight: PropTypes.bool,
+    preventTooltip: PropTypes.bool
+  }),
   children: PropTypes.node,
   className: PropTypes.string,
   /**

package/esm/LineChartPro/LineChartPro.plugins.d.ts

@@ -1,5 +1,5 @@
-import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
+import { UseChartZAxisSignature, UseChartCartesianAxisSignature, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartBrushSignature, ConvertSignaturesIntoPlugins } from '@mui/x-charts/internals';
 import { UseChartProExportSignature } from "../internals/plugins/useChartProExport/index.js";
 import { UseChartProZoomSignature } from "../internals/plugins/useChartProZoom/index.js";
-export type LineChartProPluginSignatures = [UseChartZAxisSignature, UseChartCartesianAxisSignature<'line'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
+export type LineChartProPluginSignatures = [UseChartZAxisSignature, UseChartBrushSignature, UseChartCartesianAxisSignature<'line'>, UseChartInteractionSignature, UseChartHighlightSignature, UseChartKeyboardNavigationSignature, UseChartProZoomSignature, UseChartProExportSignature];
 export declare const LINE_CHART_PRO_PLUGINS: ConvertSignaturesIntoPlugins<LineChartProPluginSignatures>;

package/esm/LineChartPro/LineChartPro.plugins.js

@@ -1,4 +1,4 @@
-import { useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation } from '@mui/x-charts/internals';
+import { useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartBrush } from '@mui/x-charts/internals';
 import { useChartProExport } from "../internals/plugins/useChartProExport/index.js";
 import { useChartProZoom } from "../internals/plugins/useChartProZoom/index.js";
-export const LINE_CHART_PRO_PLUGINS = [useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartProZoom, useChartProExport];
+export const LINE_CHART_PRO_PLUGINS = [useChartZAxis, useChartBrush, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartKeyboardNavigation, useChartProZoom, useChartProExport];

package/esm/SankeyChart/SankeyChart.d.ts

@@ -7,7 +7,7 @@ import { type SankeyChartPluginSignatures } from "./SankeyChart.plugins.js";
 import type { SankeySeriesType } from "./sankey.types.js";
 import type { SankeyChartSlotExtension } from "./sankeySlots.types.js";
 export type SankeySeries = MakeOptional<SankeySeriesType, 'type'>;
-export interface SankeyChartProps extends Omit<ChartContainerProProps<'sankey', SankeyChartPluginSignatures>, 'plugins' | 'series' | 'slotProps' | 'slots' | 'dataset' | 'hideLegend' | 'skipAnimation' | 'highlightedItem' | 'onHighlightChange'>, Omit<SankeyPlotProps, 'data'>, Omit<ChartsOverlayProps, 'slots' | 'slotProps'>, SankeyChartSlotExtension {
+export interface SankeyChartProps extends Omit<ChartContainerProProps<'sankey', SankeyChartPluginSignatures>, 'plugins' | 'series' | 'slotProps' | 'slots' | 'dataset' | 'hideLegend' | 'skipAnimation'>, Omit<SankeyPlotProps, 'data'>, Omit<ChartsOverlayProps, 'slots' | 'slotProps'>, SankeyChartSlotExtension {
   /**
    * The series to display in the Sankey chart.
    * A single object is expected.

package/esm/SankeyChart/SankeyChart.js

@@ -94,6 +94,30 @@ process.env.NODE_ENV !== "production" ? SankeyChart.propTypes = {
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
   height: PropTypes.number,
+  /**
+   * The highlighted item.
+   * Used when the highlight is controlled.
+   */
+  highlightedItem: PropTypes.oneOfType([PropTypes.shape({
+    nodeId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    subType: PropTypes.oneOf([
+    /**
+     * Subtype to differentiate between node and link
+     */
+    'node']).isRequired,
+    type: PropTypes.oneOf(['sankey']).isRequired
+  }), PropTypes.shape({
+    seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    sourceId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    subType: PropTypes.oneOf([
+    /**
+     * Subtype to differentiate between node and link
+     */
+    'link']).isRequired,
+    targetId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    type: PropTypes.oneOf(['sankey']).isRequired
+  })]),
   /**
    * This prop is used to help implement the accessibility logic.
    * If you don't provide this prop. It falls back to a randomly generated id.
@@ -120,6 +144,12 @@ process.env.NODE_ENV !== "production" ? SankeyChart.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   })]),
+  /**
+   * The callback fired when the highlighted item changes.
+   *
+   * @param {SankeyHighlightItemData | null} highlightedItem The newly highlighted item.
+   */
+  onHighlightChange: PropTypes.func,
   /**
    * Callback fired when a sankey item is clicked.
    * @param {React.MouseEvent<SVGElement, MouseEvent>} event The event source of the callback.

package/esm/SankeyChart/SankeyChart.plugins.d.ts

@@ -1,4 +1,5 @@
-import { ConvertSignaturesIntoPlugins, UseChartHighlightSignature, UseChartInteractionSignature } from '@mui/x-charts/internals';
+import { ConvertSignaturesIntoPlugins, UseChartInteractionSignature } from '@mui/x-charts/internals';
 import { UseChartProExportSignature } from "../internals/plugins/useChartProExport/index.js";
-export type SankeyChartPluginSignatures = [UseChartInteractionSignature, UseChartHighlightSignature, UseChartProExportSignature];
+import { type UseSankeyHighlightSignature } from "./plugins/index.js";
+export type SankeyChartPluginSignatures = [UseChartInteractionSignature, UseSankeyHighlightSignature, UseChartProExportSignature];
 export declare const SANKEY_CHART_PLUGINS: ConvertSignaturesIntoPlugins<SankeyChartPluginSignatures>;