@mui/x-charts 7.2.0 → 7.3.0

package/esm/hooks/useAxisEvents.js

@@ -1,20 +1,21 @@
 import * as React from 'react';
 import { InteractionContext } from '../context/InteractionProvider';
 import { CartesianContext } from '../context/CartesianContextProvider';
-import { SvgContext, DrawingContext } from '../context/DrawingProvider';
 import { isBandScale } from '../internals/isBandScale';
 import { getSVGPoint } from '../internals/utils';
+import { useSvgRef } from './useSvgRef';
+import { useDrawingArea } from './useDrawingArea';
 function getAsANumber(value) {
   return value instanceof Date ? value.getTime() : value;
 }
 export const useAxisEvents = disableAxisListener => {
-  const svgRef = React.useContext(SvgContext);
+  const svgRef = useSvgRef();
   const {
-    width,
-    height,
+    left,
     top,
-    left
-  } = React.useContext(DrawingContext);
+    width,
+    height
+  } = useDrawingArea();
   const {
     xAxis,
     yAxis,

package/esm/hooks/useChartId.js

@@ -0,0 +1,8 @@
+import * as React from 'react';
+import { DrawingContext } from '../context/DrawingProvider';
+export function useChartId() {
+  const {
+    chartId
+  } = React.useContext(DrawingContext);
+  return React.useMemo(() => chartId, [chartId]);
+}

package/esm/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/esm/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/esm/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) {
+  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);
+    }
+  }
+  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/esm/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/esm/internals/components/ChartsAxesGradients/ChartsAxesGradients.js

@@ -0,0 +1,96 @@
+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 } from "react/jsx-runtime";
+import { 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/esm/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/esm/internals/components/ChartsAxesGradients/ChartsPiecewiseGradient.js

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { 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/esm/internals/components/ChartsAxesGradients/index.js

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

package/esm/models/colorMapping.js

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

package/esm/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/hooks/index.d.ts

@@ -1,2 +1,5 @@
 export * from './useDrawingArea';
+export * from './useChartId';
 export * from './useScale';
+export * from './useSvgRef';
+export { useSeries as unstable_useSeries, usePieSeries as unstable_usePieSeries, useLineSeries as unstable_useLineSeries, useBarSeries as unstable_useBarSeries, useScatterSeries as unstable_useScatterSeries, } from './useSeries';

package/hooks/index.js

@@ -3,9 +3,47 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _exportNames = {
+  unstable_useSeries: true,
+  unstable_usePieSeries: true,
+  unstable_useLineSeries: true,
+  unstable_useBarSeries: true,
+  unstable_useScatterSeries: true
+};
+Object.defineProperty(exports, "unstable_useBarSeries", {
+  enumerable: true,
+  get: function () {
+    return _useSeries.useBarSeries;
+  }
+});
+Object.defineProperty(exports, "unstable_useLineSeries", {
+  enumerable: true,
+  get: function () {
+    return _useSeries.useLineSeries;
+  }
+});
+Object.defineProperty(exports, "unstable_usePieSeries", {
+  enumerable: true,
+  get: function () {
+    return _useSeries.usePieSeries;
+  }
+});
+Object.defineProperty(exports, "unstable_useScatterSeries", {
+  enumerable: true,
+  get: function () {
+    return _useSeries.useScatterSeries;
+  }
+});
+Object.defineProperty(exports, "unstable_useSeries", {
+  enumerable: true,
+  get: function () {
+    return _useSeries.useSeries;
+  }
+});
 var _useDrawingArea = require("./useDrawingArea");
 Object.keys(_useDrawingArea).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _useDrawingArea[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -14,9 +52,22 @@ Object.keys(_useDrawingArea).forEach(function (key) {
     }
   });
 });
+var _useChartId = require("./useChartId");
+Object.keys(_useChartId).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useChartId[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useChartId[key];
+    }
+  });
+});
 var _useScale = require("./useScale");
 Object.keys(_useScale).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _useScale[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -24,4 +75,17 @@ Object.keys(_useScale).forEach(function (key) {
       return _useScale[key];
     }
   });
-});
+});
+var _useSvgRef = require("./useSvgRef");
+Object.keys(_useSvgRef).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useSvgRef[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useSvgRef[key];
+    }
+  });
+});
+var _useSeries = require("./useSeries");

package/hooks/useAxisEvents.js

@@ -7,22 +7,23 @@ exports.useAxisEvents = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _InteractionProvider = require("../context/InteractionProvider");
 var _CartesianContextProvider = require("../context/CartesianContextProvider");
-var _DrawingProvider = require("../context/DrawingProvider");
 var _isBandScale = require("../internals/isBandScale");
 var _utils = require("../internals/utils");
+var _useSvgRef = require("./useSvgRef");
+var _useDrawingArea = require("./useDrawingArea");
 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 && Object.prototype.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 getAsANumber(value) {
   return value instanceof Date ? value.getTime() : value;
 }
 const useAxisEvents = disableAxisListener => {
-  const svgRef = React.useContext(_DrawingProvider.SvgContext);
+  const svgRef = (0, _useSvgRef.useSvgRef)();
   const {
-    width,
-    height,
+    left,
     top,
-    left
-  } = React.useContext(_DrawingProvider.DrawingContext);
+    width,
+    height
+  } = (0, _useDrawingArea.useDrawingArea)();
   const {
     xAxis,
     yAxis,

package/hooks/useChartId.d.ts

@@ -0,0 +1 @@
+export declare function useChartId(): string;

package/hooks/useChartId.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useChartId = useChartId;
+var React = _interopRequireWildcard(require("react"));
+var _DrawingProvider = require("../context/DrawingProvider");
+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 && Object.prototype.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 useChartId() {
+  const {
+    chartId
+  } = React.useContext(_DrawingProvider.DrawingContext);
+  return React.useMemo(() => chartId, [chartId]);
+}

package/hooks/useSeries.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Get access to the internal state of series.
+ * Structured by type of series:
+ * { seriesType?: { series: { id1: precessedValue, ... }, seriesOrder: [id1, ...] } }
+ * @returns FormattedSeries series
+ */
+export declare function useSeries(): import("../context/SeriesContextProvider").FormattedSeries;
+/**
+ * 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 declare function usePieSeries(): {
+    series: Record<import("../models/seriesType/common").SeriesId, import("..").DefaultizedPieSeriesType>;
+    seriesOrder: import("../models/seriesType/common").SeriesId[];
+} | undefined;
+/**
+ * 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 declare function useLineSeries(): import("../models/seriesType/config").FormatterResult<"line"> | undefined;
+/**
+ * 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 declare function useBarSeries(): import("../models/seriesType/config").FormatterResult<"bar"> | undefined;
+/**
+ * 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 declare function useScatterSeries(): {
+    series: Record<import("../models/seriesType/common").SeriesId, import("..").DefaultizedScatterSeriesType>;
+    seriesOrder: import("../models/seriesType/common").SeriesId[];
+} | undefined;

package/hooks/useSeries.js

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useBarSeries = useBarSeries;
+exports.useLineSeries = useLineSeries;
+exports.usePieSeries = usePieSeries;
+exports.useScatterSeries = useScatterSeries;
+exports.useSeries = useSeries;
+var React = _interopRequireWildcard(require("react"));
+var _SeriesContextProvider = require("../context/SeriesContextProvider");
+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 && Object.prototype.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; }
+/**
+ * Get access to the internal state of series.
+ * Structured by type of series:
+ * { seriesType?: { series: { id1: precessedValue, ... }, seriesOrder: [id1, ...] } }
+ * @returns FormattedSeries series
+ */
+function useSeries() {
+  const series = React.useContext(_SeriesContextProvider.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
+ */
+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
+ */
+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
+ */
+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
+ */
+function useScatterSeries() {
+  const series = useSeries();
+  return React.useMemo(() => series.scatter, [series.scatter]);
+}

package/hooks/useSvgRef.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare function useSvgRef(): React.MutableRefObject<SVGSVGElement>;

package/hooks/useSvgRef.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSvgRef = useSvgRef;
+var React = _interopRequireWildcard(require("react"));
+var _DrawingProvider = require("../context/DrawingProvider");
+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 && Object.prototype.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 useSvgRef() {
+  const svgRef = React.useContext(_DrawingProvider.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/index.js

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