@mui/x-charts 8.0.0-alpha.12 → 8.0.0-alpha.14

package/modern/RadarChart/RadarGrid/useRadarGridData.js

@@ -0,0 +1,29 @@
+import { useRotationScale } from "../../hooks/useScale.js";
+import { useDrawingArea } from "../../hooks/useDrawingArea.js";
+import { useRadiusAxes } from "../../hooks/index.js";
+export function useRadarGridData() {
+  const rotationScale = useRotationScale();
+  const {
+    radiusAxis
+  } = useRadiusAxes();
+  const drawingArea = useDrawingArea();
+  const cx = drawingArea.left + drawingArea.width / 2;
+  const cy = drawingArea.top + drawingArea.height / 2;
+  const metrics = rotationScale.domain();
+  const angles = metrics.map(key => rotationScale(key));
+  return {
+    center: {
+      x: cx,
+      y: cy
+    },
+    corners: metrics.map((metric, dataIndex) => {
+      const radiusScale = radiusAxis[metric].scale;
+      const r = radiusScale.range()[1];
+      const angle = angles[dataIndex];
+      return {
+        x: cx + r * Math.sin(angle),
+        y: cy - r * Math.cos(angle)
+      };
+    })
+  };
+}

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesArea.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { RadarSeriesAreaProps } from "./RadarSeriesPlot.types.js";
+declare function RadarSeriesArea(props: RadarSeriesAreaProps): React.JSX.Element;
+declare namespace RadarSeriesArea {
+  var propTypes: any;
+}
+export { RadarSeriesArea };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesArea.js

@@ -0,0 +1,39 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["seriesId"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useRadarSeriesData } from "./useRadarSeriesData.js";
+import { getAreaPath } from "./getAreaPath.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+function RadarSeriesArea(props) {
+  const {
+      seriesId
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const seriesCoordinates = useRadarSeriesData(seriesId);
+  return /*#__PURE__*/_jsx(React.Fragment, {
+    children: seriesCoordinates?.map(({
+      seriesId: id,
+      points,
+      color
+    }) => /*#__PURE__*/_jsx("path", _extends({
+      d: getAreaPath(points),
+      fill: color,
+      stroke: color,
+      fillOpacity: 0.4
+    }, other), id))
+  });
+}
+process.env.NODE_ENV !== "production" ? RadarSeriesArea.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * The id of the series to display.
+   * If undefined all series are displayed.
+   */
+  seriesId: PropTypes.string
+} : void 0;
+export { RadarSeriesArea };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesMarks.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { RadarSeriesMarksProps } from "./RadarSeriesPlot.types.js";
+declare function RadarSeriesMarks(props: RadarSeriesMarksProps): React.JSX.Element;
+declare namespace RadarSeriesMarks {
+  var propTypes: any;
+}
+export { RadarSeriesMarks };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesMarks.js

@@ -0,0 +1,38 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["seriesId"];
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useRadarSeriesData } from "./useRadarSeriesData.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+function RadarSeriesMarks(props) {
+  const other = _objectWithoutPropertiesLoose(props, _excluded);
+  const seriesCoordinates = useRadarSeriesData(props.seriesId);
+  return /*#__PURE__*/_jsx(React.Fragment, {
+    children: seriesCoordinates?.map(({
+      seriesId: id,
+      points,
+      color
+    }) => /*#__PURE__*/_jsx("g", {
+      children: points.map((point, index) => /*#__PURE__*/_jsx("circle", _extends({
+        cx: point.x,
+        cy: point.y,
+        r: 5,
+        fill: color,
+        stroke: color
+      }, other), index))
+    }, id))
+  });
+}
+process.env.NODE_ENV !== "production" ? RadarSeriesMarks.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * The id of the series to display.
+   * If undefined all series are displayed.
+   */
+  seriesId: PropTypes.string
+} : void 0;
+export { RadarSeriesMarks };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesPlot.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { RadarSeriesPlotProps } from "./RadarSeriesPlot.types.js";
+declare function RadarSeriesPlot(props: RadarSeriesPlotProps): React.JSX.Element;
+declare namespace RadarSeriesPlot {
+  var propTypes: any;
+}
+export { RadarSeriesPlot };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesPlot.js

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { useRadarSeriesData } from "./useRadarSeriesData.js";
+import { getAreaPath } from "./getAreaPath.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function RadarSeriesPlot(props) {
+  const seriesCoordinates = useRadarSeriesData(props.seriesId);
+  return /*#__PURE__*/_jsx(React.Fragment, {
+    children: seriesCoordinates?.map(({
+      seriesId,
+      points,
+      color,
+      showMark
+    }) => /*#__PURE__*/_jsxs("g", {
+      children: [/*#__PURE__*/_jsx("path", {
+        d: getAreaPath(points),
+        fill: color,
+        stroke: color,
+        fillOpacity: 0.4
+      }, seriesId), showMark && points.map((point, index) => /*#__PURE__*/_jsx("circle", {
+        cx: point.x,
+        cy: point.y,
+        r: 5,
+        fill: color,
+        stroke: color
+      }, index))]
+    }, seriesId))
+  });
+}
+process.env.NODE_ENV !== "production" ? RadarSeriesPlot.propTypes = {
+  // ----------------------------- Warning --------------------------------
+  // | These PropTypes are generated from the TypeScript type definitions |
+  // | To update them edit the TypeScript types and run "pnpm proptypes"  |
+  // ----------------------------------------------------------------------
+  /**
+   * The id of the series to display.
+   * If undefined all series are displayed.
+   */
+  seriesId: PropTypes.string
+} : void 0;
+export { RadarSeriesPlot };

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesPlot.types.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+interface CommonRadarSeriesPlotProps {
+  /**
+   * The id of the series to display.
+   * If undefined all series are displayed.
+   */
+  seriesId?: string;
+}
+export interface RadarSeriesPlotProps extends CommonRadarSeriesPlotProps {}
+export interface RadarSeriesMarksProps extends CommonRadarSeriesPlotProps, React.SVGAttributes<SVGCircleElement> {}
+export interface RadarSeriesAreaProps extends CommonRadarSeriesPlotProps, React.SVGAttributes<SVGPathElement> {}
+export {};

package/modern/RadarChart/RadarSeriesPlot/RadarSeriesPlot.types.js

@@ -0,0 +1 @@
+export {};

package/modern/RadarChart/RadarSeriesPlot/getAreaPath.d.ts

@@ -0,0 +1,4 @@
+export declare function getAreaPath(points: {
+  x: number;
+  y: number;
+}[]): string;

package/modern/RadarChart/RadarSeriesPlot/getAreaPath.js

@@ -0,0 +1,3 @@
+export function getAreaPath(points) {
+  return `M ${points.map(p => `${p.x} ${p.y}`).join('L')} Z`;
+}

package/modern/RadarChart/RadarSeriesPlot/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./RadarSeriesPlot.js";
+export type * from './RadarSeriesPlot.types';
+export * from "./RadarSeriesArea.js";
+export * from "./RadarSeriesMarks.js";

package/modern/RadarChart/RadarSeriesPlot/index.js

@@ -0,0 +1,3 @@
+export * from "./RadarSeriesPlot.js";
+export * from "./RadarSeriesArea.js";
+export * from "./RadarSeriesMarks.js";

package/modern/RadarChart/RadarSeriesPlot/useRadarSeriesData.d.ts

@@ -0,0 +1,27 @@
+import { SeriesId } from "../../models/seriesType/common.js";
+/**
+ * This hook provides all the data needed to display radar series.
+ * @param querySeriesId The id of the series to display
+ * @returns
+ */
+export declare function useRadarSeriesData(querySeriesId?: SeriesId): {
+  seriesId: SeriesId;
+  isSeriesHighlighted: boolean;
+  isSeriesFaded: boolean;
+  points: {
+    x: number;
+    y: number;
+    isItemHighlighted: boolean;
+    isItemFaded: boolean;
+    dataIndex: number;
+  }[];
+  type: "radar";
+  label?: string | ((location: "tooltip" | "legend") => string) | undefined;
+  highlightScope?: Partial<import("../..").HighlightScope> | undefined;
+  labelMarkType?: "line" | "square" | "circle" | import("react").ComponentType<import("../..").ChartsLabelCustomMarkProps> | undefined;
+  showMark?: boolean | undefined;
+  data: number[];
+  color: string;
+  id: SeriesId;
+  valueFormatter: import("../../internals").SeriesValueFormatter<number>;
+}[];

package/modern/RadarChart/RadarSeriesPlot/useRadarSeriesData.js

@@ -0,0 +1,60 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import { useRotationScale } from "../../hooks/useScale.js";
+import { useDrawingArea } from "../../hooks/useDrawingArea.js";
+import { useRadarSeries } from "../../hooks/useRadarSeries.js";
+import { useRadiusAxes } from "../../hooks/useAxis.js";
+import { useItemHighlightedGetter } from "../../hooks/useItemHighlightedGetter.js";
+/**
+ * This hook provides all the data needed to display radar series.
+ * @param querySeriesId The id of the series to display
+ * @returns
+ */
+export function useRadarSeriesData(querySeriesId) {
+  const rotationScale = useRotationScale();
+  const {
+    radiusAxis
+  } = useRadiusAxes();
+  const radarSeries = useRadarSeries(querySeriesId === undefined ? undefined : [querySeriesId]);
+  const drawingArea = useDrawingArea();
+  const {
+    isFaded: isItemFaded,
+    isHighlighted: isItemHighlighted
+  } = useItemHighlightedGetter();
+  const cx = drawingArea.left + drawingArea.width / 2;
+  const cy = drawingArea.top + drawingArea.height / 2;
+  const metrics = rotationScale.domain();
+  const angles = metrics.map(key => rotationScale(key));
+  return radarSeries.map(series => {
+    const seriesId = series.id;
+    const isSeriesHighlighted = isItemHighlighted({
+      seriesId
+    });
+    const isSeriesFaded = !isSeriesHighlighted && isItemFaded({
+      seriesId
+    });
+    return _extends({}, series, {
+      seriesId: series.id,
+      isSeriesHighlighted,
+      isSeriesFaded,
+      points: series.data.map((value, dataIndex) => {
+        const highlighted = isItemHighlighted({
+          seriesId,
+          dataIndex
+        });
+        const faded = !highlighted && isItemFaded({
+          seriesId,
+          dataIndex
+        });
+        const r = radiusAxis[metrics[dataIndex]].scale(value);
+        const angle = angles[dataIndex];
+        return {
+          x: cx + r * Math.sin(angle),
+          y: cy - r * Math.cos(angle),
+          isItemHighlighted: highlighted,
+          isItemFaded: faded,
+          dataIndex
+        };
+      })
+    });
+  });
+}

package/modern/RadarChart/index.d.ts

@@ -0,0 +1,6 @@
+export { RadarChart as Unstable_RadarChart } from "./RadarChart.js";
+export { RadarDataProvider as Unstable_RadarDataProvider } from "./RadarDataProvider/index.js";
+export type { RadarChartProps } from './RadarChart';
+export type { RadarDataProviderProps } from './RadarDataProvider';
+export * from "./RadarGrid/index.js";
+export * from "./RadarSeriesPlot/index.js";

package/modern/RadarChart/index.js

@@ -0,0 +1,4 @@
+export { RadarChart as Unstable_RadarChart } from "./RadarChart.js";
+export { RadarDataProvider as Unstable_RadarDataProvider } from "./RadarDataProvider/index.js";
+export * from "./RadarGrid/index.js";
+export * from "./RadarSeriesPlot/index.js";

package/modern/RadarChart/seriesConfig/extremums.d.ts

@@ -0,0 +1,3 @@
+import { PolarExtremumGetter } from "../../internals/plugins/models/seriesConfig/index.js";
+export declare const radiusExtremumGetter: PolarExtremumGetter<'radar'>;
+export declare const rotationExtremumGetter: PolarExtremumGetter<'radar'>;

package/modern/RadarChart/seriesConfig/extremums.js

@@ -0,0 +1,18 @@
+export const radiusExtremumGetter = ({
+  series,
+  axisIndex
+}) => {
+  return Object.keys(series).filter(seriesId => series[seriesId].type === 'radar').reduce((acc, seriesId) => {
+    const {
+      data
+    } = series[seriesId];
+    return [Math.min(data[axisIndex], acc[0]), Math.max(data[axisIndex], acc[1])];
+  }, [Infinity, -Infinity]);
+};
+export const rotationExtremumGetter = ({
+  axis
+}) => {
+  const min = Math.min(...(axis.data ?? []));
+  const max = Math.max(...(axis.data ?? []));
+  return [min, max];
+};

package/modern/RadarChart/seriesConfig/formatter.d.ts

@@ -0,0 +1,3 @@
+import { SeriesProcessor } from "../../internals/plugins/models/seriesConfig/index.js";
+declare const formatter: SeriesProcessor<'radar'>;
+export default formatter;

package/modern/RadarChart/seriesConfig/formatter.js

@@ -0,0 +1,12 @@
+import { defaultizeValueFormatter } from "../../internals/defaultizeValueFormatter.js";
+const formatter = params => {
+  const {
+    seriesOrder,
+    series
+  } = params;
+  return {
+    seriesOrder,
+    series: defaultizeValueFormatter(series, v => v == null ? '' : v.toLocaleString())
+  };
+};
+export default formatter;

package/modern/RadarChart/seriesConfig/getColor.d.ts

@@ -0,0 +1,3 @@
+import { ColorProcessor } from "../../internals/plugins/models/seriesConfig/index.js";
+declare const getColor: ColorProcessor<'radar'>;
+export default getColor;

package/modern/RadarChart/seriesConfig/getColor.js

@@ -0,0 +1,4 @@
+const getColor = series => {
+  return () => series.color;
+};
+export default getColor;

package/modern/RadarChart/seriesConfig/getSeriesWithDefaultValues.d.ts

@@ -0,0 +1,3 @@
+import type { GetSeriesWithDefaultValues } from '../../internals/plugins/models/seriesConfig';
+declare const getSeriesWithDefaultValues: GetSeriesWithDefaultValues<'radar'>;
+export default getSeriesWithDefaultValues;

package/modern/RadarChart/seriesConfig/getSeriesWithDefaultValues.js

@@ -0,0 +1,8 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+const getSeriesWithDefaultValues = (seriesData, seriesIndex, colors) => {
+  return _extends({
+    id: seriesData.id ?? `auto-generated-id-${seriesIndex}`,
+    color: colors[seriesIndex % colors.length]
+  }, seriesData);
+};
+export default getSeriesWithDefaultValues;

package/modern/RadarChart/seriesConfig/index.d.ts

@@ -0,0 +1,2 @@
+import { ChartSeriesTypeConfig } from "../../internals/plugins/models/seriesConfig/index.js";
+export declare const radarSeriesConfig: ChartSeriesTypeConfig<'radar'>;

package/modern/RadarChart/seriesConfig/index.js

@@ -0,0 +1,15 @@
+import formatter from "./formatter.js";
+import getColor from "./getColor.js";
+import { radiusExtremumGetter, rotationExtremumGetter } from "./extremums.js";
+import legendGetter from "./legend.js";
+import tooltipGetter from "./tooltip.js";
+import getSeriesWithDefaultValues from "./getSeriesWithDefaultValues.js";
+export const radarSeriesConfig = {
+  colorProcessor: getColor,
+  seriesProcessor: formatter,
+  legendGetter,
+  tooltipGetter,
+  getSeriesWithDefaultValues,
+  radiusExtremumGetter,
+  rotationExtremumGetter
+};

package/modern/RadarChart/seriesConfig/legend.d.ts

@@ -0,0 +1,3 @@
+import { LegendGetter } from "../../internals/plugins/models/seriesConfig/index.js";
+declare const legendGetter: LegendGetter<'radar'>;
+export default legendGetter;

package/modern/RadarChart/seriesConfig/legend.js

@@ -0,0 +1,22 @@
+import { getLabel } from "../../internals/getLabel.js";
+const legendGetter = params => {
+  const {
+    seriesOrder,
+    series
+  } = params;
+  return seriesOrder.reduce((acc, seriesId) => {
+    const formattedLabel = getLabel(series[seriesId].label, 'legend');
+    if (formattedLabel === undefined) {
+      return acc;
+    }
+    acc.push({
+      id: seriesId,
+      seriesId,
+      color: series[seriesId].color,
+      label: formattedLabel,
+      markType: series[seriesId].labelMarkType ?? 'square'
+    });
+    return acc;
+  }, []);
+};
+export default legendGetter;

package/modern/RadarChart/seriesConfig/tooltip.d.ts

@@ -0,0 +1,3 @@
+import type { TooltipGetter } from '../../internals/plugins/models';
+declare const tooltipGetter: TooltipGetter<'radar'>;
+export default tooltipGetter;

package/modern/RadarChart/seriesConfig/tooltip.js

@@ -0,0 +1,25 @@
+import { getLabel } from "../../internals/getLabel.js";
+const tooltipGetter = params => {
+  const {
+    series,
+    getColor,
+    identifier
+  } = params;
+  if (!identifier || identifier.dataIndex === undefined) {
+    return null;
+  }
+  const label = getLabel(series.label, 'tooltip');
+  const value = series.data[identifier.dataIndex];
+  const formattedValue = series.valueFormatter(value, {
+    dataIndex: identifier.dataIndex
+  });
+  return {
+    identifier,
+    color: getColor(identifier.dataIndex),
+    label,
+    value,
+    formattedValue,
+    markType: series.labelMarkType
+  };
+};
+export default tooltipGetter;

package/modern/RadarChart/useRadarChartProps.d.ts

@@ -0,0 +1,23 @@
+import type { RadarChartProps } from './RadarChart';
+import { ChartsOverlayProps } from "../ChartsOverlay/index.js";
+import { ChartsLegendSlotExtension } from "../ChartsLegend/index.js";
+import type { ChartsWrapperProps } from '../internals/components/ChartsWrapper';
+import { RadarDataProviderProps } from "./RadarDataProvider/RadarDataProvider.js";
+import { ChartsSurfaceProps } from "../ChartsSurface/index.js";
+import { RadarGridProps } from "./RadarGrid/RadarGrid.js";
+/**
+ * A helper function that extracts RadarChartProps from the input props
+ * and returns an object with props for the children components of RadarChart.
+ *
+ * @param props The input props for RadarChart
+ * @returns An object with props for the children components of RadarChart
+ */
+export declare const useRadarChartProps: (props: RadarChartProps) => {
+  chartsWrapperProps: Omit<ChartsWrapperProps, "children">;
+  chartsSurfaceProps: ChartsSurfaceProps;
+  radarDataProviderProps: RadarDataProviderProps;
+  radarGrid: RadarGridProps;
+  overlayProps: ChartsOverlayProps;
+  legendProps: ChartsLegendSlotExtension;
+  children: import("react").ReactNode;
+};

package/modern/RadarChart/useRadarChartProps.js

@@ -0,0 +1,67 @@
+'use client';
+
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["series", "radar", "width", "height", "margin", "colors", "sx", "children", "slots", "slotProps", "skipAnimation", "loading", "highlightedItem", "onHighlightChange", "hideLegend", "divisions"];
+/**
+ * A helper function that extracts RadarChartProps from the input props
+ * and returns an object with props for the children components of RadarChart.
+ *
+ * @param props The input props for RadarChart
+ * @returns An object with props for the children components of RadarChart
+ */
+export const useRadarChartProps = props => {
+  const {
+      series,
+      radar,
+      width,
+      height,
+      margin,
+      colors,
+      sx,
+      children,
+      slots,
+      slotProps,
+      skipAnimation,
+      loading,
+      highlightedItem,
+      onHighlightChange,
+      divisions
+    } = props,
+    other = _objectWithoutPropertiesLoose(props, _excluded);
+  const radarDataProviderProps = {
+    series,
+    radar,
+    width,
+    height,
+    margin,
+    colors,
+    highlightedItem,
+    onHighlightChange,
+    skipAnimation
+  };
+  const overlayProps = {
+    slots,
+    slotProps,
+    loading
+  };
+  const legendProps = {
+    slots,
+    slotProps
+  };
+  const chartsWrapperProps = {
+    sx
+  };
+  const radarGrid = {
+    divisions
+  };
+  const chartsSurfaceProps = other;
+  return {
+    chartsWrapperProps,
+    chartsSurfaceProps,
+    radarDataProviderProps,
+    radarGrid,
+    overlayProps,
+    legendProps,
+    children
+  };
+};

package/modern/ScatterChart/ScatterChart.d.ts

@@ -19,7 +19,7 @@ export interface ScatterChartProps extends Omit<ChartContainerProps<'scatter', S
    * The series to display in the scatter chart.
    * An array of [[ScatterSeriesType]] objects.
    */
-  series: MakeOptional<ScatterSeriesType, 'type'>[];
+  series: Readonly<MakeOptional<ScatterSeriesType, 'type'>[]>;
   /**
    * The configuration of axes highlight.
    * @see See {@link https://mui.com/x/react-charts/highlighting/ highlighting docs} for more details.