@mui/x-charts 7.2.0 → 7.3.0

package/internals/colorGetter.d.ts

@@ -0,0 +1,5 @@
+import { DefaultizedBarSeriesType, DefaultizedLineSeriesType, DefaultizedPieSeriesType, DefaultizedScatterSeriesType } from '../models';
+import { AxisDefaultized } from '../models/axis';
+declare function getColor(series: DefaultizedPieSeriesType): (dataIndex: number) => string;
+declare function getColor(series: DefaultizedBarSeriesType | DefaultizedLineSeriesType | DefaultizedScatterSeriesType | DefaultizedPieSeriesType, xAxis: AxisDefaultized, yAxis: AxisDefaultized): (dataIndex: number) => string;
+export default getColor;

package/internals/colorGetter.js

@@ -0,0 +1,29 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _getColor = _interopRequireDefault(require("../BarChart/getColor"));
+var _getColor2 = _interopRequireDefault(require("../LineChart/getColor"));
+var _getColor3 = _interopRequireDefault(require("../ScatterChart/getColor"));
+var _getColor4 = _interopRequireDefault(require("../PieChart/getColor"));
+function getColor(series, xAxis, yAxis) {
+  if (xAxis !== undefined && yAxis !== undefined) {
+    if (series.type === 'bar') {
+      return (0, _getColor.default)(series, xAxis, yAxis);
+    }
+    if (series.type === 'line') {
+      return (0, _getColor2.default)(series, xAxis, yAxis);
+    }
+    if (series.type === 'scatter') {
+      return (0, _getColor3.default)(series, xAxis, yAxis);
+    }
+  }
+  if (series.type === 'pie') {
+    return (0, _getColor4.default)(series);
+  }
+  throw Error(`MUI X Charts: getColor called with unexpected arguments for series with id "${series.id}"`);
+}
+var _default = exports.default = getColor;

package/internals/colorScale.d.ts

@@ -0,0 +1,5 @@
+import { ScaleOrdinal } from 'd3-scale';
+import { ContinuousColorConfig, PiecewiseColorConfig, OrdinalColorConfig } from '../models/colorMapping';
+export declare function getSequentialColorScale<Value extends number | Date>(config: ContinuousColorConfig<Value> | PiecewiseColorConfig<Value>): import("d3-scale").ScaleThreshold<Value, string, never> | import("d3-scale").ScaleSequential<string, never>;
+export declare function getOrdinalColorScale<Value extends number | Date | string>(config: OrdinalColorConfig<Value>): ScaleOrdinal<Value, string, null | string> | ScaleOrdinal<number, string, null | string>;
+export declare function getColorScale(config: ContinuousColorConfig | PiecewiseColorConfig | OrdinalColorConfig): ScaleOrdinal<string | number | Date, string, string | null> | ScaleOrdinal<number, string, string | null> | import("d3-scale").ScaleSequential<string, never> | import("d3-scale").ScaleThreshold<number | Date, string, never>;

package/internals/colorScale.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getColorScale = getColorScale;
+exports.getOrdinalColorScale = getOrdinalColorScale;
+exports.getSequentialColorScale = getSequentialColorScale;
+var _d3Scale = require("d3-scale");
+function getSequentialColorScale(config) {
+  if (config.type === 'piecewise') {
+    return (0, _d3Scale.scaleThreshold)(config.thresholds, config.colors);
+  }
+  return (0, _d3Scale.scaleSequential)([config.min ?? 0, config.max ?? 100], config.color);
+}
+function getOrdinalColorScale(config) {
+  if (config.values) {
+    return (0, _d3Scale.scaleOrdinal)(config.values, config.colors).unknown(config.unknownColor ?? null);
+  }
+  return (0, _d3Scale.scaleOrdinal)(config.colors.map((_, index) => index), config.colors).unknown(config.unknownColor ?? null);
+}
+function getColorScale(config) {
+  return config.type === 'ordinal' ? getOrdinalColorScale(config) : getSequentialColorScale(config);
+}

package/internals/components/ChartsAxesGradients/ChartsAxesGradients.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+export declare function useChartGradient(): (axisId: string, direction: 'x' | 'y') => string;
+export declare function ChartsAxesGradients(): React.JSX.Element;

package/internals/components/ChartsAxesGradients/ChartsAxesGradients.js

@@ -0,0 +1,105 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChartsAxesGradients = ChartsAxesGradients;
+exports.useChartGradient = useChartGradient;
+var React = _interopRequireWildcard(require("react"));
+var _CartesianContextProvider = require("../../../context/CartesianContextProvider");
+var _DrawingProvider = require("../../../context/DrawingProvider");
+var _hooks = require("../../../hooks");
+var _ChartsPiecewiseGradient = _interopRequireDefault(require("./ChartsPiecewiseGradient"));
+var _ChartsContinuousGradient = _interopRequireDefault(require("./ChartsContinuousGradient"));
+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 && 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 useChartGradient() {
+  const {
+    chartId
+  } = React.useContext(_DrawingProvider.DrawingContext);
+  return React.useCallback((axisId, direction) => `${chartId}-graient-${direction}-${axisId}`, [chartId]);
+}
+function ChartsAxesGradients() {
+  const {
+    top,
+    height,
+    bottom,
+    left,
+    width,
+    right
+  } = (0, _hooks.useDrawingArea)();
+  const svgHeight = top + height + bottom;
+  const svgWidth = left + width + right;
+  const getGradientId = useChartGradient();
+  const {
+    xAxisIds,
+    xAxis,
+    yAxisIds,
+    yAxis
+  } = React.useContext(_CartesianContextProvider.CartesianContext);
+  return /*#__PURE__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsx)(_ChartsPiecewiseGradient.default, {
+          isReveresed: !reverse,
+          scale: scale,
+          colorMap: colorMap,
+          size: svgHeight,
+          gradientId: gradientId,
+          direction: "y"
+        }, gradientId);
+      }
+      if (colorMap?.type === 'continuous') {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsContinuousGradient.default, {
+          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__*/(0, _jsxRuntime.jsx)(_ChartsPiecewiseGradient.default, {
+          isReveresed: reverse,
+          scale: scale,
+          colorMap: colorMap,
+          size: svgWidth,
+          gradientId: gradientId,
+          direction: "x"
+        }, gradientId);
+      }
+      if (colorMap?.type === 'continuous') {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ChartsContinuousGradient.default, {
+          isReveresed: reverse,
+          scale: scale,
+          colorScale: colorScale,
+          colorMap: colorMap,
+          size: svgWidth,
+          gradientId: gradientId,
+          direction: "x"
+        }, gradientId);
+      }
+      return null;
+    })]
+  });
+}

package/internals/components/ChartsAxesGradients/ChartsContinuousGradient.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import { ContinuousColorConfig } from '../../../models/colorMapping';
+type ChartsContinuousGradientProps = {
+    isReveresed?: boolean;
+    gradientId: string;
+    size: number;
+    direction: 'x' | 'y';
+    scale: (value: any) => number | undefined;
+    colorMap: ContinuousColorConfig;
+    colorScale: (value: any) => string | null;
+};
+export default function ChartsContinuousGradient(props: ChartsContinuousGradientProps): React.JSX.Element | null;
+export {};

package/internals/components/ChartsAxesGradients/ChartsContinuousGradient.js

@@ -0,0 +1,63 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = ChartsContinuousGradient;
+var React = _interopRequireWildcard(require("react"));
+var _d3Interpolate = require("d3-interpolate");
+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 && 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; }
+const PX_PRECISION = 10;
+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' ? (0, _d3Interpolate.interpolateNumber)(extremValues[0], extremValues[1]) : (0, _d3Interpolate.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__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsx)("stop", {
+        offset: offset,
+        stopColor: color,
+        stopOpacity: 1
+      }, keyPrefix + index);
+    })
+  });
+}

package/internals/components/ChartsAxesGradients/ChartsPiecewiseGradient.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import { PiecewiseColorConfig } from '../../../models/colorMapping';
+type ChartsPiecewiseGradientProps = {
+    isReveresed?: boolean;
+    gradientId: string;
+    size: number;
+    direction: 'x' | 'y';
+    scale: (value: any) => number | undefined;
+    colorMap: PiecewiseColorConfig;
+};
+export default function ChartsPiecewiseGradient(props: ChartsPiecewiseGradientProps): React.JSX.Element;
+export {};

package/internals/components/ChartsAxesGradients/ChartsPiecewiseGradient.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = ChartsPiecewiseGradient;
+var React = _interopRequireWildcard(require("react"));
+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 && 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 ChartsPiecewiseGradient(props) {
+  const {
+    isReveresed,
+    gradientId,
+    size,
+    direction,
+    scale,
+    colorMap
+  } = props;
+  return /*#__PURE__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("stop", {
+          offset: offset,
+          stopColor: colorMap.colors[index],
+          stopOpacity: 1
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)("stop", {
+          offset: offset,
+          stopColor: colorMap.colors[index + 1],
+          stopOpacity: 1
+        })]
+      }, threshold.toString() + index);
+    })
+  });
+}

package/internals/components/ChartsAxesGradients/index.d.ts

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

package/internals/components/ChartsAxesGradients/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _ChartsAxesGradients = require("./ChartsAxesGradients");
+Object.keys(_ChartsAxesGradients).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ChartsAxesGradients[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ChartsAxesGradients[key];
+    }
+  });
+});

package/internals/defaultizeColor.d.ts

@@ -39,7 +39,7 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     } | undefined;
     id?: import("../models/seriesType/common").SeriesId | undefined;
     color?: string | undefined;
-    valueFormatter?: (<V extends import("../models/helpers").MakeOptional<import("../models/seriesType").PieValueType, "id">>(value: V) => string) | undefined;
+    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<import("../models/helpers").MakeOptional<import("../models/seriesType").PieValueType, "id">> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
 } | {
     type: "bar";
@@ -50,7 +50,7 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     stackOffset?: import("..").StackOffsetType | undefined;
     id?: import("../models/seriesType/common").SeriesId | undefined;
     color: string;
-    valueFormatter?: (<V_1 extends number | null>(value: V_1) => string) | undefined;
+    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<number | null> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;
@@ -64,7 +64,7 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     disableHover?: boolean | undefined;
     id?: import("../models/seriesType/common").SeriesId | undefined;
     color: string;
-    valueFormatter?: (<V_2 extends import("../models/seriesType").ScatterValueType>(value: V_2) => string) | undefined;
+    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<import("../models/seriesType").ScatterValueType> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;
@@ -82,7 +82,7 @@ export declare function defaultizeColor(series: AllSeriesType, seriesIndex: numb
     stackOffset?: import("..").StackOffsetType | undefined;
     id?: import("../models/seriesType/common").SeriesId | undefined;
     color: string;
-    valueFormatter?: (<V_1 extends number | null>(value: V_1) => string) | undefined;
+    valueFormatter?: import("../models/seriesType/common").SeriesValueFormatter<number | null> | undefined;
     highlightScope?: Partial<import("..").HighlightScope> | undefined;
     xAxisKey?: string | undefined;
     yAxisKey?: string | undefined;

package/internals/defaultizeValueFormatter.d.ts

@@ -1,7 +1,7 @@
-import { SeriesId } from '../models/seriesType/common';
-declare function defaultizeValueFormatter<ISeries extends {
-    valueFormatter?: IFormatter;
-}, IFormatter extends (v: any) => string>(series: Record<SeriesId, ISeries>, defaultValueFormatter: IFormatter): Record<SeriesId, ISeries & {
-    valueFormatter: IFormatter;
+import { SeriesId, SeriesValueFormatter } from '../models/seriesType/common';
+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/getScale.d.ts

@@ -1,2 +1,2 @@
-import { ContinuouseScaleName, D3ContinuouseScale } from '../models/axis';
-export declare function getScale(scaleType: ContinuouseScaleName, domain: any[], range: any[]): D3ContinuouseScale;
+import { ContinuousScaleName, D3ContinuousScale } from '../models/axis';
+export declare function getScale(scaleType: ContinuousScaleName, domain: any[], range: any[]): D3ContinuousScale;

package/models/axis.d.ts

@@ -1,13 +1,14 @@
 /// <reference types="react" />
-import type { ScaleBand, ScaleLogarithmic, ScalePower, ScaleTime, ScaleLinear, ScalePoint } from 'd3-scale';
+import type { ScaleBand, ScaleLogarithmic, ScalePower, ScaleTime, ScaleLinear, ScalePoint, ScaleOrdinal, ScaleSequential, ScaleThreshold } from 'd3-scale';
 import { ChartsAxisClasses } from '../ChartsAxis/axisClasses';
 import type { TickParams } from '../hooks/useTicks';
 import { ChartsTextProps } from '../ChartsText';
+import { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from './colorMapping';
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
     toString(): string;
 } = number | Date | string, Range = number, Output = number> = ScaleBand<Domain> | ScaleLogarithmic<Range, Output> | ScalePoint<Domain> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
-export type D3ContinuouseScale<Range = number, Output = number> = ScaleLogarithmic<Range, Output> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
+export type D3ContinuousScale<Range = number, Output = number> = ScaleLogarithmic<Range, Output> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
 export interface ChartsAxisSlots {
     /**
      * Custom component for the axis main line.
@@ -126,7 +127,7 @@ export interface ChartsXAxisProps extends ChartsAxisProps {
     position?: 'top' | 'bottom';
 }
 export type ScaleName = 'linear' | 'band' | 'point' | 'log' | 'pow' | 'sqrt' | 'time' | 'utc';
-export type ContinuouseScaleName = 'linear' | 'log' | 'pow' | 'sqrt' | 'time' | 'utc';
+export type ContinuousScaleName = 'linear' | 'log' | 'pow' | 'sqrt' | 'time' | 'utc';
 interface AxisScaleConfig {
     band: {
         scaleType: 'band';
@@ -143,37 +144,76 @@ interface AxisScaleConfig {
          * @default 0.1
          */
         barGapRatio: number;
+        colorMap?: OrdinalColorConfig | ContinuousColorConfig | PiecewiseColorConfig;
     } & Pick<TickParams, 'tickPlacement' | 'tickLabelPlacement'>;
     point: {
         scaleType: 'point';
         scale: ScalePoint<number | Date | string>;
+        colorMap?: OrdinalColorConfig | ContinuousColorConfig | PiecewiseColorConfig;
     };
     log: {
         scaleType: 'log';
         scale: ScaleLogarithmic<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
     };
     pow: {
         scaleType: 'pow';
         scale: ScalePower<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
     };
     sqrt: {
         scaleType: 'sqrt';
         scale: ScalePower<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
     };
     time: {
         scaleType: 'time';
         scale: ScaleTime<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
     };
     utc: {
         scaleType: 'utc';
         scale: ScaleTime<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
     };
     linear: {
         scaleType: 'linear';
         scale: ScaleLinear<number, number>;
+        colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
+    };
+}
+interface AxisScaleComputedConfig {
+    band: {
+        colorScale?: ScaleOrdinal<string | number | Date, string, string | null> | ScaleOrdinal<number, string, string | null> | ScaleSequential<string, string | null> | ScaleThreshold<number | Date, string | null>;
+    };
+    point: {
+        colorScale?: ScaleOrdinal<string | number | Date, string, string | null> | ScaleOrdinal<number, string, string | null> | ScaleSequential<string, string | null> | ScaleThreshold<number | Date, string | null>;
+    };
+    log: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
+    };
+    pow: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
+    };
+    sqrt: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
+    };
+    time: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number | Date, string | null>;
+    };
+    utc: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number | Date, string | null>;
+    };
+    linear: {
+        colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
     };
 }
 export type AxisValueFormatterContext = {
+    /**
+     * Location indicates where the value will be displayed.
+     * - `'tick'` The value is displayed on the axis ticks.
+     * - `'tooltip'` The value is displayed in the tooltip when hovering the chart.
+     */
     location: 'tick' | 'tooltip';
 };
 export type AxisConfig<S extends ScaleName = ScaleName, V = any> = {
@@ -215,7 +255,7 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any> = {
      */
     reverse?: boolean;
 } & Partial<ChartsXAxisProps | ChartsYAxisProps> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & TickParams;
-export type AxisDefaultized<S extends ScaleName = ScaleName, V = any> = Omit<AxisConfig<S, V>, 'scaleType'> & AxisScaleConfig[S] & {
+export type AxisDefaultized<S extends ScaleName = ScaleName, V = any> = Omit<AxisConfig<S, V>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
     /**
      * An indication of the expected number of ticks.
      */

package/models/colorMapping.d.ts

@@ -0,0 +1,45 @@
+export interface ContinuousColorConfig<Value = number | Date> {
+    type: 'continuous';
+    /**
+     * The minimal value of the color scale.
+     * @default 0
+     */
+    min?: Value;
+    /**
+     * The maximal value of the color scale.
+     * @default 100
+     */
+    max?: Value;
+    /**
+     * The colors to render. Can either be and array with the extrem colors, or an interpolation function.
+     */
+    color: [string, string] | ((t: number) => string);
+}
+export interface PiecewiseColorConfig<Value = number | Date> {
+    type: 'piecewise';
+    /**
+     * The thresholds where color should change from one category to another.
+     */
+    thresholds: Value[];
+    /**
+     * The colors used for each band defined by `thresholds`.
+     * Should contain N+1 colors with N the number of thresholds.
+     */
+    colors: string[];
+}
+export interface OrdinalColorConfig<Value = number | Date | string> {
+    type: 'ordinal';
+    /**
+     * The value to map.
+     * If undefined, it will be integers from 0 to the number of colors.
+     */
+    values?: Value[];
+    /**
+     * The color palette.
+     */
+    colors: string[];
+    /**
+     * The color to use when an element is not part of the values.
+     */
+    unknownColor?: string;
+}

package/models/colorMapping.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/models/index.d.ts

@@ -1,4 +1,4 @@
 export * from './seriesType';
 export * from './layout';
 export * from './stacking';
-export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuouseScaleName, } from './axis';
+export type { AxisConfig, ChartsYAxisProps, ChartsXAxisProps, ScaleName, ContinuousScaleName, } from './axis';

package/models/seriesType/common.d.ts

@@ -1,15 +1,23 @@
 import type { HighlightScope } from '../../context/HighlightProvider';
 import type { StackOffsetType, StackOrderType } from '../stacking';
 export type SeriesId = number | string;
+export type SeriesValueFormatterContext = {
+    /**
+     * The index of the value in the data array.
+     */
+    dataIndex: number;
+};
+export type SeriesValueFormatter<TValue> = (value: TValue, context: SeriesValueFormatterContext) => string;
 export type CommonSeriesType<TValue> = {
     id?: SeriesId;
     color?: string;
     /**
      * Formatter used to render values in tooltip or other data display.
      * @param {TValue} value The series' value to render.
-     * @returns {string} The string to dispaly.
+     * @param {SeriesValueFormatterContext} context The rendering context of the value.
+     * @returns {string} The string to display.
      */
-    valueFormatter?: <V extends TValue>(value: V) => string;
+    valueFormatter?: SeriesValueFormatter<TValue>;
     highlightScope?: Partial<HighlightScope>;
 };
 export type CommonDefaultizedProps = 'id' | 'valueFormatter' | 'data';

package/models/seriesType/index.d.ts

@@ -14,3 +14,5 @@ export * from './bar';
 export * from './scatter';
 export * from './pie';
 export type { AllSeriesType, CartesianSeriesType, DefaultizedSeriesType, DefaultizedCartesianSeriesType, StackableSeriesType, };
+export declare function isDefaultizedBarSeries(series: DefaultizedSeriesType): series is DefaultizedBarSeriesType;
+export declare function isBarSeries(series: AllSeriesType): series is BarSeriesType;

package/models/seriesType/index.js

@@ -3,9 +3,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _exportNames = {
+  isDefaultizedBarSeries: true,
+  isBarSeries: true
+};
+exports.isBarSeries = isBarSeries;
+exports.isDefaultizedBarSeries = isDefaultizedBarSeries;
 var _line = require("./line");
 Object.keys(_line).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _line[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -17,6 +24,7 @@ Object.keys(_line).forEach(function (key) {
 var _bar = require("./bar");
 Object.keys(_bar).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _bar[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -28,6 +36,7 @@ Object.keys(_bar).forEach(function (key) {
 var _scatter = require("./scatter");
 Object.keys(_scatter).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _scatter[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -39,6 +48,7 @@ Object.keys(_scatter).forEach(function (key) {
 var _pie = require("./pie");
 Object.keys(_pie).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _pie[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -46,4 +56,10 @@ Object.keys(_pie).forEach(function (key) {
       return _pie[key];
     }
   });
-});
+});
+function isDefaultizedBarSeries(series) {
+  return series.type === 'bar';
+}
+function isBarSeries(series) {
+  return series.type === 'bar';
+}