@react-fabric/chart 1.0.0-beta.9 → 1.0.1

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 (82) hide show
  1. package/{src/wrapper/Chart.module.css → css/_chart.css} +11 -11
  2. package/css/styles.css +24 -0
  3. package/dist/cjs/charts/ActivityMap.js +70 -36
  4. package/dist/cjs/charts/CountSeries.js +67 -35
  5. package/dist/cjs/charts/DataSeries.js +75 -40
  6. package/dist/cjs/charts/Generic.js +41 -19
  7. package/dist/cjs/charts/MapSeries.js +41 -17
  8. package/dist/cjs/charts/TimeSeries.js +73 -40
  9. package/dist/cjs/charts/TimeSlider.js +40 -21
  10. package/dist/cjs/charts/WordBubble.js +65 -29
  11. package/dist/cjs/index.js +28 -0
  12. package/dist/cjs/theme/darkBase.js +13 -10
  13. package/dist/cjs/theme/index.js +43 -23
  14. package/dist/cjs/theme/lightBase.js +18 -15
  15. package/dist/cjs/theme/palettes.js +5 -54
  16. package/dist/cjs/types/charts.js +4 -2
  17. package/dist/cjs/types/utils.js +6 -9
  18. package/dist/cjs/wrapper/ChartContainer.js +26 -18
  19. package/dist/cjs/wrapper/ChartToolbar.js +4 -5
  20. package/dist/cjs/wrapper/ChartWrapper.js +4 -5
  21. package/dist/cjs/wrapper/PaletteSelect.js +31 -18
  22. package/dist/esm/charts/ActivityMap.js +71 -37
  23. package/dist/esm/charts/CountSeries.js +68 -36
  24. package/dist/esm/charts/DataSeries.js +76 -41
  25. package/dist/esm/charts/Generic.js +43 -21
  26. package/dist/esm/charts/MapSeries.js +41 -17
  27. package/dist/esm/charts/TimeSeries.js +74 -41
  28. package/dist/esm/charts/TimeSlider.js +41 -22
  29. package/dist/esm/charts/WordBubble.js +67 -31
  30. package/dist/esm/index.js +30 -0
  31. package/dist/esm/theme/darkBase.js +13 -10
  32. package/dist/esm/theme/index.js +43 -23
  33. package/dist/esm/theme/lightBase.js +18 -15
  34. package/dist/esm/theme/palettes.js +5 -54
  35. package/dist/esm/types/charts.js +4 -2
  36. package/dist/esm/types/utils.js +6 -9
  37. package/dist/esm/wrapper/ChartContainer.js +27 -19
  38. package/dist/esm/wrapper/ChartToolbar.js +4 -5
  39. package/dist/esm/wrapper/ChartWrapper.js +4 -5
  40. package/dist/esm/wrapper/PaletteSelect.js +32 -19
  41. package/dist/types/charts/ActivityMap.d.ts +20 -4
  42. package/dist/types/charts/CountSeries.d.ts +25 -3
  43. package/dist/types/charts/DataSeries.d.ts +26 -1
  44. package/dist/types/charts/Generic.d.ts +36 -52
  45. package/dist/types/charts/MapSeries.d.ts +31 -3
  46. package/dist/types/charts/TimeSeries.d.ts +24 -1
  47. package/dist/types/charts/TimeSlider.d.ts +19 -5
  48. package/dist/types/charts/WordBubble.d.ts +28 -5
  49. package/dist/types/index.d.ts +26 -0
  50. package/dist/types/theme/darkBase.d.ts +8 -5
  51. package/dist/types/theme/index.d.ts +3 -2
  52. package/dist/types/theme/lightBase.d.ts +8 -5
  53. package/dist/types/types/charts.d.ts +2 -1
  54. package/dist/types/types/index.d.ts +30 -12
  55. package/dist/types/types/world.svg.d.ts +1 -1
  56. package/dist/types/wrapper/ChartContainer.d.ts +7 -7
  57. package/dist/types/wrapper/ChartToolbar.d.ts +2 -3
  58. package/dist/types/wrapper/ChartWrapper.d.ts +3 -5
  59. package/dist/types/wrapper/PaletteSelect.d.ts +6 -1
  60. package/package.json +17 -21
  61. package/src/charts/ActivityMap.tsx +95 -94
  62. package/src/charts/CountSeries.tsx +73 -65
  63. package/src/charts/DataSeries.tsx +104 -98
  64. package/src/charts/Generic.tsx +56 -86
  65. package/src/charts/MapSeries.tsx +153 -151
  66. package/src/charts/TimeSeries.tsx +96 -79
  67. package/src/charts/TimeSlider.tsx +194 -195
  68. package/src/charts/WordBubble.tsx +97 -62
  69. package/src/index.ts +22 -17
  70. package/src/theme/darkBase.ts +12 -9
  71. package/src/theme/index.ts +92 -30
  72. package/src/theme/lightBase.ts +17 -14
  73. package/src/theme/palettes.ts +1 -52
  74. package/src/types/charts.ts +6 -2
  75. package/src/types/index.ts +40 -4
  76. package/src/types/utils.ts +18 -30
  77. package/src/wrapper/ChartContainer.tsx +48 -79
  78. package/src/wrapper/ChartToolbar.tsx +5 -12
  79. package/src/wrapper/ChartWrapper.tsx +5 -10
  80. package/src/wrapper/PaletteSelect.tsx +43 -40
  81. package/dist/cjs/wrapper/Chart.module.css +0 -1
  82. package/dist/esm/wrapper/Chart.module.css +0 -1
@@ -12,16 +12,19 @@ var PaletteSelect = require('../wrapper/PaletteSelect.js');
12
12
  var jsxRuntime = require('react/jsx-runtime');
13
13
 
14
14
  function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
15
- function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
15
+ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
16
16
  var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
17
- var data = _ref.data,
17
+ var _series = _ref.series,
18
18
  onExport = _ref.onExport,
19
19
  categoryAxisName = _ref.categoryAxisName,
20
20
  valueAxisName = _ref.valueAxisName,
21
21
  title = _ref.title,
22
+ showThemeSelector = _ref.showThemeSelector,
23
+ showTypeSelector = _ref.showTypeSelector,
22
24
  chartTheme = _ref.theme,
23
25
  _ref$type = _ref.type,
24
26
  chartType = _ref$type === void 0 ? "column" : _ref$type,
27
+ optionOverride = _ref.options,
25
28
  _onClick = _ref.onClick,
26
29
  onBrush = _ref.onBrush;
27
30
  var chartRef = react.useRef(null);
@@ -34,9 +37,11 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
34
37
  theme = _useState4[0],
35
38
  setTheme = _useState4[1];
36
39
  react.useEffect(function () {
40
+ // eslint-disable-next-line @eslint-react/set-state-in-effect
37
41
  setType(chartType);
38
42
  }, [chartType]);
39
43
  react.useEffect(function () {
44
+ // eslint-disable-next-line @eslint-react/set-state-in-effect
40
45
  setTheme(chartTheme);
41
46
  }, [chartTheme]);
42
47
  var enableBrush = react.useCallback(function () {
@@ -65,6 +70,7 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
65
70
  var range = [0, 0];
66
71
  chart.on("brushselected", function (e) {
67
72
  var _e$batch;
73
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
68
74
  range = (_e$batch = e.batch) === null || _e$batch === void 0 || (_e$batch = _e$batch[0]) === null || _e$batch === void 0 || (_e$batch = _e$batch.areas) === null || _e$batch === void 0 || (_e$batch = _e$batch[0]) === null || _e$batch === void 0 ? void 0 : _e$batch.coordRange;
69
75
  });
70
76
  chart.on("brushEnd", function () {
@@ -76,13 +82,16 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
76
82
  enableBrush();
77
83
  });
78
84
  return function () {
79
- !chart.isDisposed() && chart.off("brushEnd");
80
- !chart.isDisposed() && chart.off("brushselected");
85
+ if (!chart.isDisposed()) {
86
+ chart.off("brushEnd");
87
+ chart.off("brushselected");
88
+ }
81
89
  };
82
90
  }
83
- }, [chartRef.current, onBrush]);
91
+ // eslint-disable-next-line @eslint-react/exhaustive-deps
92
+ }, [enableBrush, onBrush, chartRef.current]);
84
93
  var options = core.useMemoDebugger(function () {
85
- if (utilities.isEmpty(data)) {
94
+ if (utilities.isEmpty(_series)) {
86
95
  var _chartRef$current3;
87
96
  (_chartRef$current3 = chartRef.current) === null || _chartRef$current3 === void 0 || _chartRef$current3.clear();
88
97
  return {};
@@ -92,7 +101,7 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
92
101
  _type$split2 = _slicedToArray(_type$split, 2),
93
102
  _type = _type$split2[0],
94
103
  stacked = _type$split2[1];
95
- var categoryAxis = {
104
+ var categoryAxis = Object.assign({}, optionOverride === null || optionOverride === void 0 ? void 0 : optionOverride.xAxis, {
96
105
  name: categoryAxisName,
97
106
  type: "time",
98
107
  nameGap: 32,
@@ -112,88 +121,89 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
112
121
  none: "{yyyy}-{MM}-{dd} {hh}:{mm}:{ss} {SSS}"
113
122
  }
114
123
  }
115
- };
116
- var valueAxis = {
124
+ });
125
+ var valueAxis = Object.assign({}, optionOverride === null || optionOverride === void 0 ? void 0 : optionOverride.yAxis, {
117
126
  name: valueAxisName,
118
127
  type: "value",
119
128
  nameGap: 32,
120
129
  nameLocation: "center"
121
- };
122
- var series = data === null || data === void 0 ? void 0 : data.map(function (item) {
123
- var _item$label;
124
- return {
125
- id: item.id,
126
- stack: stack,
130
+ });
131
+ var series = _series === null || _series === void 0 ? void 0 : _series.map(function (item) {
132
+ var _item$stack, _item$name;
133
+ return _objectSpread(_objectSpread({}, item), {}, {
134
+ stack: (_item$stack = item.stack) !== null && _item$stack !== void 0 ? _item$stack : stack,
127
135
  areaStyle: stacked ? {} : undefined,
128
136
  symbol: "none",
129
137
  type: _type === "column" ? "bar" : _type,
130
- name: (_item$label = item.label) !== null && _item$label !== void 0 ? _item$label : item.id,
131
- data: item.values,
138
+ name: (_item$name = item.name) !== null && _item$name !== void 0 ? _item$name : item.id,
132
139
  universalTransition: true
133
- };
140
+ });
134
141
  });
135
- return {
136
- xAxis: categoryAxis,
137
- yAxis: valueAxis,
138
- series: series,
142
+ return _objectSpread(_objectSpread({
139
143
  brush: {
140
144
  toolbox: ["lineX", "clear"],
141
145
  brushType: "lineX",
142
146
  xAxisIndex: 0
143
- },
144
- tooltip: {
147
+ }
148
+ }, optionOverride), {}, {
149
+ tooltip: Object.assign({
145
150
  trigger: "axis",
146
151
  confine: true,
147
- position: "top"
148
- }
149
- };
150
- }, [data, type, categoryAxisName, valueAxisName], "TimeChart options");
152
+ position: "top",
153
+ appendTo: "body"
154
+ }, optionOverride === null || optionOverride === void 0 ? void 0 : optionOverride.tooltip),
155
+ xAxis: categoryAxis,
156
+ yAxis: valueAxis,
157
+ series: series
158
+ });
159
+ }, [_series, type, categoryAxisName, valueAxisName, optionOverride], "TimeChart options");
151
160
  return /*#__PURE__*/jsxRuntime.jsxs(ChartContainer.ChartContainer, {
152
161
  title: title,
153
162
  onExport: onExport,
154
163
  theme: theme,
155
164
  options: options,
156
165
  chartRef: chartRef,
157
- isEmpty: utilities.isEmpty(data),
158
- emptyIcon: core.CoreIcons.chartColumn,
166
+ isEmpty: utilities.isEmpty(_series),
167
+ emptyIcon: "icon-[mdi--chart-bar] rotate-90 -scale-x-100",
159
168
  dataTableRenderer: utils.timeSeriesRenderer,
160
169
  onClick: function onClick(e) {
170
+ var _, _e$data, _e$seriesId;
161
171
  return _onClick === null || _onClick === void 0 ? void 0 : _onClick({
162
- category: e.data[0],
163
- series: e.seriesId
172
+ category: (_ = e === null || e === void 0 || (_e$data = e.data) === null || _e$data === void 0 ? void 0 : _e$data[0]) !== null && _ !== void 0 ? _ : "",
173
+ series: (_e$seriesId = e.seriesId) !== null && _e$seriesId !== void 0 ? _e$seriesId : ""
164
174
  });
165
175
  },
166
- children: [/*#__PURE__*/jsxRuntime.jsxs(core.ToggleButtonGroup, {
176
+ children: [showTypeSelector && /*#__PURE__*/jsxRuntime.jsxs(core.ToggleButtonGroup, {
167
177
  value: type,
168
178
  onChange: setType,
169
179
  children: [/*#__PURE__*/jsxRuntime.jsx(core.Button, {
170
180
  size: "sm",
171
181
  variant: "link",
172
- icon: core.CoreIcons.chartLine,
182
+ icon: "icon-[mdi--chart-line]",
173
183
  value: "line",
174
184
  "aria-label": "line"
175
185
  }), /*#__PURE__*/jsxRuntime.jsx(core.Button, {
176
186
  size: "sm",
177
187
  variant: "link",
178
- icon: core.CoreIcons.chartColumn,
188
+ icon: "icon-[mdi--chart-bar]",
179
189
  value: "column",
180
190
  "aria-label": "column"
181
191
  }), /*#__PURE__*/jsxRuntime.jsx(core.Button, {
182
192
  size: "sm",
183
193
  variant: "link",
184
- icon: core.CoreIcons.chartLineStacked,
194
+ icon: "icon-[mdi--chart-line-stacked]",
185
195
  value: "line-stacked",
186
196
  "aria-label": "line-stacked"
187
197
  }), /*#__PURE__*/jsxRuntime.jsx(core.Button, {
188
198
  size: "sm",
189
199
  variant: "link",
190
- icon: core.CoreIcons.chartColumnStacked,
200
+ icon: "icon-[mdi--chart-bar-stacked]",
191
201
  value: "column-stacked",
192
202
  "aria-label": "column-stacked"
193
203
  })]
194
- }), /*#__PURE__*/jsxRuntime.jsx(core.Divider, {
204
+ }), showTypeSelector && showThemeSelector && /*#__PURE__*/jsxRuntime.jsx(core.Divider, {
195
205
  vertical: true
196
- }), /*#__PURE__*/jsxRuntime.jsx(PaletteSelect.PaletteSelect, {
206
+ }), showThemeSelector && /*#__PURE__*/jsxRuntime.jsx(PaletteSelect.PaletteSelect, {
197
207
  theme: theme,
198
208
  onClick: setTheme
199
209
  })]
@@ -202,7 +212,30 @@ var TimeSeriesChart = /*#__PURE__*/react.memo(function (_ref) {
202
212
  TimeSeriesChart.displayName = "TimeSeriesChart";
203
213
 
204
214
  /**
205
- * Chart to display simple data time series
215
+ * TimeSeries component renders a time series chart using the provided data and options.
216
+ * It supports different chart types such as line, column, and stacked variants.
217
+ * It also allows for interaction through click and brush events.
218
+ *
219
+ * @param {TimeSeriesProps} props - The properties for the TimeSeries component.
220
+ * @returns {React.ReactElement} The rendered TimeSeries component.
221
+ *
222
+ * @example
223
+ * ```jsx
224
+ * <TimeSeries
225
+ * data={data}
226
+ * onExport={handleExport}
227
+ * categoryAxisName="Time"
228
+ * valueAxisName="Value"
229
+ * title="Time Series Chart"
230
+ * type="line"
231
+ * onClick={(data) => console.log(data)}
232
+ * onBrush={(range) => console.log(range)}
233
+ * />
234
+ * ```
235
+ *
236
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/charts-timeseries--docs} for more details on the properties.
237
+ * @see {@link https://echarts.apache.org/en/option.html#series-line} for more details on the ECharts line series options.
238
+ * @see {@link https://echarts.apache.org/en/option.html#series-bar} for more details on the ECharts bar series options.
206
239
  */
207
240
  var TimeSeries = function TimeSeries(props) {
208
241
  return /*#__PURE__*/jsxRuntime.jsx(ChartWrapper.ChartWrapper, {
@@ -11,9 +11,9 @@ var ChartWrapper = require('../wrapper/ChartWrapper.js');
11
11
  var jsxRuntime = require('react/jsx-runtime');
12
12
 
13
13
  function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
14
- function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
14
+ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
15
15
  var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
16
- var data = _ref.data,
16
+ var dataSeries = _ref.series,
17
17
  sliderRange = _ref.range,
18
18
  onBrush = _ref.onBrush;
19
19
  var chartRef = react.useRef(null);
@@ -26,21 +26,22 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
26
26
  setRange = _useState2[1];
27
27
  var handleBrush = core.useDebounce(function (range) {
28
28
  return onBrush === null || onBrush === void 0 ? void 0 : onBrush(range);
29
- }, [onBrush], 100);
29
+ }, [onBrush], 250);
30
30
  react.useEffect(function () {
31
- var _data$, _data;
32
- var defaultStart = data.length > 0 ? data === null || data === void 0 || (_data$ = data[0]) === null || _data$ === void 0 || (_data$ = _data$[0]) === null || _data$ === void 0 ? void 0 : _data$.getTime() : 0;
33
- var defaultEnd = data.length > 0 ? data === null || data === void 0 || (_data = data[data.length - 1]) === null || _data === void 0 || (_data = _data[0]) === null || _data === void 0 ? void 0 : _data.getTime() : 32;
31
+ var _dataSeries$, _dataSeries;
32
+ var defaultStart = dataSeries.length > 0 ? dataSeries === null || dataSeries === void 0 || (_dataSeries$ = dataSeries[0]) === null || _dataSeries$ === void 0 || (_dataSeries$ = _dataSeries$[0]) === null || _dataSeries$ === void 0 ? void 0 : _dataSeries$.getTime() : 0;
33
+ var defaultEnd = dataSeries.length > 0 ? dataSeries === null || dataSeries === void 0 || (_dataSeries = dataSeries[dataSeries.length - 1]) === null || _dataSeries === void 0 || (_dataSeries = _dataSeries[0]) === null || _dataSeries === void 0 ? void 0 : _dataSeries.getTime() : 32;
34
34
  var getRangeValue = function getRangeValue() {
35
35
  var v = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
36
36
  var def = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
37
37
  return v >= defaultStart && v <= defaultEnd ? v : def;
38
38
  };
39
+ // eslint-disable-next-line @eslint-react/set-state-in-effect
39
40
  setRange({
40
41
  startValue: getRangeValue(sliderRange === null || sliderRange === void 0 ? void 0 : sliderRange.start.getTime(), defaultStart),
41
42
  endValue: getRangeValue(sliderRange === null || sliderRange === void 0 ? void 0 : sliderRange.end.getTime(), defaultEnd)
42
43
  });
43
- }, [sliderRange, data]);
44
+ }, [sliderRange, dataSeries]);
44
45
  var enableBrush = react.useCallback(function () {
45
46
  var _chartRef$current, _chartRef$current2;
46
47
  (_chartRef$current = chartRef.current) === null || _chartRef$current === void 0 || _chartRef$current.dispatchAction({
@@ -58,8 +59,8 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
58
59
  if (chart && !(chart !== null && chart !== void 0 && chart.isDisposed())) {
59
60
  enableBrush();
60
61
  chart.on("datazoom", function () {
61
- var _chart$getOption$data;
62
- var zoom = (_chart$getOption$data = chart.getOption().dataZoom) === null || _chart$getOption$data === void 0 ? void 0 : _chart$getOption$data[0];
62
+ var _dataZoom;
63
+ var zoom = (_dataZoom = chart.getOption().dataZoom) === null || _dataZoom === void 0 ? void 0 : _dataZoom[0];
63
64
  if (zoom) {
64
65
  var startValue = Math.floor(zoom.startValue);
65
66
  var endValue = Math.ceil(zoom.endValue + (24 * 60 * 60 * 1000 - 1));
@@ -74,12 +75,12 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
74
75
  }
75
76
  });
76
77
  return function () {
77
- !chart.isDisposed() && chart.off("datazoom");
78
+ if (!chart.isDisposed()) chart.off("datazoom");
78
79
  };
79
80
  }
80
81
  }, [chartRef.current, handleBrush], "TimeSldier onBrush");
81
82
  var options = core.useMemoDebugger(function () {
82
- if (utilities.isEmpty(data)) {
83
+ if (utilities.isEmpty(dataSeries)) {
83
84
  var _chartRef$current3;
84
85
  (_chartRef$current3 = chartRef.current) === null || _chartRef$current3 === void 0 || _chartRef$current3.clear();
85
86
  return {};
@@ -124,7 +125,7 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
124
125
  lineStyle: {
125
126
  width: 2
126
127
  },
127
- data: data
128
+ data: dataSeries
128
129
  }];
129
130
  return {
130
131
  grid: {
@@ -147,22 +148,22 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
147
148
  legend: {
148
149
  show: false
149
150
  },
150
- dataZoom: [_objectSpread({
151
+ dataZoom: _objectSpread({
151
152
  type: "slider",
152
153
  height: "45%",
153
154
  bottom: 4,
154
155
  left: 2,
155
156
  right: 8
156
- }, range)],
157
+ }, range),
157
158
  tooltip: {
158
159
  trigger: "axis",
159
160
  confine: true,
160
161
  position: "top"
161
162
  }
162
163
  };
163
- }, [data], "TimeSlider options");
164
+ }, [dataSeries], "TimeSlider options");
164
165
  react.useEffect(function () {
165
- setTimeout(function () {
166
+ var tmr = setTimeout(function () {
166
167
  var _chartRef$current4;
167
168
  (_chartRef$current4 = chartRef.current) === null || _chartRef$current4 === void 0 || _chartRef$current4.setOption({
168
169
  dataZoom: [_objectSpread({
@@ -174,21 +175,39 @@ var TimeSliderChart = /*#__PURE__*/react.memo(function (_ref) {
174
175
  }, range)]
175
176
  });
176
177
  }, 50);
177
- }, [chartRef.current, range]);
178
+ return function () {
179
+ clearTimeout(tmr);
180
+ };
181
+ }, [range]);
178
182
  return /*#__PURE__*/jsxRuntime.jsx(ChartContainer.ChartContainer, {
179
183
  options: options,
180
184
  chartRef: chartRef,
181
- isEmpty: utilities.isEmpty(data)
185
+ isEmpty: utilities.isEmpty(dataSeries)
182
186
  });
183
187
  });
184
188
  TimeSliderChart.displayName = "TimeSliderChart";
185
189
 
186
190
  /**
187
- * Chart to display time scale data with zoom and brush */
188
- var TimeSlider = function TimeSlider(props) {
191
+ * TimeSlider component renders a time slider chart.
192
+ * It allows users to visualize time-based data and interactively select a range.
193
+ * The chart supports brushing to select a specific time range,
194
+ * and it emits an event when the range is changed.
195
+ *
196
+ * @example
197
+ * ```jsx
198
+ * <TimeSlider
199
+ * data={data}
200
+ * range={{ start: new Date("2023-01-01"), end: new Date("2023-12-31") }}
201
+ * onBrush={(range) => console.log("Selected range:", range)}
202
+ * />
203
+ * ```
204
+ * @see {@link https://echarts.apache.org/en/option.html#dataZoom} for more details on the ECharts dataZoom feature.
205
+ * @see {@link https://echarts.apache.org/en/option.html#series-line} for more details on the ECharts line series.
206
+ */
207
+ function TimeSlider(props) {
189
208
  return /*#__PURE__*/jsxRuntime.jsx(ChartWrapper.ChartWrapper, {
190
209
  children: /*#__PURE__*/jsxRuntime.jsx(TimeSliderChart, _objectSpread({}, props))
191
210
  });
192
- };
211
+ }
193
212
 
194
213
  exports.TimeSlider = TimeSlider;
@@ -11,54 +11,71 @@ var ChartWrapper = require('../wrapper/ChartWrapper.js');
11
11
  var jsxRuntime = require('react/jsx-runtime');
12
12
 
13
13
  function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
14
- function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
14
+ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
15
15
  var WordBubbleChart = /*#__PURE__*/react.memo(function (_ref) {
16
- var data = _ref.data,
16
+ var series = _ref.series,
17
17
  title = _ref.title,
18
18
  onExport = _ref.onExport,
19
19
  _onClick = _ref.onClick;
20
20
  var isDark = core.useIsDark();
21
21
  var options = core.useMemoDebugger(function () {
22
- if (utilities.isEmpty(data)) return {};
22
+ if (utilities.isEmpty(series)) return {};
23
23
  var palette = isDark ? palettes.ChartPalette.CloudDark : palettes.ChartPalette.CloudLight;
24
24
  return {
25
25
  legend: undefined,
26
+ tooltip: {
27
+ trigger: "axis",
28
+ confine: true,
29
+ position: "top",
30
+ appendToBody: true
31
+ },
32
+ grid: {
33
+ top: 128,
34
+ bottom: 16
35
+ },
26
36
  series: [{
27
37
  name: title,
28
- type: "wordCloud",
29
- shape: "circle",
30
- sizeRange: [12, 60],
31
- gridSize: 32,
32
- rotationRange: [-10, 10],
33
- rotationStep: 1,
34
- drawOutOfBound: false,
35
- layoutAnimation: true,
36
- textStyle: {
37
- fontFamily: "sans-serif",
38
- fontWeight: "bold",
39
- color: function color(_ref2) {
40
- var dataIndex = _ref2.dataIndex;
41
- return palette[dataIndex % palette.length];
42
- }
38
+ type: "custom",
39
+ renderItem: "wordCloud",
40
+ coordinateSystem: "none",
41
+ itemPayload: {
42
+ shape: "circle",
43
+ gridSize: 4,
44
+ sizeRange: [32, 96],
45
+ rotationRange: [0, 0],
46
+ rotationStep: 1,
47
+ drawOutOfBound: false,
48
+ top: 48,
49
+ bottom: 32,
50
+ left: 32,
51
+ right: 32
43
52
  },
44
- data: data.sort(utilities.compareValues("desc", "count")).map(function (_ref3, index) {
45
- var key = _ref3.id,
46
- label = _ref3.label,
47
- count = _ref3.count;
53
+ data: series.map(function (_ref2, index) {
54
+ var key = _ref2.id,
55
+ label = _ref2.label,
56
+ count = _ref2.count;
48
57
  return {
49
58
  name: label !== null && label !== void 0 ? label : key,
50
- value: count
59
+ value: [label !== null && label !== void 0 ? label : key, count],
60
+ itemStyle: {
61
+ color: palette[index % palette.length]
62
+ },
63
+ emphasis: {
64
+ itemStyle: {
65
+ color: "#f00"
66
+ }
67
+ }
51
68
  };
52
69
  })
53
70
  }]
54
71
  };
55
- }, [data, title, isDark], "WordChart options");
72
+ }, [series, title, isDark], "WordChart options");
56
73
  return /*#__PURE__*/jsxRuntime.jsx(ChartContainer.ChartContainer, {
57
74
  title: title,
58
75
  onExport: onExport,
59
76
  options: options,
60
- isEmpty: utilities.isEmpty(data),
61
- emptyIcon: core.CoreIcons.chartActivityScatter,
77
+ isEmpty: utilities.isEmpty(series),
78
+ emptyIcon: "icon-[mdi--chart-bubble]",
62
79
  dataTableRenderer: utils.countRenderer,
63
80
  onClick: function onClick(e) {
64
81
  var _e$name;
@@ -69,12 +86,31 @@ var WordBubbleChart = /*#__PURE__*/react.memo(function (_ref) {
69
86
  WordBubbleChart.displayName = "WordBubbleChart";
70
87
 
71
88
  /**
72
- * Chart to display simple word cloud
89
+ * WordBubble component renders a word cloud chart using ECharts.
90
+ * It displays words with sizes proportional to their frequency in the data.
91
+ * Users can click on words to trigger an action, such as filtering or navigating.
92
+ * It also supports exporting the chart and displays an empty state when no data is available.
93
+ *
94
+ * @example
95
+ * ```jsx
96
+ * <WordBubble
97
+ * data={[
98
+ * { id: "1", label: "Word One", count: 10 },
99
+ * { id: "2", label: "Word Two", count: 20 },
100
+ * { id: "3", label: "Word Three", count: 30 },
101
+ * ]}
102
+ * title="Word Frequency"
103
+ * onExport={() => console.log("Exporting chart...")}
104
+ * onClick={(key) => console.log("Clicked word:", key)}
105
+ * theme="light"
106
+ * />
107
+ * ```
108
+ * @see {@link https://github.com/apache/echarts-custom-series} for the underlying chart implementation.
73
109
  */
74
- var WordBubble = function WordBubble(props) {
110
+ function WordBubble(props) {
75
111
  return /*#__PURE__*/jsxRuntime.jsx(ChartWrapper.ChartWrapper, {
76
112
  children: /*#__PURE__*/jsxRuntime.jsx(WordBubbleChart, _objectSpread({}, props))
77
113
  });
78
- };
114
+ }
79
115
 
80
116
  exports.WordBubble = WordBubble;
package/dist/cjs/index.js CHANGED
@@ -10,7 +10,33 @@ var TimeSlider = require('./charts/TimeSlider.js');
10
10
  var WordBubble = require('./charts/WordBubble.js');
11
11
  var charts = require('./types/charts.js');
12
12
 
13
+ /**
14
+ * React Fabric
15
+ * @version 1.0.0
16
+ * @license MIT
17
+ * @copyright 2024 Adarsh Pastakia
18
+ *
19
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
20
+ * of this software and associated documentation files (the "Software"), to deal
21
+ * in the Software without restriction, including without limitation the rights
22
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
23
+ * copies of the Software, and to permit persons to whom the Software is
24
+ * furnished to do so, subject to the following conditions:
25
+ *
26
+ * The above copyright notice and this permission notice shall be included in all
27
+ * copies or substantial portions of the Software.
28
+ *
29
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
31
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
32
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
34
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
35
+ * SOFTWARE.
36
+ */
13
37
 
38
+ var CHARTS_PACKAGE = "@react-fabric/charts";
39
+ var CHARTS_VERSION = "1.0.0";
14
40
 
15
41
  exports.ActivityMap = ActivityMap.ActivityMap;
16
42
  exports.CountSeries = CountSeries.CountSeries;
@@ -21,3 +47,5 @@ exports.TimeSeries = TimeSeries.TimeSeries;
21
47
  exports.TimeSlider = TimeSlider.TimeSlider;
22
48
  exports.WordBubble = WordBubble.WordBubble;
23
49
  exports.registerTheme = charts.registerTheme;
50
+ exports.CHARTS_PACKAGE = CHARTS_PACKAGE;
51
+ exports.CHARTS_VERSION = CHARTS_VERSION;
@@ -197,7 +197,7 @@ var DarkThemeBase = {
197
197
  splitLine: {
198
198
  show: true,
199
199
  lineStyle: {
200
- color: ["#444"]
200
+ color: ["#363636"]
201
201
  }
202
202
  },
203
203
  splitArea: {
@@ -231,7 +231,7 @@ var DarkThemeBase = {
231
231
  splitLine: {
232
232
  show: true,
233
233
  lineStyle: {
234
- color: ["#444"]
234
+ color: ["#363636"]
235
235
  }
236
236
  },
237
237
  splitArea: {
@@ -265,7 +265,7 @@ var DarkThemeBase = {
265
265
  splitLine: {
266
266
  show: true,
267
267
  lineStyle: {
268
- color: ["#444"]
268
+ color: ["#363636"]
269
269
  }
270
270
  },
271
271
  splitArea: {
@@ -299,7 +299,7 @@ var DarkThemeBase = {
299
299
  splitLine: {
300
300
  show: true,
301
301
  lineStyle: {
302
- color: ["#444"]
302
+ color: ["#363636"]
303
303
  }
304
304
  },
305
305
  splitArea: {
@@ -309,11 +309,6 @@ var DarkThemeBase = {
309
309
  }
310
310
  }
311
311
  },
312
- visualMap: {
313
- textStyle: {
314
- color: "#eee"
315
- }
316
- },
317
312
  toolbox: {
318
313
  iconStyle: {
319
314
  borderColor: "#999999"
@@ -326,9 +321,17 @@ var DarkThemeBase = {
326
321
  },
327
322
  legend: {
328
323
  inactiveColor: "rgb(192 192 192 / .75)",
324
+ itemHeight: 8,
329
325
  textStyle: {
326
+ fontSize: 10,
330
327
  color: "#5d6d7d6"
331
- }
328
+ },
329
+ pageTextStyle: {
330
+ fontSize: 8
331
+ },
332
+ pageIconSize: 8,
333
+ pageIconColor: "#6997A3",
334
+ pageIconInactiveColor: "#474B4A"
332
335
  },
333
336
  tooltip: {
334
337
  backgroundColor: "#0C141D",