@mui/x-charts 7.10.0 → 7.11.0

package/ChartsLegend/DefaultChartsLegend.js

@@ -4,212 +4,24 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ChartsLegendRoot = void 0;
 exports.DefaultChartsLegend = DefaultChartsLegend;
-var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var React = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
-var _NoSsr = require("@mui/base/NoSsr");
-var _styles = require("@mui/material/styles");
-var _ChartsText = require("../ChartsText");
-var _getWordsByLines = require("../internals/getWordsByLines");
+var _LegendPerItem = require("./LegendPerItem");
 var _jsxRuntime = require("react/jsx-runtime");
-const _excluded = ["rotate", "dominantBaseline"],
-  _excluded2 = ["label"];
+const _excluded = ["drawingArea", "seriesToDisplay"];
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-const ChartsLegendRoot = exports.ChartsLegendRoot = (0, _styles.styled)('g', {
-  name: 'MuiChartsLegend',
-  slot: 'Root',
-  overridesResolver: (props, styles) => styles.root
-})({});
-/**
- * Transforms number or partial padding object to a defaultized padding object.
- */
-const getStandardizedPadding = padding => {
-  if (typeof padding === 'number') {
-    return {
-      left: padding,
-      right: padding,
-      top: padding,
-      bottom: padding
-    };
-  }
-  return (0, _extends2.default)({
-    left: 0,
-    right: 0,
-    top: 0,
-    bottom: 0
-  }, padding);
-};
 function DefaultChartsLegend(props) {
   const {
-    hidden,
-    position,
-    direction,
-    seriesToDisplay,
-    drawingArea,
-    classes,
-    itemMarkWidth = 20,
-    itemMarkHeight = 20,
-    markGap = 5,
-    itemGap = 10,
-    padding: paddingProps = 10,
-    labelStyle: inLabelStyle
-  } = props;
-  const theme = (0, _styles.useTheme)();
-  const isRTL = theme.direction === 'rtl';
-  const labelStyle = React.useMemo(() => (0, _extends2.default)({}, theme.typography.subtitle1, {
-    color: 'inherit',
-    dominantBaseline: 'central',
-    textAnchor: 'start',
-    fill: (theme.vars || theme).palette.text.primary,
-    lineHeight: 1
-  }, inLabelStyle),
-  // To say to TS that the dominantBaseline and textAnchor are correct
-  [inLabelStyle, theme]);
-  const padding = React.useMemo(() => getStandardizedPadding(paddingProps), [paddingProps]);
-  const getItemSpace = React.useCallback((label, inStyle = {}) => {
-    const style = (0, _objectWithoutPropertiesLoose2.default)(inStyle, _excluded);
-    const linesSize = (0, _getWordsByLines.getWordsByLines)({
-      style,
-      needsComputation: true,
-      text: label
-    });
-    const innerSize = {
-      innerWidth: itemMarkWidth + markGap + Math.max(...linesSize.map(size => size.width)),
-      innerHeight: Math.max(itemMarkHeight, linesSize.length * linesSize[0].height)
-    };
-    return (0, _extends2.default)({}, innerSize, {
-      outerWidth: innerSize.innerWidth + itemGap,
-      outerHeight: innerSize.innerHeight + itemGap
-    });
-  }, [itemGap, itemMarkHeight, itemMarkWidth, markGap]);
-  const totalWidth = drawingArea.left + drawingArea.width + drawingArea.right;
-  const totalHeight = drawingArea.top + drawingArea.height + drawingArea.bottom;
-  const availableWidth = totalWidth - padding.left - padding.right;
-  const availableHeight = totalHeight - padding.top - padding.bottom;
-  const [seriesWithPosition, legendWidth, legendHeight] = React.useMemo(() => {
-    // Start at 0, 0. Will be modified later by padding and position.
-    let x = 0;
-    let y = 0;
-
-    // total values used to align legend later.
-    let totalWidthUsed = 0;
-    let totalHeightUsed = 0;
-    let rowIndex = 0;
-    const rowMaxHeight = [0];
-    const seriesWithRawPosition = seriesToDisplay.map(_ref => {
-      let {
-          label
-        } = _ref,
-        other = (0, _objectWithoutPropertiesLoose2.default)(_ref, _excluded2);
-      const itemSpace = getItemSpace(label, labelStyle);
-      const rep = (0, _extends2.default)({}, other, {
-        label,
-        positionX: x,
-        positionY: y,
-        innerHeight: itemSpace.innerHeight,
-        innerWidth: itemSpace.innerWidth,
-        outerHeight: itemSpace.outerHeight,
-        outerWidth: itemSpace.outerWidth,
-        rowIndex
-      });
-      if (direction === 'row') {
-        if (x + itemSpace.innerWidth > availableWidth) {
-          // This legend item would create overflow along the x-axis, so we start a new row.
-          x = 0;
-          y += rowMaxHeight[rowIndex];
-          rowIndex += 1;
-          if (rowMaxHeight.length <= rowIndex) {
-            rowMaxHeight.push(0);
-          }
-          rep.positionX = x;
-          rep.positionY = y;
-          rep.rowIndex = rowIndex;
-        }
-        totalWidthUsed = Math.max(totalWidthUsed, x + itemSpace.outerWidth);
-        totalHeightUsed = Math.max(totalHeightUsed, y + itemSpace.outerHeight);
-        rowMaxHeight[rowIndex] = Math.max(rowMaxHeight[rowIndex], itemSpace.outerHeight);
-        x += itemSpace.outerWidth;
-      }
-      if (direction === 'column') {
-        if (y + itemSpace.innerHeight > availableHeight) {
-          // This legend item would create overflow along the y-axis, so we start a new column.
-          x = totalWidthUsed + itemGap;
-          y = 0;
-          rowIndex = 0;
-          rep.positionX = x;
-          rep.positionY = y;
-          rep.rowIndex = rowIndex;
-        }
-        if (rowMaxHeight.length <= rowIndex) {
-          rowMaxHeight.push(0);
-        }
-        totalWidthUsed = Math.max(totalWidthUsed, x + itemSpace.outerWidth);
-        totalHeightUsed = Math.max(totalHeightUsed, y + itemSpace.outerHeight);
-        rowIndex += 1;
-        y += itemSpace.outerHeight;
-      }
-      return rep;
-    });
-    return [seriesWithRawPosition.map(item => (0, _extends2.default)({}, item, {
-      positionY: item.positionY + (direction === 'row' ? rowMaxHeight[item.rowIndex] / 2 // Get the center of the entire row
-      : item.outerHeight / 2) // Get the center of the item
-    })), totalWidthUsed, totalHeightUsed];
-  }, [seriesToDisplay, getItemSpace, labelStyle, direction, availableWidth, availableHeight, itemGap]);
-  const gapX = React.useMemo(() => {
-    switch (position.horizontal) {
-      case 'left':
-        return padding.left;
-      case 'right':
-        return totalWidth - padding.right - legendWidth;
-      default:
-        return (totalWidth - legendWidth) / 2;
-    }
-  }, [position.horizontal, padding.left, padding.right, totalWidth, legendWidth]);
-  const gapY = React.useMemo(() => {
-    switch (position.vertical) {
-      case 'top':
-        return padding.top;
-      case 'bottom':
-        return totalHeight - padding.bottom - legendHeight;
-      default:
-        return (totalHeight - legendHeight) / 2;
-    }
-  }, [position.vertical, padding.top, padding.bottom, totalHeight, legendHeight]);
-  if (hidden) {
-    return null;
-  }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_NoSsr.NoSsr, {
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsLegendRoot, {
-      className: classes.root,
-      children: seriesWithPosition.map(({
-        id,
-        label,
-        color,
-        positionX,
-        positionY
-      }) => /*#__PURE__*/(0, _jsxRuntime.jsxs)("g", {
-        className: classes.series,
-        transform: `translate(${gapX + (isRTL ? legendWidth - positionX : positionX)} ${gapY + positionY})`,
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("rect", {
-          className: classes.mark,
-          x: isRTL ? -itemMarkWidth : 0,
-          y: -itemMarkHeight / 2,
-          width: itemMarkWidth,
-          height: itemMarkHeight,
-          fill: color
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsText.ChartsText, {
-          style: labelStyle,
-          text: label,
-          x: (isRTL ? -1 : 1) * (itemMarkWidth + markGap),
-          y: 0
-        })]
-      }, id))
-    })
-  });
+      seriesToDisplay
+    } = props,
+    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_LegendPerItem.LegendPerItem, (0, _extends2.default)({}, other, {
+    itemsToDisplay: seriesToDisplay
+  }));
 }
 process.env.NODE_ENV !== "production" ? DefaultChartsLegend.propTypes = {
   // ----------------------------- Warning --------------------------------
@@ -219,12 +31,15 @@ process.env.NODE_ENV !== "production" ? DefaultChartsLegend.propTypes = {
   /**
    * Override or extend the styles applied to the component.
    */
-  classes: _propTypes.default.object.isRequired,
+  classes: _propTypes.default.object,
   /**
    * The direction of the legend layout.
    * The default depends on the chart.
    */
   direction: _propTypes.default.oneOf(['column', 'row']).isRequired,
+  /**
+   * @deprecated Use the `useDrawingArea` hook instead.
+   */
   drawingArea: _propTypes.default.shape({
     bottom: _propTypes.default.number.isRequired,
     height: _propTypes.default.number.isRequired,

package/ChartsLegend/LegendPerItem.d.ts

@@ -0,0 +1,61 @@
+import * as React from 'react';
+import { DrawingArea } from '../context/DrawingProvider';
+import { DefaultizedProps } from '../models/helpers';
+import { ChartsTextStyle } from '../ChartsText';
+import { CardinalDirections } from '../models/layout';
+import type { ChartsLegendProps } from './ChartsLegend';
+import { LegendItemParams } from './chartsLegend.types';
+import { AnchorPosition, Direction } from './legend.types';
+export type ChartsLegendRootOwnerState = {
+    position: AnchorPosition;
+    direction: Direction;
+    drawingArea: DrawingArea;
+    offsetX?: number;
+    offsetY?: number;
+    seriesNumber: number;
+};
+export declare const ChartsLegendRoot: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, Pick<React.SVGProps<SVGGElement>, keyof React.SVGProps<SVGGElement>>, {}>;
+export interface LegendPerItemProps extends DefaultizedProps<Omit<ChartsLegendProps, 'slots' | 'slotProps'>, 'direction' | 'position'> {
+    /**
+     * The ordered array of item to display in the legend.
+     */
+    itemsToDisplay: LegendItemParams[];
+    classes?: Record<'mark' | 'series' | 'root', string>;
+    /**
+     * Style applied to legend labels.
+     * @default theme.typography.subtitle1
+     */
+    labelStyle?: ChartsTextStyle;
+    /**
+     * Width of the item mark (in px).
+     * @default 20
+     */
+    itemMarkWidth?: number;
+    /**
+     * Height of the item mark (in px).
+     * @default 20
+     */
+    itemMarkHeight?: number;
+    /**
+     * Space between the mark and the label (in px).
+     * @default 5
+     */
+    markGap?: number;
+    /**
+     * Space between two legend items (in px).
+     * @default 10
+     */
+    itemGap?: number;
+    /**
+     * Legend padding (in px).
+     * Can either be a single number, or an object with top, left, bottom, right properties.
+     * @default 10
+     */
+    padding?: number | Partial<CardinalDirections<number>>;
+}
+/**
+ * Internal component to display an array of items as a legend.
+ * Used for series legend, and threshold color legend.
+ * @ignore - Do not document
+ */
+export declare function LegendPerItem(props: LegendPerItemProps): React.JSX.Element | null;

package/ChartsLegend/LegendPerItem.js

@@ -0,0 +1,151 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChartsLegendRoot = void 0;
+exports.LegendPerItem = LegendPerItem;
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var React = _interopRequireWildcard(require("react"));
+var _NoSsr = require("@mui/base/NoSsr");
+var _styles = require("@mui/material/styles");
+var _ChartsText = require("../ChartsText");
+var _getWordsByLines = require("../internals/getWordsByLines");
+var _legendItemsPlacement = require("./legendItemsPlacement");
+var _useDrawingArea = require("../hooks/useDrawingArea");
+var _jsxRuntime = require("react/jsx-runtime");
+const _excluded = ["rotate", "dominantBaseline"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const ChartsLegendRoot = exports.ChartsLegendRoot = (0, _styles.styled)('g', {
+  name: 'MuiChartsLegend',
+  slot: 'Root',
+  overridesResolver: (props, styles) => styles.root
+})({});
+/**
+ * Transforms number or partial padding object to a defaultized padding object.
+ */
+const getStandardizedPadding = padding => {
+  if (typeof padding === 'number') {
+    return {
+      left: padding,
+      right: padding,
+      top: padding,
+      bottom: padding
+    };
+  }
+  return (0, _extends2.default)({
+    left: 0,
+    right: 0,
+    top: 0,
+    bottom: 0
+  }, padding);
+};
+
+/**
+ * Internal component to display an array of items as a legend.
+ * Used for series legend, and threshold color legend.
+ * @ignore - Do not document
+ */
+function LegendPerItem(props) {
+  const {
+    hidden,
+    position,
+    direction,
+    itemsToDisplay,
+    classes,
+    itemMarkWidth = 20,
+    itemMarkHeight = 20,
+    markGap = 5,
+    itemGap = 10,
+    padding: paddingProps = 10,
+    labelStyle: inLabelStyle
+  } = props;
+  const theme = (0, _styles.useTheme)();
+  const isRTL = theme.direction === 'rtl';
+  const drawingArea = (0, _useDrawingArea.useDrawingArea)();
+  const labelStyle = React.useMemo(() => (0, _extends2.default)({}, theme.typography.subtitle1, {
+    color: 'inherit',
+    dominantBaseline: 'central',
+    textAnchor: 'start',
+    fill: (theme.vars || theme).palette.text.primary,
+    lineHeight: 1
+  }, inLabelStyle),
+  // To say to TS that the dominantBaseline and textAnchor are correct
+  [inLabelStyle, theme]);
+  const padding = React.useMemo(() => getStandardizedPadding(paddingProps), [paddingProps]);
+  const getItemSpace = React.useCallback((label, inStyle = {}) => {
+    const style = (0, _objectWithoutPropertiesLoose2.default)(inStyle, _excluded);
+    const linesSize = (0, _getWordsByLines.getWordsByLines)({
+      style,
+      needsComputation: true,
+      text: label
+    });
+    const innerSize = {
+      innerWidth: itemMarkWidth + markGap + Math.max(...linesSize.map(size => size.width)),
+      innerHeight: Math.max(itemMarkHeight, linesSize.length * linesSize[0].height)
+    };
+    return (0, _extends2.default)({}, innerSize, {
+      outerWidth: innerSize.innerWidth + itemGap,
+      outerHeight: innerSize.innerHeight + itemGap
+    });
+  }, [itemGap, itemMarkHeight, itemMarkWidth, markGap]);
+  const totalWidth = drawingArea.left + drawingArea.width + drawingArea.right;
+  const totalHeight = drawingArea.top + drawingArea.height + drawingArea.bottom;
+  const availableWidth = totalWidth - padding.left - padding.right;
+  const availableHeight = totalHeight - padding.top - padding.bottom;
+  const [itemsWithPosition, legendWidth, legendHeight] = React.useMemo(() => (0, _legendItemsPlacement.legendItemPlacements)(itemsToDisplay, getItemSpace, labelStyle, direction, availableWidth, availableHeight, itemGap), [itemsToDisplay, getItemSpace, labelStyle, direction, availableWidth, availableHeight, itemGap]);
+  const gapX = React.useMemo(() => {
+    switch (position.horizontal) {
+      case 'left':
+        return padding.left;
+      case 'right':
+        return totalWidth - padding.right - legendWidth;
+      default:
+        return (totalWidth - legendWidth) / 2;
+    }
+  }, [position.horizontal, padding.left, padding.right, totalWidth, legendWidth]);
+  const gapY = React.useMemo(() => {
+    switch (position.vertical) {
+      case 'top':
+        return padding.top;
+      case 'bottom':
+        return totalHeight - padding.bottom - legendHeight;
+      default:
+        return (totalHeight - legendHeight) / 2;
+    }
+  }, [position.vertical, padding.top, padding.bottom, totalHeight, legendHeight]);
+  if (hidden) {
+    return null;
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_NoSsr.NoSsr, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsLegendRoot, {
+      className: classes?.root,
+      children: itemsWithPosition.map(({
+        id,
+        label,
+        color,
+        positionX,
+        positionY
+      }) => /*#__PURE__*/(0, _jsxRuntime.jsxs)("g", {
+        className: classes?.series,
+        transform: `translate(${gapX + (isRTL ? legendWidth - positionX : positionX)} ${gapY + positionY})`,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("rect", {
+          className: classes?.mark,
+          x: isRTL ? -itemMarkWidth : 0,
+          y: -itemMarkHeight / 2,
+          width: itemMarkWidth,
+          height: itemMarkHeight,
+          fill: color
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsText.ChartsText, {
+          style: labelStyle,
+          text: label,
+          x: (isRTL ? -1 : 1) * (itemMarkWidth + markGap),
+          y: 0
+        })]
+      }, id))
+    })
+  });
+}

package/ChartsLegend/PiecewiseColorLegend.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import { ColorLegendSelector, PiecewiseLabelFormatterParams } from './legend.types';
+import { LegendPerItemProps } from './LegendPerItem';
+export interface PiecewiseColorLegendProps extends ColorLegendSelector, Omit<LegendPerItemProps, 'itemsToDisplay'> {
+    /**
+     * Hide the first item of the legend, corresponding to the [-infinity, min] piece.
+     * @default false
+     */
+    hideFirst?: boolean;
+    /**
+     * Hide the last item of the legend, corresponding to the [max, +infinity] piece.
+     * @default false
+     */
+    hideLast?: boolean;
+    /**
+     * Format the legend labels.
+     * @param {PiecewiseLabelFormatterParams} params The bound of the piece to format.
+     * @returns {string|null} The displayed label, or `null` to skip the item.
+     */
+    labelFormatter?: (params: PiecewiseLabelFormatterParams) => string | null;
+}
+declare function PiecewiseColorLegend(props: PiecewiseColorLegendProps): React.JSX.Element | null;
+declare namespace PiecewiseColorLegend {
+    var propTypes: any;
+}
+export { PiecewiseColorLegend };

package/ChartsLegend/PiecewiseColorLegend.js

@@ -0,0 +1,169 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PiecewiseColorLegend = PiecewiseColorLegend;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+var React = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _useAxis = require("./useAxis");
+var _LegendPerItem = require("./LegendPerItem");
+var _notNull = require("../internals/notNull");
+var _jsxRuntime = require("react/jsx-runtime");
+const _excluded = ["axisDirection", "axisId", "hideFirst", "hideLast", "labelFormatter"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function defaultLabelFormatter(params) {
+  if (params.min === null) {
+    return `<${params.formattedMax}`;
+  }
+  if (params.max === null) {
+    return `>${params.formattedMin}`;
+  }
+  return `${params.formattedMin}-${params.formattedMax}`;
+}
+function PiecewiseColorLegend(props) {
+  const {
+      axisDirection,
+      axisId,
+      hideFirst,
+      hideLast,
+      labelFormatter = defaultLabelFormatter
+    } = props,
+    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  const axisItem = (0, _useAxis.useAxis)({
+    axisDirection,
+    axisId
+  });
+  const colorMap = axisItem?.colorMap;
+  if (!colorMap || !colorMap.type || colorMap.type !== 'piecewise') {
+    return null;
+  }
+  const valueFormatter = v => axisItem.valueFormatter?.(v, {
+    location: 'legend'
+  }) ?? v.toLocaleString();
+  const formattedLabels = colorMap.thresholds.map(valueFormatter);
+  const itemsToDisplay = colorMap.colors.map((color, index) => {
+    const isFirst = index === 0;
+    const isLast = index === colorMap.colors.length - 1;
+    if (hideFirst && isFirst || hideLast && isLast) {
+      return null;
+    }
+    const label = labelFormatter((0, _extends2.default)({}, index === 0 ? {
+      min: null,
+      formattedMin: null
+    } : {
+      min: colorMap.thresholds[index - 1],
+      formattedMin: formattedLabels[index - 1]
+    }, index === colorMap.colors.length - 1 ? {
+      max: null,
+      formattedMax: null
+    } : {
+      max: colorMap.thresholds[index],
+      formattedMax: formattedLabels[index]
+    }));
+    if (label === null) {
+      return null;
+    }
+    return {
+      id: label,
+      color,
+      label
+    };
+  }).filter(_notNull.notNull);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_LegendPerItem.LegendPerItem, (0, _extends2.default)({}, other, {
+    itemsToDisplay: itemsToDisplay
+  }));
+}
+process.env.NODE_ENV !== "production" ? PiecewiseColorLegend.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * The axis direction containing the color configuration to represent.
+   * @default 'z'
+   */
+  axisDirection: _propTypes.default.oneOf(['x', 'y', 'z']),
+  /**
+   * The id of the axis item with the color configuration to represent.
+   * @default The first axis item.
+   */
+  axisId: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes: _propTypes.default.object,
+  /**
+   * The direction of the legend layout.
+   * The default depends on the chart.
+   */
+  direction: _propTypes.default.oneOf(['column', 'row']).isRequired,
+  /**
+   * Set to true to hide the legend.
+   * @default false
+   */
+  hidden: _propTypes.default.bool,
+  /**
+   * Hide the first item of the legend, corresponding to the [-infinity, min] piece.
+   * @default false
+   */
+  hideFirst: _propTypes.default.bool,
+  /**
+   * Hide the last item of the legend, corresponding to the [max, +infinity] piece.
+   * @default false
+   */
+  hideLast: _propTypes.default.bool,
+  /**
+   * Space between two legend items (in px).
+   * @default 10
+   */
+  itemGap: _propTypes.default.number,
+  /**
+   * Height of the item mark (in px).
+   * @default 20
+   */
+  itemMarkHeight: _propTypes.default.number,
+  /**
+   * Width of the item mark (in px).
+   * @default 20
+   */
+  itemMarkWidth: _propTypes.default.number,
+  /**
+   * Format the legend labels.
+   * @param {PiecewiseLabelFormatterParams} params The bound of the piece to format.
+   * @returns {string|null} The displayed label, or `null` to skip the item.
+   */
+  labelFormatter: _propTypes.default.func,
+  /**
+   * Style applied to legend labels.
+   * @default theme.typography.subtitle1
+   */
+  labelStyle: _propTypes.default.object,
+  /**
+   * Space between the mark and the label (in px).
+   * @default 5
+   */
+  markGap: _propTypes.default.number,
+  /**
+   * Legend padding (in px).
+   * Can either be a single number, or an object with top, left, bottom, right properties.
+   * @default 10
+   */
+  padding: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.shape({
+    bottom: _propTypes.default.number,
+    left: _propTypes.default.number,
+    right: _propTypes.default.number,
+    top: _propTypes.default.number
+  })]),
+  /**
+   * The position of the legend.
+   */
+  position: _propTypes.default.shape({
+    horizontal: _propTypes.default.oneOf(['left', 'middle', 'right']).isRequired,
+    vertical: _propTypes.default.oneOf(['bottom', 'middle', 'top']).isRequired
+  }).isRequired
+} : void 0;

package/ChartsLegend/chartsLegend.types.d.ts

@@ -0,0 +1,31 @@
+import { ChartsTextStyle } from '../ChartsText';
+export interface LegendItemParams {
+    /**
+     * The color used in the legend
+     */
+    color: string;
+    /**
+     * The label displayed in the legend
+     */
+    label: string;
+    /**
+     * The identifier of the legend element.
+     * Used for internal purpose such as `key` props
+     */
+    id: number | string;
+}
+export interface LegendItemWithPosition extends LegendItemParams {
+    positionX: number;
+    positionY: number;
+    innerHeight: number;
+    innerWidth: number;
+    outerHeight: number;
+    outerWidth: number;
+    rowIndex: number;
+}
+export type GetItemSpaceType = (label: string, inStyle?: ChartsTextStyle) => {
+    innerWidth: number;
+    innerHeight: number;
+    outerWidth: number;
+    outerHeight: number;
+};

package/ChartsLegend/chartsLegend.types.js

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