@restio/ui 0.2.1 → 0.2.2

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