visualifyjs 2.5.3-2.dev → 3.0.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 (252) hide show
  1. package/.claude/mem/TIMELINE.md +36 -0
  2. package/.claude/mem/notes/2026-02-11-3d-visualization-docs-fix-external-script-solution.md +24 -0
  3. package/.claude/mem/notes/2026-02-11-3d-visualization-docs-fix-session-summary.md +43 -0
  4. package/.claude/mem/notes/2026-02-11-cli-fix-editor-command-alias.md +26 -0
  5. package/.claude/mem/notes/2026-02-11-phase-3-developer-experience-completed.md +51 -0
  6. package/.claude/mem/notes/2026-02-11-phase-4-web-workers-implementation-complete.md +59 -0
  7. package/.claude/mem/notes/2026-02-11-visualify-phase-2-3d-visualization-complete.md +50 -0
  8. package/.claude/mem/notes/2026-02-11-visualify-phase-2-committed-ready-for-phase-3.md +33 -0
  9. package/.claude/mem/notes/2026-02-11-visualify-phase-3-complete-developer-experience.md +52 -0
  10. package/.claude/mem/notes/2026-02-11-visualify-repository-cleanup-complete.md +28 -0
  11. package/.claude/mem/notes/2026-02-18-codebase-cleanup-docsify-plugin-documentation.md +37 -0
  12. package/.claude/mem/notes/2026-02-19-css-grid-layout-fix-displaycontents-on-vcontroller.md +18 -0
  13. package/.claude/mem/notes/2026-02-19-docsify-plugin-fixes-latex-and-visualify-code-bloc.md +26 -0
  14. package/.claude/mem/notes/2026-02-19-page-mode-docs-update-decisions.md +23 -0
  15. package/.claude/mem/notes/2026-02-19-react-context-infinite-re-render-loop-fix-pattern.md +31 -0
  16. package/.claude/mem/notes/2026-02-19-version-300-bump-and-build-fixes.md +32 -0
  17. package/.claude/mem/notes/2026-02-19-visualify-build-deployment-architecture-bug-fixes.md +25 -0
  18. package/.claude/mem/notes/2026-02-19-visualify-dist-iife-self-contained-build-config.md +30 -0
  19. package/.claude/mem/notes/2026-02-19-visualify-infinite-loop-i18n-fixes.md +31 -0
  20. package/.claude/mem/notes/2026-02-19-visualify-v3-bundle-splitting-docs-restructuring.md +32 -0
  21. package/.claude/mem/notes/2026-02-20-bundle-externalization-final-architecture.md +29 -0
  22. package/.claude/mem/notes/2026-02-20-chromium-page-fix-unstable-keys-and-double-event-b.md +27 -0
  23. package/.claude/mem/notes/2026-02-20-console-cleanup-bundle-optimization-commit.md +20 -0
  24. package/.claude/mem/notes/2026-02-20-dotbio-dot-plot-fix-useeffect-dependency.md +21 -0
  25. package/.claude/mem/notes/2026-02-20-public-folder-cleanup-and-readme-rewrite.md +25 -0
  26. package/.claude/mem/notes/2026-02-20-v300-release-and-beta-channel-strategy.md +29 -0
  27. package/.claude/mem/notes/2026-02-20-visium-background-image-unknown-legend-fix.md +19 -0
  28. package/.claude/mem/notes/2026-02-20-visualify-cdn-loader-bundle-externalization.md +34 -0
  29. package/.claude/mem/sessions/session-2026-02-20-031524.md +54 -0
  30. package/.claude/settings.local.json +21 -0
  31. package/.github/workflows/static.yml.bak +51 -51
  32. package/.sisyphus/boulder.json +65 -0
  33. package/.sisyphus/plans/phase-4-advanced-optimizations.md +217 -0
  34. package/LICENSE +674 -674
  35. package/README.md +94 -59
  36. package/config-overrides.js +31 -31
  37. package/dist/stats.html +4949 -0
  38. package/dist/visualify-3d.esm.js +1 -0
  39. package/dist/visualify-3d.js +1 -0
  40. package/dist/visualify-core.esm.js +1 -0
  41. package/dist/visualify-core.js +1 -0
  42. package/dist/visualify-docs.esm.js +1 -0
  43. package/dist/visualify-docs.js +1 -0
  44. package/dist/visualify-loader.js +1 -0
  45. package/dist/visualify-pages.esm.js +1 -0
  46. package/dist/visualify-pages.js +1 -0
  47. package/dist/visualify-portal.esm.js +1 -0
  48. package/dist/visualify-portal.js +1 -0
  49. package/dist/visualify-shared.js +26571 -0
  50. package/dist/visualify.js +1 -188
  51. package/docs/CHANGELOG.md +148 -0
  52. package/docs/cli/commands.md +513 -0
  53. package/docs/configuration/visualify-json.md +474 -0
  54. package/docs/docs/3d-visualization.md +374 -0
  55. package/docs/docs/CLI.md +303 -34
  56. package/docs/docs/README.md +65 -65
  57. package/docs/docs/Rechart/bar.md +190 -190
  58. package/docs/docs/Rechart/funnel.md +241 -241
  59. package/docs/docs/Rechart/line.md +355 -355
  60. package/docs/docs/Rechart/pie.md +225 -225
  61. package/docs/docs/Rechart/radar.md +253 -253
  62. package/docs/docs/Rechart/scatter.md +298 -298
  63. package/docs/docs/_404.md +51 -51
  64. package/docs/docs/_coverpage.md +11 -11
  65. package/docs/docs/_sidebar.md +54 -44
  66. package/docs/docs/components/dotBio.md +87 -34
  67. package/docs/docs/components/echart.md +171 -82
  68. package/docs/docs/components/html.md +61 -34
  69. package/docs/docs/components/macaron.md +156 -145
  70. package/docs/docs/components/markdown.md +42 -0
  71. package/docs/docs/components/more.md +183 -142
  72. package/docs/docs/components/plotly.md +132 -62
  73. package/docs/docs/components/scatterL.md +171 -70
  74. package/docs/docs/components/visium.md +112 -57
  75. package/docs/docs/configuration.md +121 -121
  76. package/docs/docs/deploy.md +31 -31
  77. package/docs/docs/docsify-plugin.md +655 -0
  78. package/docs/docs/hmr.md +165 -0
  79. package/docs/docs/i18n.md +332 -0
  80. package/docs/docs/log.md +30 -9
  81. package/docs/docs/more-pages.md +23 -23
  82. package/docs/docs/quickstart.md +148 -124
  83. package/docs/docs/rechart-attributes.md +74 -74
  84. package/docs/docs/rechart-basic-usage.md +160 -162
  85. package/docs/docs/theme.md +5 -5
  86. package/docs/docs/typescript.md +306 -0
  87. package/docs/docs/visual-editor.md +359 -0
  88. package/docs/index.html +85 -71
  89. package/docs/manifest.json +23 -23
  90. package/docs/migration/v3-migration.md +392 -0
  91. package/docs/static/css/fluff-stuff.css +169 -169
  92. package/docs/static/css/font-awesome.min.css +4 -4
  93. package/docs/static/css/visualify.css +6 -25
  94. package/docs/static/js/3d-viz-examples.js +181 -0
  95. package/docs/static/js/configuration.js +630 -448
  96. package/docs/static/js/visualify.js +1 -188
  97. package/package.json +106 -84
  98. package/rollup.config.mjs +766 -76
  99. package/src/_css/404.css +115 -115
  100. package/src/_css/App.css +37 -37
  101. package/src/_css/autoSuggestion.css +26 -26
  102. package/src/_css/circular-progress.css +32 -32
  103. package/src/_css/index.css +36 -36
  104. package/src/_css/modern.css +350 -25
  105. package/src/_media/corner.svg +8 -8
  106. package/src/_media/download.svg +3 -3
  107. package/src/_media/logo.svg +14 -14
  108. package/src/_test/App.test.js +15 -15
  109. package/src/_utils/reportWebVitals.js +13 -13
  110. package/src/a11y/README.md +177 -0
  111. package/src/a11y/aria-labels.js +339 -0
  112. package/src/a11y/color-contrast.js +535 -0
  113. package/src/a11y/index.js +197 -0
  114. package/src/a11y/keyboard-nav.js +523 -0
  115. package/src/a11y/styles.css +165 -0
  116. package/src/cli/commands/dev.js +214 -0
  117. package/src/cli/commands/docs.js +521 -0
  118. package/src/cli/commands/edit.js +379 -0
  119. package/src/cli/commands/init.js +213 -0
  120. package/src/cli/commands/portal.js +236 -0
  121. package/src/cli/dev-server.js +530 -0
  122. package/src/cli/hmr.js +456 -0
  123. package/src/cli/index.js +180 -0
  124. package/src/cli/utils/config.js +207 -0
  125. package/src/cli/utils/logger.js +241 -0
  126. package/src/config/defaults.ts +122 -0
  127. package/src/config/index.ts +72 -0
  128. package/src/config/loader.ts +478 -0
  129. package/src/config/schema.ts +227 -0
  130. package/src/config/validator.ts +337 -0
  131. package/src/core/appContext.js +34 -27
  132. package/src/core/components/Bar.js +383 -0
  133. package/src/core/components/Bar3D.js +473 -0
  134. package/src/core/components/LargeDatasetChart.js +296 -0
  135. package/src/core/components/Line3D.js +310 -0
  136. package/src/core/components/Scatter.js +392 -188
  137. package/src/core/components/Scatter3D.js +455 -0
  138. package/src/core/components/ScatterBio.js +601 -572
  139. package/src/core/components/Surface3D.js +326 -0
  140. package/src/core/components/ThreeCustom.js +648 -0
  141. package/src/core/components/ThreeScene.js +459 -0
  142. package/src/core/components/VisiumPlot.js +191 -165
  143. package/src/core/components/browser.js +42 -42
  144. package/src/core/components/dotplot.js +413 -413
  145. package/src/core/components/html.js +29 -29
  146. package/src/core/components/list.js +178 -178
  147. package/src/core/components/macaron.js +206 -201
  148. package/src/core/components/markdown.js +56 -56
  149. package/src/core/components/parser.scatterBio.js +582 -587
  150. package/src/core/components/ratio.js +82 -80
  151. package/src/core/components/scatterL.js +206 -173
  152. package/src/core/components/searchbar.js +156 -131
  153. package/src/core/components/selection.js +310 -193
  154. package/src/core/components/timeline.js +236 -281
  155. package/src/core/components/visium.js +114 -97
  156. package/src/core/data-processor.js +413 -0
  157. package/src/core/fetch/condfetch.js +82 -82
  158. package/src/core/fetch/fetch.js +92 -92
  159. package/src/core/fetch/json.js +29 -29
  160. package/src/core/fetch/vfetch.js +42 -42
  161. package/src/core/hmr-client.js +724 -0
  162. package/src/core/liveEditor.js +44 -44
  163. package/src/core/modules/codeEditorWithPreview.js +104 -104
  164. package/src/core/modules/echarts/common.js +20 -20
  165. package/src/core/modules/echarts/gl.js +228 -0
  166. package/src/core/modules/echarts/presetHandler.js +41 -41
  167. package/src/core/modules/echarts/presets/esodev.chromium.js +172 -172
  168. package/src/core/modules/echarts/presets/esodev.codex.js +130 -130
  169. package/src/core/modules/echarts/presets/esodev.visium.js +123 -123
  170. package/src/core/modules/echarts/presets/mmtrbc.js +186 -186
  171. package/src/core/modules/echarts.js +70 -71
  172. package/src/core/modules/echartsUtils.js +43 -43
  173. package/src/core/modules/echartswitcher.js +227 -152
  174. package/src/core/modules/replotly/presetHandler.js +24 -24
  175. package/src/core/modules/replotly/presets/minimum.js +18 -18
  176. package/src/core/modules/replotly/presets/mmtrbc.dot.js +114 -114
  177. package/src/core/modules/replotly/presets/mmtrbc.violin.js +100 -100
  178. package/src/core/modules/replotly.js +74 -71
  179. package/src/core/modules/threejs/Camera.js +373 -0
  180. package/src/core/modules/threejs/Lighting.js +459 -0
  181. package/src/core/modules/threejs/Renderer.js +364 -0
  182. package/src/core/modules/threejs/Scene.js +266 -0
  183. package/src/core/modules/threejs/index.js +155 -0
  184. package/src/core/pages/404.js +50 -50
  185. package/src/core/pages/error.js +27 -27
  186. package/src/core/pages/jsonPage.js +62 -62
  187. package/src/core/pages/loading.js +44 -44
  188. package/src/core/parser/echart.data.js +204 -183
  189. package/src/core/parser/echart.features.js +125 -125
  190. package/src/core/parser/echart.general.js +147 -147
  191. package/src/core/parser/echart.hilbert.js +57 -57
  192. package/src/core/parser/echart.parser.js +210 -210
  193. package/src/core/parser/echart.series.js +67 -67
  194. package/src/core/parser/echart.types.js +76 -76
  195. package/src/core/parser/plotly.config.js +10 -10
  196. package/src/core/parser/plotly.data.js +132 -132
  197. package/src/core/parser/plotly.layout.js +9 -9
  198. package/src/core/parser/plotly.violin.js +18 -18
  199. package/src/core/recharts.js +361 -62
  200. package/src/core/router/alias.js +49 -49
  201. package/src/core/router/jsonRouter.js +31 -31
  202. package/src/core/themes/modern.js +32 -32
  203. package/src/core/themes/themeSelector.js +33 -33
  204. package/src/core/visualify.js +213 -47
  205. package/src/core/widgets/circularProgress.js +23 -23
  206. package/src/core/widgets/controller.js +116 -83
  207. package/src/core/widgets/errorBoundary.js +36 -36
  208. package/src/core/widgets/footer.js +185 -177
  209. package/src/core/widgets/header.js +238 -234
  210. package/src/core/widgets/layout/Grid.js +31 -31
  211. package/src/core/widgets/layout.js +36 -36
  212. package/src/core/widgets/mapping.js +56 -42
  213. package/src/core/workers/data-worker.js +349 -0
  214. package/src/core/workers/worker-pool.js +396 -0
  215. package/src/docsify/bundle.js +215 -0
  216. package/src/docsify/markdown.js +271 -0
  217. package/src/docsify/plugin.js +268 -0
  218. package/src/editor/README.md +172 -0
  219. package/src/editor/components/ChartBuilder.jsx +341 -0
  220. package/src/editor/components/ChartTypeSidebar.jsx +91 -0
  221. package/src/editor/components/Editor.jsx +367 -0
  222. package/src/editor/components/Preview.jsx +446 -0
  223. package/src/editor/components/PropertyPanel.jsx +468 -0
  224. package/src/editor/components/StatusBar.jsx +85 -0
  225. package/src/editor/context/EditorContext.js +248 -0
  226. package/src/editor/hooks/useDebounce.js +32 -0
  227. package/src/editor/index.js +315 -0
  228. package/src/editor/styles/editor.css +637 -0
  229. package/src/editor/utils/chartValidator.js +263 -0
  230. package/src/entries/charts3d.js +70 -0
  231. package/src/entries/core.js +78 -0
  232. package/src/entries/docs.js +154 -0
  233. package/src/entries/pages.js +93 -0
  234. package/src/entries/portal.js +204 -0
  235. package/src/entries/shared.js +50 -0
  236. package/src/i18n/formatters.js +455 -0
  237. package/src/i18n/index.js +169 -0
  238. package/src/i18n/locales/ar.json +137 -0
  239. package/src/i18n/locales/de.json +137 -0
  240. package/src/i18n/locales/en.json +137 -0
  241. package/src/i18n/locales/es.json +137 -0
  242. package/src/i18n/locales/he.json +137 -0
  243. package/src/i18n/locales/zh.json +137 -0
  244. package/src/i18n/rtl.css +183 -0
  245. package/src/index.js +82 -62
  246. package/src/loader.js +103 -0
  247. package/src/setupTests.js +5 -5
  248. package/tsconfig.json +51 -0
  249. package/types/charts.d.ts +569 -0
  250. package/types/components.d.ts +441 -0
  251. package/types/config.d.ts +199 -0
  252. package/types/index.d.ts +353 -0
@@ -0,0 +1,446 @@
1
+ /**
2
+ * @fileoverview Preview Component - Live chart rendering
3
+ * @module editor/components/Preview
4
+ *
5
+ * Provides real-time chart preview with error handling and fullscreen mode.
6
+ */
7
+
8
+ import React, { useState, useEffect, useCallback, useMemo } from 'react';
9
+ import {
10
+ ArrowsFullscreen,
11
+ FullscreenExit,
12
+ ExclamationTriangle,
13
+ RefreshCw,
14
+ } from 'react-bootstrap-icons';
15
+ import { Button, Alert, Spinner } from 'react-bootstrap';
16
+ import ReactECharts from 'echarts-for-react';
17
+ import * as echarts from 'echarts';
18
+
19
+ /**
20
+ * Validate chart configuration
21
+ */
22
+ function validateChartConfig(chart) {
23
+ const errors = [];
24
+
25
+ if (!chart.type) {
26
+ errors.push('Chart type is required');
27
+ }
28
+
29
+ if (!chart.data || !Array.isArray(chart.data)) {
30
+ errors.push('Chart data must be an array');
31
+ }
32
+
33
+ return errors;
34
+ }
35
+
36
+ /**
37
+ * Transform chart config to ECharts options
38
+ */
39
+ function transformToEChartsOptions(chart) {
40
+ const baseOption = {
41
+ title: {
42
+ text: chart.title || '',
43
+ left: 'center',
44
+ },
45
+ tooltip: {
46
+ trigger: chart.type === 'pie' || chart.type === 'radar' ? 'item' : 'axis',
47
+ },
48
+ legend: {
49
+ top: 30,
50
+ },
51
+ series: [],
52
+ };
53
+
54
+ const is3D = chart.type.includes('3d');
55
+
56
+ // Handle different chart types
57
+ switch (chart.type) {
58
+ case 'scatter':
59
+ return {
60
+ ...baseOption,
61
+ xAxis: {
62
+ type: chart.options?.xAxis?.type || 'value',
63
+ name: chart.options?.xAxis?.name,
64
+ },
65
+ yAxis: {
66
+ type: chart.options?.yAxis?.type || 'value',
67
+ name: chart.options?.yAxis?.name,
68
+ },
69
+ series: [
70
+ {
71
+ type: 'scatter',
72
+ data: chart.data.map((d) => [d.x, d.y]),
73
+ symbolSize: chart.series?.symbolSize || 10,
74
+ symbol: chart.series?.symbol || 'circle',
75
+ },
76
+ ],
77
+ };
78
+
79
+ case 'scatter3d':
80
+ return {
81
+ ...baseOption,
82
+ xAxis3D: {
83
+ type: 'value',
84
+ name: chart.options?.xAxis3D?.name || 'X',
85
+ },
86
+ yAxis3D: {
87
+ type: 'value',
88
+ name: chart.options?.yAxis3D?.name || 'Y',
89
+ },
90
+ zAxis3D: {
91
+ type: 'value',
92
+ name: chart.options?.zAxis3D?.name || 'Z',
93
+ },
94
+ grid3D: {},
95
+ series: [
96
+ {
97
+ type: 'scatter3D',
98
+ data: chart.data.map((d) => [d.x, d.y, d.z]),
99
+ symbolSize: chart.series?.symbolSize || 10,
100
+ },
101
+ ],
102
+ };
103
+
104
+ case 'bar':
105
+ return {
106
+ ...baseOption,
107
+ xAxis: {
108
+ type: chart.options?.xAxis?.type || 'category',
109
+ data: chart.data.map((d) => d.category),
110
+ },
111
+ yAxis: {
112
+ type: chart.options?.yAxis?.type || 'value',
113
+ },
114
+ series: [
115
+ {
116
+ type: 'bar',
117
+ data: chart.data.map((d) => d.value),
118
+ stack: chart.series?.stack,
119
+ },
120
+ ],
121
+ };
122
+
123
+ case 'bar3d':
124
+ return {
125
+ ...baseOption,
126
+ xAxis3D: { type: 'category' },
127
+ yAxis3D: { type: 'category' },
128
+ zAxis3D: { type: 'value' },
129
+ grid3D: {},
130
+ series: [
131
+ {
132
+ type: 'bar3D',
133
+ data: chart.data.map((d, i) => [i, 0, d.value]),
134
+ shading: 'lambert',
135
+ },
136
+ ],
137
+ };
138
+
139
+ case 'line':
140
+ return {
141
+ ...baseOption,
142
+ xAxis: {
143
+ type: chart.options?.xAxis?.type || 'category',
144
+ data: chart.data.map((d) => d.x),
145
+ },
146
+ yAxis: {
147
+ type: chart.options?.yAxis?.type || 'value',
148
+ },
149
+ series: [
150
+ {
151
+ type: 'line',
152
+ data: chart.data.map((d) => d.y),
153
+ smooth: chart.series?.smooth || false,
154
+ areaStyle: chart.series?.areaStyle,
155
+ },
156
+ ],
157
+ };
158
+
159
+ case 'line3d':
160
+ return {
161
+ ...baseOption,
162
+ xAxis3D: { type: 'value' },
163
+ yAxis3D: { type: 'value' },
164
+ zAxis3D: { type: 'value' },
165
+ grid3D: {},
166
+ series: [
167
+ {
168
+ type: 'line3D',
169
+ data: chart.data.map((d) => [d.x, d.y, d.z || 0]),
170
+ },
171
+ ],
172
+ };
173
+
174
+ case 'pie':
175
+ return {
176
+ ...baseOption,
177
+ series: [
178
+ {
179
+ type: 'pie',
180
+ radius: chart.series?.radius || ['0%', '70%'],
181
+ data: chart.data.map((d) => ({
182
+ name: d.name,
183
+ value: d.value,
184
+ })),
185
+ emphasis: {
186
+ itemStyle: {
187
+ shadowBlur: 10,
188
+ shadowOffsetX: 0,
189
+ shadowColor: 'rgba(0, 0, 0, 0.5)',
190
+ },
191
+ },
192
+ },
193
+ ],
194
+ };
195
+
196
+ case 'radar':
197
+ return {
198
+ ...baseOption,
199
+ radar: {
200
+ indicator: chart.options?.radar?.indicator || [],
201
+ },
202
+ series: [
203
+ {
204
+ type: 'radar',
205
+ data: chart.data.map((d) => ({
206
+ name: d.name,
207
+ value: d.value,
208
+ })),
209
+ },
210
+ ],
211
+ };
212
+
213
+ case 'funnel':
214
+ return {
215
+ ...baseOption,
216
+ series: [
217
+ {
218
+ type: 'funnel',
219
+ data: chart.data.map((d) => ({
220
+ name: d.name,
221
+ value: d.value,
222
+ })),
223
+ sort: 'descending',
224
+ },
225
+ ],
226
+ };
227
+
228
+ case 'heatmap':
229
+ return {
230
+ ...baseOption,
231
+ xAxis: { type: 'category' },
232
+ yAxis: { type: 'category' },
233
+ visualMap: {
234
+ min: chart.options?.visualMap?.min || 0,
235
+ max: chart.options?.visualMap?.max || 100,
236
+ },
237
+ series: [
238
+ {
239
+ type: 'heatmap',
240
+ data: chart.data,
241
+ label: { show: true },
242
+ },
243
+ ],
244
+ };
245
+
246
+ case 'boxplot':
247
+ return {
248
+ ...baseOption,
249
+ xAxis: { type: 'category' },
250
+ yAxis: { type: 'value' },
251
+ series: [
252
+ {
253
+ type: 'boxplot',
254
+ data: chart.data,
255
+ },
256
+ ],
257
+ };
258
+
259
+ case 'surface3d':
260
+ return {
261
+ ...baseOption,
262
+ xAxis3D: { type: 'value' },
263
+ yAxis3D: { type: 'value' },
264
+ zAxis3D: { type: 'value' },
265
+ grid3D: {
266
+ viewControl: {
267
+ autoRotate: true,
268
+ },
269
+ },
270
+ series: [
271
+ {
272
+ type: 'surface',
273
+ wireframe: { show: false },
274
+ shading: 'color',
275
+ },
276
+ ],
277
+ };
278
+
279
+ default:
280
+ return baseOption;
281
+ }
282
+ }
283
+
284
+ /**
285
+ * Single Chart Preview Component
286
+ */
287
+ function ChartPreview({ chart, height = '300px' }) {
288
+ const [error, setError] = useState(null);
289
+ const [loading, setLoading] = useState(true);
290
+
291
+ const chartOption = useMemo(() => {
292
+ try {
293
+ const errors = validateChartConfig(chart);
294
+ if (errors.length > 0) {
295
+ throw new Error(errors.join(', '));
296
+ }
297
+ return transformToEChartsOptions(chart);
298
+ } catch (err) {
299
+ setError(err.message);
300
+ return null;
301
+ }
302
+ }, [chart]);
303
+
304
+ useEffect(() => {
305
+ if (chartOption) {
306
+ setError(null);
307
+ setLoading(false);
308
+ }
309
+ }, [chartOption]);
310
+
311
+ if (error) {
312
+ return (
313
+ <Alert variant="danger" className="m-3">
314
+ <ExclamationTriangle className="me-2" />
315
+ <strong>Chart Error</strong>
316
+ <hr />
317
+ <pre className="mb-0 small">{error}</pre>
318
+ </Alert>
319
+ );
320
+ }
321
+
322
+ if (loading || !chartOption) {
323
+ return (
324
+ <div
325
+ className="d-flex align-items-center justify-content-center"
326
+ style={{ height }}
327
+ >
328
+ <Spinner animation="border" variant="primary" />
329
+ </div>
330
+ );
331
+ }
332
+
333
+ return (
334
+ <ReactECharts
335
+ option={chartOption}
336
+ style={{ height, width: '100%' }}
337
+ opts={{ renderer: chart.type.includes('3d') ? 'webgl' : 'canvas' }}
338
+ onChartReady={() => setLoading(false)}
339
+ />
340
+ );
341
+ }
342
+
343
+ /**
344
+ * Preview Component
345
+ */
346
+ function Preview({ config, fullscreen = false }) {
347
+ const [isFullscreen, setIsFullscreen] = useState(fullscreen);
348
+ const [refreshKey, setRefreshKey] = useState(0);
349
+
350
+ const toggleFullscreen = useCallback(() => {
351
+ setIsFullscreen((prev) => !prev);
352
+ }, []);
353
+
354
+ const handleRefresh = useCallback(() => {
355
+ setRefreshKey((prev) => prev + 1);
356
+ }, []);
357
+
358
+ const validCharts = config.charts.filter((chart) => {
359
+ const errors = validateChartConfig(chart);
360
+ return errors.length === 0;
361
+ });
362
+
363
+ const hasErrors = validCharts.length !== config.charts.length;
364
+
365
+ return (
366
+ <div
367
+ className={`preview-container ${isFullscreen ? 'vh-100' : ''}`}
368
+ key={refreshKey}
369
+ >
370
+ <div className="preview-header">
371
+ <div className="d-flex align-items-center">
372
+ <span className="preview-title">Live Preview</span>
373
+ {hasErrors && (
374
+ <span className="badge bg-warning text-dark ms-2">
375
+ <ExclamationTriangle className="me-1" size={12} />
376
+ Some charts have errors
377
+ </span>
378
+ )}
379
+ </div>
380
+ <div className="preview-actions">
381
+ <Button
382
+ variant="outline-secondary"
383
+ size="sm"
384
+ onClick={handleRefresh}
385
+ title="Refresh"
386
+ >
387
+ <RefreshCw size={16} />
388
+ </Button>
389
+ <Button
390
+ variant="outline-secondary"
391
+ size="sm"
392
+ onClick={toggleFullscreen}
393
+ title={isFullscreen ? 'Exit Fullscreen' : 'Fullscreen'}
394
+ >
395
+ {isFullscreen ? (
396
+ <FullscreenExit size={16} />
397
+ ) : (
398
+ <ArrowsFullscreen size={16} />
399
+ )}
400
+ </Button>
401
+ </div>
402
+ </div>
403
+
404
+ <div
405
+ className="preview-content"
406
+ style={{
407
+ maxHeight: isFullscreen ? 'calc(100vh - 60px)' : '600px',
408
+ overflow: 'auto',
409
+ }}
410
+ >
411
+ {config.charts.length === 0 ? (
412
+ <Alert variant="info">
413
+ No charts to preview. Add charts from the sidebar.
414
+ </Alert>
415
+ ) : (
416
+ <div className="row g-3">
417
+ {config.charts.map((chart) => (
418
+ <div
419
+ key={chart.id}
420
+ className={`col-${isFullscreen ? '6' : '12'}`}
421
+ >
422
+ <div className="card">
423
+ <div className="card-header d-flex justify-content-between align-items-center">
424
+ <span>{chart.title}</span>
425
+ <span className="badge bg-secondary">
426
+ {chart.type}
427
+ </span>
428
+ </div>
429
+ <div className="card-body p-0">
430
+ <ChartPreview
431
+ chart={chart}
432
+ height={isFullscreen ? '400px' : '300px'}
433
+ />
434
+ </div>
435
+ </div>
436
+ </div>
437
+ ))}
438
+ </div>
439
+ )
440
+ )}
441
+ </div>
442
+ </div>
443
+ );
444
+ }
445
+
446
+ export default Preview;