@mui/x-charts-pro 9.0.0-alpha.0 → 9.0.0-alpha.2

package/SankeyChart/sankey.types.d.mts

@@ -0,0 +1,300 @@
+import type { SeriesId } from '@mui/x-charts/internals';
+import type { DefaultizedProps, MakeRequired } from '@mui/x-internals/types';
+import type { SankeyLink as D3SankeyLink, SankeyNode as D3SankeyNode } from "./d3Sankey/index.mjs";
+import type { SankeyHighlightScope, SankeyLinkHighlightScope, SankeyNodeHighlightScope } from "./sankey.highlight.types.mjs";
+export type SankeyNodeId = string | number;
+export interface SankeyNode {
+  /**
+   * Unique identifier for the node
+   */
+  id: SankeyNodeId;
+  /**
+   * The node label to display
+   */
+  label?: string;
+  /**
+   * Optional custom data for the node
+   */
+  data?: any;
+  /**
+   * Optional color override for the node
+   */
+  color?: string;
+}
+export interface SankeyLink {
+  /**
+   * Source node ID
+   */
+  source: SankeyNodeId;
+  /**
+   * Target node ID
+   */
+  target: SankeyNodeId;
+  /**
+   * The value/weight of the link (affects width)
+   */
+  value: number;
+  /**
+   * Optional custom data for the link
+   */
+  data?: any;
+  /**
+   * Optional color override for the link.
+   * Can be a color string, or a keyword:
+   * - 'source': Use the color of the source node
+   * - 'target': Use the color of the target node
+   * @default 'source'
+   */
+  color?: string | 'source' | 'target';
+}
+export type SankeyNodeOptions = {
+  /**
+   * Default color for nodes without specified colors
+   */
+  color?: string;
+  /**
+   * Width of the nodes in pixels
+   */
+  width?: number;
+  /**
+   * Padding between nodes in pixels
+   */
+  padding?: number;
+  /**
+   * Node alignment strategy
+   * - 'justify': Nodes are evenly distributed across the width.
+   * - 'left': Nodes are  aligned to the left.
+   * - 'right': Nodes are aligned to the right.
+   * - 'center': Nodes are centered.
+   * @default 'justify'
+   */
+  align?: 'justify' | 'left' | 'right' | 'center';
+  /**
+   * Whether to show node labels
+   */
+  showLabels?: boolean;
+  /**
+   * Custom sort mode for nodes
+   *
+   * - 'auto': Automatic sorting behavior (default)
+   * - 'fixed': Preserve the order from the nodes array (disables automatic sorting)
+   * - or a custom function
+   *
+   * @param {SankeyLayoutNode} a - First node to compare
+   * @param {SankeyLayoutNode} b - Second node to compare
+   * @returns {number} Comparison result
+   *
+   * @default 'auto'
+   */
+  sort?: 'auto' | 'fixed' | ((a: SankeyLayoutNode<true>, b: SankeyLayoutNode<true>) => number);
+} & SankeyNodeHighlightScope;
+export type SankeyLinkOptions = {
+  /**
+   * Default color for links without specified colors.
+   * Can be a color string, or a keyword:
+   * - 'source': Use the color of the source node
+   * - 'target': Use the color of the target node
+   * @default 'source'
+   */
+  color?: string | 'source' | 'target';
+  /**
+   * Opacity of the links (0-1)
+   */
+  opacity?: number;
+  /**
+   * Whether to show link values
+   */
+  showValues?: boolean;
+  /**
+   * Custom sort mode for links
+   *
+   * - 'auto': Automatic sorting behavior (default)
+   * - 'fixed': Preserve the order from the links array (disables automatic sorting)
+   * - or a custom function
+   *
+   * @param {SankeyLayoutLink} a - First link to compare
+   * @param {SankeyLayoutLink} b - Second link to compare
+   * @returns {number} Comparison result
+     * @default 'auto'
+   */
+  sort?: 'auto' | 'fixed' | ((a: SankeyLayoutLink<true>, b: SankeyLayoutLink<true>) => number);
+  /**
+   * Applies the given number to the X dimension of the control points of the link's curve function.
+   * This can create better looking links between nodes, but is dependent on the graph layout.
+   * It is specially impacted by the chart height.
+   * @default 10
+   */
+  curveCorrection?: number;
+} & SankeyLinkHighlightScope;
+export interface SankeyData {
+  /**
+   * An array of node configs for the Sankey diagram
+   *
+   * This is optional, but can be used to provide custom labels or styles for nodes.
+   */
+  nodes?: readonly SankeyNode[];
+  /**
+   * Array of links between nodes.
+   *
+   * The node ids will be used as the labels. If you want to provide custom labels, use the `nodes` property.
+   *
+   * Each link should have a `source`, `target`, and `value` property.
+   */
+  links: readonly SankeyLink[];
+}
+export interface SankeySeriesType {
+  /**
+   * Unique identifier for the series
+   */
+  id?: SeriesId;
+  /**
+   * Type identifier for Sankey series
+   */
+  type: 'sankey';
+  /**
+   * The data for the Sankey diagram
+   */
+  data: SankeyData;
+  /**
+   * Optional configuration for the nodes style, layout, and behavior
+   */
+  nodeOptions?: SankeyNodeOptions;
+  /**
+   * Optional configuration for the links style, layout, and behavior
+   */
+  linkOptions?: SankeyLinkOptions;
+  /**
+   * Number of iterations for the layout algorithm
+   * @default 6
+   */
+  iterations?: number;
+  /**
+   * Formatter used to render values in tooltip or other data display.
+   * @param {number} value The value to render.
+   * @param {SankeyValueFormatterContext} context The rendering context of the value.
+   * @param {'node' | 'link'} context.type The type of element being formatted.
+   * @param {SankeyNodeId} [context.nodeId] For nodes: the node ID. For links: undefined.
+   * @param {SankeyNodeId} [context.sourceId] For links: the source node ID. For nodes: undefined.
+   * @param {SankeyNodeId} [context.targetId] For links: the target node ID. For nodes: undefined.
+   * @returns {string | null} The formatted value to display.
+   */
+  valueFormatter?: (value: number, context: SankeyValueFormatterContext) => string | null;
+}
+export interface SankeyLayoutNodeWithoutPosition extends D3SankeyNode<false, MakeRequired<SankeyNode, 'label' | 'color'>, SankeyLayoutLinkWithoutPosition> {
+  targetLinks: SankeyLayoutLinkWithoutPosition[];
+  sourceLinks: SankeyLayoutLinkWithoutPosition[];
+  value: number;
+}
+export interface SankeyLayoutLinkWithoutPosition extends D3SankeyLink<false, SankeyLayoutNodeWithoutPosition, Omit<MakeRequired<SankeyLink, 'color'>, 'source' | 'target'>> {
+  source: SankeyLayoutNodeWithoutPosition;
+  target: SankeyLayoutNodeWithoutPosition;
+}
+export interface SankeyLayoutNodeWithPosition extends D3SankeyNode<true, MakeRequired<SankeyNode, 'label' | 'color'>, SankeyLayoutLinkWithPosition> {
+  targetLinks: SankeyLayoutLinkWithPosition[];
+  sourceLinks: SankeyLayoutLinkWithPosition[];
+  value: number;
+}
+export interface SankeyLayoutLinkWithPosition extends D3SankeyLink<true, SankeyLayoutNodeWithPosition, Omit<MakeRequired<SankeyLink, 'color'>, 'source' | 'target'>> {
+  path?: string | null;
+  source: SankeyLayoutNodeWithPosition;
+  target: SankeyLayoutNodeWithPosition;
+}
+/**
+ * Represents the calculated positions and dimensions for a node in the Sankey diagram
+ */
+export type SankeyLayoutNode<WithPosition extends boolean = true> = WithPosition extends true ? SankeyLayoutNodeWithPosition : SankeyLayoutNodeWithoutPosition;
+/**
+ * Represents the calculated positions and paths for a link in the Sankey diagram
+ */
+export type SankeyLayoutLink<WithPosition extends boolean = true> = WithPosition extends true ? SankeyLayoutLinkWithPosition : SankeyLayoutLinkWithoutPosition;
+/**
+ * Calculated layout for the Sankey diagram
+ */
+export interface SankeyLayout<WithPosition extends boolean = true> {
+  nodes: readonly SankeyLayoutNode<WithPosition>[];
+  links: readonly SankeyLayoutLink<WithPosition>[];
+}
+export interface DefaultizedSankeySeriesType extends DefaultizedProps<Omit<SankeySeriesType, 'data'>, 'id' | 'valueFormatter'> {
+  data: SankeyLayout<false>;
+  /**
+   * Highlight scope for the series derived from nodeOptions and linksOptions
+   */
+  highlightScope: SankeyHighlightScope;
+}
+type SankeyNodeIdentifierBase = {
+  type: 'sankey';
+  /**
+   * Unique identifier for the series
+   */
+  seriesId: SeriesId;
+};
+export type SankeyNodeIdentifier = SankeyNodeIdentifierBase & {
+  /**
+   * Subtype to differentiate between node and link
+   */
+  subType: 'node';
+  /**
+   * The id of the node
+   */
+  nodeId: SankeyNodeId;
+};
+export type SankeyNodeIdentifierWithData<WithPosition extends boolean = true> = SankeyNodeIdentifier & {
+  /**
+   * The node object with all the calculated properties
+   */
+  node: SankeyLayoutNode<WithPosition>;
+};
+export type SankeyLinkIdentifier = SankeyNodeIdentifierBase & {
+  /**
+   * Subtype to differentiate between node and link
+   */
+  subType: 'link';
+  /**
+   * The id of the source node
+   */
+  sourceId: SankeyNodeId;
+  /**
+   * The id of the target node
+   */
+  targetId: SankeyNodeId;
+};
+export type SankeyLinkIdentifierWithData<WithPosition extends boolean = true> = SankeyLinkIdentifier & {
+  /**
+   * The link object with all the calculated properties
+   */
+  link: SankeyLayoutLink<WithPosition>;
+};
+export type SankeyItemIdentifier = SankeyNodeIdentifier | SankeyLinkIdentifier;
+export type SankeyItemIdentifierWithData<WithPosition extends boolean = true> = SankeyNodeIdentifierWithData<WithPosition> | SankeyLinkIdentifierWithData<WithPosition>;
+export type SankeyValueFormatterContext = {
+  /**
+   * Where the value will be displayed
+   */
+  location: 'tooltip' | 'label';
+  /**
+   * Can be 'node' or 'link'
+   */
+  type: 'node';
+  /**
+   * The id of the node
+   */
+  nodeId: SankeyNodeId;
+} | {
+  /**
+   * Where the value will be displayed
+   */
+  location: 'tooltip' | 'label';
+  /**
+   * Can be 'node' or 'link'
+   */
+  type: 'link';
+  /**
+   * The id of the source node
+   */
+  sourceId: SankeyNodeId;
+  /**
+   * The id of the target node
+   */
+  targetId: SankeyNodeId;
+};
+export {};

package/SankeyChart/sankeyHighlightHooks.d.mts

@@ -0,0 +1,3 @@
+import type { SankeyLinkIdentifier, SankeyNodeIdentifier } from "./sankey.types.mjs";
+export declare function useSankeyNodeHighlightState(nodeIdentifier: SankeyNodeIdentifier): "none" | "highlighted" | "faded";
+export declare function useSankeyLinkHighlightState(linkIdentifier: SankeyLinkIdentifier): "none" | "highlighted" | "faded";

package/SankeyChart/sankeyHighlightHooks.d.ts

@@ -1,3 +1,3 @@
-import type { SankeyLayoutLink, SankeyNodeId } from "./sankey.types.js";
-export declare function useSankeyNodeHighlightState(nodeId: SankeyNodeId): "none" | "highlighted" | "faded";
-export declare function useSankeyLinkHighlightState(link: SankeyLayoutLink): "none" | "highlighted" | "faded";
+import type { SankeyLinkIdentifier, SankeyNodeIdentifier } from "./sankey.types.js";
+export declare function useSankeyNodeHighlightState(nodeIdentifier: SankeyNodeIdentifier): "none" | "highlighted" | "faded";
+export declare function useSankeyLinkHighlightState(linkIdentifier: SankeyLinkIdentifier): "none" | "highlighted" | "faded";

package/SankeyChart/sankeyHighlightHooks.js

@@ -6,19 +6,18 @@ Object.defineProperty(exports, "__esModule", {
 exports.useSankeyLinkHighlightState = useSankeyLinkHighlightState;
 exports.useSankeyNodeHighlightState = useSankeyNodeHighlightState;
 var _internals = require("@mui/x-charts/internals");
-var _useSankeyHighlight = require("./plugins/useSankeyHighlight.selectors");
-function useSankeyNodeHighlightState(nodeId) {
+function useSankeyNodeHighlightState(nodeIdentifier) {
   const store = (0, _internals.useStore)();
-  const isHighlighted = store.use(_useSankeyHighlight.selectorIsNodeHighlighted, nodeId);
-  const isFaded = store.use(_useSankeyHighlight.selectorIsSankeyItemFaded, isHighlighted);
+  const isHighlighted = store.use(_internals.selectorChartsIsHighlighted, nodeIdentifier);
+  const isFaded = store.use(_internals.selectorChartsIsFaded, nodeIdentifier);
 
   // eslint-disable-next-line no-nested-ternary
   return isHighlighted ? 'highlighted' : isFaded ? 'faded' : 'none';
 }
-function useSankeyLinkHighlightState(link) {
+function useSankeyLinkHighlightState(linkIdentifier) {
   const store = (0, _internals.useStore)();
-  const isHighlighted = store.use(_useSankeyHighlight.selectorIsLinkHighlighted, link);
-  const isFaded = store.use(_useSankeyHighlight.selectorIsSankeyItemFaded, isHighlighted);
+  const isHighlighted = store.use(_internals.selectorChartsIsHighlighted, linkIdentifier);
+  const isFaded = store.use(_internals.selectorChartsIsFaded, linkIdentifier);
 
   // eslint-disable-next-line no-nested-ternary
   return isHighlighted ? 'highlighted' : isFaded ? 'faded' : 'none';

package/SankeyChart/sankeyHighlightHooks.mjs

@@ -0,0 +1,17 @@
+import { selectorChartsIsFaded, selectorChartsIsHighlighted, useStore } from '@mui/x-charts/internals';
+export function useSankeyNodeHighlightState(nodeIdentifier) {
+  const store = useStore();
+  const isHighlighted = store.use(selectorChartsIsHighlighted, nodeIdentifier);
+  const isFaded = store.use(selectorChartsIsFaded, nodeIdentifier);
+
+  // eslint-disable-next-line no-nested-ternary
+  return isHighlighted ? 'highlighted' : isFaded ? 'faded' : 'none';
+}
+export function useSankeyLinkHighlightState(linkIdentifier) {
+  const store = useStore();
+  const isHighlighted = store.use(selectorChartsIsHighlighted, linkIdentifier);
+  const isFaded = store.use(selectorChartsIsFaded, linkIdentifier);
+
+  // eslint-disable-next-line no-nested-ternary
+  return isHighlighted ? 'highlighted' : isFaded ? 'faded' : 'none';
+}

package/SankeyChart/sankeySlots.types.d.mts

@@ -0,0 +1,18 @@
+import { type ChartsOverlaySlotProps, type ChartsOverlaySlots } from '@mui/x-charts/ChartsOverlay';
+import { type ChartsTooltipSlotProps, type ChartsTooltipSlots } from '@mui/x-charts/ChartsTooltip';
+import { type ChartsSlotProps, type ChartsSlots } from '@mui/x-charts/internals';
+import { type ChartsToolbarSlotProps, type ChartsToolbarSlots } from '@mui/x-charts/Toolbar';
+export interface SankeyChartSlots extends ChartsTooltipSlots<'item' | 'none'>, ChartsOverlaySlots, ChartsToolbarSlots, Partial<ChartsSlots> {}
+export interface SankeyChartSlotProps extends ChartsTooltipSlotProps<'item' | 'none'>, ChartsOverlaySlotProps, ChartsToolbarSlotProps, Partial<ChartsSlotProps> {}
+export interface SankeyChartSlotExtension {
+  /**
+   * Overridable component slots.
+   * @default {}
+   */
+  slots?: SankeyChartSlots;
+  /**
+   * The props used for each component slot.
+   * @default {}
+   */
+  slotProps?: SankeyChartSlotProps;
+}

package/SankeyChart/sankeySlots.types.d.ts

@@ -1,15 +1,9 @@
 import { type ChartsOverlaySlotProps, type ChartsOverlaySlots } from '@mui/x-charts/ChartsOverlay';
-import { type ChartsTooltipProps, type ChartsTooltipSlotProps, type ChartsTooltipSlots } from '@mui/x-charts/ChartsTooltip';
+import { type ChartsTooltipSlotProps, type ChartsTooltipSlots } from '@mui/x-charts/ChartsTooltip';
 import { type ChartsSlotProps, type ChartsSlots } from '@mui/x-charts/internals';
 import { type ChartsToolbarSlotProps, type ChartsToolbarSlots } from '@mui/x-charts/Toolbar';
-export interface SankeyChartSlots extends ChartsTooltipSlots, ChartsOverlaySlots, ChartsToolbarSlots, Partial<ChartsSlots> {}
-export interface SankeyChartSlotProps extends Omit<ChartsTooltipSlotProps, 'tooltip'>, ChartsOverlaySlotProps, ChartsToolbarSlotProps, Partial<ChartsSlotProps> {
-  /**
-   * Slot props for the tooltip component.
-   * @default {}
-   */
-  tooltip?: Partial<ChartsTooltipProps<'item' | 'none'>>;
-}
+export interface SankeyChartSlots extends ChartsTooltipSlots<'item' | 'none'>, ChartsOverlaySlots, ChartsToolbarSlots, Partial<ChartsSlots> {}
+export interface SankeyChartSlotProps extends ChartsTooltipSlotProps<'item' | 'none'>, ChartsOverlaySlotProps, ChartsToolbarSlotProps, Partial<ChartsSlotProps> {}
 export interface SankeyChartSlotExtension {
   /**
    * Overridable component slots.

package/SankeyChart/seriesConfig/createIsFaded.d.mts

@@ -0,0 +1,3 @@
+import type { HighlightItemIdentifierWithType } from '@mui/x-charts/models';
+import type { SankeyHighlightScope } from "../sankey.highlight.types.mjs";
+export declare function createSankeyIsFaded(highlightScope: SankeyHighlightScope | null | undefined, highlightedItem: HighlightItemIdentifierWithType<'sankey'> | null): (item: HighlightItemIdentifierWithType<"sankey"> | null) => boolean;

package/SankeyChart/seriesConfig/createIsFaded.d.ts

@@ -0,0 +1,3 @@
+import type { HighlightItemIdentifierWithType } from '@mui/x-charts/models';
+import type { SankeyHighlightScope } from "../sankey.highlight.types.js";
+export declare function createSankeyIsFaded(highlightScope: SankeyHighlightScope | null | undefined, highlightedItem: HighlightItemIdentifierWithType<'sankey'> | null): (item: HighlightItemIdentifierWithType<"sankey"> | null) => boolean;

package/SankeyChart/seriesConfig/createIsFaded.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSankeyIsFaded = createSankeyIsFaded;
+var _createIsHighlighted = require("./createIsHighlighted");
+const DEFAULT_FADE = 'none';
+function alwaysFalse() {
+  return false;
+}
+function createSankeyIsFaded(highlightScope, highlightedItem) {
+  if (!highlightedItem) {
+    return alwaysFalse;
+  }
+  const nodeFade = highlightScope?.nodes?.fade ?? DEFAULT_FADE;
+  const linkFade = highlightScope?.links?.fade ?? DEFAULT_FADE;
+  const isHighlighted = (0, _createIsHighlighted.createSankeyIsHighlighted)(highlightScope, highlightedItem);
+  return function isFaded(item) {
+    if (!item || item.type !== 'sankey') {
+      return false;
+    }
+    if (isHighlighted(item)) {
+      return false;
+    }
+    const fadeMode = highlightedItem.subType === 'node' ? nodeFade : linkFade;
+    return fadeMode === 'global';
+  };
+}

package/SankeyChart/seriesConfig/createIsFaded.mjs

@@ -0,0 +1,23 @@
+import { createSankeyIsHighlighted } from "./createIsHighlighted.mjs";
+const DEFAULT_FADE = 'none';
+function alwaysFalse() {
+  return false;
+}
+export function createSankeyIsFaded(highlightScope, highlightedItem) {
+  if (!highlightedItem) {
+    return alwaysFalse;
+  }
+  const nodeFade = highlightScope?.nodes?.fade ?? DEFAULT_FADE;
+  const linkFade = highlightScope?.links?.fade ?? DEFAULT_FADE;
+  const isHighlighted = createSankeyIsHighlighted(highlightScope, highlightedItem);
+  return function isFaded(item) {
+    if (!item || item.type !== 'sankey') {
+      return false;
+    }
+    if (isHighlighted(item)) {
+      return false;
+    }
+    const fadeMode = highlightedItem.subType === 'node' ? nodeFade : linkFade;
+    return fadeMode === 'global';
+  };
+}

package/SankeyChart/seriesConfig/createIsHighlighted.d.mts

@@ -0,0 +1,4 @@
+import type { ChartSeriesType } from '@mui/x-charts/internals';
+import type { HighlightItemIdentifierWithType } from '@mui/x-charts/models';
+import type { SankeyHighlightScope } from "../sankey.highlight.types.mjs";
+export declare function createSankeyIsHighlighted(highlightScope: SankeyHighlightScope | null | undefined, highlightedItem: HighlightItemIdentifierWithType<'sankey'> | null): (item: HighlightItemIdentifierWithType<ChartSeriesType> | null) => boolean;

package/SankeyChart/seriesConfig/createIsHighlighted.d.ts

@@ -0,0 +1,4 @@
+import type { ChartSeriesType } from '@mui/x-charts/internals';
+import type { HighlightItemIdentifierWithType } from '@mui/x-charts/models';
+import type { SankeyHighlightScope } from "../sankey.highlight.types.js";
+export declare function createSankeyIsHighlighted(highlightScope: SankeyHighlightScope | null | undefined, highlightedItem: HighlightItemIdentifierWithType<'sankey'> | null): (item: HighlightItemIdentifierWithType<ChartSeriesType> | null) => boolean;

package/SankeyChart/seriesConfig/createIsHighlighted.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSankeyIsHighlighted = createSankeyIsHighlighted;
+const DEFAULT_NODE_HIGHLIGHT = 'links';
+const DEFAULT_LINK_HIGHLIGHT = 'links';
+function alwaysFalse() {
+  return false;
+}
+function isNodeHighlighted(highlightedItem, nodeHighlight, linkHighlight, item) {
+  if (item.subType !== 'node') {
+    return false;
+  }
+  const nodeId = item.nodeId;
+  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;
+}
+function isLinkHighlighted(highlightedItem, nodeHighlight, linkHighlight, item) {
+  if (item.subType !== 'link') {
+    return false;
+  }
+  const {
+    sourceId,
+    targetId
+  } = item;
+  if (highlightedItem.subType === 'link' && highlightedItem.sourceId === sourceId && highlightedItem.targetId === targetId) {
+    return linkHighlight !== 'none';
+  }
+  if (highlightedItem.subType === 'node') {
+    if (!nodeHighlight || nodeHighlight === 'none' || nodeHighlight === 'nodes') {
+      return false;
+    }
+    const highlightedNodeId = highlightedItem.nodeId;
+    switch (nodeHighlight) {
+      case 'links':
+        return sourceId === highlightedNodeId || targetId === highlightedNodeId;
+      case 'incoming':
+        return targetId === highlightedNodeId;
+      case 'outgoing':
+        return sourceId === highlightedNodeId;
+      default:
+        return false;
+    }
+  }
+  return false;
+}
+function createSankeyIsHighlighted(highlightScope, highlightedItem) {
+  if (!highlightedItem) {
+    return alwaysFalse;
+  }
+  const nodeHighlight = highlightScope?.nodes?.highlight ?? DEFAULT_NODE_HIGHLIGHT;
+  const linkHighlight = highlightScope?.links?.highlight ?? DEFAULT_LINK_HIGHLIGHT;
+  return function isHighlighted(item) {
+    if (!item || item.type !== 'sankey') {
+      return false;
+    }
+    const sankeyItem = item;
+    if (sankeyItem.subType === 'node') {
+      return isNodeHighlighted(highlightedItem, nodeHighlight, linkHighlight, sankeyItem);
+    }
+    if (sankeyItem.subType === 'link') {
+      return isLinkHighlighted(highlightedItem, nodeHighlight, linkHighlight, sankeyItem);
+    }
+    return false;
+  };
+}

package/SankeyChart/seriesConfig/createIsHighlighted.mjs

@@ -0,0 +1,83 @@
+const DEFAULT_NODE_HIGHLIGHT = 'links';
+const DEFAULT_LINK_HIGHLIGHT = 'links';
+function alwaysFalse() {
+  return false;
+}
+function isNodeHighlighted(highlightedItem, nodeHighlight, linkHighlight, item) {
+  if (item.subType !== 'node') {
+    return false;
+  }
+  const nodeId = item.nodeId;
+  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;
+}
+function isLinkHighlighted(highlightedItem, nodeHighlight, linkHighlight, item) {
+  if (item.subType !== 'link') {
+    return false;
+  }
+  const {
+    sourceId,
+    targetId
+  } = item;
+  if (highlightedItem.subType === 'link' && highlightedItem.sourceId === sourceId && highlightedItem.targetId === targetId) {
+    return linkHighlight !== 'none';
+  }
+  if (highlightedItem.subType === 'node') {
+    if (!nodeHighlight || nodeHighlight === 'none' || nodeHighlight === 'nodes') {
+      return false;
+    }
+    const highlightedNodeId = highlightedItem.nodeId;
+    switch (nodeHighlight) {
+      case 'links':
+        return sourceId === highlightedNodeId || targetId === highlightedNodeId;
+      case 'incoming':
+        return targetId === highlightedNodeId;
+      case 'outgoing':
+        return sourceId === highlightedNodeId;
+      default:
+        return false;
+    }
+  }
+  return false;
+}
+export function createSankeyIsHighlighted(highlightScope, highlightedItem) {
+  if (!highlightedItem) {
+    return alwaysFalse;
+  }
+  const nodeHighlight = highlightScope?.nodes?.highlight ?? DEFAULT_NODE_HIGHLIGHT;
+  const linkHighlight = highlightScope?.links?.highlight ?? DEFAULT_LINK_HIGHLIGHT;
+  return function isHighlighted(item) {
+    if (!item || item.type !== 'sankey') {
+      return false;
+    }
+    const sankeyItem = item;
+    if (sankeyItem.subType === 'node') {
+      return isNodeHighlighted(highlightedItem, nodeHighlight, linkHighlight, sankeyItem);
+    }
+    if (sankeyItem.subType === 'link') {
+      return isLinkHighlighted(highlightedItem, nodeHighlight, linkHighlight, sankeyItem);
+    }
+    return false;
+  };
+}

package/SankeyChart/seriesConfig/getSeriesWithDefaultValues.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getSeriesWithDefaultValues = void 0;
+var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _d3Sankey = require("../d3Sankey");
 var _utils = require("../utils");
@@ -103,7 +104,7 @@ const getSeriesWithDefaultValues = (seriesData, seriesIndex, colors) => {
     // 2. If there are missing source/target nodes, d3-sankey will throw an error.
     // We handle the second case by building a map of nodes ourselves, so they are always present.
     if (error instanceof Error && error.message === 'circular link') {
-      throw new Error('MUI X Charts: Sankey diagram contains circular references.');
+      throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X Charts: Sankey diagram contains circular references.' : (0, _formatErrorMessage2.default)(47));
     }
     throw error;
   }