@mui/x-charts 7.14.0 → 7.16.0

package/ChartsLegend/ContinuousColorLegend.js

@@ -1,24 +1,16 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ContinuousColorLegend = ContinuousColorLegend;
-var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var React = _interopRequireWildcard(require("react"));
-var _propTypes = _interopRequireDefault(require("prop-types"));
-var _styles = require("@mui/material/styles");
-var _ChartsContinuousGradient = _interopRequireDefault(require("../internals/components/ChartsAxesGradients/ChartsContinuousGradient"));
-var _hooks = require("../hooks");
-var _getScale = require("../internals/getScale");
-var _getPercentageValue = require("../internals/getPercentageValue");
-var _ChartsText = require("../ChartsText");
-var _domUtils = require("../internals/domUtils");
-var _useAxis = require("./useAxis");
-var _jsxRuntime = require("react/jsx-runtime");
-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; }
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useTheme } from '@mui/material/styles';
+import { useRtl } from '@mui/system/RtlProvider';
+import ChartsContinuousGradient from "../internals/components/ChartsAxesGradients/ChartsContinuousGradient.js";
+import { useChartId, useDrawingArea } from "../hooks/index.js";
+import { getScale } from "../internals/getScale.js";
+import { getPercentageValue } from "../internals/getPercentageValue.js";
+import { ChartsText } from "../ChartsText/index.js";
+import { getStringSize } from "../internals/domUtils.js";
+import { useAxis } from "./useAxis.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 function getPositionOffset(position, legendBox, svgBox) {
   let offsetX = 0;
   let offsetY = 0;
@@ -78,30 +70,30 @@ function getElementPositions(text1Box, barBox, text2Box, params) {
     switch (params.align) {
       case 'start':
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             textAnchor: 'start',
             x: 0
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             textAnchor: 'start',
             x: 0
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             x: 0
           }),
           boundingBox
         };
       case 'end':
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             textAnchor: 'end',
             x: totalWidth
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             textAnchor: 'end',
             x: totalWidth
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             x: totalWidth - barBox.width
           }),
           boundingBox
@@ -109,15 +101,15 @@ function getElementPositions(text1Box, barBox, text2Box, params) {
       case 'middle':
       default:
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             textAnchor: 'middle',
             x: totalWidth / 2
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             textAnchor: 'middle',
             x: totalWidth / 2
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             x: totalWidth / 2 - barBox.width / 2
           }),
           boundingBox
@@ -144,30 +136,30 @@ function getElementPositions(text1Box, barBox, text2Box, params) {
     switch (params.align) {
       case 'start':
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             dominantBaseline: 'hanging',
             y: 0
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             dominantBaseline: 'hanging',
             y: 0
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             y: 0
           }),
           boundingBox
         };
       case 'end':
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             dominantBaseline: 'auto',
             y: totalHeight
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             dominantBaseline: 'auto',
             y: totalHeight
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             y: totalHeight - barBox.height
           }),
           boundingBox
@@ -175,15 +167,15 @@ function getElementPositions(text1Box, barBox, text2Box, params) {
       case 'middle':
       default:
         return {
-          text1: (0, _extends2.default)({}, text1, {
+          text1: _extends({}, text1, {
             dominantBaseline: 'central',
             y: totalHeight / 2
           }),
-          text2: (0, _extends2.default)({}, text2, {
+          text2: _extends({}, text2, {
             dominantBaseline: 'central',
             y: totalHeight / 2
           }),
-          bar: (0, _extends2.default)({}, bar, {
+          bar: _extends({}, bar, {
             y: totalHeight / 2 - barBox.height / 2
           }),
           boundingBox
@@ -195,7 +187,8 @@ const defaultLabelFormatter = ({
   formattedValue
 }) => formattedValue;
 function ContinuousColorLegend(props) {
-  const theme = (0, _styles.useTheme)();
+  const theme = useTheme();
+  const isRtl = useRtl();
   const {
     id: idProp,
     minLabel = defaultLabelFormatter,
@@ -211,10 +204,9 @@ function ContinuousColorLegend(props) {
     axisDirection,
     axisId
   } = props;
-  const chartId = (0, _hooks.useChartId)();
+  const chartId = useChartId();
   const id = idProp ?? `gradient-legend-${chartId}`;
-  const isRTL = theme.direction === 'rtl';
-  const axisItem = (0, _useAxis.useAxis)({
+  const axisItem = useAxis({
     axisDirection,
     axisId
   });
@@ -225,9 +217,9 @@ function ContinuousColorLegend(props) {
     right,
     top,
     bottom
-  } = (0, _hooks.useDrawingArea)();
+  } = useDrawingArea();
   const refLength = direction === 'column' ? height + top + bottom : width + left + right;
-  const size = (0, _getPercentageValue.getPercentageValue)(length, refLength);
+  const size = getPercentageValue(length, refLength);
   const isReversed = direction === 'column';
   const colorMap = axisItem?.colorMap;
   if (!colorMap || !colorMap.type || colorMap.type !== 'continuous') {
@@ -239,7 +231,7 @@ function ContinuousColorLegend(props) {
   const colorScale = axisItem.colorScale;
   const minValue = colorMap.min ?? 0;
   const maxValue = colorMap.max ?? 100;
-  const scale = (0, _getScale.getScale)(scaleType, [minValue, maxValue], isReversed ? [size, 0] : [0, size]);
+  const scale = getScale(scaleType, [minValue, maxValue], isReversed ? [size, 0] : [0, size]);
 
   // Get texts to display
 
@@ -259,12 +251,12 @@ function ContinuousColorLegend(props) {
   });
   const text1 = isReversed ? maxText : minText;
   const text2 = isReversed ? minText : maxText;
-  const text1Box = (0, _domUtils.getStringSize)(text1, (0, _extends2.default)({}, labelStyle));
-  const text2Box = (0, _domUtils.getStringSize)(text2, (0, _extends2.default)({}, labelStyle));
+  const text1Box = getStringSize(text1, _extends({}, labelStyle));
+  const text2Box = getStringSize(text2, _extends({}, labelStyle));
 
   // Place bar and texts
 
-  const barBox = direction === 'column' || isRTL && direction === 'row' ? {
+  const barBox = direction === 'column' || isRtl && direction === 'row' ? {
     width: thickness,
     height: size
   } : {
@@ -280,12 +272,12 @@ function ContinuousColorLegend(props) {
     width: width + left + right,
     height: height + top + bottom
   };
-  const positionOffset = getPositionOffset((0, _extends2.default)({
+  const positionOffset = getPositionOffset(_extends({
     horizontal: 'middle',
     vertical: 'top'
   }, position), legendPositions.boundingBox, svgBoundingBox);
-  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
-    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsContinuousGradient.default, {
+  return /*#__PURE__*/_jsxs(React.Fragment, {
+    children: [/*#__PURE__*/_jsx(ChartsContinuousGradient, {
       isReversed: isReversed,
       gradientId: id,
       size: size,
@@ -294,24 +286,24 @@ function ContinuousColorLegend(props) {
       colorScale: colorScale,
       colorMap: colorMap,
       gradientUnits: "objectBoundingBox"
-    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsText.ChartsText, {
+    }), /*#__PURE__*/_jsx(ChartsText, {
       text: text1,
       x: positionOffset.offsetX + legendPositions.text1.x,
       y: positionOffset.offsetY + legendPositions.text1.y,
-      style: (0, _extends2.default)({
+      style: _extends({
         dominantBaseline: legendPositions.text1.dominantBaseline,
         textAnchor: legendPositions.text1.textAnchor
       }, labelStyle)
-    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("rect", (0, _extends2.default)({
+    }), /*#__PURE__*/_jsx("rect", _extends({
       x: positionOffset.offsetX + legendPositions.bar.x,
       y: positionOffset.offsetY + legendPositions.bar.y
     }, barBox, {
       fill: `url(#${id})`
-    })), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsText.ChartsText, {
+    })), /*#__PURE__*/_jsx(ChartsText, {
       text: text2,
       x: positionOffset.offsetX + legendPositions.text2.x,
       y: positionOffset.offsetY + legendPositions.text2.y,
-      style: (0, _extends2.default)({
+      style: _extends({
         dominantBaseline: legendPositions.text2.dominantBaseline,
         textAnchor: legendPositions.text2.textAnchor
       }, labelStyle)
@@ -327,72 +319,73 @@ process.env.NODE_ENV !== "production" ? ContinuousColorLegend.propTypes = {
    * The alignment of the texts with the gradient bar.
    * @default 'middle'
    */
-  align: _propTypes.default.oneOf(['end', 'middle', 'start']),
+  align: PropTypes.oneOf(['end', 'middle', 'start']),
   /**
    * The axis direction containing the color configuration to represent.
    * @default 'z'
    */
-  axisDirection: _propTypes.default.oneOf(['x', 'y', 'z']),
+  axisDirection: PropTypes.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]),
+  axisId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
   /**
    * The direction of the legend layout.
    * The default depends on the chart.
    */
-  direction: _propTypes.default.oneOf(['column', 'row']),
+  direction: PropTypes.oneOf(['column', 'row']),
   /**
    * A unique identifier for the gradient.
    * @default auto-generated id
    */
-  id: _propTypes.default.string,
+  id: PropTypes.string,
   /**
    * The style applied to labels.
    * @default theme.typography.subtitle1
    */
-  labelStyle: _propTypes.default.object,
+  labelStyle: PropTypes.object,
   /**
    * The length of the gradient bar.
    * Can be a number (in px) or a string with a percentage such as '50%'.
    * The '100%' is the length of the svg.
    * @default '50%'
    */
-  length: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
+  length: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
   /**
    * The label to display at the maximum side of the gradient.
    * Can either be a string, or a function.
    * If not defined, the formatted maximal value is display.
    * @default ({ formattedValue }) => formattedValue
    */
-  maxLabel: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.string]),
+  maxLabel: PropTypes.oneOfType([PropTypes.func, PropTypes.string]),
   /**
    * The label to display at the minimum side of the gradient.
    * Can either be a string, or a function.
    * @default ({ formattedValue }) => formattedValue
    */
-  minLabel: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.string]),
+  minLabel: PropTypes.oneOfType([PropTypes.func, PropTypes.string]),
   /**
    * 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
+  position: PropTypes.shape({
+    horizontal: PropTypes.oneOf(['left', 'middle', 'right']).isRequired,
+    vertical: PropTypes.oneOf(['bottom', 'middle', 'top']).isRequired
   }),
   /**
    * The scale used to display gradient colors.
    * @default 'linear'
    */
-  scaleType: _propTypes.default.oneOf(['linear', 'log', 'pow', 'sqrt', 'time', 'utc']),
+  scaleType: PropTypes.oneOf(['linear', 'log', 'pow', 'sqrt', 'time', 'utc']),
   /**
    * The space between the gradient bar and the labels.
    * @default 4
    */
-  spacing: _propTypes.default.number,
+  spacing: PropTypes.number,
   /**
    * The thickness of the gradient bar.
    * @default 5
    */
-  thickness: _propTypes.default.number
-} : void 0;
+  thickness: PropTypes.number
+} : void 0;
+export { ContinuousColorLegend };

package/ChartsLegend/DefaultChartsLegend.d.ts

@@ -9,8 +9,13 @@ export interface LegendRendererProps extends Omit<LegendPerItemProps, 'itemsToDi
      * @deprecated Use the `useDrawingArea` hook instead.
      */
     drawingArea: Omit<DrawingArea, 'isPointInside'>;
+    /**
+     * Set to true to hide the legend.
+     * @default false
+     */
+    hidden?: boolean;
 }
-declare function DefaultChartsLegend(props: LegendRendererProps): React.JSX.Element;
+declare function DefaultChartsLegend(props: LegendRendererProps): React.JSX.Element | null;
 declare namespace DefaultChartsLegend {
     var propTypes: any;
 }

package/ChartsLegend/DefaultChartsLegend.js

@@ -1,25 +1,20 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DefaultChartsLegend = DefaultChartsLegend;
-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 _LegendPerItem = require("./LegendPerItem");
-var _jsxRuntime = require("react/jsx-runtime");
-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; }
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["drawingArea", "seriesToDisplay", "hidden"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { LegendPerItem } from "./LegendPerItem.js";
+import { jsx as _jsx } from "react/jsx-runtime";
 function DefaultChartsLegend(props) {
   const {
-      seriesToDisplay
+      seriesToDisplay,
+      hidden
     } = props,
-    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_LegendPerItem.LegendPerItem, (0, _extends2.default)({}, other, {
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  if (hidden) {
+    return null;
+  }
+  return /*#__PURE__*/_jsx(LegendPerItem, _extends({}, other, {
     itemsToDisplay: seriesToDisplay
   }));
 }
@@ -31,75 +26,76 @@ process.env.NODE_ENV !== "production" ? DefaultChartsLegend.propTypes = {
   /**
    * Override or extend the styles applied to the component.
    */
-  classes: _propTypes.default.object,
+  classes: PropTypes.object,
   /**
    * The direction of the legend layout.
    * The default depends on the chart.
    */
-  direction: _propTypes.default.oneOf(['column', 'row']).isRequired,
+  direction: PropTypes.oneOf(['column', 'row']).isRequired,
   /**
    * @deprecated Use the `useDrawingArea` hook instead.
    */
-  drawingArea: _propTypes.default.shape({
-    bottom: _propTypes.default.number.isRequired,
-    height: _propTypes.default.number.isRequired,
-    left: _propTypes.default.number.isRequired,
-    right: _propTypes.default.number.isRequired,
-    top: _propTypes.default.number.isRequired,
-    width: _propTypes.default.number.isRequired
+  drawingArea: PropTypes.shape({
+    bottom: PropTypes.number.isRequired,
+    height: PropTypes.number.isRequired,
+    left: PropTypes.number.isRequired,
+    right: PropTypes.number.isRequired,
+    top: PropTypes.number.isRequired,
+    width: PropTypes.number.isRequired
   }).isRequired,
   /**
    * Set to true to hide the legend.
    * @default false
    */
-  hidden: _propTypes.default.bool,
+  hidden: PropTypes.bool,
   /**
    * Space between two legend items (in px).
    * @default 10
    */
-  itemGap: _propTypes.default.number,
+  itemGap: PropTypes.number,
   /**
    * Height of the item mark (in px).
    * @default 20
    */
-  itemMarkHeight: _propTypes.default.number,
+  itemMarkHeight: PropTypes.number,
   /**
    * Width of the item mark (in px).
    * @default 20
    */
-  itemMarkWidth: _propTypes.default.number,
+  itemMarkWidth: PropTypes.number,
   /**
    * Style applied to legend labels.
    * @default theme.typography.subtitle1
    */
-  labelStyle: _propTypes.default.object,
+  labelStyle: PropTypes.object,
   /**
    * Space between the mark and the label (in px).
    * @default 5
    */
-  markGap: _propTypes.default.number,
+  markGap: PropTypes.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
+  padding: PropTypes.oneOfType([PropTypes.number, PropTypes.shape({
+    bottom: PropTypes.number,
+    left: PropTypes.number,
+    right: PropTypes.number,
+    top: PropTypes.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
+  position: PropTypes.shape({
+    horizontal: PropTypes.oneOf(['left', 'middle', 'right']).isRequired,
+    vertical: PropTypes.oneOf(['bottom', 'middle', 'top']).isRequired
   }).isRequired,
-  series: _propTypes.default.object.isRequired,
-  seriesToDisplay: _propTypes.default.arrayOf(_propTypes.default.shape({
-    color: _propTypes.default.string.isRequired,
-    id: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]).isRequired,
-    label: _propTypes.default.string.isRequired
+  series: PropTypes.object.isRequired,
+  seriesToDisplay: PropTypes.arrayOf(PropTypes.shape({
+    color: PropTypes.string.isRequired,
+    id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    label: PropTypes.string.isRequired
   })).isRequired
-} : void 0;
+} : void 0;
+export { DefaultChartsLegend };

package/ChartsLegend/LegendPerItem.d.ts

@@ -1,11 +1,11 @@
 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';
+import { AnchorPosition, Direction, LegendPlacement } from './legend.types';
+import { ChartsLegendClasses } from './chartsLegendClasses';
+import { DefaultizedProps } from '../models/helpers';
 export type ChartsLegendRootOwnerState = {
     position: AnchorPosition;
     direction: Direction;
@@ -15,12 +15,15 @@ export type ChartsLegendRootOwnerState = {
     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'> {
+export interface LegendPerItemProps extends DefaultizedProps<LegendPlacement, keyof LegendPlacement> {
     /**
      * The ordered array of item to display in the legend.
      */
     itemsToDisplay: LegendItemParams[];
-    classes?: Record<'mark' | 'series' | 'root', string>;
+    /**
+     * Override or extend the styles applied to the component.
+     */
+    classes?: Partial<ChartsLegendClasses>;
     /**
      * Style applied to legend labels.
      * @default theme.typography.subtitle1
@@ -58,4 +61,4 @@ export interface LegendPerItemProps extends DefaultizedProps<Omit<ChartsLegendPr
  * Used for series legend, and threshold color legend.
  * @ignore - Do not document
  */
-export declare function LegendPerItem(props: LegendPerItemProps): React.JSX.Element | null;
+export declare function LegendPerItem(props: LegendPerItemProps): React.JSX.Element;