@databricks/appkit-ui 0.2.0 → 0.4.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 (489) hide show
  1. package/CLAUDE.md +121 -1228
  2. package/NOTICE.md +1 -1
  3. package/bin/appkit.js +3 -0
  4. package/dist/cli/commands/docs.js +47 -0
  5. package/dist/cli/commands/docs.js.map +1 -0
  6. package/dist/cli/commands/generate-types.js +38 -0
  7. package/dist/cli/commands/generate-types.js.map +1 -0
  8. package/dist/cli/commands/lint.js +104 -0
  9. package/dist/cli/commands/lint.js.map +1 -0
  10. package/dist/cli/commands/setup.js +121 -0
  11. package/dist/cli/commands/setup.js.map +1 -0
  12. package/dist/cli/index.d.ts +1 -0
  13. package/dist/cli/index.js +24 -0
  14. package/dist/cli/index.js.map +1 -0
  15. package/dist/js/arrow/arrow-client.d.ts +48 -0
  16. package/dist/js/arrow/arrow-client.d.ts.map +1 -1
  17. package/dist/js/arrow/arrow-client.js +51 -3
  18. package/dist/js/arrow/arrow-client.js.map +1 -1
  19. package/dist/react/charts/area/index.d.ts +6 -17
  20. package/dist/react/charts/area/index.d.ts.map +1 -1
  21. package/dist/react/charts/area/index.js +5 -17
  22. package/dist/react/charts/area/index.js.map +1 -1
  23. package/dist/react/charts/bar/index.d.ts +5 -26
  24. package/dist/react/charts/bar/index.d.ts.map +1 -1
  25. package/dist/react/charts/bar/index.js +4 -26
  26. package/dist/react/charts/bar/index.js.map +1 -1
  27. package/dist/react/charts/create-chart.js +1 -2
  28. package/dist/react/charts/create-chart.js.map +1 -1
  29. package/dist/react/charts/heatmap/index.d.ts +7 -22
  30. package/dist/react/charts/heatmap/index.d.ts.map +1 -1
  31. package/dist/react/charts/heatmap/index.js +6 -22
  32. package/dist/react/charts/heatmap/index.js.map +1 -1
  33. package/dist/react/charts/line/index.d.ts +6 -18
  34. package/dist/react/charts/line/index.d.ts.map +1 -1
  35. package/dist/react/charts/line/index.js +5 -18
  36. package/dist/react/charts/line/index.js.map +1 -1
  37. package/dist/react/charts/normalize.js +16 -16
  38. package/dist/react/charts/normalize.js.map +1 -1
  39. package/dist/react/charts/pie/index.d.ts +10 -32
  40. package/dist/react/charts/pie/index.d.ts.map +1 -1
  41. package/dist/react/charts/pie/index.js +9 -32
  42. package/dist/react/charts/pie/index.js.map +1 -1
  43. package/dist/react/charts/radar/index.d.ts +6 -16
  44. package/dist/react/charts/radar/index.d.ts.map +1 -1
  45. package/dist/react/charts/radar/index.js +5 -16
  46. package/dist/react/charts/radar/index.js.map +1 -1
  47. package/dist/react/charts/scatter/index.d.ts +6 -16
  48. package/dist/react/charts/scatter/index.d.ts.map +1 -1
  49. package/dist/react/charts/scatter/index.js +5 -16
  50. package/dist/react/charts/scatter/index.js.map +1 -1
  51. package/dist/react/charts/types.d.ts +0 -5
  52. package/dist/react/charts/types.d.ts.map +1 -1
  53. package/dist/react/charts/types.js.map +1 -1
  54. package/dist/react/charts/wrapper.d.ts +0 -2
  55. package/dist/react/charts/wrapper.d.ts.map +1 -1
  56. package/dist/react/charts/wrapper.js +2 -4
  57. package/dist/react/charts/wrapper.js.map +1 -1
  58. package/dist/react/hooks/types.d.ts +0 -2
  59. package/dist/react/hooks/types.d.ts.map +1 -1
  60. package/dist/react/hooks/use-analytics-query.d.ts +4 -0
  61. package/dist/react/hooks/use-analytics-query.d.ts.map +1 -1
  62. package/dist/react/hooks/use-analytics-query.js +17 -14
  63. package/dist/react/hooks/use-analytics-query.js.map +1 -1
  64. package/dist/react/hooks/use-chart-data.d.ts +0 -2
  65. package/dist/react/hooks/use-chart-data.d.ts.map +1 -1
  66. package/dist/react/hooks/use-chart-data.js +2 -3
  67. package/dist/react/hooks/use-chart-data.js.map +1 -1
  68. package/dist/react/table/data-table.d.ts +4 -1
  69. package/dist/react/table/data-table.d.ts.map +1 -1
  70. package/dist/react/table/data-table.js +4 -1
  71. package/dist/react/table/data-table.js.map +1 -1
  72. package/dist/react/table/table-wrapper.js +5 -6
  73. package/dist/react/table/table-wrapper.js.map +1 -1
  74. package/dist/react/table/types.d.ts.map +1 -1
  75. package/dist/react/ui/accordion.d.ts +9 -5
  76. package/dist/react/ui/accordion.d.ts.map +1 -1
  77. package/dist/react/ui/accordion.js +4 -0
  78. package/dist/react/ui/accordion.js.map +1 -1
  79. package/dist/react/ui/alert-dialog.d.ts +23 -12
  80. package/dist/react/ui/alert-dialog.d.ts.map +1 -1
  81. package/dist/react/ui/alert-dialog.js +11 -0
  82. package/dist/react/ui/alert-dialog.js.map +1 -1
  83. package/dist/react/ui/alert.d.ts +7 -4
  84. package/dist/react/ui/alert.d.ts.map +1 -1
  85. package/dist/react/ui/alert.js +3 -0
  86. package/dist/react/ui/alert.js.map +1 -1
  87. package/dist/react/ui/aspect-ratio.d.ts +3 -2
  88. package/dist/react/ui/aspect-ratio.d.ts.map +1 -1
  89. package/dist/react/ui/aspect-ratio.js +1 -0
  90. package/dist/react/ui/aspect-ratio.js.map +1 -1
  91. package/dist/react/ui/avatar.d.ts +7 -4
  92. package/dist/react/ui/avatar.d.ts.map +1 -1
  93. package/dist/react/ui/avatar.js +3 -0
  94. package/dist/react/ui/avatar.js.map +1 -1
  95. package/dist/react/ui/badge.d.ts +5 -4
  96. package/dist/react/ui/badge.d.ts.map +1 -1
  97. package/dist/react/ui/badge.js +1 -0
  98. package/dist/react/ui/badge.js.map +1 -1
  99. package/dist/react/ui/breadcrumb.d.ts +15 -8
  100. package/dist/react/ui/breadcrumb.d.ts.map +1 -1
  101. package/dist/react/ui/breadcrumb.js +7 -0
  102. package/dist/react/ui/breadcrumb.js.map +1 -1
  103. package/dist/react/ui/button-group.d.ts +9 -6
  104. package/dist/react/ui/button-group.d.ts.map +1 -1
  105. package/dist/react/ui/button-group.js +3 -0
  106. package/dist/react/ui/button-group.js.map +1 -1
  107. package/dist/react/ui/button.d.ts +5 -4
  108. package/dist/react/ui/button.d.ts.map +1 -1
  109. package/dist/react/ui/button.js +1 -0
  110. package/dist/react/ui/button.js.map +1 -1
  111. package/dist/react/ui/calendar.d.ts +5 -3
  112. package/dist/react/ui/calendar.d.ts.map +1 -1
  113. package/dist/react/ui/calendar.js +14 -12
  114. package/dist/react/ui/calendar.js.map +1 -1
  115. package/dist/react/ui/card.d.ts +15 -8
  116. package/dist/react/ui/card.d.ts.map +1 -1
  117. package/dist/react/ui/card.js +7 -0
  118. package/dist/react/ui/card.js.map +1 -1
  119. package/dist/react/ui/carousel.d.ts +11 -6
  120. package/dist/react/ui/carousel.d.ts.map +1 -1
  121. package/dist/react/ui/carousel.js +9 -4
  122. package/dist/react/ui/carousel.js.map +1 -1
  123. package/dist/react/ui/chart.d.ts +6 -5
  124. package/dist/react/ui/chart.d.ts.map +1 -1
  125. package/dist/react/ui/chart.js +2 -1
  126. package/dist/react/ui/chart.js.map +1 -1
  127. package/dist/react/ui/checkbox.d.ts +3 -2
  128. package/dist/react/ui/checkbox.d.ts.map +1 -1
  129. package/dist/react/ui/checkbox.js +1 -0
  130. package/dist/react/ui/checkbox.js.map +1 -1
  131. package/dist/react/ui/collapsible.d.ts +7 -4
  132. package/dist/react/ui/collapsible.d.ts.map +1 -1
  133. package/dist/react/ui/collapsible.js +3 -0
  134. package/dist/react/ui/collapsible.js.map +1 -1
  135. package/dist/react/ui/command.d.ts +19 -10
  136. package/dist/react/ui/command.d.ts.map +1 -1
  137. package/dist/react/ui/command.js +9 -0
  138. package/dist/react/ui/command.js.map +1 -1
  139. package/dist/react/ui/context-menu.d.ts +17 -16
  140. package/dist/react/ui/context-menu.d.ts.map +1 -1
  141. package/dist/react/ui/context-menu.js +1 -0
  142. package/dist/react/ui/context-menu.js.map +1 -1
  143. package/dist/react/ui/dialog.d.ts +21 -11
  144. package/dist/react/ui/dialog.d.ts.map +1 -1
  145. package/dist/react/ui/dialog.js +10 -0
  146. package/dist/react/ui/dialog.js.map +1 -1
  147. package/dist/react/ui/drawer.d.ts +21 -11
  148. package/dist/react/ui/drawer.d.ts.map +1 -1
  149. package/dist/react/ui/drawer.js +10 -0
  150. package/dist/react/ui/drawer.js.map +1 -1
  151. package/dist/react/ui/dropdown-menu.d.ts +17 -16
  152. package/dist/react/ui/dropdown-menu.d.ts.map +1 -1
  153. package/dist/react/ui/dropdown-menu.js +1 -0
  154. package/dist/react/ui/dropdown-menu.js.map +1 -1
  155. package/dist/react/ui/empty.d.ts +8 -7
  156. package/dist/react/ui/empty.d.ts.map +1 -1
  157. package/dist/react/ui/empty.js +1 -0
  158. package/dist/react/ui/empty.js.map +1 -1
  159. package/dist/react/ui/field.d.ts +21 -11
  160. package/dist/react/ui/field.d.ts.map +1 -1
  161. package/dist/react/ui/field.js +10 -0
  162. package/dist/react/ui/field.js.map +1 -1
  163. package/dist/react/ui/form.d.ts +14 -7
  164. package/dist/react/ui/form.d.ts.map +1 -1
  165. package/dist/react/ui/form.js +7 -0
  166. package/dist/react/ui/form.js.map +1 -1
  167. package/dist/react/ui/hover-card.d.ts +5 -4
  168. package/dist/react/ui/hover-card.d.ts.map +1 -1
  169. package/dist/react/ui/hover-card.js +1 -0
  170. package/dist/react/ui/hover-card.js.map +1 -1
  171. package/dist/react/ui/input-group.d.ts +16 -10
  172. package/dist/react/ui/input-group.d.ts.map +1 -1
  173. package/dist/react/ui/input-group.js +6 -0
  174. package/dist/react/ui/input-group.js.map +1 -1
  175. package/dist/react/ui/input-otp.d.ts +9 -5
  176. package/dist/react/ui/input-otp.d.ts.map +1 -1
  177. package/dist/react/ui/input-otp.js +4 -0
  178. package/dist/react/ui/input-otp.js.map +1 -1
  179. package/dist/react/ui/input.d.ts +3 -2
  180. package/dist/react/ui/input.d.ts.map +1 -1
  181. package/dist/react/ui/input.js +1 -0
  182. package/dist/react/ui/input.js.map +1 -1
  183. package/dist/react/ui/item.d.ts +15 -14
  184. package/dist/react/ui/item.d.ts.map +1 -1
  185. package/dist/react/ui/item.js +1 -0
  186. package/dist/react/ui/item.js.map +1 -1
  187. package/dist/react/ui/kbd.d.ts +1 -0
  188. package/dist/react/ui/kbd.d.ts.map +1 -1
  189. package/dist/react/ui/kbd.js +1 -0
  190. package/dist/react/ui/kbd.js.map +1 -1
  191. package/dist/react/ui/label.d.ts +1 -0
  192. package/dist/react/ui/label.d.ts.map +1 -1
  193. package/dist/react/ui/label.js +1 -0
  194. package/dist/react/ui/label.js.map +1 -1
  195. package/dist/react/ui/menubar.d.ts +1 -0
  196. package/dist/react/ui/menubar.d.ts.map +1 -1
  197. package/dist/react/ui/menubar.js +1 -0
  198. package/dist/react/ui/menubar.js.map +1 -1
  199. package/dist/react/ui/navigation-menu.d.ts +8 -0
  200. package/dist/react/ui/navigation-menu.d.ts.map +1 -1
  201. package/dist/react/ui/navigation-menu.js +8 -0
  202. package/dist/react/ui/navigation-menu.js.map +1 -1
  203. package/dist/react/ui/pagination.d.ts +7 -0
  204. package/dist/react/ui/pagination.d.ts.map +1 -1
  205. package/dist/react/ui/pagination.js +7 -0
  206. package/dist/react/ui/pagination.js.map +1 -1
  207. package/dist/react/ui/popover.d.ts +6 -5
  208. package/dist/react/ui/popover.d.ts.map +1 -1
  209. package/dist/react/ui/popover.js +1 -0
  210. package/dist/react/ui/popover.js.map +1 -1
  211. package/dist/react/ui/progress.d.ts +3 -2
  212. package/dist/react/ui/progress.d.ts.map +1 -1
  213. package/dist/react/ui/progress.js +1 -0
  214. package/dist/react/ui/progress.js.map +1 -1
  215. package/dist/react/ui/radio-group.d.ts +4 -3
  216. package/dist/react/ui/radio-group.d.ts.map +1 -1
  217. package/dist/react/ui/radio-group.js +1 -0
  218. package/dist/react/ui/radio-group.js.map +1 -1
  219. package/dist/react/ui/resizable.d.ts +7 -4
  220. package/dist/react/ui/resizable.d.ts.map +1 -1
  221. package/dist/react/ui/resizable.js +3 -0
  222. package/dist/react/ui/resizable.js.map +1 -1
  223. package/dist/react/ui/scroll-area.d.ts +5 -3
  224. package/dist/react/ui/scroll-area.d.ts.map +1 -1
  225. package/dist/react/ui/scroll-area.js +2 -0
  226. package/dist/react/ui/scroll-area.js.map +1 -1
  227. package/dist/react/ui/select.d.ts +23 -11
  228. package/dist/react/ui/select.d.ts.map +1 -1
  229. package/dist/react/ui/select.js +12 -0
  230. package/dist/react/ui/select.js.map +1 -1
  231. package/dist/react/ui/separator.d.ts +3 -2
  232. package/dist/react/ui/separator.d.ts.map +1 -1
  233. package/dist/react/ui/separator.js +1 -0
  234. package/dist/react/ui/separator.js.map +1 -1
  235. package/dist/react/ui/sheet.d.ts +17 -9
  236. package/dist/react/ui/sheet.d.ts.map +1 -1
  237. package/dist/react/ui/sheet.js +10 -0
  238. package/dist/react/ui/sheet.js.map +1 -1
  239. package/dist/react/ui/sidebar.d.ts +46 -24
  240. package/dist/react/ui/sidebar.d.ts.map +1 -1
  241. package/dist/react/ui/sidebar.js +23 -1
  242. package/dist/react/ui/sidebar.js.map +1 -1
  243. package/dist/react/ui/skeleton.d.ts +3 -2
  244. package/dist/react/ui/skeleton.d.ts.map +1 -1
  245. package/dist/react/ui/skeleton.js +1 -0
  246. package/dist/react/ui/skeleton.js.map +1 -1
  247. package/dist/react/ui/slider.d.ts +3 -2
  248. package/dist/react/ui/slider.d.ts.map +1 -1
  249. package/dist/react/ui/slider.js +1 -0
  250. package/dist/react/ui/slider.js.map +1 -1
  251. package/dist/react/ui/sonner.d.ts +3 -2
  252. package/dist/react/ui/sonner.d.ts.map +1 -1
  253. package/dist/react/ui/sonner.js +1 -0
  254. package/dist/react/ui/sonner.js.map +1 -1
  255. package/dist/react/ui/spinner.d.ts +3 -2
  256. package/dist/react/ui/spinner.d.ts.map +1 -1
  257. package/dist/react/ui/spinner.js +1 -0
  258. package/dist/react/ui/spinner.js.map +1 -1
  259. package/dist/react/ui/switch.d.ts +3 -2
  260. package/dist/react/ui/switch.d.ts.map +1 -1
  261. package/dist/react/ui/switch.js +1 -0
  262. package/dist/react/ui/switch.js.map +1 -1
  263. package/dist/react/ui/table.d.ts +1 -0
  264. package/dist/react/ui/table.d.ts.map +1 -1
  265. package/dist/react/ui/table.js +1 -0
  266. package/dist/react/ui/table.js.map +1 -1
  267. package/dist/react/ui/tabs.d.ts +9 -5
  268. package/dist/react/ui/tabs.d.ts.map +1 -1
  269. package/dist/react/ui/tabs.js +4 -0
  270. package/dist/react/ui/tabs.js.map +1 -1
  271. package/dist/react/ui/textarea.d.ts +3 -2
  272. package/dist/react/ui/textarea.d.ts.map +1 -1
  273. package/dist/react/ui/textarea.js +1 -0
  274. package/dist/react/ui/textarea.js.map +1 -1
  275. package/dist/react/ui/toggle-group.d.ts +4 -3
  276. package/dist/react/ui/toggle-group.d.ts.map +1 -1
  277. package/dist/react/ui/toggle-group.js +1 -0
  278. package/dist/react/ui/toggle-group.js.map +1 -1
  279. package/dist/react/ui/toggle.d.ts +3 -2
  280. package/dist/react/ui/toggle.d.ts.map +1 -1
  281. package/dist/react/ui/toggle.js +1 -0
  282. package/dist/react/ui/toggle.js.map +1 -1
  283. package/dist/react/ui/tooltip.d.ts +7 -5
  284. package/dist/react/ui/tooltip.d.ts.map +1 -1
  285. package/dist/react/ui/tooltip.js +2 -0
  286. package/dist/react/ui/tooltip.js.map +1 -1
  287. package/docs/docs/api/appkit/Class.AppKitError/index.html +77 -0
  288. package/docs/docs/api/appkit/Class.AppKitError.md +154 -0
  289. package/docs/docs/api/appkit/Class.AuthenticationError/index.html +110 -0
  290. package/docs/docs/api/appkit/Class.AuthenticationError.md +236 -0
  291. package/docs/docs/api/appkit/Class.ConfigurationError/index.html +112 -0
  292. package/docs/docs/api/appkit/Class.ConfigurationError.md +243 -0
  293. package/docs/docs/api/appkit/Class.ConnectionError/index.html +120 -0
  294. package/docs/docs/api/appkit/Class.ConnectionError.md +265 -0
  295. package/docs/docs/api/appkit/Class.ExecutionError/index.html +116 -0
  296. package/docs/docs/api/appkit/Class.ExecutionError.md +250 -0
  297. package/docs/docs/api/appkit/Class.InitializationError/index.html +104 -0
  298. package/docs/docs/api/appkit/Class.InitializationError.md +222 -0
  299. package/docs/docs/api/appkit/Class.Plugin/index.html +149 -0
  300. package/docs/docs/api/appkit/Class.Plugin.md +392 -0
  301. package/docs/docs/api/appkit/Class.ServerError/index.html +108 -0
  302. package/docs/docs/api/appkit/Class.ServerError.md +229 -0
  303. package/docs/docs/api/appkit/Class.TunnelError/index.html +108 -0
  304. package/docs/docs/api/appkit/Class.TunnelError.md +231 -0
  305. package/docs/docs/api/appkit/Class.ValidationError/index.html +106 -0
  306. package/docs/docs/api/appkit/Class.ValidationError.md +225 -0
  307. package/docs/docs/api/appkit/Function.appKitTypesPlugin/index.html +24 -0
  308. package/docs/docs/api/appkit/Function.appKitTypesPlugin.md +20 -0
  309. package/docs/docs/api/appkit/Function.createApp/index.html +24 -0
  310. package/docs/docs/api/appkit/Function.createApp.md +31 -0
  311. package/docs/docs/api/appkit/Function.isSQLTypeMarker/index.html +25 -0
  312. package/docs/docs/api/appkit/Function.isSQLTypeMarker.md +32 -0
  313. package/docs/docs/api/appkit/Interface.BasePluginConfig/index.html +28 -0
  314. package/docs/docs/api/appkit/Interface.BasePluginConfig.md +37 -0
  315. package/docs/docs/api/appkit/Interface.CacheConfig/index.html +63 -0
  316. package/docs/docs/api/appkit/Interface.CacheConfig.md +131 -0
  317. package/docs/docs/api/appkit/Interface.ITelemetry/index.html +73 -0
  318. package/docs/docs/api/appkit/Interface.ITelemetry.md +144 -0
  319. package/docs/docs/api/appkit/Interface.StreamExecutionSettings/index.html +26 -0
  320. package/docs/docs/api/appkit/Interface.StreamExecutionSettings.md +30 -0
  321. package/docs/docs/api/appkit/Interface.TelemetryConfig/index.html +32 -0
  322. package/docs/docs/api/appkit/Interface.TelemetryConfig.md +48 -0
  323. package/docs/docs/api/appkit/TypeAlias.IAppRouter/index.html +18 -0
  324. package/docs/docs/api/appkit/TypeAlias.IAppRouter.md +8 -0
  325. package/docs/docs/api/appkit/Variable.sql/index.html +98 -0
  326. package/docs/docs/api/appkit/Variable.sql.md +260 -0
  327. package/docs/docs/api/appkit/index.html +28 -0
  328. package/docs/docs/api/appkit-ui/data/AreaChart/index.html +29 -0
  329. package/docs/docs/api/appkit-ui/data/AreaChart.md +79 -0
  330. package/docs/docs/api/appkit-ui/data/BarChart/index.html +29 -0
  331. package/docs/docs/api/appkit-ui/data/BarChart.md +74 -0
  332. package/docs/docs/api/appkit-ui/data/DataTable/index.html +36 -0
  333. package/docs/docs/api/appkit-ui/data/DataTable.md +69 -0
  334. package/docs/docs/api/appkit-ui/data/DonutChart/index.html +29 -0
  335. package/docs/docs/api/appkit-ui/data/DonutChart.md +72 -0
  336. package/docs/docs/api/appkit-ui/data/HeatmapChart/index.html +35 -0
  337. package/docs/docs/api/appkit-ui/data/HeatmapChart.md +91 -0
  338. package/docs/docs/api/appkit-ui/data/LineChart/index.html +29 -0
  339. package/docs/docs/api/appkit-ui/data/LineChart.md +77 -0
  340. package/docs/docs/api/appkit-ui/data/PieChart/index.html +29 -0
  341. package/docs/docs/api/appkit-ui/data/PieChart.md +72 -0
  342. package/docs/docs/api/appkit-ui/data/RadarChart/index.html +29 -0
  343. package/docs/docs/api/appkit-ui/data/RadarChart.md +74 -0
  344. package/docs/docs/api/appkit-ui/data/ScatterChart/index.html +29 -0
  345. package/docs/docs/api/appkit-ui/data/ScatterChart.md +76 -0
  346. package/docs/docs/api/appkit-ui/index.html +23 -0
  347. package/docs/docs/api/appkit-ui/styling/index.html +74 -0
  348. package/docs/docs/api/appkit-ui/styling.md +81 -0
  349. package/docs/docs/api/appkit-ui/ui/Accordion/index.html +48 -0
  350. package/docs/docs/api/appkit-ui/ui/Accordion.md +139 -0
  351. package/docs/docs/api/appkit-ui/ui/Alert/index.html +41 -0
  352. package/docs/docs/api/appkit-ui/ui/Alert.md +89 -0
  353. package/docs/docs/api/appkit-ui/ui/AlertDialog/index.html +97 -0
  354. package/docs/docs/api/appkit-ui/ui/AlertDialog.md +282 -0
  355. package/docs/docs/api/appkit-ui/ui/AspectRatio/index.html +27 -0
  356. package/docs/docs/api/appkit-ui/ui/AspectRatio.md +46 -0
  357. package/docs/docs/api/appkit-ui/ui/Avatar/index.html +41 -0
  358. package/docs/docs/api/appkit-ui/ui/Avatar.md +90 -0
  359. package/docs/docs/api/appkit-ui/ui/Badge/index.html +27 -0
  360. package/docs/docs/api/appkit-ui/ui/Badge.md +38 -0
  361. package/docs/docs/api/appkit-ui/ui/Breadcrumb/index.html +69 -0
  362. package/docs/docs/api/appkit-ui/ui/Breadcrumb.md +193 -0
  363. package/docs/docs/api/appkit-ui/ui/Button/index.html +27 -0
  364. package/docs/docs/api/appkit-ui/ui/Button.md +39 -0
  365. package/docs/docs/api/appkit-ui/ui/ButtonGroup/index.html +38 -0
  366. package/docs/docs/api/appkit-ui/ui/ButtonGroup.md +68 -0
  367. package/docs/docs/api/appkit-ui/ui/Calendar/index.html +34 -0
  368. package/docs/docs/api/appkit-ui/ui/Calendar.md +154 -0
  369. package/docs/docs/api/appkit-ui/ui/Card/index.html +69 -0
  370. package/docs/docs/api/appkit-ui/ui/Card.md +222 -0
  371. package/docs/docs/api/appkit-ui/ui/Carousel/index.html +55 -0
  372. package/docs/docs/api/appkit-ui/ui/Carousel.md +152 -0
  373. package/docs/docs/api/appkit-ui/ui/ChartContainer/index.html +58 -0
  374. package/docs/docs/api/appkit-ui/ui/ChartContainer.md +343 -0
  375. package/docs/docs/api/appkit-ui/ui/Checkbox/index.html +27 -0
  376. package/docs/docs/api/appkit-ui/ui/Checkbox.md +53 -0
  377. package/docs/docs/api/appkit-ui/ui/Collapsible/index.html +41 -0
  378. package/docs/docs/api/appkit-ui/ui/Collapsible.md +125 -0
  379. package/docs/docs/api/appkit-ui/ui/Command/index.html +83 -0
  380. package/docs/docs/api/appkit-ui/ui/Command.md +287 -0
  381. package/docs/docs/api/appkit-ui/ui/ContextMenu/index.html +111 -0
  382. package/docs/docs/api/appkit-ui/ui/ContextMenu.md +419 -0
  383. package/docs/docs/api/appkit-ui/ui/Dialog/index.html +90 -0
  384. package/docs/docs/api/appkit-ui/ui/Dialog.md +285 -0
  385. package/docs/docs/api/appkit-ui/ui/Drawer/index.html +90 -0
  386. package/docs/docs/api/appkit-ui/ui/Drawer.md +387 -0
  387. package/docs/docs/api/appkit-ui/ui/DropdownMenu/index.html +111 -0
  388. package/docs/docs/api/appkit-ui/ui/DropdownMenu.md +478 -0
  389. package/docs/docs/api/appkit-ui/ui/Empty/index.html +54 -0
  390. package/docs/docs/api/appkit-ui/ui/Empty.md +109 -0
  391. package/docs/docs/api/appkit-ui/ui/Field/index.html +87 -0
  392. package/docs/docs/api/appkit-ui/ui/Field.md +201 -0
  393. package/docs/docs/api/appkit-ui/ui/FormControl/index.html +59 -0
  394. package/docs/docs/api/appkit-ui/ui/FormControl.md +128 -0
  395. package/docs/docs/api/appkit-ui/ui/HoverCard/index.html +39 -0
  396. package/docs/docs/api/appkit-ui/ui/HoverCard.md +131 -0
  397. package/docs/docs/api/appkit-ui/ui/Input/index.html +27 -0
  398. package/docs/docs/api/appkit-ui/ui/Input.md +35 -0
  399. package/docs/docs/api/appkit-ui/ui/InputGroup/index.html +59 -0
  400. package/docs/docs/api/appkit-ui/ui/InputGroup.md +123 -0
  401. package/docs/docs/api/appkit-ui/ui/InputOTP/index.html +48 -0
  402. package/docs/docs/api/appkit-ui/ui/InputOTP.md +124 -0
  403. package/docs/docs/api/appkit-ui/ui/Item/index.html +78 -0
  404. package/docs/docs/api/appkit-ui/ui/Item.md +185 -0
  405. package/docs/docs/api/appkit-ui/ui/Kbd/index.html +30 -0
  406. package/docs/docs/api/appkit-ui/ui/Kbd.md +39 -0
  407. package/docs/docs/api/appkit-ui/ui/Label/index.html +27 -0
  408. package/docs/docs/api/appkit-ui/ui/Label.md +44 -0
  409. package/docs/docs/api/appkit-ui/ui/Menubar/index.html +117 -0
  410. package/docs/docs/api/appkit-ui/ui/Menubar.md +484 -0
  411. package/docs/docs/api/appkit-ui/ui/NavigationMenu/index.html +76 -0
  412. package/docs/docs/api/appkit-ui/ui/NavigationMenu.md +338 -0
  413. package/docs/docs/api/appkit-ui/ui/Pagination/index.html +69 -0
  414. package/docs/docs/api/appkit-ui/ui/Pagination.md +191 -0
  415. package/docs/docs/api/appkit-ui/ui/Popover/index.html +45 -0
  416. package/docs/docs/api/appkit-ui/ui/Popover.md +173 -0
  417. package/docs/docs/api/appkit-ui/ui/Progress/index.html +27 -0
  418. package/docs/docs/api/appkit-ui/ui/Progress.md +51 -0
  419. package/docs/docs/api/appkit-ui/ui/RadioGroup/index.html +33 -0
  420. package/docs/docs/api/appkit-ui/ui/RadioGroup.md +83 -0
  421. package/docs/docs/api/appkit-ui/ui/ResizableHandle/index.html +41 -0
  422. package/docs/docs/api/appkit-ui/ui/ResizableHandle.md +136 -0
  423. package/docs/docs/api/appkit-ui/ui/ScrollArea/index.html +34 -0
  424. package/docs/docs/api/appkit-ui/ui/ScrollArea.md +83 -0
  425. package/docs/docs/api/appkit-ui/ui/Select/index.html +82 -0
  426. package/docs/docs/api/appkit-ui/ui/Select.md +267 -0
  427. package/docs/docs/api/appkit-ui/ui/Separator/index.html +27 -0
  428. package/docs/docs/api/appkit-ui/ui/Separator.md +56 -0
  429. package/docs/docs/api/appkit-ui/ui/Sheet/index.html +76 -0
  430. package/docs/docs/api/appkit-ui/ui/Sheet.md +236 -0
  431. package/docs/docs/api/appkit-ui/ui/Sidebar/index.html +183 -0
  432. package/docs/docs/api/appkit-ui/ui/Sidebar.md +490 -0
  433. package/docs/docs/api/appkit-ui/ui/Skeleton/index.html +27 -0
  434. package/docs/docs/api/appkit-ui/ui/Skeleton.md +43 -0
  435. package/docs/docs/api/appkit-ui/ui/Slider/index.html +27 -0
  436. package/docs/docs/api/appkit-ui/ui/Slider.md +61 -0
  437. package/docs/docs/api/appkit-ui/ui/Spinner/index.html +24 -0
  438. package/docs/docs/api/appkit-ui/ui/Spinner.md +22 -0
  439. package/docs/docs/api/appkit-ui/ui/Switch/index.html +27 -0
  440. package/docs/docs/api/appkit-ui/ui/Switch.md +46 -0
  441. package/docs/docs/api/appkit-ui/ui/Table/index.html +69 -0
  442. package/docs/docs/api/appkit-ui/ui/Table.md +236 -0
  443. package/docs/docs/api/appkit-ui/ui/Tabs/index.html +48 -0
  444. package/docs/docs/api/appkit-ui/ui/Tabs.md +177 -0
  445. package/docs/docs/api/appkit-ui/ui/Textarea/index.html +27 -0
  446. package/docs/docs/api/appkit-ui/ui/Textarea.md +35 -0
  447. package/docs/docs/api/appkit-ui/ui/Toaster/index.html +27 -0
  448. package/docs/docs/api/appkit-ui/ui/Toaster.md +75 -0
  449. package/docs/docs/api/appkit-ui/ui/Toggle/index.html +27 -0
  450. package/docs/docs/api/appkit-ui/ui/Toggle.md +48 -0
  451. package/docs/docs/api/appkit-ui/ui/ToggleGroup/index.html +33 -0
  452. package/docs/docs/api/appkit-ui/ui/ToggleGroup.md +88 -0
  453. package/docs/docs/api/appkit-ui/ui/Tooltip/index.html +46 -0
  454. package/docs/docs/api/appkit-ui/ui/Tooltip.md +134 -0
  455. package/docs/docs/api/appkit-ui.md +15 -0
  456. package/docs/docs/api/appkit.md +48 -0
  457. package/docs/docs/api/index.html +28 -0
  458. package/docs/docs/api.md +24 -0
  459. package/docs/docs/app-management/index.html +106 -0
  460. package/docs/docs/app-management.md +171 -0
  461. package/docs/docs/architecture/index.html +71 -0
  462. package/docs/docs/architecture.md +69 -0
  463. package/docs/docs/category/development/index.html +16 -0
  464. package/docs/docs/category/development.md +3 -0
  465. package/docs/docs/configuration/index.html +66 -0
  466. package/docs/docs/configuration.md +150 -0
  467. package/docs/docs/core-principles/index.html +38 -0
  468. package/docs/docs/core-principles.md +31 -0
  469. package/docs/docs/development/index.html +34 -0
  470. package/docs/docs/development/llm-guide/index.html +74 -0
  471. package/docs/docs/development/llm-guide.md +74 -0
  472. package/docs/docs/development/local-development/index.html +27 -0
  473. package/docs/docs/development/local-development.md +20 -0
  474. package/docs/docs/development/project-setup/index.html +69 -0
  475. package/docs/docs/development/project-setup.md +246 -0
  476. package/docs/docs/development/remote-bridge/index.html +76 -0
  477. package/docs/docs/development/remote-bridge.md +80 -0
  478. package/docs/docs/development/type-generation/index.html +65 -0
  479. package/docs/docs/development/type-generation.md +110 -0
  480. package/docs/docs/development.md +21 -0
  481. package/docs/docs/index.html +58 -0
  482. package/docs/docs/plugins/index.html +151 -0
  483. package/docs/docs/plugins.md +313 -0
  484. package/docs/docs.md +64 -0
  485. package/llms.txt +121 -1228
  486. package/package.json +7 -5
  487. package/scripts/postinstall.js +1 -1
  488. package/AGENTS.md +0 -1231
  489. package/bin/setup-claude.js +0 -190
@@ -1 +1 @@
1
- {"version":3,"file":"normalize.js","names":["xField","detected","resolvedXKey","resolvedYKeys","rawXData","rawYDataMap","xData","yDataMap"],"sources":["../../../src/react/charts/normalize.ts"],"sourcesContent":["import { ArrowClient } from \"@/js\";\nimport type { Table } from \"apache-arrow\";\nimport { DATE_FIELD_PATTERNS, NAME_FIELD_PATTERNS } from \"./constants\";\nimport type {\n ChartData,\n NormalizedChartData,\n NormalizedChartDataBase,\n Orientation,\n} from \"./types\";\nimport { isArrowTable } from \"./types\";\nimport { sortTimeSeriesAscending, toChartArray } from \"./utils\";\n\n// ============================================================================\n// Type Detection Helpers\n// ============================================================================\n\n/**\n * Checks if a value looks like an ISO date string\n */\nfunction isDateString(value: unknown): boolean {\n if (typeof value !== \"string\") return false;\n return /^\\d{4}-\\d{2}-\\d{2}(T|$)/.test(value);\n}\n\n/**\n * Checks if a value is numeric (number or numeric string)\n */\nfunction isNumericValue(value: unknown): boolean {\n if (typeof value === \"number\") return true;\n if (typeof value === \"bigint\") return true;\n if (typeof value === \"string\") {\n const trimmed = value.trim();\n if (trimmed === \"\" || isDateString(trimmed)) return false;\n const parsed = Number(trimmed);\n return !Number.isNaN(parsed) && Number.isFinite(parsed);\n }\n return false;\n}\n\n/**\n * Checks if a value looks like a category/label (non-numeric string)\n */\nfunction isCategoryValue(value: unknown): boolean {\n if (typeof value !== \"string\") return false;\n const trimmed = value.trim();\n if (trimmed === \"\") return false;\n if (/^\\d{4}-\\d{2}-\\d{2}/.test(trimmed)) return false;\n const parsed = Number(trimmed);\n return Number.isNaN(parsed) || !Number.isFinite(parsed);\n}\n\n// ============================================================================\n// Field Detection\n// ============================================================================\n\n/**\n * Detects fields from JSON data for charting\n */\nfunction detectFieldsFromJson(\n data: Record<string, unknown>[],\n orientation?: Orientation,\n): {\n xField: string;\n yFields: string[];\n chartType: \"timeseries\" | \"categorical\";\n} {\n if (!data || data.length === 0) {\n return { xField: \"x\", yFields: [\"y\"], chartType: \"categorical\" };\n }\n\n const firstRow = data[0];\n const keys = Object.keys(firstRow);\n\n // Detect date fields by key name OR by value being a date string\n const dateFields = keys.filter((key) => {\n const value = firstRow[key];\n const keyMatchesDatePattern = DATE_FIELD_PATTERNS.some((p) =>\n key.toLowerCase().includes(p),\n );\n const valueIsDateString = isDateString(value);\n return keyMatchesDatePattern || valueIsDateString;\n });\n\n // Detect name/category fields by pattern AND value type\n let nameFields = keys.filter((key) => {\n const value = firstRow[key];\n return (\n isCategoryValue(value) &&\n !isDateString(value) &&\n NAME_FIELD_PATTERNS.some((p) => key.toLowerCase().includes(p))\n );\n });\n\n // Fallback: any string field that isn't a date or ID\n if (nameFields.length === 0) {\n nameFields = keys.filter((key) => {\n const value = firstRow[key];\n return (\n isCategoryValue(value) &&\n !isDateString(value) &&\n !dateFields.includes(key) &&\n !key.toLowerCase().endsWith(\"_id\")\n );\n });\n }\n\n // Detect numeric fields\n const numericFields = keys.filter((key) => {\n const value = firstRow[key];\n return isNumericValue(value) && !dateFields.includes(key);\n });\n\n const isHorizontal = orientation === \"horizontal\";\n\n if (isHorizontal || (nameFields.length > 0 && dateFields.length === 0)) {\n const xField = nameFields[0] || dateFields[0] || keys[0];\n const yFields =\n numericFields.length > 0\n ? numericFields\n : keys.filter((k) => k !== xField);\n return { xField, yFields, chartType: \"categorical\" };\n }\n\n const xField = dateFields[0] || nameFields[0] || keys[0];\n const yFields =\n numericFields.length > 0 ? numericFields : keys.filter((k) => k !== xField);\n return {\n xField,\n yFields,\n chartType: dateFields.length > 0 ? \"timeseries\" : \"categorical\",\n };\n}\n\n// ============================================================================\n// Value Conversion\n// ============================================================================\n\n/**\n * Converts a JSON value to a chart-compatible value.\n */\nfunction jsonValueToChartValue(\n value: unknown,\n isYValue: boolean,\n isDateField: boolean,\n): string | number {\n if (value === null || value === undefined) {\n return isYValue ? 0 : \"\";\n }\n if (typeof value === \"number\") {\n return value;\n }\n if (typeof value === \"bigint\") {\n return Number(value);\n }\n if (typeof value === \"string\") {\n if (isDateField && isDateString(value)) {\n const timestamp = new Date(value).getTime();\n if (!Number.isNaN(timestamp)) {\n return timestamp;\n }\n }\n if (isYValue) {\n const trimmed = value.trim();\n const parsed = Number(trimmed);\n if (!Number.isNaN(parsed) && Number.isFinite(parsed)) {\n return parsed;\n }\n }\n return value;\n }\n return String(value);\n}\n\n// ============================================================================\n// Data Extraction\n// ============================================================================\n\n/**\n * Extracts chart data from JSON array\n */\nfunction extractFromJson(\n data: Record<string, unknown>[],\n xField: string,\n yFields: string[],\n): {\n xData: (string | number)[];\n yDataMap: Record<string, (string | number)[]>;\n} {\n const xData: (string | number)[] = [];\n const yDataMap: Record<string, (string | number)[]> = {};\n\n for (const field of yFields) {\n yDataMap[field] = [];\n }\n\n const xIsDateField = data.length > 0 && isDateString(data[0][xField]);\n\n for (const row of data) {\n xData.push(jsonValueToChartValue(row[xField], false, xIsDateField));\n for (const field of yFields) {\n yDataMap[field].push(jsonValueToChartValue(row[field], true, false));\n }\n }\n\n return { xData, yDataMap };\n}\n\n// ============================================================================\n// Main Normalization Function\n// ============================================================================\n\n/**\n * Normalizes chart data from either Arrow or JSON format.\n * Converts BigInt and Date values to chart-compatible types.\n */\nexport function normalizeChartData(\n data: ChartData,\n xKey?: string,\n yKey?: string | string[],\n orientation?: Orientation,\n): NormalizedChartData {\n if (isArrowTable(data)) {\n const table = data as Table;\n const detected = ArrowClient.detectFieldsFromArrow(table, orientation);\n const resolvedXKey = xKey ?? detected.xField;\n const resolvedYKeys = yKey\n ? Array.isArray(yKey)\n ? yKey\n : [yKey]\n : detected.yFields;\n\n const { xData: rawXData, yDataMap: rawYDataMap } =\n ArrowClient.extractChartData(table, resolvedXKey, resolvedYKeys);\n\n let xData = toChartArray(rawXData);\n let yDataMap: Record<string, (string | number)[]> = {};\n for (const key of resolvedYKeys) {\n yDataMap[key] = toChartArray(rawYDataMap[key] ?? []);\n }\n\n if (detected.chartType === \"timeseries\") {\n ({ xData, yDataMap } = sortTimeSeriesAscending(\n xData,\n yDataMap,\n resolvedYKeys,\n ));\n }\n\n return {\n xData,\n yDataMap,\n xField: resolvedXKey,\n yFields: resolvedYKeys,\n chartType: detected.chartType,\n };\n }\n\n // JSON Array\n const jsonData = data as Record<string, unknown>[];\n const detected = detectFieldsFromJson(jsonData, orientation);\n const resolvedXKey = xKey ?? detected.xField;\n const resolvedYKeys = yKey\n ? Array.isArray(yKey)\n ? yKey\n : [yKey]\n : detected.yFields;\n\n const { xData: rawXData, yDataMap: rawYDataMap } = extractFromJson(\n jsonData,\n resolvedXKey,\n resolvedYKeys,\n );\n\n let xData = toChartArray(rawXData);\n let yDataMap: Record<string, (string | number)[]> = {};\n for (const key of resolvedYKeys) {\n yDataMap[key] = toChartArray(rawYDataMap[key] ?? []);\n }\n\n if (detected.chartType === \"timeseries\") {\n ({ xData, yDataMap } = sortTimeSeriesAscending(\n xData,\n yDataMap,\n resolvedYKeys,\n ));\n }\n\n return {\n xData,\n yDataMap,\n xField: resolvedXKey,\n yFields: resolvedYKeys,\n chartType: detected.chartType,\n };\n}\n\n// ============================================================================\n// Heatmap Data Normalization\n// ============================================================================\n\n/**\n * Normalized data for heatmap charts.\n * Extends base (not NormalizedChartData) because heatmaps don't use yDataMap.\n * Instead, they use heatmapData which contains [xIndex, yIndex, value] tuples.\n */\nexport interface NormalizedHeatmapData extends NormalizedChartDataBase {\n /** Y-axis categories (rows) */\n yAxisData: (string | number)[];\n /** Heatmap data as [xIndex, yIndex, value] tuples */\n heatmapData: [number, number, number][];\n /** Min value in the data */\n min: number;\n /** Max value in the data */\n max: number;\n}\n\n/**\n * Normalizes data specifically for heatmap charts.\n * Expects data in format: `{ xKey: string, yAxisKey: string, valueKey: number }`\n *\n * @param data - Raw data (Arrow Table or JSON array)\n * @param xKey - Field key for X-axis (columns)\n * @param yAxisKey - Field key for Y-axis (rows)\n * @param valueKey - Field key for the cell values\n */\nexport function normalizeHeatmapData(\n data: ChartData,\n xKey?: string,\n yAxisKey?: string,\n valueKey?: string | string[],\n): NormalizedHeatmapData {\n // First, get the standard normalization\n const jsonData = isArrowTable(data)\n ? extractJsonFromArrow(data)\n : (data as Record<string, unknown>[]);\n\n if (jsonData.length === 0) {\n return {\n xData: [],\n xField: xKey ?? \"x\",\n yFields: [],\n chartType: \"categorical\",\n yAxisData: [],\n heatmapData: [],\n min: 0,\n max: 0,\n };\n }\n\n // Detect fields if not provided\n const keys = Object.keys(jsonData[0]);\n const resolvedXKey = xKey ?? keys[0];\n const resolvedYAxisKey = yAxisKey ?? keys[1];\n const resolvedValueKey = valueKey\n ? Array.isArray(valueKey)\n ? valueKey[0]\n : valueKey\n : keys[2];\n\n // Extract unique X and Y categories\n const xSet = new Set<string | number>();\n const ySet = new Set<string | number>();\n\n for (const row of jsonData) {\n const xVal = jsonValueToChartValue(row[resolvedXKey], false, false);\n const yVal = jsonValueToChartValue(row[resolvedYAxisKey], false, false);\n xSet.add(xVal);\n ySet.add(yVal);\n }\n\n const xData = Array.from(xSet);\n const yAxisData = Array.from(ySet);\n\n // Create index maps for fast lookup\n const xIndexMap = new Map<string | number, number>();\n const yIndexMap = new Map<string | number, number>();\n xData.forEach((v, i) => {\n xIndexMap.set(v, i);\n });\n yAxisData.forEach((v, i) => {\n yIndexMap.set(v, i);\n });\n\n // Build heatmap data and track min/max\n const heatmapData: [number, number, number][] = [];\n let min = Number.POSITIVE_INFINITY;\n let max = Number.NEGATIVE_INFINITY;\n\n for (const row of jsonData) {\n const xVal = jsonValueToChartValue(row[resolvedXKey], false, false);\n const yVal = jsonValueToChartValue(row[resolvedYAxisKey], false, false);\n const value = jsonValueToChartValue(row[resolvedValueKey], true, false);\n\n const xIdx = xIndexMap.get(xVal);\n const yIdx = yIndexMap.get(yVal);\n const numValue = typeof value === \"number\" ? value : 0;\n\n if (xIdx !== undefined && yIdx !== undefined) {\n heatmapData.push([xIdx, yIdx, numValue]);\n min = Math.min(min, numValue);\n max = Math.max(max, numValue);\n }\n }\n\n // Handle edge case where no valid data was found\n if (heatmapData.length === 0) {\n min = 0;\n max = 0;\n }\n\n return {\n xData,\n xField: resolvedXKey,\n yFields: [resolvedValueKey],\n chartType: \"categorical\",\n yAxisData,\n heatmapData,\n min,\n max,\n };\n}\n\n/**\n * Helper to extract JSON array from Arrow table for heatmap processing.\n */\nfunction extractJsonFromArrow(table: Table): Record<string, unknown>[] {\n const result: Record<string, unknown>[] = [];\n const fields = table.schema.fields.map((f) => f.name);\n\n for (let i = 0; i < table.numRows; i++) {\n const row: Record<string, unknown> = {};\n for (const field of fields) {\n const col = table.getChild(field);\n row[field] = col?.get(i);\n }\n result.push(row);\n }\n\n return result;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"normalize.js","names":[],"sources":["../../../src/react/charts/normalize.ts"],"sourcesContent":["import { ArrowClient } from \"@/js\";\nimport type { Table } from \"apache-arrow\";\nimport { DATE_FIELD_PATTERNS, NAME_FIELD_PATTERNS } from \"./constants\";\nimport type {\n ChartData,\n NormalizedChartData,\n NormalizedChartDataBase,\n Orientation,\n} from \"./types\";\nimport { isArrowTable } from \"./types\";\nimport { sortTimeSeriesAscending, toChartArray } from \"./utils\";\n\n// ============================================================================\n// Type Detection Helpers\n// ============================================================================\n\n/**\n * Checks if a value looks like an ISO date string\n */\nfunction isDateString(value: unknown): boolean {\n if (typeof value !== \"string\") return false;\n return /^\\d{4}-\\d{2}-\\d{2}(T|$)/.test(value);\n}\n\n/**\n * Checks if a value is numeric (number or numeric string)\n */\nfunction isNumericValue(value: unknown): boolean {\n if (typeof value === \"number\") return true;\n if (typeof value === \"bigint\") return true;\n if (typeof value === \"string\") {\n const trimmed = value.trim();\n if (trimmed === \"\" || isDateString(trimmed)) return false;\n const parsed = Number(trimmed);\n return !Number.isNaN(parsed) && Number.isFinite(parsed);\n }\n return false;\n}\n\n/**\n * Checks if a value looks like a category/label (non-numeric string)\n */\nfunction isCategoryValue(value: unknown): boolean {\n if (typeof value !== \"string\") return false;\n const trimmed = value.trim();\n if (trimmed === \"\") return false;\n if (/^\\d{4}-\\d{2}-\\d{2}/.test(trimmed)) return false;\n const parsed = Number(trimmed);\n return Number.isNaN(parsed) || !Number.isFinite(parsed);\n}\n\n// ============================================================================\n// Field Detection\n// ============================================================================\n\n/**\n * Detects fields from JSON data for charting\n */\nfunction detectFieldsFromJson(\n data: Record<string, unknown>[],\n orientation?: Orientation,\n): {\n xField: string;\n yFields: string[];\n chartType: \"timeseries\" | \"categorical\";\n} {\n if (!data || data.length === 0) {\n return { xField: \"x\", yFields: [\"y\"], chartType: \"categorical\" };\n }\n\n const firstRow = data[0];\n const keys = Object.keys(firstRow);\n\n // Detect date fields by key name OR by value being a date string\n const dateFields = keys.filter((key) => {\n const value = firstRow[key];\n const keyMatchesDatePattern = DATE_FIELD_PATTERNS.some((p) =>\n key.toLowerCase().includes(p),\n );\n const valueIsDateString = isDateString(value);\n return keyMatchesDatePattern || valueIsDateString;\n });\n\n // Detect name/category fields by pattern AND value type\n let nameFields = keys.filter((key) => {\n const value = firstRow[key];\n return (\n isCategoryValue(value) &&\n !isDateString(value) &&\n NAME_FIELD_PATTERNS.some((p) => key.toLowerCase().includes(p))\n );\n });\n\n // Fallback: any string field that isn't a date or ID\n if (nameFields.length === 0) {\n nameFields = keys.filter((key) => {\n const value = firstRow[key];\n return (\n isCategoryValue(value) &&\n !isDateString(value) &&\n !dateFields.includes(key) &&\n !key.toLowerCase().endsWith(\"_id\")\n );\n });\n }\n\n // Detect numeric fields\n const numericFields = keys.filter((key) => {\n const value = firstRow[key];\n return isNumericValue(value) && !dateFields.includes(key);\n });\n\n const isHorizontal = orientation === \"horizontal\";\n\n if (isHorizontal || (nameFields.length > 0 && dateFields.length === 0)) {\n const xField = nameFields[0] || dateFields[0] || keys[0];\n const yFields =\n numericFields.length > 0\n ? numericFields\n : keys.filter((k) => k !== xField);\n return { xField, yFields, chartType: \"categorical\" };\n }\n\n const xField = dateFields[0] || nameFields[0] || keys[0];\n const yFields =\n numericFields.length > 0 ? numericFields : keys.filter((k) => k !== xField);\n return {\n xField,\n yFields,\n chartType: dateFields.length > 0 ? \"timeseries\" : \"categorical\",\n };\n}\n\n// ============================================================================\n// Value Conversion\n// ============================================================================\n\n/**\n * Converts a JSON value to a chart-compatible value.\n */\nfunction jsonValueToChartValue(\n value: unknown,\n isYValue: boolean,\n isDateField: boolean,\n): string | number {\n if (value === null || value === undefined) {\n return isYValue ? 0 : \"\";\n }\n if (typeof value === \"number\") {\n return value;\n }\n if (typeof value === \"bigint\") {\n return Number(value);\n }\n if (typeof value === \"string\") {\n if (isDateField && isDateString(value)) {\n const timestamp = new Date(value).getTime();\n if (!Number.isNaN(timestamp)) {\n return timestamp;\n }\n }\n if (isYValue) {\n const trimmed = value.trim();\n const parsed = Number(trimmed);\n if (!Number.isNaN(parsed) && Number.isFinite(parsed)) {\n return parsed;\n }\n }\n return value;\n }\n return String(value);\n}\n\n// ============================================================================\n// Data Extraction\n// ============================================================================\n\n/**\n * Extracts chart data from JSON array\n */\nfunction extractFromJson(\n data: Record<string, unknown>[],\n xField: string,\n yFields: string[],\n): {\n xData: (string | number)[];\n yDataMap: Record<string, (string | number)[]>;\n} {\n const xData: (string | number)[] = [];\n const yDataMap: Record<string, (string | number)[]> = {};\n\n for (const field of yFields) {\n yDataMap[field] = [];\n }\n\n const xIsDateField = data.length > 0 && isDateString(data[0][xField]);\n\n for (const row of data) {\n xData.push(jsonValueToChartValue(row[xField], false, xIsDateField));\n for (const field of yFields) {\n yDataMap[field].push(jsonValueToChartValue(row[field], true, false));\n }\n }\n\n return { xData, yDataMap };\n}\n\n// ============================================================================\n// Main Normalization Function\n// ============================================================================\n\n/**\n * Normalizes chart data from either Arrow or JSON format.\n * Converts BigInt and Date values to chart-compatible types.\n */\nexport function normalizeChartData(\n data: ChartData,\n xKey?: string,\n yKey?: string | string[],\n orientation?: Orientation,\n): NormalizedChartData {\n if (isArrowTable(data)) {\n const table = data as Table;\n const detected = ArrowClient.detectFieldsFromArrow(table, orientation);\n const resolvedXKey = xKey ?? detected.xField;\n const resolvedYKeys = yKey\n ? Array.isArray(yKey)\n ? yKey\n : [yKey]\n : detected.yFields;\n\n const { xData: rawXData, yDataMap: rawYDataMap } =\n ArrowClient.extractChartData(table, resolvedXKey, resolvedYKeys);\n\n let xData = toChartArray(rawXData);\n let yDataMap: Record<string, (string | number)[]> = {};\n for (const key of resolvedYKeys) {\n yDataMap[key] = toChartArray(rawYDataMap[key] ?? []);\n }\n\n if (detected.chartType === \"timeseries\") {\n ({ xData, yDataMap } = sortTimeSeriesAscending(\n xData,\n yDataMap,\n resolvedYKeys,\n ));\n }\n\n return {\n xData,\n yDataMap,\n xField: resolvedXKey,\n yFields: resolvedYKeys,\n chartType: detected.chartType,\n };\n }\n\n // JSON Array\n const jsonData = data as Record<string, unknown>[];\n const detected = detectFieldsFromJson(jsonData, orientation);\n const resolvedXKey = xKey ?? detected.xField;\n const resolvedYKeys = yKey\n ? Array.isArray(yKey)\n ? yKey\n : [yKey]\n : detected.yFields;\n\n const { xData: rawXData, yDataMap: rawYDataMap } = extractFromJson(\n jsonData,\n resolvedXKey,\n resolvedYKeys,\n );\n\n let xData = toChartArray(rawXData);\n let yDataMap: Record<string, (string | number)[]> = {};\n for (const key of resolvedYKeys) {\n yDataMap[key] = toChartArray(rawYDataMap[key] ?? []);\n }\n\n if (detected.chartType === \"timeseries\") {\n ({ xData, yDataMap } = sortTimeSeriesAscending(\n xData,\n yDataMap,\n resolvedYKeys,\n ));\n }\n\n return {\n xData,\n yDataMap,\n xField: resolvedXKey,\n yFields: resolvedYKeys,\n chartType: detected.chartType,\n };\n}\n\n// ============================================================================\n// Heatmap Data Normalization\n// ============================================================================\n\n/**\n * Normalized data for heatmap charts.\n * Extends base (not NormalizedChartData) because heatmaps don't use yDataMap.\n * Instead, they use heatmapData which contains [xIndex, yIndex, value] tuples.\n */\nexport interface NormalizedHeatmapData extends NormalizedChartDataBase {\n /** Y-axis categories (rows) */\n yAxisData: (string | number)[];\n /** Heatmap data as [xIndex, yIndex, value] tuples */\n heatmapData: [number, number, number][];\n /** Min value in the data */\n min: number;\n /** Max value in the data */\n max: number;\n}\n\n/**\n * Normalizes data specifically for heatmap charts.\n * Expects data in format: `{ xKey: string, yAxisKey: string, valueKey: number }`\n *\n * @param data - Raw data (Arrow Table or JSON array)\n * @param xKey - Field key for X-axis (columns)\n * @param yAxisKey - Field key for Y-axis (rows)\n * @param valueKey - Field key for the cell values\n */\nexport function normalizeHeatmapData(\n data: ChartData,\n xKey?: string,\n yAxisKey?: string,\n valueKey?: string | string[],\n): NormalizedHeatmapData {\n // First, get the standard normalization\n const jsonData = isArrowTable(data)\n ? extractJsonFromArrow(data)\n : (data as Record<string, unknown>[]);\n\n if (jsonData.length === 0) {\n return {\n xData: [],\n xField: xKey ?? \"x\",\n yFields: [],\n chartType: \"categorical\",\n yAxisData: [],\n heatmapData: [],\n min: 0,\n max: 0,\n };\n }\n\n // Detect fields if not provided\n const keys = Object.keys(jsonData[0]);\n const resolvedXKey = xKey ?? keys[0];\n const resolvedYAxisKey = yAxisKey ?? keys[1];\n const resolvedValueKey = valueKey\n ? Array.isArray(valueKey)\n ? valueKey[0]\n : valueKey\n : keys[2];\n\n // Extract unique X and Y categories\n const xSet = new Set<string | number>();\n const ySet = new Set<string | number>();\n\n for (const row of jsonData) {\n const xVal = jsonValueToChartValue(row[resolvedXKey], false, false);\n const yVal = jsonValueToChartValue(row[resolvedYAxisKey], false, false);\n xSet.add(xVal);\n ySet.add(yVal);\n }\n\n const xData = Array.from(xSet);\n const yAxisData = Array.from(ySet);\n\n // Create index maps for fast lookup\n const xIndexMap = new Map<string | number, number>();\n const yIndexMap = new Map<string | number, number>();\n xData.forEach((v, i) => {\n xIndexMap.set(v, i);\n });\n yAxisData.forEach((v, i) => {\n yIndexMap.set(v, i);\n });\n\n // Build heatmap data and track min/max\n const heatmapData: [number, number, number][] = [];\n let min = Number.POSITIVE_INFINITY;\n let max = Number.NEGATIVE_INFINITY;\n\n for (const row of jsonData) {\n const xVal = jsonValueToChartValue(row[resolvedXKey], false, false);\n const yVal = jsonValueToChartValue(row[resolvedYAxisKey], false, false);\n const value = jsonValueToChartValue(row[resolvedValueKey], true, false);\n\n const xIdx = xIndexMap.get(xVal);\n const yIdx = yIndexMap.get(yVal);\n const numValue = typeof value === \"number\" ? value : 0;\n\n if (xIdx !== undefined && yIdx !== undefined) {\n heatmapData.push([xIdx, yIdx, numValue]);\n min = Math.min(min, numValue);\n max = Math.max(max, numValue);\n }\n }\n\n // Handle edge case where no valid data was found\n if (heatmapData.length === 0) {\n min = 0;\n max = 0;\n }\n\n return {\n xData,\n xField: resolvedXKey,\n yFields: [resolvedValueKey],\n chartType: \"categorical\",\n yAxisData,\n heatmapData,\n min,\n max,\n };\n}\n\n/**\n * Helper to extract JSON array from Arrow table for heatmap processing.\n */\nfunction extractJsonFromArrow(table: Table): Record<string, unknown>[] {\n const result: Record<string, unknown>[] = [];\n const fields = table.schema.fields.map((f) => f.name);\n\n for (let i = 0; i < table.numRows; i++) {\n const row: Record<string, unknown> = {};\n for (const field of fields) {\n const col = table.getChild(field);\n row[field] = col?.get(i);\n }\n result.push(row);\n }\n\n return result;\n}\n"],"mappings":"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"}
@@ -1,28 +1,17 @@
1
1
  import { DonutChartProps, PieChartProps } from "../types.js";
2
+ import "react";
2
3
  import * as react_jsx_runtime279 from "react/jsx-runtime";
3
4
 
4
5
  //#region src/react/charts/pie/index.d.ts
5
6
 
6
7
  /**
7
- * Pie Chart component.
8
- * Supports both JSON and Arrow data formats with automatic format selection.
8
+ * Pie Chart component for proportional data visualization.
9
9
  *
10
- * @example Simple usage
11
- * ```tsx
12
- * <PieChart
13
- * queryKey="market_share"
14
- * parameters={{ category: "tech" }}
15
- * />
16
- * ```
10
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
17
11
  *
18
- * @example With custom labels
19
- * ```tsx
20
- * <PieChart
21
- * queryKey="distribution"
22
- * showLabels={true}
23
- * labelPosition="inside"
24
- * />
25
- * ```
12
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
13
+ *
14
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
26
15
  */
27
16
  declare const PieChart: {
28
17
  (props: PieChartProps): react_jsx_runtime279.JSX.Element;
@@ -30,23 +19,12 @@ declare const PieChart: {
30
19
  };
31
20
  /**
32
21
  * Donut Chart component (Pie chart with inner radius).
33
- * Supports both JSON and Arrow data formats with automatic format selection.
34
22
  *
35
- * @example Simple usage
36
- * ```tsx
37
- * <DonutChart
38
- * queryKey="budget_allocation"
39
- * parameters={{ year: 2024 }}
40
- * />
41
- * ```
23
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
24
+ *
25
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
42
26
  *
43
- * @example Custom inner radius
44
- * ```tsx
45
- * <DonutChart
46
- * queryKey="progress"
47
- * innerRadius={60}
48
- * />
49
- * ```
27
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
50
28
  */
51
29
  declare const DonutChart: {
52
30
  (props: DonutChartProps): react_jsx_runtime279.JSX.Element;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/pie/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAwBA;;;;;AAsBA;;;;;;;;;;;;;cAtBa;;;;;;;;;;;;;;;;;;;;;;;;cAsBA"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/pie/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;;;;AAWA;AAA6E,cAXhE,QAWgE,EAAA;;;;;;;;;;;;;cAAhE"}
@@ -2,46 +2,23 @@ import { createChart } from "../create-chart.js";
2
2
 
3
3
  //#region src/react/charts/pie/index.tsx
4
4
  /**
5
- * Pie Chart component.
6
- * Supports both JSON and Arrow data formats with automatic format selection.
5
+ * Pie Chart component for proportional data visualization.
7
6
  *
8
- * @example Simple usage
9
- * ```tsx
10
- * <PieChart
11
- * queryKey="market_share"
12
- * parameters={{ category: "tech" }}
13
- * />
14
- * ```
7
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
15
8
  *
16
- * @example With custom labels
17
- * ```tsx
18
- * <PieChart
19
- * queryKey="distribution"
20
- * showLabels={true}
21
- * labelPosition="inside"
22
- * />
23
- * ```
9
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
10
+ *
11
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
24
12
  */
25
13
  const PieChart = createChart("pie", "PieChart");
26
14
  /**
27
15
  * Donut Chart component (Pie chart with inner radius).
28
- * Supports both JSON and Arrow data formats with automatic format selection.
29
16
  *
30
- * @example Simple usage
31
- * ```tsx
32
- * <DonutChart
33
- * queryKey="budget_allocation"
34
- * parameters={{ year: 2024 }}
35
- * />
36
- * ```
17
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
18
+ *
19
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
37
20
  *
38
- * @example Custom inner radius
39
- * ```tsx
40
- * <DonutChart
41
- * queryKey="progress"
42
- * innerRadius={60}
43
- * />
44
- * ```
21
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
45
22
  */
46
23
  const DonutChart = createChart("donut", "DonutChart");
47
24
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/pie/index.tsx"],"sourcesContent":["import { createChart } from \"../create-chart\";\nimport type { DonutChartProps, PieChartProps } from \"../types\";\n\n/**\n * Pie Chart component.\n * Supports both JSON and Arrow data formats with automatic format selection.\n *\n * @example Simple usage\n * ```tsx\n * <PieChart\n * queryKey=\"market_share\"\n * parameters={{ category: \"tech\" }}\n * />\n * ```\n *\n * @example With custom labels\n * ```tsx\n * <PieChart\n * queryKey=\"distribution\"\n * showLabels={true}\n * labelPosition=\"inside\"\n * />\n * ```\n */\nexport const PieChart = createChart<PieChartProps>(\"pie\", \"PieChart\");\n\n/**\n * Donut Chart component (Pie chart with inner radius).\n * Supports both JSON and Arrow data formats with automatic format selection.\n *\n * @example Simple usage\n * ```tsx\n * <DonutChart\n * queryKey=\"budget_allocation\"\n * parameters={{ year: 2024 }}\n * />\n * ```\n *\n * @example Custom inner radius\n * ```tsx\n * <DonutChart\n * queryKey=\"progress\"\n * innerRadius={60}\n * />\n * ```\n */\nexport const DonutChart = createChart<DonutChartProps>(\"donut\", \"DonutChart\");\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,WAAW,YAA2B,OAAO,WAAW;;;;;;;;;;;;;;;;;;;;;AAsBrE,MAAa,aAAa,YAA6B,SAAS,aAAa"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/pie/index.tsx"],"sourcesContent":["import type { JSX } from \"react\";\nimport { createChart } from \"../create-chart\";\nimport type { DonutChartProps, PieChartProps } from \"../types\";\n\n/**\n * Pie Chart component for proportional data visualization.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport const PieChart = createChart<PieChartProps>(\"pie\", \"PieChart\");\n\n/**\n * Donut Chart component (Pie chart with inner radius).\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport const DonutChart = createChart<DonutChartProps>(\"donut\", \"DonutChart\");\n\n// Type-only definitions for documentation generation (not used at runtime)\n/**\n * Pie Chart component for proportional data visualization.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport function PieChartDoc(props: PieChartProps): JSX.Element {\n return PieChart(props);\n}\n\n/**\n * Donut Chart component (Pie chart with inner radius).\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport function DonutChartDoc(props: DonutChartProps): JSX.Element {\n return DonutChart(props);\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,WAAW,YAA2B,OAAO,WAAW;;;;;;;;;;AAWrE,MAAa,aAAa,YAA6B,SAAS,aAAa"}
@@ -1,27 +1,17 @@
1
1
  import { RadarChartProps } from "../types.js";
2
+ import "react";
2
3
  import * as react_jsx_runtime281 from "react/jsx-runtime";
3
4
 
4
5
  //#region src/react/charts/radar/index.d.ts
5
6
 
6
7
  /**
7
- * Radar Chart component.
8
- * Supports both JSON and Arrow data formats with automatic format selection.
8
+ * Radar Chart component for multi-dimensional data comparison.
9
9
  *
10
- * @example Simple usage
11
- * ```tsx
12
- * <RadarChart
13
- * queryKey="skills_assessment"
14
- * parameters={{ userId: "123" }}
15
- * />
16
- * ```
10
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
17
11
  *
18
- * @example With custom styling
19
- * ```tsx
20
- * <RadarChart
21
- * queryKey="performance_metrics"
22
- * showArea={true}
23
- * />
24
- * ```
12
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
13
+ *
14
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
25
15
  */
26
16
  declare const RadarChart: {
27
17
  (props: RadarChartProps): react_jsx_runtime281.JSX.Element;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/radar/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAuBA;;;;;;;;;;;;;;;;;cAAa"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/radar/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;;;;;cAAa"}
@@ -2,24 +2,13 @@ import { createChart } from "../create-chart.js";
2
2
 
3
3
  //#region src/react/charts/radar/index.tsx
4
4
  /**
5
- * Radar Chart component.
6
- * Supports both JSON and Arrow data formats with automatic format selection.
5
+ * Radar Chart component for multi-dimensional data comparison.
7
6
  *
8
- * @example Simple usage
9
- * ```tsx
10
- * <RadarChart
11
- * queryKey="skills_assessment"
12
- * parameters={{ userId: "123" }}
13
- * />
14
- * ```
7
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
15
8
  *
16
- * @example With custom styling
17
- * ```tsx
18
- * <RadarChart
19
- * queryKey="performance_metrics"
20
- * showArea={true}
21
- * />
22
- * ```
9
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
10
+ *
11
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
23
12
  */
24
13
  const RadarChart = createChart("radar", "RadarChart");
25
14
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/radar/index.tsx"],"sourcesContent":["import { createChart } from \"../create-chart\";\nimport type { RadarChartProps } from \"../types\";\n\n/**\n * Radar Chart component.\n * Supports both JSON and Arrow data formats with automatic format selection.\n *\n * @example Simple usage\n * ```tsx\n * <RadarChart\n * queryKey=\"skills_assessment\"\n * parameters={{ userId: \"123\" }}\n * />\n * ```\n *\n * @example With custom styling\n * ```tsx\n * <RadarChart\n * queryKey=\"performance_metrics\"\n * showArea={true}\n * />\n * ```\n */\nexport const RadarChart = createChart<RadarChartProps>(\"radar\", \"RadarChart\");\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,aAAa,YAA6B,SAAS,aAAa"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/radar/index.tsx"],"sourcesContent":["import type { JSX } from \"react\";\nimport { createChart } from \"../create-chart\";\nimport type { RadarChartProps } from \"../types\";\n\n/**\n * Radar Chart component for multi-dimensional data comparison.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport const RadarChart = createChart<RadarChartProps>(\"radar\", \"RadarChart\");\n\n// Type-only definition for documentation generation (not used at runtime)\n/**\n * Radar Chart component for multi-dimensional data comparison.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport function RadarChartDoc(props: RadarChartProps): JSX.Element {\n return RadarChart(props);\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,aAAa,YAA6B,SAAS,aAAa"}
@@ -1,27 +1,17 @@
1
1
  import { ScatterChartProps } from "../types.js";
2
+ import "react";
2
3
  import * as react_jsx_runtime282 from "react/jsx-runtime";
3
4
 
4
5
  //#region src/react/charts/scatter/index.d.ts
5
6
 
6
7
  /**
7
- * Scatter Chart component.
8
- * Supports both JSON and Arrow data formats with automatic format selection.
8
+ * Scatter Chart component for correlation and distribution visualization.
9
9
  *
10
- * @example Simple usage
11
- * ```tsx
12
- * <ScatterChart
13
- * queryKey="correlation_data"
14
- * parameters={{ metrics: ["revenue", "growth"] }}
15
- * />
16
- * ```
10
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
17
11
  *
18
- * @example With custom symbol size
19
- * ```tsx
20
- * <ScatterChart
21
- * queryKey="data_points"
22
- * symbolSize={12}
23
- * />
24
- * ```
12
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
13
+ *
14
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
25
15
  */
26
16
  declare const ScatterChart: {
27
17
  (props: ScatterChartProps): react_jsx_runtime282.JSX.Element;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/scatter/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAuBA;;;;;;;;;;;;;;;;;cAAa"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/react/charts/scatter/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;;;;;cAAa"}
@@ -2,24 +2,13 @@ import { createChart } from "../create-chart.js";
2
2
 
3
3
  //#region src/react/charts/scatter/index.tsx
4
4
  /**
5
- * Scatter Chart component.
6
- * Supports both JSON and Arrow data formats with automatic format selection.
5
+ * Scatter Chart component for correlation and distribution visualization.
7
6
  *
8
- * @example Simple usage
9
- * ```tsx
10
- * <ScatterChart
11
- * queryKey="correlation_data"
12
- * parameters={{ metrics: ["revenue", "growth"] }}
13
- * />
14
- * ```
7
+ * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.
15
8
  *
16
- * @example With custom symbol size
17
- * ```tsx
18
- * <ScatterChart
19
- * queryKey="data_points"
20
- * symbolSize={12}
21
- * />
22
- * ```
9
+ * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.
10
+ *
11
+ * Supports both query mode (queryKey + parameters) and data mode (static data).
23
12
  */
24
13
  const ScatterChart = createChart("scatter", "ScatterChart");
25
14
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/scatter/index.tsx"],"sourcesContent":["import { createChart } from \"../create-chart\";\nimport type { ScatterChartProps } from \"../types\";\n\n/**\n * Scatter Chart component.\n * Supports both JSON and Arrow data formats with automatic format selection.\n *\n * @example Simple usage\n * ```tsx\n * <ScatterChart\n * queryKey=\"correlation_data\"\n * parameters={{ metrics: [\"revenue\", \"growth\"] }}\n * />\n * ```\n *\n * @example With custom symbol size\n * ```tsx\n * <ScatterChart\n * queryKey=\"data_points\"\n * symbolSize={12}\n * />\n * ```\n */\nexport const ScatterChart = createChart<ScatterChartProps>(\n \"scatter\",\n \"ScatterChart\",\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,eAAe,YAC1B,WACA,eACD"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/react/charts/scatter/index.tsx"],"sourcesContent":["import type { JSX } from \"react\";\nimport { createChart } from \"../create-chart\";\nimport type { ScatterChartProps } from \"../types\";\n\n/**\n * Scatter Chart component for correlation and distribution visualization.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport const ScatterChart = createChart<ScatterChartProps>(\n \"scatter\",\n \"ScatterChart\",\n);\n\n// Type-only definition for documentation generation (not used at runtime)\n/**\n * Scatter Chart component for correlation and distribution visualization.\n *\n * **Important:** This component uses Apache ECharts architecture. Configure it via props, not by passing child components.\n *\n * **Best Practice:** Use the built-in data fetching by passing `queryKey` and `parameters` props instead of pre-fetching data with `useAnalyticsQuery`.\n *\n * Supports both query mode (queryKey + parameters) and data mode (static data).\n */\nexport function ScatterChartDoc(props: ScatterChartProps): JSX.Element {\n return ScatterChart(props);\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,eAAe,YAC1B,WACA,eACD"}
@@ -57,11 +57,6 @@ interface QueryProps extends ChartBaseProps {
57
57
  format?: DataFormat;
58
58
  /** Transform raw data before rendering */
59
59
  transformer?: <T>(data: T) => T;
60
- /**
61
- * Whether to execute the query as the current user
62
- * @default false
63
- */
64
- asUser?: boolean;
65
60
  data?: never;
66
61
  }
67
62
  /** Props for direct data injection */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/charts/types.ts"],"sourcesContent":[],"mappings":";;;;KAOY,UAAA;AAAZ;AAGY,KAAA,WAAA,GAAW,UAAA,GAAA,YAAA;AAGvB;AAWY,KAXA,SAAA,GAWS,KAAA,GAAA,MAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA;;AAAG,KAAZ,SAAA,GAAY,KAAA,GAAQ,MAAR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA;;AAAc,KAO1B,iBAAA,GAP0B,aAAA,GAAA,YAAA,GAAA,WAAA;AAOtC;AAGiB,UAAA,cAAA,CAAc;EAAA;OAWd,CAAA,EAAA,MAAA;;EAmBC,UAAA,CAAA,EAAA,OAAA;EAQD;;;;;;cAAmB,CAAA,EA3BnB,iBA2BmB;EAAc;EA8BjC,MAAA,CAAA,EAAA,MAAU,EAAA;EAAA;QAEnB,CAAA,EAAA,MAAA;;EAFyC,SAAA,CAAA,EAAA,MAAA;EAgBrC;EAAiB,IAAA,CAAA,EAAA,MAAA;;MAAgB,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAAS;EAOrC,SAAA,CAAA,EAAA,MAAA;EAQA;EAUA,MAAA,CAAA,EAAA,MAAA;EAYA;EAMA,OAAA,CAAA,EAjGL,MAiGK,CAAA,MAAA,EAAqB,OAAA,CAAA;AAUtC;AAMA;AAkBY,UA3HK,UAAA,SAAmB,cA2HX,CAAA;EAAA;UAAI,EAAA,MAAA;;YAA0B,CAAA,EAvHxC,MAuHwC,CAAA,MAAA,EAAA,OAAA,CAAA;EAAqB;AAC5E;;;;;;EACY,MAAA,CAAA,EAjHD,UAiHe;EAAA;aAAI,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EA/GJ,CA+GI,EAAA,GA/GE,CA+GF;;;;AAC9B;EAA6B,MAAA,CAAA,EAAA,OAAA;MAAI,CAAA,EAAA,KAAA;;;AACN,UAjGV,SAAA,SAAkB,cAiGR,CAAA;EACf;EAAa,IAAA,EAhGjB,SAgGiB;UAAI,CAAA,EAAA,KAAA;YAAa,CAAA,EAAA,KAAA;QAAa,CAAA,EAAA,KAAA;EAAqB,WAAA,CAAA,EAAA,KAAA;AAC5E;;AAA+B,KAnFnB,iBAAA,GAAoB,UAmFD,GAnFc,SAmFd;;AAA0B,UA5ExC,qBAAA,CA4EwC;EAAqB;EAClE,WAAA,CAAA,EA3EI,WA2EW;EAAA;SAAI,CAAA,EAAA,OAAA;;;AACN,UAtER,sBAAA,CAsEQ;EACb;EAAiB,WAAA,CAAA,EArEb,WAqEa;;YAAiB,CAAA,EAAA,OAAA;;EACnB,MAAA,CAAA,EAAA,OAAA;AAO3B;AAQA;AAAqC,UA7EpB,sBAAA,CA6EoB;;aAAQ,CAAA,EA3E7B,WA2E6B;EAAuB;EAKpD,UAAA,CAAA,EAAA,OAAY;EAAA;QAAO,CAAA,EAAA,OAAA;;EAAyB,OAAA,CAAA,EAAA,OAAA;AAW5D;;AAAoC,UAjFnB,yBAAA,CAiFmB;;EAAuC,UAAA,CAAA,EAAA,MAAA;AAS3E;;AAAmC,UApFlB,qBAAA,CAoFkB;;EAAsC,WAAA,CAAA,EAAA,MAAA;;;;;;;UA1ExD,uBAAA;;;;;UAMA,yBAAA;;;;;;;;;;;;;KAkBL,aAAA,IAAiB,aAAa,aAAa;KAC3C,cAAA,IAAkB,aAAa,aAAa;KAC5C,cAAA,IAAkB,aAAa,aAAa;KAC5C,iBAAA,IAAqB,aAAa,aAC5C;KACU,aAAA,IAAiB,aAAa,aAAa;KAC3C,eAAA,IAAmB,aAAa,aAAa;KAC7C,eAAA,IAAmB,aAAa,aAC1C;KACU,iBAAA,IAAqB,aAAa,aAC5C;;UAOe,uBAAA;;;;;;;UAQA,mBAAA,SAA4B;YACjC;;;iBAII,YAAA,OAAmB,oBAAoB;;iBAWvC,YAAA,QAAoB,6BAA6B;;iBASjD,WAAA,QAAmB,6BAA6B"}
1
+ {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/charts/types.ts"],"sourcesContent":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","names":[],"sources":["../../../src/react/charts/types.ts"],"sourcesContent":["import type { Table } from \"apache-arrow\";\n\n// ============================================================================\n// Data Format Types\n// ============================================================================\n\n/** Supported data formats for analytics queries */\nexport type DataFormat = \"json\" | \"arrow\" | \"auto\";\n\n/** Chart orientation */\nexport type Orientation = \"vertical\" | \"horizontal\";\n\n/** Supported chart types */\nexport type ChartType =\n | \"bar\"\n | \"line\"\n | \"area\"\n | \"pie\"\n | \"donut\"\n | \"scatter\"\n | \"radar\"\n | \"heatmap\";\n\n/** Data that can be passed to unified charts */\nexport type ChartData = Table | Record<string, unknown>[];\n\n// ============================================================================\n// Base Props (shared by all charts)\n// ============================================================================\n\n/** Color palette types for different visualization needs */\nexport type ChartColorPalette = \"categorical\" | \"sequential\" | \"diverging\";\n\n/** Common visual and behavior props for all charts */\nexport interface ChartBaseProps {\n /** Chart title */\n title?: string;\n /** Show legend */\n showLegend?: boolean;\n /**\n * Color palette to use. Auto-selected based on chart type if not specified.\n * - \"categorical\": Distinct colors for different categories (bar, pie, line)\n * - \"sequential\": Gradient for magnitude/intensity (heatmap)\n * - \"diverging\": Two-tone for positive/negative values\n */\n colorPalette?: ChartColorPalette;\n /** Custom colors for series (overrides colorPalette) */\n colors?: string[];\n /** Chart height in pixels @default 300 */\n height?: number;\n /** Additional CSS classes */\n className?: string;\n\n /** X-axis field key. Auto-detected from schema if not provided. */\n xKey?: string;\n /** Y-axis field key(s). Auto-detected from schema if not provided. */\n yKey?: string | string[];\n\n /** Accessibility label for screen readers */\n ariaLabel?: string;\n /** Test ID for automated testing */\n testId?: string;\n\n /** Additional ECharts options to merge */\n options?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Query-based Props (chart fetches data)\n// ============================================================================\n\n/** Props for query-based data fetching */\nexport interface QueryProps extends ChartBaseProps {\n /** Analytics query key registered with analytics plugin */\n queryKey: string;\n /** Query parameters passed to the analytics endpoint */\n parameters?: Record<string, unknown>;\n /**\n * Data format to use\n * - \"json\": Use JSON format (smaller payloads, simpler)\n * - \"arrow\": Use Arrow format (faster for large datasets)\n * - \"auto\": Automatically select based on expected data size\n * @default \"auto\"\n */\n format?: DataFormat;\n /** Transform raw data before rendering */\n transformer?: <T>(data: T) => T;\n /**\n * Whether to execute the query as the current user\n * @default false\n */\n asUser?: boolean;\n\n // Discriminator: cannot use direct data with query\n data?: never;\n}\n\n// ============================================================================\n// Data-based Props (chart receives data externally)\n// ============================================================================\n\n/** Props for direct data injection */\nexport interface DataProps extends ChartBaseProps {\n /** Arrow Table or JSON array */\n data: ChartData;\n\n // Discriminator: cannot use query props with direct data\n queryKey?: never;\n parameters?: never;\n format?: never;\n transformer?: never;\n}\n\n// ============================================================================\n// Union Types for Each Chart\n// ============================================================================\n\n/** Base union type - either query-based or data-based */\nexport type UnifiedChartProps = QueryProps | DataProps;\n\n// ============================================================================\n// Chart-Specific Props\n// ============================================================================\n\n/** Props specific to bar charts */\nexport interface BarChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Stack bars */\n stacked?: boolean;\n}\n\n/** Props specific to line charts */\nexport interface LineChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Show data point symbols @default false */\n showSymbol?: boolean;\n /** Smooth line curves @default true */\n smooth?: boolean;\n}\n\n/** Props specific to area charts */\nexport interface AreaChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Show data point symbols @default false */\n showSymbol?: boolean;\n /** Smooth line curves @default true */\n smooth?: boolean;\n /** Stack areas @default false */\n stacked?: boolean;\n}\n\n/** Props specific to scatter charts */\nexport interface ScatterChartSpecificProps {\n /** Symbol size @default 8 */\n symbolSize?: number;\n}\n\n/** Props specific to pie/donut charts */\nexport interface PieChartSpecificProps {\n /** Inner radius for donut charts (0-100%) @default 0 */\n innerRadius?: number;\n /** Show labels on slices @default true */\n showLabels?: boolean;\n /** Label position @default \"outside\" */\n labelPosition?: \"outside\" | \"inside\" | \"center\";\n}\n\n/** Props specific to radar charts */\nexport interface RadarChartSpecificProps {\n /** Show area fill @default true */\n showArea?: boolean;\n}\n\n/** Props specific to heatmap charts */\nexport interface HeatmapChartSpecificProps {\n /**\n * Field key for the Y-axis categories.\n * For heatmaps, data should have: xKey (column), yAxisKey (row), and yKey (value).\n */\n yAxisKey?: string;\n /** Min value for color scale (auto-detected if not provided) */\n min?: number;\n /** Max value for color scale (auto-detected if not provided) */\n max?: number;\n /** Show value labels on cells @default false */\n showLabels?: boolean;\n}\n\n// ============================================================================\n// Complete Chart Props (union + specific)\n// ============================================================================\n\nexport type BarChartProps = (QueryProps | DataProps) & BarChartSpecificProps;\nexport type LineChartProps = (QueryProps | DataProps) & LineChartSpecificProps;\nexport type AreaChartProps = (QueryProps | DataProps) & AreaChartSpecificProps;\nexport type ScatterChartProps = (QueryProps | DataProps) &\n ScatterChartSpecificProps;\nexport type PieChartProps = (QueryProps | DataProps) & PieChartSpecificProps;\nexport type DonutChartProps = (QueryProps | DataProps) & PieChartSpecificProps;\nexport type RadarChartProps = (QueryProps | DataProps) &\n RadarChartSpecificProps;\nexport type HeatmapChartProps = (QueryProps | DataProps) &\n HeatmapChartSpecificProps;\n\n// ============================================================================\n// Internal Types\n// ============================================================================\n\n/** Base normalized data shared by all chart types */\nexport interface NormalizedChartDataBase {\n xData: (string | number)[];\n xField: string;\n yFields: string[];\n chartType: \"timeseries\" | \"categorical\";\n}\n\n/** Normalized chart data for rendering (standard charts) */\nexport interface NormalizedChartData extends NormalizedChartDataBase {\n yDataMap: Record<string, (string | number)[]>;\n}\n\n/** Type guard to check if data is an Arrow Table */\nexport function isArrowTable(data: ChartData): data is Table {\n return (\n data !== null &&\n typeof data === \"object\" &&\n \"schema\" in data &&\n \"numRows\" in data &&\n typeof (data as Table).getChild === \"function\"\n );\n}\n\n/** Type guard to check if props are query-based */\nexport function isQueryProps(props: UnifiedChartProps): props is QueryProps {\n return (\n \"queryKey\" in props &&\n typeof props.queryKey === \"string\" &&\n props.queryKey.length > 0\n );\n}\n\n/** Type guard to check if props are data-based */\nexport function isDataProps(props: UnifiedChartProps): props is DataProps {\n return \"data\" in props && props.data != null;\n}\n"],"mappings":";;AAiOA,SAAgB,aAAa,MAAgC;AAC3D,QACE,SAAS,QACT,OAAO,SAAS,YAChB,YAAY,QACZ,aAAa,QACb,OAAQ,KAAe,aAAa;;;AAKxC,SAAgB,aAAa,OAA+C;AAC1E,QACE,cAAc,SACd,OAAO,MAAM,aAAa,YAC1B,MAAM,SAAS,SAAS;;;AAK5B,SAAgB,YAAY,OAA8C;AACxE,QAAO,UAAU,SAAS,MAAM,QAAQ"}
1
+ {"version":3,"file":"types.js","names":[],"sources":["../../../src/react/charts/types.ts"],"sourcesContent":["import type { Table } from \"apache-arrow\";\n\n// ============================================================================\n// Data Format Types\n// ============================================================================\n\n/** Supported data formats for analytics queries */\nexport type DataFormat = \"json\" | \"arrow\" | \"auto\";\n\n/** Chart orientation */\nexport type Orientation = \"vertical\" | \"horizontal\";\n\n/** Supported chart types */\nexport type ChartType =\n | \"bar\"\n | \"line\"\n | \"area\"\n | \"pie\"\n | \"donut\"\n | \"scatter\"\n | \"radar\"\n | \"heatmap\";\n\n/** Data that can be passed to unified charts */\nexport type ChartData = Table | Record<string, unknown>[];\n\n// ============================================================================\n// Base Props (shared by all charts)\n// ============================================================================\n\n/** Color palette types for different visualization needs */\nexport type ChartColorPalette = \"categorical\" | \"sequential\" | \"diverging\";\n\n/** Common visual and behavior props for all charts */\nexport interface ChartBaseProps {\n /** Chart title */\n title?: string;\n /** Show legend */\n showLegend?: boolean;\n /**\n * Color palette to use. Auto-selected based on chart type if not specified.\n * - \"categorical\": Distinct colors for different categories (bar, pie, line)\n * - \"sequential\": Gradient for magnitude/intensity (heatmap)\n * - \"diverging\": Two-tone for positive/negative values\n */\n colorPalette?: ChartColorPalette;\n /** Custom colors for series (overrides colorPalette) */\n colors?: string[];\n /** Chart height in pixels @default 300 */\n height?: number;\n /** Additional CSS classes */\n className?: string;\n\n /** X-axis field key. Auto-detected from schema if not provided. */\n xKey?: string;\n /** Y-axis field key(s). Auto-detected from schema if not provided. */\n yKey?: string | string[];\n\n /** Accessibility label for screen readers */\n ariaLabel?: string;\n /** Test ID for automated testing */\n testId?: string;\n\n /** Additional ECharts options to merge */\n options?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Query-based Props (chart fetches data)\n// ============================================================================\n\n/** Props for query-based data fetching */\nexport interface QueryProps extends ChartBaseProps {\n /** Analytics query key registered with analytics plugin */\n queryKey: string;\n /** Query parameters passed to the analytics endpoint */\n parameters?: Record<string, unknown>;\n /**\n * Data format to use\n * - \"json\": Use JSON format (smaller payloads, simpler)\n * - \"arrow\": Use Arrow format (faster for large datasets)\n * - \"auto\": Automatically select based on expected data size\n * @default \"auto\"\n */\n format?: DataFormat;\n /** Transform raw data before rendering */\n transformer?: <T>(data: T) => T;\n // Discriminator: cannot use direct data with query\n data?: never;\n}\n\n// ============================================================================\n// Data-based Props (chart receives data externally)\n// ============================================================================\n\n/** Props for direct data injection */\nexport interface DataProps extends ChartBaseProps {\n /** Arrow Table or JSON array */\n data: ChartData;\n\n // Discriminator: cannot use query props with direct data\n queryKey?: never;\n parameters?: never;\n format?: never;\n transformer?: never;\n}\n\n// ============================================================================\n// Union Types for Each Chart\n// ============================================================================\n\n/** Base union type - either query-based or data-based */\nexport type UnifiedChartProps = QueryProps | DataProps;\n\n// ============================================================================\n// Chart-Specific Props\n// ============================================================================\n\n/** Props specific to bar charts */\nexport interface BarChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Stack bars */\n stacked?: boolean;\n}\n\n/** Props specific to line charts */\nexport interface LineChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Show data point symbols @default false */\n showSymbol?: boolean;\n /** Smooth line curves @default true */\n smooth?: boolean;\n}\n\n/** Props specific to area charts */\nexport interface AreaChartSpecificProps {\n /** Chart orientation @default \"vertical\" */\n orientation?: Orientation;\n /** Show data point symbols @default false */\n showSymbol?: boolean;\n /** Smooth line curves @default true */\n smooth?: boolean;\n /** Stack areas @default false */\n stacked?: boolean;\n}\n\n/** Props specific to scatter charts */\nexport interface ScatterChartSpecificProps {\n /** Symbol size @default 8 */\n symbolSize?: number;\n}\n\n/** Props specific to pie/donut charts */\nexport interface PieChartSpecificProps {\n /** Inner radius for donut charts (0-100%) @default 0 */\n innerRadius?: number;\n /** Show labels on slices @default true */\n showLabels?: boolean;\n /** Label position @default \"outside\" */\n labelPosition?: \"outside\" | \"inside\" | \"center\";\n}\n\n/** Props specific to radar charts */\nexport interface RadarChartSpecificProps {\n /** Show area fill @default true */\n showArea?: boolean;\n}\n\n/** Props specific to heatmap charts */\nexport interface HeatmapChartSpecificProps {\n /**\n * Field key for the Y-axis categories.\n * For heatmaps, data should have: xKey (column), yAxisKey (row), and yKey (value).\n */\n yAxisKey?: string;\n /** Min value for color scale (auto-detected if not provided) */\n min?: number;\n /** Max value for color scale (auto-detected if not provided) */\n max?: number;\n /** Show value labels on cells @default false */\n showLabels?: boolean;\n}\n\n// ============================================================================\n// Complete Chart Props (union + specific)\n// ============================================================================\n\nexport type BarChartProps = (QueryProps | DataProps) & BarChartSpecificProps;\nexport type LineChartProps = (QueryProps | DataProps) & LineChartSpecificProps;\nexport type AreaChartProps = (QueryProps | DataProps) & AreaChartSpecificProps;\nexport type ScatterChartProps = (QueryProps | DataProps) &\n ScatterChartSpecificProps;\nexport type PieChartProps = (QueryProps | DataProps) & PieChartSpecificProps;\nexport type DonutChartProps = (QueryProps | DataProps) & PieChartSpecificProps;\nexport type RadarChartProps = (QueryProps | DataProps) &\n RadarChartSpecificProps;\nexport type HeatmapChartProps = (QueryProps | DataProps) &\n HeatmapChartSpecificProps;\n\n// ============================================================================\n// Internal Types\n// ============================================================================\n\n/** Base normalized data shared by all chart types */\nexport interface NormalizedChartDataBase {\n xData: (string | number)[];\n xField: string;\n yFields: string[];\n chartType: \"timeseries\" | \"categorical\";\n}\n\n/** Normalized chart data for rendering (standard charts) */\nexport interface NormalizedChartData extends NormalizedChartDataBase {\n yDataMap: Record<string, (string | number)[]>;\n}\n\n/** Type guard to check if data is an Arrow Table */\nexport function isArrowTable(data: ChartData): data is Table {\n return (\n data !== null &&\n typeof data === \"object\" &&\n \"schema\" in data &&\n \"numRows\" in data &&\n typeof (data as Table).getChild === \"function\"\n );\n}\n\n/** Type guard to check if props are query-based */\nexport function isQueryProps(props: UnifiedChartProps): props is QueryProps {\n return (\n \"queryKey\" in props &&\n typeof props.queryKey === \"string\" &&\n props.queryKey.length > 0\n );\n}\n\n/** Type guard to check if props are data-based */\nexport function isDataProps(props: UnifiedChartProps): props is DataProps {\n return \"data\" in props && props.data != null;\n}\n"],"mappings":";;AA2NA,SAAgB,aAAa,MAAgC;AAC3D,QACE,SAAS,QACT,OAAO,SAAS,YAChB,YAAY,QACZ,aAAa,QACb,OAAQ,KAAe,aAAa;;;AAKxC,SAAgB,aAAa,OAA+C;AAC1E,QACE,cAAc,SACd,OAAO,MAAM,aAAa,YAC1B,MAAM,SAAS,SAAS;;;AAK5B,SAAgB,YAAY,OAA8C;AACxE,QAAO,UAAU,SAAS,MAAM,QAAQ"}
@@ -4,8 +4,6 @@ import * as react_jsx_runtime285 from "react/jsx-runtime";
4
4
 
5
5
  //#region src/react/charts/wrapper.d.ts
6
6
  interface ChartWrapperQueryProps {
7
- /** Whether to execute the query as a user. Default is false. */
8
- asUser?: boolean;
9
7
  /** Analytics query key */
10
8
  queryKey: string;
11
9
  /** Query parameters */
@@ -1 +1 @@
1
- {"version":3,"file":"wrapper.d.ts","names":[],"sources":["../../../src/react/charts/wrapper.tsx"],"sourcesContent":[],"mappings":";;;;;UAaU,sBAAA;;;EAAA;EAAsB,QAAA,EAAA,MAAA;;YAQrB,CAAA,EAFI,MAEJ,CAAA,MAAA,EAAA,OAAA,CAAA;;QAEqB,CAAA,EAFrB,UAEqB;EAAC;EAKvB,WAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EALgB,CAKK,EAAA,GALC,CAKD;EAUrB;EAAW,IAAA,CAAA,EAAA,KAAA;;UAVX,qBAAA,CAoBuB;EAAS;EAG9B,IAAA,EArBJ,SAqBI;EAAiB;UAAG,CAAA,EAAA,KAAA;YAC7B,CAAA,EAAA,KAAA;QAAyB,CAAA,EAAA,KAAA;EAAqB,WAAA,CAAA,EAAA,KAAA;AA4GjD;UA1HU,WAAA,CA0HkB;;QAAyB,CAAA,EAAA,MAAA;EAAA;;;;;;;mBAhHlC,cAAc;;KAGrB,iBAAA,GAAoB,eAC7B,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;iBA4GZ,YAAA,QAAoB,oBAAiB,oBAAA,CAAA,GAAA,CAAA"}
1
+ {"version":3,"file":"wrapper.d.ts","names":[],"sources":["../../../src/react/charts/wrapper.tsx"],"sourcesContent":[],"mappings":";;;;;UAaU,sBAAA;;;EAAA;EAAsB,UAAA,CAAA,EAIjB,MAJiB,CAAA,MAAA,EAAA,OAAA,CAAA;;QAMrB,CAAA,EAAA,UAAA;;aAEqB,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EAAN,CAAM,EAAA,GAAA,CAAA;EAAC;EAKvB,IAAA,CAAA,EAAA,KAAA;AAEO;UAFP,qBAAA,CAUW;;MAUY,EAlBzB,SAkByB;EAAS;EAG9B,QAAA,CAAA,EAAA,KAAA;EAAiB,UAAA,CAAA,EAAA,KAAA;QAAG,CAAA,EAAA,KAAA;aAC7B,CAAA,EAAA,KAAA;;UAdO,WAAA,CAcuC;EA0GjC;EAAY,MAAA,CAAA,EAAA,MAAA;;WAAyB,CAAA,EAAA,MAAA;EAAA;;;;;mBA9GlC,cAAc;;KAGrB,iBAAA,GAAoB,eAC7B,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;iBA0GZ,YAAA,QAAoB,oBAAiB,oBAAA,CAAA,GAAA,CAAA"}
@@ -7,13 +7,12 @@ import { LoadingSkeleton } from "./loading.js";
7
7
  import { jsx } from "react/jsx-runtime";
8
8
 
9
9
  //#region src/react/charts/wrapper.tsx
10
- function QueryModeContent({ queryKey, parameters, format, transformer, asUser, height, className, ariaLabel, testId, children }) {
10
+ function QueryModeContent({ queryKey, parameters, format, transformer, height, className, ariaLabel, testId, children }) {
11
11
  const { data, loading, error, isEmpty } = useChartData({
12
12
  queryKey,
13
13
  parameters,
14
14
  format,
15
- transformer,
16
- asUser
15
+ transformer
17
16
  });
18
17
  if (loading) return /* @__PURE__ */ jsx(LoadingSkeleton, { height: height ?? 300 });
19
18
  if (error) return /* @__PURE__ */ jsx(ErrorState, { error });
@@ -81,7 +80,6 @@ function ChartWrapper(props) {
81
80
  parameters: props.parameters,
82
81
  format: props.format,
83
82
  transformer: props.transformer,
84
- asUser: props.asUser,
85
83
  height,
86
84
  className,
87
85
  ariaLabel,
@@ -1 +1 @@
1
- {"version":3,"file":"wrapper.js","names":[],"sources":["../../../src/react/charts/wrapper.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useChartData } from \"../hooks/use-chart-data\";\nimport { ChartErrorBoundary } from \"./chart-error-boundary\";\nimport { EmptyState } from \"./empty\";\nimport { ErrorState } from \"./error\";\nimport { LoadingSkeleton } from \"./loading\";\nimport type { ChartData, DataFormat } from \"./types\";\nimport { isArrowTable } from \"./types\";\n\n// ============================================================================\n// Props Types\n// ============================================================================\n\ninterface ChartWrapperQueryProps {\n /** Whether to execute the query as a user. Default is false. */\n asUser?: boolean;\n /** Analytics query key */\n queryKey: string;\n /** Query parameters */\n parameters?: Record<string, unknown>;\n /** Data format preference */\n format?: DataFormat;\n /** Transform data after fetching */\n transformer?: <T>(data: T) => T;\n /** Direct data - not used in query mode */\n data?: never;\n}\n\ninterface ChartWrapperDataProps {\n /** Direct data (Arrow Table or JSON array) */\n data: ChartData;\n /** Not used in data mode */\n queryKey?: never;\n parameters?: never;\n format?: never;\n transformer?: never;\n}\n\ninterface CommonProps {\n /** Chart height in pixels */\n height?: number;\n /** Additional CSS classes */\n className?: string;\n /** Accessibility label */\n ariaLabel?: string;\n /** Test ID for automated testing */\n testId?: string;\n /** Render function receiving the chart data */\n children: (data: ChartData) => ReactNode;\n}\n\nexport type ChartWrapperProps = CommonProps &\n (ChartWrapperQueryProps | ChartWrapperDataProps);\n\n// ============================================================================\n// Query Mode Content\n// ============================================================================\n\nfunction QueryModeContent({\n queryKey,\n parameters,\n format,\n transformer,\n asUser,\n height,\n className,\n ariaLabel,\n testId,\n children,\n}: CommonProps & ChartWrapperQueryProps) {\n const { data, loading, error, isEmpty } = useChartData({\n queryKey,\n parameters,\n format,\n transformer,\n asUser,\n });\n\n if (loading) return <LoadingSkeleton height={height ?? 300} />;\n if (error) return <ErrorState error={error} />;\n if (isEmpty || !data) return <EmptyState />;\n\n return (\n <ChartErrorBoundary\n fallback={<ErrorState error=\"Failed to render chart\" />}\n >\n <div\n className={className}\n style={{ height }}\n aria-label={ariaLabel}\n data-testid={testId}\n role=\"img\"\n >\n {children(data)}\n </div>\n </ChartErrorBoundary>\n );\n}\n\n// ============================================================================\n// Data Mode Content\n// ============================================================================\n\nfunction DataModeContent({\n data,\n height,\n className,\n ariaLabel,\n testId,\n children,\n}: CommonProps & ChartWrapperDataProps) {\n const isEmpty = isArrowTable(data)\n ? data.numRows === 0\n : !Array.isArray(data) || data.length === 0;\n\n if (isEmpty) return <EmptyState />;\n\n return (\n <ChartErrorBoundary\n fallback={<ErrorState error=\"Failed to render chart\" />}\n >\n <div\n className={className}\n style={{ height }}\n aria-label={ariaLabel}\n data-testid={testId}\n role=\"img\"\n >\n {children(data)}\n </div>\n </ChartErrorBoundary>\n );\n}\n\n// ============================================================================\n// Main Wrapper Component\n// ============================================================================\n\n/**\n * Wrapper component for charts.\n * Handles data fetching (query mode) or direct data injection (data mode).\n *\n * @example Query mode - fetches data from analytics endpoint\n * ```tsx\n * <ChartWrapper\n * queryKey=\"spend_data\"\n * parameters={{ limit: 100 }}\n * format=\"auto\"\n * >\n * {(data) => <MyChart data={data} />}\n * </ChartWrapper>\n * ```\n *\n * @example Data mode - uses provided data directly\n * ```tsx\n * <ChartWrapper data={myArrowTable}>\n * {(data) => <MyChart data={data} />}\n * </ChartWrapper>\n * ```\n */\nexport function ChartWrapper(props: ChartWrapperProps) {\n const { height = 300, className, ariaLabel, testId, children } = props;\n\n // Data mode: use provided data directly\n if (\"data\" in props && props.data !== undefined) {\n return (\n <DataModeContent\n data={props.data}\n height={height}\n className={className}\n ariaLabel={ariaLabel}\n testId={testId}\n >\n {children}\n </DataModeContent>\n );\n }\n\n // Query mode: fetch data from analytics endpoint\n if (\"queryKey\" in props && props.queryKey !== undefined) {\n return (\n <QueryModeContent\n queryKey={props.queryKey}\n parameters={props.parameters}\n format={props.format}\n transformer={props.transformer}\n asUser={props.asUser}\n height={height}\n className={className}\n ariaLabel={ariaLabel}\n testId={testId}\n >\n {children}\n </QueryModeContent>\n );\n }\n\n // Should never reach here due to TypeScript, but safety fallback\n return <ErrorState error=\"Chart requires either 'queryKey' or 'data' prop\" />;\n}\n"],"mappings":";;;;;;;;;AA0DA,SAAS,iBAAiB,EACxB,UACA,YACA,QACA,aACA,QACA,QACA,WACA,WACA,QACA,YACuC;CACvC,MAAM,EAAE,MAAM,SAAS,OAAO,YAAY,aAAa;EACrD;EACA;EACA;EACA;EACA;EACD,CAAC;AAEF,KAAI,QAAS,QAAO,oBAAC,mBAAgB,QAAQ,UAAU,MAAO;AAC9D,KAAI,MAAO,QAAO,oBAAC,cAAkB,QAAS;AAC9C,KAAI,WAAW,CAAC,KAAM,QAAO,oBAAC,eAAa;AAE3C,QACE,oBAAC;EACC,UAAU,oBAAC,cAAW,OAAM,2BAA2B;YAEvD,oBAAC;GACY;GACX,OAAO,EAAE,QAAQ;GACjB,cAAY;GACZ,eAAa;GACb,MAAK;aAEJ,SAAS,KAAK;IACX;GACa;;AAQzB,SAAS,gBAAgB,EACvB,MACA,QACA,WACA,WACA,QACA,YACsC;AAKtC,KAJgB,aAAa,KAAK,GAC9B,KAAK,YAAY,IACjB,CAAC,MAAM,QAAQ,KAAK,IAAI,KAAK,WAAW,EAE/B,QAAO,oBAAC,eAAa;AAElC,QACE,oBAAC;EACC,UAAU,oBAAC,cAAW,OAAM,2BAA2B;YAEvD,oBAAC;GACY;GACX,OAAO,EAAE,QAAQ;GACjB,cAAY;GACZ,eAAa;GACb,MAAK;aAEJ,SAAS,KAAK;IACX;GACa;;;;;;;;;;;;;;;;;;;;;;;;AA8BzB,SAAgB,aAAa,OAA0B;CACrD,MAAM,EAAE,SAAS,KAAK,WAAW,WAAW,QAAQ,aAAa;AAGjE,KAAI,UAAU,SAAS,MAAM,SAAS,OACpC,QACE,oBAAC;EACC,MAAM,MAAM;EACJ;EACG;EACA;EACH;EAEP;GACe;AAKtB,KAAI,cAAc,SAAS,MAAM,aAAa,OAC5C,QACE,oBAAC;EACC,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,QAAQ,MAAM;EACd,aAAa,MAAM;EACnB,QAAQ,MAAM;EACN;EACG;EACA;EACH;EAEP;GACgB;AAKvB,QAAO,oBAAC,cAAW,OAAM,oDAAoD"}
1
+ {"version":3,"file":"wrapper.js","names":[],"sources":["../../../src/react/charts/wrapper.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useChartData } from \"../hooks/use-chart-data\";\nimport { ChartErrorBoundary } from \"./chart-error-boundary\";\nimport { EmptyState } from \"./empty\";\nimport { ErrorState } from \"./error\";\nimport { LoadingSkeleton } from \"./loading\";\nimport type { ChartData, DataFormat } from \"./types\";\nimport { isArrowTable } from \"./types\";\n\n// ============================================================================\n// Props Types\n// ============================================================================\n\ninterface ChartWrapperQueryProps {\n /** Analytics query key */\n queryKey: string;\n /** Query parameters */\n parameters?: Record<string, unknown>;\n /** Data format preference */\n format?: DataFormat;\n /** Transform data after fetching */\n transformer?: <T>(data: T) => T;\n /** Direct data - not used in query mode */\n data?: never;\n}\n\ninterface ChartWrapperDataProps {\n /** Direct data (Arrow Table or JSON array) */\n data: ChartData;\n /** Not used in data mode */\n queryKey?: never;\n parameters?: never;\n format?: never;\n transformer?: never;\n}\n\ninterface CommonProps {\n /** Chart height in pixels */\n height?: number;\n /** Additional CSS classes */\n className?: string;\n /** Accessibility label */\n ariaLabel?: string;\n /** Test ID for automated testing */\n testId?: string;\n /** Render function receiving the chart data */\n children: (data: ChartData) => ReactNode;\n}\n\nexport type ChartWrapperProps = CommonProps &\n (ChartWrapperQueryProps | ChartWrapperDataProps);\n\n// ============================================================================\n// Query Mode Content\n// ============================================================================\n\nfunction QueryModeContent({\n queryKey,\n parameters,\n format,\n transformer,\n height,\n className,\n ariaLabel,\n testId,\n children,\n}: CommonProps & ChartWrapperQueryProps) {\n const { data, loading, error, isEmpty } = useChartData({\n queryKey,\n parameters,\n format,\n transformer,\n });\n\n if (loading) return <LoadingSkeleton height={height ?? 300} />;\n if (error) return <ErrorState error={error} />;\n if (isEmpty || !data) return <EmptyState />;\n\n return (\n <ChartErrorBoundary\n fallback={<ErrorState error=\"Failed to render chart\" />}\n >\n <div\n className={className}\n style={{ height }}\n aria-label={ariaLabel}\n data-testid={testId}\n role=\"img\"\n >\n {children(data)}\n </div>\n </ChartErrorBoundary>\n );\n}\n\n// ============================================================================\n// Data Mode Content\n// ============================================================================\n\nfunction DataModeContent({\n data,\n height,\n className,\n ariaLabel,\n testId,\n children,\n}: CommonProps & ChartWrapperDataProps) {\n const isEmpty = isArrowTable(data)\n ? data.numRows === 0\n : !Array.isArray(data) || data.length === 0;\n\n if (isEmpty) return <EmptyState />;\n\n return (\n <ChartErrorBoundary\n fallback={<ErrorState error=\"Failed to render chart\" />}\n >\n <div\n className={className}\n style={{ height }}\n aria-label={ariaLabel}\n data-testid={testId}\n role=\"img\"\n >\n {children(data)}\n </div>\n </ChartErrorBoundary>\n );\n}\n\n// ============================================================================\n// Main Wrapper Component\n// ============================================================================\n\n/**\n * Wrapper component for charts.\n * Handles data fetching (query mode) or direct data injection (data mode).\n *\n * @example Query mode - fetches data from analytics endpoint\n * ```tsx\n * <ChartWrapper\n * queryKey=\"spend_data\"\n * parameters={{ limit: 100 }}\n * format=\"auto\"\n * >\n * {(data) => <MyChart data={data} />}\n * </ChartWrapper>\n * ```\n *\n * @example Data mode - uses provided data directly\n * ```tsx\n * <ChartWrapper data={myArrowTable}>\n * {(data) => <MyChart data={data} />}\n * </ChartWrapper>\n * ```\n */\nexport function ChartWrapper(props: ChartWrapperProps) {\n const { height = 300, className, ariaLabel, testId, children } = props;\n\n // Data mode: use provided data directly\n if (\"data\" in props && props.data !== undefined) {\n return (\n <DataModeContent\n data={props.data}\n height={height}\n className={className}\n ariaLabel={ariaLabel}\n testId={testId}\n >\n {children}\n </DataModeContent>\n );\n }\n\n // Query mode: fetch data from analytics endpoint\n if (\"queryKey\" in props && props.queryKey !== undefined) {\n return (\n <QueryModeContent\n queryKey={props.queryKey}\n parameters={props.parameters}\n format={props.format}\n transformer={props.transformer}\n height={height}\n className={className}\n ariaLabel={ariaLabel}\n testId={testId}\n >\n {children}\n </QueryModeContent>\n );\n }\n\n // Should never reach here due to TypeScript, but safety fallback\n return <ErrorState error=\"Chart requires either 'queryKey' or 'data' prop\" />;\n}\n"],"mappings":";;;;;;;;;AAwDA,SAAS,iBAAiB,EACxB,UACA,YACA,QACA,aACA,QACA,WACA,WACA,QACA,YACuC;CACvC,MAAM,EAAE,MAAM,SAAS,OAAO,YAAY,aAAa;EACrD;EACA;EACA;EACA;EACD,CAAC;AAEF,KAAI,QAAS,QAAO,oBAAC,mBAAgB,QAAQ,UAAU,MAAO;AAC9D,KAAI,MAAO,QAAO,oBAAC,cAAkB,QAAS;AAC9C,KAAI,WAAW,CAAC,KAAM,QAAO,oBAAC,eAAa;AAE3C,QACE,oBAAC;EACC,UAAU,oBAAC,cAAW,OAAM,2BAA2B;YAEvD,oBAAC;GACY;GACX,OAAO,EAAE,QAAQ;GACjB,cAAY;GACZ,eAAa;GACb,MAAK;aAEJ,SAAS,KAAK;IACX;GACa;;AAQzB,SAAS,gBAAgB,EACvB,MACA,QACA,WACA,WACA,QACA,YACsC;AAKtC,KAJgB,aAAa,KAAK,GAC9B,KAAK,YAAY,IACjB,CAAC,MAAM,QAAQ,KAAK,IAAI,KAAK,WAAW,EAE/B,QAAO,oBAAC,eAAa;AAElC,QACE,oBAAC;EACC,UAAU,oBAAC,cAAW,OAAM,2BAA2B;YAEvD,oBAAC;GACY;GACX,OAAO,EAAE,QAAQ;GACjB,cAAY;GACZ,eAAa;GACb,MAAK;aAEJ,SAAS,KAAK;IACX;GACa;;;;;;;;;;;;;;;;;;;;;;;;AA8BzB,SAAgB,aAAa,OAA0B;CACrD,MAAM,EAAE,SAAS,KAAK,WAAW,WAAW,QAAQ,aAAa;AAGjE,KAAI,UAAU,SAAS,MAAM,SAAS,OACpC,QACE,oBAAC;EACC,MAAM,MAAM;EACJ;EACG;EACA;EACH;EAEP;GACe;AAKtB,KAAI,cAAc,SAAS,MAAM,aAAa,OAC5C,QACE,oBAAC;EACC,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,QAAQ,MAAM;EACd,aAAa,MAAM;EACX;EACG;EACA;EACH;EAEP;GACgB;AAKvB,QAAO,oBAAC,cAAW,OAAM,oDAAoD"}
@@ -28,8 +28,6 @@ interface UseAnalyticsQueryOptions<F extends AnalyticsFormat = "JSON"> {
28
28
  maxParametersSize?: number;
29
29
  /** Whether to automatically start the query when the hook is mounted. Default is true. */
30
30
  autoStart?: boolean;
31
- /** Whether to execute the query as a user. Default is false. */
32
- asUser?: boolean;
33
31
  }
34
32
  /** Result state returned by useAnalyticsQuery */
35
33
  interface UseAnalyticsQueryResult<T> {
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/hooks/types.ts"],"sourcesContent":[],"mappings":";;;;KAOY,eAAA;AAAZ;AAYA;;;;;;;AAeA;;AAAoD,UAfnC,eAemC,CAAA,aAdrC,MAcqC,CAAA,MAAA,EAAA,OAAA,CAAA,GAdX,MAcW,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,SAb1C,KAa0C,CAAA;;;AAepD;AA2BA;EASY,SAAA,SAAA,CAAA,EA3DW,IA2DM;;;AACK,UApDjB,wBAoDiB,CAAA,UApDkB,eAoDlB,GAAA,MAAA,CAAA,CAAA;;QAAgB,CAAA,EAlDvC,CAkDuC;;EAAG,iBAAA,CAAA,EAAA,MAAA;EAIzC;EAAQ,SAAA,CAAA,EAAA,OAAA;;QAAG,CAAA,EAAA,OAAA;;;AAEF,UA3CJ,uBA2CI,CAAA,CAAA,CAAA,CAAA;EAMT;EAAW,IAAA,EA/Cf,CA+Ce,GAAA,IAAA;;SAAqC,EAAA,OAAA;;OACxD,EAAA,MAAA,GAAA,IAAA;;;;;;AASJ;;;;;;;;;;;;;;AAMU,UAtCO,aAAA,CAsCP;EAOE,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA;IAAmB,IAAA,EAAA,MAAA;IAGnB,UAAA,EA7CI,MA6CJ,CAAA,MAAA,EAAA,OAAA,CAAA;IACR,MAAA,EAAA,OAAA,EAAA;;;;AAAmE,KAxC3D,iBAwC2D,CAAA,CAAA,CAAA,GAAA,MAAA,QAAG,MAvC5D,CAuC4D,IAAA,MAAA,SAvCxC,CAuCwC,GAAA,KAAA,GAvC5B,CAuC4B,GAvCxB,CAuCwB,CAvCtB,CAuCsB,CAAA;;AAK9D,KAxCA,QAAA,GAAW,iBAwCA,CAxCkB,aAwClB,CAAA,SAAA,KAAA,GAAA,MAAA,GAtCnB,iBAsCmB,CAtCD,aAsCC,CAAA;;;;;AACnB,KAjCQ,WAiCR,CAAA,CAAA,EAAA,CAAA,CAAA,GAjC4B,CAiC5B,SAjCsC,iBAiCtC,CAjCwD,aAiCxD,CAAA,GAhCA,aAgCA,CAhCc,CAgCd,CAAA,SAAA;QAAc,EAAA,KAAA,EAAA;IA/BZ,IACA,CA+BA,GA9BF,CA8BE;;;;AAIN;KA5BY,kBAAkB,UAAU,kBAAkB,iBACtD,cAAc;UAAqB;IACjC,UAAU,0BACR,IACA,0BACF,0BACF;;;;;;KAOQ,oCAGA,mBACR,oBAAoB,gBAAgB,aAAa,MAAM,YAAY,GAAG;;;;KAK9D,iBAAiB,UAAU,kBAAkB,iBACrD,cAAc;;IACZ,IACA,0BACF;UAEa,cAAA;iBACA"}
1
+ {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/hooks/types.ts"],"sourcesContent":[],"mappings":";;;;KAOY,eAAA;AAAZ;AAYA;;;;;;;AAeA;;AAAoD,UAfnC,eAemC,CAAA,aAdrC,MAcqC,CAAA,MAAA,EAAA,OAAA,CAAA,GAdX,MAcW,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,SAb1C,KAa0C,CAAA;;;AAYpD;AA2BA;EASY,SAAA,SAAA,CAAA,EAxDW,IAwDM;;;AACK,UAjDjB,wBAiDiB,CAAA,UAjDkB,eAiDlB,GAAA,MAAA,CAAA,CAAA;;QAAgB,CAAA,EA/CvC,CA+CuC;;EAAG,iBAAA,CAAA,EAAA,MAAA;EAIzC;EAAQ,SAAA,CAAA,EAAA,OAAA;;;AAEE,UA3CL,uBA2CK,CAAA,CAAA,CAAA,CAAA;;EAAD,IAAA,EAzCb,CAyCa,GAAA,IAAA;EAMT;EAAW,OAAA,EAAA,OAAA;;OAAqC,EAAA,MAAA,GAAA,IAAA;;;;;;;;AAU5D;;;;;;;;;;;;AAKM,UArCW,aAAA,CAqCX;MACF,EAAA,MAAA,CAAA,EAAA;IAAM,IAAA,EAAA,MAAA;IAOE,UAAA,EA1CI,MA0Ce,CAAA,MAAA,EAAA,OAAA,CAAA;IAAA,MAAA,EAAA,OAAA,EAAA;;;;AAIS,KAxC5B,iBAwC4B,CAAA,CAAA,CAAA,GAAA,MAAA,QAAhB,MAvCV,CAuCU,IAAA,MAAA,SAvCU,CAuCV,GAAA,KAAA,GAvCsB,CAuCtB,GAvC0B,CAuC1B,CAvC4B,CAuC5B,CAAA;;AAAmC,KAnC/C,QAAA,GAAW,iBAmCoC,CAnClB,aAmCkB,CAAA,SAAA,KAAA,GAAA,MAAA,GAjCvD,iBAiCuD,CAjCrC,aAiCqC,CAAA;;AAK3D;;;AAAyD,KAhC7C,WAgC6C,CAAA,CAAA,EAAA,CAAA,CAAA,GAhCzB,CAgCyB,SAhCf,iBAgCe,CAhCG,aAgCH,CAAA,GA/BrD,aA+BqD,CA/BvC,CA+BuC,CAAA,SAAA;QAAlB,EAAA,KAAA,EAAA;IA9BjC,IACA,CA8BF,GA7BA,CA6BA;;;;;AAGM,KA1BE,YA0BF,CAAA,CAAA,CAAA,GA1BoB,CA0BpB,SA1B8B,iBA0B9B,CA1BgD,aA0BhD,CAAA,GAzBN,aAyBM,CAzBQ,CAyBR,CAAA,SAAA;EAEO,MAAA,EA3BsB,KA2BtB,CAAA,KAAc,EAAA,CAAA;IA1BzB,UAAU,0BACR,IACA,0BACF,0BACF;;;;;;KAOQ,oCAGA,mBACR,oBAAoB,gBAAgB,aAAa,MAAM,YAAY,GAAG;;;;KAK9D,iBAAiB,UAAU,kBAAkB,iBACrD,cAAc;;IACZ,IACA,0BACF;UAEa,cAAA;iBACA"}
@@ -10,6 +10,10 @@ import { AnalyticsFormat, InferParams, InferResultByFormat, QueryKey, UseAnalyti
10
10
  * - `format: "JSON"` (default): Returns typed array from QueryRegistry
11
11
  * - `format: "ARROW"`: Returns TypedArrowTable with row type preserved
12
12
  *
13
+ * Note: User context execution is determined by query file naming:
14
+ * - `queryKey.obo.sql`: Executes as user (OBO = on-behalf-of / user delegation)
15
+ * - `queryKey.sql`: Executes as service principal
16
+ *
13
17
  * @param queryKey - Analytics query identifier
14
18
  * @param parameters - Query parameters (type-safe based on QueryRegistry)
15
19
  * @param options - Analytics query settings including format
@@ -1 +1 @@
1
- {"version":3,"file":"use-analytics-query.d.ts","names":[],"sources":["../../../src/react/hooks/use-analytics-query.ts"],"sourcesContent":[],"mappings":";;;;;;AAiDA;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,yCAEJ,WAAW,oBACX,oCAEA,gBACG,YAAY,qBAChB,yBAAyB,KACjC,wBAAwB,oBAAoB,GAAG,GAAG"}
1
+ {"version":3,"file":"use-analytics-query.d.ts","names":[],"sources":["../../../src/react/hooks/use-analytics-query.ts"],"sourcesContent":[],"mappings":";;;;;;AAqDA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,yCAEJ,WAAW,oBACX,oCAEA,gBACG,YAAY,qBAChB,yBAAyB,KACjC,wBAAwB,oBAAoB,GAAG,GAAG"}