@mui/x-charts 7.2.0 → 7.3.1

package/modern/hooks/useSeries.js

@@ -0,0 +1,64 @@
+import * as React from 'react';
+import { SeriesContext } from '../context/SeriesContextProvider';
+
+/**
+ * Get access to the internal state of series.
+ * Structured by type of series:
+ * { seriesType?: { series: { id1: precessedValue, ... }, seriesOrder: [id1, ...] } }
+ * @returns FormattedSeries series
+ */
+export function useSeries() {
+  const series = React.useContext(SeriesContext);
+  if (series === undefined) {
+    throw new Error(['MUI X: Could not find the series ref context.', 'It looks like you rendered your component outside of a ChartsContainer parent component.'].join('\n'));
+  }
+  return series;
+}
+
+/**
+ * Get access to the internal state of pie series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns { series: Record<SeriesId, DefaultizedPieSeriesType>; seriesOrder: SeriesId[]; } | undefined pieSeries
+ */
+export function usePieSeries() {
+  const series = useSeries();
+  return React.useMemo(() => series.pie, [series.pie]);
+}
+
+/**
+ * Get access to the internal state of line series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns { series: Record<SeriesId, DefaultizedLineSeriesType>; seriesOrder: SeriesId[]; } | undefined lineSeries
+ */
+export function useLineSeries() {
+  const series = useSeries();
+  return React.useMemo(() => series.line, [series.line]);
+}
+
+/**
+ * Get access to the internal state of bar series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns { series: Record<SeriesId, DefaultizedBarSeriesType>; seriesOrder: SeriesId[]; } | undefined barSeries
+ */
+export function useBarSeries() {
+  const series = useSeries();
+  return React.useMemo(() => series.bar, [series.bar]);
+}
+
+/**
+ * Get access to the internal state of scatter series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns { series: Record<SeriesId, DefaultizedScatterSeriesType>; seriesOrder: SeriesId[]; } | undefined scatterSeries
+ */
+export function useScatterSeries() {
+  const series = useSeries();
+  return React.useMemo(() => series.scatter, [series.scatter]);
+}

package/modern/hooks/useSvgRef.js

@@ -0,0 +1,9 @@
+import * as React from 'react';
+import { SvgContext } from '../context/DrawingProvider';
+export function useSvgRef() {
+  const svgRef = React.useContext(SvgContext);
+  if (svgRef === undefined) {
+    throw new Error(['MUI X: Could not find the svg ref context.', 'It looks like you rendered your component outside of a ChartsContainer parent component.'].join('\n'));
+  }
+  return svgRef;
+}

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-charts v7.2.0
+ * @mui/x-charts v7.3.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/internals/colorGetter.js

@@ -0,0 +1,22 @@
+import getBarColor from '../BarChart/getColor';
+import getLineColor from '../LineChart/getColor';
+import getScatterColor from '../ScatterChart/getColor';
+import getPieColor from '../PieChart/getColor';
+function getColor(series, xAxis, yAxis, zAxis) {
+  if (xAxis !== undefined && yAxis !== undefined) {
+    if (series.type === 'bar') {
+      return getBarColor(series, xAxis, yAxis);
+    }
+    if (series.type === 'line') {
+      return getLineColor(series, xAxis, yAxis);
+    }
+    if (series.type === 'scatter') {
+      return getScatterColor(series, xAxis, yAxis, zAxis);
+    }
+  }
+  if (series.type === 'pie') {
+    return getPieColor(series);
+  }
+  throw Error(`MUI X Charts: getColor called with unexpected arguments for series with id "${series.id}"`);
+}
+export default getColor;

package/modern/internals/colorScale.js

@@ -0,0 +1,16 @@
+import { scaleOrdinal, scaleThreshold, scaleSequential } from 'd3-scale';
+export function getSequentialColorScale(config) {
+  if (config.type === 'piecewise') {
+    return scaleThreshold(config.thresholds, config.colors);
+  }
+  return scaleSequential([config.min ?? 0, config.max ?? 100], config.color);
+}
+export function getOrdinalColorScale(config) {
+  if (config.values) {
+    return scaleOrdinal(config.values, config.colors).unknown(config.unknownColor ?? null);
+  }
+  return scaleOrdinal(config.colors.map((_, index) => index), config.colors).unknown(config.unknownColor ?? null);
+}
+export function getColorScale(config) {
+  return config.type === 'ordinal' ? getOrdinalColorScale(config) : getSequentialColorScale(config);
+}

package/modern/internals/components/ChartsAxesGradients/ChartsAxesGradients.js

@@ -0,0 +1,95 @@
+import * as React from 'react';
+import { CartesianContext } from '../../../context/CartesianContextProvider';
+import { DrawingContext } from '../../../context/DrawingProvider';
+import { useDrawingArea } from '../../../hooks';
+import ChartsPiecewiseGradient from './ChartsPiecewiseGradient';
+import ChartsContinuousGradient from './ChartsContinuousGradient';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function useChartGradient() {
+  const {
+    chartId
+  } = React.useContext(DrawingContext);
+  return React.useCallback((axisId, direction) => `${chartId}-graient-${direction}-${axisId}`, [chartId]);
+}
+export function ChartsAxesGradients() {
+  const {
+    top,
+    height,
+    bottom,
+    left,
+    width,
+    right
+  } = useDrawingArea();
+  const svgHeight = top + height + bottom;
+  const svgWidth = left + width + right;
+  const getGradientId = useChartGradient();
+  const {
+    xAxisIds,
+    xAxis,
+    yAxisIds,
+    yAxis
+  } = React.useContext(CartesianContext);
+  return /*#__PURE__*/_jsxs("defs", {
+    children: [yAxisIds.filter(axisId => yAxis[axisId].colorMap !== undefined).map(axisId => {
+      const gradientId = getGradientId(axisId, 'y');
+      const {
+        colorMap,
+        scale,
+        colorScale,
+        reverse
+      } = yAxis[axisId];
+      if (colorMap?.type === 'piecewise') {
+        return /*#__PURE__*/_jsx(ChartsPiecewiseGradient, {
+          isReveresed: !reverse,
+          scale: scale,
+          colorMap: colorMap,
+          size: svgHeight,
+          gradientId: gradientId,
+          direction: "y"
+        }, gradientId);
+      }
+      if (colorMap?.type === 'continuous') {
+        return /*#__PURE__*/_jsx(ChartsContinuousGradient, {
+          isReveresed: !reverse,
+          scale: scale,
+          colorScale: colorScale,
+          colorMap: colorMap,
+          size: svgHeight,
+          gradientId: gradientId,
+          direction: "y"
+        }, gradientId);
+      }
+      return null;
+    }), xAxisIds.filter(axisId => xAxis[axisId].colorMap !== undefined).map(axisId => {
+      const gradientId = getGradientId(axisId, 'x');
+      const {
+        colorMap,
+        scale,
+        reverse,
+        colorScale
+      } = xAxis[axisId];
+      if (colorMap?.type === 'piecewise') {
+        return /*#__PURE__*/_jsx(ChartsPiecewiseGradient, {
+          isReveresed: reverse,
+          scale: scale,
+          colorMap: colorMap,
+          size: svgWidth,
+          gradientId: gradientId,
+          direction: "x"
+        }, gradientId);
+      }
+      if (colorMap?.type === 'continuous') {
+        return /*#__PURE__*/_jsx(ChartsContinuousGradient, {
+          isReveresed: reverse,
+          scale: scale,
+          colorScale: colorScale,
+          colorMap: colorMap,
+          size: svgWidth,
+          gradientId: gradientId,
+          direction: "x"
+        }, gradientId);
+      }
+      return null;
+    })]
+  });
+}

package/modern/internals/components/ChartsAxesGradients/ChartsContinuousGradient.js

@@ -0,0 +1,55 @@
+import * as React from 'react';
+import { interpolateDate, interpolateNumber } from 'd3-interpolate';
+import { jsx as _jsx } from "react/jsx-runtime";
+const PX_PRECISION = 10;
+export default function ChartsContinuousGradient(props) {
+  const {
+    isReveresed,
+    gradientId,
+    size,
+    direction,
+    scale,
+    colorScale,
+    colorMap
+  } = props;
+  const extremValues = [colorMap.min ?? 0, colorMap.max ?? 100];
+  const extremPositions = extremValues.map(scale).filter(p => p !== undefined);
+  if (extremPositions.length !== 2) {
+    return null;
+  }
+  const interpolator = typeof extremValues[0] === 'number' ? interpolateNumber(extremValues[0], extremValues[1]) : interpolateDate(extremValues[0], extremValues[1]);
+  const numberOfPoints = Math.round((Math.max(...extremPositions) - Math.min(...extremPositions)) / PX_PRECISION);
+  const keyPrefix = `${extremValues[0]}-${extremValues[1]}-`;
+  return /*#__PURE__*/_jsx("linearGradient", {
+    id: gradientId,
+    x1: "0",
+    x2: "0",
+    y1: "0",
+    y2: "0",
+    [`${direction}${isReveresed ? 1 : 2}`]: `${size}px`,
+    gradientUnits: "userSpaceOnUse" // Use the SVG coordinate instead of the component ones.
+    ,
+    children: Array.from({
+      length: numberOfPoints + 1
+    }, (_, index) => {
+      const value = interpolator(index / numberOfPoints);
+      if (value === undefined) {
+        return null;
+      }
+      const x = scale(value);
+      if (x === undefined) {
+        return null;
+      }
+      const offset = isReveresed ? 1 - x / size : x / size;
+      const color = colorScale(value);
+      if (color === null) {
+        return null;
+      }
+      return /*#__PURE__*/_jsx("stop", {
+        offset: offset,
+        stopColor: color,
+        stopOpacity: 1
+      }, keyPrefix + index);
+    })
+  });
+}

package/modern/internals/components/ChartsAxesGradients/ChartsPiecewiseGradient.js

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export default function ChartsPiecewiseGradient(props) {
+  const {
+    isReveresed,
+    gradientId,
+    size,
+    direction,
+    scale,
+    colorMap
+  } = props;
+  return /*#__PURE__*/_jsx("linearGradient", {
+    id: gradientId,
+    x1: "0",
+    x2: "0",
+    y1: "0",
+    y2: "0",
+    [`${direction}${isReveresed ? 1 : 2}`]: `${size}px`,
+    gradientUnits: "userSpaceOnUse" // Use the SVG coordinate instead of the component ones.
+    ,
+    children: colorMap.thresholds.map((threshold, index) => {
+      const x = scale(threshold);
+      if (x === undefined) {
+        return null;
+      }
+      const offset = isReveresed ? 1 - x / size : x / size;
+      return /*#__PURE__*/_jsxs(React.Fragment, {
+        children: [/*#__PURE__*/_jsx("stop", {
+          offset: offset,
+          stopColor: colorMap.colors[index],
+          stopOpacity: 1
+        }), /*#__PURE__*/_jsx("stop", {
+          offset: offset,
+          stopColor: colorMap.colors[index + 1],
+          stopOpacity: 1
+        })]
+      }, threshold.toString() + index);
+    })
+  });
+}

package/modern/internals/components/ChartsAxesGradients/index.js

@@ -0,0 +1 @@
+export * from './ChartsAxesGradients';

package/modern/models/colorMapping.js

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

package/modern/models/seriesType/index.js

@@ -2,4 +2,9 @@ export * from './line';
 export * from './bar';
 export * from './scatter';
 export * from './pie';
-export {};
+export function isDefaultizedBarSeries(series) {
+  return series.type === 'bar';
+}
+export function isBarSeries(series) {
+  return series.type === 'bar';
+}

package/modern/models/z-axis.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "7.2.0",
+  "version": "7.3.1",
   "description": "The community edition of the Charts components (MUI X).",
   "author": "MUI Team",
   "main": "./index.js",
@@ -11,7 +11,8 @@
   "homepage": "https://mui.com/x/react-charts/",
   "sideEffects": false,
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "directory": "build"
   },
   "keywords": [
     "react",
@@ -69,9 +70,6 @@
       "default": "./esm/*/index.js"
     }
   },
-  "setupFiles": [
-    "<rootDir>/src/setupTests.js"
-  ],
   "engines": {
     "node": ">=14.0.0"
   },