@restio/ui 0.2.1 → 0.2.2-20261120112131

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 +992 -0
  4. package/dist/core.js +36 -0
  5. package/dist/data.cjs +1 -0
  6. package/dist/data.d.ts +1465 -0
  7. package/dist/data.js +24 -0
  8. package/dist/experimental.cjs +2 -0
  9. package/dist/experimental.d.ts +660 -0
  10. package/dist/experimental.js +1365 -0
  11. package/dist/framework.cjs +1 -0
  12. package/dist/framework.d.ts +761 -0
  13. package/dist/framework.js +34 -0
  14. package/dist/index.cjs +1 -0
  15. package/dist/index.d.ts +3282 -151
  16. package/dist/index.js +99 -0
  17. package/dist/src-C-0-H5TG.cjs +159 -0
  18. package/dist/{restio-ui.es.js → src-DzNRRdGD.js} +37175 -36673
  19. package/dist/ui.css +1 -1
  20. package/package.json +65 -43
  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/data.d.ts ADDED
@@ -0,0 +1,1465 @@
1
+ import * as React$1 from 'react';
2
+ import React__default, { UIEventHandler, Ref } from 'react';
3
+
4
+ /** Interface for an option in a component */
5
+ interface Option {
6
+ value: string;
7
+ /** Human-readable label shown in the UI; falls back to `value` when omitted. */
8
+ label?: string;
9
+ id?: string;
10
+ leadingVisual?: string;
11
+ imageSrc?: string;
12
+ imageAlt?: string;
13
+ description?: string;
14
+ disabled?: boolean;
15
+ children?: Option[];
16
+ onClick?: (option: Option) => void;
17
+ }
18
+ /** Sizing values */
19
+ type Size = "extraSmall" | "small" | "default" | "large" | "extraLarge";
20
+ /** Edit mode for interactive cell components */
21
+ type EditMode = 'click' | 'doubleClick' | 'always' | 'never';
22
+ /** State for component */
23
+ type State = "base" | "success" | "warning" | "danger" | "info" | "idle";
24
+ type ChartType = "line" | "bar" | "pie" | "area" | "scatter" | "sankey" | "sparkline" | "geo" | "composed";
25
+ type ComposedSeriesType = "line" | "bar" | "area" | "scatter";
26
+ declare const CellType: {
27
+ readonly SELECT: "SELECT";
28
+ readonly MULTI_SELECT: "MULTI_SELECT";
29
+ readonly BUTTON_GROUP: "BUTTON_GROUP";
30
+ readonly TEXT: "TEXT";
31
+ readonly TEXTAREA: "TEXTAREA";
32
+ readonly PASSWORD: "PASSWORD";
33
+ readonly NUMBER: "NUMBER";
34
+ readonly DATE: "DATE";
35
+ readonly DATE_RANGE: "DATE_RANGE";
36
+ readonly IMAGE: "IMAGE";
37
+ readonly TABLE_GRID: "TABLE_GRID";
38
+ readonly CHART: "CHART";
39
+ readonly CHART_SERIES: "CHART_SERIES";
40
+ readonly PROGRESS: "PROGRESS";
41
+ readonly CHECKBOX_GROUP: "CHECKBOX_GROUP";
42
+ readonly CHECKBOX: "CHECKBOX";
43
+ readonly RADIO_GROUP: "RADIO_GROUP";
44
+ readonly COLORS: "COLORS";
45
+ readonly SPARKLINE: "SPARKLINE";
46
+ readonly BUTTON_DROPDOWN: "BUTTON_DROPDOWN";
47
+ readonly BUTTON: "BUTTON";
48
+ readonly TAG: "TAG";
49
+ };
50
+ type CellType = typeof CellType[keyof typeof CellType];
51
+ /** Responsive layout breakpoint */
52
+ type Breakpoint = 'mobile' | 'tablet' | 'desktop';
53
+
54
+ /** Horizontal alignment: main axis for flex, inside the cell for grid */
55
+ type alignX = 'start' | 'center' | 'end' | 'space-between' | 'space-around';
56
+ /** Vertical alignment: cross axis for flex, inside the cell for grid */
57
+ type alignY = 'start' | 'center' | 'end' | 'stretch';
58
+ /** Leaf node: renders content through `renderBlock(fieldId)` */
59
+ type BlockNode = {
60
+ type: 'block';
61
+ /** Identifier passed to `renderBlock` to resolve this block's content */
62
+ fieldId: string;
63
+ };
64
+ /** A child placed on a grid cell, with its position, span and content alignment */
65
+ type GridChild = {
66
+ node: LayoutNode;
67
+ /** Column to start at (1-based) */
68
+ col: number;
69
+ /** Row to start at (1-based) */
70
+ row: number;
71
+ /** Number of columns to span */
72
+ w: number;
73
+ /** Number of rows to span */
74
+ h: number;
75
+ /** Alignment of the content inside the cell */
76
+ alignX?: alignX;
77
+ /** Alignment of the content inside the cell */
78
+ alignY?: alignY;
79
+ };
80
+ /** Grid container: positions children on a column/row matrix */
81
+ type GridContainer = {
82
+ type: 'grid';
83
+ /** Number of equal-width columns */
84
+ columns: number;
85
+ /** Number of rows; omit to size rows automatically */
86
+ rows?: number;
87
+ /** Space between children, in units of 0.25rem (`8` = 2rem) */
88
+ gap?: number;
89
+ children: GridChild[];
90
+ };
91
+ /** Flex container: lays children out along one axis */
92
+ type FlexContainer = {
93
+ type: 'flex';
94
+ /** Main axis; defaults to `row` */
95
+ direction?: 'row' | 'column';
96
+ /** Space between children, in units of 0.25rem (`8` = 2rem) */
97
+ gap?: number;
98
+ /** Alignment along the main axis */
99
+ alignX?: alignX;
100
+ /** Alignment along the cross axis */
101
+ alignY?: alignY;
102
+ children: LayoutNode[];
103
+ };
104
+ /** Any node in a layout tree */
105
+ type LayoutNode = BlockNode | GridContainer | FlexContainer;
106
+ /** One layout tree per breakpoint; every breakpoint is required, with no fallback between them */
107
+ type ResponsiveLayout = {
108
+ [K in Breakpoint]: LayoutNode;
109
+ };
110
+
111
+ interface BaseTypographyProps {
112
+ /**
113
+ * Prefer children when rendering rich/nested content
114
+ */
115
+ children?: React__default.ReactNode;
116
+ variant: TypographyVariant;
117
+ /**
118
+ * Flag to indicate if the component is disabled.
119
+ * @optional
120
+ */
121
+ disabled?: boolean;
122
+ /**
123
+ * Optional color string i can pass to the text
124
+ * @optional
125
+ */
126
+ color?: string;
127
+ /**
128
+ * Font weight applied to the text.
129
+ * @optional
130
+ */
131
+ fontWeight?: string | number;
132
+ /**
133
+ * Font style applied to the text.
134
+ * @optional
135
+ */
136
+ fontStyle?: string;
137
+ /**
138
+ * Text decoration applied to the text.
139
+ * @optional
140
+ */
141
+ textDecoration?: string;
142
+ }
143
+ 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";
144
+
145
+ interface IconProps {
146
+ /**
147
+ * Icon name for SVG file or URL for image
148
+ */
149
+ src: string;
150
+ /**
151
+ * Manage disabled state
152
+ */
153
+ disabled?: boolean;
154
+ /**
155
+ * Manage disabled state
156
+ */
157
+ state?: State;
158
+ /**
159
+ * Width of the icon
160
+ */
161
+ width?: string;
162
+ /**
163
+ * Height of the icon
164
+ */
165
+ height?: string;
166
+ }
167
+
168
+ interface ProgressBarProps {
169
+ /** Current progress value */
170
+ value: number;
171
+ /** Minimum value of the range. Defaults to 0. */
172
+ min?: number;
173
+ /** Maximum value of the range. Defaults to 100. */
174
+ max?: number;
175
+ /** Visual variant for color theming */
176
+ variant?: State;
177
+ /** Whether the progress bar is in an indeterminate loading state */
178
+ indeterminate?: boolean;
179
+ /** Whether to show the header with percentage (left) and value (right) above the bar */
180
+ showLabel?: boolean;
181
+ /** Custom label text (overrides the percentage on the left) */
182
+ label?: string;
183
+ /** Custom formatter for the value shown on the right */
184
+ formatValue?: (value: number) => string;
185
+ /** Height of the progress bar */
186
+ height?: number;
187
+ /** Whether the component is disabled */
188
+ disabled?: boolean;
189
+ /** Additional CSS class name */
190
+ className?: string;
191
+ }
192
+
193
+ /**
194
+ * Maps each CellType to the component props accepted by `uiVariant`, so TypeScript
195
+ * only allows props the underlying component understands.
196
+ */
197
+ type CellUIVariantMap = {
198
+ [K in CellType]: K extends "IMAGE" ? Partial<Omit<IconProps, "src">> : K extends "TAG" ? Partial<{
199
+ state: State;
200
+ size: Size;
201
+ }> : K extends "PROGRESS" ? Partial<Pick<ProgressBarProps, "variant" | "showLabel" | "height">> : Partial<Omit<BaseTypographyProps, "children" | "variant">>;
202
+ };
203
+ /**
204
+ * Given a tuple of `DataStructureColumn`, produces a union of
205
+ * `{ columnId: string; cellType: CellType }` entries.
206
+ */
207
+ type ColumnTypeMap<TData, TColumns extends readonly DataStructureColumn<TData>[]> = {
208
+ [K in keyof TColumns]: TColumns[K] extends DataStructureColumn<TData> ? {
209
+ columnId: TColumns[K]["id"] extends string ? TColumns[K]["id"] : string;
210
+ cellType: TColumns[K]["cellType"] extends CellType ? TColumns[K]["cellType"] : CellType;
211
+ } : never;
212
+ }[number];
213
+ /**
214
+ * Looks up the `cellType` for a given `columnId` from a columns array.
215
+ * Falls back to `CellType` if not found.
216
+ */
217
+ type LookupCellType<TData, TColumns extends readonly DataStructureColumn<TData>[], TId extends string> = Extract<ColumnTypeMap<TData, TColumns>, {
218
+ columnId: TId;
219
+ }> extends {
220
+ cellType: infer R;
221
+ } ? R extends CellType ? R : CellType : CellType;
222
+ /** Comparison operators for AST-like UI rules */
223
+ type UIRuleOperator = "==" | "!=" | ">" | ">=" | "<" | "<=" | "includes" | "startsWith" | "endsWith" | "isEmpty" | "isNotEmpty";
224
+ /**
225
+ * A declarative styling rule evaluated against a row, compiled once into a fast
226
+ * evaluator. Omitting `field` and `op` makes it a static rule that always matches.
227
+ *
228
+ * @example conditional
229
+ * { field: "price", op: ">", value: 100, uiVariant: { color: "var(--rst-fontColor-success)", fontWeight: "bold" } }
230
+ *
231
+ * @example static (always applies)
232
+ * { uiVariant: { color: "red" } }
233
+ */
234
+ interface DataStructureUIRule<TData, K extends CellType = CellType> {
235
+ /** Which field to evaluate — omit for a static rule that always matches */
236
+ field?: keyof TData;
237
+ /** Comparison operator — omit for a static rule that always matches */
238
+ op?: UIRuleOperator;
239
+ /** Comparison value (not needed for isEmpty / isNotEmpty) */
240
+ value?: unknown;
241
+ /**
242
+ * Component-specific props forwarded to the underlying renderer.
243
+ * TypeScript enforces the correct props based on the column's `cellType`.
244
+ */
245
+ uiVariant?: CellUIVariantMap[K];
246
+ }
247
+ /**
248
+ * Per-column UI configuration.
249
+ * Matches a schema column via `columnId` (same as `DataStructureColumn.id` or `accessorKey`).
250
+ */
251
+ interface DataStructureUIColumn<TData, TColumns extends readonly DataStructureColumn<TData>[] = DataStructureColumn<TData>[], TId extends string = string> {
252
+ /** Matches `DataStructureColumn.id` or `accessorKey` */
253
+ columnId: TId;
254
+ /** Ordered rules — first match wins. Rules without `field`/`op` always match. */
255
+ rules?: DataStructureUIRule<TData, LookupCellType<TData, TColumns, TId>>[];
256
+ }
257
+ /**
258
+ * Top-level UI configuration passed to any data-component.
259
+ * `TColumns` is inferred from the `columns` prop — `cellType` is looked up automatically.
260
+ */
261
+ interface DataStructureUIConfig<TData, TColumns extends readonly DataStructureColumn<TData>[] = DataStructureColumn<TData>[]> {
262
+ columns?: DataStructureUIColumn<TData, TColumns, string>[];
263
+ /** Container-level styling applied to the component root (e.g. Card state). */
264
+ container?: DataStructureUIContainer;
265
+ }
266
+ /** Container-level UI configuration.*/
267
+ interface DataStructureUIContainer {
268
+ /** Component-specific props forwarded to the container root renderer. */
269
+ uiVariant?: Record<string, unknown>;
270
+ }
271
+ /** Pre-resolved cell styling — Cell never resolves UI, only consumes this */
272
+ interface ResolvedCellUI {
273
+ /** Component-specific props resolved from uiVariant rules */
274
+ uiVariant?: Record<string, unknown>;
275
+ }
276
+
277
+ interface DataStructureComponent<TData> {
278
+ /** Array of data to display in the chart */
279
+ data: TData[];
280
+ /** Column definitions - reused from TableGrid */
281
+ columns?: DataStructureColumn<TData>[];
282
+ /** Function to get subrows for a given row */
283
+ getSubRows?: (originalRow: TData, index: number) => TData[] | undefined;
284
+ /** UI configuration for conditional styling and presentation */
285
+ uiConfig?: DataStructureUIConfig<TData>;
286
+ }
287
+ interface DataStructureColumn<TData, TValue = TData[keyof TData]> {
288
+ /** Unique identifier for the column */
289
+ id?: string;
290
+ /** Display header text */
291
+ header?: string;
292
+ /** Simple accessor key for primitive values */
293
+ accessorKey?: keyof TData;
294
+ /** Optional: options for select inputs */
295
+ options?: Option[];
296
+ /** Formula string using column IDs as references */
297
+ formula?: string;
298
+ /** Enable editing for this column */
299
+ enableEditing?: boolean;
300
+ /** Optional: mark field as required */
301
+ required?: boolean;
302
+ /** Disable editing for this column */
303
+ disabled?: boolean;
304
+ /** Function accessor for complex values */
305
+ accessorFn?: (row: TData) => TValue;
306
+ /** Visual representation type for cells with options or specific data types */
307
+ cellType?: CellType;
308
+ /** Helper text shown below the field (e.g. "Opzionale", "Usa +/− per il segno"). */
309
+ helperText?: string;
310
+ /**
311
+ * Column-level config for the component named by `cellType` (e.g. ChartProps for
312
+ * CHART). `data` and `columns` are excluded — they come from the cell value and schema.
313
+ */
314
+ columnConfig?: Record<string, unknown>;
315
+ /**
316
+ * Called when an interactive cell (e.g. BUTTON) fires an action; the first argument
317
+ * is the action id (for BUTTON, `option.value`).
318
+ */
319
+ onCellClick?: (actionId: string, rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
320
+ }
321
+
322
+ /**
323
+ * Maps a layout slot (`block.fieldId`) to the data-column option value (`col.id ?? String(accessorKey)`) that fills it.
324
+ */
325
+ type SlotMap = {
326
+ slotId: string;
327
+ column: string;
328
+ }[];
329
+
330
+ /**
331
+ * Props for the Card component.
332
+ * Renders a single data row as a card with optional layout configuration.
333
+ */
334
+ interface CardSpecificProps<TData> {
335
+ /** Single row of data to display in the card */
336
+ data: TData;
337
+ /** Responsive layout configuration for card fields */
338
+ layout?: ResponsiveLayout;
339
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
340
+ slotMap?: SlotMap;
341
+ /** Additional CSS class for the card container */
342
+ className?: string;
343
+ /** Semantic state for the card container (colors background/border). */
344
+ state?: State;
345
+ /** Called when the card is clicked */
346
+ onClick?: () => void;
347
+ /** Whether the card is in selected state */
348
+ selected?: boolean;
349
+ /** Whether the card is disabled (muted, non-interactive look) */
350
+ disabled?: boolean;
351
+ }
352
+ type CardProps<TData> = Omit<DataStructureComponent<TData>, "data"> & CardSpecificProps<TData>;
353
+
354
+ /**
355
+ * Renders a single data row as a card with optional layout configuration.
356
+ * Fields are displayed using Cell components and optionally arranged via Layout.
357
+ */
358
+ declare function Card<TData>({ data, columns, layout, className, uiConfig, onClick, selected, disabled, slotMap, state }: CardProps<TData>): React__default.JSX.Element;
359
+ declare namespace Card {
360
+ var displayName: string;
361
+ }
362
+
363
+ /**
364
+ * Per-series row of the composed matrix: `column` names the Y-axis data column,
365
+ * `type` the cartesian primitive, `color` an optional override for the palette.
366
+ */
367
+ interface ChartSeriesConfig<TData = Record<string, unknown>> {
368
+ column: keyof TData | string;
369
+ type: ComposedSeriesType;
370
+ color?: string;
371
+ }
372
+ /**
373
+ * Sankey chart config. `stageColumns` lists the ordered flow stages (min 2); empty
374
+ * values are skipped, linking the nearest non-empty stages on either side.
375
+ *
376
+ * @example 2-level (source → target)
377
+ * { stageColumns: ["from", "to"], valueColumn: "amount" }
378
+ *
379
+ * @example multi-level journey
380
+ * { stageColumns: ["channel", "device", "outcome"], valueColumn: "count" }
381
+ */
382
+ interface SankeyConfig<TData> {
383
+ stageColumns: (keyof TData)[];
384
+ valueColumn: keyof TData;
385
+ }
386
+ /**
387
+ * Geo (choropleth) chart config: GeoJSON features matched to `regionColumn`,
388
+ * with `valueColumn` driving the colour scale and `colorRange` as its endpoints.
389
+ */
390
+ interface GeoConfig<TData> {
391
+ geoJson: {
392
+ type: "FeatureCollection";
393
+ features: Array<{
394
+ type: "Feature";
395
+ properties: Record<string, unknown>;
396
+ geometry: {
397
+ type: "MultiPolygon" | "Polygon";
398
+ coordinates: number[][][][] | number[][][];
399
+ };
400
+ }>;
401
+ };
402
+ regionColumn: keyof TData;
403
+ valueColumn: keyof TData;
404
+ colorRange?: [string, string];
405
+ }
406
+ interface ChartSpecificProps<TData> {
407
+ /** Type of chart to render */
408
+ type: ChartType;
409
+ /** Column to use for X-axis (category/labels). Not required for type="sankey". */
410
+ xAxisColumn?: keyof TData;
411
+ /** Column(s) to use for Y-axis (values). Not required for type="sankey". */
412
+ yAxisColumns?: (keyof TData)[];
413
+ /** Chart title */
414
+ title?: string;
415
+ /** Chart subtitle */
416
+ subtitle?: string;
417
+ /** Width of the chart */
418
+ width?: number | `${number}%`;
419
+ /** Height of the chart */
420
+ height?: number | `${number}%`;
421
+ /** Custom colors for chart series */
422
+ colors?: string[];
423
+ /**
424
+ * Per-series matrix for "composed" cartesian charts (line + bar + area + scatter).
425
+ * Single-type cartesian charts derive it from `yAxisColumns`; ignored for pie/sankey/sparkline/geo.
426
+ */
427
+ series?: ChartSeriesConfig<TData>[];
428
+ /** Show/hide chart elements */
429
+ showGrid?: boolean;
430
+ showTooltip?: boolean;
431
+ showLegend?: boolean;
432
+ showXAxis?: boolean;
433
+ showYAxis?: boolean;
434
+ /** Callback when a data point is clicked */
435
+ onDataPointClick?: (data: TData, index: number) => void;
436
+ /** Chart layout orientation */
437
+ layout?: "horizontal" | "vertical";
438
+ /** Configuration required when type="sankey" */
439
+ sankeyConfig?: SankeyConfig<TData>;
440
+ /** Configuration required when type="geo" */
441
+ geoConfig?: GeoConfig<TData>;
442
+ }
443
+ type ChartProps<TData> = DataStructureComponent<TData> & ChartSpecificProps<TData>;
444
+
445
+ 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;
446
+
447
+ interface ToolCall {
448
+ tool: string;
449
+ arguments: Record<string, unknown>;
450
+ }
451
+ interface ToolParameterSchema {
452
+ name: string;
453
+ type: string;
454
+ description: string;
455
+ required?: boolean;
456
+ }
457
+ interface ToolDefinition {
458
+ name: string;
459
+ description: string;
460
+ parameters: ToolParameterSchema[];
461
+ }
462
+ interface ColumnSchema {
463
+ id: string;
464
+ label: string;
465
+ type: "string" | "number" | "date" | "boolean" | "unknown";
466
+ /** Valid option values for select / button-group columns */
467
+ options?: string[];
468
+ }
469
+ /**
470
+ * Serializable snapshot of the current table state passed to the AI provider.
471
+ * All IDs align with ColumnSchema ids and 0-based rowIndex values.
472
+ */
473
+ interface AITableContext {
474
+ /** All data rows. rowIndex (0-based) in tool calls maps to this array. */
475
+ rows: Record<string, unknown>[];
476
+ /** Active sort criteria in priority order */
477
+ sorting?: Array<{
478
+ column: string;
479
+ direction: "asc" | "desc";
480
+ }>;
481
+ /** Column IDs currently used for grouping */
482
+ grouping?: string[];
483
+ /** IDs of rows currently selected */
484
+ selectedRowIds?: string[];
485
+ /** Column IDs that are hidden */
486
+ hiddenColumnIds?: string[];
487
+ /** Current column display order (empty = natural order) */
488
+ columnOrder?: string[];
489
+ /** Current column pinning overrides */
490
+ columnPinning?: Record<string, "left" | "right">;
491
+ }
492
+ interface AIResponse {
493
+ message: string;
494
+ toolCalls: ToolCall[];
495
+ }
496
+ interface AIProvider {
497
+ processMessage(input: string, schema: ColumnSchema[], tools: ToolDefinition[], tableContext?: AITableContext): Promise<AIResponse>;
498
+ }
499
+ interface AIQuickAction {
500
+ /** Button label shown to the user */
501
+ label: string;
502
+ /** The prompt text sent to the AI when this action is triggered */
503
+ prompt: string;
504
+ /** Optional icon name (from the icon system) */
505
+ icon?: string;
506
+ }
507
+
508
+ type GanttView = "year" | "month" | "week" | "day";
509
+ /**
510
+ * Dependency relation types: FS (finish→start), SS (start→start), FF (finish→finish)
511
+ * and SF (start→finish).
512
+ */
513
+ type GanttRelationType = "FS" | "SS" | "FF" | "SF";
514
+ /**
515
+ * A single dependency descriptor. A row's `dependencyColumnId` may resolve to a string,
516
+ * string[], `GanttDependency`, or `GanttDependency[]` (strings default to "FS").
517
+ */
518
+ interface GanttDependency {
519
+ id: string;
520
+ type?: GanttRelationType;
521
+ }
522
+ interface GanttSpecificProps<TData> {
523
+ /** Column id or accessorKey for the start date (must resolve to Date, ISO string, or timestamp) */
524
+ startColumnId: string | keyof TData;
525
+ /** Column id or accessorKey for the end date (must resolve to Date, ISO string, or timestamp) */
526
+ endColumnId: string | keyof TData;
527
+ /** Column id or accessorKey for the event label */
528
+ eventColumnId: string | keyof TData;
529
+ /** Column id or accessorKey that uniquely identifies each row */
530
+ idColumnId?: string | keyof TData;
531
+ /**
532
+ * Column id or accessorKey for the dependency field.
533
+ * Resolves to string | string[] | GanttDependency | GanttDependency[]
534
+ */
535
+ dependencyColumnId?: string | keyof TData;
536
+ /**
537
+ * IDs of columns to display in the left data-grid panel.
538
+ * If not provided, all columns (excluding dependencyColumnId) are shown.
539
+ */
540
+ gridColumnIds?: string[];
541
+ /** Time granularity for the timeline header */
542
+ view?: GanttView;
543
+ /** Reference date used to determine the visible range. Defaults to `new Date()` */
544
+ initialDate?: Date;
545
+ /** Optional function to override the background color of an event bar */
546
+ eventColorFn?: (row: TData) => string | undefined;
547
+ /** Enable sorting on the left grid panel columns */
548
+ enableSorting?: boolean;
549
+ /** Enable the AI assistant sidebar panel */
550
+ enableAIAssistant?: boolean;
551
+ /** AI provider instance used by the AI assistant panel */
552
+ aiProvider?: AIProvider;
553
+ /** Pre-configured quick-action buttons shown in the AI chat */
554
+ aiQuickActions?: AIQuickAction[];
555
+ /** When true, AI tool calls require explicit user confirmation before being applied */
556
+ requiresConfirmation?: boolean;
557
+ /**
558
+ * Called when the user manually drags or resizes an event bar.
559
+ * Receives the original row data and the new start/end Dates.
560
+ */
561
+ onEventChange?: (row: TData, newStart: Date, newEnd: Date) => void;
562
+ }
563
+ type GanttProps<TData> = DataStructureComponent<TData> & GanttSpecificProps<TData>;
564
+
565
+ declare function Gantt<TData>(props: GanttProps<TData>): React$1.JSX.Element;
566
+
567
+ type AggregationFn = "sum" | "count" | "avg" | "min" | "max";
568
+
569
+ /** Backward-compatible alias — prefer AggregationFn for new code. */
570
+ type PivotAggregation = AggregationFn;
571
+ interface PivotValueField {
572
+ /** The field ID (column accessorKey or id) to aggregate */
573
+ field: string;
574
+ /** Aggregation function to apply */
575
+ aggregation: PivotAggregation;
576
+ /** Optional display label */
577
+ label?: string;
578
+ }
579
+ /**
580
+ * Pivot config: `rowFields` form the row groups, `columnFields` become dynamic columns,
581
+ * and `valueFields` are aggregated at each intersection.
582
+ */
583
+ interface PivotConfig {
584
+ rowFields: string[];
585
+ columnFields: string[];
586
+ valueFields: PivotValueField[];
587
+ }
588
+ /** A resolved column in the computed pivot result */
589
+ interface PivotColumnDef {
590
+ id: string;
591
+ /** Primary label: row-field name OR column-field value (e.g. "New York") */
592
+ label: string;
593
+ /** Secondary label shown in the second header row: aggregation + field (e.g. "Salary (sum)"). Only present for value columns when columnFields are in use. */
594
+ subLabel?: string;
595
+ /** true when this column represents a row grouping field (left side) */
596
+ isRowField: boolean;
597
+ /** The value from the pivot column field (e.g. "New York") */
598
+ columnFieldValue?: string;
599
+ /** The column field ID (e.g. "location") */
600
+ columnFieldId?: string;
601
+ /** The value field aggregation spec */
602
+ valueField?: PivotValueField;
603
+ }
604
+ /** A single row in the computed pivot result */
605
+ interface PivotRow {
606
+ id: string;
607
+ /** Values for each row field */
608
+ rowValues: Record<string, string>;
609
+ /** Aggregated cell values keyed by PivotColumnDef.id */
610
+ cells: Record<string, number | string | null>;
611
+ }
612
+ /** Full computed pivot output */
613
+ interface ComputedPivotData {
614
+ columns: PivotColumnDef[];
615
+ rows: PivotRow[];
616
+ }
617
+
618
+ interface DateRange {
619
+ from: Date | undefined;
620
+ to: Date | undefined;
621
+ }
622
+
623
+ type FilterColumnType = "string" | "number" | "date" | "boolean";
624
+ type StringOperator = "equals" | "not_equals" | "contains" | "starts_with" | "ends_with" | "in" | "not_in" | "is_null" | "is_not_null";
625
+ type NumberOperator = "equals" | "not_equals" | "greater" | "greater_equals" | "less" | "less_equals" | "in" | "not_in" | "is_null" | "is_not_null";
626
+ type DateOperator = "equals" | "not_equals" | "after" | "after_or_on" | "before" | "before_or_on" | "between" | "is_null" | "is_not_null";
627
+ type BooleanOperator = "is_true" | "is_false" | "is_null" | "is_not_null";
628
+ type FilterOperator = StringOperator | NumberOperator | DateOperator | BooleanOperator;
629
+ type FilterValue = string | string[] | number | number[] | Date | boolean | DateRange | null;
630
+ interface FilterFieldProp {
631
+ /** Matches ColumnDef id or accessorKey (stringified) */
632
+ id: string;
633
+ /** Human-readable label (from ColumnDef.header) */
634
+ label: string;
635
+ /** Column data type used to pick operators and value input */
636
+ type: FilterColumnType;
637
+ /** Available values for `in` / `not_in` operators (from CellType.SELECT / MULTI_SELECT columns) */
638
+ availableOptions?: Option[];
639
+ }
640
+ /**
641
+ * Per-field read-only flags for a condition. Each flag locks a single
642
+ */
643
+ interface ConditionReadOnly {
644
+ /** Locks the field selector (first dropdown). */
645
+ field?: boolean;
646
+ /** Locks the operator selector (second dropdown). */
647
+ operator?: boolean;
648
+ /** Locks the value input. */
649
+ value?: boolean;
650
+ /** Hides the delete button. */
651
+ delete?: boolean;
652
+ }
653
+ interface FilterCondition {
654
+ type: "condition";
655
+ field: FilterFieldProp;
656
+ operator: FilterOperator;
657
+ value: FilterValue;
658
+ /** Optional per-field read-only flags (stored on the condition, not global). */
659
+ readOnly?: ConditionReadOnly;
660
+ }
661
+ interface FilterGroup {
662
+ type: "group";
663
+ logic: "and" | "or";
664
+ filters: FilterNode[];
665
+ }
666
+ /** Recursive union — use `node.type` to discriminate */
667
+ type FilterNode = FilterCondition | FilterGroup;
668
+
669
+ /**
670
+ * Row model switch and feature-by-model registry: single source of truth binding each grid
671
+ * feature to the models that support it (client, server, server-only, dual, blocked-on-server).
672
+ */
673
+ /** All row models the grid supports. */
674
+ declare const TableRowModel: {
675
+ readonly client: "client";
676
+ readonly server: "server";
677
+ };
678
+ type TableRowModel = (typeof TableRowModel)[keyof typeof TableRowModel];
679
+ /** Where a dual feature executes. */
680
+ declare const TableSortingMode: {
681
+ readonly client: "client";
682
+ readonly server: "server";
683
+ };
684
+ type TableSortingMode = (typeof TableSortingMode)[keyof typeof TableSortingMode];
685
+ /** How one feature relates to the row models. */
686
+ type FeatureSupport = "client" | "server" | "server-only" | "dual" | "blocked-on-server";
687
+ /** Feature registry — keep in sync with the matrix in `table-grid-row-models.md`. */
688
+ declare const TABLE_MODEL_FEATURES: {
689
+ /** Client: applyFilter on full data. Server: app filters inside getRows. */
690
+ readonly filtering: "server-only";
691
+ /** Client: groupData on full data. Server: app returns group rows. */
692
+ readonly grouping: "server-only";
693
+ /** Server model: server by default, sortingMode="client" sorts loaded rows. */
694
+ readonly sorting: "dual";
695
+ /** Pivot needs the whole dataset in memory — blocked on server. */
696
+ readonly pivot: "blocked-on-server";
697
+ /** Local in both; over loaded rows only on server. */
698
+ readonly cellEditing: "dual";
699
+ /** Local in both; rendered rows only on server. */
700
+ readonly rowSelection: "dual";
701
+ /** Tree data is unsupported with rowModel="server" (v1). */
702
+ readonly treeData: "blocked-on-server";
703
+ /** Model-agnostic; on server the scrollbar total is totalRowCount. */
704
+ readonly virtualization: "dual";
705
+ /** Pagination runs on top of the non-virtualized render in both models:
706
+ * client = local slice, server = per-page fetch. */
707
+ readonly pagination: "dual";
708
+ };
709
+ type TableModelFeature = keyof typeof TABLE_MODEL_FEATURES;
710
+
711
+ /** Request the grid sends to the app datasource (server model only). */
712
+ interface ServerRowRequest {
713
+ /** Inclusive/exclusive window of flat rows the grid currently needs. */
714
+ range: {
715
+ start: number;
716
+ end: number;
717
+ };
718
+ /** Active sort: [{ id, desc }] — same shape as client SortingState. */
719
+ sorting: SortingState;
720
+ /** Active filter tree, or null. Same FilterGroup consumed by the filter panel. */
721
+ filtering: FilterGroup | null;
722
+ /** Ordered group-by column ids. */
723
+ grouping: string[];
724
+ /** Ids (derived paths) of expanded group rows — see ServerGroupRow.id. */
725
+ expandedGroups: string[];
726
+ }
727
+ /** A group row returned by the server (server model only). */
728
+ interface ServerGroupRow {
729
+ kind: "group";
730
+ /** Grouped values from root to this node, e.g. ["IT", "Milan"]. */
731
+ path: string[];
732
+ /** Depth = path.length - 1 (root groups = 0). */
733
+ depth: number;
734
+ /** Total leaf rows in the group — shown in the group banner/count. */
735
+ childCount: number;
736
+ }
737
+ /** Response the app datasource returns. */
738
+ interface ServerRowResponse<TData> {
739
+ /**
740
+ * Flat sequence of rows for the requested window, in final display order.
741
+ * Data rows are raw TData; group rows are wrapped in {@link ServerGroupRow}.
742
+ */
743
+ rows: Array<TData | ServerGroupRow>;
744
+ /** Total rows matching the query (data + group rows), for the scrollbar size. */
745
+ totalRowCount: number;
746
+ }
747
+ /**
748
+ * Datasource contract for `rowModel: "server"`. The app implements `getRows`
749
+ * and owns filtering, sorting and grouping server-side.
750
+ */
751
+ interface ServerDatasource<TData> {
752
+ getRows(request: ServerRowRequest): Promise<ServerRowResponse<TData>>;
753
+ }
754
+
755
+ type TableGridDisplayMode = "tree" | "table" | "table-tree";
756
+ /** Which grid lines (cell borders) are visible. */
757
+ type TableGridShowGrid = ShowGridLines;
758
+ /** All valid showGrid values. */
759
+ declare const ShowGridLines: {
760
+ readonly None: "none";
761
+ readonly Vertical: "vertical";
762
+ readonly Horizontal: "horizontal";
763
+ readonly Both: "both";
764
+ };
765
+ type ShowGridLines = (typeof ShowGridLines)[keyof typeof ShowGridLines];
766
+ interface TableGridSpecificProps<TData> {
767
+ /** Enable sorting functionality */
768
+ enableSorting?: boolean;
769
+ /** Enable row selection */
770
+ enableSelection?: boolean;
771
+ /** Enable editing functionality */
772
+ enableEditing?: boolean;
773
+ /** Callback when a row is clicked */
774
+ onRowClick?: (row: TData, index: number) => void;
775
+ /** Callback when data changes */
776
+ onDataChange?: (data: TData[]) => void;
777
+ /** Callback fired when the selection changes */
778
+ onSelectionChange?: (selectedIds: string[], selectedData: TData[]) => void;
779
+ /** Enable grouping functionality */
780
+ enableGrouping?: boolean;
781
+ /** Callback when grouping changes */
782
+ onGroupingChange?: (grouping: string[]) => void;
783
+ /** Custom className for styling */
784
+ className?: string;
785
+ /** Enable virtualization */
786
+ enableVirtualization?: boolean;
787
+ /** Height of each row in pixels (required for virtualization) */
788
+ virtualizedRowHeight?: number;
789
+ /**
790
+ * Scrollable container height in pixels. Required with virtualization; otherwise the
791
+ * container grows with its content (fill mode in a flex parent).
792
+ */
793
+ containerHeight?: number;
794
+ /** When true, cells keep a fixed single-line height; overflowing content is clipped. */
795
+ oneLine?: boolean;
796
+ /** Which grid lines (cell borders) are visible. Defaults to "both". */
797
+ showGrid?: TableGridShowGrid;
798
+ /** Enable sticky header */
799
+ stickyHeader?: boolean;
800
+ /** Enable sticky footer */
801
+ stickyFooter?: boolean;
802
+ /** Enable pivot table mode — shows the pivot icon in the right toolbar */
803
+ enablePivot?: boolean;
804
+ /** Initial or controlled pivot configuration */
805
+ pivotConfig?: PivotConfig;
806
+ /** Callback when the pivot configuration changes */
807
+ onPivotConfigChange?: (config: PivotConfig) => void;
808
+ /** Enable the formula builder — shows the formula icon in the right toolbar */
809
+ enableFormulaBuilder?: boolean;
810
+ /**
811
+ * How column widths are calculated: "auto" shares the available width (ignoring `size`),
812
+ * "fixed" uses each column's `size` and scrolls horizontally when the total overflows.
813
+ */
814
+ columnSizing?: "auto" | "fixed";
815
+ /** Show loading skeleton state while data is being fetched */
816
+ loading?: boolean;
817
+ /** Allow columns to be reordered via drag & drop on the header */
818
+ enableColumnReorder?: boolean;
819
+ /** Show a column visibility toggle panel in the right sidebar */
820
+ enableColumnVisibility?: boolean;
821
+ /** Show a filter panel in the right sidebar */
822
+ enableFiltering?: boolean;
823
+ /** Enable the AI assistant chat panel in the right sidebar */
824
+ enableAIAssistant?: boolean;
825
+ /** AI provider instance for processing natural-language commands */
826
+ aiProvider?: AIProvider;
827
+ /** When true, AI-suggested actions are held for explicit user confirmation before being applied */
828
+ requiresConfirmation?: boolean;
829
+ /** Pre-configured action buttons shown in the AI chat panel for one-click commands */
830
+ aiQuickActions?: AIQuickAction[];
831
+ /**
832
+ * Called when a new formula column is created (builder or AI). Persist the definition
833
+ * on your server so it can be re-supplied via `columns` on the next load.
834
+ */
835
+ onFormulaColumnAdd?: (col: ColumnDef<TData>) => void;
836
+ /**
837
+ * Forwarded to the inner scroll container (`rst-table-container`), so an external
838
+ * component can react to scroll events. Works in both row models.
839
+ */
840
+ onScroll?: UIEventHandler<HTMLDivElement>;
841
+ /**
842
+ * Ref to the inner scroll container (`rst-table-container`), so an external component
843
+ * can read or set `scrollTop`. Works in both row models.
844
+ */
845
+ scrollContainerRef?: Ref<HTMLDivElement>;
846
+ }
847
+ /** Props that only apply when `rowModel` is "server". See table-model-registry. */
848
+ interface TableGridServerModelProps<TData> {
849
+ /** Datasource — required when rowModel="server", ignored otherwise. */
850
+ datasource?: ServerDatasource<TData>;
851
+ /** Server model only: where sorting executes (default "server"). */
852
+ sortingMode?: TableSortingMode;
853
+ }
854
+ /** Pagination config — only honored when virtualization is disabled. */
855
+ interface TableGridPagination {
856
+ /** Rows per page. */
857
+ readonly pageSize: number;
858
+ }
859
+ type TableGridProps<TData> = DataStructureComponent<TData> & TableGridSpecificProps<TData> & {
860
+ /** Global row-model switch — decides where each data-pipeline feature runs. Default "client". See `TableRowModel`. */
861
+ rowModel?: TableRowModel;
862
+ /**
863
+ * Pagination — orthogonal to the row model: client pages slice in-memory data, server
864
+ * pages fetch a window. Honored only when virtualization is off. Defaults to off.
865
+ */
866
+ pagination?: TableGridPagination;
867
+ } & TableGridServerModelProps<TData>;
868
+ interface ColumnDef<TData, TValue = TData[keyof TData]> extends DataStructureColumn<TData, TValue> {
869
+ /** Column width */
870
+ size?: number;
871
+ minSize?: number;
872
+ maxSize?: number;
873
+ /** Enable sorting for this column */
874
+ enableSorting?: boolean;
875
+ /** Sort function for custom sorting */
876
+ sortingFn?: (a: TData, b: TData, columnId: string) => number;
877
+ /** Pin column to left or right */
878
+ pinned?: "left" | "right" | false;
879
+ /** Footer content. Pass a string for a static label, a function for dynamic JSX,
880
+ * or { aggregation } to auto-compute a total from the column data. */
881
+ footer?: string | {
882
+ aggregation: AggregationFn;
883
+ label?: string;
884
+ } | ((props: {
885
+ column: ColumnDef<TData>;
886
+ }) => React.ReactNode);
887
+ }
888
+ interface TableRow<TData> {
889
+ /** Row unique ID */
890
+ id: string;
891
+ /** Original data object for the row */
892
+ data: TData;
893
+ /** Index in the original data array */
894
+ index: number;
895
+ /** Parent row ID if this is a subrow */
896
+ parentId?: string;
897
+ /** Depth level in the hierarchy (0 = top level) */
898
+ depth: number;
899
+ /** Whether this row is expanded (has visible subrows) */
900
+ isExpanded: boolean;
901
+ /** Subrows if any */
902
+ subRows?: TableRow<TData>[];
903
+ /** Whether this is a group row */
904
+ isGroup?: boolean;
905
+ /** The value being grouped on */
906
+ groupingValue?: string;
907
+ /** The column ID being grouped on */
908
+ groupingColumnId?: string;
909
+ /** All original data items in this group (set only when isGroup=true) */
910
+ groupItems?: TData[];
911
+ }
912
+ interface TableState<TData> {
913
+ /** Current data in the table */
914
+ dataState: TData[];
915
+ /** Current sorting state */
916
+ sorting: SortingState;
917
+ /** Current grouping state (column IDs) */
918
+ grouping: string[];
919
+ /** Expanded rows */
920
+ expandedRows: Set<string>;
921
+ /** Display mode based on data structure */
922
+ displayMode: TableGridDisplayMode;
923
+ /** Set of selected row IDs */
924
+ selectedRows: Set<string>;
925
+ /** Ordered list of column IDs (empty = natural order) */
926
+ columnOrder: string[];
927
+ /** Set of hidden column IDs */
928
+ hiddenColumns: Set<string>;
929
+ /** Dynamic pinning overrides — takes precedence over ColumnDef.pinned */
930
+ columnPinning: Record<string, "left" | "right" | false>;
931
+ /** Active filter tree — null means no filter applied */
932
+ filterGroup: FilterGroup | null;
933
+ /** Whether filtering is enabled */
934
+ enableFiltering?: boolean;
935
+ }
936
+ type SortingState = {
937
+ id: string;
938
+ desc: boolean;
939
+ }[];
940
+
941
+ 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;
942
+
943
+ /**
944
+ * Read a CSV/TSV/custom-delimited file and convert it into
945
+ * { data, columns } matching DataStructureComponent<TData> props.
946
+ */
947
+ declare function createDataStructureFromFile<TData extends Record<string, unknown> = Record<string, unknown>>(file: File): Promise<{
948
+ data: TData[];
949
+ columns: ColumnDef<TData, TData[keyof TData]>[];
950
+ }>;
951
+
952
+ interface CellProps<TData, TValue> {
953
+ /** The actual value to display/edit */
954
+ value: TValue;
955
+ /** Column definition for configuration */
956
+ column: DataStructureColumn<TData, TValue>;
957
+ /** Original row data */
958
+ rowData: TData;
959
+ /** Row index */
960
+ rowIndex: number;
961
+ /** Edit mode behavior */
962
+ editMode?: EditMode;
963
+ /** Whether this cell is editable (overrides column config) */
964
+ isEditable?: boolean;
965
+ /** Error message to display */
966
+ error?: string;
967
+ /** Whether the cell is disabled */
968
+ disabled?: boolean;
969
+ /** Whether the cell is in a loading state — renders a skeleton placeholder */
970
+ loading?: boolean;
971
+ /** Whether to show the label above the cell (default: true) */
972
+ showLabel?: boolean;
973
+ /** Whether to show the helper/error text below the cell (default: true) */
974
+ showHelperText?: boolean;
975
+ /** Helper text shown below the cell when no error is present */
976
+ helperText?: string;
977
+ /** Alignment of the label (default: "top") */
978
+ labelAlign?: "top" | "left";
979
+ /** Pre-resolved UI styling — Cell never resolves UI, only consumes it */
980
+ ui?: ResolvedCellUI;
981
+ /** Callback when value changes */
982
+ onValueChange?: (newValue: TValue, rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
983
+ /** Callback when editing starts */
984
+ onEditStart?: (rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
985
+ /** Callback when editing ends */
986
+ onEditEnd?: (rowData: TData, column: DataStructureColumn<TData, TValue>) => void;
987
+ }
988
+
989
+ 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;
990
+
991
+ interface CalendarSpecificProps<TData> {
992
+ /** Column id or accessorKey for the date column (must resolve to a Date or ISO string) */
993
+ dateColumnId: string | keyof TData;
994
+ /** Column id or accessorKey for the event/title column */
995
+ eventColumnId: string | keyof TData;
996
+ /** Optional starting month (Date) to render */
997
+ initialMonth?: Date;
998
+ /** Calendar View */
999
+ view?: CalendarView;
1000
+ /**
1001
+ * Column id or accessorKey of a field that already contains the summary
1002
+ * value to display for that day (or month in year view).
1003
+ */
1004
+ summaryColumnId?: string | keyof TData;
1005
+ /**
1006
+ * Maximum number of events to show per day cell before collapsing the rest
1007
+ * into a "+ N more" button. Defaults to unlimited.
1008
+ */
1009
+ maxEvents?: number;
1010
+ /**
1011
+ * Optional function to override the background color of a specific event chip.
1012
+ * Receives the data row and returns a CSS color string, or undefined to use the default.
1013
+ * @example eventColorFn={(row) => row.type === 'holiday' ? '#f59e0b' : undefined}
1014
+ */
1015
+ eventColorFn?: (row: TData) => string | undefined;
1016
+ }
1017
+ type CalendarProps<TData> = DataStructureComponent<TData> & CalendarSpecificProps<TData>;
1018
+ type CalendarView = "month" | "week" | "day" | "year";
1019
+
1020
+ declare function Calendar<TData>({ data, columns, dateColumnId, eventColumnId, initialMonth, view, summaryColumnId, maxEvents, eventColorFn, uiConfig, }: CalendarProps<TData>): React__default.JSX.Element;
1021
+
1022
+ type ButtonVariant = "base" | "primary" | "danger" | "invisible" | "link";
1023
+ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
1024
+ alignContent?: 'start' | 'center';
1025
+ leadingVisual?: string;
1026
+ trailingVisual?: string;
1027
+ loading?: boolean;
1028
+ size?: Size;
1029
+ variant?: ButtonVariant;
1030
+ disabled?: boolean;
1031
+ /** State where interaction and animation are disabled */
1032
+ readOnly?: boolean;
1033
+ count?: number;
1034
+ }
1035
+
1036
+ /**
1037
+ * Delta operation for a single column when the form state changes.
1038
+ * The server returns only the columns that need to be added, updated, or removed.
1039
+ */
1040
+ interface FormColumnDelta<TData> {
1041
+ /** What to do with this column */
1042
+ action: "add" | "update" | "remove";
1043
+ /** The column definition */
1044
+ column: FormColumn<TData>;
1045
+ }
1046
+ /**
1047
+ * Server response to a field change. Only the changed pieces are returned; the form
1048
+ * merges `data` (partial rows), `columns` (add/update/remove deltas) and optional `layout`.
1049
+ */
1050
+ interface FormChangeResponse<TData> {
1051
+ /** Partial data delta — merged with current formData */
1052
+ data?: Partial<TData>;
1053
+ /** Column delta operations — applied to current columns */
1054
+ columns?: FormColumnDelta<TData>[];
1055
+ /** Optional new layout. If omitted, layout is recalculated from updated columns. */
1056
+ layout?: ResponsiveLayout;
1057
+ }
1058
+ interface FormSpecificProps<TData> {
1059
+ /** Override columns with form-specific options */
1060
+ columns?: FormColumn<TData>[];
1061
+ /** label alignment */
1062
+ labelAlign?: "left" | "top";
1063
+ /** Optional layout configuration */
1064
+ layout?: ResponsiveLayout;
1065
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
1066
+ slotMap?: SlotMap;
1067
+ /** Callback when form is submitted */
1068
+ onSubmit?: (data: TData) => void;
1069
+ /** Callback when cancel is clicked */
1070
+ onCancel?: () => void;
1071
+ /** Custom action buttons rendered in the form footer.*/
1072
+ actions?: ButtonProps[];
1073
+ /**
1074
+ * Server-driven callback invoked on every field change: it receives the form state
1075
+ * and the changed field, and returns the partial delta to merge. Unresolved fields show skeletons.
1076
+ *
1077
+ * @returns A partial delta with data, column operations, and optional layout
1078
+ */
1079
+ onFormChange?: (formData: TData, changedField: keyof TData, newValue: TData[keyof TData]) => Promise<FormChangeResponse<TData>>;
1080
+ }
1081
+ type FormProps<TData> = DataStructureComponent<TData> & FormSpecificProps<TData>;
1082
+ interface FormColumn<TData> extends DataStructureColumn<TData> {
1083
+ /** Optional: custom message when required validation fails */
1084
+ requiredMessage?: string;
1085
+ /** Optional: custom validation function */
1086
+ validate?: (value: TData[keyof TData], rowData: TData) => string | undefined;
1087
+ }
1088
+
1089
+ declare function Form<TData>({ data, columns, layout, slotMap, onSubmit, onCancel, onFormChange, uiConfig, labelAlign, actions }: FormProps<TData>): React__default.JSX.Element;
1090
+
1091
+ /**
1092
+ * Props for the CardList component.
1093
+ * Renders an array of data as a list of cards.
1094
+ */
1095
+ interface CardListSpecificProps<TData> {
1096
+ /** Responsive layout configuration for each card's fields */
1097
+ layout?: ResponsiveLayout;
1098
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`)*/
1099
+ slotMap?: SlotMap;
1100
+ /** Additional CSS class for the container */
1101
+ containerClassName?: string;
1102
+ /** Called when a card is clicked, with the item data */
1103
+ onCardClick?: (item: TData) => void;
1104
+ /** Currently selected item (single selection) */
1105
+ selected?: TData;
1106
+ /** Array of selected items (multi-selection) */
1107
+ multiSelection?: TData[];
1108
+ /** Function to determine if an item is selected (used when TData is not comparable by reference) */
1109
+ isSelected?: (item: TData, selectedItem: TData) => boolean;
1110
+ }
1111
+ type CardListProps<TData> = DataStructureComponent<TData> & CardListSpecificProps<TData>;
1112
+
1113
+ /**
1114
+ * Renders an array of data as a list of cards.
1115
+ * Each card is configured with the same columns and layout.
1116
+ */
1117
+ declare function CardList<TData>({ data, columns, layout, slotMap, containerClassName, uiConfig, onCardClick, selected, multiSelection, isSelected, }: CardListProps<TData>): React$1.JSX.Element;
1118
+ declare namespace CardList {
1119
+ var displayName: string;
1120
+ }
1121
+
1122
+ /** Position where a dragged node can be dropped, relative to a drop target. */
1123
+ type TreeDropPosition = "inside" | "before" | "after";
1124
+ /** Payload describing the drop of a dragged node onto a target node. */
1125
+ interface TreeDropPayload {
1126
+ /** Id of the dragged node. */
1127
+ sourceId: string;
1128
+ /** Id of the node used as drop target. */
1129
+ targetId: string;
1130
+ /** Where the node is dropped relative to the target. */
1131
+ position: TreeDropPosition;
1132
+ }
1133
+ /** Internal (non-data) state of a row, fed to the row renderer. */
1134
+ interface TreeRowState {
1135
+ depth: number;
1136
+ isExpanded: boolean;
1137
+ isSelected: boolean;
1138
+ isOver: boolean;
1139
+ dropPosition: TreeDropPosition | undefined;
1140
+ isDragging: boolean;
1141
+ isDisabled: boolean;
1142
+ }
1143
+ /** Contract passed from the Tree to each row (accessors, callbacks, state fns). */
1144
+ interface TreeRowScope<TData> {
1145
+ getNodeId: (node: TData) => string;
1146
+ getNodeLabel: (node: TData) => string;
1147
+ getChildren: (node: TData) => TData[] | undefined;
1148
+ isExpanded: (id: string) => boolean;
1149
+ isSelected: (id: string) => boolean;
1150
+ isDragging: (id: string) => boolean;
1151
+ /** Id of the unique direct parent of the hovered node, if any. */
1152
+ parentOfHoveredId?: string;
1153
+ /** Set the id of the row currently hovered (undefined to clear). */
1154
+ setHoveredId: (id: string | undefined) => void;
1155
+ hoverTargetId: string | undefined;
1156
+ hoverPosition: TreeDropPosition | undefined;
1157
+ /** True while the current hover target is not a valid drop target (rejected). */
1158
+ dropRejected: boolean;
1159
+ onToggle: (id: string) => void;
1160
+ onSelect: (id: string) => void;
1161
+ onDragStart: (e: React__default.DragEvent, id: string) => void;
1162
+ onDragOver: (e: React__default.DragEvent, id: string) => void;
1163
+ onDragLeave: () => void;
1164
+ onDrop: (e: React__default.DragEvent, id: string) => void;
1165
+ onAction?: (actionId: string, node: TData, id: string) => void;
1166
+ renderNode?: (node: TData, state: TreeRowState) => React__default.ReactNode;
1167
+ getNodeIcon?: (node: TData) => string | undefined;
1168
+ getNodeDisabled?: (node: TData) => boolean;
1169
+ actions?: Option[];
1170
+ draggable?: boolean;
1171
+ enableDragAndDrop?: boolean;
1172
+ enableConnection?: boolean;
1173
+ depth: number;
1174
+ }
1175
+ /** Imperative handle exposed via `ref` for programmatic expansion control. */
1176
+ interface TreeHandle {
1177
+ expandAll: () => void;
1178
+ collapseAll: () => void;
1179
+ expandToLevel: (level: number) => void;
1180
+ collapseToLevel: (level: number) => void;
1181
+ }
1182
+ interface TreeProps<TData> {
1183
+ /** Array of root nodes of the forest. */
1184
+ data: TData[];
1185
+ /** Accessor returning the children of a node (undefined for leaves). */
1186
+ getChildren: (node: TData) => TData[] | undefined;
1187
+ /** Accessor returning a stable unique id for the node. */
1188
+ getNodeId: (node: TData) => string;
1189
+ /** Id of the currently selected branch (node that also "comprises" its children). */
1190
+ selectedId?: string;
1191
+ /** Called when a node is selected. */
1192
+ onSelect?: (node: TData, id: string) => void;
1193
+ /** Initial expanded ids. */
1194
+ defaultExpandedIds?: string[];
1195
+ /**
1196
+ * Row actions rendered in the overflow menu. The `value` of each option is
1197
+ * passed to `onAction`; the consumer fully owns their behavior.
1198
+ */
1199
+ actions?: Option[];
1200
+ /** Called when an action (from `actions`) is fired. */
1201
+ onAction?: (actionId: string, node: TData, id: string) => void;
1202
+ /** Whether rows are draggable and the drag handle is shown. Defaults to true. */
1203
+ enableDragAndDrop?: boolean;
1204
+ /** Whether vertical connection lines are shown. Defaults to true. */
1205
+ enableConnection?: boolean;
1206
+ /** Custom validator run before emitting a drop. Return false to reject. */
1207
+ canDrop?: (payload: TreeDropPayload) => boolean;
1208
+ /** Per-node drop validator. */
1209
+ canDropNode?: (source: TData, target: TData, position: TreeDropPosition) => boolean;
1210
+ /** Emitted when a node is dropped onto/around a target. */
1211
+ onNodeDrop?: (payload: TreeDropPayload) => void;
1212
+ /** Custom renderer for the row content. Receives the node + internal state. */
1213
+ renderNode?: (node: TData, state: TreeRowState) => React__default.ReactNode;
1214
+ /** Extract the display label of a node. Defaults to a `label` field. */
1215
+ getNodeLabel?: (node: TData) => string;
1216
+ /** Extract the icon for a node. Emoji strings are rendered as text; URLs/names use the Icon component. */
1217
+ getNodeIcon?: (node: TData) => string | undefined;
1218
+ /** Extract whether a node is disabled. Disabled nodes are not draggable and get a disabled style. */
1219
+ getNodeDisabled?: (node: TData) => boolean;
1220
+ /** Accessibility label describing the whole tree. */
1221
+ ariaLabel?: string;
1222
+ className?: string;
1223
+ /** Imperative handle for programmatic expansion control (see {@link TreeHandle}). */
1224
+ ref?: React__default.Ref<TreeHandle>;
1225
+ }
1226
+
1227
+ /** Renders a hierarchical (tree) structure as a sortable, accessible list. */
1228
+ declare function Tree<TData>(props: TreeProps<TData> & {
1229
+ ref?: React__default.Ref<TreeHandle>;
1230
+ }): React__default.JSX.Element;
1231
+
1232
+ interface TreeCardSpecificProps<TData> {
1233
+ /** Column definitions used to render each card's fields. */
1234
+ columns?: DataStructureColumn<TData>[];
1235
+ /** Responsive layout configuration for each card's fields. */
1236
+ layout?: ResponsiveLayout;
1237
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`). */
1238
+ slotMap?: SlotMap;
1239
+ /** UI configuration for conditional styling and presentation. */
1240
+ uiConfig?: DataStructureUIConfig<TData>;
1241
+ /** Which nodes get a card body: every node, or only the last nesting level (leaves). Defaults to "all". */
1242
+ cardsAt?: "all" | "leaves";
1243
+ }
1244
+ /** Props for the TreeCard component — combines Tree props with Card-specific layout configuration. */
1245
+ interface TreeCardProps<TData> extends TreeProps<TData>, TreeCardSpecificProps<TData> {
1246
+ }
1247
+
1248
+ /** Renders a hierarchical (tree) structure as nested Cards, reusing {@link Tree}'s mechanism. */
1249
+ declare function TreeCard<TData>(props: TreeCardProps<TData> & {
1250
+ ref?: React__default.Ref<TreeHandle>;
1251
+ }): React__default.JSX.Element;
1252
+
1253
+ /**
1254
+ * Props for the KPI component.
1255
+ * A KPI is a single-metric Card;
1256
+ */
1257
+ interface KPISpecificProps<TData> {
1258
+ /** Single row of data to display in the KPI */
1259
+ data: TData;
1260
+ /** Layout for the KPI fields. Reuse a shared layout example or supply a custom one. */
1261
+ layout?: ResponsiveLayout;
1262
+ /** Maps a column (`accessorKey`) to a layout slot id (`block.fieldId`).*/
1263
+ slotMap?: SlotMap;
1264
+ /** Additional CSS class for the KPI container */
1265
+ className?: string;
1266
+ /** Called when the KPI is clicked */
1267
+ onClick?: () => void;
1268
+ }
1269
+ type KPIProps<TData> = Omit<DataStructureComponent<TData>, "data"> & KPISpecificProps<TData>;
1270
+
1271
+ /**
1272
+ * KPI component — a single-metric Card.
1273
+ */
1274
+ declare function KPI<TData>({ data, columns, layout, slotMap, className, uiConfig, onClick }: KPIProps<TData>): React$1.JSX.Element;
1275
+
1276
+ /**
1277
+ * Shared finance layouts for any component taking a `ResponsiveLayout` (Card, KPI,
1278
+ * CardList). Field IDs are generic: `label`, `value`, `delta`, `trend`, `icon`.
1279
+ */
1280
+ /**
1281
+ * Compact KPI layout: label on top, big value in the middle, delta/trend
1282
+ * at the bottom. On small breakpoints it collapses to a single column.
1283
+ */
1284
+ declare const financeKpiLayout: ResponsiveLayout;
1285
+ /**
1286
+ * Finance layout with leading icon on the right side (icon spans the whole
1287
+ * height). Useful when the dataset includes a representative icon/illustration.
1288
+ */
1289
+ declare const financeKpiLayoutWithIcon: ResponsiveLayout;
1290
+
1291
+ /** A registered CardList layout preset. */
1292
+ interface CardLayoutPreset {
1293
+ id: string;
1294
+ label: string;
1295
+ description: string;
1296
+ /** Bundled SVG icon name shown in the selector. */
1297
+ leadingVisual?: string;
1298
+ layout: ResponsiveLayout;
1299
+ }
1300
+ /**
1301
+ * Card layout: icon left, name + type beside it, actions right-aligned.
1302
+ * Field IDs: `icon`, `name`, `type`, `actions`.
1303
+ */
1304
+ declare const cardLayoutWithIcon: ResponsiveLayout;
1305
+ /** Maps a preset id to its `ResponsiveLayout`. Falls back to `undefined`. */
1306
+ declare function resolveCardLayoutPreset(id?: string): ResponsiveLayout | undefined;
1307
+ /** Option shape consumed by the card-list layout selector. */
1308
+ declare const cardLayoutPresetOptions: {
1309
+ value: string;
1310
+ label: string;
1311
+ description: string;
1312
+ leadingVisual: string | undefined;
1313
+ }[];
1314
+
1315
+ /**
1316
+ * A registered KPI layout preset: `id` is stored in the widget config and resolved
1317
+ * back to a `ResponsiveLayout`; `label` / `description` drive the selector UI.
1318
+ */
1319
+ interface KpiLayoutPreset {
1320
+ id: string;
1321
+ label: string;
1322
+ description: string;
1323
+ /** Bundled SVG icon name shown in the selector. */
1324
+ leadingVisual?: string;
1325
+ layout: ResponsiveLayout;
1326
+ }
1327
+ /** Maps a preset id to its `ResponsiveLayout`. Falls back to `undefined`. */
1328
+ declare function resolveKpiLayoutPreset(id?: string): ResponsiveLayout | undefined;
1329
+ /** Option shape consumed by the `preview-dialog` selector. */
1330
+ declare const kpiLayoutPresetOptions: {
1331
+ value: string;
1332
+ label: string;
1333
+ description: string;
1334
+ leadingVisual: string | undefined;
1335
+ }[];
1336
+
1337
+ /**
1338
+ * Identifiers for all data-components that the switcher can render.
1339
+ */
1340
+ type DataComponentId = "table-grid" | "chart" | "calendar" | "gantt" | "form" | "card-list" | "kpi";
1341
+ /**
1342
+ * Maps each component id to its specific props interface (without DataStructureComponent).
1343
+ * Used by the switcher to type the dynamic `componentProps` state.
1344
+ */
1345
+ type ComponentSpecificPropsMap<TData> = {
1346
+ "table-grid": TableGridSpecificProps<TData>;
1347
+ "chart": ChartSpecificProps<TData>;
1348
+ "calendar": CalendarSpecificProps<TData>;
1349
+ "gantt": GanttSpecificProps<TData>;
1350
+ "form": FormSpecificProps<TData>;
1351
+ "card-list": CardListSpecificProps<TData>;
1352
+ "kpi": KPISpecificProps<TData>;
1353
+ };
1354
+ /**
1355
+ * Props for the Switcher, which wraps a data-component and manages its specific props.
1356
+ * Uncontrolled: `initialComponent` / `initialComponentProps`; controlled: `activeComponent` / `componentProps`.
1357
+ */
1358
+ interface SwitcherProps<TData> extends DataStructureComponent<TData> {
1359
+ /** Initial active component. Defaults to "table-grid". (Uncontrolled mode) */
1360
+ initialComponent?: DataComponentId;
1361
+ /** Initial specific props for the active component. (Uncontrolled mode) */
1362
+ initialComponentProps?: Partial<ComponentSpecificPropsMap<TData>[DataComponentId]>;
1363
+ /** Active component. When provided, Switcher runs in controlled mode. */
1364
+ activeComponent?: DataComponentId;
1365
+ /** Current component props. When provided, Switcher runs in controlled mode. */
1366
+ componentProps?: Record<string, unknown>;
1367
+ /** Whether to show the "Configure" button and overlay. Default: true. */
1368
+ showConfigurator?: boolean;
1369
+ /** Called when the active component changes. */
1370
+ onComponentChange?: (componentId: DataComponentId) => void;
1371
+ /** Called when the specific props change. */
1372
+ onComponentPropsChange?: (props: Partial<ComponentSpecificPropsMap<TData>[DataComponentId]>) => void;
1373
+ }
1374
+
1375
+ /**
1376
+ * Wraps a data-component: shared props (data, columns, uiConfig, getSubRows) go to every
1377
+ * component, specific props are managed via the config overlay. Uncontrolled or controlled.
1378
+ */
1379
+ 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;
1380
+
1381
+ /**
1382
+ * Where a prop field is configurable: "all" (both), "switcher", "dashboard",
1383
+ * or "none" (not configurable via UI).
1384
+ */
1385
+ type PropFieldScope = "all" | "switcher" | "dashboard" | "none";
1386
+ /**
1387
+ * Describes a single configurable prop field for the dynamic PropForm.
1388
+ */
1389
+ interface PropFieldDescriptor {
1390
+ /** Prop name (matches the key in the SpecificProps interface). */
1391
+ name: string;
1392
+ /** Control type to render. */
1393
+ type: "boolean" | "string" | "number" | "select" | "column" | "columns" | "color[]" | "chart-series" | "slot-map";
1394
+ /** Human-readable label. */
1395
+ label: string;
1396
+ /** Default value when the prop is not set. */
1397
+ defaultValue: unknown;
1398
+ /**
1399
+ * Where this field is configurable.
1400
+ * @default "all"
1401
+ */
1402
+ scope?: PropFieldScope;
1403
+ /** Options for "select" type controls. */
1404
+ options?: {
1405
+ label: string;
1406
+ value: string;
1407
+ description?: string;
1408
+ leadingVisual?: string;
1409
+ }[];
1410
+ /**
1411
+ * Generic column-level configuration forwarded as-is to the generated
1412
+ */
1413
+ columnConfig?: Record<string, unknown>;
1414
+ /**
1415
+ * Optional condition: if provided, the field is only visible when this
1416
+ * function returns true given the current form values.
1417
+ */
1418
+ condition?: (formValues: Record<string, unknown>) => boolean;
1419
+ }
1420
+ /**
1421
+ * Registry mapping each DataComponentId to its array of PropFieldDescriptors.
1422
+ */
1423
+ type PropSchemaRegistry = Record<string, PropFieldDescriptor[]>;
1424
+
1425
+ /**
1426
+ * Props for the shared DataComponentConfigurator, used by the Switcher (selector +
1427
+ * form, scope "switcher") and the Dashboard widget configurator (form only).
1428
+ */
1429
+ interface DataComponentConfiguratorProps {
1430
+ /** Schema for the active component's configurable fields. */
1431
+ schema: PropFieldDescriptor[];
1432
+ /** Current values for all fields. */
1433
+ values: Record<string, unknown>;
1434
+ /** Called when a field value changes. */
1435
+ onChange: (name: string, value: unknown) => void;
1436
+ /** Available columns (for "column" / "columns" type fields). */
1437
+ columns?: DataStructureColumn<Record<string, unknown>>[];
1438
+ /**
1439
+ * Scope filter — only fields matching this scope are rendered.
1440
+ * @default "all"
1441
+ */
1442
+ scope?: PropFieldScope;
1443
+ /** When provided, shows the component selector panel. */
1444
+ componentId?: DataComponentId;
1445
+ /** Called when the active component changes. */
1446
+ onComponentChange?: (componentId: DataComponentId) => void;
1447
+ /** Metadata list for the component selector. */
1448
+ componentMetaList?: {
1449
+ id: DataComponentId;
1450
+ label: string;
1451
+ icon: string;
1452
+ }[];
1453
+ }
1454
+
1455
+ /**
1456
+ * Shared configurator for data-components: an optional component selector
1457
+ * (`componentMetaList`) plus a dynamic prop form filtered by `scope`.
1458
+ */
1459
+ declare const DataComponentConfigurator: {
1460
+ ({ schema, values, onChange, columns, scope, componentId, onComponentChange, componentMetaList, }: DataComponentConfiguratorProps): React__default.JSX.Element;
1461
+ displayName: string;
1462
+ };
1463
+
1464
+ export { Calendar, Card, CardList, Cell, Chart, DataComponentConfigurator, Form, Gantt, KPI, Switcher, TableGrid, TableRowModel, TableSortingMode, Tree, TreeCard, cardLayoutPresetOptions, cardLayoutWithIcon, createDataStructureFromFile, financeKpiLayout, financeKpiLayoutWithIcon, kpiLayoutPresetOptions, resolveCardLayoutPreset, resolveKpiLayoutPreset };
1465
+ export type { BlockNode, CalendarProps, CardLayoutPreset, CardListProps, CardProps, CellProps, ChartProps, ChartType, ColumnDef, ComponentSpecificPropsMap, ComputedPivotData, DataComponentConfiguratorProps, DataComponentId, DataStructureColumn, DataStructureComponent, DataStructureUIColumn, DataStructureUIConfig, DataStructureUIContainer, DataStructureUIRule, FeatureSupport, FlexContainer, FormChangeResponse, FormColumn, FormColumnDelta, FormProps, GanttDependency, GanttProps, GanttRelationType, GanttView, GeoConfig, GridChild, GridContainer, KPIProps, KPISpecificProps, KpiLayoutPreset, LayoutNode, PivotAggregation, PivotConfig, PivotValueField, PropFieldDescriptor, PropFieldScope, PropSchemaRegistry, ResolvedCellUI, ResponsiveLayout, SankeyConfig, ServerDatasource, ServerGroupRow, ServerRowRequest, ServerRowResponse, SwitcherProps, TableGridProps, TableModelFeature, TableRow, TableState, TreeCardProps, TreeDropPayload, TreeDropPosition, TreeHandle, TreeProps, TreeRowScope, TreeRowState, UIRuleOperator };