@mui/x-charts-pro 8.21.0 → 8.22.1

package/SankeyChart/d3Sankey/sankey.d.ts

@@ -7,7 +7,7 @@ import type { SankeyExtraProperties, SankeyGraph, SankeyLayout } from "./sankey.
  *
  * Default nodes/links accessors are assumed.
  */
-export declare function sankey(): SankeyLayout<SankeyGraph<{}, {}>, {}, {}>;
+export declare function sankey<WithPosition extends boolean>(withoutPositions?: WithPosition): SankeyLayout<WithPosition, SankeyGraph<WithPosition, {}, {}>, {}, {}>;
 /**
  * Get a Sankey layout generator.
  *
@@ -21,7 +21,7 @@ export declare function sankey(): SankeyLayout<SankeyGraph<{}, {}>, {}, {}>;
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export declare function sankey<N extends SankeyExtraProperties, L extends SankeyExtraProperties>(): SankeyLayout<SankeyGraph<N, L>, N, L>;
+export declare function sankey<N extends SankeyExtraProperties, L extends SankeyExtraProperties, WithPosition extends boolean>(withoutPositions?: WithPosition): SankeyLayout<WithPosition, SankeyGraph<WithPosition, N, L>, N, L>;
 /**
  * Get a Sankey layout generator.
  *
@@ -39,4 +39,4 @@ export declare function sankey<N extends SankeyExtraProperties, L extends Sankey
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export declare function sankey<Data, N extends SankeyExtraProperties, L extends SankeyExtraProperties>(): SankeyLayout<Data, N, L>;
+export declare function sankey<Data, N extends SankeyExtraProperties, L extends SankeyExtraProperties, WithPosition extends boolean>(withPositions?: WithPosition): SankeyLayout<WithPosition, Data, N, L>;

package/SankeyChart/d3Sankey/sankey.js

@@ -101,7 +101,7 @@ function computeLinkBreadths({
  * SankeyLinkMinimal interface.
  */
 
-function sankey() {
+function sankey(withPositions) {
   let x0 = 0,
     y0 = 0,
     x1 = 1,
@@ -127,6 +127,9 @@ function sankey() {
     computeNodeValues(graph);
     computeNodeDepths(graph);
     computeNodeHeights(graph);
+    if (!withPositions) {
+      return graph;
+    }
     computeNodeBreadths(graph);
     computeLinkBreadths(graph);
     return graph;

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

@@ -10,25 +10,27 @@ export interface SankeyExtraProperties {
  * Helper interface to define the properties of Sankey Nodes. Calculated properties may only be defined,
  * once the layout(...) method of the Sankey layout generator has been invoked.
  *
+ * Those properties correspond to a SankyNode generated by `sankey(withoutPositions=true)`.
+ *
  * The first generic N refers to user-defined properties contained in the node data passed into
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
- * SankeyNodeMinimal interface.
+ * SankeyNodeStrictMinimal interface.
  *
  * The second generic L refers to user-defined properties contained in the link data passed into
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
- * SankeyLinkMinimal interface.
+ * SankeyLinkStrictMinimal interface.
  */
-export interface SankeyNodeMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
+export interface SankeyNodeStrictMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
   /**
    * Array of outgoing links which have this node as their source.
    * This property is calculated internally by the Sankey layout generator.
    */
-  sourceLinks?: Array<SankeyLink<N, L>> | undefined;
+  sourceLinks?: Array<SankeyLinkStrictMinimal<N, L>> | undefined;
   /**
    * Array of incoming links which have this node as their target.
    * This property is calculated internally by the Sankey layout generator.
    */
-  targetLinks?: Array<SankeyLink<N, L>> | undefined;
+  targetLinks?: Array<SankeyLinkStrictMinimal<N, L>> | undefined;
   /**
    * Node's value calculated by Sankey layout Generator;
    * the sum of link.value for the node's incoming links.
@@ -50,6 +52,12 @@ export interface SankeyNodeMinimal<N extends SankeyExtraProperties, L extends Sa
    * Node's zero-based graph height, derived from the graph topology calculated by Sankey layout generator.
    */
   height?: number | undefined;
+  /**
+   * Link's layer in case of layered layout, calculated by Sankey layout generator.
+   */
+  layer?: number | undefined;
+}
+interface SankeyNodePosition {
   /**
    * Node's minimum horizontal position (derived from the node.depth) calculated by Sankey layout generator.
    */
@@ -66,11 +74,22 @@ export interface SankeyNodeMinimal<N extends SankeyExtraProperties, L extends Sa
    * Node's maximum vertical position (node.y1 - node.y0 is proportional to node.value) calculated by Sankey layout generator.
    */
   y1?: number | undefined;
-  /**
-   * Link's layer in case of layered layout, calculated by Sankey layout generator.
-   */
-  layer?: number | undefined;
 }
+/**
+ * Helper interface to define the properties of Sankey Nodes. Calculated properties may only be defined,
+ * once the layout(...) method of the Sankey layout generator has been invoked.
+ *
+ * Those properties correspond to a SankyNode generated by `sankey(withoutPositions=false)`.
+ *
+ * The first generic N refers to user-defined properties contained in the node data passed into
+ * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
+ * SankeyNodeMinimal interface.
+ *
+ * The second generic L refers to user-defined properties contained in the link data passed into
+ * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
+ * SankeyLinkMinimal interface.
+ */
+export interface SankeyNodeMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> extends SankeyNodeStrictMinimal<N & SankeyNode<true, N, L>, L & SankeyLink<true, N, L>>, SankeyNodePosition {}
 /**
  * Sankey Node type including both user-defined node data elements as well as those
  * calculated once the layout(...) method of the Sankey layout generators has been invoked.
@@ -83,11 +102,13 @@ export interface SankeyNodeMinimal<N extends SankeyExtraProperties, L extends Sa
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export type SankeyNode<N extends SankeyExtraProperties, L extends SankeyExtraProperties> = N & SankeyNodeMinimal<N, L>;
+export type SankeyNode<WithPosition extends boolean, N extends SankeyExtraProperties, L extends SankeyExtraProperties> = N & (WithPosition extends true ? SankeyNodeMinimal<N, L> : SankeyNodeStrictMinimal<N, L>);
 /**
  * Helper interface to define the properties of Sankey Links. Calculated properties may only be defined,
  * once the layout(...) method of the Sankey layout generator has been invoked.
  *
+ * Those properties correspond to a SankyLink generated by `sankey(withoutPositions=true)`.
+ *
  * The first generic N refers to user-defined properties contained in the node data passed into
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyNodeMinimal interface.
@@ -96,7 +117,7 @@ export type SankeyNode<N extends SankeyExtraProperties, L extends SankeyExtraPro
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
+export interface SankeyLinkStrictMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
   /**
    * Link's source node. For convenience, when initializing a Sankey layout using the default node id accessor,
    * source may be the zero-based index of the corresponding node in the nodes array
@@ -106,7 +127,7 @@ export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends Sa
    * Once the Sankey generator is invoked to return the Sankey graph object,
    * the numeric index will be replaced with the corresponding source node object.
    */
-  source: number | string | SankeyNode<N, L>;
+  source: number | string | SankeyNodeStrictMinimal<N, L>;
   /**
    * Link's target node. For convenience, when initializing a Sankey layout using the default node id accessor,
    * target may be the zero-based index of the corresponding node in the nodes array
@@ -116,11 +137,17 @@ export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends Sa
    * Once the Sankey generator is invoked to return the Sankey graph object,
    * the numeric index will be replaced with the corresponding target node object.
    */
-  target: number | string | SankeyNode<N, L>;
+  target: number | string | SankeyNodeStrictMinimal<N, L>;
   /**
    * Link's numeric value
    */
   value: number;
+  /**
+   * Link's zero-based index within the array of links calculated by Sankey layout generator.
+   */
+  index?: number | undefined;
+}
+interface SankeyLinkPosition {
   /**
    * Link's vertical starting position (at source node) calculated by Sankey layout generator.
    */
@@ -133,11 +160,20 @@ export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends Sa
    * Link's width (proportional to its value) calculated by Sankey layout generator.
    */
   width?: number | undefined;
-  /**
-   * Link's zero-based index within the array of links calculated by Sankey layout generator.
-   */
-  index?: number | undefined;
 }
+/**
+ * Helper interface to define the properties of Sankey Links. Calculated properties may only be defined,
+ * once the layout(...) method of the Sankey layout generator has been invoked.
+ *
+ * The first generic N refers to user-defined properties contained in the node data passed into
+ * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
+ * SankeyNodeMinimal interface.
+ *
+ * The second generic L refers to user-defined properties contained in the link data passed into
+ * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
+ * SankeyLinkMinimal interface.
+ */
+export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends SankeyExtraProperties> extends SankeyLinkStrictMinimal<N & SankeyNode<true, N, L>, L & SankeyLink<true, N, L>>, SankeyLinkPosition {}
 /**
  * Sankey Link type including both user-defined link data elements, those required by the Sankey layout generator,
  *  as well as those calculated once the layout(...) method of the layout generator has been invoked.
@@ -150,7 +186,7 @@ export interface SankeyLinkMinimal<N extends SankeyExtraProperties, L extends Sa
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export type SankeyLink<N extends SankeyExtraProperties, L extends SankeyExtraProperties> = L & SankeyLinkMinimal<N, L>;
+export type SankeyLink<WithPosition extends boolean, N extends SankeyExtraProperties, L extends SankeyExtraProperties> = L & (WithPosition extends true ? SankeyLinkMinimal<N, L> : SankeyLinkStrictMinimal<N, L>);
 /**
  * A Sankey Graph Object which contains the computed layout information for nodes and links.
  *
@@ -162,15 +198,15 @@ export type SankeyLink<N extends SankeyExtraProperties, L extends SankeyExtraPro
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export interface SankeyGraph<N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
+export interface SankeyGraph<WithPosition extends boolean, N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
   /**
    * Array of Sankey diagram nodes
    */
-  nodes: Array<SankeyNode<N, L>>;
+  nodes: Array<SankeyNode<WithPosition, N, L>>;
   /**
    * Array of Sankey diagram links
    */
-  links: Array<SankeyLink<N, L>>;
+  links: Array<SankeyLink<WithPosition, N, L>>;
 }
 /**
  * A Sankey layout generator.
@@ -186,14 +222,14 @@ export interface SankeyGraph<N extends SankeyExtraProperties, L extends SankeyEx
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export interface SankeyLayout<Data, N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
+export interface SankeyLayout<WithPosition extends boolean, Data, N extends SankeyExtraProperties, L extends SankeyExtraProperties> {
   /**
    * Computes the node and link positions for the given arguments, returning a graph representing the Sankey layout.
    *
    * @param data Data object being passed as the first argument to the nodes and links accessor functions. Additional arguments will also be passed
    * to the accessor functions.
    */
-  (data: Data, ...args: any[]): SankeyGraph<N, L>;
+  (data: Data, ...args: any[]): SankeyGraph<WithPosition, N, L>;
   /**
    * Recomputes the specified graph's links' positions, updating the following properties of each link:
    *
@@ -204,48 +240,48 @@ export interface SankeyLayout<Data, N extends SankeyExtraProperties, L extends S
    *
    * @param graph A previously initialized Sankey graph for which the link positions should be re-calculated
    */
-  update(graph: SankeyGraph<N, L>): SankeyGraph<N, L>;
+  update(graph: SankeyGraph<WithPosition, N, L>): SankeyGraph<WithPosition, N, L>;
   /**
    * Return the current nodes accessor function, which defaults to a function returning the "nodes" property of the
    * first argument it is invoked with.
    */
-  nodes(): (data: Data, ...args: any[]) => Array<SankeyNode<N, L>>;
+  nodes(): (data: Data, ...args: any[]) => Array<SankeyNode<WithPosition, N, L>>;
   /**
    * Set the Sankey generator's nodes accessor to a function returning the specified array of objects and returns this Sankey layout generator.
    *
    * @param nodes Array of nodes.
    */
-  nodes(nodes: Array<SankeyNode<N, L>>): this;
+  nodes(nodes: Array<SankeyNode<WithPosition, N, L>>): this;
   /**
    * Set the Sankey generator's nodes accessor to the specified function and returns this Sankey layout generator.
    *
    * @param nodes A nodes accessor function. The function is invoked when the Sankey layout is generated, being passed any arguments passed to the Sankey generator.
    * This function must return an array of nodes.
    */
-  nodes(nodes: (data: Data, ...args: any[]) => Array<SankeyNode<N, L>>): this;
+  nodes(nodes: (data: Data, ...args: any[]) => Array<SankeyNode<WithPosition, N, L>>): this;
   /**
    * Return the current links accessor function, which defaults to a function returning the "links" property of the
    * first argument it is invoked with.
    */
-  links(): (data: Data, ...args: any[]) => Array<SankeyLink<N, L>>;
+  links(): (data: Data, ...args: any[]) => Array<SankeyLink<WithPosition, N, L>>;
   /**
    * Set the Sankey generator's links accessor to a function returning the specified array of objects and returns this Sankey layout generator.
    *
    * @param links Array of links.
    */
-  links(links: Array<SankeyLink<N, L>>): this;
+  links(links: Array<SankeyLink<WithPosition, N, L>>): this;
   /**
    * Set the Sankey generator's links accessor to the specified function and returns this Sankey layout generator.
    *
    * @param links A links accessor function. The function is invoked when the Sankey layout is generated, being passed any arguments passed to the Sankey generator.
    * This function must return an array of links.
    */
-  links(links: (data: Data, ...args: any[]) => Array<SankeyLink<N, L>>): this;
+  links(links: (data: Data, ...args: any[]) => Array<SankeyLink<WithPosition, N, L>>): this;
   /**
    * Return the current node id accessor.
    * The default accessor is a function being passed in a Sankey layout node and returning its numeric node.index.
    */
-  nodeId(): (node: SankeyNode<N, L>) => string | number;
+  nodeId(): (node: SankeyNode<WithPosition, N, L>) => string | number;
   /**
    * Set the node id accessor to the specified function and return this Sankey layout generator.
    *
@@ -254,11 +290,11 @@ export interface SankeyLayout<Data, N extends SankeyExtraProperties, L extends S
    *
    * @param nodeId A node id accessor function being passed a node in the Sankey graph and returning its id.
    */
-  nodeId(nodeId: (node: SankeyNode<N, L>) => string | number): this;
+  nodeId(nodeId: (node: SankeyNode<WithPosition, N, L>) => string | number): this;
   /**
    * Return the current node alignment method, which defaults to d3.sankeyJustify.
    */
-  nodeAlign(): (node: SankeyNode<N, L>, n: number) => number;
+  nodeAlign(): (node: SankeyNode<WithPosition, N, L>, n: number) => number;
   /**
    * Set the node alignment method the specified function and return this Sankey layout generator.
    *
@@ -266,7 +302,7 @@ export interface SankeyLayout<Data, N extends SankeyExtraProperties, L extends S
    * being passed the current node and the total depth n of the graph (one plus the maximum node.depth),
    * and must return an integer between 0 and n - 1 that indicates the desired horizontal position of the node in the generated Sankey diagram.
    */
-  nodeAlign(nodeAlign: (node: SankeyNode<N, L>, n: number) => number): this;
+  nodeAlign(nodeAlign: (node: SankeyNode<WithPosition, N, L>, n: number) => number): this;
   /**
    * Return the current node width, which defaults to 24.
    */
@@ -324,21 +360,22 @@ export interface SankeyLayout<Data, N extends SankeyExtraProperties, L extends S
   /**
    * Returns the node comparison function which defaults to undefined.
    */
-  nodeSort(): ((a: SankeyNode<N, L>, b: SankeyNode<N, L>) => number) | undefined | null;
+  nodeSort(): ((a: SankeyNode<WithPosition, N, L>, b: SankeyNode<WithPosition, N, L>) => number) | undefined | null;
   /**
    * Set the node comparison function and return this Sankey layout generator.
    *
    * @param compare Node comparison function. If `null`, the order is fixed by the input.
    */
-  nodeSort(compare: ((a: SankeyNode<N, L>, b: SankeyNode<N, L>) => number) | undefined | null): this;
+  nodeSort(compare: ((a: SankeyNode<WithPosition, N, L>, b: SankeyNode<WithPosition, N, L>) => number) | undefined | null): this;
   /**
    * Returns the link comparison function which defaults to undefined.
    */
-  linkSort(): ((a: SankeyLink<N, L>, b: SankeyLink<N, L>) => number) | undefined | null;
+  linkSort(): ((a: SankeyLink<WithPosition, N, L>, b: SankeyLink<WithPosition, N, L>) => number) | undefined | null;
   /**
    * Set the link comparison function and return this Sankey layout generator.
    *
    * @param compare Link comparison function. If `null`, the order is fixed by the input.
    */
-  linkSort(compare: ((a: SankeyLink<N, L>, b: SankeyLink<N, L>) => number) | undefined | null): this;
-}
+  linkSort(compare: ((a: SankeyLink<WithPosition, N, L>, b: SankeyLink<WithPosition, N, L>) => number) | undefined | null): this;
+}
+export {};

package/SankeyChart/d3Sankey/sankeyLinkHorizontal.d.ts

@@ -5,7 +5,7 @@ import type { SankeyExtraProperties, SankeyLink } from "./sankey.types.js";
  * Source and target accessors are pre-configured and work with the
  * default x- and y- accessors of the link shape generator.
  */
-export declare function sankeyLinkHorizontal(): Link<any, SankeyLink<{}, {}>, [number, number]>;
+export declare function sankeyLinkHorizontal(): Link<any, SankeyLink<true, {}, {}>, [number, number]>;
 /**
  * Get a horizontal link shape suitable for a Sankey diagram.
  * Source and target accessors are pre-configured and work with the
@@ -19,4 +19,4 @@ export declare function sankeyLinkHorizontal(): Link<any, SankeyLink<{}, {}>, [n
  * Sankey layout generator. These properties are IN EXCESS to the properties explicitly identified in the
  * SankeyLinkMinimal interface.
  */
-export declare function sankeyLinkHorizontal<N extends SankeyExtraProperties, L extends SankeyExtraProperties>(): Link<any, SankeyLink<N, L>, [number, number]>;
+export declare function sankeyLinkHorizontal<N extends SankeyExtraProperties, L extends SankeyExtraProperties>(): Link<any, SankeyLink<true, N, L>, [number, number]>;

package/SankeyChart/plugins/useSankeyHighlight.d.ts

@@ -1,4 +1,4 @@
-import { ChartPlugin } from '@mui/x-charts/internals';
+import { type ChartPlugin } from '@mui/x-charts/internals';
 import type { UseSankeyHighlightSignature } from "./useSankeyHighlight.types.js";
 /**
  * Custom highlight plugin for Sankey charts that uses SankeyItemIdentifier

package/SankeyChart/plugins/useSankeyHighlight.js

@@ -39,7 +39,7 @@ const useSankeyHighlight = ({
     }));
   });
   const setHighlight = (0, _useEventCallback.default)(newItem => {
-    const prevItem = store.getSnapshot().highlight.item;
+    const prevItem = store.state.highlight.item;
     if ((0, _fastObjectShallowCompare.fastObjectShallowCompare)(prevItem, newItem)) {
       return;
     }

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

@@ -1,4 +1,4 @@
-import type { SankeyLayoutLink, SankeyNodeId } from "../sankey.types.js";
+import type { SankeyNodeId } from "../sankey.types.js";
 import type { SankeyLinkFade, SankeyLinkHighlight, SankeyNodeFade, SankeyNodeHighlight } from "../sankey.highlight.types.js";
 /**
  * Get the node highlight configuration from the Sankey series.
@@ -51,7 +51,7 @@ export declare const selectorIsNodeHighlighted: (args_0: import("@mui/x-charts/i
  */
 export declare const selectorIsLinkHighlighted: (args_0: 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;
-}, link: SankeyLayoutLink) => boolean;
+}, link: import("../index.js").SankeyLayoutLinkWithPosition) => boolean;
 /**
  * Selector that determines if an item should be faded.
  * An item is faded if:

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

@@ -1,6 +1,6 @@
-import { DefaultizedProps } from '@mui/x-internals/types';
-import { ChartPluginSignature } from '@mui/x-charts/internals';
-import { SankeyItemIdentifier } from "../sankey.types.js";
+import { type DefaultizedProps } from '@mui/x-internals/types';
+import { type ChartPluginSignature } from '@mui/x-charts/internals';
+import { type SankeyItemIdentifier } from "../sankey.types.js";
 /**
  * The data of the highlighted item in a Sankey chart.
  * Can be either a node or a link.

package/SankeyChart/sankey.types.d.ts

@@ -86,7 +86,7 @@ export type SankeyNodeOptions = {
    *
    * @default 'auto'
    */
-  sort?: 'auto' | 'fixed' | ((a: SankeyLayoutNode, b: SankeyLayoutNode) => number);
+  sort?: 'auto' | 'fixed' | ((a: SankeyLayoutNode<true>, b: SankeyLayoutNode<true>) => number);
 } & SankeyNodeHighlightScope;
 export type SankeyLinkOptions = {
   /**
@@ -117,7 +117,7 @@ export type SankeyLinkOptions = {
    * @returns {number} Comparison result
      * @default 'auto'
    */
-  sort?: 'auto' | 'fixed' | ((a: SankeyLayoutLink, b: SankeyLayoutLink) => number);
+  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.
@@ -180,34 +180,42 @@ export interface SankeySeriesType {
    */
   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 interface SankeyLayoutNode extends D3SankeyNode<MakeRequired<SankeyNode, 'label' | 'color'>, SankeyLayoutLink> {
-  targetLinks: SankeyLayoutLink[];
-  sourceLinks: SankeyLayoutLink[];
-  value: number;
-}
+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 interface SankeyLayoutLink extends D3SankeyLink<SankeyLayoutNode, Omit<MakeRequired<SankeyLink, 'color'>, 'source' | 'target'>> {
-  path?: string | null;
-  source: SankeyLayoutNode;
-  target: SankeyLayoutNode;
-}
+export type SankeyLayoutLink<WithPosition extends boolean = true> = WithPosition extends true ? SankeyLayoutLinkWithPosition : SankeyLayoutLinkWithoutPosition;
 /**
  * Calculated layout for the Sankey diagram
  */
-export interface SankeyLayout {
-  nodes: readonly SankeyLayoutNode[];
-  links: readonly SankeyLayoutLink[];
+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: {
-    nodes: Map<SankeyNodeId, SankeyNode>;
-    links: readonly SankeyLink[];
-  };
+  data: SankeyLayout<false>;
   highlightScope?: HighlightScope;
 }
 type SankeyNodeIdentifierBase = {
@@ -227,11 +235,11 @@ export type SankeyNodeIdentifier = SankeyNodeIdentifierBase & {
    */
   nodeId: SankeyNodeId;
 };
-export type SankeyNodeIdentifierWithData = SankeyNodeIdentifier & {
+export type SankeyNodeIdentifierWithData<WithPosition extends boolean = true> = SankeyNodeIdentifier & {
   /**
    * The node object with all the calculated properties
    */
-  node: SankeyLayoutNode;
+  node: SankeyLayoutNode<WithPosition>;
 };
 export type SankeyLinkIdentifier = SankeyNodeIdentifierBase & {
   /**
@@ -247,14 +255,14 @@ export type SankeyLinkIdentifier = SankeyNodeIdentifierBase & {
    */
   targetId: SankeyNodeId;
 };
-export type SankeyLinkIdentifierWithData = SankeyLinkIdentifier & {
+export type SankeyLinkIdentifierWithData<WithPosition extends boolean = true> = SankeyLinkIdentifier & {
   /**
    * The link object with all the calculated properties
    */
-  link: SankeyLayoutLink;
+  link: SankeyLayoutLink<WithPosition>;
 };
 export type SankeyItemIdentifier = SankeyNodeIdentifier | SankeyLinkIdentifier;
-export type SankeyItemIdentifierWithData = SankeyNodeIdentifierWithData | SankeyLinkIdentifierWithData;
+export type SankeyItemIdentifierWithData<WithPosition extends boolean = true> = SankeyNodeIdentifierWithData<WithPosition> | SankeyLinkIdentifierWithData<WithPosition>;
 export type SankeyValueFormatterContext = {
   /**
    * Where the value will be displayed

package/SankeyChart/sankeyClasses.d.ts

@@ -3,6 +3,8 @@ export interface SankeyPlotClasses {
   root: string;
   /** Styles applied to the nodes container. */
   nodes: string;
+  /** Styles applied to the node label container. */
+  nodeLabels: string;
   /** Styles applied to the links container. */
   links: string;
   /** Styles applied to the link label container. */
@@ -12,4 +14,4 @@ export declare function getSankeyPlotUtilityClass(slot: string): string;
 export declare const sankeyPlotClasses: SankeyPlotClasses;
 export declare const useUtilityClasses: (ownerState: {
   classes?: Partial<SankeyPlotClasses>;
-}) => Record<"nodes" | "links" | "root" | "linkLabels", string>;
+}) => Record<"nodes" | "links" | "root" | "nodeLabels" | "linkLabels", string>;

package/SankeyChart/sankeyClasses.js

@@ -12,7 +12,7 @@ var _generateUtilityClasses = _interopRequireDefault(require("@mui/utils/generat
 function getSankeyPlotUtilityClass(slot) {
   return (0, _generateUtilityClass.default)('MuiSankeyChart', slot);
 }
-const sankeyPlotClasses = exports.sankeyPlotClasses = (0, _generateUtilityClasses.default)('MuiSankeyChart', ['root', 'nodes', 'links', 'linkLabels']);
+const sankeyPlotClasses = exports.sankeyPlotClasses = (0, _generateUtilityClasses.default)('MuiSankeyChart', ['root', 'nodes', 'nodeLabels', 'links', 'linkLabels']);
 const useUtilityClasses = ownerState => {
   const {
     classes
@@ -20,6 +20,7 @@ const useUtilityClasses = ownerState => {
   const slots = {
     root: ['root'],
     nodes: ['nodes'],
+    nodeLabels: ['nodeLabels'],
     links: ['links'],
     linkLabels: ['linkLabels']
   };

package/SankeyChart/sankeySlots.types.d.ts

@@ -1,7 +1,7 @@
-import { ChartsOverlaySlotProps, ChartsOverlaySlots } from '@mui/x-charts/ChartsOverlay';
-import { ChartsTooltipProps, ChartsTooltipSlotProps, ChartsTooltipSlots } from '@mui/x-charts/ChartsTooltip';
-import { ChartsSlotProps, ChartsSlots } from '@mui/x-charts/internals';
-import { ChartsToolbarSlotProps, ChartsToolbarSlots } from '@mui/x-charts/Toolbar';
+import { type ChartsOverlaySlotProps, type ChartsOverlaySlots } from '@mui/x-charts/ChartsOverlay';
+import { type ChartsTooltipProps, 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> {
   /**