@mui/x-charts 6.0.0-alpha.8 → 6.18.0

package/esm/PieChart/PieChart.js

@@ -16,6 +16,17 @@ const defaultMargin = {
   left: 5,
   right: 100
 };
+
+/**
+ * Demos:
+ *
+ * - [Pie](https://mui.com/x/react-charts/pie/)
+ * - [Pie demonstration](https://mui.com/x/react-charts/pie-demo/)
+ *
+ * API:
+ *
+ * - [PieChart API](https://mui.com/x/api/charts/pie-chart/)
+ */
 function PieChart(props) {
   const {
     xAxis,
@@ -33,6 +44,7 @@ function PieChart(props) {
       x: 'none',
       y: 'none'
     },
+    skipAnimation,
     legend = {
       direction: 'column',
       position: {
@@ -46,7 +58,8 @@ function PieChart(props) {
     bottomAxis = null,
     children,
     slots,
-    slotProps
+    slotProps,
+    onClick
   } = props;
   const margin = _extends({}, defaultMargin, marginProps);
   return /*#__PURE__*/_jsxs(ResponsiveChartContainer, {
@@ -74,7 +87,9 @@ function PieChart(props) {
       slotProps: slotProps
     }), /*#__PURE__*/_jsx(PiePlot, {
       slots: slots,
-      slotProps: slotProps
+      slotProps: slotProps,
+      onClick: onClick,
+      skipAnimation: skipAnimation
     }), /*#__PURE__*/_jsx(ChartsLegend, _extends({}, legend, {
       slots: slots,
       slotProps: slotProps
@@ -103,11 +118,15 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     fill: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     position: PropTypes.oneOf(['bottom', 'top']),
     slotProps: PropTypes.object,
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,
@@ -136,33 +155,33 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     fill: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     position: PropTypes.oneOf(['left', 'right']),
     slotProps: PropTypes.object,
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,
     tickSize: PropTypes.number
   }), PropTypes.string]),
+  /**
+   * @deprecated Consider using `slotProps.legend` instead.
+   */
   legend: PropTypes.shape({
     classes: PropTypes.object,
     direction: PropTypes.oneOf(['column', 'row']),
     hidden: PropTypes.bool,
-    itemWidth: PropTypes.number,
-    markSize: PropTypes.number,
-    offset: PropTypes.shape({
-      x: PropTypes.number,
-      y: PropTypes.number
-    }),
     position: PropTypes.shape({
       horizontal: PropTypes.oneOf(['left', 'middle', 'right']).isRequired,
       vertical: PropTypes.oneOf(['bottom', 'middle', 'top']).isRequired
     }),
     slotProps: PropTypes.object,
-    slots: PropTypes.object,
-    spacing: PropTypes.number
+    slots: PropTypes.object
   }),
   margin: PropTypes.shape({
     bottom: PropTypes.number,
@@ -170,6 +189,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     right: PropTypes.number,
     top: PropTypes.number
   }),
+  onClick: PropTypes.func,
   /**
    * Indicate which axis to display the right of the charts.
    * Can be a string (the id of the axis) or an object `ChartsYAxisProps`.
@@ -183,11 +203,15 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     fill: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     position: PropTypes.oneOf(['left', 'right']),
     slotProps: PropTypes.object,
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,
@@ -209,15 +233,19 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     endAngle: PropTypes.number,
     faded: PropTypes.shape({
       additionalRadius: PropTypes.number,
+      color: PropTypes.string,
       cornerRadius: PropTypes.number,
       innerRadius: PropTypes.number,
-      outerRadius: PropTypes.number
+      outerRadius: PropTypes.number,
+      paddingAngle: PropTypes.number
     }),
     highlighted: PropTypes.shape({
       additionalRadius: PropTypes.number,
+      color: PropTypes.string,
       cornerRadius: PropTypes.number,
       innerRadius: PropTypes.number,
-      outerRadius: PropTypes.number
+      outerRadius: PropTypes.number,
+      paddingAngle: PropTypes.number
     }),
     highlightScope: PropTypes.shape({
       faded: PropTypes.oneOf(['global', 'none', 'series']),
@@ -232,6 +260,11 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     type: PropTypes.oneOf(['pie']),
     valueFormatter: PropTypes.func
   })).isRequired,
+  /**
+   * If `true`, animations are skiped.
+   * @default false
+   */
+  skipAnimation: PropTypes.bool,
   /**
    * The props used for each component slot.
    * @default {}
@@ -244,6 +277,8 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     axisContent: PropTypes.elementType,
     classes: PropTypes.object,
     itemContent: PropTypes.elementType,
+    slotProps: PropTypes.object,
+    slots: PropTypes.object,
     trigger: PropTypes.oneOf(['axis', 'item', 'none'])
   }),
   /**
@@ -259,11 +294,15 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     fill: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     position: PropTypes.oneOf(['bottom', 'top']),
     slotProps: PropTypes.object,
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,
@@ -288,6 +327,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     id: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     max: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
     min: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
     position: PropTypes.oneOf(['bottom', 'left', 'right', 'top']),
@@ -296,6 +336,9 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,
@@ -314,6 +357,7 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     id: PropTypes.string,
     label: PropTypes.string,
     labelFontSize: PropTypes.number,
+    labelStyle: PropTypes.object,
     max: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
     min: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.number]),
     position: PropTypes.oneOf(['bottom', 'left', 'right', 'top']),
@@ -322,6 +366,9 @@ process.env.NODE_ENV !== "production" ? PieChart.propTypes = {
     slots: PropTypes.object,
     stroke: PropTypes.string,
     tickFontSize: PropTypes.number,
+    tickInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.array, PropTypes.func]),
+    tickLabelInterval: PropTypes.oneOfType([PropTypes.oneOf(['auto']), PropTypes.func]),
+    tickLabelStyle: PropTypes.object,
     tickMaxStep: PropTypes.number,
     tickMinStep: PropTypes.number,
     tickNumber: PropTypes.number,

package/esm/PieChart/PiePlot.js

@@ -1,33 +1,27 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { SeriesContext } from '../context/SeriesContextProvider';
-import PieArc from './PieArc';
-import PieArcLabel from './PieArcLabel';
 import { DrawingContext } from '../context/DrawingProvider';
-import { createElement as _createElement } from "react";
-import { jsxs as _jsxs } from "react/jsx-runtime";
+import { PieArcPlot } from './PieArcPlot';
+import { PieArcLabelPlot } from './PieArcLabelPlot';
 import { jsx as _jsx } from "react/jsx-runtime";
-const RATIO = 180 / Math.PI;
-function getItemLabel(arcLabel, arcLabelMinAngle, item) {
-  if (!arcLabel) {
-    return null;
-  }
-  const angle = (item.endAngle - item.startAngle) * RATIO;
-  if (angle < arcLabelMinAngle) {
-    return null;
-  }
-  if (typeof arcLabel === 'string') {
-    var _item$arcLabel;
-    return (_item$arcLabel = item[arcLabel]) == null ? void 0 : _item$arcLabel.toString();
-  }
-  return arcLabel(item);
-}
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Demos:
+ *
+ * - [Pie](https://mui.com/x/react-charts/pie/)
+ * - [Pie demonstration](https://mui.com/x/react-charts/pie-demo/)
+ *
+ * API:
+ *
+ * - [PiePlot API](https://mui.com/x/api/charts/pie-plot/)
+ */
 function PiePlot(props) {
-  var _slots$pieArc, _slots$pieArcLabel;
   const {
+    skipAnimation,
     slots,
-    slotProps
+    slotProps,
+    onClick
   } = props;
   const seriesData = React.useContext(SeriesContext).pie;
   const {
@@ -48,54 +42,67 @@ function PiePlot(props) {
     series,
     seriesOrder
   } = seriesData;
-  const Arc = (_slots$pieArc = slots == null ? void 0 : slots.pieArc) != null ? _slots$pieArc : PieArc;
-  const ArcLabel = (_slots$pieArcLabel = slots == null ? void 0 : slots.pieArcLabel) != null ? _slots$pieArcLabel : PieArcLabel;
-  return /*#__PURE__*/_jsx("g", {
-    children: seriesOrder.map(seriesId => {
+  return /*#__PURE__*/_jsxs("g", {
+    children: [seriesOrder.map(seriesId => {
       const {
         innerRadius,
         outerRadius,
         cornerRadius,
-        arcLabel,
-        arcLabelMinAngle = 0,
+        paddingAngle,
         data,
         cx,
         cy,
         highlighted,
-        faded
+        faded,
+        highlightScope
+      } = series[seriesId];
+      return /*#__PURE__*/_jsx("g", {
+        transform: `translate(${cx === undefined ? center.x : left + cx}, ${cy === undefined ? center.y : top + cy})`,
+        children: /*#__PURE__*/_jsx(PieArcPlot, {
+          innerRadius: innerRadius,
+          outerRadius: outerRadius != null ? outerRadius : availableRadius,
+          cornerRadius: cornerRadius,
+          paddingAngle: paddingAngle,
+          id: seriesId,
+          data: data,
+          skipAnimation: skipAnimation,
+          highlightScope: highlightScope,
+          highlighted: highlighted,
+          faded: faded,
+          onClick: onClick,
+          slots: slots,
+          slotProps: slotProps
+        })
+      }, seriesId);
+    }), seriesOrder.map(seriesId => {
+      const {
+        innerRadius,
+        outerRadius,
+        cornerRadius,
+        paddingAngle,
+        arcLabel,
+        arcLabelMinAngle,
+        data,
+        cx,
+        cy,
+        highlightScope
       } = series[seriesId];
       return /*#__PURE__*/_jsx("g", {
         transform: `translate(${cx === undefined ? center.x : left + cx}, ${cy === undefined ? center.y : top + cy})`,
-        children: /*#__PURE__*/_jsxs("g", {
-          children: [data.map((item, index) => {
-            return /*#__PURE__*/_createElement(Arc, _extends({}, item, {
-              key: item.id,
-              innerRadius: innerRadius,
-              outerRadius: outerRadius != null ? outerRadius : availableRadius,
-              cornerRadius: cornerRadius,
-              id: seriesId,
-              color: item.color,
-              dataIndex: index,
-              highlightScope: series[seriesId].highlightScope,
-              highlighted: highlighted,
-              faded: faded
-            }, slotProps == null ? void 0 : slotProps.pieArc));
-          }), data.map((item, index) => {
-            return /*#__PURE__*/_createElement(ArcLabel, _extends({}, item, {
-              key: item.id,
-              innerRadius: innerRadius,
-              outerRadius: outerRadius != null ? outerRadius : availableRadius,
-              cornerRadius: cornerRadius,
-              id: seriesId,
-              color: item.color,
-              dataIndex: index,
-              highlightScope: series[seriesId].highlightScope,
-              formattedArcLabel: getItemLabel(arcLabel, arcLabelMinAngle, item)
-            }, slotProps == null ? void 0 : slotProps.pieArcLabel));
-          })]
+        children: /*#__PURE__*/_jsx(PieArcLabelPlot, {
+          innerRadius: innerRadius,
+          outerRadius: outerRadius != null ? outerRadius : availableRadius,
+          cornerRadius: cornerRadius,
+          paddingAngle: paddingAngle,
+          id: seriesId,
+          data: data,
+          skipAnimation: skipAnimation,
+          arcLabel: arcLabel,
+          arcLabelMinAngle: arcLabelMinAngle,
+          highlightScope: highlightScope
         })
       }, seriesId);
-    })
+    })]
   });
 }
 process.env.NODE_ENV !== "production" ? PiePlot.propTypes = {
@@ -103,6 +110,18 @@ process.env.NODE_ENV !== "production" ? PiePlot.propTypes = {
   // | These PropTypes are generated from the TypeScript type definitions |
   // | To update them edit the TypeScript types and run "yarn proptypes"  |
   // ----------------------------------------------------------------------
+  /**
+   * Callback fired when a pie item is clicked.
+   * @param {React.MouseEvent<SVGPathElement, MouseEvent>} event The event source of the callback.
+   * @param {PieItemIdentifier} pieItemIdentifier The pie item identifier.
+   * @param {DefaultizedPieValueType} item The pie item.
+   */
+  onClick: PropTypes.func,
+  /**
+   * If `true`, animations are skiped.
+   * @default false
+   */
+  skipAnimation: PropTypes.bool,
   /**
    * The props used for each component slot.
    * @default {}

package/esm/PieChart/dataTransform/transition.js

@@ -0,0 +1,130 @@
+export const defaultTransitionConfig = {
+  keys: item => item.id,
+  from: ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle,
+    color,
+    isFaded
+  }) => ({
+    innerRadius,
+    outerRadius: (innerRadius + outerRadius) / 2,
+    cornerRadius,
+    startAngle: (startAngle + endAngle) / 2,
+    endAngle: (startAngle + endAngle) / 2,
+    paddingAngle,
+    fill: color,
+    opacity: isFaded ? 0.3 : 1
+  }),
+  leave: ({
+    innerRadius,
+    startAngle,
+    endAngle
+  }) => ({
+    innerRadius,
+    outerRadius: innerRadius,
+    startAngle: (startAngle + endAngle) / 2,
+    endAngle: (startAngle + endAngle) / 2
+  }),
+  enter: ({
+    innerRadius,
+    outerRadius,
+    startAngle,
+    endAngle
+  }) => ({
+    innerRadius,
+    outerRadius,
+    startAngle,
+    endAngle
+  }),
+  update: ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle,
+    color,
+    isFaded
+  }) => ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle,
+    fill: color,
+    opacity: isFaded ? 0.3 : 1
+  }),
+  config: {
+    tension: 120,
+    friction: 14,
+    clamp: true
+  }
+};
+export const defaultLabelTransitionConfig = {
+  keys: item => item.id,
+  from: ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle
+  }) => ({
+    innerRadius,
+    outerRadius: (innerRadius + outerRadius) / 2,
+    cornerRadius,
+    startAngle: (startAngle + endAngle) / 2,
+    endAngle: (startAngle + endAngle) / 2,
+    paddingAngle,
+    opacity: 0
+  }),
+  leave: ({
+    innerRadius,
+    startAngle,
+    endAngle
+  }) => ({
+    innerRadius,
+    outerRadius: innerRadius,
+    startAngle: (startAngle + endAngle) / 2,
+    endAngle: (startAngle + endAngle) / 2,
+    opacity: 0
+  }),
+  enter: ({
+    innerRadius,
+    outerRadius,
+    startAngle,
+    endAngle
+  }) => ({
+    innerRadius,
+    outerRadius,
+    startAngle,
+    endAngle,
+    opacity: 1
+  }),
+  update: ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle
+  }) => ({
+    innerRadius,
+    outerRadius,
+    cornerRadius,
+    startAngle,
+    endAngle,
+    paddingAngle,
+    opacity: 1
+  }),
+  config: {
+    tension: 120,
+    friction: 14,
+    clamp: true
+  }
+};

package/esm/PieChart/dataTransform/useTransformData.js

@@ -0,0 +1,59 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { InteractionContext } from '../../context/InteractionProvider';
+import { getIsHighlighted, getIsFaded } from '../../hooks/useInteractionItemProps';
+export function useTransformData(series) {
+  const {
+    id: seriesId,
+    highlightScope,
+    data,
+    faded,
+    highlighted,
+    paddingAngle: basePaddingAngle = 0,
+    innerRadius: baseInnerRadius = 0,
+    outerRadius: baseOuterRadius,
+    cornerRadius: baseCornerRadius = 0
+  } = series;
+  const {
+    item: highlightedItem
+  } = React.useContext(InteractionContext);
+  const getHighlightStatus = React.useCallback(dataIndex => {
+    const isHighlighted = getIsHighlighted(highlightedItem, {
+      type: 'pie',
+      seriesId,
+      dataIndex
+    }, highlightScope);
+    const isFaded = !isHighlighted && getIsFaded(highlightedItem, {
+      type: 'pie',
+      seriesId,
+      dataIndex
+    }, highlightScope);
+    return {
+      isHighlighted,
+      isFaded
+    };
+  }, [highlightScope, highlightedItem, seriesId]);
+  const dataWithHighlight = React.useMemo(() => data.map((item, itemIndex) => {
+    var _attibuesOverride$pad, _attibuesOverride$inn, _attibuesOverride$out, _attibuesOverride$cor;
+    const {
+      isHighlighted,
+      isFaded
+    } = getHighlightStatus(itemIndex);
+    const attibuesOverride = _extends({
+      additionalRadius: 0
+    }, isFaded && faded || isHighlighted && highlighted || {});
+    const paddingAngle = Math.max(0, Math.PI * ((_attibuesOverride$pad = attibuesOverride.paddingAngle) != null ? _attibuesOverride$pad : basePaddingAngle) / 180);
+    const innerRadius = Math.max(0, (_attibuesOverride$inn = attibuesOverride.innerRadius) != null ? _attibuesOverride$inn : baseInnerRadius);
+    const outerRadius = Math.max(0, (_attibuesOverride$out = attibuesOverride.outerRadius) != null ? _attibuesOverride$out : baseOuterRadius + attibuesOverride.additionalRadius);
+    const cornerRadius = (_attibuesOverride$cor = attibuesOverride.cornerRadius) != null ? _attibuesOverride$cor : baseCornerRadius;
+    return _extends({}, item, attibuesOverride, {
+      isFaded,
+      isHighlighted,
+      paddingAngle,
+      innerRadius,
+      outerRadius,
+      cornerRadius
+    });
+  }), [baseCornerRadius, baseInnerRadius, baseOuterRadius, basePaddingAngle, data, faded, getHighlightStatus, highlighted]);
+  return dataWithHighlight;
+}

package/esm/ResponsiveChartContainer/index.js

@@ -42,7 +42,7 @@ const useChartDimensions = (inWidth, inHeight) => {
     let animationFrame;
     const observer = new ResizeObserver(() => {
       // See https://github.com/mui/mui-x/issues/8733
-      animationFrame = window.requestAnimationFrame(() => {
+      animationFrame = requestAnimationFrame(() => {
         computeSize();
       });
     });
@@ -106,10 +106,10 @@ export const ResponsiveChartContainer = /*#__PURE__*/React.forwardRef(function R
       width: inWidth,
       height: inHeight
     },
-    children: /*#__PURE__*/_jsx(ChartContainer, _extends({}, other, {
+    children: width && height ? /*#__PURE__*/_jsx(ChartContainer, _extends({}, other, {
       width: width,
       height: height,
       ref: ref
-    }))
+    })) : null
   });
 });

package/esm/ScatterChart/Scatter.js

@@ -5,6 +5,16 @@ import { getValueToPositionMapper } from '../hooks/useScale';
 import { getIsFaded, getIsHighlighted, useInteractionItemProps } from '../hooks/useInteractionItemProps';
 import { InteractionContext } from '../context/InteractionProvider';
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Demos:
+ *
+ * - [Scatter](https://mui.com/x/react-charts/scatter/)
+ * - [Scatter demonstration](https://mui.com/x/react-charts/scatter-demo/)
+ *
+ * API:
+ *
+ * - [Scatter API](https://mui.com/x/api/charts/scatter/)
+ */
 function Scatter(props) {
   const {
     series,