@mui/x-charts 8.17.0 → 8.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/BarChart/BarLabel/BarLabel.d.ts +7 -1
  2. package/BarChart/BarLabel/BarLabel.js +41 -4
  3. package/BarChart/BarLabel/BarLabelItem.d.ts +6 -0
  4. package/BarChart/BarLabel/BarLabelItem.js +4 -2
  5. package/BarChart/BarLabel/BarLabelPlot.js +2 -3
  6. package/BarChart/BarPlot.js +5 -0
  7. package/BarChart/seriesConfig/bar/seriesProcessor.js +15 -9
  8. package/BarChart/types.d.ts +1 -0
  9. package/BarChart/useBarPlotData.js +3 -2
  10. package/CHANGELOG.md +213 -0
  11. package/ChartsSurface/ChartsSurface.js +5 -2
  12. package/LineChart/seriesConfig/seriesProcessor.js +15 -10
  13. package/PieChart/PieArcPlot.js +5 -3
  14. package/esm/BarChart/BarLabel/BarLabel.d.ts +7 -1
  15. package/esm/BarChart/BarLabel/BarLabel.js +41 -4
  16. package/esm/BarChart/BarLabel/BarLabelItem.d.ts +6 -0
  17. package/esm/BarChart/BarLabel/BarLabelItem.js +4 -2
  18. package/esm/BarChart/BarLabel/BarLabelPlot.js +2 -2
  19. package/esm/BarChart/BarPlot.js +5 -0
  20. package/esm/BarChart/seriesConfig/bar/seriesProcessor.js +15 -9
  21. package/esm/BarChart/types.d.ts +1 -0
  22. package/esm/BarChart/useBarPlotData.js +3 -2
  23. package/esm/ChartsSurface/ChartsSurface.js +5 -2
  24. package/esm/LineChart/seriesConfig/seriesProcessor.js +15 -10
  25. package/esm/PieChart/PieArcPlot.js +5 -3
  26. package/esm/hooks/animation/useAnimateBarLabel.d.ts +1 -1
  27. package/esm/hooks/animation/useAnimateBarLabel.js +61 -12
  28. package/esm/hooks/useAxis.d.ts +116 -16
  29. package/esm/hooks/useAxis.js +122 -18
  30. package/esm/hooks/useBarSeries.js +3 -5
  31. package/esm/hooks/useLineSeries.js +3 -5
  32. package/esm/hooks/usePieSeries.js +3 -5
  33. package/esm/hooks/useRadarSeries.js +3 -5
  34. package/esm/hooks/useScale.d.ts +25 -6
  35. package/esm/hooks/useScale.js +29 -8
  36. package/esm/hooks/useScatterSeries.js +3 -5
  37. package/esm/index.d.ts +2 -1
  38. package/esm/index.js +2 -1
  39. package/esm/internals/domUtils.js +30 -14
  40. package/esm/internals/getScale.d.ts +2 -1
  41. package/esm/internals/index.d.ts +1 -1
  42. package/esm/internals/index.js +1 -1
  43. package/esm/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.selectors.js +2 -2
  44. package/esm/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.selectors.js +5 -6
  45. package/esm/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.js +2 -2
  46. package/esm/internals/plugins/corePlugins/useChartId/useChartId.selectors.js +2 -2
  47. package/esm/internals/plugins/corePlugins/useChartInteractionListener/useChartInteractionListener.js +4 -1
  48. package/esm/internals/plugins/corePlugins/useChartInteractionListener/useChartInteractionListener.types.d.ts +3 -1
  49. package/esm/internals/plugins/corePlugins/useChartSeries/useChartSeries.selectors.d.ts +1 -1
  50. package/esm/internals/plugins/corePlugins/useChartSeries/useChartSeries.selectors.js +4 -4
  51. package/esm/internals/plugins/featurePlugins/useChartBrush/useChartBrush.selectors.d.ts +1 -1
  52. package/esm/internals/plugins/featurePlugins/useChartBrush/useChartBrush.selectors.js +15 -15
  53. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxis.types.d.ts +1 -1
  54. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisPreview.selectors.js +5 -5
  55. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisRendering.selectors.d.ts +3 -0
  56. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisRendering.selectors.js +11 -11
  57. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianHighlight.selectors.js +5 -6
  58. package/esm/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianInteraction.selectors.js +7 -8
  59. package/esm/internals/plugins/featurePlugins/useChartClosestPoint/findClosestPoints.js +2 -2
  60. package/esm/internals/plugins/featurePlugins/useChartClosestPoint/useChartClosestPoint.selectors.js +2 -2
  61. package/esm/internals/plugins/featurePlugins/useChartHighlight/useChartHighlight.selectors.js +11 -12
  62. package/esm/internals/plugins/featurePlugins/useChartInteraction/useChartInteraction.selectors.js +8 -8
  63. package/esm/internals/plugins/featurePlugins/useChartInteraction/useChartTooltip.selectors.js +4 -4
  64. package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.selectors.js +11 -11
  65. package/esm/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarAxis.selectors.js +6 -6
  66. package/esm/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarInteraction.selectors.js +7 -8
  67. package/esm/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.selectors.js +2 -2
  68. package/esm/internals/plugins/utils/selectors.d.ts +1 -14
  69. package/esm/internals/plugins/utils/selectors.js +1 -5
  70. package/esm/internals/seriesSelectorOfType.d.ts +20 -0
  71. package/esm/internals/seriesSelectorOfType.js +38 -0
  72. package/esm/models/seriesType/bar.d.ts +7 -0
  73. package/esm/models/seriesType/config.d.ts +2 -2
  74. package/esm/utils/index.d.ts +4 -0
  75. package/esm/utils/index.js +5 -0
  76. package/esm/utils/niceDomain.d.ts +20 -0
  77. package/esm/utils/niceDomain.js +24 -0
  78. package/hooks/animation/useAnimateBarLabel.d.ts +1 -1
  79. package/hooks/animation/useAnimateBarLabel.js +61 -12
  80. package/hooks/useAxis.d.ts +116 -16
  81. package/hooks/useAxis.js +122 -18
  82. package/hooks/useBarSeries.js +3 -6
  83. package/hooks/useLineSeries.js +3 -6
  84. package/hooks/usePieSeries.js +3 -6
  85. package/hooks/useRadarSeries.js +3 -6
  86. package/hooks/useScale.d.ts +25 -6
  87. package/hooks/useScale.js +29 -8
  88. package/hooks/useScatterSeries.js +3 -6
  89. package/index.d.ts +2 -1
  90. package/index.js +13 -1
  91. package/internals/domUtils.js +30 -14
  92. package/internals/getScale.d.ts +2 -1
  93. package/internals/index.d.ts +1 -1
  94. package/internals/index.js +4 -4
  95. package/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.selectors.js +2 -2
  96. package/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.selectors.js +4 -5
  97. package/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.selectors.js +2 -2
  98. package/internals/plugins/corePlugins/useChartId/useChartId.selectors.js +2 -2
  99. package/internals/plugins/corePlugins/useChartInteractionListener/useChartInteractionListener.js +4 -1
  100. package/internals/plugins/corePlugins/useChartInteractionListener/useChartInteractionListener.types.d.ts +3 -1
  101. package/internals/plugins/corePlugins/useChartSeries/useChartSeries.selectors.d.ts +1 -1
  102. package/internals/plugins/corePlugins/useChartSeries/useChartSeries.selectors.js +4 -4
  103. package/internals/plugins/featurePlugins/useChartBrush/useChartBrush.selectors.d.ts +1 -1
  104. package/internals/plugins/featurePlugins/useChartBrush/useChartBrush.selectors.js +15 -15
  105. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxis.types.d.ts +1 -1
  106. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisPreview.selectors.js +5 -5
  107. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisRendering.selectors.d.ts +3 -0
  108. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisRendering.selectors.js +11 -11
  109. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianHighlight.selectors.js +4 -5
  110. package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianInteraction.selectors.js +6 -7
  111. package/internals/plugins/featurePlugins/useChartClosestPoint/findClosestPoints.js +2 -2
  112. package/internals/plugins/featurePlugins/useChartClosestPoint/useChartClosestPoint.selectors.js +2 -2
  113. package/internals/plugins/featurePlugins/useChartHighlight/useChartHighlight.selectors.js +10 -11
  114. package/internals/plugins/featurePlugins/useChartInteraction/useChartInteraction.selectors.js +8 -8
  115. package/internals/plugins/featurePlugins/useChartInteraction/useChartTooltip.selectors.js +4 -4
  116. package/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.selectors.js +11 -11
  117. package/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarAxis.selectors.js +6 -6
  118. package/internals/plugins/featurePlugins/useChartPolarAxis/useChartPolarInteraction.selectors.js +6 -7
  119. package/internals/plugins/featurePlugins/useChartZAxis/useChartZAxis.selectors.js +2 -2
  120. package/internals/plugins/utils/selectors.d.ts +1 -14
  121. package/internals/plugins/utils/selectors.js +1 -8
  122. package/internals/seriesSelectorOfType.d.ts +20 -0
  123. package/internals/seriesSelectorOfType.js +46 -0
  124. package/models/seriesType/bar.d.ts +7 -0
  125. package/models/seriesType/config.d.ts +2 -2
  126. package/package.json +5 -5
  127. package/utils/index.d.ts +4 -0
  128. package/utils/index.js +16 -0
  129. package/utils/niceDomain.d.ts +20 -0
  130. package/utils/niceDomain.js +29 -0
  131. package/esm/internals/createSeriesSelectorOfType.d.ts +0 -4
  132. package/esm/internals/createSeriesSelectorOfType.js +0 -45
  133. package/internals/createSeriesSelectorOfType.d.ts +0 -4
  134. package/internals/createSeriesSelectorOfType.js +0 -53
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mui/x-charts",
3
- "version": "8.17.0",
3
+ "version": "8.19.0",
4
4
  "author": "MUI Team",
5
5
  "description": "The community edition of MUI X Charts components.",
6
6
  "license": "MIT",
@@ -28,16 +28,16 @@
28
28
  },
29
29
  "dependencies": {
30
30
  "@babel/runtime": "^7.28.4",
31
- "@mui/utils": "^7.3.3",
31
+ "@mui/utils": "^7.3.5",
32
32
  "bezier-easing": "^2.1.0",
33
33
  "clsx": "^2.1.1",
34
34
  "flatqueue": "^3.0.0",
35
35
  "prop-types": "^15.8.1",
36
36
  "reselect": "^5.1.1",
37
37
  "use-sync-external-store": "^1.6.0",
38
- "@mui/x-internals": "8.17.0",
39
- "@mui/x-charts-vendor": "8.15.0",
40
- "@mui/x-internal-gestures": "0.3.4"
38
+ "@mui/x-charts-vendor": "8.19.0",
39
+ "@mui/x-internal-gestures": "0.3.6",
40
+ "@mui/x-internals": "8.19.0"
41
41
  },
42
42
  "peerDependencies": {
43
43
  "@emotion/react": "^11.9.0",
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Exported utility functions for the x-charts library.
3
+ */
4
+ export * from "./niceDomain.js";
package/utils/index.js ADDED
@@ -0,0 +1,16 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ var _niceDomain = require("./niceDomain");
7
+ Object.keys(_niceDomain).forEach(function (key) {
8
+ if (key === "default" || key === "__esModule") return;
9
+ if (key in exports && exports[key] === _niceDomain[key]) return;
10
+ Object.defineProperty(exports, key, {
11
+ enumerable: true,
12
+ get: function () {
13
+ return _niceDomain[key];
14
+ }
15
+ });
16
+ });
@@ -0,0 +1,20 @@
1
+ import { NumberValue } from '@mui/x-charts-vendor/d3-scale';
2
+ import { ContinuousScaleName } from "../models/index.js";
3
+ /**
4
+ * Returns a nice domain for the given scale type and domain.
5
+ * Does not modify the original domain.
6
+ *
7
+ * Providing a count improves the nice domain calculation by trying to align tick values to round
8
+ * numbers or dates.
9
+ *
10
+ * For example, if you have a domain of [29, 72] and there are 5 ticks, the nice domain will be
11
+ * [20, 80] so that the ticks can be at [20, 35, 50, 65, 80].
12
+ * However, if there are 11 ticks, the nice domain will be [25, 75] so that the ticks can be at
13
+ * [25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75].
14
+ *
15
+ * @param scaleType The type of the scale (e.g., 'linear', 'log', 'time', etc.).
16
+ * @param domain The domain to be made nicer.
17
+ * @param count An optional number of ticks to improve the nice domain calculation. Defaults to 5.
18
+ */
19
+ export declare function niceDomain<Domain extends NumberValue>(scaleType: Exclude<ContinuousScaleName, 'time' | 'utc'>, domain: Iterable<Domain>, count?: number): Domain[];
20
+ export declare function niceDomain<Domain extends NumberValue>(scaleType: 'time' | 'utc', domain: Iterable<Domain>, count?: number): Date[];
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.niceDomain = niceDomain;
7
+ var _getScale = require("../internals/getScale");
8
+ /**
9
+ * Returns a nice domain for the given scale type and domain.
10
+ * Does not modify the original domain.
11
+ *
12
+ * Providing a count improves the nice domain calculation by trying to align tick values to round
13
+ * numbers or dates.
14
+ *
15
+ * For example, if you have a domain of [29, 72] and there are 5 ticks, the nice domain will be
16
+ * [20, 80] so that the ticks can be at [20, 35, 50, 65, 80].
17
+ * However, if there are 11 ticks, the nice domain will be [25, 75] so that the ticks can be at
18
+ * [25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75].
19
+ *
20
+ * @param scaleType The type of the scale (e.g., 'linear', 'log', 'time', etc.).
21
+ * @param domain The domain to be made nicer.
22
+ * @param count An optional number of ticks to improve the nice domain calculation. Defaults to 5.
23
+ */
24
+
25
+ function niceDomain(scaleType, domain, count = 5) {
26
+ const scale = (0, _getScale.getScale)(scaleType, domain, [0, 1]);
27
+ scale.nice(count);
28
+ return scale.domain();
29
+ }
@@ -1,4 +0,0 @@
1
- import { ChartSeriesDefaultized, ChartsSeriesConfig } from "../models/seriesType/config.js";
2
- import { SeriesId } from "../models/seriesType/common.js";
3
- export declare function createSeriesSelectorsOfType<T extends keyof ChartsSeriesConfig>(seriesType: T): (ids?: SeriesId | SeriesId[]) => ChartSeriesDefaultized<T> | (ChartSeriesDefaultized<T> | undefined)[] | undefined;
4
- export declare function createAllSeriesSelectorOfType<T extends keyof ChartsSeriesConfig>(seriesType: T): () => import("./index.js").ProcessedSeries<keyof ChartsSeriesConfig>[T];
@@ -1,45 +0,0 @@
1
- // import { fastArrayCompare } from '@mui/x-internals/fastArrayCompare';
2
- import { warnOnce } from '@mui/x-internals/warning';
3
- import { createSelector } from "./plugins/utils/selectors.js";
4
- import { selectorChartSeriesProcessed } from "./plugins/corePlugins/useChartSeries/useChartSeries.selectors.js";
5
- import { useStore } from "./store/useStore.js";
6
- import { useSelector } from "./store/useSelector.js";
7
- export function createSeriesSelectorsOfType(seriesType) {
8
- const selectorSeriesWithIds = createSelector([selectorChartSeriesProcessed], (processedSeries, ids) => {
9
- if (!ids || Array.isArray(ids) && ids.length === 0) {
10
- return processedSeries[seriesType]?.seriesOrder?.map(seriesId => processedSeries[seriesType]?.series[seriesId]) ?? [];
11
- }
12
- if (!Array.isArray(ids)) {
13
- return processedSeries[seriesType]?.series?.[ids];
14
- }
15
- const result = [];
16
- const failedIds = [];
17
- for (const id of ids) {
18
- const series = processedSeries[seriesType]?.series?.[id];
19
- if (series) {
20
- result.push(series);
21
- } else {
22
- failedIds.push(id);
23
- }
24
- }
25
- if (process.env.NODE_ENV !== 'production' && failedIds.length > 0) {
26
- const formattedIds = failedIds.map(v => JSON.stringify(v)).join(', ');
27
- const fnName = `use${seriesType.charAt(0).toUpperCase()}${seriesType.slice(1)}Series`;
28
- warnOnce([`MUI X Charts: The following ids provided to "${fnName}" could not be found: ${formattedIds}.`, `Make sure that they exist and their series are using the "${seriesType}" series type.`]);
29
- }
30
- return result;
31
- });
32
- return ids => {
33
- const store = useStore();
34
- return useSelector(store, selectorSeriesWithIds, ids
35
- // fastArrayCompare
36
- );
37
- };
38
- }
39
- export function createAllSeriesSelectorOfType(seriesType) {
40
- const selectorSeries = createSelector([selectorChartSeriesProcessed], processedSeries => processedSeries[seriesType]);
41
- return () => {
42
- const store = useStore();
43
- return useSelector(store, selectorSeries);
44
- };
45
- }
@@ -1,4 +0,0 @@
1
- import { ChartSeriesDefaultized, ChartsSeriesConfig } from "../models/seriesType/config.js";
2
- import { SeriesId } from "../models/seriesType/common.js";
3
- export declare function createSeriesSelectorsOfType<T extends keyof ChartsSeriesConfig>(seriesType: T): (ids?: SeriesId | SeriesId[]) => ChartSeriesDefaultized<T> | (ChartSeriesDefaultized<T> | undefined)[] | undefined;
4
- export declare function createAllSeriesSelectorOfType<T extends keyof ChartsSeriesConfig>(seriesType: T): () => import("./index.js").ProcessedSeries<keyof ChartsSeriesConfig>[T];
@@ -1,53 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.createAllSeriesSelectorOfType = createAllSeriesSelectorOfType;
7
- exports.createSeriesSelectorsOfType = createSeriesSelectorsOfType;
8
- var _warning = require("@mui/x-internals/warning");
9
- var _selectors = require("./plugins/utils/selectors");
10
- var _useChartSeries = require("./plugins/corePlugins/useChartSeries/useChartSeries.selectors");
11
- var _useStore = require("./store/useStore");
12
- var _useSelector = require("./store/useSelector");
13
- // import { fastArrayCompare } from '@mui/x-internals/fastArrayCompare';
14
-
15
- function createSeriesSelectorsOfType(seriesType) {
16
- const selectorSeriesWithIds = (0, _selectors.createSelector)([_useChartSeries.selectorChartSeriesProcessed], (processedSeries, ids) => {
17
- if (!ids || Array.isArray(ids) && ids.length === 0) {
18
- return processedSeries[seriesType]?.seriesOrder?.map(seriesId => processedSeries[seriesType]?.series[seriesId]) ?? [];
19
- }
20
- if (!Array.isArray(ids)) {
21
- return processedSeries[seriesType]?.series?.[ids];
22
- }
23
- const result = [];
24
- const failedIds = [];
25
- for (const id of ids) {
26
- const series = processedSeries[seriesType]?.series?.[id];
27
- if (series) {
28
- result.push(series);
29
- } else {
30
- failedIds.push(id);
31
- }
32
- }
33
- if (process.env.NODE_ENV !== 'production' && failedIds.length > 0) {
34
- const formattedIds = failedIds.map(v => JSON.stringify(v)).join(', ');
35
- const fnName = `use${seriesType.charAt(0).toUpperCase()}${seriesType.slice(1)}Series`;
36
- (0, _warning.warnOnce)([`MUI X Charts: The following ids provided to "${fnName}" could not be found: ${formattedIds}.`, `Make sure that they exist and their series are using the "${seriesType}" series type.`]);
37
- }
38
- return result;
39
- });
40
- return ids => {
41
- const store = (0, _useStore.useStore)();
42
- return (0, _useSelector.useSelector)(store, selectorSeriesWithIds, ids
43
- // fastArrayCompare
44
- );
45
- };
46
- }
47
- function createAllSeriesSelectorOfType(seriesType) {
48
- const selectorSeries = (0, _selectors.createSelector)([_useChartSeries.selectorChartSeriesProcessed], processedSeries => processedSeries[seriesType]);
49
- return () => {
50
- const store = (0, _useStore.useStore)();
51
- return (0, _useSelector.useSelector)(store, selectorSeries);
52
- };
53
- }