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

package/SankeyChart/plugins/useSankeyHighlight.js

@@ -1,72 +0,0 @@
-"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)(() => {
-    if (store.state.highlight.item !== params.highlightedItem) {
-      store.set('highlight', (0, _extends2.default)({}, store.state.highlight, {
-        item: params.highlightedItem
-      }));
-    }
-  }, [store, params.highlightedItem]);
-  const clearHighlight = (0, _useEventCallback.default)(() => {
-    params.onHighlightChange?.(null);
-    store.set('highlight', (0, _extends2.default)({}, store.state.highlight, {
-      item: null
-    }));
-  });
-  const setHighlight = (0, _useEventCallback.default)(newItem => {
-    const prevItem = store.state.highlight.item;
-    if ((0, _fastObjectShallowCompare.fastObjectShallowCompare)(prevItem, newItem)) {
-      return;
-    }
-    params.onHighlightChange?.(newItem);
-    store.set('highlight', (0, _extends2.default)({}, store.state.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

@@ -1,64 +0,0 @@
-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.
- * Defaults to 'nodes' if not specified.
- */
-export declare const selectorNodeHighlightConfig: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}) => SankeyNodeHighlight;
-/**
- * Get the node fade configuration from the Sankey series.
- * Defaults to 'none' if not specified.
- */
-export declare const selectorNodeFadeConfig: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}) => SankeyNodeFade;
-/**
- * Get the link highlight configuration from the Sankey series.
- * Defaults to 'links' if not specified.
- */
-export declare const selectorLinkHighlightConfig: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}) => SankeyLinkHighlight;
-/**
- * Get the link fade configuration from the Sankey series.
- * Defaults to 'none' if not specified.
- */
-export declare const selectorLinkFadeConfig: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}) => SankeyLinkFade;
-/**
- * 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: (args_0: import("./useSankeyHighlight.types.js").UseSankeyHighlightState) => 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: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}, nodeId: SankeyNodeId) => boolean;
-/**
- * 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: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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: import("../index.js").SankeyLayoutLinkWithPosition) => boolean;
-/**
- * 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: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & 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;
-}, isHighlighted: boolean) => boolean;

package/SankeyChart/plugins/useSankeyHighlight.selectors.js

@@ -1,126 +0,0 @@
-"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 _store = require("@mui/x-internals/store");
-var _internals = require("@mui/x-charts/internals");
-const selectorSankeyHighlight = state => state.highlight;
-const selectorSankeySeries = (0, _store.createSelector)(_internals.selectorChartSeriesProcessed, processedSeries => processedSeries.sankey?.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, _store.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, _store.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, _store.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, _store.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, _store.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, _store.createSelector)(selectorSankeyHighlightedItem, selectorNodeHighlightConfig, selectorLinkHighlightConfig, (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, _store.createSelector)(selectorSankeyHighlightedItem, selectorNodeHighlightConfig, selectorLinkHighlightConfig, (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, _store.createSelector)(selectorSankeyHighlightedItem, selectorNodeFadeConfig, selectorLinkFadeConfig, (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

@@ -1,55 +0,0 @@
-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.
- *
- * @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

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

package/esm/BarChartPro/BarChartPro.d.ts

@@ -1,33 +0,0 @@
-import * as React from 'react';
-import { type BarChartProps, type BarChartSlotProps, type BarChartSlots } from '@mui/x-charts/BarChart';
-import { type ChartsToolbarProSlotProps, type ChartsToolbarProSlots } from "../ChartsToolbarPro/Toolbar.types.js";
-import { type ChartsSlotPropsPro, type ChartsSlotsPro } from "../internals/material/index.js";
-import { type ChartContainerProProps } from "../ChartContainerPro/index.js";
-import { type BarChartProPluginSignatures } from "./BarChartPro.plugins.js";
-export interface BarChartProSlots extends Omit<BarChartSlots, 'toolbar'>, ChartsToolbarProSlots, Partial<ChartsSlotsPro> {}
-export interface BarChartProSlotProps extends Omit<BarChartSlotProps, 'toolbar'>, ChartsToolbarProSlotProps, Partial<ChartsSlotPropsPro> {}
-export interface BarChartProProps extends Omit<BarChartProps, 'apiRef' | 'slots' | 'slotProps' | 'seriesConfig' | 'plugins'>, Omit<ChartContainerProProps<'bar', BarChartProPluginSignatures>, 'series' | 'slots' | 'slotProps' | 'experimentalFeatures'> {
-  /**
-   * Overridable component slots.
-   * @default {}
-   */
-  slots?: BarChartProSlots;
-  /**
-   * The props used for each component slot.
-   * @default {}
-   */
-  slotProps?: BarChartProSlotProps;
-}
-/**
- * Demos:
- *
- * - [Bars](https://mui.com/x/react-charts/bars/)
- * - [Bar demonstration](https://mui.com/x/react-charts/bar-demo/)
- * - [Stacking](https://mui.com/x/react-charts/stacking/)
- *
- * API:
- *
- * - [BarChart API](https://mui.com/x/api/charts/bar-chart/)
- */
-declare const BarChartPro: React.ForwardRefExoticComponent<BarChartProProps & React.RefAttributes<SVGSVGElement>>;
-export { BarChartPro };