@restio/ui 0.1.0 → 0.2.1-20260901123418

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 (670) hide show
  1. package/README.md +78 -8
  2. package/dist/core.cjs +1 -0
  3. package/dist/core.d.ts +803 -0
  4. package/dist/core.js +30 -0
  5. package/dist/data.cjs +1 -0
  6. package/dist/data.d.ts +1423 -0
  7. package/dist/data.js +24 -0
  8. package/dist/experimental.cjs +1 -0
  9. package/dist/experimental.d.ts +486 -0
  10. package/dist/experimental.js +1027 -0
  11. package/dist/framework.cjs +1 -0
  12. package/dist/framework.d.ts +788 -0
  13. package/dist/framework.js +31 -0
  14. package/dist/index.cjs +1 -0
  15. package/dist/index.d.ts +3124 -132
  16. package/dist/index.js +90 -0
  17. package/dist/src-DaTjVaGd.js +39749 -0
  18. package/dist/src-gB-fpYMb.cjs +156 -0
  19. package/dist/ui.css +1 -1
  20. package/package.json +66 -45
  21. package/dist/assets/svg/alert.svg +0 -1
  22. package/dist/assets/svg/arrow-down-up.svg +0 -1
  23. package/dist/assets/svg/arrow-down.svg +0 -1
  24. package/dist/assets/svg/arrow-left.svg +0 -1
  25. package/dist/assets/svg/arrow-right.svg +0 -1
  26. package/dist/assets/svg/arrow-up.svg +0 -1
  27. package/dist/assets/svg/arrow_drop_down.svg +0 -1
  28. package/dist/assets/svg/calendar.svg +0 -1
  29. package/dist/assets/svg/chart-area.svg +0 -9
  30. package/dist/assets/svg/chart-bar-stacked.svg +0 -9
  31. package/dist/assets/svg/chart-bar.svg +0 -6
  32. package/dist/assets/svg/chart-candlestick.svg +0 -17
  33. package/dist/assets/svg/chart-gantt.svg +0 -9
  34. package/dist/assets/svg/chart-line.svg +0 -9
  35. package/dist/assets/svg/chart-pie.svg +0 -9
  36. package/dist/assets/svg/chart-sankey.svg +0 -18
  37. package/dist/assets/svg/check.svg +0 -1
  38. package/dist/assets/svg/chevron-down.svg +0 -1
  39. package/dist/assets/svg/chevron-right.svg +0 -1
  40. package/dist/assets/svg/clipboard.svg +0 -1
  41. package/dist/assets/svg/close.svg +0 -1
  42. package/dist/assets/svg/copy.svg +0 -1
  43. package/dist/assets/svg/cursor.svg +0 -1
  44. package/dist/assets/svg/cut.svg +0 -1
  45. package/dist/assets/svg/delete.svg +0 -1
  46. package/dist/assets/svg/discussion.svg +0 -1
  47. package/dist/assets/svg/dock-left-arrow.svg +0 -1
  48. package/dist/assets/svg/dock-right-arrow.svg +0 -1
  49. package/dist/assets/svg/document-outline.svg +0 -1
  50. package/dist/assets/svg/download.svg +0 -1
  51. package/dist/assets/svg/drag.svg +0 -1
  52. package/dist/assets/svg/error.svg +0 -1
  53. package/dist/assets/svg/expand-right.svg +0 -1
  54. package/dist/assets/svg/expand.svg +0 -1
  55. package/dist/assets/svg/eye.svg +0 -1
  56. package/dist/assets/svg/form.svg +0 -16
  57. package/dist/assets/svg/fullscreen.svg +0 -1
  58. package/dist/assets/svg/gear.svg +0 -1
  59. package/dist/assets/svg/groups.svg +0 -1
  60. package/dist/assets/svg/help.svg +0 -1
  61. package/dist/assets/svg/info.svg +0 -1
  62. package/dist/assets/svg/list.svg +0 -15
  63. package/dist/assets/svg/logo.svg +0 -9
  64. package/dist/assets/svg/menu.svg +0 -1
  65. package/dist/assets/svg/message-bubble-question-mark.svg +0 -1
  66. package/dist/assets/svg/pencil.svg +0 -1
  67. package/dist/assets/svg/pie-chart.svg +0 -1
  68. package/dist/assets/svg/plus.svg +0 -1
  69. package/dist/assets/svg/restio.svg +0 -5
  70. package/dist/assets/svg/search.svg +0 -1
  71. package/dist/assets/svg/send.svg +0 -1
  72. package/dist/assets/svg/shrink-right.svg +0 -1
  73. package/dist/assets/svg/sidebar.svg +0 -1
  74. package/dist/assets/svg/table.svg +0 -18
  75. package/dist/assets/svg/terminal.svg +0 -1
  76. package/dist/assets/svg/timer.svg +0 -1
  77. package/dist/assets/svg/warning.svg +0 -1
  78. package/dist/assets/svg/zoom-minus.svg +0 -1
  79. package/dist/assets/svg/zoom-plus.svg +0 -1
  80. package/dist/components/anchored-overlay/anchored-overlay-types.d.ts +0 -23
  81. package/dist/components/anchored-overlay/anchored-overlay-types.d.ts.map +0 -1
  82. package/dist/components/anchored-overlay/anchored-overlay.d.ts +0 -5
  83. package/dist/components/anchored-overlay/anchored-overlay.d.ts.map +0 -1
  84. package/dist/components/banner/banner-types.d.ts +0 -13
  85. package/dist/components/banner/banner-types.d.ts.map +0 -1
  86. package/dist/components/banner/banner.d.ts +0 -5
  87. package/dist/components/banner/banner.d.ts.map +0 -1
  88. package/dist/components/button/button-types.d.ts +0 -12
  89. package/dist/components/button/button-types.d.ts.map +0 -1
  90. package/dist/components/button/button.d.ts +0 -4
  91. package/dist/components/button/button.d.ts.map +0 -1
  92. package/dist/components/button-dropdown/button-dropdown-types.d.ts +0 -20
  93. package/dist/components/button-dropdown/button-dropdown-types.d.ts.map +0 -1
  94. package/dist/components/button-dropdown/button-dropdown.d.ts +0 -8
  95. package/dist/components/button-dropdown/button-dropdown.d.ts.map +0 -1
  96. package/dist/components/button-group/button-group-types.d.ts +0 -16
  97. package/dist/components/button-group/button-group-types.d.ts.map +0 -1
  98. package/dist/components/button-group/button-group.d.ts +0 -4
  99. package/dist/components/button-group/button-group.d.ts.map +0 -1
  100. package/dist/components/checkbox/checkbox-types.d.ts +0 -16
  101. package/dist/components/checkbox/checkbox-types.d.ts.map +0 -1
  102. package/dist/components/checkbox/checkbox.d.ts +0 -4
  103. package/dist/components/checkbox/checkbox.d.ts.map +0 -1
  104. package/dist/components/checkbox-group/checkbox-group-types.d.ts +0 -28
  105. package/dist/components/checkbox-group/checkbox-group-types.d.ts.map +0 -1
  106. package/dist/components/checkbox-group/checkbox-group.d.ts +0 -8
  107. package/dist/components/checkbox-group/checkbox-group.d.ts.map +0 -1
  108. package/dist/components/code-block/code-block.d.ts +0 -8
  109. package/dist/components/code-block/code-block.d.ts.map +0 -1
  110. package/dist/components/file-upload/file-upload-types.d.ts +0 -37
  111. package/dist/components/file-upload/file-upload-types.d.ts.map +0 -1
  112. package/dist/components/file-upload/file-upload-utils.d.ts +0 -2
  113. package/dist/components/file-upload/file-upload-utils.d.ts.map +0 -1
  114. package/dist/components/file-upload/file-upload.d.ts +0 -4
  115. package/dist/components/file-upload/file-upload.d.ts.map +0 -1
  116. package/dist/components/input/date/date-calendar.d.ts +0 -4
  117. package/dist/components/input/date/date-calendar.d.ts.map +0 -1
  118. package/dist/components/input/date/date-input-field.d.ts +0 -9
  119. package/dist/components/input/date/date-input-field.d.ts.map +0 -1
  120. package/dist/components/input/date/date-picker.d.ts +0 -8
  121. package/dist/components/input/date/date-picker.d.ts.map +0 -1
  122. package/dist/components/input/date/date-range-input-field.d.ts +0 -9
  123. package/dist/components/input/date/date-range-input-field.d.ts.map +0 -1
  124. package/dist/components/input/date/date-range-picker.d.ts +0 -9
  125. package/dist/components/input/date/date-range-picker.d.ts.map +0 -1
  126. package/dist/components/input/date/date-shortcuts.d.ts +0 -4
  127. package/dist/components/input/date/date-shortcuts.d.ts.map +0 -1
  128. package/dist/components/input/date/date-types.d.ts +0 -53
  129. package/dist/components/input/date/date-types.d.ts.map +0 -1
  130. package/dist/components/input/date/date-utils.d.ts +0 -51
  131. package/dist/components/input/date/date-utils.d.ts.map +0 -1
  132. package/dist/components/input/input-types.d.ts +0 -27
  133. package/dist/components/input/input-types.d.ts.map +0 -1
  134. package/dist/components/input/input.d.ts +0 -4
  135. package/dist/components/input/input.d.ts.map +0 -1
  136. package/dist/components/input/number/input-number-types.d.ts +0 -8
  137. package/dist/components/input/number/input-number-types.d.ts.map +0 -1
  138. package/dist/components/input/number/input-number.d.ts +0 -4
  139. package/dist/components/input/number/input-number.d.ts.map +0 -1
  140. package/dist/components/input/text/input-text-types.d.ts +0 -7
  141. package/dist/components/input/text/input-text-types.d.ts.map +0 -1
  142. package/dist/components/input/text/input-text.d.ts +0 -4
  143. package/dist/components/input/text/input-text.d.ts.map +0 -1
  144. package/dist/components/kbd/kbd-types.d.ts +0 -7
  145. package/dist/components/kbd/kbd-types.d.ts.map +0 -1
  146. package/dist/components/kbd/kbd.d.ts +0 -5
  147. package/dist/components/kbd/kbd.d.ts.map +0 -1
  148. package/dist/components/kbd-group/kbd-group-types.d.ts +0 -15
  149. package/dist/components/kbd-group/kbd-group-types.d.ts.map +0 -1
  150. package/dist/components/kbd-group/kbd-group.d.ts +0 -5
  151. package/dist/components/kbd-group/kbd-group.d.ts.map +0 -1
  152. package/dist/components/list/list-types.d.ts +0 -38
  153. package/dist/components/list/list-types.d.ts.map +0 -1
  154. package/dist/components/list/list-utils.d.ts +0 -47
  155. package/dist/components/list/list-utils.d.ts.map +0 -1
  156. package/dist/components/list/list.d.ts +0 -3
  157. package/dist/components/list/list.d.ts.map +0 -1
  158. package/dist/components/menu/anchored-navigation-menu.d.ts +0 -19
  159. package/dist/components/menu/anchored-navigation-menu.d.ts.map +0 -1
  160. package/dist/components/menu/menu-assets.d.ts +0 -3
  161. package/dist/components/menu/menu-assets.d.ts.map +0 -1
  162. package/dist/components/menu/menu-types.d.ts +0 -22
  163. package/dist/components/menu/menu-types.d.ts.map +0 -1
  164. package/dist/components/menu/menu.d.ts +0 -9
  165. package/dist/components/menu/menu.d.ts.map +0 -1
  166. package/dist/components/otp/otp-types.d.ts +0 -30
  167. package/dist/components/otp/otp-types.d.ts.map +0 -1
  168. package/dist/components/otp/otp-utils.d.ts +0 -15
  169. package/dist/components/otp/otp-utils.d.ts.map +0 -1
  170. package/dist/components/otp/otp.d.ts +0 -4
  171. package/dist/components/otp/otp.d.ts.map +0 -1
  172. package/dist/components/progress-bar/progress-bar-types.d.ts +0 -20
  173. package/dist/components/progress-bar/progress-bar-types.d.ts.map +0 -1
  174. package/dist/components/progress-bar/progress-bar.d.ts +0 -7
  175. package/dist/components/progress-bar/progress-bar.d.ts.map +0 -1
  176. package/dist/components/radio/radio-types.d.ts +0 -14
  177. package/dist/components/radio/radio-types.d.ts.map +0 -1
  178. package/dist/components/radio/radio.d.ts +0 -8
  179. package/dist/components/radio/radio.d.ts.map +0 -1
  180. package/dist/components/radio-group/radio-group-types.d.ts +0 -30
  181. package/dist/components/radio-group/radio-group-types.d.ts.map +0 -1
  182. package/dist/components/radio-group/radio-group.d.ts +0 -8
  183. package/dist/components/radio-group/radio-group.d.ts.map +0 -1
  184. package/dist/components/select/select-types.d.ts +0 -62
  185. package/dist/components/select/select-types.d.ts.map +0 -1
  186. package/dist/components/select/select.d.ts +0 -5
  187. package/dist/components/select/select.d.ts.map +0 -1
  188. package/dist/components/selection-grid/selection-grid-types.d.ts +0 -20
  189. package/dist/components/selection-grid/selection-grid-types.d.ts.map +0 -1
  190. package/dist/components/selection-grid/selection-grid.d.ts +0 -8
  191. package/dist/components/selection-grid/selection-grid.d.ts.map +0 -1
  192. package/dist/components/tag/tag-types.d.ts +0 -9
  193. package/dist/components/tag/tag-types.d.ts.map +0 -1
  194. package/dist/components/tag/tag.d.ts +0 -4
  195. package/dist/components/tag/tag.d.ts.map +0 -1
  196. package/dist/components/textarea/textarea-types.d.ts +0 -55
  197. package/dist/components/textarea/textarea-types.d.ts.map +0 -1
  198. package/dist/components/textarea/textarea.d.ts +0 -4
  199. package/dist/components/textarea/textarea.d.ts.map +0 -1
  200. package/dist/components/toast-group/toast-group-types.d.ts +0 -6
  201. package/dist/components/toast-group/toast-group-types.d.ts.map +0 -1
  202. package/dist/components/toast-group/toast-group.d.ts +0 -5
  203. package/dist/components/toast-group/toast-group.d.ts.map +0 -1
  204. package/dist/components/typography/typography-types.d.ts +0 -59
  205. package/dist/components/typography/typography-types.d.ts.map +0 -1
  206. package/dist/components/typography/typography.d.ts +0 -4
  207. package/dist/components/typography/typography.d.ts.map +0 -1
  208. package/dist/custom-components/chat/chat-types.d.ts +0 -19
  209. package/dist/custom-components/chat/chat-types.d.ts.map +0 -1
  210. package/dist/custom-components/chat/chat.d.ts +0 -3
  211. package/dist/custom-components/chat/chat.d.ts.map +0 -1
  212. package/dist/custom-components/layout/layout-renderers.d.ts +0 -9
  213. package/dist/custom-components/layout/layout-renderers.d.ts.map +0 -1
  214. package/dist/custom-components/layout/layout-types.d.ts +0 -44
  215. package/dist/custom-components/layout/layout-types.d.ts.map +0 -1
  216. package/dist/custom-components/layout/layout.d.ts +0 -13
  217. package/dist/custom-components/layout/layout.d.ts.map +0 -1
  218. package/dist/custom-components/markdown/components/img/zoomable-image.d.ts +0 -5
  219. package/dist/custom-components/markdown/components/img/zoomable-image.d.ts.map +0 -1
  220. package/dist/custom-components/markdown/markdown-types.d.ts +0 -29
  221. package/dist/custom-components/markdown/markdown-types.d.ts.map +0 -1
  222. package/dist/custom-components/markdown/markdown-utils.d.ts +0 -2
  223. package/dist/custom-components/markdown/markdown-utils.d.ts.map +0 -1
  224. package/dist/custom-components/markdown/markdown.d.ts +0 -4
  225. package/dist/custom-components/markdown/markdown.d.ts.map +0 -1
  226. package/dist/custom-components/mindmap/index.d.ts +0 -3
  227. package/dist/custom-components/mindmap/index.d.ts.map +0 -1
  228. package/dist/custom-components/mindmap/mind-tree-types.d.ts +0 -94
  229. package/dist/custom-components/mindmap/mind-tree-types.d.ts.map +0 -1
  230. package/dist/custom-components/mindmap/mind-tree.d.ts +0 -3
  231. package/dist/custom-components/mindmap/mind-tree.d.ts.map +0 -1
  232. package/dist/custom-components/mindmap/reingold-tilford-algorithm.d.ts +0 -65
  233. package/dist/custom-components/mindmap/reingold-tilford-algorithm.d.ts.map +0 -1
  234. package/dist/custom-components/shortcut-tooltip/shortcut-tooltip-types.d.ts +0 -60
  235. package/dist/custom-components/shortcut-tooltip/shortcut-tooltip-types.d.ts.map +0 -1
  236. package/dist/custom-components/shortcut-tooltip/shortcut-tooltip.d.ts +0 -18
  237. package/dist/custom-components/shortcut-tooltip/shortcut-tooltip.d.ts.map +0 -1
  238. package/dist/custom-components/timeline/skeleton/timeline-skeleton.d.ts +0 -7
  239. package/dist/custom-components/timeline/skeleton/timeline-skeleton.d.ts.map +0 -1
  240. package/dist/custom-components/timeline/timeline-types.d.ts +0 -46
  241. package/dist/custom-components/timeline/timeline-types.d.ts.map +0 -1
  242. package/dist/custom-components/timeline/timeline.d.ts +0 -20
  243. package/dist/custom-components/timeline/timeline.d.ts.map +0 -1
  244. package/dist/custom-components/workflow/layout/workflow-edge.d.ts +0 -3
  245. package/dist/custom-components/workflow/layout/workflow-edge.d.ts.map +0 -1
  246. package/dist/custom-components/workflow/layout/workflow-layout-types.d.ts +0 -74
  247. package/dist/custom-components/workflow/layout/workflow-layout-types.d.ts.map +0 -1
  248. package/dist/custom-components/workflow/layout/workflow-layout.d.ts +0 -38
  249. package/dist/custom-components/workflow/layout/workflow-layout.d.ts.map +0 -1
  250. package/dist/custom-components/workflow/node/workflow-node.d.ts +0 -3
  251. package/dist/custom-components/workflow/node/workflow-node.d.ts.map +0 -1
  252. package/dist/custom-components/workflow/panel/workflow-panel-types.d.ts +0 -18
  253. package/dist/custom-components/workflow/panel/workflow-panel-types.d.ts.map +0 -1
  254. package/dist/custom-components/workflow/panel/workflow-panel.d.ts +0 -3
  255. package/dist/custom-components/workflow/panel/workflow-panel.d.ts.map +0 -1
  256. package/dist/custom-components/workflow/toolbar/workflow-toolbar-types.d.ts +0 -24
  257. package/dist/custom-components/workflow/toolbar/workflow-toolbar-types.d.ts.map +0 -1
  258. package/dist/custom-components/workflow/toolbar/workflow-toolbar.d.ts +0 -3
  259. package/dist/custom-components/workflow/toolbar/workflow-toolbar.d.ts.map +0 -1
  260. package/dist/custom-components/workflow/utils/workflow-validation.d.ts +0 -48
  261. package/dist/custom-components/workflow/utils/workflow-validation.d.ts.map +0 -1
  262. package/dist/custom-components/workflow/workflow-types.d.ts +0 -204
  263. package/dist/custom-components/workflow/workflow-types.d.ts.map +0 -1
  264. package/dist/custom-components/workflow/workflow.d.ts +0 -6
  265. package/dist/custom-components/workflow/workflow.d.ts.map +0 -1
  266. package/dist/data-components/assets/cell-types-asset.d.ts +0 -39
  267. package/dist/data-components/assets/cell-types-asset.d.ts.map +0 -1
  268. package/dist/data-components/assets/data-components-asset.d.ts +0 -14
  269. package/dist/data-components/assets/data-components-asset.d.ts.map +0 -1
  270. package/dist/data-components/calendar/calendar-types.d.ts +0 -31
  271. package/dist/data-components/calendar/calendar-types.d.ts.map +0 -1
  272. package/dist/data-components/calendar/calendar-utils.d.ts +0 -6
  273. package/dist/data-components/calendar/calendar-utils.d.ts.map +0 -1
  274. package/dist/data-components/calendar/calendar.d.ts +0 -4
  275. package/dist/data-components/calendar/calendar.d.ts.map +0 -1
  276. package/dist/data-components/card/card-types.d.ts +0 -21
  277. package/dist/data-components/card/card-types.d.ts.map +0 -1
  278. package/dist/data-components/card/card.d.ts +0 -10
  279. package/dist/data-components/card/card.d.ts.map +0 -1
  280. package/dist/data-components/card-list/card-list-types.d.ts +0 -22
  281. package/dist/data-components/card-list/card-list-types.d.ts.map +0 -1
  282. package/dist/data-components/card-list/card-list.d.ts +0 -13
  283. package/dist/data-components/card-list/card-list.d.ts.map +0 -1
  284. package/dist/data-components/card-list/models/ecommerce.d.ts +0 -13
  285. package/dist/data-components/card-list/models/ecommerce.d.ts.map +0 -1
  286. package/dist/data-components/cell/cell-registry.d.ts +0 -29
  287. package/dist/data-components/cell/cell-registry.d.ts.map +0 -1
  288. package/dist/data-components/cell/cell-types.d.ts +0 -36
  289. package/dist/data-components/cell/cell-types.d.ts.map +0 -1
  290. package/dist/data-components/cell/cell-utils.d.ts +0 -22
  291. package/dist/data-components/cell/cell-utils.d.ts.map +0 -1
  292. package/dist/data-components/cell/cell.d.ts +0 -3
  293. package/dist/data-components/cell/cell.d.ts.map +0 -1
  294. package/dist/data-components/chart/chart-tooltip/chart-tooltip-types.d.ts +0 -14
  295. package/dist/data-components/chart/chart-tooltip/chart-tooltip-types.d.ts.map +0 -1
  296. package/dist/data-components/chart/chart-tooltip/chart-tooltip.d.ts +0 -7
  297. package/dist/data-components/chart/chart-tooltip/chart-tooltip.d.ts.map +0 -1
  298. package/dist/data-components/chart/chart-types.d.ts +0 -88
  299. package/dist/data-components/chart/chart-types.d.ts.map +0 -1
  300. package/dist/data-components/chart/chart-utils.d.ts +0 -28
  301. package/dist/data-components/chart/chart-utils.d.ts.map +0 -1
  302. package/dist/data-components/chart/chart.d.ts +0 -4
  303. package/dist/data-components/chart/chart.d.ts.map +0 -1
  304. package/dist/data-components/chart/geo/geoChart.d.ts +0 -10
  305. package/dist/data-components/chart/geo/geoChart.d.ts.map +0 -1
  306. package/dist/data-components/chart/sankey/sankeyChart.d.ts +0 -38
  307. package/dist/data-components/chart/sankey/sankeyChart.d.ts.map +0 -1
  308. package/dist/data-components/data-component-configurator/data-component-configurator-types.d.ts +0 -36
  309. package/dist/data-components/data-component-configurator/data-component-configurator-types.d.ts.map +0 -1
  310. package/dist/data-components/data-component-configurator/data-component-configurator.d.ts +0 -17
  311. package/dist/data-components/data-component-configurator/data-component-configurator.d.ts.map +0 -1
  312. package/dist/data-components/data-component-types.d.ts +0 -11
  313. package/dist/data-components/data-component-types.d.ts.map +0 -1
  314. package/dist/data-components/data-component-utils.d.ts +0 -4
  315. package/dist/data-components/data-component-utils.d.ts.map +0 -1
  316. package/dist/data-components/data-structure/data-structure-utils.d.ts +0 -16
  317. package/dist/data-components/data-structure/data-structure-utils.d.ts.map +0 -1
  318. package/dist/data-components/data-structure/data-structure.d.ts +0 -42
  319. package/dist/data-components/data-structure/data-structure.d.ts.map +0 -1
  320. package/dist/data-components/data-structure/stories-assets.d.ts +0 -87
  321. package/dist/data-components/data-structure/stories-assets.d.ts.map +0 -1
  322. package/dist/data-components/filter/filter-engine.d.ts +0 -15
  323. package/dist/data-components/filter/filter-engine.d.ts.map +0 -1
  324. package/dist/data-components/filter/filter-types.d.ts +0 -41
  325. package/dist/data-components/filter/filter-types.d.ts.map +0 -1
  326. package/dist/data-components/filter/filter-utils.d.ts +0 -26
  327. package/dist/data-components/filter/filter-utils.d.ts.map +0 -1
  328. package/dist/data-components/form/form-types.d.ts +0 -65
  329. package/dist/data-components/form/form-types.d.ts.map +0 -1
  330. package/dist/data-components/form/form.d.ts +0 -3
  331. package/dist/data-components/form/form.d.ts.map +0 -1
  332. package/dist/data-components/gantt/ai-assistant/gantt-ai-executor.d.ts +0 -9
  333. package/dist/data-components/gantt/ai-assistant/gantt-ai-executor.d.ts.map +0 -1
  334. package/dist/data-components/gantt/ai-assistant/gantt-ai-panel.d.ts +0 -12
  335. package/dist/data-components/gantt/ai-assistant/gantt-ai-panel.d.ts.map +0 -1
  336. package/dist/data-components/gantt/ai-assistant/gantt-ai-schema.d.ts +0 -7
  337. package/dist/data-components/gantt/ai-assistant/gantt-ai-schema.d.ts.map +0 -1
  338. package/dist/data-components/gantt/ai-assistant/gantt-ai-tools.d.ts +0 -3
  339. package/dist/data-components/gantt/ai-assistant/gantt-ai-tools.d.ts.map +0 -1
  340. package/dist/data-components/gantt/arrows/gantt-arrows.d.ts +0 -21
  341. package/dist/data-components/gantt/arrows/gantt-arrows.d.ts.map +0 -1
  342. package/dist/data-components/gantt/gantt-context.d.ts +0 -13
  343. package/dist/data-components/gantt/gantt-context.d.ts.map +0 -1
  344. package/dist/data-components/gantt/gantt-types.d.ts +0 -102
  345. package/dist/data-components/gantt/gantt-types.d.ts.map +0 -1
  346. package/dist/data-components/gantt/gantt-utils.d.ts +0 -61
  347. package/dist/data-components/gantt/gantt-utils.d.ts.map +0 -1
  348. package/dist/data-components/gantt/gantt.d.ts +0 -4
  349. package/dist/data-components/gantt/gantt.d.ts.map +0 -1
  350. package/dist/data-components/gantt/hooks/useGanttDrag.d.ts +0 -15
  351. package/dist/data-components/gantt/hooks/useGanttDrag.d.ts.map +0 -1
  352. package/dist/data-components/gantt/hooks/useGanttTimeline.d.ts +0 -18
  353. package/dist/data-components/gantt/hooks/useGanttTimeline.d.ts.map +0 -1
  354. package/dist/data-components/gantt/sidebar/gantt-sidebar-types.d.ts +0 -10
  355. package/dist/data-components/gantt/sidebar/gantt-sidebar-types.d.ts.map +0 -1
  356. package/dist/data-components/gantt/sidebar/gantt-sidebar.d.ts +0 -3
  357. package/dist/data-components/gantt/sidebar/gantt-sidebar.d.ts.map +0 -1
  358. package/dist/data-components/gantt/stories/gantt-stories-utils.d.ts +0 -13
  359. package/dist/data-components/gantt/stories/gantt-stories-utils.d.ts.map +0 -1
  360. package/dist/data-components/switcher/prop-form/prop-form-adapter.d.ts +0 -8
  361. package/dist/data-components/switcher/prop-form/prop-form-adapter.d.ts.map +0 -1
  362. package/dist/data-components/switcher/prop-form/prop-form-types.d.ts +0 -17
  363. package/dist/data-components/switcher/prop-form/prop-form-types.d.ts.map +0 -1
  364. package/dist/data-components/switcher/prop-form/prop-form.d.ts +0 -6
  365. package/dist/data-components/switcher/prop-form/prop-form.d.ts.map +0 -1
  366. package/dist/data-components/switcher/prop-schema/prop-schema-types.d.ts +0 -53
  367. package/dist/data-components/switcher/prop-schema/prop-schema-types.d.ts.map +0 -1
  368. package/dist/data-components/switcher/prop-schema/prop-schema-utils.d.ts +0 -15
  369. package/dist/data-components/switcher/prop-schema/prop-schema-utils.d.ts.map +0 -1
  370. package/dist/data-components/switcher/prop-schema/prop-schema.d.ts +0 -38
  371. package/dist/data-components/switcher/prop-schema/prop-schema.d.ts.map +0 -1
  372. package/dist/data-components/switcher/switcher-types.d.ts +0 -58
  373. package/dist/data-components/switcher/switcher-types.d.ts.map +0 -1
  374. package/dist/data-components/switcher/switcher.d.ts +0 -12
  375. package/dist/data-components/switcher/switcher.d.ts.map +0 -1
  376. package/dist/data-components/table-grid/aggregation/aggregation-utils.d.ts +0 -9
  377. package/dist/data-components/table-grid/aggregation/aggregation-utils.d.ts.map +0 -1
  378. package/dist/data-components/table-grid/ai-assistant/ai-assistant-executor.d.ts +0 -9
  379. package/dist/data-components/table-grid/ai-assistant/ai-assistant-executor.d.ts.map +0 -1
  380. package/dist/data-components/table-grid/ai-assistant/ai-assistant-mock.d.ts +0 -13
  381. package/dist/data-components/table-grid/ai-assistant/ai-assistant-mock.d.ts.map +0 -1
  382. package/dist/data-components/table-grid/ai-assistant/ai-assistant-panel-types.d.ts +0 -14
  383. package/dist/data-components/table-grid/ai-assistant/ai-assistant-panel-types.d.ts.map +0 -1
  384. package/dist/data-components/table-grid/ai-assistant/ai-assistant-panel.d.ts +0 -3
  385. package/dist/data-components/table-grid/ai-assistant/ai-assistant-panel.d.ts.map +0 -1
  386. package/dist/data-components/table-grid/ai-assistant/ai-assistant-schema.d.ts +0 -4
  387. package/dist/data-components/table-grid/ai-assistant/ai-assistant-schema.d.ts.map +0 -1
  388. package/dist/data-components/table-grid/ai-assistant/ai-assistant-tools.d.ts +0 -6
  389. package/dist/data-components/table-grid/ai-assistant/ai-assistant-tools.d.ts.map +0 -1
  390. package/dist/data-components/table-grid/ai-assistant/ai-assistant-types.d.ts +0 -94
  391. package/dist/data-components/table-grid/ai-assistant/ai-assistant-types.d.ts.map +0 -1
  392. package/dist/data-components/table-grid/ai-assistant/ai-assistant-validator.d.ts +0 -5
  393. package/dist/data-components/table-grid/ai-assistant/ai-assistant-validator.d.ts.map +0 -1
  394. package/dist/data-components/table-grid/external-functionalities/import/csv/autoDetect.d.ts +0 -7
  395. package/dist/data-components/table-grid/external-functionalities/import/csv/autoDetect.d.ts.map +0 -1
  396. package/dist/data-components/table-grid/external-functionalities/import/csv/createDataStructureFromFile.d.ts +0 -9
  397. package/dist/data-components/table-grid/external-functionalities/import/csv/createDataStructureFromFile.d.ts.map +0 -1
  398. package/dist/data-components/table-grid/external-functionalities/import/csv/csvToObj.d.ts +0 -6
  399. package/dist/data-components/table-grid/external-functionalities/import/csv/csvToObj.d.ts.map +0 -1
  400. package/dist/data-components/table-grid/external-functionalities/import/csv/detectDelimeter.d.ts +0 -6
  401. package/dist/data-components/table-grid/external-functionalities/import/csv/detectDelimeter.d.ts.map +0 -1
  402. package/dist/data-components/table-grid/external-functionalities/import/csv/index.d.ts +0 -7
  403. package/dist/data-components/table-grid/external-functionalities/import/csv/index.d.ts.map +0 -1
  404. package/dist/data-components/table-grid/external-functionalities/import/csv/inferColumns.d.ts +0 -6
  405. package/dist/data-components/table-grid/external-functionalities/import/csv/inferColumns.d.ts.map +0 -1
  406. package/dist/data-components/table-grid/external-functionalities/import/csv/parseDelimeted.d.ts +0 -7
  407. package/dist/data-components/table-grid/external-functionalities/import/csv/parseDelimeted.d.ts.map +0 -1
  408. package/dist/data-components/table-grid/footer/table-grid-footer-types.d.ts +0 -5
  409. package/dist/data-components/table-grid/footer/table-grid-footer-types.d.ts.map +0 -1
  410. package/dist/data-components/table-grid/footer/table-grid-footer.d.ts +0 -3
  411. package/dist/data-components/table-grid/footer/table-grid-footer.d.ts.map +0 -1
  412. package/dist/data-components/table-grid/formula/evaluator.d.ts +0 -11
  413. package/dist/data-components/table-grid/formula/evaluator.d.ts.map +0 -1
  414. package/dist/data-components/table-grid/formula/formula-builder-types.d.ts +0 -8
  415. package/dist/data-components/table-grid/formula/formula-builder-types.d.ts.map +0 -1
  416. package/dist/data-components/table-grid/formula/formula-builder.d.ts +0 -3
  417. package/dist/data-components/table-grid/formula/formula-builder.d.ts.map +0 -1
  418. package/dist/data-components/table-grid/formula/formula.test.d.ts +0 -2
  419. package/dist/data-components/table-grid/formula/formula.test.d.ts.map +0 -1
  420. package/dist/data-components/table-grid/formula/index.d.ts +0 -12
  421. package/dist/data-components/table-grid/formula/index.d.ts.map +0 -1
  422. package/dist/data-components/table-grid/formula/parser.d.ts +0 -24
  423. package/dist/data-components/table-grid/formula/parser.d.ts.map +0 -1
  424. package/dist/data-components/table-grid/formula/tokenizer.d.ts +0 -16
  425. package/dist/data-components/table-grid/formula/tokenizer.d.ts.map +0 -1
  426. package/dist/data-components/table-grid/formula/types.d.ts +0 -39
  427. package/dist/data-components/table-grid/formula/types.d.ts.map +0 -1
  428. package/dist/data-components/table-grid/grouping/grouping.d.ts +0 -15
  429. package/dist/data-components/table-grid/grouping/grouping.d.ts.map +0 -1
  430. package/dist/data-components/table-grid/header/grouping/group-panel-types.d.ts +0 -7
  431. package/dist/data-components/table-grid/header/grouping/group-panel-types.d.ts.map +0 -1
  432. package/dist/data-components/table-grid/header/grouping/group-panel.d.ts +0 -3
  433. package/dist/data-components/table-grid/header/grouping/group-panel.d.ts.map +0 -1
  434. package/dist/data-components/table-grid/header/table-grid-column-menu.d.ts +0 -10
  435. package/dist/data-components/table-grid/header/table-grid-column-menu.d.ts.map +0 -1
  436. package/dist/data-components/table-grid/header/table-grid-header-types.d.ts +0 -6
  437. package/dist/data-components/table-grid/header/table-grid-header-types.d.ts.map +0 -1
  438. package/dist/data-components/table-grid/header/table-grid-header.d.ts +0 -3
  439. package/dist/data-components/table-grid/header/table-grid-header.d.ts.map +0 -1
  440. package/dist/data-components/table-grid/hooks/use-table.d.ts +0 -3
  441. package/dist/data-components/table-grid/hooks/use-table.d.ts.map +0 -1
  442. package/dist/data-components/table-grid/pinning/pinning-utils.d.ts +0 -21
  443. package/dist/data-components/table-grid/pinning/pinning-utils.d.ts.map +0 -1
  444. package/dist/data-components/table-grid/pivot/pivot-config-panel-types.d.ts +0 -17
  445. package/dist/data-components/table-grid/pivot/pivot-config-panel-types.d.ts.map +0 -1
  446. package/dist/data-components/table-grid/pivot/pivot-config-panel.d.ts +0 -3
  447. package/dist/data-components/table-grid/pivot/pivot-config-panel.d.ts.map +0 -1
  448. package/dist/data-components/table-grid/pivot/pivot-table.d.ts +0 -8
  449. package/dist/data-components/table-grid/pivot/pivot-table.d.ts.map +0 -1
  450. package/dist/data-components/table-grid/pivot/pivot-types.d.ts +0 -53
  451. package/dist/data-components/table-grid/pivot/pivot-types.d.ts.map +0 -1
  452. package/dist/data-components/table-grid/pivot/pivot-utils.d.ts +0 -14
  453. package/dist/data-components/table-grid/pivot/pivot-utils.d.ts.map +0 -1
  454. package/dist/data-components/table-grid/row/table-grid-row-types.d.ts +0 -11
  455. package/dist/data-components/table-grid/row/table-grid-row-types.d.ts.map +0 -1
  456. package/dist/data-components/table-grid/row/table-grid-row-utils.d.ts +0 -17
  457. package/dist/data-components/table-grid/row/table-grid-row-utils.d.ts.map +0 -1
  458. package/dist/data-components/table-grid/row/table-grid-row.d.ts +0 -3
  459. package/dist/data-components/table-grid/row/table-grid-row.d.ts.map +0 -1
  460. package/dist/data-components/table-grid/selection/selection-types.d.ts +0 -3
  461. package/dist/data-components/table-grid/selection/selection-types.d.ts.map +0 -1
  462. package/dist/data-components/table-grid/selection/selection-utils.d.ts +0 -49
  463. package/dist/data-components/table-grid/selection/selection-utils.d.ts.map +0 -1
  464. package/dist/data-components/table-grid/sidebar/table-grid-sidebar-types.d.ts +0 -28
  465. package/dist/data-components/table-grid/sidebar/table-grid-sidebar-types.d.ts.map +0 -1
  466. package/dist/data-components/table-grid/sidebar/table-grid-sidebar.d.ts +0 -3
  467. package/dist/data-components/table-grid/sidebar/table-grid-sidebar.d.ts.map +0 -1
  468. package/dist/data-components/table-grid/sorting/sorting.d.ts +0 -8
  469. package/dist/data-components/table-grid/sorting/sorting.d.ts.map +0 -1
  470. package/dist/data-components/table-grid/table-context/table-context-types.d.ts +0 -17
  471. package/dist/data-components/table-grid/table-context/table-context-types.d.ts.map +0 -1
  472. package/dist/data-components/table-grid/table-context/table-context.d.ts +0 -3
  473. package/dist/data-components/table-grid/table-context/table-context.d.ts.map +0 -1
  474. package/dist/data-components/table-grid/table-grid-context.d.ts +0 -4
  475. package/dist/data-components/table-grid/table-grid-context.d.ts.map +0 -1
  476. package/dist/data-components/table-grid/table-grid-panels.d.ts +0 -22
  477. package/dist/data-components/table-grid/table-grid-panels.d.ts.map +0 -1
  478. package/dist/data-components/table-grid/table-grid-types.d.ts +0 -247
  479. package/dist/data-components/table-grid/table-grid-types.d.ts.map +0 -1
  480. package/dist/data-components/table-grid/table-grid.d.ts +0 -11
  481. package/dist/data-components/table-grid/table-grid.d.ts.map +0 -1
  482. package/dist/data-components/table-grid/table-utils.d.ts +0 -18
  483. package/dist/data-components/table-grid/table-utils.d.ts.map +0 -1
  484. package/dist/data-components/ui-layer/ui-layer-types.d.ts +0 -82
  485. package/dist/data-components/ui-layer/ui-layer-types.d.ts.map +0 -1
  486. package/dist/data-components/ui-layer/ui-layer-utils.d.ts +0 -13
  487. package/dist/data-components/ui-layer/ui-layer-utils.d.ts.map +0 -1
  488. package/dist/experimental-components/contribution-heatmap/contribution-heatmap-types.d.ts +0 -15
  489. package/dist/experimental-components/contribution-heatmap/contribution-heatmap-types.d.ts.map +0 -1
  490. package/dist/experimental-components/contribution-heatmap/contribution-heatmap-utils.d.ts +0 -12
  491. package/dist/experimental-components/contribution-heatmap/contribution-heatmap-utils.d.ts.map +0 -1
  492. package/dist/experimental-components/contribution-heatmap/contribution-heatmap.d.ts +0 -4
  493. package/dist/experimental-components/contribution-heatmap/contribution-heatmap.d.ts.map +0 -1
  494. package/dist/experimental-components/dashboard-builder/builder-canvas-hooks.d.ts +0 -47
  495. package/dist/experimental-components/dashboard-builder/builder-canvas-hooks.d.ts.map +0 -1
  496. package/dist/experimental-components/dashboard-builder/builder-canvas.d.ts +0 -33
  497. package/dist/experimental-components/dashboard-builder/builder-canvas.d.ts.map +0 -1
  498. package/dist/experimental-components/dashboard-builder/dashboard-builder-hooks.d.ts +0 -23
  499. package/dist/experimental-components/dashboard-builder/dashboard-builder-hooks.d.ts.map +0 -1
  500. package/dist/experimental-components/dashboard-builder/dashboard-builder-types.d.ts +0 -150
  501. package/dist/experimental-components/dashboard-builder/dashboard-builder-types.d.ts.map +0 -1
  502. package/dist/experimental-components/dashboard-builder/dashboard-builder-utils.d.ts +0 -28
  503. package/dist/experimental-components/dashboard-builder/dashboard-builder-utils.d.ts.map +0 -1
  504. package/dist/experimental-components/dashboard-builder/dashboard-builder.d.ts +0 -14
  505. package/dist/experimental-components/dashboard-builder/dashboard-builder.d.ts.map +0 -1
  506. package/dist/experimental-components/dashboard-builder/widget-configurator.d.ts +0 -24
  507. package/dist/experimental-components/dashboard-builder/widget-configurator.d.ts.map +0 -1
  508. package/dist/experimental-components/dashboard-builder/widget-palette.d.ts +0 -20
  509. package/dist/experimental-components/dashboard-builder/widget-palette.d.ts.map +0 -1
  510. package/dist/experimental-components/filter-builder/filter-builder-types.d.ts +0 -12
  511. package/dist/experimental-components/filter-builder/filter-builder-types.d.ts.map +0 -1
  512. package/dist/experimental-components/filter-builder/filter-builder.d.ts +0 -11
  513. package/dist/experimental-components/filter-builder/filter-builder.d.ts.map +0 -1
  514. package/dist/framework-components/appbar/appbar-assets.d.ts +0 -2
  515. package/dist/framework-components/appbar/appbar-assets.d.ts.map +0 -1
  516. package/dist/framework-components/appbar/appbar-types.d.ts +0 -19
  517. package/dist/framework-components/appbar/appbar-types.d.ts.map +0 -1
  518. package/dist/framework-components/appbar/appbar.d.ts +0 -9
  519. package/dist/framework-components/appbar/appbar.d.ts.map +0 -1
  520. package/dist/framework-components/breadcrumbs/breadcrumbs-types.d.ts +0 -14
  521. package/dist/framework-components/breadcrumbs/breadcrumbs-types.d.ts.map +0 -1
  522. package/dist/framework-components/breadcrumbs/breadcrumbs.d.ts +0 -4
  523. package/dist/framework-components/breadcrumbs/breadcrumbs.d.ts.map +0 -1
  524. package/dist/framework-components/dashboard/dashboard-context.d.ts +0 -12
  525. package/dist/framework-components/dashboard/dashboard-context.d.ts.map +0 -1
  526. package/dist/framework-components/dashboard/dashboard-types.d.ts +0 -35
  527. package/dist/framework-components/dashboard/dashboard-types.d.ts.map +0 -1
  528. package/dist/framework-components/dashboard/dashboard-widget-actions.d.ts +0 -1
  529. package/dist/framework-components/dashboard/dashboard-widget-actions.d.ts.map +0 -1
  530. package/dist/framework-components/dashboard/dashboard-widget-types.d.ts +0 -67
  531. package/dist/framework-components/dashboard/dashboard-widget-types.d.ts.map +0 -1
  532. package/dist/framework-components/dashboard/dashboard-widget.d.ts +0 -17
  533. package/dist/framework-components/dashboard/dashboard-widget.d.ts.map +0 -1
  534. package/dist/framework-components/dashboard/dashboard.d.ts +0 -11
  535. package/dist/framework-components/dashboard/dashboard.d.ts.map +0 -1
  536. package/dist/framework-components/dashboard/data-engine/aggregation-engine.d.ts +0 -11
  537. package/dist/framework-components/dashboard/data-engine/aggregation-engine.d.ts.map +0 -1
  538. package/dist/framework-components/dashboard/data-engine/data-engine-client.d.ts +0 -47
  539. package/dist/framework-components/dashboard/data-engine/data-engine-client.d.ts.map +0 -1
  540. package/dist/framework-components/dashboard/data-engine/data-engine-types.d.ts +0 -119
  541. package/dist/framework-components/dashboard/data-engine/data-engine-types.d.ts.map +0 -1
  542. package/dist/framework-components/dashboard/data-engine/data-engine.d.ts +0 -87
  543. package/dist/framework-components/dashboard/data-engine/data-engine.d.ts.map +0 -1
  544. package/dist/framework-components/dashboard/data-engine/data-engine.test.d.ts +0 -2
  545. package/dist/framework-components/dashboard/data-engine/data-engine.test.d.ts.map +0 -1
  546. package/dist/framework-components/dashboard/data-engine/data-engine.worker.d.ts +0 -2
  547. package/dist/framework-components/dashboard/data-engine/data-engine.worker.d.ts.map +0 -1
  548. package/dist/framework-components/dashboard/data-engine/field-inference.d.ts +0 -10
  549. package/dist/framework-components/dashboard/data-engine/field-inference.d.ts.map +0 -1
  550. package/dist/framework-components/dashboard/data-engine/filter-adapter.d.ts +0 -12
  551. package/dist/framework-components/dashboard/data-engine/filter-adapter.d.ts.map +0 -1
  552. package/dist/framework-components/dashboard/data-engine/index.d.ts +0 -8
  553. package/dist/framework-components/dashboard/data-engine/index.d.ts.map +0 -1
  554. package/dist/framework-components/dashboard/data-engine/join-engine.d.ts +0 -17
  555. package/dist/framework-components/dashboard/data-engine/join-engine.d.ts.map +0 -1
  556. package/dist/framework-components/drawer/drawer-types.d.ts +0 -7
  557. package/dist/framework-components/drawer/drawer-types.d.ts.map +0 -1
  558. package/dist/framework-components/drawer/drawer.d.ts +0 -5
  559. package/dist/framework-components/drawer/drawer.d.ts.map +0 -1
  560. package/dist/framework-components/scaffold/scaffold-context.d.ts +0 -4
  561. package/dist/framework-components/scaffold/scaffold-context.d.ts.map +0 -1
  562. package/dist/framework-components/scaffold/scaffold-types.d.ts +0 -18
  563. package/dist/framework-components/scaffold/scaffold-types.d.ts.map +0 -1
  564. package/dist/framework-components/scaffold/scaffold.d.ts +0 -7
  565. package/dist/framework-components/scaffold/scaffold.d.ts.map +0 -1
  566. package/dist/framework-components/section/section-types.d.ts +0 -14
  567. package/dist/framework-components/section/section-types.d.ts.map +0 -1
  568. package/dist/framework-components/section/section.d.ts +0 -9
  569. package/dist/framework-components/section/section.d.ts.map +0 -1
  570. package/dist/framework-components/sidebar/sidebar-assets.d.ts +0 -2
  571. package/dist/framework-components/sidebar/sidebar-assets.d.ts.map +0 -1
  572. package/dist/framework-components/sidebar/sidebar-context.d.ts +0 -4
  573. package/dist/framework-components/sidebar/sidebar-context.d.ts.map +0 -1
  574. package/dist/framework-components/sidebar/sidebar-logo/sidebar-logo-types.d.ts +0 -4
  575. package/dist/framework-components/sidebar/sidebar-logo/sidebar-logo-types.d.ts.map +0 -1
  576. package/dist/framework-components/sidebar/sidebar-logo/sidebar-logo.d.ts +0 -3
  577. package/dist/framework-components/sidebar/sidebar-logo/sidebar-logo.d.ts.map +0 -1
  578. package/dist/framework-components/sidebar/sidebar-types.d.ts +0 -13
  579. package/dist/framework-components/sidebar/sidebar-types.d.ts.map +0 -1
  580. package/dist/framework-components/sidebar/sidebar.d.ts +0 -17
  581. package/dist/framework-components/sidebar/sidebar.d.ts.map +0 -1
  582. package/dist/hooks/useDynamicVirtualList.d.ts +0 -76
  583. package/dist/hooks/useDynamicVirtualList.d.ts.map +0 -1
  584. package/dist/hooks/useFixedVirtualList.d.ts +0 -35
  585. package/dist/hooks/useFixedVirtualList.d.ts.map +0 -1
  586. package/dist/hooks/useShortcut.d.ts +0 -20
  587. package/dist/hooks/useShortcut.d.ts.map +0 -1
  588. package/dist/hooks/useTour/useTour-context-internal.d.ts +0 -7
  589. package/dist/hooks/useTour/useTour-context-internal.d.ts.map +0 -1
  590. package/dist/hooks/useTour/useTour-context.d.ts +0 -10
  591. package/dist/hooks/useTour/useTour-context.d.ts.map +0 -1
  592. package/dist/hooks/useTour/useTour-types.d.ts +0 -192
  593. package/dist/hooks/useTour/useTour-types.d.ts.map +0 -1
  594. package/dist/hooks/useTour/useTour.d.ts +0 -3
  595. package/dist/hooks/useTour/useTour.d.ts.map +0 -1
  596. package/dist/hooks/useVirtualListScroll.d.ts +0 -41
  597. package/dist/hooks/useVirtualListScroll.d.ts.map +0 -1
  598. package/dist/index.d.ts.map +0 -1
  599. package/dist/providers/ai-assistant/ai-assistant-prompts.d.ts +0 -8
  600. package/dist/providers/ai-assistant/ai-assistant-prompts.d.ts.map +0 -1
  601. package/dist/providers/ai-assistant/ai-assistant-types.d.ts +0 -78
  602. package/dist/providers/ai-assistant/ai-assistant-types.d.ts.map +0 -1
  603. package/dist/providers/ai-assistant/ai-assistant-validator.d.ts +0 -23
  604. package/dist/providers/ai-assistant/ai-assistant-validator.d.ts.map +0 -1
  605. package/dist/providers/ai-assistant/ai-chat-panel-types.d.ts +0 -25
  606. package/dist/providers/ai-assistant/ai-chat-panel-types.d.ts.map +0 -1
  607. package/dist/providers/ai-assistant/ai-chat-panel.d.ts +0 -3
  608. package/dist/providers/ai-assistant/ai-chat-panel.d.ts.map +0 -1
  609. package/dist/providers/shortcut/shortcut-context.d.ts +0 -7
  610. package/dist/providers/shortcut/shortcut-context.d.ts.map +0 -1
  611. package/dist/providers/shortcut/shortcut-provider.d.ts +0 -35
  612. package/dist/providers/shortcut/shortcut-provider.d.ts.map +0 -1
  613. package/dist/providers/theme/index.d.ts +0 -4
  614. package/dist/providers/theme/index.d.ts.map +0 -1
  615. package/dist/providers/theme/theme-provider-types.d.ts +0 -6
  616. package/dist/providers/theme/theme-provider-types.d.ts.map +0 -1
  617. package/dist/providers/theme/themeProvider.d.ts +0 -10
  618. package/dist/providers/theme/themeProvider.d.ts.map +0 -1
  619. package/dist/restio-ui.cjs.js +0 -183
  620. package/dist/restio-ui.es.js +0 -37303
  621. package/dist/test/vitest.utils.d.ts +0 -1
  622. package/dist/test/vitest.utils.d.ts.map +0 -1
  623. package/dist/types/global-types.d.ts +0 -42
  624. package/dist/types/global-types.d.ts.map +0 -1
  625. package/dist/types/storybook-types.d.ts +0 -2
  626. package/dist/types/storybook-types.d.ts.map +0 -1
  627. package/dist/utility-components/avatar/avatar-types.d.ts +0 -16
  628. package/dist/utility-components/avatar/avatar-types.d.ts.map +0 -1
  629. package/dist/utility-components/avatar/avatar.d.ts +0 -5
  630. package/dist/utility-components/avatar/avatar.d.ts.map +0 -1
  631. package/dist/utility-components/chip/chip-types.d.ts +0 -17
  632. package/dist/utility-components/chip/chip-types.d.ts.map +0 -1
  633. package/dist/utility-components/chip/chip.d.ts +0 -4
  634. package/dist/utility-components/chip/chip.d.ts.map +0 -1
  635. package/dist/utility-components/helper-text/helper-text-types.d.ts +0 -20
  636. package/dist/utility-components/helper-text/helper-text-types.d.ts.map +0 -1
  637. package/dist/utility-components/helper-text/helper-text.d.ts +0 -3
  638. package/dist/utility-components/helper-text/helper-text.d.ts.map +0 -1
  639. package/dist/utility-components/icon/icon-assets.d.ts +0 -2
  640. package/dist/utility-components/icon/icon-assets.d.ts.map +0 -1
  641. package/dist/utility-components/icon/icon-types.d.ts +0 -24
  642. package/dist/utility-components/icon/icon-types.d.ts.map +0 -1
  643. package/dist/utility-components/icon/icon.d.ts +0 -4
  644. package/dist/utility-components/icon/icon.d.ts.map +0 -1
  645. package/dist/utility-components/label/label-types.d.ts +0 -19
  646. package/dist/utility-components/label/label-types.d.ts.map +0 -1
  647. package/dist/utility-components/label/label.d.ts +0 -3
  648. package/dist/utility-components/label/label.d.ts.map +0 -1
  649. package/dist/utility-components/overlay-panel/overlay-panel-types.d.ts +0 -69
  650. package/dist/utility-components/overlay-panel/overlay-panel-types.d.ts.map +0 -1
  651. package/dist/utility-components/overlay-panel/overlay-panel.d.ts +0 -5
  652. package/dist/utility-components/overlay-panel/overlay-panel.d.ts.map +0 -1
  653. package/dist/utility-components/overlay-panel/use-focus-trap.d.ts +0 -8
  654. package/dist/utility-components/overlay-panel/use-focus-trap.d.ts.map +0 -1
  655. package/dist/utility-components/skeleton/skeleton-types.d.ts +0 -7
  656. package/dist/utility-components/skeleton/skeleton-types.d.ts.map +0 -1
  657. package/dist/utility-components/skeleton/skeleton.d.ts +0 -4
  658. package/dist/utility-components/skeleton/skeleton.d.ts.map +0 -1
  659. package/dist/utility-components/stack/stack-types.d.ts +0 -9
  660. package/dist/utility-components/stack/stack-types.d.ts.map +0 -1
  661. package/dist/utility-components/stack/stack.d.ts +0 -4
  662. package/dist/utility-components/stack/stack.d.ts.map +0 -1
  663. package/dist/utility-components/toast/toast-types.d.ts +0 -9
  664. package/dist/utility-components/toast/toast-types.d.ts.map +0 -1
  665. package/dist/utility-components/toast/toast.d.ts +0 -5
  666. package/dist/utility-components/toast/toast.d.ts.map +0 -1
  667. package/dist/utils/general.d.ts +0 -9
  668. package/dist/utils/general.d.ts.map +0 -1
  669. package/dist/utils/shortcut-utils.d.ts +0 -44
  670. package/dist/utils/shortcut-utils.d.ts.map +0 -1
package/dist/index.d.ts CHANGED
@@ -1,132 +1,3124 @@
1
- export { OTPComponent as OTP } from './components/otp/otp';
2
- export type { OTPProps } from './components/otp/otp-types';
3
- export { Banner } from './components/banner/banner';
4
- export type { BannerProps } from './components/banner/banner-types';
5
- export { Button } from './components/button/button';
6
- export type { ButtonProps } from './components/button/button-types';
7
- export { ButtonDropdown } from './components/button-dropdown/button-dropdown';
8
- export type { ButtonDropdownProps } from './components/button-dropdown/button-dropdown-types';
9
- export { Checkbox } from './components/checkbox/checkbox';
10
- export type { CheckboxProps } from './components/checkbox/checkbox-types';
11
- export { CheckboxGroup } from './components/checkbox-group/checkbox-group';
12
- export type { CheckboxGroupProps, CheckboxOption } from './components/checkbox-group/checkbox-group-types';
13
- export { Radio } from './components/radio/radio';
14
- export type { RadioProps } from './components/radio/radio-types';
15
- export { RadioGroup } from './components/radio-group/radio-group';
16
- export type { RadioGroupProps, RadioOption } from './components/radio-group/radio-group-types';
17
- export { AnchoredOverlay } from './components/anchored-overlay/anchored-overlay';
18
- export type { AnchoredOverlayProps } from './components/anchored-overlay/anchored-overlay-types';
19
- export { Kbd } from './components/kbd/kbd';
20
- export type { KbdProps } from './components/kbd/kbd-types';
21
- export { Icon } from './utility-components/icon/icon';
22
- export { type IconProps } from './utility-components/icon/icon-types';
23
- export { Avatar } from './utility-components/avatar/avatar';
24
- export type { AvatarProps } from './utility-components/avatar/avatar-types';
25
- export { Markdown } from './custom-components/markdown/markdown';
26
- export type { MarkdownProps } from './custom-components/markdown/markdown-types';
27
- export { Select } from './components/select/select';
28
- export type { SelectProps } from './components/select/select-types';
29
- export { ContributionHeatmap } from './experimental-components/contribution-heatmap/contribution-heatmap';
30
- export type { ContributionHeatmapProps } from './experimental-components/contribution-heatmap/contribution-heatmap-types';
31
- export { Typography } from './components/typography/typography';
32
- export type { TypographyProps } from './components/typography/typography-types';
33
- export { TextInput } from './components/input/text/input-text';
34
- export type { TextInputProps } from './components/input/text/input-text-types';
35
- export { NumberInput } from './components/input/number/input-number';
36
- export type { NumberInputProps } from './components/input/number/input-number-types';
37
- export { Label } from './utility-components/label/label';
38
- export type { LabelProps } from './utility-components/label/label-types';
39
- export { Timeline } from './custom-components/timeline/timeline';
40
- export type { TimelineProps } from './custom-components/timeline/timeline-types';
41
- export { Layout } from './custom-components/layout/layout';
42
- export type { LayoutProps, ResponsiveLayout, BlockNode, GridContainer, GridChild, Breakpoint } from './custom-components/layout/layout-types';
43
- export { useTour } from './hooks/useTour/useTour';
44
- export { TourProvider, useTourManager } from './hooks/useTour/useTour-context';
45
- export type { TourStep, TourPlacement, TourStepTrigger, TourProgress, TourOptions, TourInstance, TourPersistenceAdapter, TourAnalyticsAdapter, TourStepEvent, TourEvent, TourDropEvent, ManagedTourInfo, TourManagerInstance, } from './hooks/useTour/useTour-types';
46
- export { Stack } from './utility-components/stack/stack';
47
- export type { StackProps } from './utility-components/stack/stack-types';
48
- export { Menu } from './components/menu/menu';
49
- export type { MenuProps, MenuItem, MenuSubmenuProps } from './components/menu/menu-types';
50
- export { Chart } from './data-components/chart/chart';
51
- export type { ChartProps, ChartType, SankeyConfig, GeoConfig } from './data-components/chart/chart-types';
52
- export { default as Gantt } from './data-components/gantt/gantt';
53
- export type { GanttProps, GanttView, GanttRelationType, GanttDependency } from './data-components/gantt/gantt-types';
54
- export { TableGrid } from './data-components/table-grid/table-grid';
55
- export { TableGridRow } from './data-components/table-grid/row/table-grid-row';
56
- export { TableProvider } from './data-components/table-grid/table-grid-context';
57
- export type { TableGridProps, ColumnDef, TableRow, TableState, TableContextValue } from './data-components/table-grid/table-grid-types';
58
- export type { PivotConfig, PivotValueField, PivotAggregation, ComputedPivotData } from './data-components/table-grid/pivot/pivot-types';
59
- export type { AggregationFn } from './data-components/table-grid/aggregation/aggregation-utils';
60
- export type { AIProvider, ToolCall, ToolDefinition, ColumnSchema, ChatMessage, AIResponse, ExecutionResult, AIQuickAction, AITableContext } from './providers/ai-assistant/ai-assistant-types';
61
- export type { AIChatPanelProps } from './providers/ai-assistant/ai-chat-panel-types';
62
- export { AIChatPanel } from './providers/ai-assistant/ai-chat-panel';
63
- export { buildSystemPrompt } from './providers/ai-assistant/ai-assistant-prompts';
64
- export { validateToolCalls as validateToolCallsGeneric } from './providers/ai-assistant/ai-assistant-validator';
65
- export { createDataStructureFromFile } from './data-components/table-grid/external-functionalities/import/csv/createDataStructureFromFile';
66
- export { MockAIProvider } from './data-components/table-grid/ai-assistant/ai-assistant-mock';
67
- export { toolDefinitions as tableGridToolDefinitions } from './data-components/table-grid/ai-assistant/ai-assistant-tools';
68
- export { buildColumnSchema } from './data-components/table-grid/ai-assistant/ai-assistant-schema';
69
- export { Cell } from './data-components/cell/cell';
70
- export type { CellProps } from './data-components/cell/cell-types';
71
- export type { DataStructureComponent, DataStructureColumn, } from './data-components/data-structure/data-structure';
72
- export type { DataStructureUIConfig, DataStructureUIColumn, DataStructureUIRule, ResolvedCellUI, UIRuleOperator, } from './data-components/ui-layer/ui-layer-types';
73
- export { buildUIMap, useUIMap } from './data-components/ui-layer/ui-layer-utils';
74
- export { CellType } from './types/global-types';
75
- export type { Option, Size, State, ListItemVariant } from './types/global-types';
76
- export { DatePicker } from './components/input/date/date-picker';
77
- export { DateRangePicker } from './components/input/date/date-range-picker';
78
- export type { DatePickerProps, DateRangePickerProps, DatePickerMode } from './components/input/date/date-types';
79
- export { ShortcutProvider } from './providers/shortcut/shortcut-provider';
80
- export { useShortcut } from './hooks/useShortcut';
81
- export { useDynamicVirtualList } from './hooks/useDynamicVirtualList';
82
- export type { DynamicVirtualItem, UseDynamicVirtualListOptions, UseDynamicVirtualListResult } from './hooks/useDynamicVirtualList';
83
- export type { ShortcutConfig, ShortcutTooltipProps, ShortcutContextValue, UseShortcutOptions } from './custom-components/shortcut-tooltip/shortcut-tooltip-types';
84
- export { AppBar } from './framework-components/appbar/appbar';
85
- export type { AppBarProps, AppBarTitleProps, AppBarActionsProps, AppBarMenuButtonProps } from './framework-components/appbar/appbar-types';
86
- export { Breadcrumbs } from './framework-components/breadcrumbs/breadcrumbs';
87
- export type { BreadcrumbsProps, BreadcrumbItem } from './framework-components/breadcrumbs/breadcrumbs-types';
88
- export { Sidebar } from './framework-components/sidebar/sidebar';
89
- export type { SidebarProps, SectionProps as SidebarSectionProps, UserProps } from './framework-components/sidebar/sidebar-types';
90
- export { Scaffold } from './framework-components/scaffold/scaffold';
91
- export { useScaffold } from './framework-components/scaffold/scaffold-context';
92
- export type { ScaffoldProps, ScaffoldContextValue } from './framework-components/scaffold/scaffold-types';
93
- export { Section } from './framework-components/section/section';
94
- export type { SectionProps } from './framework-components/section/section-types';
95
- export { MindTree } from './custom-components/mindmap/mind-tree';
96
- export type { TreeNode, LayoutNode, MindTreeProps, TreeLayout, ReingoldTilfordConfig } from './custom-components/mindmap/mind-tree-types';
97
- export { Calendar } from './data-components/calendar/calendar';
98
- export type { CalendarProps } from './data-components/calendar/calendar-types';
99
- export { Form } from './data-components/form/form';
100
- export type { FormProps, FormColumn, FormChangeResponse, FormColumnDelta } from './data-components/form/form-types';
101
- export { SelectionGrid } from './components/selection-grid/selection-grid';
102
- export type { SelectionGridProps } from './components/selection-grid/selection-grid-types';
103
- export { CardList } from './data-components/card-list/card-list';
104
- export type { CardListProps } from './data-components/card-list/card-list-types';
105
- export { Switcher } from './data-components/switcher/switcher';
106
- export type { SwitcherProps, DataComponentId, ComponentSpecificPropsMap } from './data-components/switcher/switcher-types';
107
- export { DataComponentConfigurator } from './data-components/data-component-configurator/data-component-configurator';
108
- export type { DataComponentConfiguratorProps } from './data-components/data-component-configurator/data-component-configurator-types';
109
- export { propSchemaRegistry, dataComponentMetaList } from './data-components/switcher/prop-schema/prop-schema';
110
- export type { PropFieldDescriptor, PropFieldScope, PropSchemaRegistry } from './data-components/switcher/prop-schema/prop-schema-types';
111
- export { filterSchemaByScope, buildDefaultPropsFromSchema, mergeWithSchemaDefaults } from './data-components/switcher/prop-schema/prop-schema-utils';
112
- export { FileUpload } from './components/file-upload/file-upload';
113
- export { Workflow } from './custom-components/workflow/workflow';
114
- export type { WorkflowProps, WorkflowNode, PositionedNode, ConnectionPoint, WorkflowNodeProps, WorkflowNodeType, WorkflowAction, WorkflowActionType, ApiAction, ApiActionConfig, TransformAction, TransformActionConfig, WaitAction, WaitActionConfig, NotificationAction, NotificationActionConfig, ConditionAction, ConditionActionConfig, } from './custom-components/workflow/workflow-types';
115
- export type { WorkflowLayout, WorkflowEdge, WorkflowEdgeType, WorkflowCondition, WorkflowContext, } from './custom-components/workflow/layout/workflow-layout-types';
116
- export { WorkflowToolbar } from './custom-components/workflow/toolbar/workflow-toolbar';
117
- export type { WorkflowToolbarProps, WorkflowMode } from './custom-components/workflow/toolbar/workflow-toolbar-types';
118
- export { WorkflowPanel } from './custom-components/workflow/panel/workflow-panel';
119
- export type { WorkflowPanelProps } from './custom-components/workflow/panel/workflow-panel-types';
120
- export { validateWorkflow, getReachableNodes, getTopologicalOrder } from './custom-components/workflow/utils/workflow-validation';
121
- export type { ValidationResult, ValidationError, ValidationWarning } from './custom-components/workflow/utils/workflow-validation';
122
- export { ProgressBar } from './components/progress-bar/progress-bar';
123
- export type { ProgressBarProps } from './components/progress-bar/progress-bar-types';
124
- export { Dashboard } from './framework-components/dashboard/dashboard';
125
- export type { DashboardProps, DashboardContextValue } from './framework-components/dashboard/dashboard-types';
126
- export { useDashboard } from './framework-components/dashboard/dashboard-context';
127
- export { DashboardWidget } from './framework-components/dashboard/dashboard-widget';
128
- export type { DashboardWidgetProps, DashboardWidgetRenderPayload } from './framework-components/dashboard/dashboard-widget-types';
129
- export { DashboardBuilder } from './experimental-components/dashboard-builder/dashboard-builder';
130
- export type { DashboardBuilderProps, DashboardConfig, DashboardWidgetConfig, WidgetComponentType, WidgetTypeDescriptor, WidgetPosition, WidgetActionDefaults, DataSourceDefinition, DataSourceField, DataSourceRegistry, FieldFormat, DashboardBuilderState, DashboardTemplate, } from './experimental-components/dashboard-builder/dashboard-builder-types';
131
- export { DASHBOARD_CONFIG_VERSION } from './experimental-components/dashboard-builder/dashboard-builder-types';
132
- //# sourceMappingURL=index.d.ts.map
1
+ import * as React$1 from 'react';
2
+ import React__default, { ReactNode, UIEventHandler, Ref } from 'react';
3
+
4
+ /**
5
+ * OTP Component Props
6
+ */
7
+ interface OTPProps {
8
+ /**
9
+ * Length of the OTP code (number of input fields)
10
+ * @default 6
11
+ */
12
+ length?: number;
13
+ /**
14
+ * Callback triggered when OTP value changes
15
+ * @param value - The current OTP value
16
+ */
17
+ onChange?: (value: string) => void;
18
+ /**
19
+ * Callback triggered when OTP is completely filled
20
+ * @param value - The complete OTP value
21
+ */
22
+ onComplete?: (value: string) => void;
23
+ /**
24
+ * ARIA label for the OTP container
25
+ * @default 'One-time password input'
26
+ */
27
+ ariaLabel?: string;
28
+ /**
29
+ * Class name for the container
30
+ */
31
+ className?: string;
32
+ }
33
+
34
+ declare const OTPComponent: React__default.FC<OTPProps>;
35
+
36
+ /** Interface for an option in a component */
37
+ interface Option {
38
+ value: string;
39
+ /** Human-readable label shown in the UI; falls back to `value` when omitted. */
40
+ label?: string;
41
+ id?: string;
42
+ leadingVisual?: string;
43
+ imageSrc?: string;
44
+ imageAlt?: string;
45
+ description?: string;
46
+ disabled?: boolean;
47
+ children?: Option[];
48
+ onClick?: (option: Option) => void;
49
+ }
50
+ type ListItemVariant = "default" | "with-image" | "with-description";
51
+ /** Sizing values */
52
+ type Size = "extraSmall" | "small" | "default" | "large" | "extraLarge";
53
+ /** Edit mode for interactive cell components */
54
+ type EditMode = 'click' | 'doubleClick' | 'always' | 'never';
55
+ /** State for component */
56
+ type State = "base" | "success" | "warning" | "danger" | "info" | "idle";
57
+ type ChartType = "line" | "bar" | "pie" | "area" | "scatter" | "sankey" | "sparkline" | "geo" | "composed";
58
+ type ComposedSeriesType = "line" | "bar" | "area" | "scatter";
59
+ declare const CellType: {
60
+ readonly SELECT: "SELECT";
61
+ readonly MULTI_SELECT: "MULTI_SELECT";
62
+ readonly BUTTON_GROUP: "BUTTON_GROUP";
63
+ readonly TEXT: "TEXT";
64
+ readonly TEXTAREA: "TEXTAREA";
65
+ readonly NUMBER: "NUMBER";
66
+ readonly DATE: "DATE";
67
+ readonly DATE_RANGE: "DATE_RANGE";
68
+ readonly IMAGE: "IMAGE";
69
+ readonly TABLE_GRID: "TABLE_GRID";
70
+ readonly CHART: "CHART";
71
+ readonly CHART_SERIES: "CHART_SERIES";
72
+ readonly PROGRESS: "PROGRESS";
73
+ readonly CHECKBOX_GROUP: "CHECKBOX_GROUP";
74
+ readonly CHECKBOX: "CHECKBOX";
75
+ readonly RADIO_GROUP: "RADIO_GROUP";
76
+ readonly COLORS: "COLORS";
77
+ readonly SPARKLINE: "SPARKLINE";
78
+ readonly BUTTON_DROPDOWN: "BUTTON_DROPDOWN";
79
+ readonly BUTTON: "BUTTON";
80
+ readonly TAG: "TAG";
81
+ };
82
+ type CellType = typeof CellType[keyof typeof CellType];
83
+ /**
84
+ * Alignment options for anchoring elements
85
+ */
86
+ type anchorAlign = 'top' | 'center' | 'bottom';
87
+ type AnchorPosition = 'left' | 'center' | 'right';
88
+ /** Responsive layout breakpoint */
89
+ type Breakpoint = 'mobile' | 'tablet' | 'desktop';
90
+
91
+ interface BannerProps {
92
+ variant?: State | "info";
93
+ action?: string;
94
+ title?: string;
95
+ description?: React.ReactNode;
96
+ dismissable?: boolean;
97
+ /** Optional callback fired when the banner is dismissed */
98
+ onDismiss?: () => void;
99
+ /** Optional label for the link; defaults to "Learn more" */
100
+ linkLabel?: string;
101
+ }
102
+
103
+ declare const Banner: React__default.FC<BannerProps>;
104
+
105
+ type ButtonVariant = "base" | "primary" | "danger" | "invisible" | "link";
106
+ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
107
+ alignContent?: 'start' | 'center';
108
+ leadingVisual?: string;
109
+ trailingVisual?: string;
110
+ loading?: boolean;
111
+ size?: Size;
112
+ variant?: ButtonVariant;
113
+ disabled?: boolean;
114
+ /** State where interaction and animation are disabled */
115
+ readOnly?: boolean;
116
+ count?: number;
117
+ }
118
+
119
+ declare const Button: React__default.FC<ButtonProps>;
120
+
121
+ interface ButtonGroupProps {
122
+ options: Option[];
123
+ value?: string;
124
+ defaultValue?: string;
125
+ onChange?: (value: string) => void;
126
+ variant?: "base" | "primary" | "secondary";
127
+ size?: Size;
128
+ alignContent?: "center" | "left" | "right";
129
+ disabled?: boolean;
130
+ /**
131
+ * If true, only icons will be displayed in the button group
132
+ */
133
+ readonly iconOnly?: boolean;
134
+ }
135
+
136
+ declare const ButtonGroup: React__default.FC<ButtonGroupProps>;
137
+
138
+ interface ButtonDropdownProps {
139
+ /** Currently selected value */
140
+ value?: string;
141
+ /** Available options */
142
+ options: Option[];
143
+ /** Callback when selection changes */
144
+ onChange?: (value: string) => void;
145
+ /** Button variant */
146
+ variant?: "base" | "primary" | "danger" | "invisible" | "link";
147
+ /** Button size */
148
+ size?: Size;
149
+ /** Placeholder text when no value is selected */
150
+ placeholder?: string;
151
+ /** Whether the dropdown is disabled */
152
+ disabled?: boolean;
153
+ /** Additional CSS class */
154
+ className?: string;
155
+ }
156
+
157
+ /**
158
+ * A button that opens a dropdown menu to select a single value.
159
+ * Flat component — not a form field. Use Select for form contexts.
160
+ */
161
+ declare const ButtonDropdown: React__default.FC<ButtonDropdownProps>;
162
+
163
+ interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange"> {
164
+ /** Whether the checkbox is checked */
165
+ checked?: boolean;
166
+ /** Whether the checkbox is in indeterminate state */
167
+ indeterminate?: boolean;
168
+ /** Size of the checkbox */
169
+ size?: Size;
170
+ /** Whether the checkbox is disabled */
171
+ disabled?: boolean;
172
+ /** Error state for the checkbox */
173
+ error?: boolean;
174
+ /** Callback when the checkbox value changes */
175
+ onChange?: (checked: boolean) => void;
176
+ }
177
+
178
+ declare const Checkbox: React__default.FC<CheckboxProps>;
179
+
180
+ interface CheckboxOption {
181
+ /** Value of the checkbox option */
182
+ value: string;
183
+ /** Label to display next to the checkbox */
184
+ label: string;
185
+ /** Whether this option is disabled */
186
+ disabled?: boolean;
187
+ }
188
+ interface CheckboxGroupProps {
189
+ /** Array of checkbox options */
190
+ options: CheckboxOption[];
191
+ /** Currently selected values */
192
+ value?: string[];
193
+ /** Size of each checkbox */
194
+ size?: Size;
195
+ /** Whether all checkboxes are disabled */
196
+ disabled?: boolean;
197
+ /** Error state for all checkboxes */
198
+ error?: boolean;
199
+ /** Whether the group is read-only (visual only, no interaction) */
200
+ readOnly?: boolean;
201
+ /** Callback when selection changes */
202
+ onChange?: (selectedValues: string[]) => void;
203
+ /** Additional class name */
204
+ className?: string;
205
+ }
206
+
207
+ /**
208
+ * A group of checkboxes that allows multiple selection.
209
+ * Manages the selection state and renders a list of Checkbox components.
210
+ */
211
+ declare const CheckboxGroup: React__default.FC<CheckboxGroupProps>;
212
+
213
+ interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "onChange" | "type"> {
214
+ /** Whether the radio is checked */
215
+ checked?: boolean;
216
+ /** Size of the radio */
217
+ size?: Size;
218
+ /** Whether the radio is disabled */
219
+ disabled?: boolean;
220
+ /** Error state for the radio */
221
+ error?: boolean;
222
+ /** Callback when the radio value changes */
223
+ onChange?: (checked: boolean) => void;
224
+ }
225
+
226
+ /**
227
+ * A styled radio input component.
228
+ * Supports size variants, disabled, and error states.
229
+ */
230
+ declare const Radio: React__default.FC<RadioProps>;
231
+
232
+ interface RadioOption {
233
+ /** Value of the radio option */
234
+ value: string;
235
+ /** Label to display next to the radio */
236
+ label: string;
237
+ /** Whether this option is disabled */
238
+ disabled?: boolean;
239
+ }
240
+ interface RadioGroupProps {
241
+ /** Array of radio options */
242
+ options: RadioOption[];
243
+ /** Currently selected value */
244
+ value?: string;
245
+ /** Name attribute for the radio group (used for HTML radio behavior) */
246
+ name?: string;
247
+ /** Size of each radio */
248
+ size?: Size;
249
+ /** Whether all radios are disabled */
250
+ disabled?: boolean;
251
+ /** Error state for all radios */
252
+ error?: boolean;
253
+ /** Whether the group is read-only (visual only, no interaction) */
254
+ readOnly?: boolean;
255
+ /** Callback when selection changes */
256
+ onChange?: (value: string) => void;
257
+ /** Additional class name */
258
+ className?: string;
259
+ }
260
+
261
+ /**
262
+ * A group of radios that allows single selection.
263
+ * Manages the selection state and renders a list of Radio components.
264
+ */
265
+ declare const RadioGroup: React__default.FC<RadioGroupProps>;
266
+
267
+ interface AnchoredOverlayProps {
268
+ /** The anchor element that triggers the overlay */
269
+ anchor: React__default.ReactNode;
270
+ /** The target element to display as the overlay */
271
+ target: React__default.ReactNode;
272
+ /** Whether the overlay is open/visible */
273
+ isOpen?: boolean;
274
+ /** Callback when the overlay should be closed */
275
+ onClose?: () => void;
276
+ /** The positioning side of the target relative to anchor */
277
+ position?: AnchorPosition;
278
+ /** The alignment of the target relative to anchor */
279
+ align?: anchorAlign;
280
+ /** Additional CSS class for the container */
281
+ className?: string;
282
+ /** Custom anchor name for CSS anchoring (optional, generated if not provided) */
283
+ anchorName?: string;
284
+ /** Duration of open/close animation in ms. */
285
+ animationDuration?: number;
286
+ }
287
+
288
+ declare const AnchoredOverlay: React__default.FC<AnchoredOverlayProps>;
289
+
290
+ /** Props for the OverlayPanel.Footer sub-component. */
291
+ interface OverlayPanelFooterProps {
292
+ /** Footer content — typically action buttons (primary, secondary, etc.). */
293
+ children: React__default.ReactNode;
294
+ }
295
+
296
+ /** Standard footer for OverlayPanel. Compose as a child of OverlayPanel */
297
+ declare const OverlayPanelFooter: React__default.FC<OverlayPanelFooterProps>;
298
+
299
+ /** Props for the OverlayPanel.Header sub-component.*/
300
+ interface OverlayPanelHeaderProps {
301
+ /** Panel title shown on the left. Accepts string or custom node. */
302
+ title: React__default.ReactNode;
303
+ /** Called when the close button is clicked. If omitted, no close button is rendered. */
304
+ onClose?: () => void;
305
+ /** Optional actions (buttons, etc.) rendered before the close button. */
306
+ actions?: React__default.ReactNode;
307
+ /** Whether to show the close button. Defaults to true when onClose is provided. */
308
+ showClose?: boolean;
309
+ }
310
+
311
+ /** Standard header for OverlayPanel. Compose as a child of OverlayPanel */
312
+ declare const OverlayPanelHeader: React__default.FC<OverlayPanelHeaderProps>;
313
+
314
+ /** OverlayPanelPosition defines the possible positions for the OverlayPanel. */
315
+ type OverlayPanelPosition = "center" | "left" | "right" | "top" | "bottom";
316
+ /**
317
+ * OverlayPanelVariant defines the visual and behavioral variant for the OverlayPanel.
318
+ * - "modal": Center modal with backdrop, traps focus, blocks interaction.
319
+ * - "dialog": Center dialog, lighter backdrop, may allow outside click to close.
320
+ * - "sidepanel": Left/right slide-in panel, typically with backdrop.
321
+ * - "drawer": Mobile-friendly drawer, usually slides from bottom or side.
322
+ * - "popover": Light overlay, anchored to element, minimal/no backdrop.
323
+ */
324
+ type OverlayPanelVariant = "modal" | "dialog" | "sidepanel" | "drawer" | "popover";
325
+ /** Props for the OverlayPanel component.*/
326
+ interface OverlayPanelProps {
327
+ /** Whether the panel is open (visible). */
328
+ open: boolean;
329
+ /** Position of the panel in the viewport. */
330
+ position?: OverlayPanelPosition;
331
+ /** Visual and behavioral variant of the panel. */
332
+ variant?: OverlayPanelVariant;
333
+ /** Custom width for the panel (CSS value or number in px). */
334
+ width?: string | number;
335
+ /** Custom height for the panel (CSS value or number in px). */
336
+ height?: string | number;
337
+ /** Maximum width for the panel. */
338
+ maxWidth?: string | number;
339
+ /** Maximum height for the panel. */
340
+ maxHeight?: string | number;
341
+ /** If true, clicking outside the panel closes it. */
342
+ closeOnClickOutside?: boolean;
343
+ /** If true, pressing Escape closes the panel. */
344
+ closeOnEscape?: boolean;
345
+ /** If true, shows a backdrop behind the panel. When false, users can interact with the background. Defaults to true for modal/dialog/sidepanel/drawer, false for popover. */
346
+ hasBackdrop?: boolean;
347
+ /** If true, prevents body scroll when panel is open. */
348
+ preventBodyScroll?: boolean;
349
+ /** If true, traps focus within the panel when open. */
350
+ trapFocus?: boolean;
351
+ /** If true, restores focus to the trigger element on close. */
352
+ restoreFocus?: boolean;
353
+ /** Duration of open/close animation in ms. */
354
+ animationDuration?: number;
355
+ /** Called when the panel is closed. */
356
+ onClose?: () => void;
357
+ /** Called when the panel is opened. */
358
+ onOpen?: () => void;
359
+ /** Called when the open/close animation completes. */
360
+ onAnimationComplete?: () => void;
361
+ /** Panel content. */
362
+ children: React.ReactNode;
363
+ /** Additional className for the panel container. */
364
+ className?: string;
365
+ /** Accessible label for the panel. */
366
+ "aria-label"?: string;
367
+ /** Accessible labelledby for the panel. */
368
+ "aria-labelledby"?: string;
369
+ /** Accessible describedby for the panel. */
370
+ "aria-describedby"?: string;
371
+ }
372
+ /** OverlayPanelComponent defines the main OverlayPanel component with Header and Footer sub-components. */
373
+ type OverlayPanelComponent = React.FC<OverlayPanelProps> & {
374
+ Header: typeof OverlayPanelHeader;
375
+ Footer: typeof OverlayPanelFooter;
376
+ };
377
+
378
+ declare const OverlayPanel: OverlayPanelComponent;
379
+
380
+ interface KbdProps extends React.HTMLAttributes<HTMLElement> {
381
+ /**
382
+ * The keyboard key or combination to display
383
+ */
384
+ children: string;
385
+ }
386
+
387
+ declare const Kbd: React__default.FC<KbdProps>;
388
+
389
+ interface IconProps {
390
+ /**
391
+ * Icon name for SVG file or URL for image
392
+ */
393
+ src: string;
394
+ /**
395
+ * Manage disabled state
396
+ */
397
+ disabled?: boolean;
398
+ /**
399
+ * Manage disabled state
400
+ */
401
+ state?: State;
402
+ /**
403
+ * Width of the icon
404
+ */
405
+ width?: string;
406
+ /**
407
+ * Height of the icon
408
+ */
409
+ height?: string;
410
+ }
411
+
412
+ declare const Icon: React__default.FC<IconProps>;
413
+
414
+ interface sharedInputProps {
415
+ autoFocus?: boolean;
416
+ placeholder?: string;
417
+ className?: string;
418
+ error?: string;
419
+ leadingIcon?: string;
420
+ trailingIcon?: string;
421
+ size?: Size;
422
+ disabled?: boolean;
423
+ /** Whether the input is read-only. */
424
+ readOnly?: boolean;
425
+ onBlur?: () => void;
426
+ onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
427
+ }
428
+
429
+ interface NumberInputProps extends sharedInputProps {
430
+ value: number | undefined;
431
+ onChange: (value: number | undefined) => void;
432
+ min?: number;
433
+ max?: number;
434
+ }
435
+
436
+ declare const NumberInput: React__default.FC<NumberInputProps>;
437
+
438
+ type DatePickerMode = "day" | "month" | "quarter" | "year";
439
+ interface DateRange {
440
+ from: Date | undefined;
441
+ to: Date | undefined;
442
+ }
443
+ interface DatePickerProps extends sharedInputProps {
444
+ value: Date | undefined;
445
+ onChange: (value: Date | undefined) => void;
446
+ mode?: DatePickerMode;
447
+ shortcuts?: boolean;
448
+ readOnly?: boolean;
449
+ /** Controlled open state. When provided, the calendar overlay is controlled externally. */
450
+ open?: boolean;
451
+ /** Initial open state for the uncontrolled calendar overlay. */
452
+ defaultOpen?: boolean;
453
+ /** Notifies open/close changes. Only meaningful when `open` is provided. */
454
+ onOpenChange?: (open: boolean) => void;
455
+ }
456
+ interface DateRangePickerProps extends Omit<sharedInputProps, "onKeyDown"> {
457
+ value: DateRange;
458
+ onChange: (value: DateRange) => void;
459
+ mode?: DatePickerMode;
460
+ shortcuts?: boolean;
461
+ readOnly?: boolean;
462
+ /** Controlled open state. When provided, the calendar overlay is controlled externally. */
463
+ open?: boolean;
464
+ /** Initial open state for the uncontrolled calendar overlay. */
465
+ defaultOpen?: boolean;
466
+ /** Notifies open/close changes. Only meaningful when `open` is provided. */
467
+ onOpenChange?: (open: boolean) => void;
468
+ }
469
+
470
+ /**
471
+ * Single-date picker supporting day, month, quarter, and year modes.
472
+ * Renders a styled text input and opens a calendar overlay on focus/click.
473
+ */
474
+ declare const DatePicker: React__default.FC<DatePickerProps>;
475
+
476
+ /**
477
+ * Date range picker supporting day, month, quarter, and year modes.
478
+ * Shows two calendars side-by-side for range selection.
479
+ * Clicking once sets the start date; clicking again sets the end date.
480
+ */
481
+ declare const DateRangePicker: React__default.FC<DateRangePickerProps>;
482
+
483
+ interface LabelProps {
484
+ /**
485
+ * The value of the label field
486
+ */
487
+ label: string;
488
+ /**
489
+ * The id for the htmlFor field
490
+ */
491
+ id: string;
492
+ /**
493
+ * Manage disabled state
494
+ */
495
+ disabled?: boolean;
496
+ /**
497
+ * Indicate if the field is required
498
+ */
499
+ required?: boolean;
500
+ }
501
+
502
+ declare const Label: React.FC<LabelProps>;
503
+
504
+ interface StackProps {
505
+ children: React.ReactNode;
506
+ direction?: "row" | "column";
507
+ gap?: Size | "zero";
508
+ align?: React.CSSProperties["alignItems"];
509
+ justify?: React.CSSProperties["justifyContent"];
510
+ wrap?: boolean;
511
+ className?: string;
512
+ }
513
+
514
+ /**
515
+ * Arranges children in a flex row or column with consistent spacing.
516
+ * Uses design-system gap tokens (`--rst-space-*`) instead of inline rem values.
517
+ */
518
+ declare const Stack: React__default.FC<StackProps>;
519
+
520
+ interface MenuItem {
521
+ id?: string;
522
+ label?: string;
523
+ leadingVisual?: string;
524
+ disabled?: boolean;
525
+ children?: MenuItem[];
526
+ onClick?: (item: MenuItem) => void;
527
+ type?: "item" | "separator";
528
+ shortcut?: string[];
529
+ content?: React__default.ReactNode;
530
+ }
531
+ interface MenuProps extends React__default.HTMLAttributes<HTMLDivElement> {
532
+ onItemClick?: (item: MenuItem) => void;
533
+ }
534
+ interface MenuSubmenuProps extends React__default.HTMLAttributes<HTMLDivElement> {
535
+ trigger: React__default.ReactNode;
536
+ position?: AnchorPosition;
537
+ align?: anchorAlign;
538
+ }
539
+
540
+ declare const Menu: React__default.FC<MenuProps> & {
541
+ Item: React__default.FC<MenuItem>;
542
+ Separator: React__default.FC<React__default.HTMLAttributes<HTMLHRElement>>;
543
+ Submenu: React__default.FC<MenuSubmenuProps>;
544
+ };
545
+
546
+ interface SelectionGridProps {
547
+ /** Array of selectable options */
548
+ options: Option[];
549
+ /** Currently selected value(s). Single string for single-select, string[] for multi-select. */
550
+ value?: string | string[];
551
+ /** Callback when selection changes */
552
+ onChange?: (value: string | string[]) => void;
553
+ /** Allow multiple selection */
554
+ multiple?: boolean;
555
+ /** Number of grid columns */
556
+ columns?: number;
557
+ /** Size of each item */
558
+ size?: Size;
559
+ /** Disable all interactions */
560
+ disabled?: boolean;
561
+ /** Additional class name */
562
+ className?: string;
563
+ }
564
+
565
+ /**
566
+ * A grid of selectable items supporting single and multiple selection.
567
+ * Behaves like a selection list but laid out in a grid.
568
+ */
569
+ declare const SelectionGrid: React__default.FC<SelectionGridProps>;
570
+
571
+ interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
572
+ /**
573
+ * Title of the upload area
574
+ */
575
+ title?: string;
576
+ /**
577
+ * List of accepted file extensions (e.g. ['.csv', '.txt'])
578
+ */
579
+ acceptedFileTypes?: string[];
580
+ /**
581
+ * Max file size in bytes
582
+ */
583
+ maxFileSize?: number;
584
+ /**
585
+ * Max number of files allowed
586
+ */
587
+ maxFiles?: number;
588
+ /**
589
+ * Callback when files are changed
590
+ */
591
+ onFilesChange?: (files: File[]) => void;
592
+ /**
593
+ * Custom trigger component to open file dialog.
594
+ * If provided, it renders this element which triggers the file input on click.
595
+ */
596
+ trigger?: React.ReactNode;
597
+ /**
598
+ * State of the component
599
+ */
600
+ state?: State;
601
+ /**
602
+ * Icon name to display
603
+ */
604
+ icon?: string;
605
+ }
606
+
607
+ declare const FileUpload: React__default.FC<FileUploadProps>;
608
+
609
+ interface ProgressBarProps {
610
+ /** Current progress value */
611
+ value: number;
612
+ /** Minimum value of the range. Defaults to 0. */
613
+ min?: number;
614
+ /** Maximum value of the range. Defaults to 100. */
615
+ max?: number;
616
+ /** Visual variant for color theming */
617
+ variant?: State;
618
+ /** Whether the progress bar is in an indeterminate loading state */
619
+ indeterminate?: boolean;
620
+ /** Whether to show the header with percentage (left) and value (right) above the bar */
621
+ showLabel?: boolean;
622
+ /** Custom label text (overrides the percentage on the left) */
623
+ label?: string;
624
+ /** Custom formatter for the value shown on the right */
625
+ formatValue?: (value: number) => string;
626
+ /** Height of the progress bar */
627
+ height?: number;
628
+ /** Whether the component is disabled */
629
+ disabled?: boolean;
630
+ /** Additional CSS class name */
631
+ className?: string;
632
+ }
633
+
634
+ /**
635
+ * ProgressBar component for displaying progress visually.
636
+ */
637
+ declare const ProgressBar: React__default.FC<ProgressBarProps>;
638
+
639
+ interface TagProps {
640
+ value: string | number;
641
+ src?: string;
642
+ state: State;
643
+ size?: Size;
644
+ clearable?: boolean;
645
+ onClear?: () => void;
646
+ }
647
+
648
+ declare const Tag: React__default.FC<TagProps>;
649
+
650
+ /**
651
+ * Props for the ShortcutProvider component
652
+ */
653
+ interface ShortcutProviderProps {
654
+ readonly children: React__default.ReactNode;
655
+ }
656
+ /**
657
+ * ShortcutProvider manages global keyboard shortcuts and displays visual feedback tooltips.
658
+ *
659
+ * Features:
660
+ * - Global and component-scoped shortcuts
661
+ * - Visual feedback with tooltips appearing near cursor
662
+ * - Hold-to-execute shortcuts with progress indicators (3s default)
663
+ * - Automatic cleanup of component-scoped shortcuts
664
+ * - Key release detection for cancelling hold shortcuts
665
+ *
666
+ * How it works:
667
+ * 1. Maintains a map of registered shortcuts with their configurations
668
+ * 2. Tracks active components for scoping validation
669
+ * 3. Listens for keyboard events and matches against registered shortcuts
670
+ * 4. Shows tooltip with shortcut keys and function name near cursor
671
+ * 5. Executes actions only after full hold duration (for hold shortcuts)
672
+ * 6. Cancels hold shortcuts when any key is released
673
+ *
674
+ * Component Scoping:
675
+ * - Global shortcuts (no componentId) always available
676
+ * - Component shortcuts only trigger when their component is registered as active
677
+ * - Components auto-register/unregister through useShortcut hook focus/hover handlers
678
+ *
679
+ * @param children - Child components that will have access to shortcut context
680
+ */
681
+ declare const ShortcutProvider: React__default.FC<ShortcutProviderProps>;
682
+
683
+ /**
684
+ * Configuration for a keyboard shortcut
685
+ */
686
+ interface ShortcutConfig {
687
+ /** Display name for the shortcut action */
688
+ readonly name: string;
689
+ /** Function to execute when shortcut is triggered */
690
+ readonly action: () => void | Promise<void>;
691
+ /** Optional hold duration in milliseconds - if provided, user must hold keys for this duration */
692
+ readonly holdDuration?: number;
693
+ }
694
+ /**
695
+ * Options for configuring shortcut behavior in useShortcut hook
696
+ */
697
+ interface UseShortcutOptions {
698
+ /**
699
+ * Scope of the shortcuts:
700
+ * - 'component': Shortcuts only work when this component is focused or hovered
701
+ * - 'global': Shortcuts work globally across the application
702
+ */
703
+ scope?: 'global' | 'component';
704
+ /** Whether shortcuts are enabled */
705
+ enabled?: boolean;
706
+ }
707
+
708
+ /**
709
+ * Hook for registering keyboard shortcuts with automatic lifecycle management
710
+ *
711
+ * @param options - Configuration options for shortcut behavior
712
+ * @returns Object with register, unregister, activate, deactivate, and trigger functions
713
+ */
714
+ declare const useShortcut: (options?: UseShortcutOptions) => {
715
+ /** Register a new keyboard shortcut */
716
+ register: (keys: string, config: ShortcutConfig) => void;
717
+ /** Unregister an existing keyboard shortcut */
718
+ unregister: (keys: string) => void;
719
+ /** Programmatically trigger a shortcut (for testing or manual execution) */
720
+ trigger: (keys: string) => void;
721
+ /** Activate component-scoped shortcuts (attach to onFocus/onMouseEnter) */
722
+ activate: () => void;
723
+ /** Deactivate component-scoped shortcuts (attach to onBlur/onMouseLeave) */
724
+ deactivate: () => void;
725
+ };
726
+
727
+ interface DynamicVirtualItem {
728
+ /** Original item index in the full list */
729
+ index: number;
730
+ /** Top offset from the top of the total scrollable area, in pixels */
731
+ start: number;
732
+ /** Measured (or estimated) height in pixels */
733
+ size: number;
734
+ }
735
+ interface UseDynamicVirtualListOptions {
736
+ /** Total number of items in the list */
737
+ count: number;
738
+ /** Fallback height used for items that have not been measured yet */
739
+ estimatedItemHeight?: number;
740
+ /**
741
+ * Extra items rendered above and below the visible viewport.
742
+ * A larger value makes scrolling smoother at the cost of slightly more DOM nodes.
743
+ * Defaults to 10.
744
+ */
745
+ overscan?: number;
746
+ }
747
+ interface UseDynamicVirtualListResult {
748
+ /** Items that should be rendered right now */
749
+ virtualItems: DynamicVirtualItem[];
750
+ /** Total scrollable height in pixels (for the spacer element) */
751
+ totalSize: number;
752
+ /** Attach this ref to the scrollable container div */
753
+ containerRef: React.RefObject<HTMLDivElement | null>;
754
+ /** Attach this handler to the scrollable container's onScroll */
755
+ onScroll: (e: React.UIEvent<HTMLDivElement>) => void;
756
+ /**
757
+ * Callback ref to attach to each rendered item element.
758
+ * Call with `(el, index)` — el will be null when the item unmounts.
759
+ */
760
+ measureElement: (el: Element | null, index: number) => void;
761
+ /** Scroll the container so the given index is in view */
762
+ scrollToIndex: (index: number) => void;
763
+ /** First rendered index (including overscan) */
764
+ startIndex: number;
765
+ /** Last rendered index (including overscan) */
766
+ endIndex: number;
767
+ /** Cumulative top offsets for every item. offsets[i] = top of item i, offsets[count] = totalSize */
768
+ offsets: Float64Array;
769
+ /** Current scrollTop of the container (pixels) */
770
+ scrollTop: number;
771
+ }
772
+ /**
773
+ * A dynamic-height virtual list hook inspired by TanStack Virtual.
774
+ *
775
+ * Unlike fixed-height virtualizers, this hook uses a ResizeObserver to measure
776
+ * each rendered item's actual height and falls back to `estimatedItemHeight` for
777
+ * items that have not yet been rendered. This allows rows with variable content
778
+ * (wrapped text, expandable cells, group headers) to scroll correctly.
779
+ *
780
+ * Usage:
781
+ * ```tsx
782
+ * const { virtualItems, totalSize, containerRef, onScroll, measureElement } =
783
+ * useDynamicVirtualList({ count: rows.length, estimatedItemHeight: 40, overscan: 10 });
784
+ *
785
+ * return (
786
+ * <div ref={containerRef} onScroll={onScroll} style={{ height: 400, overflowY: "auto" }}>
787
+ * <div style={{ height: totalSize, position: "relative" }}>
788
+ * {virtualItems.map(({ index, start }) => (
789
+ * <div
790
+ * key={index}
791
+ * ref={(el) => measureElement(el, index)}
792
+ * style={{ position: "absolute", top: start, width: "100%" }}
793
+ * >
794
+ * {rows[index]}
795
+ * </div>
796
+ * ))}
797
+ * </div>
798
+ * </div>
799
+ * );
800
+ * ```
801
+ *
802
+ * For table usage, pair with padding `<tr>` spacers at the top and bottom of
803
+ * `<tbody>` and attach `measureElement` to each `<tr>` via a ref callback.
804
+ */
805
+ declare function useDynamicVirtualList({ count, estimatedItemHeight, overscan, }: UseDynamicVirtualListOptions): UseDynamicVirtualListResult;
806
+
807
+ type alignX = 'start' | 'center' | 'end' | 'space-between' | 'space-around';
808
+ type alignY = 'start' | 'center' | 'end' | 'stretch';
809
+ /** Layout block node */
810
+ type BlockNode = {
811
+ type: 'block';
812
+ /** The field/column identifier that the consumer maps to a Cell */
813
+ fieldId: string;
814
+ };
815
+ /** Grid child node */
816
+ type GridChild = {
817
+ node: LayoutNode$1;
818
+ col: number;
819
+ row: number;
820
+ w: number;
821
+ h: number;
822
+ /** Horizontal alignment of content within the grid cell */
823
+ alignX?: alignX;
824
+ /** Vertical alignment of content within the grid cell */
825
+ alignY?: alignY;
826
+ };
827
+ /** Grid container node */
828
+ type GridContainer = {
829
+ type: 'grid';
830
+ columns: number;
831
+ rows?: number;
832
+ gap?: number;
833
+ children: GridChild[];
834
+ };
835
+ /** Flex container node */
836
+ type FlexContainer = {
837
+ type: 'flex';
838
+ direction?: 'row' | 'column';
839
+ gap?: number;
840
+ alignX?: alignX;
841
+ alignY?: alignY;
842
+ children: LayoutNode$1[];
843
+ };
844
+ /** Union of all node types */
845
+ type LayoutNode$1 = BlockNode | GridContainer | FlexContainer;
846
+ /** Responsive layout mapping breakpoints to layout trees */
847
+ type ResponsiveLayout = {
848
+ [K in Breakpoint]: LayoutNode$1;
849
+ };
850
+ /** Layout component props */
851
+ type LayoutProps = {
852
+ /** Responsive layout tree */
853
+ layout: ResponsiveLayout;
854
+ /** Callback that renders a Block node given its fieldId */
855
+ renderBlock: (fieldId: string) => ReactNode;
856
+ };
857
+
858
+ interface BaseTypographyProps {
859
+ /**
860
+ * Prefer children when rendering rich/nested content
861
+ */
862
+ children?: React__default.ReactNode;
863
+ variant: TypographyVariant;
864
+ /**
865
+ * Flag to indicate if the component is disabled.
866
+ * @optional
867
+ */
868
+ disabled?: boolean;
869
+ /**
870
+ * Optional color string i can pass to the text
871
+ * @optional
872
+ */
873
+ color?: string;
874
+ /**
875
+ * Font weight applied to the text.
876
+ * @optional
877
+ */
878
+ fontWeight?: string | number;
879
+ /**
880
+ * Font style applied to the text.
881
+ * @optional
882
+ */
883
+ fontStyle?: string;
884
+ /**
885
+ * Text decoration applied to the text.
886
+ * @optional
887
+ */
888
+ textDecoration?: string;
889
+ }
890
+ type TypographyVariant = "display" | "heading" | "body" | "label" | "code" | "subtitle" | "title" | "caption" | "article-h1" | "article-h2" | "article-h3" | "article-h4" | "article-body" | "article-code" | "article-quote" | "article-caption" | "article-list";
891
+
892
+ /**
893
+ * Maps each CellType to the component-specific props that can be passed
894
+ * via `uiVariant` in a rule. TypeScript enforces that you only pass props
895
+ * the underlying component actually understands.
896
+ */
897
+ type CellUIVariantMap = {
898
+ [K in CellType]: K extends "IMAGE" ? Partial<Omit<IconProps, "src">> : K extends "TAG" ? Partial<{
899
+ state: State;
900
+ size: Size;
901
+ }> : K extends "PROGRESS" ? Partial<Pick<ProgressBarProps, "variant" | "showLabel" | "height">> : Partial<Omit<BaseTypographyProps, "children" | "variant">>;
902
+ };
903
+ /**
904
+ * Given a tuple of `DataStructureColumn`, produces a union of
905
+ * `{ columnId: string; cellType: CellType }` entries.
906
+ */
907
+ type ColumnTypeMap<TData, TColumns extends readonly DataStructureColumn<TData>[]> = {
908
+ [K in keyof TColumns]: TColumns[K] extends DataStructureColumn<TData> ? {
909
+ columnId: TColumns[K]["id"] extends string ? TColumns[K]["id"] : string;
910
+ cellType: TColumns[K]["cellType"] extends CellType ? TColumns[K]["cellType"] : CellType;
911
+ } : never;
912
+ }[number];
913
+ /**
914
+ * Looks up the `cellType` for a given `columnId` from a columns array.
915
+ * Falls back to `CellType` if not found.
916
+ */
917
+ type LookupCellType<TData, TColumns extends readonly DataStructureColumn<TData>[], TId extends string> = Extract<ColumnTypeMap<TData, TColumns>, {
918
+ columnId: TId;
919
+ }> extends {
920
+ cellType: infer R;
921
+ } ? R extends CellType ? R : CellType : CellType;
922
+ /** Comparison operators for AST-like UI rules */
923
+ type UIRuleOperator = "==" | "!=" | ">" | ">=" | "<" | "<=" | "includes" | "startsWith" | "endsWith" | "isEmpty" | "isNotEmpty";
924
+ /**
925
+ * A single declarative styling rule evaluated against a row.
926
+ * Rules are compiled once into fast evaluators — no runtime functions.
927
+ *
928
+ * When `field` and `op` are omitted, the rule always matches (static styling).
929
+ *
930
+ * @example conditional
931
+ * { field: "price", op: ">", value: 100, uiVariant: { color: "var(--rst-color-success)", fontWeight: "bold" } }
932
+ *
933
+ * @example static (always applies)
934
+ * { uiVariant: { color: "red" } }
935
+ */
936
+ interface DataStructureUIRule<TData, K extends CellType = CellType> {
937
+ /** Which field to evaluate — omit for a static rule that always matches */
938
+ field?: keyof TData;
939
+ /** Comparison operator — omit for a static rule that always matches */
940
+ op?: UIRuleOperator;
941
+ /** Comparison value (not needed for isEmpty / isNotEmpty) */
942
+ value?: unknown;
943
+ /**
944
+ * Component-specific props forwarded to the underlying renderer.
945
+ * TypeScript enforces the correct props based on the column's `cellType`.
946
+ */
947
+ uiVariant?: CellUIVariantMap[K];
948
+ }
949
+ /**
950
+ * Per-column UI configuration.
951
+ * Matches a schema column via `columnId` (same as `DataStructureColumn.id` or `accessorKey`).
952
+ */
953
+ interface DataStructureUIColumn<TData, TColumns extends readonly DataStructureColumn<TData>[] = DataStructureColumn<TData>[], TId extends string = string> {
954
+ /** Matches `DataStructureColumn.id` or `accessorKey` */
955
+ columnId: TId;
956
+ /** Ordered rules — first match wins. Rules without `field`/`op` always match. */
957
+ rules?: DataStructureUIRule<TData, LookupCellType<TData, TColumns, TId>>[];
958
+ }
959
+ /**
960
+ * Top-level UI configuration passed to any data-component.
961
+ * `TColumns` is inferred from the `columns` prop — `cellType` is looked up automatically.
962
+ */
963
+ interface DataStructureUIConfig<TData, TColumns extends readonly DataStructureColumn<TData>[] = DataStructureColumn<TData>[]> {
964
+ columns?: DataStructureUIColumn<TData, TColumns, string>[];
965
+ /** Container-level styling applied to the component root (e.g. Card state). */
966
+ container?: DataStructureUIContainer;
967
+ }
968
+ /** Container-level UI configuration.*/
969
+ interface DataStructureUIContainer {
970
+ /** Component-specific props forwarded to the container root renderer. */
971
+ uiVariant?: Record<string, unknown>;
972
+ }
973
+ /** Pre-resolved cell styling — Cell never resolves UI, only consumes this */
974
+ interface ResolvedCellUI {
975
+ /** Component-specific props resolved from uiVariant rules */
976
+ uiVariant?: Record<string, unknown>;
977
+ }
978
+
979
+ interface DataStructureComponent<TData> {
980
+ /** Array of data to display in the chart */
981
+ data: TData[];
982
+ /** Column definitions - reused from TableGrid */
983
+ columns?: DataStructureColumn<TData>[];
984
+ /** Function to get subrows for a given row */
985
+ getSubRows?: (originalRow: TData, index: number) => TData[] | undefined;
986
+ /** UI configuration for conditional styling and presentation */
987
+ uiConfig?: DataStructureUIConfig<TData>;
988
+ }
989
+ interface DataStructureColumn<TData, TValue = TData[keyof TData]> {
990
+ /** Unique identifier for the column */
991
+ id?: string;
992
+ /** Display header text */
993
+ header?: string;
994
+ /** Simple accessor key for primitive values */
995
+ accessorKey?: keyof TData;
996
+ /** Optional: options for select inputs */
997
+ options?: Option[];
998
+ /** Formula string using column IDs as references */
999
+ formula?: string;
1000
+ /** Enable editing for this column */
1001
+ enableEditing?: boolean;
1002
+ /** Optional: mark field as required */
1003
+ required?: boolean;
1004
+ /** Disable editing for this column */
1005
+ disabled?: boolean;
1006
+ /** Function accessor for complex values */
1007
+ accessorFn?: (row: TData) => TValue;
1008
+ /** Visual representation type for cells with options or specific data types */
1009
+ cellType?: CellType;
1010
+ /** Helper text shown below the field (e.g. "Opzionale", "Usa +/− per il segno"). */
1011
+ helperText?: string;
1012
+ /**
1013
+ * Generic column-level configuration for the target component.
1014
+ * Mirrors the uiConfig pattern: carries the props of the component
1015
+ * referenced by `cellType` (e.g. ChartProps for CHART, TableGridProps for TABLE_GRID).
1016
+ * `data` and `columns` are excluded — they come from the cell value and schema.
1017
+ */
1018
+ columnConfig?: Record<string, unknown>;
1019
+ /**
1020
+ * Called when an interactive cell (e.g. BUTTON, IMAGE click) fires an action.
1021
+ * The cell handler decides when to invoke it; the first argument is the
1022
+ * action id (for BUTTON = `option.value`). Works in any data-component
1023
+ * that renders Cell in display mode (CardList, TableGrid, …).
1024
+ */
1025
+ onCellClick?: (actionId: string, rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
1026
+ }
1027
+
1028
+ /**
1029
+ * Maps a layout slot (`block.fieldId`) to the data-column option value (`col.id ?? String(accessorKey)`) that fills it.
1030
+ */
1031
+ type SlotMap = {
1032
+ slotId: string;
1033
+ column: string;
1034
+ }[];
1035
+
1036
+ /**
1037
+ * Props for the Card component.
1038
+ * Renders a single data row as a card with optional layout configuration.
1039
+ */
1040
+ interface CardSpecificProps<TData> {
1041
+ /** Single row of data to display in the card */
1042
+ data: TData;
1043
+ /** Responsive layout configuration for card fields */
1044
+ layout?: ResponsiveLayout;
1045
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
1046
+ slotMap?: SlotMap;
1047
+ /** Additional CSS class for the card container */
1048
+ className?: string;
1049
+ /** Semantic state for the card container (colors background/border). */
1050
+ state?: State;
1051
+ /** Called when the card is clicked */
1052
+ onClick?: () => void;
1053
+ /** Whether the card is in selected state */
1054
+ selected?: boolean;
1055
+ /** Whether the card is disabled (muted, non-interactive look) */
1056
+ disabled?: boolean;
1057
+ }
1058
+ type CardProps<TData> = Omit<DataStructureComponent<TData>, "data"> & CardSpecificProps<TData>;
1059
+
1060
+ /**
1061
+ * Renders a single data row as a card with optional layout configuration.
1062
+ * Fields are displayed using Cell components and optionally arranged via Layout.
1063
+ */
1064
+ declare function Card<TData>({ data, columns, layout, className, uiConfig, onClick, selected, disabled, slotMap, state }: CardProps<TData>): React__default.JSX.Element;
1065
+ declare namespace Card {
1066
+ var displayName: string;
1067
+ }
1068
+
1069
+ /**
1070
+ * Per-series row of the composed-series matrix.
1071
+ * `column` references a Y-axis data column by id/accessor;
1072
+ * `type` decides which cartesian primitive (line/bar/area/scatter) renders;
1073
+ * `color` is optional — falls back to the chart palette when omitted.
1074
+ */
1075
+ interface ChartSeriesConfig<TData = Record<string, unknown>> {
1076
+ column: keyof TData | string;
1077
+ type: ComposedSeriesType;
1078
+ color?: string;
1079
+ }
1080
+ /**
1081
+ * Configuration for Sankey charts.
1082
+ * stageColumns: ordered list of columns that define the flow stages (min 2).
1083
+ * - Null/undefined/empty values in a row are skipped, creating a direct link
1084
+ * between the nearest non-empty columns on both sides.
1085
+ * valueColumn: numeric column used as the flow weight.
1086
+ *
1087
+ * @example 2-level (source → target)
1088
+ * { stageColumns: ["from", "to"], valueColumn: "amount" }
1089
+ *
1090
+ * @example multi-level journey
1091
+ * { stageColumns: ["channel", "device", "outcome"], valueColumn: "count" }
1092
+ */
1093
+ interface SankeyConfig<TData> {
1094
+ stageColumns: (keyof TData)[];
1095
+ valueColumn: keyof TData;
1096
+ }
1097
+ /**
1098
+ * Configuration for Geo charts.
1099
+ * geoJson: GeoJSON FeatureCollection with MultiPolygon geometry.
1100
+ * regionColumn: column in TData that maps to the "name" property in geoJson features.
1101
+ * valueColumn: numeric column used for the choropleth color scale.
1102
+ * colorRange: [minColor, maxColor] — two CSS color strings for the gradient.
1103
+ */
1104
+ interface GeoConfig<TData> {
1105
+ geoJson: {
1106
+ type: "FeatureCollection";
1107
+ features: Array<{
1108
+ type: "Feature";
1109
+ properties: Record<string, unknown>;
1110
+ geometry: {
1111
+ type: "MultiPolygon" | "Polygon";
1112
+ coordinates: number[][][][] | number[][][];
1113
+ };
1114
+ }>;
1115
+ };
1116
+ regionColumn: keyof TData;
1117
+ valueColumn: keyof TData;
1118
+ colorRange?: [string, string];
1119
+ }
1120
+ interface ChartSpecificProps<TData> {
1121
+ /** Type of chart to render */
1122
+ type: ChartType;
1123
+ /** Column to use for X-axis (category/labels). Not required for type="sankey". */
1124
+ xAxisColumn?: keyof TData;
1125
+ /** Column(s) to use for Y-axis (values). Not required for type="sankey". */
1126
+ yAxisColumns?: (keyof TData)[];
1127
+ /** Chart title */
1128
+ title?: string;
1129
+ /** Chart subtitle */
1130
+ subtitle?: string;
1131
+ /** Width of the chart */
1132
+ width?: number | `${number}%`;
1133
+ /** Height of the chart */
1134
+ height?: number | `${number}%`;
1135
+ /** Custom colors for chart series */
1136
+ colors?: string[];
1137
+ /**
1138
+ * Per-series matrix used when type === "composed" (Cartesian-only mixes:
1139
+ * line + bar + area + scatter). For the single-type cartesian types
1140
+ * (line/bar/area/scatter), the matrix is derived from yAxisColumns and
1141
+ * every entry adopts `type` — so the prop form only needs to manage one
1142
+ * matrix for all cartesian charts. Ignored for pie/sankey/sparkline/geo.
1143
+ */
1144
+ series?: ChartSeriesConfig<TData>[];
1145
+ /** Show/hide chart elements */
1146
+ showGrid?: boolean;
1147
+ showTooltip?: boolean;
1148
+ showLegend?: boolean;
1149
+ showXAxis?: boolean;
1150
+ showYAxis?: boolean;
1151
+ /** Callback when a data point is clicked */
1152
+ onDataPointClick?: (data: TData, index: number) => void;
1153
+ /** Chart layout orientation */
1154
+ layout?: "horizontal" | "vertical";
1155
+ /** Configuration required when type="sankey" */
1156
+ sankeyConfig?: SankeyConfig<TData>;
1157
+ /** Configuration required when type="geo" */
1158
+ geoConfig?: GeoConfig<TData>;
1159
+ }
1160
+ type ChartProps<TData> = DataStructureComponent<TData> & ChartSpecificProps<TData>;
1161
+
1162
+ declare const Chart: <TData extends object>({ data, columns, type, xAxisColumn, yAxisColumns, title, subtitle, width, height, colors, showGrid, showTooltip, showLegend, showXAxis, showYAxis, layout, series, sankeyConfig, geoConfig, uiConfig, }: ChartProps<TData>) => React__default.JSX.Element;
1163
+
1164
+ interface ToolCall {
1165
+ tool: string;
1166
+ arguments: Record<string, unknown>;
1167
+ }
1168
+ interface ToolParameterSchema {
1169
+ name: string;
1170
+ type: string;
1171
+ description: string;
1172
+ required?: boolean;
1173
+ }
1174
+ interface ToolDefinition {
1175
+ name: string;
1176
+ description: string;
1177
+ parameters: ToolParameterSchema[];
1178
+ }
1179
+ interface ColumnSchema {
1180
+ id: string;
1181
+ label: string;
1182
+ type: "string" | "number" | "date" | "boolean" | "unknown";
1183
+ /** Valid option values for select / button-group columns */
1184
+ options?: string[];
1185
+ }
1186
+ /**
1187
+ * Serializable snapshot of the current table state passed to the AI provider.
1188
+ * All IDs align with ColumnSchema ids and 0-based rowIndex values.
1189
+ */
1190
+ interface AITableContext {
1191
+ /** All data rows. rowIndex (0-based) in tool calls maps to this array. */
1192
+ rows: Record<string, unknown>[];
1193
+ /** Active sort criteria in priority order */
1194
+ sorting?: Array<{
1195
+ column: string;
1196
+ direction: "asc" | "desc";
1197
+ }>;
1198
+ /** Column IDs currently used for grouping */
1199
+ grouping?: string[];
1200
+ /** IDs of rows currently selected */
1201
+ selectedRowIds?: string[];
1202
+ /** Column IDs that are hidden */
1203
+ hiddenColumnIds?: string[];
1204
+ /** Current column display order (empty = natural order) */
1205
+ columnOrder?: string[];
1206
+ /** Current column pinning overrides */
1207
+ columnPinning?: Record<string, "left" | "right">;
1208
+ }
1209
+ interface AIResponse {
1210
+ message: string;
1211
+ toolCalls: ToolCall[];
1212
+ }
1213
+ interface AIProvider {
1214
+ processMessage(input: string, schema: ColumnSchema[], tools: ToolDefinition[], tableContext?: AITableContext): Promise<AIResponse>;
1215
+ }
1216
+ interface AIQuickAction {
1217
+ /** Button label shown to the user */
1218
+ label: string;
1219
+ /** The prompt text sent to the AI when this action is triggered */
1220
+ prompt: string;
1221
+ /** Optional icon name (from the icon system) */
1222
+ icon?: string;
1223
+ }
1224
+ interface ExecutionResult {
1225
+ tool: string;
1226
+ success: boolean;
1227
+ message: string;
1228
+ }
1229
+ interface ChatMessage {
1230
+ id: string;
1231
+ role: "user" | "assistant";
1232
+ content: string;
1233
+ /** Temporary assistant placeholder shown while the provider is still processing */
1234
+ pendingResponse?: boolean;
1235
+ toolCalls?: ToolCall[];
1236
+ executionResults?: ExecutionResult[];
1237
+ timestamp: string;
1238
+ /** Confirmation status — only set when requiresConfirmation is enabled */
1239
+ status?: "pending" | "confirmed" | "rejected";
1240
+ }
1241
+
1242
+ type GanttView = "year" | "month" | "week" | "day";
1243
+ /**
1244
+ * Relation types:
1245
+ * - FS (Finish-to-Start): arrow from end of predecessor to start of successor
1246
+ * - SS (Start-to-Start): arrow from start of predecessor to start of successor
1247
+ * - FF (Finish-to-Finish): arrow from end of predecessor to end of successor
1248
+ * - SF (Start-to-Finish): arrow from start of predecessor to end of successor
1249
+ */
1250
+ type GanttRelationType = "FS" | "SS" | "FF" | "SF";
1251
+ /**
1252
+ * A single dependency descriptor.
1253
+ * The `dependencyColumnId` field on each row can resolve to:
1254
+ * - `string` — single dependency ID (defaults to "FS")
1255
+ * - `string[]` — multiple dependency IDs (all default to "FS")
1256
+ * - `GanttDependency` — single dependency with explicit type
1257
+ * - `GanttDependency[]` — multiple dependencies with explicit types
1258
+ */
1259
+ interface GanttDependency {
1260
+ id: string;
1261
+ type?: GanttRelationType;
1262
+ }
1263
+ interface GanttSpecificProps<TData> {
1264
+ /** Column id or accessorKey for the start date (must resolve to Date, ISO string, or timestamp) */
1265
+ startColumnId: string | keyof TData;
1266
+ /** Column id or accessorKey for the end date (must resolve to Date, ISO string, or timestamp) */
1267
+ endColumnId: string | keyof TData;
1268
+ /** Column id or accessorKey for the event label */
1269
+ eventColumnId: string | keyof TData;
1270
+ /** Column id or accessorKey that uniquely identifies each row */
1271
+ idColumnId?: string | keyof TData;
1272
+ /**
1273
+ * Column id or accessorKey for the dependency field.
1274
+ * Resolves to string | string[] | GanttDependency | GanttDependency[]
1275
+ */
1276
+ dependencyColumnId?: string | keyof TData;
1277
+ /**
1278
+ * IDs of columns to display in the left data-grid panel.
1279
+ * If not provided, all columns (excluding dependencyColumnId) are shown.
1280
+ */
1281
+ gridColumnIds?: string[];
1282
+ /** Time granularity for the timeline header */
1283
+ view?: GanttView;
1284
+ /** Reference date used to determine the visible range. Defaults to `new Date()` */
1285
+ initialDate?: Date;
1286
+ /** Optional function to override the background color of an event bar */
1287
+ eventColorFn?: (row: TData) => string | undefined;
1288
+ /** Enable sorting on the left grid panel columns */
1289
+ enableSorting?: boolean;
1290
+ /** Enable the AI assistant sidebar panel */
1291
+ enableAIAssistant?: boolean;
1292
+ /** AI provider instance used by the AI assistant panel */
1293
+ aiProvider?: AIProvider;
1294
+ /** Pre-configured quick-action buttons shown in the AI chat */
1295
+ aiQuickActions?: AIQuickAction[];
1296
+ /** When true, AI tool calls require explicit user confirmation before being applied */
1297
+ requiresConfirmation?: boolean;
1298
+ /**
1299
+ * Called when the user manually drags or resizes an event bar.
1300
+ * Receives the original row data and the new start/end Dates.
1301
+ */
1302
+ onEventChange?: (row: TData, newStart: Date, newEnd: Date) => void;
1303
+ }
1304
+ type GanttProps<TData> = DataStructureComponent<TData> & GanttSpecificProps<TData>;
1305
+
1306
+ declare function Gantt<TData>(props: GanttProps<TData>): React$1.JSX.Element;
1307
+
1308
+ type AggregationFn = "sum" | "count" | "avg" | "min" | "max";
1309
+
1310
+ /** Backward-compatible alias — prefer AggregationFn for new code. */
1311
+ type PivotAggregation = AggregationFn;
1312
+ interface PivotValueField {
1313
+ /** The field ID (column accessorKey or id) to aggregate */
1314
+ field: string;
1315
+ /** Aggregation function to apply */
1316
+ aggregation: PivotAggregation;
1317
+ /** Optional display label */
1318
+ label?: string;
1319
+ }
1320
+ /**
1321
+ * Configuration for pivot mode.
1322
+ * rowFields: column IDs whose values form the row groups.
1323
+ * columnFields: column IDs whose unique values become dynamic columns.
1324
+ * valueFields: numeric fields to aggregate at each row × column intersection.
1325
+ */
1326
+ interface PivotConfig {
1327
+ rowFields: string[];
1328
+ columnFields: string[];
1329
+ valueFields: PivotValueField[];
1330
+ }
1331
+ /** A resolved column in the computed pivot result */
1332
+ interface PivotColumnDef {
1333
+ id: string;
1334
+ /** Primary label: row-field name OR column-field value (e.g. "New York") */
1335
+ label: string;
1336
+ /** Secondary label shown in the second header row: aggregation + field (e.g. "Salary (sum)"). Only present for value columns when columnFields are in use. */
1337
+ subLabel?: string;
1338
+ /** true when this column represents a row grouping field (left side) */
1339
+ isRowField: boolean;
1340
+ /** The value from the pivot column field (e.g. "New York") */
1341
+ columnFieldValue?: string;
1342
+ /** The column field ID (e.g. "location") */
1343
+ columnFieldId?: string;
1344
+ /** The value field aggregation spec */
1345
+ valueField?: PivotValueField;
1346
+ }
1347
+ /** A single row in the computed pivot result */
1348
+ interface PivotRow {
1349
+ id: string;
1350
+ /** Values for each row field */
1351
+ rowValues: Record<string, string>;
1352
+ /** Aggregated cell values keyed by PivotColumnDef.id */
1353
+ cells: Record<string, number | string | null>;
1354
+ }
1355
+ /** Full computed pivot output */
1356
+ interface ComputedPivotData {
1357
+ columns: PivotColumnDef[];
1358
+ rows: PivotRow[];
1359
+ }
1360
+
1361
+ type FilterColumnType = "string" | "number" | "date" | "boolean";
1362
+ type StringOperator = "equals" | "not_equals" | "contains" | "starts_with" | "ends_with" | "in" | "not_in" | "is_null" | "is_not_null";
1363
+ type NumberOperator = "equals" | "not_equals" | "greater" | "greater_equals" | "less" | "less_equals" | "in" | "not_in" | "is_null" | "is_not_null";
1364
+ type DateOperator = "equals" | "not_equals" | "after" | "after_or_on" | "before" | "before_or_on" | "between" | "is_null" | "is_not_null";
1365
+ type BooleanOperator = "is_true" | "is_false" | "is_null" | "is_not_null";
1366
+ type FilterOperator = StringOperator | NumberOperator | DateOperator | BooleanOperator;
1367
+ type FilterValue = string | string[] | number | number[] | Date | boolean | DateRange | null;
1368
+ interface FilterFieldProp {
1369
+ /** Matches ColumnDef id or accessorKey (stringified) */
1370
+ id: string;
1371
+ /** Human-readable label (from ColumnDef.header) */
1372
+ label: string;
1373
+ /** Column data type used to pick operators and value input */
1374
+ type: FilterColumnType;
1375
+ /** Available values for `in` / `not_in` operators (from CellType.SELECT / MULTI_SELECT columns) */
1376
+ availableOptions?: Option[];
1377
+ }
1378
+ /**
1379
+ * Per-field read-only flags for a condition. Each flag locks a single
1380
+ */
1381
+ interface ConditionReadOnly {
1382
+ /** Locks the field selector (first dropdown). */
1383
+ field?: boolean;
1384
+ /** Locks the operator selector (second dropdown). */
1385
+ operator?: boolean;
1386
+ /** Locks the value input. */
1387
+ value?: boolean;
1388
+ /** Hides the delete button. */
1389
+ delete?: boolean;
1390
+ }
1391
+ interface FilterCondition {
1392
+ type: "condition";
1393
+ field: FilterFieldProp;
1394
+ operator: FilterOperator;
1395
+ value: FilterValue;
1396
+ /** Optional per-field read-only flags (stored on the condition, not global). */
1397
+ readOnly?: ConditionReadOnly;
1398
+ }
1399
+ interface FilterGroup {
1400
+ type: "group";
1401
+ logic: "and" | "or";
1402
+ filters: FilterNode[];
1403
+ }
1404
+ /** Recursive union — use `node.type` to discriminate */
1405
+ type FilterNode = FilterCondition | FilterGroup;
1406
+ interface OperatorOption {
1407
+ value: FilterOperator;
1408
+ label: string;
1409
+ }
1410
+
1411
+ type TableGridDisplayMode = "tree" | "table" | "table-tree";
1412
+ /** Which grid lines (cell borders) are visible. */
1413
+ type TableGridShowGrid = ShowGridLines;
1414
+ /** All valid showGrid values. */
1415
+ declare const ShowGridLines: {
1416
+ readonly None: "none";
1417
+ readonly Vertical: "vertical";
1418
+ readonly Horizontal: "horizontal";
1419
+ readonly Both: "both";
1420
+ };
1421
+ type ShowGridLines = (typeof ShowGridLines)[keyof typeof ShowGridLines];
1422
+ interface TableGridSpecificProps<TData> {
1423
+ /** Enable sorting functionality */
1424
+ enableSorting?: boolean;
1425
+ /** Enable row selection */
1426
+ enableSelection?: boolean;
1427
+ /** Enable editing functionality */
1428
+ enableEditing?: boolean;
1429
+ /** Callback when a row is clicked */
1430
+ onRowClick?: (row: TData, index: number) => void;
1431
+ /** Callback when data changes */
1432
+ onDataChange?: (data: TData[]) => void;
1433
+ /** Callback fired when the selection changes */
1434
+ onSelectionChange?: (selectedIds: string[], selectedData: TData[]) => void;
1435
+ /** Enable grouping functionality */
1436
+ enableGrouping?: boolean;
1437
+ /** Callback when grouping changes */
1438
+ onGroupingChange?: (grouping: string[]) => void;
1439
+ /** Custom className for styling */
1440
+ className?: string;
1441
+ /** Enable virtualization */
1442
+ enableVirtualization?: boolean;
1443
+ /** Height of each row in pixels (required for virtualization) */
1444
+ virtualizedRowHeight?: number;
1445
+ /** Height of the scrollable container in pixels (required for virtualization) */
1446
+ virtualizedContainerHeight?: number;
1447
+ /** When true, cells keep a fixed single-line height; overflowing content is clipped. */
1448
+ oneLine?: boolean;
1449
+ /** Which grid lines (cell borders) are visible. Defaults to "both". */
1450
+ showGrid?: TableGridShowGrid;
1451
+ /** Enable sticky header */
1452
+ stickyHeader?: boolean;
1453
+ /** Enable sticky footer */
1454
+ stickyFooter?: boolean;
1455
+ /** Enable pivot table mode — shows the pivot icon in the right toolbar */
1456
+ enablePivot?: boolean;
1457
+ /** Initial or controlled pivot configuration */
1458
+ pivotConfig?: PivotConfig;
1459
+ /** Callback when the pivot configuration changes */
1460
+ onPivotConfigChange?: (config: PivotConfig) => void;
1461
+ /** Enable the formula builder — shows the formula icon in the right toolbar */
1462
+ enableFormulaBuilder?: boolean;
1463
+ /**
1464
+ * Controls how column widths are calculated.
1465
+ * - `"auto"` (default): columns share the available width; `size` is ignored.
1466
+ * - `"fixed"`: each column uses its `size` value; the table scrolls horizontally when the total exceeds the container.
1467
+ */
1468
+ columnSizing?: "auto" | "fixed";
1469
+ /** Show loading skeleton state while data is being fetched */
1470
+ loading?: boolean;
1471
+ /** Allow columns to be reordered via drag & drop on the header */
1472
+ enableColumnReorder?: boolean;
1473
+ /** Show a column visibility toggle panel in the right sidebar */
1474
+ enableColumnVisibility?: boolean;
1475
+ /** Show a filter panel in the right sidebar */
1476
+ enableFiltering?: boolean;
1477
+ /** Enable the AI assistant chat panel in the right sidebar */
1478
+ enableAIAssistant?: boolean;
1479
+ /** AI provider instance for processing natural-language commands */
1480
+ aiProvider?: AIProvider;
1481
+ /** When true, AI-suggested actions are held for explicit user confirmation before being applied */
1482
+ requiresConfirmation?: boolean;
1483
+ /** Pre-configured action buttons shown in the AI chat panel for one-click commands */
1484
+ aiQuickActions?: AIQuickAction[];
1485
+ /**
1486
+ * Called whenever a new formula column is created (via the builder or AI).
1487
+ * Use this to persist the column definition on your server so it can be
1488
+ * re-supplied via the `columns` prop on the next load.
1489
+ */
1490
+ onFormulaColumnAdd?: (col: ColumnDef<TData>) => void;
1491
+ /**
1492
+ * Forwarded to the inner scroll container (`rst-table-container`).
1493
+ * Allows an external component to react to scroll events from the table body.
1494
+ * Works for both virtualized and non-virtualized modes.
1495
+ */
1496
+ onScroll?: UIEventHandler<HTMLDivElement>;
1497
+ /**
1498
+ * Ref forwarded to the inner scroll container (`rst-table-container`).
1499
+ * Allows an external component to programmatically read or set `scrollTop`.
1500
+ * Works for both virtualized and non-virtualized modes.
1501
+ */
1502
+ scrollContainerRef?: Ref<HTMLDivElement>;
1503
+ }
1504
+ type TableGridProps<TData> = DataStructureComponent<TData> & TableGridSpecificProps<TData>;
1505
+ interface ColumnDef<TData, TValue = TData[keyof TData]> extends DataStructureColumn<TData, TValue> {
1506
+ /** Column width */
1507
+ size?: number;
1508
+ minSize?: number;
1509
+ maxSize?: number;
1510
+ /** Enable sorting for this column */
1511
+ enableSorting?: boolean;
1512
+ /** Sort function for custom sorting */
1513
+ sortingFn?: (a: TData, b: TData, columnId: string) => number;
1514
+ /** Pin column to left or right */
1515
+ pinned?: "left" | "right" | false;
1516
+ /** Footer content. Pass a string for a static label, a function for dynamic JSX,
1517
+ * or { aggregation } to auto-compute a total from the column data. */
1518
+ footer?: string | {
1519
+ aggregation: AggregationFn;
1520
+ label?: string;
1521
+ } | ((props: {
1522
+ column: ColumnDef<TData>;
1523
+ }) => React.ReactNode);
1524
+ }
1525
+ interface TableRow<TData> {
1526
+ /** Row unique ID */
1527
+ id: string;
1528
+ /** Original data object for the row */
1529
+ data: TData;
1530
+ /** Index in the original data array */
1531
+ index: number;
1532
+ /** Parent row ID if this is a subrow */
1533
+ parentId?: string;
1534
+ /** Depth level in the hierarchy (0 = top level) */
1535
+ depth: number;
1536
+ /** Whether this row is expanded (has visible subrows) */
1537
+ isExpanded: boolean;
1538
+ /** Subrows if any */
1539
+ subRows?: TableRow<TData>[];
1540
+ /** Whether this is a group row */
1541
+ isGroup?: boolean;
1542
+ /** The value being grouped on */
1543
+ groupingValue?: string;
1544
+ /** The column ID being grouped on */
1545
+ groupingColumnId?: string;
1546
+ /** All original data items in this group (set only when isGroup=true) */
1547
+ groupItems?: TData[];
1548
+ }
1549
+ interface TableState<TData> {
1550
+ /** Current data in the table */
1551
+ dataState: TData[];
1552
+ /** Current sorting state */
1553
+ sorting: SortingState;
1554
+ /** Current grouping state (column IDs) */
1555
+ grouping: string[];
1556
+ /** Expanded rows */
1557
+ expandedRows: Set<string>;
1558
+ /** Display mode based on data structure */
1559
+ displayMode: TableGridDisplayMode;
1560
+ /** Set of selected row IDs */
1561
+ selectedRows: Set<string>;
1562
+ /** Ordered list of column IDs (empty = natural order) */
1563
+ columnOrder: string[];
1564
+ /** Set of hidden column IDs */
1565
+ hiddenColumns: Set<string>;
1566
+ /** Dynamic pinning overrides — takes precedence over ColumnDef.pinned */
1567
+ columnPinning: Record<string, "left" | "right" | false>;
1568
+ /** Active filter tree — null means no filter applied */
1569
+ filterGroup: FilterGroup | null;
1570
+ /** Whether filtering is enabled */
1571
+ enableFiltering?: boolean;
1572
+ }
1573
+ type SortingState = {
1574
+ id: string;
1575
+ desc: boolean;
1576
+ }[];
1577
+
1578
+ declare function TableGrid<TData>({ data, columns, getSubRows, onDataChange, onSelectionChange, enableSorting, enableSelection, enableEditing, enableGrouping, enableVirtualization, stickyHeader, stickyFooter, columnSizing, enableColumnReorder, enableColumnVisibility, enableFiltering, enableAIAssistant, aiProvider, onFormulaColumnAdd: externalOnFormulaColumnAdd, loading, uiConfig, oneLine, showGrid, ...toolPassThrough }: TableGridProps<TData>): React$1.JSX.Element;
1579
+
1580
+ /**
1581
+ * Read a CSV/TSV/custom-delimited file and convert it into
1582
+ * { data, columns } matching DataStructureComponent<TData> props.
1583
+ */
1584
+ declare function createDataStructureFromFile<TData extends Record<string, unknown> = Record<string, unknown>>(file: File): Promise<{
1585
+ data: TData[];
1586
+ columns: ColumnDef<TData, TData[keyof TData]>[];
1587
+ }>;
1588
+
1589
+ interface CellProps<TData, TValue> {
1590
+ /** The actual value to display/edit */
1591
+ value: TValue;
1592
+ /** Column definition for configuration */
1593
+ column: DataStructureColumn<TData, TValue>;
1594
+ /** Original row data */
1595
+ rowData: TData;
1596
+ /** Row index */
1597
+ rowIndex: number;
1598
+ /** Edit mode behavior */
1599
+ editMode?: EditMode;
1600
+ /** Whether this cell is editable (overrides column config) */
1601
+ isEditable?: boolean;
1602
+ /** Error message to display */
1603
+ error?: string;
1604
+ /** Whether the cell is disabled */
1605
+ disabled?: boolean;
1606
+ /** Whether the cell is in a loading state — renders a skeleton placeholder */
1607
+ loading?: boolean;
1608
+ /** Whether to show the label above the cell (default: true) */
1609
+ showLabel?: boolean;
1610
+ /** Whether to show the helper/error text below the cell (default: true) */
1611
+ showHelperText?: boolean;
1612
+ /** Helper text shown below the cell when no error is present */
1613
+ helperText?: string;
1614
+ /** Alignment of the label (default: "top") */
1615
+ labelAlign?: "top" | "left";
1616
+ /** Pre-resolved UI styling — Cell never resolves UI, only consumes it */
1617
+ ui?: ResolvedCellUI;
1618
+ /** Callback when value changes */
1619
+ onValueChange?: (newValue: TValue, rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
1620
+ /** Callback when editing starts */
1621
+ onEditStart?: (rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
1622
+ /** Callback when editing ends */
1623
+ onEditEnd?: (rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
1624
+ }
1625
+
1626
+ declare const Cell: <TData, TValue>({ value, column, rowData, editMode, isEditable, error, disabled, loading, showLabel, showHelperText, labelAlign, helperText, ui, onValueChange, onEditStart, onEditEnd, }: CellProps<TData, TValue>) => React$1.JSX.Element;
1627
+
1628
+ interface CalendarSpecificProps<TData> {
1629
+ /** Column id or accessorKey for the date column (must resolve to a Date or ISO string) */
1630
+ dateColumnId: string | keyof TData;
1631
+ /** Column id or accessorKey for the event/title column */
1632
+ eventColumnId: string | keyof TData;
1633
+ /** Optional starting month (Date) to render */
1634
+ initialMonth?: Date;
1635
+ /** Calendar View */
1636
+ view?: CalendarView;
1637
+ /**
1638
+ * Column id or accessorKey of a field that already contains the summary
1639
+ * value to display for that day (or month in year view).
1640
+ */
1641
+ summaryColumnId?: string | keyof TData;
1642
+ /**
1643
+ * Maximum number of events to show per day cell before collapsing the rest
1644
+ * into a "+ N more" button. Defaults to unlimited.
1645
+ */
1646
+ maxEvents?: number;
1647
+ /**
1648
+ * Optional function to override the background color of a specific event chip.
1649
+ * Receives the data row and returns a CSS color string, or undefined to use the default.
1650
+ * @example eventColorFn={(row) => row.type === 'holiday' ? '#f59e0b' : undefined}
1651
+ */
1652
+ eventColorFn?: (row: TData) => string | undefined;
1653
+ }
1654
+ type CalendarProps<TData> = DataStructureComponent<TData> & CalendarSpecificProps<TData>;
1655
+ type CalendarView = "month" | "week" | "day" | "year";
1656
+
1657
+ declare function Calendar<TData>({ data, columns, dateColumnId, eventColumnId, initialMonth, view, summaryColumnId, maxEvents, eventColorFn, uiConfig, }: CalendarProps<TData>): React__default.JSX.Element;
1658
+
1659
+ /**
1660
+ * Delta operation for a single column when the form state changes.
1661
+ * The server returns only the columns that need to be added, updated, or removed.
1662
+ */
1663
+ interface FormColumnDelta<TData> {
1664
+ /** What to do with this column */
1665
+ action: "add" | "update" | "remove";
1666
+ /** The column definition */
1667
+ column: FormColumn<TData>;
1668
+ }
1669
+ /**
1670
+ * Server response to a field change.
1671
+ * Only the changed pieces are returned — the form merges them with existing state.
1672
+ *
1673
+ * - `data`: partial data to merge (e.g. reset dependent fields to null)
1674
+ * - `columns`: delta operations on columns (add new dependent fields, update options, remove fields)
1675
+ * - `layout`: optional new layout. If omitted, the form recalculates from current columns.
1676
+ */
1677
+ interface FormChangeResponse<TData> {
1678
+ /** Partial data delta — merged with current formData */
1679
+ data?: Partial<TData>;
1680
+ /** Column delta operations — applied to current columns */
1681
+ columns?: FormColumnDelta<TData>[];
1682
+ /** Optional new layout. If omitted, layout is recalculated from updated columns. */
1683
+ layout?: ResponsiveLayout;
1684
+ }
1685
+ interface FormSpecificProps<TData> {
1686
+ /** Override columns with form-specific options */
1687
+ columns?: FormColumn<TData>[];
1688
+ /** label alignment */
1689
+ labelAlign?: "left" | "top";
1690
+ /** Optional layout configuration */
1691
+ layout?: ResponsiveLayout;
1692
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
1693
+ slotMap?: SlotMap;
1694
+ /** Callback when form is submitted */
1695
+ onSubmit?: (data: TData) => void;
1696
+ /** Callback when cancel is clicked */
1697
+ onCancel?: () => void;
1698
+ /** Custom action buttons rendered in the form footer.*/
1699
+ actions?: ButtonProps[];
1700
+ /**
1701
+ * Server-driven callback invoked on every field change.
1702
+ *
1703
+ * The server receives the current form state and the changed field,
1704
+ * and returns a **partial delta** — only the pieces that changed.
1705
+ * The form merges the delta into its state and re-renders only
1706
+ * the affected fields.
1707
+ *
1708
+ * Fields not yet resolved (loading) show a skeleton placeholder.
1709
+ *
1710
+ * @param formData - Current complete form data
1711
+ * @param changedField - The accessorKey of the field that changed
1712
+ * @param newValue - The new value of the changed field
1713
+ * @returns A partial delta with data, column operations, and optional layout
1714
+ */
1715
+ onFormChange?: (formData: TData, changedField: keyof TData, newValue: TData[keyof TData]) => Promise<FormChangeResponse<TData>>;
1716
+ }
1717
+ type FormProps<TData> = DataStructureComponent<TData> & FormSpecificProps<TData>;
1718
+ interface FormColumn<TData> extends DataStructureColumn<TData> {
1719
+ /** Optional: custom message when required validation fails */
1720
+ requiredMessage?: string;
1721
+ /** Optional: custom validation function */
1722
+ validate?: (value: TData[keyof TData], rowData: TData) => string | undefined;
1723
+ }
1724
+
1725
+ declare function Form<TData>({ data, columns, layout, slotMap, onSubmit, onCancel, onFormChange, uiConfig, labelAlign, actions }: FormProps<TData>): React__default.JSX.Element;
1726
+
1727
+ /**
1728
+ * Props for the CardList component.
1729
+ * Renders an array of data as a list of cards.
1730
+ */
1731
+ interface CardListSpecificProps<TData> {
1732
+ /** Responsive layout configuration for each card's fields */
1733
+ layout?: ResponsiveLayout;
1734
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`)*/
1735
+ slotMap?: SlotMap;
1736
+ /** Additional CSS class for the container */
1737
+ containerClassName?: string;
1738
+ /** Called when a card is clicked, with the item data */
1739
+ onCardClick?: (item: TData) => void;
1740
+ /** Currently selected item (single selection) */
1741
+ selected?: TData;
1742
+ /** Array of selected items (multi-selection) */
1743
+ multiSelection?: TData[];
1744
+ /** Function to determine if an item is selected (used when TData is not comparable by reference) */
1745
+ isSelected?: (item: TData, selectedItem: TData) => boolean;
1746
+ }
1747
+ type CardListProps<TData> = DataStructureComponent<TData> & CardListSpecificProps<TData>;
1748
+
1749
+ /**
1750
+ * Renders an array of data as a list of cards.
1751
+ * Each card is configured with the same columns and layout.
1752
+ */
1753
+ declare function CardList<TData>({ data, columns, layout, slotMap, containerClassName, uiConfig, onCardClick, selected, multiSelection, isSelected, }: CardListProps<TData>): React$1.JSX.Element;
1754
+ declare namespace CardList {
1755
+ var displayName: string;
1756
+ }
1757
+
1758
+ /** Position where a dragged node can be dropped, relative to a drop target. */
1759
+ type TreeDropPosition = "inside" | "before" | "after";
1760
+ /** Payload describing the drop of a dragged node onto a target node. */
1761
+ interface TreeDropPayload {
1762
+ /** Id of the dragged node. */
1763
+ sourceId: string;
1764
+ /** Id of the node used as drop target. */
1765
+ targetId: string;
1766
+ /** Where the node is dropped relative to the target. */
1767
+ position: TreeDropPosition;
1768
+ }
1769
+ /** Internal (non-data) state of a row, fed to the row renderer. */
1770
+ interface TreeRowState {
1771
+ depth: number;
1772
+ isExpanded: boolean;
1773
+ isSelected: boolean;
1774
+ isOver: boolean;
1775
+ dropPosition: TreeDropPosition | undefined;
1776
+ isDragging: boolean;
1777
+ isDisabled: boolean;
1778
+ }
1779
+ /** Contract passed from the Tree to each row (accessors, callbacks, state fns). */
1780
+ interface TreeRowScope<TData> {
1781
+ getNodeId: (node: TData) => string;
1782
+ getNodeLabel: (node: TData) => string;
1783
+ getChildren: (node: TData) => TData[] | undefined;
1784
+ isExpanded: (id: string) => boolean;
1785
+ isSelected: (id: string) => boolean;
1786
+ isDragging: (id: string) => boolean;
1787
+ /** Id of the unique direct parent of the hovered node, if any. */
1788
+ parentOfHoveredId?: string;
1789
+ /** Set the id of the row currently hovered (undefined to clear). */
1790
+ setHoveredId: (id: string | undefined) => void;
1791
+ hoverTargetId: string | undefined;
1792
+ hoverPosition: TreeDropPosition | undefined;
1793
+ /** True while the current hover target is not a valid drop target (rejected). */
1794
+ dropRejected: boolean;
1795
+ onToggle: (id: string) => void;
1796
+ onSelect: (id: string) => void;
1797
+ onDragStart: (e: React__default.DragEvent, id: string) => void;
1798
+ onDragOver: (e: React__default.DragEvent, id: string) => void;
1799
+ onDragLeave: () => void;
1800
+ onDrop: (e: React__default.DragEvent, id: string) => void;
1801
+ onAction?: (actionId: string, node: TData, id: string) => void;
1802
+ renderNode?: (node: TData, state: TreeRowState) => React__default.ReactNode;
1803
+ getNodeIcon?: (node: TData) => string | undefined;
1804
+ getNodeDisabled?: (node: TData) => boolean;
1805
+ actions?: Option[];
1806
+ draggable?: boolean;
1807
+ enableDragAndDrop?: boolean;
1808
+ enableConnection?: boolean;
1809
+ depth: number;
1810
+ }
1811
+ /** Imperative handle exposed via `ref` for programmatic expansion control. */
1812
+ interface TreeHandle {
1813
+ expandAll: () => void;
1814
+ collapseAll: () => void;
1815
+ expandToLevel: (level: number) => void;
1816
+ collapseToLevel: (level: number) => void;
1817
+ }
1818
+ interface TreeProps<TData> {
1819
+ /** Array of root nodes of the forest. */
1820
+ data: TData[];
1821
+ /** Accessor returning the children of a node (undefined for leaves). */
1822
+ getChildren: (node: TData) => TData[] | undefined;
1823
+ /** Accessor returning a stable unique id for the node. */
1824
+ getNodeId: (node: TData) => string;
1825
+ /** Id of the currently selected branch (node that also "comprises" its children). */
1826
+ selectedId?: string;
1827
+ /** Called when a node is selected. */
1828
+ onSelect?: (node: TData, id: string) => void;
1829
+ /** Initial expanded ids. */
1830
+ defaultExpandedIds?: string[];
1831
+ /**
1832
+ * Row actions rendered in the overflow menu. The `value` of each option is
1833
+ * passed to `onAction`; the consumer fully owns their behavior.
1834
+ */
1835
+ actions?: Option[];
1836
+ /** Called when an action (from `actions`) is fired. */
1837
+ onAction?: (actionId: string, node: TData, id: string) => void;
1838
+ /** Whether rows are draggable and the drag handle is shown. Defaults to true. */
1839
+ enableDragAndDrop?: boolean;
1840
+ /** Whether vertical connection lines are shown. Defaults to true. */
1841
+ enableConnection?: boolean;
1842
+ /** Custom validator run before emitting a drop. Return false to reject. */
1843
+ canDrop?: (payload: TreeDropPayload) => boolean;
1844
+ /** Per-node drop validator. */
1845
+ canDropNode?: (source: TData, target: TData, position: TreeDropPosition) => boolean;
1846
+ /** Emitted when a node is dropped onto/around a target. */
1847
+ onNodeDrop?: (payload: TreeDropPayload) => void;
1848
+ /** Custom renderer for the row content. Receives the node + internal state. */
1849
+ renderNode?: (node: TData, state: TreeRowState) => React__default.ReactNode;
1850
+ /** Extract the display label of a node. Defaults to a `label` field. */
1851
+ getNodeLabel?: (node: TData) => string;
1852
+ /** Extract the icon for a node. Emoji strings are rendered as text; URLs/names use the Icon component. */
1853
+ getNodeIcon?: (node: TData) => string | undefined;
1854
+ /** Extract whether a node is disabled. Disabled nodes are not draggable and get a disabled style. */
1855
+ getNodeDisabled?: (node: TData) => boolean;
1856
+ /** Accessibility label describing the whole tree. */
1857
+ ariaLabel?: string;
1858
+ className?: string;
1859
+ /** Imperative handle for programmatic expansion control (see {@link TreeHandle}). */
1860
+ ref?: React__default.Ref<TreeHandle>;
1861
+ }
1862
+
1863
+ /** Renders a hierarchical (tree) structure as a sortable, accessible list. */
1864
+ declare function Tree<TData>(props: TreeProps<TData> & {
1865
+ ref?: React__default.Ref<TreeHandle>;
1866
+ }): React__default.JSX.Element;
1867
+
1868
+ interface TreeCardSpecificProps<TData> {
1869
+ /** Column definitions used to render each card's fields. */
1870
+ columns?: DataStructureColumn<TData>[];
1871
+ /** Responsive layout configuration for each card's fields. */
1872
+ layout?: ResponsiveLayout;
1873
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`). */
1874
+ slotMap?: SlotMap;
1875
+ /** UI configuration for conditional styling and presentation. */
1876
+ uiConfig?: DataStructureUIConfig<TData>;
1877
+ /** Which nodes get a card body: every node, or only the last nesting level (leaves). Defaults to "all". */
1878
+ cardsAt?: "all" | "leaves";
1879
+ }
1880
+ /** Props for the TreeCard component — combines Tree props with Card-specific layout configuration. */
1881
+ interface TreeCardProps<TData> extends TreeProps<TData>, TreeCardSpecificProps<TData> {
1882
+ }
1883
+
1884
+ /** Renders a hierarchical (tree) structure as nested Cards, reusing {@link Tree}'s mechanism. */
1885
+ declare function TreeCard<TData>(props: TreeCardProps<TData> & {
1886
+ ref?: React__default.Ref<TreeHandle>;
1887
+ }): React__default.JSX.Element;
1888
+
1889
+ /**
1890
+ * Props for the KPI component.
1891
+ * A KPI is a single-metric Card;
1892
+ */
1893
+ interface KPISpecificProps<TData> {
1894
+ /** Single row of data to display in the KPI */
1895
+ data: TData;
1896
+ /** Layout for the KPI fields. Reuse a shared layout example or supply a custom one. */
1897
+ layout?: ResponsiveLayout;
1898
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
1899
+ slotMap?: SlotMap;
1900
+ /** Additional CSS class for the KPI container */
1901
+ className?: string;
1902
+ /** Called when the KPI is clicked */
1903
+ onClick?: () => void;
1904
+ }
1905
+ type KPIProps<TData> = Omit<DataStructureComponent<TData>, "data"> & KPISpecificProps<TData>;
1906
+
1907
+ /**
1908
+ * KPI component — a single-metric Card.
1909
+ */
1910
+ declare function KPI<TData>({ data, columns, layout, slotMap, className, uiConfig, onClick }: KPIProps<TData>): React$1.JSX.Element;
1911
+
1912
+ /**
1913
+ * Shared finance layouts, usable by any component that accepts a
1914
+ * `ResponsiveLayout` (Card, KPI, CardList).
1915
+ *
1916
+ * Field IDs are intentionally generic so they work with any dataset that
1917
+ * follows the KPI shape: `label`, `value`, `delta`, `trend`, `icon`.
1918
+ */
1919
+ /**
1920
+ * Compact KPI layout: label on top, big value in the middle, delta/trend
1921
+ * at the bottom. On small breakpoints it collapses to a single column.
1922
+ */
1923
+ declare const financeKpiLayout: ResponsiveLayout;
1924
+ /**
1925
+ * Finance layout with leading icon on the right side (icon spans the whole
1926
+ * height). Useful when the dataset includes a representative icon/illustration.
1927
+ */
1928
+ declare const financeKpiLayoutWithIcon: ResponsiveLayout;
1929
+
1930
+ /** A registered CardList layout preset. */
1931
+ interface CardLayoutPreset {
1932
+ id: string;
1933
+ label: string;
1934
+ description: string;
1935
+ /** Bundled SVG icon name shown in the selector. */
1936
+ leadingVisual?: string;
1937
+ layout: ResponsiveLayout;
1938
+ }
1939
+ /**
1940
+ * Card layout: icon on the left, name + type next to it, actions right-aligned.
1941
+ *
1942
+ * Field IDs: `icon`, `name`, `type`, `actions`.
1943
+ *
1944
+ * ┌──────────────────────────────────────┐
1945
+ * │ icon name actions │
1946
+ * │ type │
1947
+ * └──────────────────────────────────────┘
1948
+ */
1949
+ declare const cardLayoutWithIcon: ResponsiveLayout;
1950
+ /** Maps a preset id to its `ResponsiveLayout`. Falls back to `undefined`. */
1951
+ declare function resolveCardLayoutPreset(id?: string): ResponsiveLayout | undefined;
1952
+ /** Option shape consumed by the card-list layout selector. */
1953
+ declare const cardLayoutPresetOptions: {
1954
+ value: string;
1955
+ label: string;
1956
+ description: string;
1957
+ leadingVisual: string | undefined;
1958
+ }[];
1959
+
1960
+ /**
1961
+ * A registered KPI layout preset.
1962
+ *
1963
+ * `id` is the value stored in the widget config (and resolved back to a
1964
+ * `ResponsiveLayout` at render time by the Switcher). `label` / `description`
1965
+ * drive the selector UI; `layout` is the actual tree rendered in the preview
1966
+ * and passed to the `KPI` component.
1967
+ */
1968
+ interface KpiLayoutPreset {
1969
+ id: string;
1970
+ label: string;
1971
+ description: string;
1972
+ /** Bundled SVG icon name shown in the selector. */
1973
+ leadingVisual?: string;
1974
+ layout: ResponsiveLayout;
1975
+ }
1976
+ /** Maps a preset id to its `ResponsiveLayout`. Falls back to `undefined`. */
1977
+ declare function resolveKpiLayoutPreset(id?: string): ResponsiveLayout | undefined;
1978
+ /** Option shape consumed by the `preview-dialog` selector. */
1979
+ declare const kpiLayoutPresetOptions: {
1980
+ value: string;
1981
+ label: string;
1982
+ description: string;
1983
+ leadingVisual: string | undefined;
1984
+ }[];
1985
+
1986
+ /**
1987
+ * Identifiers for all data-components that the switcher can render.
1988
+ */
1989
+ type DataComponentId = "table-grid" | "chart" | "calendar" | "gantt" | "form" | "card-list" | "kpi";
1990
+ /**
1991
+ * Maps each component id to its specific props interface (without DataStructureComponent).
1992
+ * Used by the switcher to type the dynamic `componentProps` state.
1993
+ */
1994
+ type ComponentSpecificPropsMap<TData> = {
1995
+ "table-grid": TableGridSpecificProps<TData>;
1996
+ "chart": ChartSpecificProps<TData>;
1997
+ "calendar": CalendarSpecificProps<TData>;
1998
+ "gantt": GanttSpecificProps<TData>;
1999
+ "form": FormSpecificProps<TData>;
2000
+ "card-list": CardListSpecificProps<TData>;
2001
+ "kpi": KPISpecificProps<TData>;
2002
+ };
2003
+ /**
2004
+ * Props for the Switcher component.
2005
+ * Accepts the shared DataStructureComponent props plus an optional initial component.
2006
+ *
2007
+ * Two modes:
2008
+ * - **Uncontrolled**: provide `initialComponent` / `initialComponentProps`. Switcher manages its own state.
2009
+ * - **Controlled**: provide `activeComponent` / `componentProps`. The parent manages state,
2010
+ * and the Switcher reflects changes immediately. Use this when an external configurator
2011
+ * (e.g. DashboardBuilder) drives the configuration.
2012
+ */
2013
+ interface SwitcherProps<TData> extends DataStructureComponent<TData> {
2014
+ /** Initial active component. Defaults to "table-grid". (Uncontrolled mode) */
2015
+ initialComponent?: DataComponentId;
2016
+ /** Initial specific props for the active component. (Uncontrolled mode) */
2017
+ initialComponentProps?: Partial<ComponentSpecificPropsMap<TData>[DataComponentId]>;
2018
+ /** Active component. When provided, Switcher runs in controlled mode. */
2019
+ activeComponent?: DataComponentId;
2020
+ /** Current component props. When provided, Switcher runs in controlled mode. */
2021
+ componentProps?: Record<string, unknown>;
2022
+ /** Whether to show the "Configure" button and overlay. Default: true. */
2023
+ showConfigurator?: boolean;
2024
+ /** Called when the active component changes. */
2025
+ onComponentChange?: (componentId: DataComponentId) => void;
2026
+ /** Called when the specific props change. */
2027
+ onComponentPropsChange?: (props: Partial<ComponentSpecificPropsMap<TData>[DataComponentId]>) => void;
2028
+ }
2029
+
2030
+ /**
2031
+ * Switcher — wraps a data-component
2032
+ * Shared props (data, columns, uiConfig, getSubRows) are passed to every component.
2033
+ * Specific props are managed per-component via the config overlay.
2034
+ *
2035
+ * Two modes:
2036
+ * - **Uncontrolled**: provide `initialComponent` / `initialComponentProps`
2037
+ * - **Controlled**: provide `activeComponent` / `componentProps` (external configurator drives state)
2038
+ */
2039
+ declare const Switcher: <TData extends object>({ data, columns, getSubRows, uiConfig, initialComponent, initialComponentProps, activeComponent: controlledComponent, componentProps: controlledProps, showConfigurator, onComponentChange, onComponentPropsChange, }: SwitcherProps<TData>) => React__default.JSX.Element;
2040
+
2041
+ /**
2042
+ * Where a prop field is configurable.
2043
+ * - `"all"`: visible in both Switcher and Dashboard configurator
2044
+ * - `"switcher"`: visible only in the Switcher panel
2045
+ * - `"dashboard"`: visible only in the Dashboard configurator
2046
+ * - `"none"`: not configurable via UI (callbacks, complex objects, etc.)
2047
+ */
2048
+ type PropFieldScope = "all" | "switcher" | "dashboard" | "none";
2049
+ /**
2050
+ * Describes a single configurable prop field for the dynamic PropForm.
2051
+ */
2052
+ interface PropFieldDescriptor {
2053
+ /** Prop name (matches the key in the SpecificProps interface). */
2054
+ name: string;
2055
+ /** Control type to render. */
2056
+ type: "boolean" | "string" | "number" | "select" | "column" | "columns" | "color[]" | "chart-series" | "slot-map";
2057
+ /** Human-readable label. */
2058
+ label: string;
2059
+ /** Default value when the prop is not set. */
2060
+ defaultValue: unknown;
2061
+ /**
2062
+ * Where this field is configurable.
2063
+ * @default "all"
2064
+ */
2065
+ scope?: PropFieldScope;
2066
+ /** Options for "select" type controls. */
2067
+ options?: {
2068
+ label: string;
2069
+ value: string;
2070
+ description?: string;
2071
+ leadingVisual?: string;
2072
+ }[];
2073
+ /**
2074
+ * Generic column-level configuration forwarded as-is to the generated
2075
+ */
2076
+ columnConfig?: Record<string, unknown>;
2077
+ /**
2078
+ * Optional condition: if provided, the field is only visible when this
2079
+ * function returns true given the current form values.
2080
+ */
2081
+ condition?: (formValues: Record<string, unknown>) => boolean;
2082
+ }
2083
+ /**
2084
+ * Registry mapping each DataComponentId to its array of PropFieldDescriptors.
2085
+ */
2086
+ type PropSchemaRegistry = Record<string, PropFieldDescriptor[]>;
2087
+
2088
+ /**
2089
+ * Props for the shared DataComponentConfigurator.
2090
+ *
2091
+ * This component is used in two contexts:
2092
+ * 1. **Switcher** — shows the component selector + prop form (scope: "switcher")
2093
+ * 2. **Dashboard widget configurator** — shows only the prop form (scope: "dashboard")
2094
+ */
2095
+ interface DataComponentConfiguratorProps {
2096
+ /** Schema for the active component's configurable fields. */
2097
+ schema: PropFieldDescriptor[];
2098
+ /** Current values for all fields. */
2099
+ values: Record<string, unknown>;
2100
+ /** Called when a field value changes. */
2101
+ onChange: (name: string, value: unknown) => void;
2102
+ /** Available columns (for "column" / "columns" type fields). */
2103
+ columns?: DataStructureColumn<Record<string, unknown>>[];
2104
+ /**
2105
+ * Scope filter — only fields matching this scope are rendered.
2106
+ * @default "all"
2107
+ */
2108
+ scope?: PropFieldScope;
2109
+ /** When provided, shows the component selector panel. */
2110
+ componentId?: DataComponentId;
2111
+ /** Called when the active component changes. */
2112
+ onComponentChange?: (componentId: DataComponentId) => void;
2113
+ /** Metadata list for the component selector. */
2114
+ componentMetaList?: {
2115
+ id: DataComponentId;
2116
+ label: string;
2117
+ icon: string;
2118
+ }[];
2119
+ }
2120
+
2121
+ /**
2122
+ * Shared configurator for data-components.
2123
+ *
2124
+ * Renders:
2125
+ * - An optional **component selector** (when `componentMetaList` is provided)
2126
+ * - A **dynamic prop form** filtered by the given scope
2127
+ *
2128
+ * Used by:
2129
+ * - **Switcher** — full configurator with component selector + all props
2130
+ * - **Dashboard widget configurator** — prop form only (scope: "dashboard")
2131
+ */
2132
+ declare const DataComponentConfigurator: {
2133
+ ({ schema, values, onChange, columns, scope, componentId, onComponentChange, componentMetaList, }: DataComponentConfiguratorProps): React__default.JSX.Element;
2134
+ displayName: string;
2135
+ };
2136
+
2137
+ interface AppBarProps {
2138
+ children: React__default.ReactNode;
2139
+ className?: string;
2140
+ }
2141
+ interface AppBarTitleProps {
2142
+ children: React__default.ReactNode;
2143
+ className?: string;
2144
+ }
2145
+ interface AppBarActionsProps {
2146
+ children: React__default.ReactNode;
2147
+ className?: string;
2148
+ }
2149
+ interface AppBarMenuButtonProps {
2150
+ onClick?: () => void;
2151
+ className?: string;
2152
+ 'aria-label'?: string;
2153
+ }
2154
+
2155
+ declare const AppBar: React__default.FC<AppBarProps> & {
2156
+ Title: React__default.FC<AppBarTitleProps>;
2157
+ Actions: React__default.FC<AppBarActionsProps>;
2158
+ MenuButton: React__default.FC<AppBarMenuButtonProps>;
2159
+ };
2160
+
2161
+ interface BreadcrumbItem {
2162
+ label: string;
2163
+ value?: string;
2164
+ onClick?: () => void;
2165
+ }
2166
+ interface BreadcrumbsProps extends React.HTMLAttributes<HTMLDivElement> {
2167
+ items: BreadcrumbItem[];
2168
+ /**
2169
+ * Number of items before collapsing into menu
2170
+ * Default is 3. If items count exceeds this, middle items collapse
2171
+ */
2172
+ collapsThreshold?: number;
2173
+ }
2174
+
2175
+ declare const Breadcrumbs: React__default.FC<BreadcrumbsProps>;
2176
+
2177
+ type SidebarLogoProps = {
2178
+ logo: string;
2179
+ /** Called when the logo button is clicked (e.g. to navigate home). */
2180
+ onClick?: () => void;
2181
+ };
2182
+
2183
+ type SidebarProps = {
2184
+ children: ReactNode;
2185
+ };
2186
+ type SectionProps$1 = {
2187
+ title?: string;
2188
+ children: ReactNode;
2189
+ };
2190
+ type UserProps = {
2191
+ avatar: ReactNode;
2192
+ name: string;
2193
+ };
2194
+
2195
+ declare const Sidebar: {
2196
+ ({ children }: SidebarProps): React$1.JSX.Element;
2197
+ displayName: string;
2198
+ Logo: ({ logo, onClick }: SidebarLogoProps) => React$1.JSX.Element;
2199
+ Item: ({ leadingVisual, label, shortcut, disabled, onClick }: MenuItem) => React$1.JSX.Element | null;
2200
+ Section: ({ title, children }: SectionProps$1) => React$1.JSX.Element;
2201
+ User: ({ avatar, name }: UserProps) => React$1.JSX.Element;
2202
+ };
2203
+
2204
+ type StepperStepState = "idle" | "active" | "done";
2205
+ interface StepperItem {
2206
+ /** Unique identifier for the step. */
2207
+ value: string;
2208
+ /** Display label shown next to the marker. */
2209
+ label: string;
2210
+ }
2211
+ interface StepperProps extends React.HTMLAttributes<HTMLElement> {
2212
+ /** Ordered list of steps to render. */
2213
+ items: StepperItem[];
2214
+ /** The value of the current step. Steps before this are marked as done. */
2215
+ current: string;
2216
+ }
2217
+
2218
+ /**
2219
+ * Horizontal stepper that renders ordered steps with idle/active/done states.
2220
+ * Steps before `current` are automatically marked as done. Each step renders
2221
+ * as a `Tag` whose state changes with the step status.
2222
+ */
2223
+ declare const Stepper: React__default.FC<StepperProps>;
2224
+
2225
+ interface ScaffoldProps {
2226
+ children: React__default.ReactNode;
2227
+ defaultSidebarOpen?: boolean;
2228
+ className?: string;
2229
+ }
2230
+ interface ScaffoldContentProps {
2231
+ children: React__default.ReactNode;
2232
+ className?: string;
2233
+ }
2234
+ interface ScaffoldContextValue {
2235
+ isSidebarOpen: boolean;
2236
+ toggleSidebar: () => void;
2237
+ setSidebarOpen: (open: boolean) => void;
2238
+ isMobile: boolean;
2239
+ }
2240
+
2241
+ declare const Scaffold: React__default.FC<ScaffoldProps> & {
2242
+ Content: React__default.FC<ScaffoldContentProps>;
2243
+ };
2244
+
2245
+ declare const useScaffold: () => ScaffoldContextValue;
2246
+
2247
+ interface SectionProps {
2248
+ /** The title displayed at the top of the section */
2249
+ title: string;
2250
+ /** Optional subtitle displayed below the title */
2251
+ subtitle?: string;
2252
+ /** Optional icon name (bundled SVG) shown before the title in the header */
2253
+ icon?: string;
2254
+ /** Optional actions rendered on the right side of the header */
2255
+ headerActions?: React__default.ReactNode;
2256
+ /** The content rendered inside the section body */
2257
+ children: React__default.ReactNode;
2258
+ /** Additional CSS class names */
2259
+ className?: string;
2260
+ }
2261
+
2262
+ /**
2263
+ * Section is a layout container that groups content with a title and optional subtitle.
2264
+ * It features a box-shadow to visually separate zones within a page.
2265
+ */
2266
+ declare const Section: React__default.FC<SectionProps>;
2267
+
2268
+ interface BlankSlateProps {
2269
+ children: React__default.ReactNode;
2270
+ className?: string;
2271
+ }
2272
+ interface BlankSlateGraphicProps {
2273
+ src: string;
2274
+ alt?: string;
2275
+ }
2276
+ interface BlankSlateHeadingProps {
2277
+ children: React__default.ReactNode;
2278
+ }
2279
+ interface BlankSlateDescriptionProps {
2280
+ children: React__default.ReactNode;
2281
+ }
2282
+ interface BlankSlateActionsProps {
2283
+ children: React__default.ReactNode;
2284
+ }
2285
+ interface BlankSlateAction {
2286
+ label: string;
2287
+ variant?: "primary" | "base";
2288
+ onClick: () => void;
2289
+ leadingVisual?: string;
2290
+ }
2291
+ interface BlankSlatePreset {
2292
+ graphic: string;
2293
+ heading: string;
2294
+ description: string;
2295
+ primaryAction: BlankSlateAction;
2296
+ secondaryAction?: BlankSlateAction;
2297
+ }
2298
+
2299
+ declare const BlankSlate: React__default.FC<BlankSlateProps> & {
2300
+ Graphic: React__default.FC<BlankSlateGraphicProps>;
2301
+ Heading: React__default.FC<BlankSlateHeadingProps>;
2302
+ Description: React__default.FC<BlankSlateDescriptionProps>;
2303
+ Actions: React__default.FC<BlankSlateActionsProps>;
2304
+ Preset: React__default.FC<BlankSlatePreset>;
2305
+ };
2306
+
2307
+ /**
2308
+ * Derives `FilterFieldProp[]` from column definitions.
2309
+ *
2310
+ * Columns without a resolvable ID or header are skipped.
2311
+ * SELECT / BUTTON_GROUP columns populate `availableOptions` from `col.options`.
2312
+ */
2313
+ declare function fieldOptionsFromColumns<TData>(columns: DataStructureColumn<TData>[]): FilterFieldProp[];
2314
+ /** Returns the available operator options for a given column type. */
2315
+ declare function getOperatorsForType(type: FilterColumnType): OperatorOption[];
2316
+ /** Returns the default (first) operator for a given column type. */
2317
+ declare function getDefaultOperator(type: FilterColumnType): OperatorOption;
2318
+ /** Creates an empty root `FilterGroup` with AND logic and no conditions. */
2319
+ declare function emptyFilterGroup(): FilterGroup;
2320
+ /** Creates a blank `FilterCondition` for the given field. */
2321
+ declare function emptyCondition(field: FilterFieldProp): FilterCondition;
2322
+ /** Returns `true` when the filter tree contains at least one non-empty condition. */
2323
+ declare function isFilterActive(filter: FilterGroup | null): boolean;
2324
+ /** Replaces the node at `path` indices within a `FilterGroup` tree. */
2325
+ declare function updateNodeAtPath(root: FilterGroup, path: number[], updater: (node: FilterNode) => FilterNode): FilterGroup;
2326
+ /** Removes the node at `path` from a `FilterGroup` tree. */
2327
+ declare function removeNodeAtPath(root: FilterGroup, path: number[]): FilterGroup;
2328
+ /** Appends a node at the end of the group identified by `path`. */
2329
+ declare function addNodeAtPath(root: FilterGroup, path: number[], node: FilterNode): FilterGroup;
2330
+ /**
2331
+ * Strips conditions whose `field.id` is not present in `columns`.
2332
+ * Groups with no surviving children are pruned.
2333
+ */
2334
+ declare function stripByFields<TData>(filter: FilterGroup | null, columns: DataStructureColumn<TData>[]): FilterGroup | null;
2335
+ /**
2336
+ * Merges a global filter tree with a per-section filter tree.
2337
+ */
2338
+ declare function mergeFilters<TData>(global: FilterGroup | null, section: FilterGroup | null, columns: DataStructureColumn<TData>[]): FilterGroup | null;
2339
+ /**
2340
+ * Counts top-level filter nodes inside a `FilterGroup`.
2341
+ * Empty groups do not count.
2342
+ */
2343
+ declare function countTopLevelFilters(filter: FilterGroup | null): number;
2344
+ /**
2345
+ * Counts active top-level filters across a map of per-data-source filter groups.
2346
+ */
2347
+ declare function countTopLevelFiltersMap(filters: Record<string, FilterGroup | null> | null): number;
2348
+
2349
+ /**
2350
+ * Filters `data` rows using the provided `FilterGroup` AST.
2351
+ *
2352
+ * - Returns the original `data` array reference unchanged when `filter` is
2353
+ * `null` or contains no active conditions (avoids unnecessary re-renders).
2354
+ * - Works with any `DataStructureComponent`-compatible column definition,
2355
+ * resolving values via `accessorFn` or `accessorKey`.
2356
+ *
2357
+ * @example
2358
+ * const visible = applyFilter(data, filterGroup, columns);
2359
+ */
2360
+ declare function applyFilter<TData>(data: TData[], filter: FilterGroup | null, columns: DataStructureColumn<TData>[]): TData[];
2361
+
2362
+ interface FilterBuilderProps {
2363
+ readonly filters: FilterGroup;
2364
+ readonly onChange: (filters: FilterGroup) => void;
2365
+ readonly fieldOptions: FilterFieldProp[];
2366
+ readonly ref?: Ref<HTMLDivElement>;
2367
+ readonly onClose?: () => void;
2368
+ readonly isReadOnly?: boolean;
2369
+ }
2370
+ declare const FilterBuilder: React.FC<FilterBuilderProps>;
2371
+
2372
+ interface FilterConditionEditorProps {
2373
+ readonly condition: FilterCondition;
2374
+ readonly onChange: (condition: FilterCondition) => void;
2375
+ readonly fieldOptions: FilterFieldProp[];
2376
+ readonly onDelete?: () => void;
2377
+ /** Enables the guided step-by-step flow (field → operator → value). */
2378
+ readonly guided?: boolean;
2379
+ /** Called when the guided flow completes (value chosen / valueless operator). */
2380
+ readonly onGuidedComplete?: () => void;
2381
+ }
2382
+ /**
2383
+ * Shared row-level filter condition editor: field → operator → value.
2384
+ *
2385
+ * Reused by both `FilterBuilder` (panel rows inside groups) and `FilterField`
2386
+ * (inline chips in edit-in-place mode). This is the single place where field /
2387
+ * operator / value input switching logic lives.
2388
+ *
2389
+ * Each piece (field, operator, value, delete) can be individually locked via
2390
+ * `condition.readOnly` or the `readOnly` prop.
2391
+ *
2392
+ * When `guided` is `true`, the editor walks the user through the three steps,
2393
+ * auto-opening the dropdown / focusing the input of the current step.
2394
+ */
2395
+ declare const FilterConditionEditor: React.FC<FilterConditionEditorProps>;
2396
+
2397
+ interface FilterFieldProps {
2398
+ /** Current filter group (AND at top level; single conditions only). */
2399
+ readonly filters: FilterGroup;
2400
+ /** Called whenever a condition is added, edited, or removed. */
2401
+ readonly onChange: (filters: FilterGroup) => void;
2402
+ /** Available fields derived from columns (via `fieldOptionsFromColumns`). */
2403
+ readonly fields: FilterFieldProp[];
2404
+ /** Disables all editing controls when `true`. */
2405
+ readonly readOnly?: boolean;
2406
+ /** Maximum number of conditions rendered inline.*/
2407
+ readonly maxVisible?: number;
2408
+ }
2409
+
2410
+ declare const FilterField: React.FC<FilterFieldProps>;
2411
+
2412
+ /**
2413
+ * Props for the Dashboard orchestrator component.
2414
+ *
2415
+ * Dashboard provides global filters to all child DashboardWidget instances
2416
+ * and arranges them using the responsive Layout system.
2417
+ *
2418
+ * Global filters are organised per data source: each entry in `filters` is
2419
+ * keyed by the data source id (e.g. "transactions", "budgets") and contains
2420
+ * the filter tree specific to that source. Widgets pick the entry matching
2421
+ * their own data source via context.
2422
+ */
2423
+ interface DashboardProps {
2424
+ /**
2425
+ * Global filter trees keyed by data source id.
2426
+ * Each widget receives the entry whose key matches its data source,
2427
+ * then merges it with its own per-section filters.
2428
+ */
2429
+ filters: Record<string, FilterGroup | null> | null;
2430
+ /** Called when a data-source filter tree changes (key + new tree) */
2431
+ onFilterChange: (dataSourceId: string, filters: FilterGroup | null) => void;
2432
+ /** Responsive layout configuration (mobile / tablet / desktop breakpoints) */
2433
+ layout: ResponsiveLayout;
2434
+ /**
2435
+ * Field definitions for the FilterBuilder, keyed by data source id.
2436
+ * Each entry is shown as a separate tab/section inside the global filter
2437
+ * overlay. Required when `enableFilter` is true.
2438
+ */
2439
+ fieldOptions?: Record<string, FilterFieldProp[]>;
2440
+ /** Show a filter button that opens the FilterBuilder overlay */
2441
+ enableFilter?: boolean;
2442
+ /** DashboardWidget children */
2443
+ children: ReactNode;
2444
+ /** Additional CSS class name */
2445
+ className?: string;
2446
+ }
2447
+ /**
2448
+ * Value provided by DashboardContext to all child DashboardWidgets.
2449
+ */
2450
+ interface DashboardContextValue {
2451
+ /** The global filter trees keyed by data source id */
2452
+ filters: Record<string, FilterGroup | null> | null;
2453
+ /** Update a single data-source filter tree */
2454
+ onFilterChange: (dataSourceId: string, filters: FilterGroup | null) => void;
2455
+ }
2456
+
2457
+ /**
2458
+ * Dashboard is the top-level orchestrator for a page of data widgets.
2459
+ *
2460
+ * It provides global filters to all child DashboardWidget instances via
2461
+ * context, keyed by data source id, and arranges widgets using the
2462
+ * responsive Layout system.
2463
+ *
2464
+ * When `enableFilter` is set, a filter button opens the FilterBuilder
2465
+ * overlay where the user picks a data source and edits its filter tree.
2466
+ * The button shows the total number of active top-level filters across
2467
+ * all data sources.
2468
+ */
2469
+ declare const Dashboard: React__default.FC<DashboardProps>;
2470
+
2471
+ /**
2472
+ * Hook to consume the DashboardContext.
2473
+ * Returns the current filters and onFilterChange callback.
2474
+ * Returns null when used outside a Dashboard.
2475
+ */
2476
+ declare function useDashboard(): DashboardContextValue | null;
2477
+
2478
+ /**
2479
+ * Filtered data payload passed to the DashboardWidget render prop.
2480
+ */
2481
+ interface DashboardWidgetRenderPayload<TData> {
2482
+ /** Data filtered by the global dashboard filters */
2483
+ data: TData[];
2484
+ }
2485
+ /**
2486
+ * Props for the DashboardWidget component.
2487
+ *
2488
+ * Three modes are supported, depending on which props you provide:
2489
+ *
2490
+ * - **Passthrough mode**: provide only `data`. The data is used as-is —
2491
+ * the server already prepared it. Zero frontend processing.
2492
+ * - **Legacy mode**: provide `data` + `columns`. Global dashboard filters
2493
+ * are applied client-side via `applyFilter()`.
2494
+ */
2495
+ interface DashboardWidgetProps<TData> {
2496
+ /** Unique identifier for this widget (used as Layout block key) */
2497
+ id: string;
2498
+ /** Widget title displayed in the Section header */
2499
+ title: string;
2500
+ /**
2501
+ * Data source identifier used to pick this widget's entry from the
2502
+ * dashboard's per-source global filter map. Required to receive
2503
+ * global filters (otherwise only the per-section filter applies).
2504
+ */
2505
+ dataSourceId?: string;
2506
+ /** Optional subtitle displayed below the title */
2507
+ subtitle?: string;
2508
+ /** Optional icon name (bundled SVG) shown before the title in the Section header */
2509
+ icon?: string;
2510
+ /**
2511
+ * Data for this widget.
2512
+ *
2513
+ * - **Passthrough**: provide `data` alone → used as-is (server-ready).
2514
+ * - **Legacy**: provide `data` + `columns` → global filters applied.
2515
+ */
2516
+ data?: TData[];
2517
+ /**
2518
+ * Column definitions. When provided, global dashboard filters are
2519
+ * applied client-side via `applyFilter()`. Omit for passthrough mode.
2520
+ */
2521
+ columns?: DataStructureColumn<TData>[];
2522
+ /** Optional UI config for conditional styling */
2523
+ uiConfig?: DataStructureUIConfig<TData>;
2524
+ /** Render prop receiving filtered data */
2525
+ children: (payload: DashboardWidgetRenderPayload<TData>) => ReactNode;
2526
+ /** Show the export data action button */
2527
+ enableExport?: boolean;
2528
+ /** Show the screenshot action button */
2529
+ enableScreenshot?: boolean;
2530
+ /** Show the visual expand (fullscreen) action button */
2531
+ enableExpand?: boolean;
2532
+ /** Show a per-section filter button in the widget header. */
2533
+ enableFilter?: boolean;
2534
+ /** Filter fields available for this widget's data source (required when `enableFilter` is true) */
2535
+ fieldOptions?: FilterFieldProp[];
2536
+ /** Per-section filter tree. Overriding the global filter applies on top of it. */
2537
+ filters?: FilterGroup | null;
2538
+ /** Called when the per-section filter tree changes */
2539
+ onFilterChange?: (filters: FilterGroup | null) => void;
2540
+ /** Drop the global dashboard filters for this widget entirely (e.g. snapshot data) */
2541
+ ignoreGlobalFilters?: boolean;
2542
+ /** Additional CSS class name */
2543
+ className?: string;
2544
+ }
2545
+
2546
+ /**
2547
+ * DashboardWidget is a self-contained widget that:
2548
+ * 1. Receives its own data (raw, pre-filtered, or engine-backed)
2549
+ * 2. Renders a Section with a toolbar of actions (export, screenshot, expand)
2550
+ * 3. Passes data to the render prop
2551
+ *
2552
+ * Three modes:
2553
+ * - **Passthrough**: provide only `data` → used as-is (server-ready, zero processing)
2554
+ * - **Legacy**: provide `data` + `columns` → global filters applied via `applyFilter()`
2555
+ */
2556
+ declare const DashboardWidget: {
2557
+ <TData extends object>({ title, subtitle, icon, data, columns, children, enableExport, enableScreenshot, enableExpand, enableFilter, fieldOptions, filters, onFilterChange, ignoreGlobalFilters, dataSourceId, className, }: DashboardWidgetProps<TData>): React__default.JSX.Element;
2558
+ displayName: string;
2559
+ };
2560
+
2561
+ type MDXElementProps = {
2562
+ children?: React.ReactNode;
2563
+ className?: string;
2564
+ };
2565
+ type MDXComponents = {
2566
+ h1: React.FC<MDXElementProps>;
2567
+ h2: React.FC<MDXElementProps>;
2568
+ h3: React.FC<MDXElementProps>;
2569
+ h4: React.FC<MDXElementProps>;
2570
+ p: React.FC<MDXElementProps>;
2571
+ code: React.FC<MDXElementProps>;
2572
+ ol: React.FC<MDXElementProps>;
2573
+ li: React.FC<MDXElementProps>;
2574
+ pre: React.FC<MDXElementProps>;
2575
+ img?: React.FC<React.ImgHTMLAttributes<HTMLImageElement>>;
2576
+ hr?: React.FC<MDXElementProps>;
2577
+ blockquote?: React.FC<MDXElementProps>;
2578
+ ul?: React.FC<MDXElementProps>;
2579
+ Tag: typeof Tag;
2580
+ Banner?: typeof Banner;
2581
+ };
2582
+ type MarkdownProps = {
2583
+ readonly content?: React.ComponentType<{
2584
+ components?: Partial<MDXComponents>;
2585
+ }>;
2586
+ };
2587
+
2588
+ declare const Markdown: React__default.FC<MarkdownProps>;
2589
+
2590
+ interface TimelineProps {
2591
+ /**
2592
+ * Whether the timeline is in loading state
2593
+ */
2594
+ loading?: boolean;
2595
+ /**
2596
+ * Children for compound component usage
2597
+ */
2598
+ children: React.ReactNode;
2599
+ }
2600
+ interface TimelineItemProps {
2601
+ children: React.ReactElement<TimelineItemIconProps> | React.ReactElement<TimelineItemContentProps> | Array<React.ReactElement<TimelineItemIconProps> | React.ReactElement<TimelineItemContentProps>>;
2602
+ className?: string;
2603
+ }
2604
+ interface TimelineItemIconProps {
2605
+ children?: React.ReactNode;
2606
+ visual?: string;
2607
+ }
2608
+ interface TimelineItemContentProps {
2609
+ children: React.ReactElement<TimelineItemTitleProps> | React.ReactElement<TimelineItemDateProps> | React.ReactElement<TimelineItemDescriptionProps> | React.ReactElement<TimelineItemImageProps> | Array<React.ReactElement<TimelineItemTitleProps> | React.ReactElement<TimelineItemDateProps> | React.ReactElement<TimelineItemDescriptionProps> | React.ReactElement<TimelineItemImageProps>>;
2610
+ }
2611
+ interface TimelineItemTitleProps {
2612
+ children: React.ReactNode;
2613
+ href?: string;
2614
+ }
2615
+ interface TimelineItemDateProps {
2616
+ children: React.ReactNode;
2617
+ }
2618
+ interface TimelineItemDescriptionProps {
2619
+ children: React.ReactNode;
2620
+ }
2621
+ interface TimelineItemImageProps {
2622
+ src: string;
2623
+ alt?: string;
2624
+ }
2625
+
2626
+ declare const TimelineItemIcon: React__default.FC<TimelineItemIconProps>;
2627
+ declare const TimelineItemTitle: React__default.FC<TimelineItemTitleProps>;
2628
+ declare const TimelineItemDate: React__default.FC<TimelineItemDateProps>;
2629
+ declare const TimelineItemDescription: React__default.FC<TimelineItemDescriptionProps>;
2630
+ declare const TimelineItemImage: React__default.FC<TimelineItemImageProps>;
2631
+ declare const TimelineItemContent: React__default.FC<TimelineItemContentProps>;
2632
+ declare const Timeline: React__default.FC<TimelineProps> & {
2633
+ Item: React__default.FC<TimelineItemProps> & {
2634
+ Icon: typeof TimelineItemIcon;
2635
+ Content: typeof TimelineItemContent;
2636
+ Title: typeof TimelineItemTitle;
2637
+ Date: typeof TimelineItemDate;
2638
+ Description: typeof TimelineItemDescription;
2639
+ Image: typeof TimelineItemImage;
2640
+ };
2641
+ };
2642
+
2643
+ /**
2644
+ * Responsive layout component.
2645
+ * Detects the current breakpoint and renders the corresponding layout tree.
2646
+ */
2647
+ declare const Layout: React__default.FC<LayoutProps>;
2648
+
2649
+ interface TreeNode<TData> {
2650
+ /** Unique identifier for the node */
2651
+ id: string;
2652
+ /** Display label for the node */
2653
+ label: string;
2654
+ /** Optional data payload */
2655
+ data?: TData;
2656
+ /** Child nodes */
2657
+ children?: TreeNode<TData>[];
2658
+ /** Whether node is collapsed (children hidden) */
2659
+ collapsed?: boolean;
2660
+ }
2661
+ interface LayoutNode<TData> extends TreeNode<TData> {
2662
+ /** X coordinate after layout calculation */
2663
+ x: number;
2664
+ /** Y coordinate after layout calculation */
2665
+ y: number;
2666
+ /** Layout depth in tree */
2667
+ depth: number;
2668
+ /** Parent node reference */
2669
+ parent?: LayoutNode<TData>;
2670
+ /** Laid out children */
2671
+ children?: LayoutNode<TData>[];
2672
+ /** Preliminary x position during algorithm */
2673
+ prelim?: number;
2674
+ /** Modifier value for subtree positioning */
2675
+ mod?: number;
2676
+ /** Thread node for contour tracing */
2677
+ thread?: LayoutNode<TData>;
2678
+ /** Change value for shifting */
2679
+ change?: number;
2680
+ /** Shift value for positioning */
2681
+ shift?: number;
2682
+ /** Ancestor node for conflict resolution */
2683
+ ancestor?: LayoutNode<TData>;
2684
+ }
2685
+ interface MindTreeProps<TData> {
2686
+ /** Root node of the tree */
2687
+ data: TreeNode<TData>;
2688
+ /** Width of the SVG container */
2689
+ width?: number;
2690
+ /** Height of the SVG container */
2691
+ height?: number;
2692
+ /** Horizontal spacing between nodes */
2693
+ nodeSpacing?: number;
2694
+ /** Vertical spacing between levels */
2695
+ levelSpacing?: number;
2696
+ /** Node width for layout calculations */
2697
+ nodeWidth?: number;
2698
+ /** Node height for layout calculations */
2699
+ nodeHeight?: number;
2700
+ /** Enable zoom and pan interactions */
2701
+ interactive?: boolean;
2702
+ /** Custom node renderer */
2703
+ renderNode?: (node: LayoutNode<TData>, isRoot: boolean) => ReactNode;
2704
+ /** Custom link renderer */
2705
+ renderLink?: (source: LayoutNode<TData>, target: LayoutNode<TData>) => ReactNode;
2706
+ /** Callback when node is clicked */
2707
+ onNodeClick?: (node: LayoutNode<TData>) => void;
2708
+ /** Callback when node is collapsed/expanded */
2709
+ onNodeToggle?: (node: LayoutNode<TData>) => void;
2710
+ /** Animation duration in milliseconds */
2711
+ animationDuration?: number;
2712
+ /** Tree orientation */
2713
+ orientation?: "vertical" | "horizontal";
2714
+ /** Layout type */
2715
+ layoutType?: "hierarchical" | "radial";
2716
+ /** Custom CSS classes */
2717
+ className?: string;
2718
+ }
2719
+ interface TreeLayout<TData> {
2720
+ /** All laid out nodes */
2721
+ nodes: LayoutNode<TData>[];
2722
+ /** Root node */
2723
+ root: LayoutNode<TData>;
2724
+ /** Total width needed */
2725
+ width: number;
2726
+ /** Total height needed */
2727
+ height: number;
2728
+ }
2729
+ interface ReingoldTilfordConfig {
2730
+ /** Horizontal spacing between sibling nodes */
2731
+ siblingSpacing: number;
2732
+ /** Vertical spacing between tree levels */
2733
+ levelSpacing: number;
2734
+ /** Width of each node for spacing calculations */
2735
+ nodeWidth: number;
2736
+ /** Height of each node for spacing calculations */
2737
+ nodeHeight: number;
2738
+ /** Layout type */
2739
+ layoutType?: "hierarchical" | "radial";
2740
+ }
2741
+
2742
+ declare function MindTree<TData = unknown>({ data, width, height, nodeSpacing, levelSpacing, nodeWidth, nodeHeight, interactive, renderNode, renderLink, onNodeClick, onNodeToggle, layoutType, className, }: MindTreeProps<TData>): React__default.JSX.Element | null;
2743
+
2744
+ /**
2745
+ * Layout configuration for the workflow
2746
+ */
2747
+ interface WorkflowLayout {
2748
+ /** Direction of the flow: 'TB' (top-bottom) or 'LR' (left-right) */
2749
+ direction?: 'TB' | 'LR';
2750
+ /** Horizontal spacing between nodes (px) */
2751
+ nodeSpacingX?: number;
2752
+ /** Vertical spacing between nodes (px) */
2753
+ nodeSpacingY?: number;
2754
+ /** Node width (px) */
2755
+ nodeWidth?: number;
2756
+ /** Node height (px) */
2757
+ nodeHeight?: number;
2758
+ /** Padding around the entire workflow (px) */
2759
+ padding?: number;
2760
+ }
2761
+ /**
2762
+ * Type of connection between nodes
2763
+ */
2764
+ type WorkflowEdgeType = 'default' | 'conditional' | 'error' | 'timeout' | 'success';
2765
+ /**
2766
+ * Condition function or expression for conditional edges
2767
+ */
2768
+ type WorkflowCondition = string | ((context: WorkflowContext) => boolean);
2769
+ /**
2770
+ * Workflow execution context
2771
+ */
2772
+ interface WorkflowContext {
2773
+ /** Global workflow variables */
2774
+ variables: Record<string, unknown>;
2775
+ /** Output from previous nodes */
2776
+ nodeOutputs: Record<string, unknown>;
2777
+ /** Current execution state */
2778
+ state: 'idle' | 'running' | 'completed' | 'failed';
2779
+ }
2780
+ /**
2781
+ * Represents an edge connecting two nodes
2782
+ */
2783
+ interface WorkflowEdge {
2784
+ /** Unique identifier for the edge */
2785
+ id: string;
2786
+ /** Source node ID */
2787
+ source: string;
2788
+ /** Target node ID */
2789
+ target: string;
2790
+ /** Type of connection (default, conditional, error, etc.) */
2791
+ type?: WorkflowEdgeType;
2792
+ /** Optional condition for conditional edges */
2793
+ condition?: WorkflowCondition;
2794
+ /** Optional label for the edge */
2795
+ label?: string;
2796
+ /** Optional custom styling */
2797
+ className?: string;
2798
+ }
2799
+
2800
+ /**
2801
+ * Type of workflow node
2802
+ */
2803
+ type WorkflowNodeType = 'start' | 'task' | 'decision' | 'end';
2804
+ /**
2805
+ * Type of action that can be performed by a node
2806
+ */
2807
+ type WorkflowActionType = 'api' | 'transform' | 'wait' | 'notification' | 'condition';
2808
+ /**
2809
+ * Base interface for workflow actions
2810
+ */
2811
+ interface WorkflowAction {
2812
+ /** Unique identifier for the action */
2813
+ id: string;
2814
+ /** Type of action */
2815
+ type: WorkflowActionType;
2816
+ /** Display name for the action */
2817
+ name: string;
2818
+ /** Action configuration */
2819
+ config: unknown;
2820
+ }
2821
+ /**
2822
+ * API call action configuration
2823
+ */
2824
+ interface ApiActionConfig {
2825
+ /** HTTP method */
2826
+ method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
2827
+ /** API endpoint URL */
2828
+ url: string;
2829
+ /** Request headers */
2830
+ headers?: Record<string, string>;
2831
+ /** Request body */
2832
+ body?: unknown;
2833
+ /** Timeout in milliseconds */
2834
+ timeout?: number;
2835
+ }
2836
+ /**
2837
+ * API call action
2838
+ */
2839
+ interface ApiAction extends WorkflowAction {
2840
+ type: 'api';
2841
+ config: ApiActionConfig;
2842
+ }
2843
+ /**
2844
+ * Data transformation action configuration
2845
+ */
2846
+ interface TransformActionConfig {
2847
+ /** Transformation function as string or actual function */
2848
+ transform: string | ((input: unknown) => unknown);
2849
+ /** Input variable name from context */
2850
+ inputKey?: string;
2851
+ /** Output variable name to context */
2852
+ outputKey?: string;
2853
+ }
2854
+ /**
2855
+ * Data transformation action
2856
+ */
2857
+ interface TransformAction extends WorkflowAction {
2858
+ type: 'transform';
2859
+ config: TransformActionConfig;
2860
+ }
2861
+ /**
2862
+ * Wait/delay action configuration
2863
+ */
2864
+ interface WaitActionConfig {
2865
+ /** Duration in milliseconds */
2866
+ duration: number;
2867
+ /** Optional message to display during wait */
2868
+ message?: string;
2869
+ }
2870
+ /**
2871
+ * Wait action
2872
+ */
2873
+ interface WaitAction extends WorkflowAction {
2874
+ type: 'wait';
2875
+ config: WaitActionConfig;
2876
+ }
2877
+ /**
2878
+ * Notification action configuration
2879
+ */
2880
+ interface NotificationActionConfig {
2881
+ /** Notification title */
2882
+ title: string;
2883
+ /** Notification message */
2884
+ message: string;
2885
+ /** Notification type */
2886
+ variant?: 'info' | 'success' | 'warning' | 'error';
2887
+ }
2888
+ /**
2889
+ * Notification action
2890
+ */
2891
+ interface NotificationAction extends WorkflowAction {
2892
+ type: 'notification';
2893
+ config: NotificationActionConfig;
2894
+ }
2895
+ /**
2896
+ * Condition evaluation action configuration
2897
+ */
2898
+ interface ConditionActionConfig {
2899
+ /** Condition expression or function */
2900
+ condition: string | ((context: unknown) => boolean);
2901
+ /** Variable to store result */
2902
+ resultKey?: string;
2903
+ }
2904
+ /**
2905
+ * Condition action
2906
+ */
2907
+ interface ConditionAction extends WorkflowAction {
2908
+ type: 'condition';
2909
+ config: ConditionActionConfig;
2910
+ }
2911
+ /**
2912
+ * Represents a node in the workflow DAG
2913
+ */
2914
+ interface WorkflowNode<TData = unknown> {
2915
+ /** Unique identifier for the node */
2916
+ id: string;
2917
+ /** Display label for the node */
2918
+ label: string;
2919
+ /** Optional icon for the node */
2920
+ icon?: string;
2921
+ /** Optional description for the node */
2922
+ description?: string;
2923
+ /** Type of node (start, task, decision, end) */
2924
+ nodeType?: WorkflowNodeType;
2925
+ /** Actions to be executed when the node is activated */
2926
+ actions?: WorkflowAction[];
2927
+ /** Data to be displayed/edited in the panel */
2928
+ data: TData[];
2929
+ /** Column definitions for the table structure */
2930
+ columns: DataStructureColumn<TData>[];
2931
+ /** Optional form columns for editing in the panel */
2932
+ formColumns?: FormColumn<TData>[];
2933
+ /** Parent node IDs (for DAG structure) */
2934
+ parents?: string[];
2935
+ /** Optional custom styling */
2936
+ className?: string;
2937
+ /** Optional metadata */
2938
+ metadata?: Record<string, unknown>;
2939
+ }
2940
+ /**
2941
+ * Positioned node with calculated coordinates
2942
+ */
2943
+ interface PositionedNode<TData = unknown> extends WorkflowNode<TData> {
2944
+ x: number;
2945
+ y: number;
2946
+ level: number;
2947
+ }
2948
+ /**
2949
+ * Connection point on a node edge
2950
+ */
2951
+ interface ConnectionPoint {
2952
+ x: number;
2953
+ y: number;
2954
+ side: 'top' | 'right' | 'bottom' | 'left';
2955
+ }
2956
+ /**
2957
+ * Main Workflow component props
2958
+ */
2959
+ interface WorkflowProps {
2960
+ /** Array of workflow nodes - each node can have different data type */
2961
+ nodes: WorkflowNode<any>[];
2962
+ /** Array of edges connecting nodes */
2963
+ edges: WorkflowEdge[];
2964
+ /** Layout configuration */
2965
+ layout?: WorkflowLayout;
2966
+ /** Show toolbar with zoom and pan controls */
2967
+ showToolbar?: boolean;
2968
+ /** Default zoom level (1 = 100%) */
2969
+ defaultZoom?: number;
2970
+ /** Minimum zoom level */
2971
+ minZoom?: number;
2972
+ /** Maximum zoom level */
2973
+ maxZoom?: number;
2974
+ /** Callback when a node is clicked */
2975
+ onNodeClick?: (node: WorkflowNode<any>) => void;
2976
+ /** Callback when an edge is clicked */
2977
+ onEdgeClick?: (edge: WorkflowEdge) => void;
2978
+ /** Callback when creating a new node from an existing node */
2979
+ onNodeCreate?: (sourceNodeId: string) => void;
2980
+ /** Callback when connecting an existing node to another existing node */
2981
+ onNodeConnect?: (sourceNodeId: string, targetNodeId: string) => void;
2982
+ /** Show panel for node actions */
2983
+ showPanel?: boolean;
2984
+ /** Custom class name */
2985
+ className?: string;
2986
+ /** Additional HTML attributes */
2987
+ [key: string]: unknown;
2988
+ }
2989
+ /**
2990
+ * WorkflowNode component props
2991
+ */
2992
+ interface WorkflowNodeProps<TData = unknown> {
2993
+ /** The node to render */
2994
+ node: PositionedNode<TData>;
2995
+ /** Callback when node is clicked */
2996
+ onClick?: (node: WorkflowNode<TData>) => void;
2997
+ /** Custom class name */
2998
+ className?: string;
2999
+ }
3000
+
3001
+ /**
3002
+ * Workflow component for rendering Directed Acyclic Graphs (DAGs)
3003
+ */
3004
+ declare function Workflow({ nodes, edges, layout: layoutConfig, showToolbar, showPanel, defaultZoom, minZoom, maxZoom, onNodeClick, onEdgeClick, onNodeCreate, onNodeConnect, className, ...props }: WorkflowProps): React__default.JSX.Element;
3005
+
3006
+ /**
3007
+ * Interaction mode for the workflow
3008
+ */
3009
+ type WorkflowMode = 'pointer' | 'drag';
3010
+ /**
3011
+ * Workflow toolbar props
3012
+ */
3013
+ interface WorkflowToolbarProps {
3014
+ /** Current interaction mode */
3015
+ mode: WorkflowMode;
3016
+ /** Callback when mode changes */
3017
+ onModeChange: (mode: WorkflowMode) => void;
3018
+ /** Current zoom level (1 = 100%) */
3019
+ zoom: number;
3020
+ /** Callback when zoom changes */
3021
+ onZoomChange: (zoom: number) => void;
3022
+ /** Minimum zoom level */
3023
+ minZoom?: number;
3024
+ /** Maximum zoom level */
3025
+ maxZoom?: number;
3026
+ /** Custom class name */
3027
+ className?: string;
3028
+ }
3029
+
3030
+ declare function WorkflowToolbar({ mode, onModeChange, zoom, onZoomChange, minZoom, maxZoom, className }: WorkflowToolbarProps): React__default.JSX.Element;
3031
+
3032
+ interface WorkflowPanelProps<TData = unknown> {
3033
+ /** The currently selected node */
3034
+ selectedNode: WorkflowNode<TData> | null;
3035
+ /** All available nodes in the workflow */
3036
+ allNodes: WorkflowNode<TData>[];
3037
+ /** Whether the selected node has output connections */
3038
+ hasOutputs: boolean;
3039
+ /** Callback when creating a new node from the selected node */
3040
+ onCreateNode: (sourceNodeId: string) => void;
3041
+ /** Callback when connecting to an existing node */
3042
+ onConnectNode: (sourceNodeId: string, targetNodeId: string) => void;
3043
+ /** Callback when closing the panel */
3044
+ onClose: () => void;
3045
+ /** Custom class name */
3046
+ className?: string;
3047
+ }
3048
+
3049
+ declare function WorkflowPanel<TData>({ selectedNode, allNodes, hasOutputs, onCreateNode, onConnectNode, onClose, className }: WorkflowPanelProps<TData>): React__default.JSX.Element | null;
3050
+
3051
+ /**
3052
+ * Validation result
3053
+ */
3054
+ interface ValidationResult {
3055
+ /** Whether the workflow is valid */
3056
+ valid: boolean;
3057
+ /** Array of validation errors */
3058
+ errors: ValidationError[];
3059
+ /** Array of validation warnings */
3060
+ warnings: ValidationWarning[];
3061
+ }
3062
+ /**
3063
+ * Validation error
3064
+ */
3065
+ interface ValidationError {
3066
+ /** Error type */
3067
+ type: 'missing-start' | 'missing-end' | 'orphaned-node' | 'invalid-edge' | 'circular-dependency' | 'multiple-starts';
3068
+ /** Error message */
3069
+ message: string;
3070
+ /** Related node or edge IDs */
3071
+ relatedIds: string[];
3072
+ }
3073
+ /**
3074
+ * Validation warning
3075
+ */
3076
+ interface ValidationWarning {
3077
+ /** Warning type */
3078
+ type: 'unreachable-node' | 'dead-end' | 'missing-condition' | 'duplicate-edge' | 'orphaned-node';
3079
+ /** Warning message */
3080
+ message: string;
3081
+ /** Related node or edge IDs */
3082
+ relatedIds: string[];
3083
+ }
3084
+ /**
3085
+ * Validates the structure of a workflow
3086
+ */
3087
+ declare function validateWorkflow<TData = unknown>(nodes: WorkflowNode<TData>[], edges: WorkflowEdge[]): ValidationResult;
3088
+ /**
3089
+ * Gets all reachable nodes from a start node
3090
+ */
3091
+ declare function getReachableNodes(startNodeId: string, edges: WorkflowEdge[]): Set<string>;
3092
+ /**
3093
+ * Gets topological order of nodes (for execution planning)
3094
+ */
3095
+ declare function getTopologicalOrder<TData = unknown>(nodes: WorkflowNode<TData>[], edges: WorkflowEdge[]): string[] | null;
3096
+
3097
+ interface AIChatPanelProps {
3098
+ /** AI provider instance for processing natural-language commands */
3099
+ aiProvider: AIProvider;
3100
+ /** Available tool definitions passed to the AI provider and validator */
3101
+ toolDefinitions: ToolDefinition[];
3102
+ /** Column schema describing the data the AI can act on */
3103
+ schema: ColumnSchema[];
3104
+ /** Full table context (data rows + current state) passed to the AI provider */
3105
+ tableContext?: AITableContext;
3106
+ /** Execute validated tool calls — returns execution results */
3107
+ onExecute: (toolCalls: ToolCall[]) => ExecutionResult[];
3108
+ /** Validate and normalize raw tool calls. If not provided, calls pass through as-is. */
3109
+ onValidate?: (calls: ToolCall[], schema: ColumnSchema[]) => {
3110
+ valid: ToolCall[];
3111
+ errors: string[];
3112
+ };
3113
+ /** Placeholder text for the empty state */
3114
+ emptyStateText?: string;
3115
+ /** When true, tool calls are held for explicit user confirmation before being executed */
3116
+ requiresConfirmation?: boolean;
3117
+ /** Pre-configured action buttons shown in the chat for one-click AI commands */
3118
+ quickActions?: AIQuickAction[];
3119
+ }
3120
+
3121
+ declare function AIChatPanel({ aiProvider, toolDefinitions, schema, tableContext, onExecute, onValidate, emptyStateText, requiresConfirmation, quickActions, }: AIChatPanelProps): React$1.JSX.Element;
3122
+
3123
+ export { AIChatPanel, AnchoredOverlay, AppBar, Banner, BlankSlate, Breadcrumbs, Button, ButtonDropdown, ButtonGroup, Calendar, Card, CardList, Cell, CellType, Chart, Checkbox, CheckboxGroup, Dashboard, DashboardWidget, DataComponentConfigurator, DatePicker, DateRangePicker, FileUpload, FilterBuilder, FilterConditionEditor, FilterField, Form, Gantt, Icon, KPI, Kbd, Label, Layout, Markdown, Menu, MindTree, NumberInput, OTPComponent as OTP, OverlayPanel, ProgressBar, Radio, RadioGroup, Scaffold, Section, SelectionGrid, ShortcutProvider, Sidebar, Stack, Stepper, Switcher, TableGrid, Tag, Timeline, Tree, TreeCard, Workflow, WorkflowPanel, WorkflowToolbar, addNodeAtPath, applyFilter, cardLayoutPresetOptions, cardLayoutWithIcon, countTopLevelFilters, countTopLevelFiltersMap, createDataStructureFromFile, emptyCondition, emptyFilterGroup, fieldOptionsFromColumns, financeKpiLayout, financeKpiLayoutWithIcon, getDefaultOperator, getOperatorsForType, getReachableNodes, getTopologicalOrder, isFilterActive, kpiLayoutPresetOptions, mergeFilters, removeNodeAtPath, resolveCardLayoutPreset, resolveKpiLayoutPreset, stripByFields, updateNodeAtPath, useDashboard, useDynamicVirtualList, useScaffold, useShortcut, validateWorkflow };
3124
+ export type { AIChatPanelProps, AIProvider, AIQuickAction, AIResponse, AITableContext, AnchoredOverlayProps, ApiAction, ApiActionConfig, AppBarActionsProps, AppBarMenuButtonProps, AppBarProps, AppBarTitleProps, BannerProps, BlankSlateAction, BlankSlateActionsProps, BlankSlateDescriptionProps, BlankSlateGraphicProps, BlankSlateHeadingProps, BlankSlatePreset, BlankSlateProps, BlockNode, BooleanOperator, BreadcrumbItem, BreadcrumbsProps, Breakpoint, ButtonDropdownProps, ButtonGroupProps, ButtonProps, CalendarProps, CardLayoutPreset, CardListProps, CardProps, CellProps, ChartProps, ChartType, ChatMessage, CheckboxGroupProps, CheckboxOption, CheckboxProps, ColumnDef, ColumnSchema, ComponentSpecificPropsMap, ComputedPivotData, ConditionAction, ConditionActionConfig, ConditionReadOnly, ConnectionPoint, DashboardProps, DashboardWidgetProps, DashboardWidgetRenderPayload, DataComponentConfiguratorProps, DataComponentId, DataStructureColumn, DataStructureComponent, DataStructureUIColumn, DataStructureUIConfig, DataStructureUIContainer, DataStructureUIRule, DateOperator, DatePickerMode, DatePickerProps, DateRange, DateRangePickerProps, DynamicVirtualItem, ExecutionResult, FilterBuilderProps, FilterColumnType, FilterCondition, FilterConditionEditorProps, FilterFieldProp, FilterFieldProps, FilterGroup, FilterNode, FilterOperator, FilterValue, FlexContainer, FormChangeResponse, FormColumn, FormColumnDelta, FormProps, GanttDependency, GanttProps, GanttRelationType, GanttView, GeoConfig, GridChild, GridContainer, IconProps, KPIProps, KPISpecificProps, KbdProps, KpiLayoutPreset, LabelProps, LayoutNode, LayoutProps, ListItemVariant, MarkdownProps, MenuItem, MenuProps, MenuSubmenuProps, MindTreeProps, NotificationAction, NotificationActionConfig, NumberInputProps, NumberOperator, OTPProps, OperatorOption, Option, OverlayPanelFooterProps, OverlayPanelHeaderProps, OverlayPanelPosition, OverlayPanelProps, OverlayPanelVariant, PivotAggregation, PivotConfig, PivotValueField, PositionedNode, ProgressBarProps, PropFieldDescriptor, PropFieldScope, PropSchemaRegistry, RadioGroupProps, RadioOption, RadioProps, ReingoldTilfordConfig, ResolvedCellUI, ResponsiveLayout, SankeyConfig, ScaffoldContextValue, ScaffoldProps, SectionProps, SelectionGridProps, ShortcutConfig, SidebarProps, SectionProps$1 as SidebarSectionProps, Size, StackProps, State, StepperItem, StepperProps, StepperStepState, StringOperator, SwitcherProps, TableGridProps, TableRow, TableState, TagProps, TimelineProps, ToolCall, ToolDefinition, TransformAction, TransformActionConfig, TreeCardProps, TreeDropPayload, TreeDropPosition, TreeHandle, TreeLayout, TreeNode, TreeProps, TreeRowScope, TreeRowState, UIRuleOperator, UseDynamicVirtualListOptions, UseDynamicVirtualListResult, UseShortcutOptions, UserProps, ValidationError, ValidationResult, ValidationWarning, WaitAction, WaitActionConfig, WorkflowAction, WorkflowActionType, WorkflowCondition, WorkflowContext, WorkflowEdge, WorkflowEdgeType, WorkflowLayout, WorkflowMode, WorkflowNode, WorkflowNodeProps, WorkflowNodeType, WorkflowPanelProps, WorkflowProps, WorkflowToolbarProps };