@mui/x-charts-pro 8.0.0-beta.3 → 8.1.0

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

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

package/esm/BarChartPro/BarChartPro.plugins.js

@@ -1,3 +1,4 @@
 import { useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight } 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, useChartProZoom];
+export const BAR_CHART_PRO_PLUGINS = [useChartZAxis, useChartCartesianAxis, useChartInteraction, useChartHighlight, useChartProZoom, useChartProExport];

package/esm/ChartContainerPro/ChartContainerPro.d.ts

@@ -7,6 +7,7 @@ export type ChartContainerProProps<TSeries extends ChartSeriesType = ChartSeries
 type ChartContainerProComponent = <TSeries extends ChartSeriesType = ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = AllPluginSignatures<TSeries>>(props: ChartContainerProProps<TSeries, TSignatures> & {
   ref?: React.ForwardedRef<SVGSVGElement>;
 }) => React.JSX.Element;
+export type ChartProApi = NonNullable<NonNullable<ChartContainerProProps['apiRef']>['current']>;
 /**
  * It sets up the data providers as well as the `<svg>` for the chart.
  *

package/esm/ChartDataProviderPro/ChartDataProviderPro.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ChartSeriesType, ChartAnyPluginSignature, ChartProviderProps } from '@mui/x-charts/internals';
 import { ChartDataProviderProps } from '@mui/x-charts/ChartDataProvider';
 import { AllPluginSignatures } from "../internals/plugins/allPlugins.js";
-export type ChartDataProviderProProps<TSeries extends ChartSeriesType = ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = AllPluginSignatures<TSeries>> = ChartDataProviderProps<TSeries, TSignatures> & Omit<ChartProviderProps<TSeries, TSignatures>['pluginParams'], 'children'>;
+export type ChartDataProviderProProps<TSeries extends ChartSeriesType = ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = AllPluginSignatures<TSeries>> = ChartDataProviderProps<TSeries, TSignatures> & ChartProviderProps<TSeries, TSignatures>['pluginParams'];
 /**
  * Orchestrates the data providers for the chart components and hooks.
  *

package/esm/ChartDataProviderPro/ChartDataProviderPro.js

@@ -4,12 +4,13 @@ import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { Watermark } from '@mui/x-license/Watermark';
-import { ChartProvider, AnimationProvider } from '@mui/x-charts/internals';
+import { ChartProvider } from '@mui/x-charts/internals';
+import { ChartsLocalizationProvider } from '@mui/x-charts/ChartsLocalizationProvider';
 import { useLicenseVerifier } from '@mui/x-license/useLicenseVerifier';
+import { DEFAULT_PLUGINS } from "../internals/plugins/allPlugins.js";
 import { useChartDataProviderProProps } from "./useChartDataProviderProProps.js";
-import { getReleaseInfo } from "../internals/utils/releaseInfo.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const releaseInfo = getReleaseInfo();
+const releaseInfo = "MTc0NTQ0NTYwMDAwMA==";
 const packageIdentifier = 'x-charts-pro';
 /**
  * Orchestrates the data providers for the chart components and hooks.
@@ -41,17 +42,20 @@ const packageIdentifier = 'x-charts-pro';
 function ChartDataProviderPro(props) {
   const {
     children,
-    animationProviderProps,
+    localeText,
     chartProviderProps
-  } = useChartDataProviderProProps(props);
+  } = useChartDataProviderProProps(_extends({}, props, {
+    plugins: props.plugins ?? DEFAULT_PLUGINS
+  }));
   useLicenseVerifier(packageIdentifier, releaseInfo);
-  return /*#__PURE__*/_jsx(ChartProvider, _extends({}, chartProviderProps, {
-    children: /*#__PURE__*/_jsxs(AnimationProvider, _extends({}, animationProviderProps, {
-      children: [children, /*#__PURE__*/_jsx(Watermark, {
-        packageName: packageIdentifier,
-        releaseInfo: releaseInfo
-      })]
-    }))
+  return /*#__PURE__*/_jsxs(ChartProvider, _extends({}, chartProviderProps, {
+    children: [/*#__PURE__*/_jsx(ChartsLocalizationProvider, {
+      localeText: localeText,
+      children: children
+    }), /*#__PURE__*/_jsx(Watermark, {
+      packageName: packageIdentifier,
+      releaseInfo: releaseInfo
+    })]
   }));
 }
 process.env.NODE_ENV !== "production" ? ChartDataProviderPro.propTypes = {
@@ -59,48 +63,58 @@ process.env.NODE_ENV !== "production" ? ChartDataProviderPro.propTypes = {
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "pnpm proptypes"  |
   // ----------------------------------------------------------------------
-  apiRef: PropTypes.any,
-  children: PropTypes.node,
+  apiRef: PropTypes.shape({
+    current: PropTypes.any
+  }),
   /**
    * Color palette used to colorize multiple series.
    * @default rainbowSurgePalette
    */
-  colors: PropTypes.any,
+  colors: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.func]),
   /**
    * An array of objects that can be used to populate series and axes data using their `dataKey` property.
    */
-  dataset: PropTypes.any,
+  dataset: PropTypes.arrayOf(PropTypes.object),
   /**
    * The height of the chart in px. If not defined, it takes the height of the parent element.
    */
-  height: PropTypes.any,
+  height: PropTypes.number,
   /**
    * 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.
    */
-  id: PropTypes.any,
+  id: PropTypes.string,
+  /**
+   * Localized text for chart components.
+   */
+  localeText: PropTypes.object,
   /**
    * The margin between the SVG and the drawing area.
    * It's used for leaving some space for extra information such as the x- and y-axis or legend.
    *
    * Accepts a `number` to be used on all sides or an object with the optional properties: `top`, `bottom`, `left`, and `right`.
    */
-  margin: PropTypes.any,
+  margin: PropTypes.oneOfType([PropTypes.number, PropTypes.shape({
+    bottom: PropTypes.number,
+    left: PropTypes.number,
+    right: PropTypes.number,
+    top: PropTypes.number
+  })]),
   /**
    * The array of series to display.
    * Each type of series has its own specificity.
    * Please refer to the appropriate docs page to learn more about it.
    */
-  series: PropTypes.any,
+  series: PropTypes.arrayOf(PropTypes.object),
   /**
    * If `true`, animations are skipped.
    * If unset or `false`, the animations respects the user's `prefers-reduced-motion` setting.
    */
-  skipAnimation: PropTypes.any,
-  theme: PropTypes.any,
+  skipAnimation: PropTypes.bool,
+  theme: PropTypes.oneOf(['dark', 'light']),
   /**
    * The width of the chart in px. If not defined, it takes the width of the parent element.
    */
-  width: PropTypes.any
+  width: PropTypes.number
 } : void 0;
 export { ChartDataProviderPro };

package/esm/ChartDataProviderPro/useChartDataProviderProProps.d.ts

@@ -3,6 +3,6 @@ import type { ChartDataProviderProProps } from './ChartDataProviderPro';
 import type { AllPluginSignatures } from '../internals/plugins/allPlugins';
 export declare const useChartDataProviderProProps: <TSeries extends ChartSeriesType = ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = AllPluginSignatures<TSeries>>(props: ChartDataProviderProProps<TSeries, TSignatures>) => {
   children: import("react").ReactNode;
-  animationProviderProps: Omit<import("@mui/x-charts/internals").AnimationProviderProps, "children">;
-  chartProviderProps: Omit<import("@mui/x-charts/internals").ChartProviderProps<TSeries, TSignatures>, "children">;
+  localeText: Partial<import("@mui/x-charts/locales").ChartsLocaleText> | undefined;
+  chartProviderProps: import("@mui/x-charts/internals").ChartProviderProps<TSeries, TSignatures>;
 };

package/esm/ChartDataProviderPro/useChartDataProviderProProps.js

@@ -3,13 +3,13 @@
 import { useChartDataProviderProps } from '@mui/x-charts/internals';
 export const useChartDataProviderProProps = props => {
   const {
-    animationProviderProps,
     chartProviderProps,
+    localeText,
     children
   } = useChartDataProviderProps(props);
   return {
     children,
-    animationProviderProps,
+    localeText,
     chartProviderProps
   };
 };

package/esm/FunnelChart/FunnelChart.js

@@ -63,6 +63,7 @@ process.env.NODE_ENV !== "production" ? FunnelChart.propTypes = {
   // ----------------------------------------------------------------------
   apiRef: PropTypes.shape({
     current: PropTypes.shape({
+      exportAsPrint: PropTypes.func.isRequired,
       setZoomData: PropTypes.func.isRequired
     })
   }),
@@ -81,18 +82,87 @@ process.env.NODE_ENV !== "production" ? FunnelChart.propTypes = {
    *
    * @default { position: 'none' }
    */
-  categoryAxis: PropTypes.shape({
+  categoryAxis: PropTypes.oneOfType([PropTypes.shape({
     categories: PropTypes.arrayOf(PropTypes.string),
     disableLine: PropTypes.bool,
     disableTicks: PropTypes.bool,
     id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
     position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
-    scaleType: PropTypes.oneOf(['band', 'linear', 'log', 'point', 'pow', 'sqrt', 'time', 'utc']),
+    scaleType: PropTypes.oneOf(['band']),
     size: PropTypes.number,
     tickLabelStyle: PropTypes.object,
     tickSize: PropTypes.number
-  }),
-  children: PropTypes.node,
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['point']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['log']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['pow']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['sqrt']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['time']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['utc']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  }), PropTypes.shape({
+    categories: PropTypes.arrayOf(PropTypes.string),
+    disableLine: PropTypes.bool,
+    disableTicks: PropTypes.bool,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    position: PropTypes.oneOf(['bottom', 'left', 'none', 'right', 'top']),
+    scaleType: PropTypes.oneOf(['linear']),
+    size: PropTypes.number,
+    tickLabelStyle: PropTypes.object,
+    tickSize: PropTypes.number
+  })]),
   className: PropTypes.string,
   /**
    * Color palette used to colorize multiple series.
@@ -142,6 +212,10 @@ process.env.NODE_ENV !== "production" ? FunnelChart.propTypes = {
    * @default false
    */
   loading: PropTypes.bool,
+  /**
+   * Localized text for chart components.
+   */
+  localeText: PropTypes.object,
   /**
    * The margin between the SVG and the drawing area.
    * It's used for leaving some space for extra information such as the x- and y-axis or legend.

package/esm/FunnelChart/categoryAxis.types.d.ts

@@ -1,6 +1,6 @@
 import { AxisConfig, ScaleName } from '@mui/x-charts/models';
 import { MakeOptional } from '@mui/x-internals/types';
-export type CategoryAxis = {
+export type CategoryAxis<S extends ScaleName = ScaleName> = S extends ScaleName ? {
   /**
    * The categories to be displayed on the axis.
    * The order of the categories is the order in which they are displayed.
@@ -21,4 +21,5 @@ export type CategoryAxis = {
    * - If the axis is vertical, the size is the width of the axis.
    */
   size?: number;
-} & MakeOptional<Pick<AxisConfig<ScaleName, any>, 'disableLine' | 'disableTicks' | 'scaleType' | 'tickLabelStyle' | 'tickSize' | 'id'>, 'id'>;
+  scaleType?: S;
+} & MakeOptional<Pick<AxisConfig<S, any>, 'disableLine' | 'disableTicks' | 'tickLabelStyle' | 'tickSize' | 'id'>, 'id'> : never;

package/esm/FunnelChart/funnelSectionClasses.d.ts

@@ -8,6 +8,11 @@ export interface FunnelSectionClasses {
   faded: string;
   /** Styles applied to the label element. */
   label: string;
+  /**
+   * Styles applied to the root element for a specified series.
+   * Needs to be suffixed with the series ID: `.${funnelSectionClasses.series}-${seriesId}`.
+   */
+  series: string;
 }
 export declare const useUtilityClasses: (props: FunnelSectionProps) => Record<"label" | "highlighted" | "faded" | "root", string>;
 export declare const funnelSectionClasses: FunnelSectionClasses;

package/esm/FunnelChart/funnelSectionClasses.js

@@ -17,4 +17,4 @@ export const useUtilityClasses = props => {
   };
   return composeClasses(slots, getFunnelSectionUtilityClass, classes);
 };
-export const funnelSectionClasses = generateUtilityClasses('MuiFunnelSection', ['root', 'highlighted', 'faded', 'label']);
+export const funnelSectionClasses = generateUtilityClasses('MuiFunnelSection', ['root', 'highlighted', 'faded', 'label', 'series']);

package/esm/FunnelChart/index.d.ts

@@ -2,6 +2,7 @@ export { FunnelChart as Unstable_FunnelChart } from "./FunnelChart.js";
 export type { FunnelChartProps } from './FunnelChart';
 export * from "./FunnelPlot.js";
 export * from "./funnel.types.js";
+export * from "./categoryAxis.types.js";
 export * from "./funnelSlots.types.js";
 export { funnelSectionClasses } from "./funnelSectionClasses.js";
 export type { FunnelSectionClasses } from './funnelSectionClasses';

package/esm/FunnelChart/index.js

@@ -1,5 +1,6 @@
 export { FunnelChart as Unstable_FunnelChart } from "./FunnelChart.js";
 export * from "./FunnelPlot.js";
 export * from "./funnel.types.js";
+export * from "./categoryAxis.types.js";
 export * from "./funnelSlots.types.js";
 export { funnelSectionClasses } from "./funnelSectionClasses.js";

package/esm/FunnelChart/useFunnelChartProps.js

@@ -29,7 +29,6 @@ function getCategoryAxisConfig(categoryAxis, series, isHorizontal, direction) {
   // If the scaleType is not defined or is 'band', our job is simple.
   if (!categoryAxis?.scaleType || categoryAxis.scaleType === 'band') {
     return _extends({
-      scaleType: 'band',
       categoryGapRatio: 0,
       // Use the categories as the domain if they are defined.
       data: categoryAxis?.categories ? categoryAxis.categories :
@@ -38,7 +37,9 @@ function getCategoryAxisConfig(categoryAxis, series, isHorizontal, direction) {
         length: maxSeriesLength
       }, (_, index) => index),
       tickLabelPlacement: 'middle'
-    }, categoryValues);
+    }, categoryValues, {
+      scaleType: 'band'
+    });
   }
 
   // If the scaleType is other than 'band', we have to do some magic.
@@ -47,7 +48,6 @@ function getCategoryAxisConfig(categoryAxis, series, isHorizontal, direction) {
   // We add the total value of the series as the last tick value
   maxSeriesValue.reduce((a, value) => a + value, 0)];
   return _extends({
-    scaleType: categoryAxis.scaleType,
     domainLimit: 'strict',
     tickLabelPlacement: 'middle',
     tickInterval: tickValues,

package/esm/Heatmap/Heatmap.js

@@ -128,7 +128,6 @@ process.env.NODE_ENV !== "production" ? Heatmap.propTypes = {
   apiRef: PropTypes.shape({
     current: PropTypes.object
   }),
-  children: PropTypes.node,
   className: PropTypes.string,
   /**
    * Color palette used to colorize multiple series.
@@ -168,6 +167,10 @@ process.env.NODE_ENV !== "production" ? Heatmap.propTypes = {
    * @default false
    */
   loading: PropTypes.bool,
+  /**
+   * Localized text for chart components.
+   */
+  localeText: PropTypes.object,
   /**
    * The margin between the SVG and the drawing area.
    * It's used for leaving some space for extra information such as the x- and y-axis or legend.
@@ -199,7 +202,7 @@ process.env.NODE_ENV !== "production" ? Heatmap.propTypes = {
    */
   series: PropTypes.arrayOf(PropTypes.object).isRequired,
   /**
-   * The configuration helpers used to compute attributes according to the serries type.
+   * The configuration helpers used to compute attributes according to the series type.
    * @ignore Unstable props for internal usage.
    */
   seriesConfig: PropTypes.object,

package/esm/Heatmap/HeatmapItem.js

@@ -13,7 +13,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 const HeatmapCell = styled('rect', {
   name: 'MuiHeatmap',
   slot: 'Cell',
-  overridesResolver: (_, styles) => styles.arc
+  overridesResolver: (_, styles) => styles.arc // FIXME: Inconsistent naming with slot
 })(({
   ownerState
 }) => ({

package/esm/Heatmap/heatmapClasses.d.ts

@@ -5,6 +5,11 @@ export interface HeatmapClasses {
   highlighted: string;
   /** Styles applied to the cell element if faded. */
   faded: string;
+  /**
+   * Styles applied to the root element for a specified series.
+   * Needs to be suffixed with the series ID: `.${heatmapClasses.series}-${seriesId}`.
+   */
+  series: string;
 }
 export type HeatmapClassKey = keyof HeatmapClasses;
 export declare function getHeatmapUtilityClass(slot: string): string;

package/esm/Heatmap/heatmapClasses.js

@@ -8,7 +8,7 @@ export function getHeatmapUtilityClass(slot) {
   }
   return generateUtilityClass('MuiHeatmap', slot);
 }
-export const heatmapClasses = _extends({}, generateUtilityClasses('MuiHeatmap', ['cell']), {
+export const heatmapClasses = _extends({}, generateUtilityClasses('MuiHeatmap', ['cell', 'series']), {
   highlighted: 'Charts-highlighted',
   faded: 'Charts-faded'
 });