@mui/x-charts 7.6.1 → 7.7.0

package/esm/internals/configInit.js

@@ -0,0 +1,20 @@
+let instance;
+class CartesianSeriesTypes {
+  constructor() {
+    this.types = new Set();
+    if (instance) {
+      throw new Error('You can only create one instance!');
+    }
+    instance = this.types;
+  }
+  addType(value) {
+    this.types.add(value);
+  }
+  getTypes() {
+    return this.types;
+  }
+}
+export const cartesianSeriesTypes = new CartesianSeriesTypes();
+cartesianSeriesTypes.addType('bar');
+cartesianSeriesTypes.addType('line');
+cartesianSeriesTypes.addType('scatter');

package/esm/internals/defaultizeValueFormatter.js

@@ -1,5 +1,5 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
-function defaultizeValueFormatter(series, defaultValueFormatter) {
+export function defaultizeValueFormatter(series, defaultValueFormatter) {
   const defaultizedSeries = {};
   Object.keys(series).forEach(seriesId => {
     defaultizedSeries[seriesId] = _extends({}, series[seriesId], {
@@ -7,5 +7,4 @@ function defaultizeValueFormatter(series, defaultValueFormatter) {
     });
   });
   return defaultizedSeries;
-}
-export default defaultizeValueFormatter;
+}

package/esm/internals/index.js

@@ -0,0 +1,27 @@
+// Components
+export * from './components/ChartsAxesGradients';
+export * from '../ResponsiveChartContainer/useChartContainerDimensions';
+export * from '../ResponsiveChartContainer/ResizableContainer';
+
+// hooks
+export { useReducedMotion } from '../hooks/useReducedMotion';
+export { useSeries } from '../hooks/useSeries';
+
+// utils
+export * from './defaultizeValueFormatter';
+export * from './configInit';
+
+// contexts
+
+export * from '../context/CartesianContextProvider';
+export * from '../context/DrawingProvider';
+export * from '../context/InteractionProvider';
+export * from '../context/SeriesContextProvider';
+export * from '../context/ZAxisContextProvider';
+
+// series configuration
+export * from '../models/seriesType/config';
+export * from '../models/seriesType/common';
+export * from '../models/helpers';
+export * from '../models/z-axis';
+export * from '../models/axis';

package/esm/internals/isCartesian.js

@@ -0,0 +1,7 @@
+import { cartesianSeriesTypes } from './configInit';
+export function isCartesianSeriesType(seriesType) {
+  return cartesianSeriesTypes.getTypes().has(seriesType);
+}
+export function isCartesianSeries(series) {
+  return isCartesianSeriesType(series.type);
+}

package/esm/internals/warning.js

@@ -0,0 +1,13 @@
+export function buildWarning(message, gravity = 'warning') {
+  let alreadyWarned = false;
+  return (...args) => {
+    if (!alreadyWarned) {
+      alreadyWarned = true;
+      if (gravity === 'error') {
+        console.error(message(...args));
+      } else {
+        console.warn(message(...args));
+      }
+    }
+  };
+}

package/esm/models/index.js

@@ -1,4 +1,5 @@
 export * from './seriesType';
 export * from './layout';
 export * from './stacking';
+export * from './plugin';
 export {};

package/esm/models/plugin.js

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

package/esm/models/seriesType/index.js

@@ -1,7 +1,13 @@
+// Series definition
+
+// item identifier
+
 export * from './line';
 export * from './bar';
 export * from './scatter';
 export * from './pie';
+// Helpers
+
 export function isDefaultizedBarSeries(series) {
   return series.type === 'bar';
 }

package/hooks/index.d.ts

@@ -1,5 +1,6 @@
 export * from './useDrawingArea';
 export * from './useChartId';
 export * from './useScale';
+export * from './useColorScale';
 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

@@ -76,6 +76,18 @@ Object.keys(_useScale).forEach(function (key) {
     }
   });
 });
+var _useColorScale = require("./useColorScale");
+Object.keys(_useColorScale).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useColorScale[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useColorScale[key];
+    }
+  });
+});
 var _useSvgRef = require("./useSvgRef");
 Object.keys(_useSvgRef).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/hooks/useColor.d.ts

@@ -0,0 +1,4 @@
+import { ChartSeriesType } from '../internals';
+import { ColorProcessorsConfig } from '../models/plugin';
+export declare function useColorProcessor<T extends ChartSeriesType>(seriesType: T): ColorProcessorsConfig<ChartSeriesType>;
+export declare function useColorProcessor(): ColorProcessorsConfig<ChartSeriesType>;

package/hooks/useColor.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useColorProcessor = useColorProcessor;
+var React = _interopRequireWildcard(require("react"));
+var _ColorProvider = require("../context/ColorProvider");
+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 useColorProcessor(seriesType) {
+  const colorProcessors = React.useContext(_ColorProvider.ColorContext);
+  if (!seriesType) {
+    return colorProcessors;
+  }
+  return colorProcessors[seriesType];
+}

package/hooks/useColorScale.d.ts

@@ -0,0 +1,4 @@
+import { AxisScaleComputedConfig, ScaleName } from '../models/axis';
+export declare function useXColorScale<S extends ScaleName>(identifier?: number | string): AxisScaleComputedConfig[S]['colorScale'] | undefined;
+export declare function useYColorScale<S extends ScaleName>(identifier?: number | string): AxisScaleComputedConfig[S]['colorScale'] | undefined;
+export declare function useZColorScale<S extends ScaleName>(identifier?: number | string): AxisScaleComputedConfig[S]['colorScale'] | undefined;

package/hooks/useColorScale.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useXColorScale = useXColorScale;
+exports.useYColorScale = useYColorScale;
+exports.useZColorScale = useZColorScale;
+var React = _interopRequireWildcard(require("react"));
+var _CartesianContextProvider = require("../context/CartesianContextProvider");
+var _ZAxisContextProvider = require("../context/ZAxisContextProvider");
+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 useXColorScale(identifier) {
+  const {
+    xAxis,
+    xAxisIds
+  } = React.useContext(_CartesianContextProvider.CartesianContext);
+  const id = typeof identifier === 'string' ? identifier : xAxisIds[identifier ?? 0];
+  return xAxis[id].colorScale;
+}
+function useYColorScale(identifier) {
+  const {
+    yAxis,
+    yAxisIds
+  } = React.useContext(_CartesianContextProvider.CartesianContext);
+  const id = typeof identifier === 'string' ? identifier : yAxisIds[identifier ?? 0];
+  return yAxis[id].colorScale;
+}
+function useZColorScale(identifier) {
+  const {
+    zAxis,
+    zAxisIds
+  } = React.useContext(_ZAxisContextProvider.ZAxisContext);
+  const id = typeof identifier === 'string' ? identifier : zAxisIds[identifier ?? 0];
+  return zAxis[id]?.colorScale;
+}

package/hooks/useInteractionItemProps.js

@@ -16,7 +16,7 @@ const useInteractionItemProps = skip => {
   const {
     setHighlighted,
     clearHighlighted
-  } = React.useContext(_context.HighlightedContext);
+  } = (0, _context.useHighlighted)();
   if (skip) {
     return () => ({});
   }

package/hooks/useReducedMotion.js

@@ -16,6 +16,13 @@ const useReducedMotion = () => {
   // Taken from: https://github.com/pmndrs/react-spring/blob/02ec877bbfab0df46da0e4a47d5f68d3e731206a/packages/shared/src/hooks/useReducedMotion.ts#L13
 
   (0, _web.useIsomorphicLayoutEffect)(() => {
+    if (!window.matchMedia) {
+      // skip animation in environments where `window.matchMedia` would not be available (i.e. test/jsdom)
+      _web.Globals.assign({
+        skipAnimation: true
+      });
+      return () => {};
+    }
     const mql = window.matchMedia('(prefers-reduced-motion)');
     const handleMediaChange = e => {
       _web.Globals.assign({

package/hooks/useSeries.d.ts

@@ -1,10 +1,11 @@
+import { FormattedSeries } 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 declare function useSeries(): import("../context/SeriesContextProvider").FormattedSeries;
+export declare function useSeries(): FormattedSeries;
 /**
  * Get access to the internal state of pie series.
  * The returned object contains:
@@ -12,10 +13,7 @@ export declare function useSeries(): import("../context/SeriesContextProvider").
  * - 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;
+export declare function usePieSeries(): FormattedSeries['pie'];
 /**
  * Get access to the internal state of line series.
  * The returned object contains:
@@ -23,7 +21,7 @@ export declare function usePieSeries(): {
  * - 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;
+export declare function useLineSeries(): FormattedSeries['line'];
 /**
  * Get access to the internal state of bar series.
  * The returned object contains:
@@ -31,7 +29,7 @@ export declare function useLineSeries(): import("../models/seriesType/config").F
  * - 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;
+export declare function useBarSeries(): FormattedSeries['bar'];
 /**
  * Get access to the internal state of scatter series.
  * The returned object contains:
@@ -39,7 +37,4 @@ export declare function useBarSeries(): import("../models/seriesType/config").Fo
  * - 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;
+export declare function useScatterSeries(): FormattedSeries['scatter'];

package/hooks/useSeries.js

@@ -19,11 +19,14 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
  * @returns FormattedSeries series
  */
 function useSeries() {
-  const series = React.useContext(_SeriesContextProvider.SeriesContext);
-  if (series === undefined) {
+  const {
+    isInitialized,
+    data
+  } = React.useContext(_SeriesContextProvider.SeriesContext);
+  if (!isInitialized) {
     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;
+  return data;
 }
 
 /**

package/hooks/useSvgRef.js

@@ -9,9 +9,12 @@ 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 && {}.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) {
+  const {
+    isInitialized,
+    data
+  } = React.useContext(_DrawingProvider.SvgContext);
+  if (!isInitialized) {
     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;
+  return data;
 }

package/hooks/useTicks.d.ts

@@ -18,10 +18,12 @@ export interface TickParams {
      */
     tickNumber?: number;
     /**
-     * Defines which ticks are displayed. Its value can be:
+     * Defines which ticks are displayed.
+     * Its value can be:
      * - 'auto' In such case the ticks are computed based on axis scale and other parameters.
-     * - a filtering function of the form `(value, index) => boolean` which is available only if the axis has a data property.
+     * - a filtering function of the form `(value, index) => boolean` which is available only if the axis has "point" scale.
      * - an array containing the values where ticks should be displayed.
+     * @see See {@link https://mui.com/x/react-charts/axis/#fixed-tick-positions}
      * @default 'auto'
      */
     tickInterval?: 'auto' | ((value: any, index: number) => boolean) | any[];

package/index.js

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

package/internals/configInit.d.ts

@@ -0,0 +1,9 @@
+import { ChartSeriesType } from '../models/seriesType/config';
+declare class CartesianSeriesTypes {
+    types: Set<ChartSeriesType>;
+    constructor();
+    addType(value: ChartSeriesType): void;
+    getTypes(): Set<keyof import("../models/seriesType/config").ChartsSeriesConfig>;
+}
+export declare const cartesianSeriesTypes: CartesianSeriesTypes;
+export {};

package/internals/configInit.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.cartesianSeriesTypes = void 0;
+let instance;
+class CartesianSeriesTypes {
+  constructor() {
+    this.types = new Set();
+    if (instance) {
+      throw new Error('You can only create one instance!');
+    }
+    instance = this.types;
+  }
+  addType(value) {
+    this.types.add(value);
+  }
+  getTypes() {
+    return this.types;
+  }
+}
+const cartesianSeriesTypes = exports.cartesianSeriesTypes = new CartesianSeriesTypes();
+cartesianSeriesTypes.addType('bar');
+cartesianSeriesTypes.addType('line');
+cartesianSeriesTypes.addType('scatter');

package/internals/defaultizeColor.d.ts

@@ -39,9 +39,9 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
         arcLabelRadius?: number | undefined;
         color?: string | undefined;
     } | undefined;
-    id?: import("../models/seriesType/common").SeriesId | undefined;
+    id?: import(".").SeriesId | undefined;
     color?: string | undefined;
-    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<import("../models/helpers").MakeOptional<import("../models/seriesType").PieValueType, "id">> | undefined;
+    valueFormatter?: import(".").SeriesValueFormatter<import(".").MakeOptional<import("../models/seriesType").PieValueType, "id">> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
 } | {
     type: "bar";
@@ -50,9 +50,9 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     label?: string | ((location: "tooltip" | "legend") => string) | undefined;
     layout?: "horizontal" | "vertical" | undefined;
     stackOffset?: import("..").StackOffsetType | undefined;
-    id?: import("../models/seriesType/common").SeriesId | undefined;
+    id?: import(".").SeriesId | undefined;
     color: string;
-    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<number | null> | undefined;
+    valueFormatter?: import(".").SeriesValueFormatter<number | null> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;
@@ -70,9 +70,9 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     disableHighlight?: boolean | undefined;
     connectNulls?: boolean | undefined;
     stackOffset?: import("..").StackOffsetType | undefined;
-    id?: import("../models/seriesType/common").SeriesId | undefined;
+    id?: import(".").SeriesId | undefined;
     color: string;
-    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<number | null> | undefined;
+    valueFormatter?: import(".").SeriesValueFormatter<number | null> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;
@@ -84,9 +84,9 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     label?: string | ((location: "tooltip" | "legend") => string) | undefined;
     disableHover?: boolean | undefined;
     zAxisKey?: string | undefined;
-    id?: import("../models/seriesType/common").SeriesId | undefined;
+    id?: import(".").SeriesId | undefined;
     color: string;
-    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<import("../models/seriesType").ScatterValueType> | undefined;
+    valueFormatter?: import(".").SeriesValueFormatter<import("../models/seriesType").ScatterValueType> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;

package/internals/defaultizeValueFormatter.d.ts

@@ -1,7 +1,6 @@
 import { SeriesId, SeriesValueFormatter } from '../models/seriesType/common';
-declare function defaultizeValueFormatter<TValue, ISeries extends {
+export declare function defaultizeValueFormatter<TValue, ISeries extends {
     valueFormatter?: SeriesValueFormatter<TValue>;
 }>(series: Record<SeriesId, ISeries>, defaultValueFormatter: SeriesValueFormatter<TValue>): Record<SeriesId, ISeries & {
     valueFormatter: SeriesValueFormatter<TValue>;
 }>;
-export default defaultizeValueFormatter;

package/internals/defaultizeValueFormatter.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.defaultizeValueFormatter = defaultizeValueFormatter;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 function defaultizeValueFormatter(series, defaultValueFormatter) {
   const defaultizedSeries = {};
@@ -14,5 +14,4 @@ function defaultizeValueFormatter(series, defaultValueFormatter) {
     });
   });
   return defaultizedSeries;
-}
-var _default = exports.default = defaultizeValueFormatter;
+}

package/internals/index.d.ts

@@ -0,0 +1,17 @@
+export * from './components/ChartsAxesGradients';
+export * from '../ResponsiveChartContainer/useChartContainerDimensions';
+export * from '../ResponsiveChartContainer/ResizableContainer';
+export { useReducedMotion } from '../hooks/useReducedMotion';
+export { useSeries } from '../hooks/useSeries';
+export * from './defaultizeValueFormatter';
+export * from './configInit';
+export * from '../context/CartesianContextProvider';
+export * from '../context/DrawingProvider';
+export * from '../context/InteractionProvider';
+export * from '../context/SeriesContextProvider';
+export * from '../context/ZAxisContextProvider';
+export * from '../models/seriesType/config';
+export * from '../models/seriesType/common';
+export * from '../models/helpers';
+export * from '../models/z-axis';
+export * from '../models/axis';