@cloud-ru/ds-table 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (995) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +201 -0
  3. package/README.md +2471 -0
  4. package/dist/cjs/columnUtils/actionsColumn.d.ts +10 -0
  5. package/dist/cjs/columnUtils/actionsColumn.js +8 -0
  6. package/dist/cjs/columnUtils/defineColumns.d.ts +27 -0
  7. package/dist/cjs/columnUtils/defineColumns.js +53 -0
  8. package/dist/cjs/columnUtils/index.d.ts +8 -0
  9. package/dist/cjs/columnUtils/index.js +11 -0
  10. package/dist/cjs/columnUtils/mapCardViewProps.d.ts +25 -0
  11. package/dist/cjs/columnUtils/mapCardViewProps.js +21 -0
  12. package/dist/cjs/columnUtils/statusColumn.d.ts +18 -0
  13. package/dist/cjs/columnUtils/statusColumn.js +25 -0
  14. package/dist/cjs/components/ServerTable/ServerTable.d.ts +19 -0
  15. package/dist/cjs/components/ServerTable/ServerTable.js +50 -0
  16. package/dist/cjs/components/ServerTable/constants.d.ts +2 -0
  17. package/dist/cjs/components/ServerTable/constants.js +5 -0
  18. package/dist/cjs/components/ServerTable/index.d.ts +1 -0
  19. package/dist/cjs/components/ServerTable/index.js +17 -0
  20. package/dist/cjs/components/Table/Table.d.ts +23 -0
  21. package/dist/cjs/components/Table/Table.js +336 -0
  22. package/dist/cjs/components/Table/components/TableCardsBody/TableCardsBody.d.ts +39 -0
  23. package/dist/cjs/components/Table/components/TableCardsBody/TableCardsBody.js +36 -0
  24. package/dist/cjs/components/Table/components/TableCardsBody/index.d.ts +1 -0
  25. package/dist/cjs/components/Table/components/TableCardsBody/index.js +17 -0
  26. package/dist/cjs/components/Table/components/TableChrome/TableChrome.d.ts +10 -0
  27. package/dist/cjs/components/Table/components/TableChrome/TableChrome.js +18 -0
  28. package/dist/cjs/components/Table/components/TableChrome/index.d.ts +1 -0
  29. package/dist/cjs/components/Table/components/TableChrome/index.js +17 -0
  30. package/dist/cjs/components/Table/components/TableRowsBody/TableRowsBody.d.ts +21 -0
  31. package/dist/cjs/components/Table/components/TableRowsBody/TableRowsBody.js +21 -0
  32. package/dist/cjs/components/Table/components/TableRowsBody/index.d.ts +1 -0
  33. package/dist/cjs/components/Table/components/TableRowsBody/index.js +17 -0
  34. package/dist/cjs/components/Table/components/TableScrollHost/TableScrollHost.d.ts +21 -0
  35. package/dist/cjs/components/Table/components/TableScrollHost/TableScrollHost.js +19 -0
  36. package/dist/cjs/components/Table/components/TableScrollHost/index.d.ts +1 -0
  37. package/dist/cjs/components/Table/components/TableScrollHost/index.js +17 -0
  38. package/dist/cjs/components/Table/components/TableSkeletonBody/TableSkeletonBody.d.ts +23 -0
  39. package/dist/cjs/components/Table/components/TableSkeletonBody/TableSkeletonBody.js +16 -0
  40. package/dist/cjs/components/Table/components/TableSkeletonBody/index.d.ts +1 -0
  41. package/dist/cjs/components/Table/components/TableSkeletonBody/index.js +17 -0
  42. package/dist/cjs/components/Table/components/TableToolbar/TableToolbar.d.ts +26 -0
  43. package/dist/cjs/components/Table/components/TableToolbar/TableToolbar.js +13 -0
  44. package/dist/cjs/components/Table/components/TableToolbar/index.d.ts +1 -0
  45. package/dist/cjs/components/Table/components/TableToolbar/index.js +17 -0
  46. package/dist/cjs/components/Table/hooks/index.d.ts +13 -0
  47. package/dist/cjs/components/Table/hooks/index.js +29 -0
  48. package/dist/cjs/components/Table/hooks/loadingTableCells.d.ts +2 -0
  49. package/dist/cjs/components/Table/hooks/loadingTableCells.js +59 -0
  50. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/index.d.ts +1 -0
  51. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/index.js +17 -0
  52. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.d.ts +16 -0
  53. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.js +82 -0
  54. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.d.ts +4 -0
  55. package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.js +23 -0
  56. package/dist/cjs/components/Table/hooks/useColumnSettings/index.d.ts +1 -0
  57. package/dist/cjs/components/Table/hooks/useColumnSettings/index.js +17 -0
  58. package/dist/cjs/components/Table/hooks/useColumnSettings/useColumnSettings.d.ts +28 -0
  59. package/dist/cjs/components/Table/hooks/useColumnSettings/useColumnSettings.js +95 -0
  60. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.d.ts +8 -0
  61. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.js +13 -0
  62. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.d.ts +14 -0
  63. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.js +59 -0
  64. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.d.ts +3 -0
  65. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.js +26 -0
  66. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/index.d.ts +9 -0
  67. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/index.js +25 -0
  68. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.d.ts +6 -0
  69. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.js +13 -0
  70. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.d.ts +6 -0
  71. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.js +24 -0
  72. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.d.ts +6 -0
  73. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.js +12 -0
  74. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.d.ts +5 -0
  75. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.js +19 -0
  76. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.d.ts +15 -0
  77. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.js +37 -0
  78. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.d.ts +21 -0
  79. package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.js +16 -0
  80. package/dist/cjs/components/Table/hooks/useColumnSizes.d.ts +21 -0
  81. package/dist/cjs/components/Table/hooks/useColumnSizes.js +138 -0
  82. package/dist/cjs/components/Table/hooks/useColumnVirtualizer.d.ts +30 -0
  83. package/dist/cjs/components/Table/hooks/useColumnVirtualizer.js +33 -0
  84. package/dist/cjs/components/Table/hooks/useFilters/index.d.ts +1 -0
  85. package/dist/cjs/components/Table/hooks/useFilters/index.js +17 -0
  86. package/dist/cjs/components/Table/hooks/useFilters/useFilters.d.ts +11 -0
  87. package/dist/cjs/components/Table/hooks/useFilters/useFilters.js +40 -0
  88. package/dist/cjs/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.d.ts +2 -0
  89. package/dist/cjs/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.js +11 -0
  90. package/dist/cjs/components/Table/hooks/useFilters/utils/index.d.ts +1 -0
  91. package/dist/cjs/components/Table/hooks/useFilters/utils/index.js +17 -0
  92. package/dist/cjs/components/Table/hooks/useLoadingTable.d.ts +16 -0
  93. package/dist/cjs/components/Table/hooks/useLoadingTable.js +60 -0
  94. package/dist/cjs/components/Table/hooks/usePageReset.d.ts +10 -0
  95. package/dist/cjs/components/Table/hooks/usePageReset.js +15 -0
  96. package/dist/cjs/components/Table/hooks/useRowVirtualizer.d.ts +17 -0
  97. package/dist/cjs/components/Table/hooks/useRowVirtualizer.js +25 -0
  98. package/dist/cjs/components/Table/hooks/useStateControl.d.ts +8 -0
  99. package/dist/cjs/components/Table/hooks/useStateControl.js +16 -0
  100. package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +126 -0
  101. package/dist/cjs/components/Table/hooks/useTableInstance.js +143 -0
  102. package/dist/cjs/components/Table/hooks/useTableScroll.d.ts +28 -0
  103. package/dist/cjs/components/Table/hooks/useTableScroll.js +114 -0
  104. package/dist/cjs/components/Table/hooks/useTableToolbar.d.ts +78 -0
  105. package/dist/cjs/components/Table/hooks/useTableToolbar.js +119 -0
  106. package/dist/cjs/components/Table/hooks/useTableView.d.ts +24 -0
  107. package/dist/cjs/components/Table/hooks/useTableView.js +23 -0
  108. package/dist/cjs/components/Table/index.d.ts +2 -0
  109. package/dist/cjs/components/Table/index.js +20 -0
  110. package/dist/cjs/components/Table/styles.module.css +578 -0
  111. package/dist/cjs/components/Table/utils/columnSize.d.ts +12 -0
  112. package/dist/cjs/components/Table/utils/columnSize.js +24 -0
  113. package/dist/cjs/components/Table/utils/getColumnIdentifier.d.ts +2 -0
  114. package/dist/cjs/components/Table/utils/getColumnIdentifier.js +9 -0
  115. package/dist/cjs/components/Table/utils/getColumnStyleVars.d.ts +4 -0
  116. package/dist/cjs/components/Table/utils/getColumnStyleVars.js +10 -0
  117. package/dist/cjs/components/Table/utils/getCurrentlyConfiguredHeaderWidth.d.ts +1 -0
  118. package/dist/cjs/components/Table/utils/getCurrentlyConfiguredHeaderWidth.js +20 -0
  119. package/dist/cjs/components/Table/utils/getPinnedGroups.d.ts +11 -0
  120. package/dist/cjs/components/Table/utils/getPinnedGroups.js +26 -0
  121. package/dist/cjs/components/Table/utils/getTableColumnsDefinitions.d.ts +18 -0
  122. package/dist/cjs/components/Table/utils/getTableColumnsDefinitions.js +27 -0
  123. package/dist/cjs/components/Table/utils/index.d.ts +8 -0
  124. package/dist/cjs/components/Table/utils/index.js +24 -0
  125. package/dist/cjs/components/Table/utils/isEveryArrayItemString.d.ts +1 -0
  126. package/dist/cjs/components/Table/utils/isEveryArrayItemString.js +5 -0
  127. package/dist/cjs/components/Table/utils/saveTableState/mappers.d.ts +18 -0
  128. package/dist/cjs/components/Table/utils/saveTableState/mappers.js +45 -0
  129. package/dist/cjs/components/Table/utils/saveTableState/validators.d.ts +5 -0
  130. package/dist/cjs/components/Table/utils/saveTableState/validators.js +24 -0
  131. package/dist/cjs/components/Table/utils/sortColumnDefinitions.d.ts +2 -0
  132. package/dist/cjs/components/Table/utils/sortColumnDefinitions.js +11 -0
  133. package/dist/cjs/components/index.d.ts +3 -0
  134. package/dist/cjs/components/index.js +19 -0
  135. package/dist/cjs/components/types.d.ts +395 -0
  136. package/dist/cjs/components/types.js +28 -0
  137. package/dist/cjs/constants.d.ts +113 -0
  138. package/dist/cjs/constants.js +117 -0
  139. package/dist/cjs/contexts/CellAutoResizeContext/CellAutoResizeContext.d.ts +2 -0
  140. package/dist/cjs/contexts/CellAutoResizeContext/CellAutoResizeContext.js +8 -0
  141. package/dist/cjs/contexts/CellAutoResizeContext/hooks/index.d.ts +2 -0
  142. package/dist/cjs/contexts/CellAutoResizeContext/hooks/index.js +18 -0
  143. package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.d.ts +6 -0
  144. package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.js +41 -0
  145. package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellResize.d.ts +4 -0
  146. package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellResize.js +23 -0
  147. package/dist/cjs/contexts/CellAutoResizeContext/index.d.ts +2 -0
  148. package/dist/cjs/contexts/CellAutoResizeContext/index.js +18 -0
  149. package/dist/cjs/contexts/CellAutoResizeContext/types.d.ts +15 -0
  150. package/dist/cjs/contexts/CellAutoResizeContext/types.js +2 -0
  151. package/dist/cjs/contexts/RowContext/RowContext.d.ts +10 -0
  152. package/dist/cjs/contexts/RowContext/RowContext.js +12 -0
  153. package/dist/cjs/contexts/RowContext/index.d.ts +1 -0
  154. package/dist/cjs/contexts/RowContext/index.js +17 -0
  155. package/dist/cjs/contexts/TableContext/TableContext.d.ts +28 -0
  156. package/dist/cjs/contexts/TableContext/TableContext.js +17 -0
  157. package/dist/cjs/contexts/TableContext/index.d.ts +1 -0
  158. package/dist/cjs/contexts/TableContext/index.js +17 -0
  159. package/dist/cjs/contexts/index.d.ts +4 -0
  160. package/dist/cjs/contexts/index.js +22 -0
  161. package/dist/cjs/helperComponents/Cells/BodyCell/BodyCell.d.ts +9 -0
  162. package/dist/cjs/helperComponents/Cells/BodyCell/BodyCell.js +33 -0
  163. package/dist/cjs/helperComponents/Cells/BodyCell/index.d.ts +1 -0
  164. package/dist/cjs/helperComponents/Cells/BodyCell/index.js +17 -0
  165. package/dist/cjs/helperComponents/Cells/BodyCell/styles.module.css +15 -0
  166. package/dist/cjs/helperComponents/Cells/Cell.d.ts +18 -0
  167. package/dist/cjs/helperComponents/Cells/Cell.js +11 -0
  168. package/dist/cjs/helperComponents/Cells/CopyCell/CopyCell.d.ts +4 -0
  169. package/dist/cjs/helperComponents/Cells/CopyCell/CopyCell.js +32 -0
  170. package/dist/cjs/helperComponents/Cells/CopyCell/index.d.ts +1 -0
  171. package/dist/cjs/helperComponents/Cells/CopyCell/index.js +17 -0
  172. package/dist/cjs/helperComponents/Cells/CopyCell/styles.module.css +39 -0
  173. package/dist/cjs/helperComponents/Cells/HeaderCell/HeaderCell.d.ts +11 -0
  174. package/dist/cjs/helperComponents/Cells/HeaderCell/HeaderCell.js +49 -0
  175. package/dist/cjs/helperComponents/Cells/HeaderCell/ResizeHandle.d.ts +8 -0
  176. package/dist/cjs/helperComponents/Cells/HeaderCell/ResizeHandle.js +41 -0
  177. package/dist/cjs/helperComponents/Cells/HeaderCell/helpers.d.ts +4 -0
  178. package/dist/cjs/helperComponents/Cells/HeaderCell/helpers.js +20 -0
  179. package/dist/cjs/helperComponents/Cells/HeaderCell/index.d.ts +1 -0
  180. package/dist/cjs/helperComponents/Cells/HeaderCell/index.js +17 -0
  181. package/dist/cjs/helperComponents/Cells/HeaderCell/styles.module.css +149 -0
  182. package/dist/cjs/helperComponents/Cells/RowActionsCell/RowActionsCell.d.ts +12 -0
  183. package/dist/cjs/helperComponents/Cells/RowActionsCell/RowActionsCell.js +63 -0
  184. package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.d.ts +8 -0
  185. package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +20 -0
  186. package/dist/cjs/helperComponents/Cells/RowActionsCell/components/index.d.ts +1 -0
  187. package/dist/cjs/helperComponents/Cells/RowActionsCell/components/index.js +17 -0
  188. package/dist/cjs/helperComponents/Cells/RowActionsCell/index.d.ts +1 -0
  189. package/dist/cjs/helperComponents/Cells/RowActionsCell/index.js +17 -0
  190. package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +23 -0
  191. package/dist/cjs/helperComponents/Cells/SelectionCell/SelectionCell.d.ts +3 -0
  192. package/dist/cjs/helperComponents/Cells/SelectionCell/SelectionCell.js +92 -0
  193. package/dist/cjs/helperComponents/Cells/SelectionCell/index.d.ts +1 -0
  194. package/dist/cjs/helperComponents/Cells/SelectionCell/index.js +17 -0
  195. package/dist/cjs/helperComponents/Cells/SelectionCell/styles.module.css +15 -0
  196. package/dist/cjs/helperComponents/Cells/StatusCell/StatusCell.d.ts +39 -0
  197. package/dist/cjs/helperComponents/Cells/StatusCell/StatusCell.js +73 -0
  198. package/dist/cjs/helperComponents/Cells/StatusCell/constants.d.ts +13 -0
  199. package/dist/cjs/helperComponents/Cells/StatusCell/constants.js +18 -0
  200. package/dist/cjs/helperComponents/Cells/StatusCell/index.d.ts +1 -0
  201. package/dist/cjs/helperComponents/Cells/StatusCell/index.js +17 -0
  202. package/dist/cjs/helperComponents/Cells/StatusCell/styles.module.css +24 -0
  203. package/dist/cjs/helperComponents/Cells/StatusCell/types.d.ts +3 -0
  204. package/dist/cjs/helperComponents/Cells/StatusCell/types.js +2 -0
  205. package/dist/cjs/helperComponents/Cells/TreeCell/TreeCell.d.ts +40 -0
  206. package/dist/cjs/helperComponents/Cells/TreeCell/TreeCell.js +170 -0
  207. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/TreeLine.d.ts +9 -0
  208. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/TreeLine.js +12 -0
  209. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/index.d.ts +1 -0
  210. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/index.js +17 -0
  211. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +39 -0
  212. package/dist/cjs/helperComponents/Cells/TreeCell/constants.d.ts +1 -0
  213. package/dist/cjs/helperComponents/Cells/TreeCell/constants.js +4 -0
  214. package/dist/cjs/helperComponents/Cells/TreeCell/index.d.ts +1 -0
  215. package/dist/cjs/helperComponents/Cells/TreeCell/index.js +17 -0
  216. package/dist/cjs/helperComponents/Cells/TreeCell/rowHierarchicalSelection.d.ts +7 -0
  217. package/dist/cjs/helperComponents/Cells/TreeCell/rowHierarchicalSelection.js +41 -0
  218. package/dist/cjs/helperComponents/Cells/TreeCell/styles.module.css +112 -0
  219. package/dist/cjs/helperComponents/Cells/index.d.ts +8 -0
  220. package/dist/cjs/helperComponents/Cells/index.js +24 -0
  221. package/dist/cjs/helperComponents/Cells/styles.module.css +13 -0
  222. package/dist/cjs/helperComponents/ControlsChrome/ControlsChrome.d.ts +17 -0
  223. package/dist/cjs/helperComponents/ControlsChrome/ControlsChrome.js +31 -0
  224. package/dist/cjs/helperComponents/ControlsChrome/index.d.ts +1 -0
  225. package/dist/cjs/helperComponents/ControlsChrome/index.js +17 -0
  226. package/dist/cjs/helperComponents/ControlsChrome/styles.module.css +221 -0
  227. package/dist/cjs/helperComponents/LoadMoreButton/LoadMoreButton.d.ts +6 -0
  228. package/dist/cjs/helperComponents/LoadMoreButton/LoadMoreButton.js +18 -0
  229. package/dist/cjs/helperComponents/LoadMoreButton/index.d.ts +2 -0
  230. package/dist/cjs/helperComponents/LoadMoreButton/index.js +5 -0
  231. package/dist/cjs/helperComponents/LoadMoreButton/styles.module.css +6 -0
  232. package/dist/cjs/helperComponents/Rows/BodyRow.d.ts +20 -0
  233. package/dist/cjs/helperComponents/Rows/BodyRow.js +37 -0
  234. package/dist/cjs/helperComponents/Rows/HeaderRow.d.ts +10 -0
  235. package/dist/cjs/helperComponents/Rows/HeaderRow.js +27 -0
  236. package/dist/cjs/helperComponents/Rows/PinnedCells.d.ts +9 -0
  237. package/dist/cjs/helperComponents/Rows/PinnedCells.js +12 -0
  238. package/dist/cjs/helperComponents/Rows/Row.d.ts +12 -0
  239. package/dist/cjs/helperComponents/Rows/Row.js +23 -0
  240. package/dist/cjs/helperComponents/Rows/index.d.ts +2 -0
  241. package/dist/cjs/helperComponents/Rows/index.js +18 -0
  242. package/dist/cjs/helperComponents/Rows/styles.module.css +229 -0
  243. package/dist/cjs/helperComponents/TableCard/TableCard.d.ts +28 -0
  244. package/dist/cjs/helperComponents/TableCard/TableCard.js +80 -0
  245. package/dist/cjs/helperComponents/TableCard/index.d.ts +1 -0
  246. package/dist/cjs/helperComponents/TableCard/index.js +17 -0
  247. package/dist/cjs/helperComponents/TableCard/styles.module.css +63 -0
  248. package/dist/cjs/helperComponents/TableEmptyState/TableEmptyState.d.ts +13 -0
  249. package/dist/cjs/helperComponents/TableEmptyState/TableEmptyState.js +15 -0
  250. package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +10 -0
  251. package/dist/cjs/helperComponents/TableEmptyState/hooks.js +34 -0
  252. package/dist/cjs/helperComponents/TableEmptyState/index.d.ts +2 -0
  253. package/dist/cjs/helperComponents/TableEmptyState/index.js +18 -0
  254. package/dist/cjs/helperComponents/TableEmptyState/styles.module.css +11 -0
  255. package/dist/cjs/helperComponents/TablePagination/TablePagination.d.ts +9 -0
  256. package/dist/cjs/helperComponents/TablePagination/TablePagination.js +34 -0
  257. package/dist/cjs/helperComponents/TablePagination/index.d.ts +1 -0
  258. package/dist/cjs/helperComponents/TablePagination/index.js +17 -0
  259. package/dist/cjs/helperComponents/TablePagination/styles.module.css +14 -0
  260. package/dist/cjs/helperComponents/index.d.ts +8 -0
  261. package/dist/cjs/helperComponents/index.js +24 -0
  262. package/dist/cjs/helperComponents/types.d.ts +7 -0
  263. package/dist/cjs/helperComponents/types.js +2 -0
  264. package/dist/cjs/helpers/getColumnId.d.ts +2 -0
  265. package/dist/cjs/helpers/getColumnId.js +12 -0
  266. package/dist/cjs/helpers/index.d.ts +9 -0
  267. package/dist/cjs/helpers/index.js +25 -0
  268. package/dist/cjs/helpers/masterSelection.d.ts +15 -0
  269. package/dist/cjs/helpers/masterSelection.js +31 -0
  270. package/dist/cjs/helpers/renderColumnsSettingsOverflowButton.d.ts +7 -0
  271. package/dist/cjs/helpers/renderColumnsSettingsOverflowButton.js +15 -0
  272. package/dist/cjs/helpers/renderExportToolbarButton.d.ts +8 -0
  273. package/dist/cjs/helpers/renderExportToolbarButton.js +24 -0
  274. package/dist/cjs/helpers/renderMasterSelectionToggle.d.ts +10 -0
  275. package/dist/cjs/helpers/renderMasterSelectionToggle.js +20 -0
  276. package/dist/cjs/helpers/renderTableSortingOverflowButton.d.ts +9 -0
  277. package/dist/cjs/helpers/renderTableSortingOverflowButton.js +20 -0
  278. package/dist/cjs/helpers/renderToolbarAfterOverflowButton.d.ts +9 -0
  279. package/dist/cjs/helpers/renderToolbarAfterOverflowButton.js +9 -0
  280. package/dist/cjs/helpers/rowSelectionState.d.ts +3 -0
  281. package/dist/cjs/helpers/rowSelectionState.js +13 -0
  282. package/dist/cjs/helpers/toolbarTooltipTrigger.module.css +5 -0
  283. package/dist/cjs/helpers/tryParseLocalStorage.d.ts +2 -0
  284. package/dist/cjs/helpers/tryParseLocalStorage.js +16 -0
  285. package/dist/cjs/hooks/index.d.ts +7 -0
  286. package/dist/cjs/hooks/index.js +23 -0
  287. package/dist/cjs/hooks/useCellSizes.d.ts +10 -0
  288. package/dist/cjs/hooks/useCellSizes.js +34 -0
  289. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/index.d.ts +1 -0
  290. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/index.js +17 -0
  291. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.d.ts +17 -0
  292. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +90 -0
  293. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.css +13 -0
  294. package/dist/cjs/hooks/useExportToolbarSlot/index.d.ts +1 -0
  295. package/dist/cjs/hooks/useExportToolbarSlot/index.js +17 -0
  296. package/dist/cjs/hooks/useExportToolbarSlot/useExportToolbarSlot.d.ts +10 -0
  297. package/dist/cjs/hooks/useExportToolbarSlot/useExportToolbarSlot.js +22 -0
  298. package/dist/cjs/hooks/useHeaderGroups.d.ts +10 -0
  299. package/dist/cjs/hooks/useHeaderGroups.js +40 -0
  300. package/dist/cjs/hooks/useRowCells.d.ts +10 -0
  301. package/dist/cjs/hooks/useRowCells.js +31 -0
  302. package/dist/cjs/hooks/useTableSorting/index.d.ts +1 -0
  303. package/dist/cjs/hooks/useTableSorting/index.js +17 -0
  304. package/dist/cjs/hooks/useTableSorting/useTableSorting.d.ts +25 -0
  305. package/dist/cjs/hooks/useTableSorting/useTableSorting.js +197 -0
  306. package/dist/cjs/hooks/useTableSorting/useTableSorting.module.css +3 -0
  307. package/dist/cjs/hooks/useTableSorting/utils.d.ts +16 -0
  308. package/dist/cjs/hooks/useTableSorting/utils.js +82 -0
  309. package/dist/cjs/hooks/useTableSortingToolbarSlot/index.d.ts +1 -0
  310. package/dist/cjs/hooks/useTableSortingToolbarSlot/index.js +17 -0
  311. package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.d.ts +24 -0
  312. package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +57 -0
  313. package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.css +8 -0
  314. package/dist/cjs/index.d.ts +20 -0
  315. package/dist/cjs/index.js +51 -0
  316. package/dist/cjs/locale/index.d.ts +107 -0
  317. package/dist/cjs/locale/index.js +58 -0
  318. package/dist/cjs/package.json +3 -0
  319. package/dist/cjs/presets/adminTable/AdminTable.d.ts +4 -0
  320. package/dist/cjs/presets/adminTable/AdminTable.js +11 -0
  321. package/dist/cjs/presets/adminTable/index.d.ts +4 -0
  322. package/dist/cjs/presets/adminTable/index.js +9 -0
  323. package/dist/cjs/presets/adminTable/toAdminTableProps.d.ts +31 -0
  324. package/dist/cjs/presets/adminTable/toAdminTableProps.js +57 -0
  325. package/dist/cjs/presets/adminTable/useAdminTableProps.d.ts +5 -0
  326. package/dist/cjs/presets/adminTable/useAdminTableProps.js +25 -0
  327. package/dist/cjs/presets/constants.d.ts +3 -0
  328. package/dist/cjs/presets/constants.js +6 -0
  329. package/dist/cjs/presets/entitiesTable/EntitiesTable.d.ts +9 -0
  330. package/dist/cjs/presets/entitiesTable/EntitiesTable.js +78 -0
  331. package/dist/cjs/presets/entitiesTable/constants.d.ts +1 -0
  332. package/dist/cjs/presets/entitiesTable/constants.js +4 -0
  333. package/dist/cjs/presets/entitiesTable/index.d.ts +7 -0
  334. package/dist/cjs/presets/entitiesTable/index.js +17 -0
  335. package/dist/cjs/presets/entitiesTable/toEntitiesTableProps.d.ts +13 -0
  336. package/dist/cjs/presets/entitiesTable/toEntitiesTableProps.js +58 -0
  337. package/dist/cjs/presets/entitiesTable/types.d.ts +55 -0
  338. package/dist/cjs/presets/entitiesTable/types.js +2 -0
  339. package/dist/cjs/presets/entitiesTable/useEntitiesTableProps.d.ts +13 -0
  340. package/dist/cjs/presets/entitiesTable/useEntitiesTableProps.js +9 -0
  341. package/dist/cjs/presets/entitiesTable/useEntitiesTableState.d.ts +3 -0
  342. package/dist/cjs/presets/entitiesTable/useEntitiesTableState.js +42 -0
  343. package/dist/cjs/presets/entitiesTable/utils.d.ts +9 -0
  344. package/dist/cjs/presets/entitiesTable/utils.js +24 -0
  345. package/dist/cjs/presets/index.d.ts +7 -0
  346. package/dist/cjs/presets/index.js +23 -0
  347. package/dist/cjs/presets/infiniteTable/InfiniteTable.d.ts +3 -0
  348. package/dist/cjs/presets/infiniteTable/InfiniteTable.js +11 -0
  349. package/dist/cjs/presets/infiniteTable/index.d.ts +5 -0
  350. package/dist/cjs/presets/infiniteTable/index.js +11 -0
  351. package/dist/cjs/presets/infiniteTable/toInfiniteTableProps.d.ts +11 -0
  352. package/dist/cjs/presets/infiniteTable/toInfiniteTableProps.js +20 -0
  353. package/dist/cjs/presets/infiniteTable/useInfiniteScrollRef.d.ts +17 -0
  354. package/dist/cjs/presets/infiniteTable/useInfiniteScrollRef.js +29 -0
  355. package/dist/cjs/presets/infiniteTable/useInfiniteTableProps.d.ts +4 -0
  356. package/dist/cjs/presets/infiniteTable/useInfiniteTableProps.js +26 -0
  357. package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
  358. package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +11 -0
  359. package/dist/cjs/presets/serverAdminTable/index.d.ts +4 -0
  360. package/dist/cjs/presets/serverAdminTable/index.js +9 -0
  361. package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
  362. package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +25 -0
  363. package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
  364. package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +25 -0
  365. package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
  366. package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +11 -0
  367. package/dist/cjs/presets/serverSimpleTable/index.d.ts +4 -0
  368. package/dist/cjs/presets/serverSimpleTable/index.js +9 -0
  369. package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
  370. package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +25 -0
  371. package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
  372. package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +21 -0
  373. package/dist/cjs/presets/simpleTable/SimpleTable.d.ts +3 -0
  374. package/dist/cjs/presets/simpleTable/SimpleTable.js +11 -0
  375. package/dist/cjs/presets/simpleTable/index.d.ts +4 -0
  376. package/dist/cjs/presets/simpleTable/index.js +9 -0
  377. package/dist/cjs/presets/simpleTable/toSimpleTableProps.d.ts +15 -0
  378. package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +21 -0
  379. package/dist/cjs/presets/simpleTable/useSimpleTableProps.d.ts +4 -0
  380. package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +21 -0
  381. package/dist/cjs/presets/treeTable/TreeTable.d.ts +3 -0
  382. package/dist/cjs/presets/treeTable/TreeTable.js +11 -0
  383. package/dist/cjs/presets/treeTable/index.d.ts +4 -0
  384. package/dist/cjs/presets/treeTable/index.js +9 -0
  385. package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +34 -0
  386. package/dist/cjs/presets/treeTable/toTreeTableProps.js +57 -0
  387. package/dist/cjs/presets/treeTable/useTreeTableProps.d.ts +4 -0
  388. package/dist/cjs/presets/treeTable/useTreeTableProps.js +18 -0
  389. package/dist/cjs/presets/wrapGetRowId.d.ts +2 -0
  390. package/dist/cjs/presets/wrapGetRowId.js +10 -0
  391. package/dist/cjs/style.css +1580 -0
  392. package/dist/cjs/types.d.ts +59 -0
  393. package/dist/cjs/types.js +2 -0
  394. package/dist/cjs/utils.d.ts +2 -0
  395. package/dist/cjs/utils.js +13 -0
  396. package/dist/esm/columnUtils/actionsColumn.d.ts +10 -0
  397. package/dist/esm/columnUtils/actionsColumn.js +5 -0
  398. package/dist/esm/columnUtils/defineColumns.d.ts +27 -0
  399. package/dist/esm/columnUtils/defineColumns.js +50 -0
  400. package/dist/esm/columnUtils/index.d.ts +8 -0
  401. package/dist/esm/columnUtils/index.js +4 -0
  402. package/dist/esm/columnUtils/mapCardViewProps.d.ts +25 -0
  403. package/dist/esm/columnUtils/mapCardViewProps.js +18 -0
  404. package/dist/esm/columnUtils/statusColumn.d.ts +18 -0
  405. package/dist/esm/columnUtils/statusColumn.js +22 -0
  406. package/dist/esm/components/ServerTable/ServerTable.d.ts +19 -0
  407. package/dist/esm/components/ServerTable/ServerTable.js +47 -0
  408. package/dist/esm/components/ServerTable/constants.d.ts +2 -0
  409. package/dist/esm/components/ServerTable/constants.js +2 -0
  410. package/dist/esm/components/ServerTable/index.d.ts +1 -0
  411. package/dist/esm/components/ServerTable/index.js +1 -0
  412. package/dist/esm/components/Table/Table.d.ts +23 -0
  413. package/dist/esm/components/Table/Table.js +329 -0
  414. package/dist/esm/components/Table/components/TableCardsBody/TableCardsBody.d.ts +39 -0
  415. package/dist/esm/components/Table/components/TableCardsBody/TableCardsBody.js +28 -0
  416. package/dist/esm/components/Table/components/TableCardsBody/index.d.ts +1 -0
  417. package/dist/esm/components/Table/components/TableCardsBody/index.js +1 -0
  418. package/dist/esm/components/Table/components/TableChrome/TableChrome.d.ts +10 -0
  419. package/dist/esm/components/Table/components/TableChrome/TableChrome.js +12 -0
  420. package/dist/esm/components/Table/components/TableChrome/index.d.ts +1 -0
  421. package/dist/esm/components/Table/components/TableChrome/index.js +1 -0
  422. package/dist/esm/components/Table/components/TableRowsBody/TableRowsBody.d.ts +21 -0
  423. package/dist/esm/components/Table/components/TableRowsBody/TableRowsBody.js +15 -0
  424. package/dist/esm/components/Table/components/TableRowsBody/index.d.ts +1 -0
  425. package/dist/esm/components/Table/components/TableRowsBody/index.js +1 -0
  426. package/dist/esm/components/Table/components/TableScrollHost/TableScrollHost.d.ts +21 -0
  427. package/dist/esm/components/Table/components/TableScrollHost/TableScrollHost.js +13 -0
  428. package/dist/esm/components/Table/components/TableScrollHost/index.d.ts +1 -0
  429. package/dist/esm/components/Table/components/TableScrollHost/index.js +1 -0
  430. package/dist/esm/components/Table/components/TableSkeletonBody/TableSkeletonBody.d.ts +23 -0
  431. package/dist/esm/components/Table/components/TableSkeletonBody/TableSkeletonBody.js +13 -0
  432. package/dist/esm/components/Table/components/TableSkeletonBody/index.d.ts +1 -0
  433. package/dist/esm/components/Table/components/TableSkeletonBody/index.js +1 -0
  434. package/dist/esm/components/Table/components/TableToolbar/TableToolbar.d.ts +26 -0
  435. package/dist/esm/components/Table/components/TableToolbar/TableToolbar.js +7 -0
  436. package/dist/esm/components/Table/components/TableToolbar/index.d.ts +1 -0
  437. package/dist/esm/components/Table/components/TableToolbar/index.js +1 -0
  438. package/dist/esm/components/Table/hooks/index.d.ts +13 -0
  439. package/dist/esm/components/Table/hooks/index.js +13 -0
  440. package/dist/esm/components/Table/hooks/loadingTableCells.d.ts +2 -0
  441. package/dist/esm/components/Table/hooks/loadingTableCells.js +53 -0
  442. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/index.d.ts +1 -0
  443. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/index.js +1 -0
  444. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.d.ts +16 -0
  445. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.js +79 -0
  446. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.d.ts +4 -0
  447. package/dist/esm/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.js +18 -0
  448. package/dist/esm/components/Table/hooks/useColumnSettings/index.d.ts +1 -0
  449. package/dist/esm/components/Table/hooks/useColumnSettings/index.js +1 -0
  450. package/dist/esm/components/Table/hooks/useColumnSettings/useColumnSettings.d.ts +28 -0
  451. package/dist/esm/components/Table/hooks/useColumnSettings/useColumnSettings.js +92 -0
  452. package/dist/esm/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.d.ts +8 -0
  453. package/dist/esm/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.js +10 -0
  454. package/dist/esm/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.d.ts +14 -0
  455. package/dist/esm/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.js +54 -0
  456. package/dist/esm/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.d.ts +3 -0
  457. package/dist/esm/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.js +23 -0
  458. package/dist/esm/components/Table/hooks/useColumnSettings/utils/index.d.ts +9 -0
  459. package/dist/esm/components/Table/hooks/useColumnSettings/utils/index.js +9 -0
  460. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.d.ts +6 -0
  461. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.js +10 -0
  462. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.d.ts +6 -0
  463. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.js +21 -0
  464. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.d.ts +6 -0
  465. package/dist/esm/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.js +9 -0
  466. package/dist/esm/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.d.ts +5 -0
  467. package/dist/esm/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.js +16 -0
  468. package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.d.ts +15 -0
  469. package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.js +34 -0
  470. package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.d.ts +21 -0
  471. package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.js +13 -0
  472. package/dist/esm/components/Table/hooks/useColumnSizes.d.ts +21 -0
  473. package/dist/esm/components/Table/hooks/useColumnSizes.js +135 -0
  474. package/dist/esm/components/Table/hooks/useColumnVirtualizer.d.ts +30 -0
  475. package/dist/esm/components/Table/hooks/useColumnVirtualizer.js +30 -0
  476. package/dist/esm/components/Table/hooks/useFilters/index.d.ts +1 -0
  477. package/dist/esm/components/Table/hooks/useFilters/index.js +1 -0
  478. package/dist/esm/components/Table/hooks/useFilters/useFilters.d.ts +11 -0
  479. package/dist/esm/components/Table/hooks/useFilters/useFilters.js +37 -0
  480. package/dist/esm/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.d.ts +2 -0
  481. package/dist/esm/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.js +8 -0
  482. package/dist/esm/components/Table/hooks/useFilters/utils/index.d.ts +1 -0
  483. package/dist/esm/components/Table/hooks/useFilters/utils/index.js +1 -0
  484. package/dist/esm/components/Table/hooks/useLoadingTable.d.ts +16 -0
  485. package/dist/esm/components/Table/hooks/useLoadingTable.js +57 -0
  486. package/dist/esm/components/Table/hooks/usePageReset.d.ts +10 -0
  487. package/dist/esm/components/Table/hooks/usePageReset.js +12 -0
  488. package/dist/esm/components/Table/hooks/useRowVirtualizer.d.ts +17 -0
  489. package/dist/esm/components/Table/hooks/useRowVirtualizer.js +22 -0
  490. package/dist/esm/components/Table/hooks/useStateControl.d.ts +8 -0
  491. package/dist/esm/components/Table/hooks/useStateControl.js +13 -0
  492. package/dist/esm/components/Table/hooks/useTableInstance.d.ts +126 -0
  493. package/dist/esm/components/Table/hooks/useTableInstance.js +138 -0
  494. package/dist/esm/components/Table/hooks/useTableScroll.d.ts +28 -0
  495. package/dist/esm/components/Table/hooks/useTableScroll.js +111 -0
  496. package/dist/esm/components/Table/hooks/useTableToolbar.d.ts +78 -0
  497. package/dist/esm/components/Table/hooks/useTableToolbar.js +116 -0
  498. package/dist/esm/components/Table/hooks/useTableView.d.ts +24 -0
  499. package/dist/esm/components/Table/hooks/useTableView.js +20 -0
  500. package/dist/esm/components/Table/index.d.ts +2 -0
  501. package/dist/esm/components/Table/index.js +2 -0
  502. package/dist/esm/components/Table/styles.module.css +578 -0
  503. package/dist/esm/components/Table/utils/columnSize.d.ts +12 -0
  504. package/dist/esm/components/Table/utils/columnSize.js +20 -0
  505. package/dist/esm/components/Table/utils/getColumnIdentifier.d.ts +2 -0
  506. package/dist/esm/components/Table/utils/getColumnIdentifier.js +6 -0
  507. package/dist/esm/components/Table/utils/getColumnStyleVars.d.ts +4 -0
  508. package/dist/esm/components/Table/utils/getColumnStyleVars.js +7 -0
  509. package/dist/esm/components/Table/utils/getCurrentlyConfiguredHeaderWidth.d.ts +1 -0
  510. package/dist/esm/components/Table/utils/getCurrentlyConfiguredHeaderWidth.js +17 -0
  511. package/dist/esm/components/Table/utils/getPinnedGroups.d.ts +11 -0
  512. package/dist/esm/components/Table/utils/getPinnedGroups.js +23 -0
  513. package/dist/esm/components/Table/utils/getTableColumnsDefinitions.d.ts +18 -0
  514. package/dist/esm/components/Table/utils/getTableColumnsDefinitions.js +24 -0
  515. package/dist/esm/components/Table/utils/index.d.ts +8 -0
  516. package/dist/esm/components/Table/utils/index.js +8 -0
  517. package/dist/esm/components/Table/utils/isEveryArrayItemString.d.ts +1 -0
  518. package/dist/esm/components/Table/utils/isEveryArrayItemString.js +1 -0
  519. package/dist/esm/components/Table/utils/saveTableState/mappers.d.ts +18 -0
  520. package/dist/esm/components/Table/utils/saveTableState/mappers.js +37 -0
  521. package/dist/esm/components/Table/utils/saveTableState/validators.d.ts +5 -0
  522. package/dist/esm/components/Table/utils/saveTableState/validators.js +18 -0
  523. package/dist/esm/components/Table/utils/sortColumnDefinitions.d.ts +2 -0
  524. package/dist/esm/components/Table/utils/sortColumnDefinitions.js +8 -0
  525. package/dist/esm/components/index.d.ts +3 -0
  526. package/dist/esm/components/index.js +3 -0
  527. package/dist/esm/components/types.d.ts +395 -0
  528. package/dist/esm/components/types.js +25 -0
  529. package/dist/esm/constants.d.ts +113 -0
  530. package/dist/esm/constants.js +114 -0
  531. package/dist/esm/contexts/CellAutoResizeContext/CellAutoResizeContext.d.ts +2 -0
  532. package/dist/esm/contexts/CellAutoResizeContext/CellAutoResizeContext.js +5 -0
  533. package/dist/esm/contexts/CellAutoResizeContext/hooks/index.d.ts +2 -0
  534. package/dist/esm/contexts/CellAutoResizeContext/hooks/index.js +2 -0
  535. package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.d.ts +6 -0
  536. package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.js +37 -0
  537. package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellResize.d.ts +4 -0
  538. package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellResize.js +19 -0
  539. package/dist/esm/contexts/CellAutoResizeContext/index.d.ts +2 -0
  540. package/dist/esm/contexts/CellAutoResizeContext/index.js +2 -0
  541. package/dist/esm/contexts/CellAutoResizeContext/types.d.ts +15 -0
  542. package/dist/esm/contexts/CellAutoResizeContext/types.js +1 -0
  543. package/dist/esm/contexts/RowContext/RowContext.d.ts +10 -0
  544. package/dist/esm/contexts/RowContext/RowContext.js +8 -0
  545. package/dist/esm/contexts/RowContext/index.d.ts +1 -0
  546. package/dist/esm/contexts/RowContext/index.js +1 -0
  547. package/dist/esm/contexts/TableContext/TableContext.d.ts +28 -0
  548. package/dist/esm/contexts/TableContext/TableContext.js +13 -0
  549. package/dist/esm/contexts/TableContext/index.d.ts +1 -0
  550. package/dist/esm/contexts/TableContext/index.js +1 -0
  551. package/dist/esm/contexts/index.d.ts +4 -0
  552. package/dist/esm/contexts/index.js +4 -0
  553. package/dist/esm/helperComponents/Cells/BodyCell/BodyCell.d.ts +9 -0
  554. package/dist/esm/helperComponents/Cells/BodyCell/BodyCell.js +27 -0
  555. package/dist/esm/helperComponents/Cells/BodyCell/index.d.ts +1 -0
  556. package/dist/esm/helperComponents/Cells/BodyCell/index.js +1 -0
  557. package/dist/esm/helperComponents/Cells/BodyCell/styles.module.css +15 -0
  558. package/dist/esm/helperComponents/Cells/Cell.d.ts +18 -0
  559. package/dist/esm/helperComponents/Cells/Cell.js +5 -0
  560. package/dist/esm/helperComponents/Cells/CopyCell/CopyCell.d.ts +4 -0
  561. package/dist/esm/helperComponents/Cells/CopyCell/CopyCell.js +26 -0
  562. package/dist/esm/helperComponents/Cells/CopyCell/index.d.ts +1 -0
  563. package/dist/esm/helperComponents/Cells/CopyCell/index.js +1 -0
  564. package/dist/esm/helperComponents/Cells/CopyCell/styles.module.css +39 -0
  565. package/dist/esm/helperComponents/Cells/HeaderCell/HeaderCell.d.ts +11 -0
  566. package/dist/esm/helperComponents/Cells/HeaderCell/HeaderCell.js +43 -0
  567. package/dist/esm/helperComponents/Cells/HeaderCell/ResizeHandle.d.ts +8 -0
  568. package/dist/esm/helperComponents/Cells/HeaderCell/ResizeHandle.js +35 -0
  569. package/dist/esm/helperComponents/Cells/HeaderCell/helpers.d.ts +4 -0
  570. package/dist/esm/helperComponents/Cells/HeaderCell/helpers.js +15 -0
  571. package/dist/esm/helperComponents/Cells/HeaderCell/index.d.ts +1 -0
  572. package/dist/esm/helperComponents/Cells/HeaderCell/index.js +1 -0
  573. package/dist/esm/helperComponents/Cells/HeaderCell/styles.module.css +149 -0
  574. package/dist/esm/helperComponents/Cells/RowActionsCell/RowActionsCell.d.ts +12 -0
  575. package/dist/esm/helperComponents/Cells/RowActionsCell/RowActionsCell.js +57 -0
  576. package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.d.ts +8 -0
  577. package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +17 -0
  578. package/dist/esm/helperComponents/Cells/RowActionsCell/components/index.d.ts +1 -0
  579. package/dist/esm/helperComponents/Cells/RowActionsCell/components/index.js +1 -0
  580. package/dist/esm/helperComponents/Cells/RowActionsCell/index.d.ts +1 -0
  581. package/dist/esm/helperComponents/Cells/RowActionsCell/index.js +1 -0
  582. package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +23 -0
  583. package/dist/esm/helperComponents/Cells/SelectionCell/SelectionCell.d.ts +3 -0
  584. package/dist/esm/helperComponents/Cells/SelectionCell/SelectionCell.js +86 -0
  585. package/dist/esm/helperComponents/Cells/SelectionCell/index.d.ts +1 -0
  586. package/dist/esm/helperComponents/Cells/SelectionCell/index.js +1 -0
  587. package/dist/esm/helperComponents/Cells/SelectionCell/styles.module.css +15 -0
  588. package/dist/esm/helperComponents/Cells/StatusCell/StatusCell.d.ts +39 -0
  589. package/dist/esm/helperComponents/Cells/StatusCell/StatusCell.js +66 -0
  590. package/dist/esm/helperComponents/Cells/StatusCell/constants.d.ts +13 -0
  591. package/dist/esm/helperComponents/Cells/StatusCell/constants.js +15 -0
  592. package/dist/esm/helperComponents/Cells/StatusCell/index.d.ts +1 -0
  593. package/dist/esm/helperComponents/Cells/StatusCell/index.js +1 -0
  594. package/dist/esm/helperComponents/Cells/StatusCell/styles.module.css +24 -0
  595. package/dist/esm/helperComponents/Cells/StatusCell/types.d.ts +3 -0
  596. package/dist/esm/helperComponents/Cells/StatusCell/types.js +1 -0
  597. package/dist/esm/helperComponents/Cells/TreeCell/TreeCell.d.ts +40 -0
  598. package/dist/esm/helperComponents/Cells/TreeCell/TreeCell.js +163 -0
  599. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/TreeLine.d.ts +9 -0
  600. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/TreeLine.js +6 -0
  601. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/index.d.ts +1 -0
  602. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/index.js +1 -0
  603. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +39 -0
  604. package/dist/esm/helperComponents/Cells/TreeCell/constants.d.ts +1 -0
  605. package/dist/esm/helperComponents/Cells/TreeCell/constants.js +1 -0
  606. package/dist/esm/helperComponents/Cells/TreeCell/index.d.ts +1 -0
  607. package/dist/esm/helperComponents/Cells/TreeCell/index.js +1 -0
  608. package/dist/esm/helperComponents/Cells/TreeCell/rowHierarchicalSelection.d.ts +7 -0
  609. package/dist/esm/helperComponents/Cells/TreeCell/rowHierarchicalSelection.js +38 -0
  610. package/dist/esm/helperComponents/Cells/TreeCell/styles.module.css +112 -0
  611. package/dist/esm/helperComponents/Cells/index.d.ts +8 -0
  612. package/dist/esm/helperComponents/Cells/index.js +8 -0
  613. package/dist/esm/helperComponents/Cells/styles.module.css +13 -0
  614. package/dist/esm/helperComponents/ControlsChrome/ControlsChrome.d.ts +17 -0
  615. package/dist/esm/helperComponents/ControlsChrome/ControlsChrome.js +23 -0
  616. package/dist/esm/helperComponents/ControlsChrome/index.d.ts +1 -0
  617. package/dist/esm/helperComponents/ControlsChrome/index.js +1 -0
  618. package/dist/esm/helperComponents/ControlsChrome/styles.module.css +221 -0
  619. package/dist/esm/helperComponents/LoadMoreButton/LoadMoreButton.d.ts +6 -0
  620. package/dist/esm/helperComponents/LoadMoreButton/LoadMoreButton.js +12 -0
  621. package/dist/esm/helperComponents/LoadMoreButton/index.d.ts +2 -0
  622. package/dist/esm/helperComponents/LoadMoreButton/index.js +1 -0
  623. package/dist/esm/helperComponents/LoadMoreButton/styles.module.css +6 -0
  624. package/dist/esm/helperComponents/Rows/BodyRow.d.ts +20 -0
  625. package/dist/esm/helperComponents/Rows/BodyRow.js +31 -0
  626. package/dist/esm/helperComponents/Rows/HeaderRow.d.ts +10 -0
  627. package/dist/esm/helperComponents/Rows/HeaderRow.js +21 -0
  628. package/dist/esm/helperComponents/Rows/PinnedCells.d.ts +9 -0
  629. package/dist/esm/helperComponents/Rows/PinnedCells.js +6 -0
  630. package/dist/esm/helperComponents/Rows/Row.d.ts +12 -0
  631. package/dist/esm/helperComponents/Rows/Row.js +17 -0
  632. package/dist/esm/helperComponents/Rows/index.d.ts +2 -0
  633. package/dist/esm/helperComponents/Rows/index.js +2 -0
  634. package/dist/esm/helperComponents/Rows/styles.module.css +229 -0
  635. package/dist/esm/helperComponents/TableCard/TableCard.d.ts +28 -0
  636. package/dist/esm/helperComponents/TableCard/TableCard.js +74 -0
  637. package/dist/esm/helperComponents/TableCard/index.d.ts +1 -0
  638. package/dist/esm/helperComponents/TableCard/index.js +1 -0
  639. package/dist/esm/helperComponents/TableCard/styles.module.css +63 -0
  640. package/dist/esm/helperComponents/TableEmptyState/TableEmptyState.d.ts +13 -0
  641. package/dist/esm/helperComponents/TableEmptyState/TableEmptyState.js +9 -0
  642. package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +10 -0
  643. package/dist/esm/helperComponents/TableEmptyState/hooks.js +31 -0
  644. package/dist/esm/helperComponents/TableEmptyState/index.d.ts +2 -0
  645. package/dist/esm/helperComponents/TableEmptyState/index.js +2 -0
  646. package/dist/esm/helperComponents/TableEmptyState/styles.module.css +11 -0
  647. package/dist/esm/helperComponents/TablePagination/TablePagination.d.ts +9 -0
  648. package/dist/esm/helperComponents/TablePagination/TablePagination.js +28 -0
  649. package/dist/esm/helperComponents/TablePagination/index.d.ts +1 -0
  650. package/dist/esm/helperComponents/TablePagination/index.js +1 -0
  651. package/dist/esm/helperComponents/TablePagination/styles.module.css +14 -0
  652. package/dist/esm/helperComponents/index.d.ts +8 -0
  653. package/dist/esm/helperComponents/index.js +8 -0
  654. package/dist/esm/helperComponents/types.d.ts +7 -0
  655. package/dist/esm/helperComponents/types.js +1 -0
  656. package/dist/esm/helpers/getColumnId.d.ts +2 -0
  657. package/dist/esm/helpers/getColumnId.js +9 -0
  658. package/dist/esm/helpers/index.d.ts +9 -0
  659. package/dist/esm/helpers/index.js +9 -0
  660. package/dist/esm/helpers/masterSelection.d.ts +15 -0
  661. package/dist/esm/helpers/masterSelection.js +26 -0
  662. package/dist/esm/helpers/renderColumnsSettingsOverflowButton.d.ts +7 -0
  663. package/dist/esm/helpers/renderColumnsSettingsOverflowButton.js +12 -0
  664. package/dist/esm/helpers/renderExportToolbarButton.d.ts +8 -0
  665. package/dist/esm/helpers/renderExportToolbarButton.js +18 -0
  666. package/dist/esm/helpers/renderMasterSelectionToggle.d.ts +10 -0
  667. package/dist/esm/helpers/renderMasterSelectionToggle.js +17 -0
  668. package/dist/esm/helpers/renderTableSortingOverflowButton.d.ts +9 -0
  669. package/dist/esm/helpers/renderTableSortingOverflowButton.js +17 -0
  670. package/dist/esm/helpers/renderToolbarAfterOverflowButton.d.ts +9 -0
  671. package/dist/esm/helpers/renderToolbarAfterOverflowButton.js +6 -0
  672. package/dist/esm/helpers/rowSelectionState.d.ts +3 -0
  673. package/dist/esm/helpers/rowSelectionState.js +9 -0
  674. package/dist/esm/helpers/toolbarTooltipTrigger.module.css +5 -0
  675. package/dist/esm/helpers/tryParseLocalStorage.d.ts +2 -0
  676. package/dist/esm/helpers/tryParseLocalStorage.js +13 -0
  677. package/dist/esm/hooks/index.d.ts +7 -0
  678. package/dist/esm/hooks/index.js +7 -0
  679. package/dist/esm/hooks/useCellSizes.d.ts +10 -0
  680. package/dist/esm/hooks/useCellSizes.js +31 -0
  681. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/index.d.ts +1 -0
  682. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/index.js +1 -0
  683. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.d.ts +17 -0
  684. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +84 -0
  685. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.css +13 -0
  686. package/dist/esm/hooks/useExportToolbarSlot/index.d.ts +1 -0
  687. package/dist/esm/hooks/useExportToolbarSlot/index.js +1 -0
  688. package/dist/esm/hooks/useExportToolbarSlot/useExportToolbarSlot.d.ts +10 -0
  689. package/dist/esm/hooks/useExportToolbarSlot/useExportToolbarSlot.js +19 -0
  690. package/dist/esm/hooks/useHeaderGroups.d.ts +10 -0
  691. package/dist/esm/hooks/useHeaderGroups.js +37 -0
  692. package/dist/esm/hooks/useRowCells.d.ts +10 -0
  693. package/dist/esm/hooks/useRowCells.js +28 -0
  694. package/dist/esm/hooks/useTableSorting/index.d.ts +1 -0
  695. package/dist/esm/hooks/useTableSorting/index.js +1 -0
  696. package/dist/esm/hooks/useTableSorting/useTableSorting.d.ts +25 -0
  697. package/dist/esm/hooks/useTableSorting/useTableSorting.js +191 -0
  698. package/dist/esm/hooks/useTableSorting/useTableSorting.module.css +3 -0
  699. package/dist/esm/hooks/useTableSorting/utils.d.ts +16 -0
  700. package/dist/esm/hooks/useTableSorting/utils.js +77 -0
  701. package/dist/esm/hooks/useTableSortingToolbarSlot/index.d.ts +1 -0
  702. package/dist/esm/hooks/useTableSortingToolbarSlot/index.js +1 -0
  703. package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.d.ts +24 -0
  704. package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +51 -0
  705. package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.css +8 -0
  706. package/dist/esm/index.d.ts +20 -0
  707. package/dist/esm/index.js +15 -0
  708. package/dist/esm/locale/index.d.ts +107 -0
  709. package/dist/esm/locale/index.js +55 -0
  710. package/dist/esm/presets/adminTable/AdminTable.d.ts +4 -0
  711. package/dist/esm/presets/adminTable/AdminTable.js +8 -0
  712. package/dist/esm/presets/adminTable/index.d.ts +4 -0
  713. package/dist/esm/presets/adminTable/index.js +3 -0
  714. package/dist/esm/presets/adminTable/toAdminTableProps.d.ts +31 -0
  715. package/dist/esm/presets/adminTable/toAdminTableProps.js +54 -0
  716. package/dist/esm/presets/adminTable/useAdminTableProps.d.ts +5 -0
  717. package/dist/esm/presets/adminTable/useAdminTableProps.js +22 -0
  718. package/dist/esm/presets/constants.d.ts +3 -0
  719. package/dist/esm/presets/constants.js +3 -0
  720. package/dist/esm/presets/entitiesTable/EntitiesTable.d.ts +9 -0
  721. package/dist/esm/presets/entitiesTable/EntitiesTable.js +75 -0
  722. package/dist/esm/presets/entitiesTable/constants.d.ts +1 -0
  723. package/dist/esm/presets/entitiesTable/constants.js +1 -0
  724. package/dist/esm/presets/entitiesTable/index.d.ts +7 -0
  725. package/dist/esm/presets/entitiesTable/index.js +6 -0
  726. package/dist/esm/presets/entitiesTable/toEntitiesTableProps.d.ts +13 -0
  727. package/dist/esm/presets/entitiesTable/toEntitiesTableProps.js +55 -0
  728. package/dist/esm/presets/entitiesTable/types.d.ts +55 -0
  729. package/dist/esm/presets/entitiesTable/types.js +1 -0
  730. package/dist/esm/presets/entitiesTable/useEntitiesTableProps.d.ts +13 -0
  731. package/dist/esm/presets/entitiesTable/useEntitiesTableProps.js +6 -0
  732. package/dist/esm/presets/entitiesTable/useEntitiesTableState.d.ts +3 -0
  733. package/dist/esm/presets/entitiesTable/useEntitiesTableState.js +39 -0
  734. package/dist/esm/presets/entitiesTable/utils.d.ts +9 -0
  735. package/dist/esm/presets/entitiesTable/utils.js +19 -0
  736. package/dist/esm/presets/index.d.ts +7 -0
  737. package/dist/esm/presets/index.js +7 -0
  738. package/dist/esm/presets/infiniteTable/InfiniteTable.d.ts +3 -0
  739. package/dist/esm/presets/infiniteTable/InfiniteTable.js +8 -0
  740. package/dist/esm/presets/infiniteTable/index.d.ts +5 -0
  741. package/dist/esm/presets/infiniteTable/index.js +4 -0
  742. package/dist/esm/presets/infiniteTable/toInfiniteTableProps.d.ts +11 -0
  743. package/dist/esm/presets/infiniteTable/toInfiniteTableProps.js +17 -0
  744. package/dist/esm/presets/infiniteTable/useInfiniteScrollRef.d.ts +17 -0
  745. package/dist/esm/presets/infiniteTable/useInfiniteScrollRef.js +26 -0
  746. package/dist/esm/presets/infiniteTable/useInfiniteTableProps.d.ts +4 -0
  747. package/dist/esm/presets/infiniteTable/useInfiniteTableProps.js +23 -0
  748. package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
  749. package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +8 -0
  750. package/dist/esm/presets/serverAdminTable/index.d.ts +4 -0
  751. package/dist/esm/presets/serverAdminTable/index.js +3 -0
  752. package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
  753. package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +22 -0
  754. package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
  755. package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +22 -0
  756. package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
  757. package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +8 -0
  758. package/dist/esm/presets/serverSimpleTable/index.d.ts +4 -0
  759. package/dist/esm/presets/serverSimpleTable/index.js +3 -0
  760. package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
  761. package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +22 -0
  762. package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
  763. package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +18 -0
  764. package/dist/esm/presets/simpleTable/SimpleTable.d.ts +3 -0
  765. package/dist/esm/presets/simpleTable/SimpleTable.js +8 -0
  766. package/dist/esm/presets/simpleTable/index.d.ts +4 -0
  767. package/dist/esm/presets/simpleTable/index.js +3 -0
  768. package/dist/esm/presets/simpleTable/toSimpleTableProps.d.ts +15 -0
  769. package/dist/esm/presets/simpleTable/toSimpleTableProps.js +18 -0
  770. package/dist/esm/presets/simpleTable/useSimpleTableProps.d.ts +4 -0
  771. package/dist/esm/presets/simpleTable/useSimpleTableProps.js +18 -0
  772. package/dist/esm/presets/treeTable/TreeTable.d.ts +3 -0
  773. package/dist/esm/presets/treeTable/TreeTable.js +8 -0
  774. package/dist/esm/presets/treeTable/index.d.ts +4 -0
  775. package/dist/esm/presets/treeTable/index.js +3 -0
  776. package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +34 -0
  777. package/dist/esm/presets/treeTable/toTreeTableProps.js +54 -0
  778. package/dist/esm/presets/treeTable/useTreeTableProps.d.ts +4 -0
  779. package/dist/esm/presets/treeTable/useTreeTableProps.js +15 -0
  780. package/dist/esm/presets/wrapGetRowId.d.ts +2 -0
  781. package/dist/esm/presets/wrapGetRowId.js +7 -0
  782. package/dist/esm/style.css +1580 -0
  783. package/dist/esm/types.d.ts +59 -0
  784. package/dist/esm/types.js +1 -0
  785. package/dist/esm/utils.d.ts +2 -0
  786. package/dist/esm/utils.js +9 -0
  787. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  788. package/dist/tsconfig.esm.tsbuildinfo +1 -0
  789. package/package.json +74 -0
  790. package/src/columnUtils/actionsColumn.ts +17 -0
  791. package/src/columnUtils/defineColumns.ts +79 -0
  792. package/src/columnUtils/index.ts +8 -0
  793. package/src/columnUtils/mapCardViewProps.ts +51 -0
  794. package/src/columnUtils/statusColumn.ts +47 -0
  795. package/src/components/ServerTable/ServerTable.tsx +94 -0
  796. package/src/components/ServerTable/constants.ts +3 -0
  797. package/src/components/ServerTable/index.ts +1 -0
  798. package/src/components/Table/STRUCTURE.md +119 -0
  799. package/src/components/Table/Table.tsx +756 -0
  800. package/src/components/Table/components/TableCardsBody/TableCardsBody.tsx +117 -0
  801. package/src/components/Table/components/TableCardsBody/index.ts +1 -0
  802. package/src/components/Table/components/TableChrome/TableChrome.tsx +32 -0
  803. package/src/components/Table/components/TableChrome/index.ts +1 -0
  804. package/src/components/Table/components/TableRowsBody/TableRowsBody.tsx +118 -0
  805. package/src/components/Table/components/TableRowsBody/index.ts +1 -0
  806. package/src/components/Table/components/TableScrollHost/TableScrollHost.tsx +92 -0
  807. package/src/components/Table/components/TableScrollHost/index.ts +1 -0
  808. package/src/components/Table/components/TableSkeletonBody/TableSkeletonBody.tsx +82 -0
  809. package/src/components/Table/components/TableSkeletonBody/index.ts +1 -0
  810. package/src/components/Table/components/TableToolbar/TableToolbar.tsx +72 -0
  811. package/src/components/Table/components/TableToolbar/index.ts +1 -0
  812. package/src/components/Table/hooks/index.ts +13 -0
  813. package/src/components/Table/hooks/loadingTableCells.tsx +109 -0
  814. package/src/components/Table/hooks/useColumnOrderByDrag/index.ts +1 -0
  815. package/src/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.ts +135 -0
  816. package/src/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.ts +30 -0
  817. package/src/components/Table/hooks/useColumnSettings/index.ts +1 -0
  818. package/src/components/Table/hooks/useColumnSettings/useColumnSettings.ts +174 -0
  819. package/src/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.ts +11 -0
  820. package/src/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.ts +75 -0
  821. package/src/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.ts +36 -0
  822. package/src/components/Table/hooks/useColumnSettings/utils/index.ts +9 -0
  823. package/src/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.ts +13 -0
  824. package/src/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.ts +26 -0
  825. package/src/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.ts +15 -0
  826. package/src/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.ts +19 -0
  827. package/src/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.ts +53 -0
  828. package/src/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.ts +34 -0
  829. package/src/components/Table/hooks/useColumnSizes.ts +190 -0
  830. package/src/components/Table/hooks/useColumnVirtualizer.ts +69 -0
  831. package/src/components/Table/hooks/useFilters/index.ts +1 -0
  832. package/src/components/Table/hooks/useFilters/useFilters.ts +67 -0
  833. package/src/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.ts +13 -0
  834. package/src/components/Table/hooks/useFilters/utils/index.ts +1 -0
  835. package/src/components/Table/hooks/useLoadingTable.tsx +86 -0
  836. package/src/components/Table/hooks/usePageReset.ts +30 -0
  837. package/src/components/Table/hooks/useRowVirtualizer.ts +37 -0
  838. package/src/components/Table/hooks/useStateControl.ts +29 -0
  839. package/src/components/Table/hooks/useTableInstance.tsx +271 -0
  840. package/src/components/Table/hooks/useTableScroll.ts +176 -0
  841. package/src/components/Table/hooks/useTableToolbar.ts +265 -0
  842. package/src/components/Table/hooks/useTableView.ts +42 -0
  843. package/src/components/Table/index.ts +2 -0
  844. package/src/components/Table/styles.module.scss +510 -0
  845. package/src/components/Table/utils/columnSize.ts +44 -0
  846. package/src/components/Table/utils/getColumnIdentifier.ts +9 -0
  847. package/src/components/Table/utils/getColumnStyleVars.ts +11 -0
  848. package/src/components/Table/utils/getCurrentlyConfiguredHeaderWidth.ts +24 -0
  849. package/src/components/Table/utils/getPinnedGroups.ts +37 -0
  850. package/src/components/Table/utils/getTableColumnsDefinitions.ts +47 -0
  851. package/src/components/Table/utils/index.ts +8 -0
  852. package/src/components/Table/utils/isEveryArrayItemString.ts +2 -0
  853. package/src/components/Table/utils/saveTableState/mappers.ts +62 -0
  854. package/src/components/Table/utils/saveTableState/validators.ts +33 -0
  855. package/src/components/Table/utils/sortColumnDefinitions.ts +14 -0
  856. package/src/components/index.ts +3 -0
  857. package/src/components/types.ts +450 -0
  858. package/src/constants.ts +131 -0
  859. package/src/contexts/CellAutoResizeContext/CellAutoResizeContext.ts +8 -0
  860. package/src/contexts/CellAutoResizeContext/hooks/index.ts +2 -0
  861. package/src/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.ts +52 -0
  862. package/src/contexts/CellAutoResizeContext/hooks/useCellResize.ts +25 -0
  863. package/src/contexts/CellAutoResizeContext/index.ts +2 -0
  864. package/src/contexts/CellAutoResizeContext/types.ts +22 -0
  865. package/src/contexts/RowContext/RowContext.ts +17 -0
  866. package/src/contexts/RowContext/index.ts +1 -0
  867. package/src/contexts/TableContext/TableContext.ts +39 -0
  868. package/src/contexts/TableContext/index.ts +1 -0
  869. package/src/contexts/index.ts +4 -0
  870. package/src/helperComponents/Cells/BodyCell/BodyCell.tsx +68 -0
  871. package/src/helperComponents/Cells/BodyCell/index.ts +1 -0
  872. package/src/helperComponents/Cells/BodyCell/styles.module.scss +26 -0
  873. package/src/helperComponents/Cells/Cell.tsx +30 -0
  874. package/src/helperComponents/Cells/CopyCell/CopyCell.tsx +53 -0
  875. package/src/helperComponents/Cells/CopyCell/index.ts +1 -0
  876. package/src/helperComponents/Cells/CopyCell/styles.module.scss +53 -0
  877. package/src/helperComponents/Cells/HeaderCell/HeaderCell.tsx +109 -0
  878. package/src/helperComponents/Cells/HeaderCell/ResizeHandle.tsx +73 -0
  879. package/src/helperComponents/Cells/HeaderCell/helpers.tsx +18 -0
  880. package/src/helperComponents/Cells/HeaderCell/index.ts +1 -0
  881. package/src/helperComponents/Cells/HeaderCell/styles.module.scss +192 -0
  882. package/src/helperComponents/Cells/RowActionsCell/RowActionsCell.tsx +111 -0
  883. package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +36 -0
  884. package/src/helperComponents/Cells/RowActionsCell/components/index.ts +1 -0
  885. package/src/helperComponents/Cells/RowActionsCell/index.ts +1 -0
  886. package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +29 -0
  887. package/src/helperComponents/Cells/SelectionCell/SelectionCell.tsx +115 -0
  888. package/src/helperComponents/Cells/SelectionCell/index.ts +1 -0
  889. package/src/helperComponents/Cells/SelectionCell/styles.module.scss +39 -0
  890. package/src/helperComponents/Cells/StatusCell/StatusCell.tsx +157 -0
  891. package/src/helperComponents/Cells/StatusCell/constants.ts +16 -0
  892. package/src/helperComponents/Cells/StatusCell/index.ts +1 -0
  893. package/src/helperComponents/Cells/StatusCell/styles.module.scss +35 -0
  894. package/src/helperComponents/Cells/StatusCell/types.ts +5 -0
  895. package/src/helperComponents/Cells/TreeCell/TreeCell.tsx +374 -0
  896. package/src/helperComponents/Cells/TreeCell/TreeLine/TreeLine.tsx +24 -0
  897. package/src/helperComponents/Cells/TreeCell/TreeLine/index.ts +1 -0
  898. package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +68 -0
  899. package/src/helperComponents/Cells/TreeCell/constants.ts +1 -0
  900. package/src/helperComponents/Cells/TreeCell/index.ts +1 -0
  901. package/src/helperComponents/Cells/TreeCell/rowHierarchicalSelection.ts +51 -0
  902. package/src/helperComponents/Cells/TreeCell/styles.module.scss +194 -0
  903. package/src/helperComponents/Cells/index.ts +8 -0
  904. package/src/helperComponents/Cells/styles.module.scss +13 -0
  905. package/src/helperComponents/ControlsChrome/ControlsChrome.tsx +51 -0
  906. package/src/helperComponents/ControlsChrome/index.ts +1 -0
  907. package/src/helperComponents/ControlsChrome/styles.module.scss +25 -0
  908. package/src/helperComponents/LoadMoreButton/LoadMoreButton.tsx +34 -0
  909. package/src/helperComponents/LoadMoreButton/index.ts +2 -0
  910. package/src/helperComponents/LoadMoreButton/styles.module.scss +9 -0
  911. package/src/helperComponents/Rows/BodyRow.tsx +117 -0
  912. package/src/helperComponents/Rows/HeaderRow.tsx +102 -0
  913. package/src/helperComponents/Rows/PinnedCells.tsx +18 -0
  914. package/src/helperComponents/Rows/Row.tsx +46 -0
  915. package/src/helperComponents/Rows/index.ts +2 -0
  916. package/src/helperComponents/Rows/styles.module.scss +314 -0
  917. package/src/helperComponents/TableCard/TableCard.tsx +167 -0
  918. package/src/helperComponents/TableCard/index.ts +1 -0
  919. package/src/helperComponents/TableCard/styles.module.scss +67 -0
  920. package/src/helperComponents/TableEmptyState/TableEmptyState.tsx +30 -0
  921. package/src/helperComponents/TableEmptyState/hooks.ts +50 -0
  922. package/src/helperComponents/TableEmptyState/index.ts +2 -0
  923. package/src/helperComponents/TableEmptyState/styles.module.scss +16 -0
  924. package/src/helperComponents/TablePagination/TablePagination.tsx +83 -0
  925. package/src/helperComponents/TablePagination/index.ts +1 -0
  926. package/src/helperComponents/TablePagination/styles.module.scss +23 -0
  927. package/src/helperComponents/index.ts +8 -0
  928. package/src/helperComponents/types.ts +10 -0
  929. package/src/helpers/getColumnId.ts +13 -0
  930. package/src/helpers/index.ts +9 -0
  931. package/src/helpers/masterSelection.ts +39 -0
  932. package/src/helpers/renderColumnsSettingsOverflowButton.tsx +22 -0
  933. package/src/helpers/renderExportToolbarButton.tsx +43 -0
  934. package/src/helpers/renderMasterSelectionToggle.tsx +38 -0
  935. package/src/helpers/renderTableSortingOverflowButton.tsx +33 -0
  936. package/src/helpers/renderToolbarAfterOverflowButton.tsx +30 -0
  937. package/src/helpers/rowSelectionState.ts +13 -0
  938. package/src/helpers/toolbarTooltipTrigger.module.scss +5 -0
  939. package/src/helpers/tryParseLocalStorage.ts +14 -0
  940. package/src/hooks/index.ts +7 -0
  941. package/src/hooks/useCellSizes.ts +48 -0
  942. package/src/hooks/useColumnsSettingsToolbarSlot/index.ts +1 -0
  943. package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.scss +18 -0
  944. package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +169 -0
  945. package/src/hooks/useExportToolbarSlot/index.ts +1 -0
  946. package/src/hooks/useExportToolbarSlot/useExportToolbarSlot.tsx +33 -0
  947. package/src/hooks/useHeaderGroups.ts +45 -0
  948. package/src/hooks/useRowCells.ts +34 -0
  949. package/src/hooks/useTableSorting/index.ts +1 -0
  950. package/src/hooks/useTableSorting/useTableSorting.module.scss +8 -0
  951. package/src/hooks/useTableSorting/useTableSorting.tsx +272 -0
  952. package/src/hooks/useTableSorting/utils.ts +107 -0
  953. package/src/hooks/useTableSortingToolbarSlot/index.ts +1 -0
  954. package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.scss +13 -0
  955. package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +116 -0
  956. package/src/index.ts +39 -0
  957. package/src/locale/index.ts +59 -0
  958. package/src/presets/adminTable/AdminTable.tsx +14 -0
  959. package/src/presets/adminTable/index.ts +4 -0
  960. package/src/presets/adminTable/toAdminTableProps.ts +140 -0
  961. package/src/presets/adminTable/useAdminTableProps.ts +35 -0
  962. package/src/presets/constants.ts +5 -0
  963. package/src/presets/entitiesTable/EntitiesTable.tsx +115 -0
  964. package/src/presets/entitiesTable/constants.ts +1 -0
  965. package/src/presets/entitiesTable/index.ts +18 -0
  966. package/src/presets/entitiesTable/toEntitiesTableProps.ts +76 -0
  967. package/src/presets/entitiesTable/types.ts +86 -0
  968. package/src/presets/entitiesTable/useEntitiesTableProps.ts +28 -0
  969. package/src/presets/entitiesTable/useEntitiesTableState.ts +59 -0
  970. package/src/presets/entitiesTable/utils.ts +36 -0
  971. package/src/presets/index.ts +7 -0
  972. package/src/presets/infiniteTable/InfiniteTable.tsx +10 -0
  973. package/src/presets/infiniteTable/index.ts +5 -0
  974. package/src/presets/infiniteTable/toInfiniteTableProps.ts +47 -0
  975. package/src/presets/infiniteTable/useInfiniteScrollRef.ts +49 -0
  976. package/src/presets/infiniteTable/useInfiniteTableProps.ts +33 -0
  977. package/src/presets/serverAdminTable/ServerAdminTable.tsx +14 -0
  978. package/src/presets/serverAdminTable/index.ts +4 -0
  979. package/src/presets/serverAdminTable/toServerAdminTableProps.ts +44 -0
  980. package/src/presets/serverAdminTable/useServerAdminTableProps.ts +35 -0
  981. package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +10 -0
  982. package/src/presets/serverSimpleTable/index.ts +4 -0
  983. package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +56 -0
  984. package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +27 -0
  985. package/src/presets/simpleTable/SimpleTable.tsx +10 -0
  986. package/src/presets/simpleTable/index.ts +4 -0
  987. package/src/presets/simpleTable/toSimpleTableProps.ts +46 -0
  988. package/src/presets/simpleTable/useSimpleTableProps.ts +25 -0
  989. package/src/presets/treeTable/TreeTable.tsx +10 -0
  990. package/src/presets/treeTable/index.ts +4 -0
  991. package/src/presets/treeTable/toTreeTableProps.ts +124 -0
  992. package/src/presets/treeTable/useTreeTableProps.ts +21 -0
  993. package/src/presets/wrapGetRowId.ts +8 -0
  994. package/src/types.ts +112 -0
  995. package/src/utils.ts +13 -0
package/README.md ADDED
@@ -0,0 +1,2471 @@
1
+ # Table
2
+
3
+ `@cloud-ru/ds-table` — Таблица данных: клиентская Table, серверная ServerTable и preset-обёртки с упрощённым API.
4
+
5
+ Пакет `@cloud-ru/ds-table` предоставляет таблицы поверх `@tanstack/react-table`: полнофункциональные `Table` / `ServerTable` и preset-обёртки с упрощённым API.
6
+
7
+ ## Установка
8
+
9
+ ```bash
10
+ pnpm add @cloud-ru/ds-table
11
+ ```
12
+
13
+ ```ts
14
+ import { Table, ServerTable, SimpleTable, defineColumns } from '@cloud-ru/ds-table';
15
+ ```
16
+
17
+ ## Смотри также
18
+
19
+ - **Pagination** — отдельный компонент пагинации.
20
+ - **InfoBlock** — основа пустых состояний таблицы.
21
+ - **Card** — самостоятельные карточки вне таблицы.
22
+ ## Архитектура пакета
23
+
24
+ ```mermaid
25
+ flowchart TB
26
+ subgraph public [Публичный API]
27
+ direction LR
28
+ defineColumns[defineColumns]
29
+ statusColumn[statusColumn]
30
+ actionsColumn[actionsColumn]
31
+ end
32
+
33
+ subgraph hooks [Хуки]
34
+ useSimple[useSimpleTableProps]
35
+ useAdmin[useAdminTableProps]
36
+ useTree[useTreeTableProps]
37
+ useInfinite[useInfiniteTableProps]
38
+ useEntities[useEntitiesTableProps]
39
+ end
40
+
41
+ subgraph presets [Preset-компоненты]
42
+ SimpleTable
43
+ ServerSimpleTable
44
+ AdminTable
45
+ ServerAdminTable
46
+ EntitiesTable
47
+ TreeTable
48
+ InfiniteTable
49
+ end
50
+
51
+ subgraph core [Core]
52
+ direction LR
53
+ Table
54
+ ServerTable
55
+ end
56
+
57
+ public -.->|columnDefinitions| Table
58
+ useSimple --> SimpleTable
59
+ useAdmin --> AdminTable
60
+ useTree --> TreeTable
61
+ useInfinite --> InfiniteTable
62
+ useEntities --> EntitiesTable
63
+ SimpleTable --> Table
64
+ ServerSimpleTable --> ServerTable
65
+ AdminTable --> Table
66
+ ServerAdminTable --> ServerTable
67
+ EntitiesTable --> ServerTable
68
+ TreeTable --> Table
69
+ InfiniteTable --> Table
70
+ ServerTable --> Table
71
+ ```
72
+
73
+ `defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые пропсы (`columns`, `statusColumn`, `rowActions` в `AdminTable`).
74
+
75
+ `ServerTable` — обёртка над `Table` для серверной пагинации, сортировки и фильтрации.
76
+
77
+ ## Какой сценарий выбрать
78
+
79
+ ### Компоненты
80
+
81
+ | Сценарий
82
+
83
+ ### Утилиты
84
+
85
+ | Сценарий | Утилита |
86
+ | ----------------------- | --------------------------------------------------- |
87
+ | Декларативные колонки | **`defineColumns`** |
88
+ | Колонка статуса | `statusColumn` |
89
+ | Колонка действий строки | `actionsColumn` |
90
+
91
+ Каждый preset доступен в двух формах: **компонент** (`<SimpleTable />`) и **хук** (`useSimpleTableProps()` + `<Table />`).
92
+
93
+ Карточный режим (`headlineKey`, `defaultView`, `view`) — сквозная опция всех preset-ов, не отдельный компонент.
94
+
95
+ ## Table
96
+
97
+ Клиентская таблица данных: сортировка, поиск, выбор строк, пагинация, дерево, настройка колонок, режим карточек.
98
+
99
+ Клиентская таблица поверх `@tanstack/react-table`: данные передаются целиком, сортировка, поиск и пагинация выполняются локально. Служебные колонки — статус, выбор строки, действия, дерево — собираются готовыми фабриками.
100
+
101
+ Для типовых сценариев есть preset-обёртки с упрощённым API — см. **обзор пакета** и **`defineColumns`**. Для постраничных данных с бэкенда — **`ServerTable`**.
102
+
103
+ ### Когда использовать
104
+
105
+ - Структурированные данные с одинаковым набором полей у каждой записи.
106
+ - Операции над строками: выбор, массовые действия, контекстные действия строки.
107
+ - Сравнение записей по колонкам: сортировка, фильтры, настройка видимости колонок.
108
+
109
+ Когда **не** нужен:
110
+
111
+ - Данные приходят с бэкенда постранично:
112
+ - используйте **`ServerTable`**.
113
+ - Простой справочник без поиска и фильтров:
114
+ - **`SimpleTable`** вместо ручной сборки `columnDefinitions`.
115
+ - Типичный админ-экран (поиск, статус, выбор, действия):
116
+ - **`AdminTable`** вместо полного `Table`.
117
+ - Простой список без колонок и сортировки:
118
+ - используйте список или карточки.
119
+
120
+ Рекомендации:
121
+
122
+ - ✅ Задавать `getRowId` по стабильному идентификатору данных при включённом выборе строк.
123
+ - ❌ Полагаться на индекс строки — при сортировке и фильтрации выбор переходит на другие записи.
124
+
125
+ - ✅ Для постраничных данных с бэкенда использовать **`ServerTable`** с `onChangePage`.
126
+ - ❌ Собирать `manualPagination` поверх `Table` вручную — это уже реализовано в `ServerTable`.
127
+
128
+ - ✅ Служебные колонки создавать фабриками `getStatusColumnDef` / `getRowActionsColumnDef` / `getTreeColumnDef`.
129
+ - ❌ Собирать закреплённую колонку статуса вручную — фабрика задаёт ширину, закрепление и отступы по дизайну.
130
+
131
+ - ✅ В режиме карточек передавать `headlineId` — id колонки, чей рендер становится заголовком карточки.
132
+ - ❌ Включать `view='cards'` без `headlineId` — карточки останутся без заголовка.
133
+
134
+ - ✅ Задавать уникальный `savedState.id` для каждой таблицы приложения.
135
+ - ❌ Использовать один id на несколько таблиц — сохранённые состояния перетирают друг друга в localStorage.
136
+
137
+ ### Анатомия
138
+
139
+ #### View (default `table`, на mobile — `cards`)
140
+
141
+ Режим отображения данных (ось `VIEW`):
142
+
143
+ - `table` — классическая сетка со строками и колонками.
144
+ - `cards` — карточки с внешним бордером; заголовок карточки берётся из колонки `headlineId`, при множественном выборе на карточке отображается бэйдж выбора, при одиночном — radio; действия строки доступны на карточке.
145
+
146
+ Начальный вид зависит от раскладки (адаптивный дефолт): `table` на desktop, `cards` на mobile. Явные `defaultView` / `view` перекрывают его.
147
+
148
+ Управление режимом:
149
+
150
+ - `defaultView` — начальный режим для uncontrolled-сценария.
151
+ - `view` + `onViewChange` — управляемый режим.
152
+ - `showDataView` (default `false`) — показывать ли переключатель вида (сегмент-контрол в тулбаре). Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`.
153
+
154
+ Три режима:
155
+
156
+ - **Только таблица / только карточки** (дефолт — тоггла нет) — вид задаётся `defaultView` (или адаптивным дефолтом: desktop `table`, mobile `cards`).
157
+ - **С переключателем** — `showDataView`; пользователь сам переключает table/cards, стартовый вид — `defaultView` / адаптивный дефолт.
158
+
159
+ Для «только таблицы» на mobile учтите адаптивный дефолт (`cards`): нужен `layoutPresets={{ mobile: { defaultView: 'table' } }}`.
160
+
161
+ Поведение в режиме карточек:
162
+
163
+ - `onRowClick` работает в обоих режимах — и в сетке, и на карточках.
164
+ - `suppressHeader` скрывает подписи-заголовки полей карточки.
165
+ - `getRowBackgroundColor` не применяется — карточки не тонируются.
166
+
167
+ #### Колонки (`columnDefinitions`)
168
+
169
+ `ColumnDefinition` — надстройка над `ColumnDef` из `@tanstack/react-table`:
170
+
171
+ - `header` — заголовок колонки (ReactNode или функция от контекста).
172
+ - `align` / `headerAlign` — выравнивание контента ячейки и заголовка (ось `COLUMN_ALIGN`: `left` / `right`).
173
+ - `size` — ширина колонки; меняется перетаскиванием за хэндл на границе заголовков.
174
+ - `pinned` — закрепление колонки (ось `COLUMN_PIN_POSITION`: `left` / `right`); закреплённая колонка обязана иметь `id` и `size`.
175
+ - `cellClassName` / `headerClassName` — CSS-классы ячеек тела и шапки.
176
+ - `noBodyCellPadding` / `noHeaderCellPadding` — отключение паддингов ячейки.
177
+ - `meta.skipOnExport` — пропуск колонки при экспорте.
178
+
179
+ #### Служебные колонки
180
+
181
+ Предопределённые колонки (идентификаторы — в `DefaultColumns`) создаются фабриками:
182
+
183
+ - `getStatusColumnDef` — закреплённая колонка статуса, рисуется компонентом **`Status`** из `@cloud-ru/ds-status` (точка-индикатор + подпись): `mapStatusToAppearance` переводит значение поля в appearance, `renderDescription` задаёт текст подписи. Без `renderDescription` отрисовывается только точка-индикатор.
184
+ - `getSelectionCellColumnDef` — колонка с чекбоксом или radio выбора строки. В мультивыборе мастер-чекбокс «выбрать всё» рендерится в строке заголовков таблицы.
185
+ - `getRowActionsColumnDef` — колонка с кнопкой действий строки; пункты выпадающего списка собирает `actionsGenerator` по данным строки.
186
+ - `getTreeColumnDef` — колонка с chevron раскрытия дерева (передаётся в `expanding.expandingColumnDefinition`).
187
+
188
+ Значения `STATUS_APPEARANCE` для статус-колонки:
189
+
190
+ - `neutral` — нейтральный статус. `primary` — синий акцент (у `@cloud-ru/ds-status` нет appearance `primary`, маппится на `blue`).
191
+ - `red` — ошибка, блокировка.
192
+ - `orange` / `yellow` — предупреждение.
193
+ - `green` — успешное состояние.
194
+ - `blue` / `violet` / `pink` — информационные и категорийные статусы.
195
+ - `loading` — спиннер вместо цветового индикатора.
196
+
197
+ Готовая ячейка `CopyCell` отображает значение с кнопкой копирования.
198
+
199
+ #### Сортировка (`sorting`)
200
+
201
+ - `initialState` — начальное состояние для uncontrolled-сценария.
202
+ - `state` + `onChange` — управляемый режим.
203
+
204
+ Функция сравнения задаётся на колонке через `sortingFn` (ось `SORT_FN`):
205
+
206
+ - `alphanumeric` — строки и числа.
207
+ - `datetime` — даты.
208
+
209
+ Для серверной сортировки — `manualSorting`: таблица не сортирует данные сама, только отдаёт состояние через `onChange`.
210
+
211
+ #### Выбор строк (`rowSelection`)
212
+
213
+ - `multiRow` — множественный выбор чекбоксами; без него — одиночный выбор radio.
214
+ - `enable` — предикат доступности выбора для конкретной строки.
215
+ - `appearance` — вид недоступной для выбора строки (ось `RowAppearance`):
216
+ - `disabled` — заблокированный чекбокс;
217
+ - `hide-toggler` — чекбокс скрыт.
218
+ - `initialState` / `state` + `onChange` — uncontrolled- и controlled-режимы.
219
+
220
+ Bulk-бар в тулбаре (чекбокс «выбрать все» и счётчик выбранных) появляется только при `rowSelection.multiRow`:
221
+
222
+ - `bulkActions` — массовые действия; `onClick` получает `selectionState` и `resetRowSelection`.
223
+ - `toolbarCheckBoxMode` — охват мастер-чекбокса выбора (ось `ToolbarCheckBoxMode`, только клиентская `Table`):
224
+ - `pageRows` — строки текущей страницы;
225
+ - `allRows` — все строки набора `data` (включая другие страницы пагинации).
226
+
227
+ В `view='table'` мастер-чекбокс в заголовке колонки выбора; в `view='cards'` — в bulk-баре тулбара.
228
+
229
+ #### Поиск и фильтры
230
+
231
+ - `search` — глобальный поиск: `initialState` / `state` + `onChange`, `placeholder`, `loading`.
232
+ - `enableFuzzySearch` — нечёткий поиск вместо точного совпадения подстроки.
233
+ - `columnFilters` — строка фильтров-чипов над таблицей (`FilterRow`; `initialOpen` раскрывает её сразу).
234
+ - `dataFiltered` — флаг «данные отфильтрованы снаружи»: при пустых данных показывается `noResultsState`.
235
+ - `manualFiltering` — фильтрация на сервере: таблица не фильтрует данные сама.
236
+
237
+ #### Пагинация (default `pageSize` 10)
238
+
239
+ - `pageSize` — число строк на страницу.
240
+ - `pagination` — `state` + `onChange` (управляемый режим), `options` (варианты числа строк на страницу), `optionsLabel`, `optionsRender`.
241
+ - `suppressPagination` — отключение пагинации.
242
+ - `autoResetPageIndex` — сброс на первую страницу при изменении данных, фильтров или сортировки.
243
+ - `pageCount` — количество страниц при внешнем управлении.
244
+ - `infiniteLoading` — режим «бесконечной» загрузки; взаимоисключающая ветка типа: вместе с ним пропы `pagination` / `suppressPagination` / `toolbarCheckBoxMode` недоступны.
245
+
246
+ #### Дерево (`expanding`)
247
+
248
+ - `getSubRows` — функция получения дочерних строк элемента.
249
+ - `expandingColumnDefinition` — определение колонки с chevron (создаётся `getTreeColumnDef`).
250
+ - `state` + `onChange` — управляемый `ExpandedState`; без них раскрытие живёт во внутреннем состоянии.
251
+
252
+ #### Настройка колонок (`columnsSettings`)
253
+
254
+ - `enableDrag` — переупорядочивание колонок: перетаскивание заголовков в таблице и строк в меню настроек (через `onItemsReorder` у `@cloud-ru/ds-list`). Оба канала пишут в один и тот же `columnOrder`.
255
+ - `enableSettingsMenu` — меню видимости колонок в тулбаре.
256
+
257
+ Поведение колонки в меню задаётся на самой колонке через `columnSettings.mode` (ось `COLUMN_SETTINGS_MODE`):
258
+
259
+ - `locked` — колонка есть в меню, но строка disabled (всегда видима, свитч нельзя выключить).
260
+ - `defaultVisible` — в меню, по умолчанию включена.
261
+ - `defaultHidden` — в меню, по умолчанию выключена.
262
+
263
+ `columnSettings.label` — название колонки в меню настроек. Колонки без `columnSettings` тоже показываются в меню (disabled, label из `header`); исключение — служебные `selection` / `rowActions`.
264
+
265
+ `savedState` сохраняет состояние таблицы в localStorage и query-параметрах: `id` обязан быть уникальным в рамках приложения; `resize` / `columnSettings` включают сохранение ширин и видимости колонок; `serializer` / `parser` / `filterQueryKey` настраивают сериализацию фильтров.
266
+
267
+ #### Цвет строки
268
+
269
+ `getRowBackgroundColor(data)` возвращает цвет фона строки по её данным (ось `TABLE_ROW_COLOR`) или `undefined`:
270
+
271
+ - `red` / `orange` / `yellow` — ошибка и предупреждения.
272
+ - `green` — успешное состояние.
273
+ - `blue` / `violet` / `pink` — категорийная подсветка.
274
+ - `neutral` — нейтральное выделение.
275
+
276
+ Работает только в `view='table'` — карточки не тонируются.
277
+
278
+ #### Пустые состояния и загрузка
279
+
280
+ - `noDataState` — экран при отсутствии данных.
281
+ - `noResultsState` — экран при пустом результате поиска или фильтров.
282
+ - `errorDataState` — экран при ошибке запроса.
283
+ - Все три — `EmptyStateProps` поверх `InfoBlock`.
284
+ - `loading` — skeleton-строки на время загрузки.
285
+ - Флаги `dataFiltered` / `dataError` определяют, какой из экранов показывается при пустых данных.
286
+
287
+ #### Тулбар
288
+
289
+ - `suppressToolbar` — скрыть тулбар целиком.
290
+ - `suppressSearch` — скрыть строку поиска.
291
+ - `suppressHeader` — скрыть шапку таблицы; в режиме карточек — подписи полей карточки.
292
+ - `moreActions` — пункты выпадающего списка кнопки дополнительных действий.
293
+ - `toolbarAfter` — дополнительный слот после строки поиска.
294
+ - `onRefresh` — кнопка обновления данных.
295
+ - `outline` — внешний бордер вокруг тулбара и таблицы.
296
+ - `fullWidth` — растягивание на ширину контейнера (`true` по умолчанию). При `false` на desktop ширина таблицы определяется суммой колонок; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). Лучше всего работает, когда у всех колонок задан `size`. Если нужна fluid-колонка на остаток ширины — оставьте `fullWidth={true}` и не задавайте `size` хотя бы одной колонке.
297
+
298
+ ### Примеры использования
299
+
300
+ {/* client:only='react': SSR демо невозможен — @cloud-ru/ds-list использует в dist directory-imports, которые Node-ESM не резолвит (тот же паттерн, что в @cloud-ru/ds-chips). */}
301
+
302
+ #### Базовая таблица
303
+
304
+ Колонки с выравниванием и форматированием, `outline`, пагинация с выбором числа строк.
305
+
306
+ ```tsx
307
+ import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
308
+
309
+ type User = {
310
+ id: string;
311
+ name: string;
312
+ email: string;
313
+ role: string;
314
+ balance: number;
315
+ };
316
+
317
+ const USERS: User[] = [
318
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
319
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
320
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
321
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
322
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
323
+ { id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', balance: 15600 },
324
+ { id: 'u-7', name: 'Жанна Волкова', email: 'zhanna.volkova@example.com', role: 'Viewer', balance: 2100 },
325
+ { id: 'u-8', name: 'Захар Соколов', email: 'zakhar.sokolov@example.com', role: 'Editor', balance: 7800 },
326
+ ];
327
+
328
+ const balanceFormatter = new Intl.NumberFormat('ru-RU', {
329
+ style: 'currency',
330
+ currency: 'RUB',
331
+ maximumFractionDigits: 0,
332
+ });
333
+
334
+ const columns: ColumnDefinition<User>[] = [
335
+ { accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
336
+ { accessorKey: 'email', header: 'Email', size: 240 },
337
+ { accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
338
+ {
339
+ accessorKey: 'balance',
340
+ header: 'Баланс',
341
+ align: 'right',
342
+ headerAlign: 'right',
343
+ enableSorting: true,
344
+ size: 140,
345
+ cell: ctx => balanceFormatter.format(Number(ctx.getValue() ?? 0)),
346
+ },
347
+ ];
348
+
349
+ export function Basic() {
350
+ return <Table data={USERS} columnDefinitions={columns} pageSize={5} pagination={{ options: [5, 10] }} outline />;
351
+ }
352
+ ```
353
+
354
+ #### Управляемая сортировка
355
+
356
+ `sorting.state` + `onChange`, начальная сортировка по убыванию суммы.
357
+
358
+ ```tsx
359
+ import { ColumnDefinition, SortingState, Table } from '@cloud-ru/ds-table';
360
+ import { useState } from 'react';
361
+
362
+ type User = {
363
+ id: string;
364
+ name: string;
365
+ email: string;
366
+ role: string;
367
+ amount: number;
368
+ };
369
+
370
+ const USERS: User[] = [
371
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', amount: 12990 },
372
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', amount: 8450 },
373
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', amount: 4300 },
374
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', amount: 0 },
375
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', amount: 990 },
376
+ { id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', amount: 15600 },
377
+ ];
378
+
379
+ const columns: ColumnDefinition<User>[] = [
380
+ { accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
381
+ { accessorKey: 'email', header: 'Email', enableSorting: true, size: 260 },
382
+ { accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
383
+ { accessorKey: 'amount', header: 'Баланс', align: 'right', headerAlign: 'right', enableSorting: true, size: 140 },
384
+ ];
385
+
386
+ export function Sorting() {
387
+ const [sorting, setSorting] = useState<SortingState>([{ id: 'amount', desc: true }]);
388
+
389
+ return (
390
+ <Table
391
+ data={USERS}
392
+ columnDefinitions={columns}
393
+ sorting={{ state: sorting, onChange: setSorting }}
394
+ suppressPagination
395
+ outline
396
+ />
397
+ );
398
+ }
399
+ ```
400
+
401
+ #### Статус-колонка и цвет строки
402
+
403
+ `getStatusColumnDef` с подписью в тултипе и подкраска строк через `getRowBackgroundColor`.
404
+
405
+ ```tsx
406
+ import {
407
+ ColumnDefinition,
408
+ getStatusColumnDef,
409
+ MapStatusToAppearanceFnType,
410
+ STATUS_APPEARANCE,
411
+ Table,
412
+ TABLE_ROW_COLOR,
413
+ } from '@cloud-ru/ds-table';
414
+
415
+ type User = {
416
+ id: string;
417
+ name: string;
418
+ email: string;
419
+ role: string;
420
+ status: string;
421
+ };
422
+
423
+ const USERS: User[] = [
424
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', status: 'active' },
425
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', status: 'pending' },
426
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', status: 'blocked' },
427
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', status: 'invited' },
428
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', status: 'active' },
429
+ { id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', status: 'blocked' },
430
+ ];
431
+
432
+ const STATUS_LABELS: Record<string, string> = {
433
+ active: 'Активен',
434
+ pending: 'Ожидание',
435
+ blocked: 'Заблокирован',
436
+ invited: 'Приглашён',
437
+ };
438
+
439
+ const mapStatusToAppearance: MapStatusToAppearanceFnType = value => {
440
+ switch (value) {
441
+ case 'active':
442
+ return STATUS_APPEARANCE.Green;
443
+ case 'pending':
444
+ return STATUS_APPEARANCE.Yellow;
445
+ case 'blocked':
446
+ return STATUS_APPEARANCE.Red;
447
+ case 'invited':
448
+ return STATUS_APPEARANCE.Blue;
449
+ default:
450
+ return STATUS_APPEARANCE.Neutral;
451
+ }
452
+ };
453
+
454
+ const columns: ColumnDefinition<User>[] = [
455
+ getStatusColumnDef<User>({
456
+ accessorKey: 'status',
457
+ mapStatusToAppearance,
458
+ renderDescription: value => STATUS_LABELS[value] ?? value,
459
+ header: 'Статус',
460
+ size: 160,
461
+ }),
462
+ { accessorKey: 'name', header: 'Имя', size: 200 },
463
+ { accessorKey: 'email', header: 'Email', size: 260 },
464
+ { accessorKey: 'role', header: 'Роль', size: 140 },
465
+ ];
466
+
467
+ export function StatusColumn() {
468
+ return (
469
+ <Table
470
+ data={USERS}
471
+ columnDefinitions={columns}
472
+ getRowBackgroundColor={user => (user.status === 'blocked' ? TABLE_ROW_COLOR.Red : undefined)}
473
+ suppressPagination
474
+ outline
475
+ />
476
+ );
477
+ }
478
+ ```
479
+
480
+ #### Выбор строк и массовые действия
481
+
482
+ Множественный выбор, bulk-бар с действием удаления и `resetRowSelection`.
483
+
484
+ ```tsx
485
+ import { TrashSVG } from '@cloud-ru/ds-icons/interface/system';
486
+ import { ColumnDefinition, RowSelectionState, Table } from '@cloud-ru/ds-table';
487
+ import { useState } from 'react';
488
+
489
+ type User = {
490
+ id: string;
491
+ name: string;
492
+ email: string;
493
+ role: string;
494
+ };
495
+
496
+ const INITIAL_USERS: User[] = [
497
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner' },
498
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin' },
499
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor' },
500
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer' },
501
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor' },
502
+ { id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin' },
503
+ ];
504
+
505
+ const columns: ColumnDefinition<User>[] = [
506
+ { accessorKey: 'name', header: 'Имя', size: 200 },
507
+ { accessorKey: 'email', header: 'Email', size: 260 },
508
+ { accessorKey: 'role', header: 'Роль', size: 140 },
509
+ ];
510
+
511
+ export function Selection() {
512
+ const [users, setUsers] = useState<User[]>(INITIAL_USERS);
513
+ const [selection, setSelection] = useState<RowSelectionState>({ 'u-2': true });
514
+
515
+ return (
516
+ <Table
517
+ data={users}
518
+ columnDefinitions={columns}
519
+ getRowId={user => user.id}
520
+ rowSelection={{ enable: true, multiRow: true, state: selection, onChange: setSelection }}
521
+ bulkActions={[
522
+ {
523
+ label: 'Удалить выбранные',
524
+ icon: TrashSVG,
525
+ onClick: (selectionState, resetRowSelection) => {
526
+ setUsers(prev => prev.filter(user => !selectionState[user.id]));
527
+ setSelection({});
528
+ resetRowSelection();
529
+ },
530
+ },
531
+ ]}
532
+ suppressPagination
533
+ outline
534
+ />
535
+ );
536
+ }
537
+ ```
538
+
539
+ #### Действия строки
540
+
541
+ `getRowActionsColumnDef` с выпадающим списком: пункты меняют данные строки.
542
+
543
+ ```tsx
544
+ import { ColumnDefinition, getRowActionsColumnDef, Table } from '@cloud-ru/ds-table';
545
+ import { useMemo, useState } from 'react';
546
+
547
+ type User = {
548
+ id: string;
549
+ name: string;
550
+ email: string;
551
+ status: 'active' | 'blocked';
552
+ };
553
+
554
+ const INITIAL_USERS: User[] = [
555
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', status: 'active' },
556
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', status: 'active' },
557
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', status: 'blocked' },
558
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', status: 'active' },
559
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', status: 'blocked' },
560
+ ];
561
+
562
+ export function RowActions() {
563
+ const [users, setUsers] = useState<User[]>(INITIAL_USERS);
564
+
565
+ const columns = useMemo<ColumnDefinition<User>[]>(
566
+ () => [
567
+ { accessorKey: 'name', header: 'Имя', size: 200 },
568
+ { accessorKey: 'email', header: 'Email', size: 260 },
569
+ {
570
+ accessorKey: 'status',
571
+ header: 'Статус',
572
+ size: 160,
573
+ cell: ctx => (ctx.getValue() === 'blocked' ? 'Заблокирован' : 'Активен'),
574
+ },
575
+ getRowActionsColumnDef<User>({
576
+ pinned: true,
577
+ actionsGenerator: cell => {
578
+ const user = cell.row.original;
579
+
580
+ return [
581
+ {
582
+ content: { label: user.status === 'blocked' ? 'Активировать' : 'Заблокировать' },
583
+ onClick: () =>
584
+ setUsers(prev =>
585
+ prev.map(item =>
586
+ item.id === user.id ? { ...item, status: item.status === 'blocked' ? 'active' : 'blocked' } : item,
587
+ ),
588
+ ),
589
+ },
590
+ {
591
+ content: { label: 'Удалить' },
592
+ onClick: () => setUsers(prev => prev.filter(item => item.id !== user.id)),
593
+ },
594
+ ];
595
+ },
596
+ }),
597
+ ],
598
+ [],
599
+ );
600
+
601
+ return <Table data={users} columnDefinitions={columns} getRowId={user => user.id} suppressPagination outline />;
602
+ }
603
+ ```
604
+
605
+ #### Дерево
606
+
607
+ Иерархические данные через `expanding.getSubRows` + `getTreeColumnDef`.
608
+
609
+ ```tsx
610
+ import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
611
+
612
+ type OrgNode = {
613
+ id: string;
614
+ name: string;
615
+ type: string;
616
+ email: string;
617
+ subRows?: OrgNode[];
618
+ };
619
+
620
+ const ORG_TREE: OrgNode[] = [
621
+ {
622
+ id: 'org-cloud',
623
+ name: 'Cloud Platform',
624
+ type: 'Организация',
625
+ email: 'platform@example.com',
626
+ subRows: [
627
+ {
628
+ id: 'team-compute',
629
+ name: 'Compute',
630
+ type: 'Команда',
631
+ email: 'compute@example.com',
632
+ subRows: [
633
+ { id: 'p-1', name: 'Анна Иванова', type: 'Owner', email: 'anna.ivanova@example.com' },
634
+ { id: 'p-2', name: 'Борис Петров', type: 'Admin', email: 'boris.petrov@example.com' },
635
+ ],
636
+ },
637
+ {
638
+ id: 'team-storage',
639
+ name: 'Storage',
640
+ type: 'Команда',
641
+ email: 'storage@example.com',
642
+ subRows: [{ id: 'p-3', name: 'Вера Сидорова', type: 'Editor', email: 'vera.sidorova@example.com' }],
643
+ },
644
+ ],
645
+ },
646
+ {
647
+ id: 'org-data',
648
+ name: 'Data Platform',
649
+ type: 'Организация',
650
+ email: 'data@example.com',
651
+ subRows: [{ id: 'p-4', name: 'Егор Морозов', type: 'Admin', email: 'egor.morozov@example.com' }],
652
+ },
653
+ ];
654
+
655
+ // `name` рендерится tree-колонкой (`expandingColumnDefinition`), поэтому
656
+ // в обычных колонках его нет — иначе значение продублируется.
657
+ const columns: ColumnDefinition<OrgNode>[] = [
658
+ { accessorKey: 'type', header: 'Тип', size: 160 },
659
+ { accessorKey: 'email', header: 'Email', size: 260 },
660
+ ];
661
+
662
+ export function Tree() {
663
+ return (
664
+ <Table
665
+ data={ORG_TREE}
666
+ columnDefinitions={columns}
667
+ getRowId={node => node.id}
668
+ expanding={{
669
+ getSubRows: node => node.subRows,
670
+ expandingColumnDefinition: { accessorKey: 'name', header: 'Подразделение' },
671
+ }}
672
+ suppressPagination
673
+ outline
674
+ />
675
+ );
676
+ }
677
+ ```
678
+
679
+ #### Настройка колонок
680
+
681
+ Перетаскивание заголовков и строк в меню настроек (`enableDrag`) плюс видимость колонок (`enableSettingsMenu`).
682
+
683
+ ```tsx
684
+ import { COLUMN_SETTINGS_MODE, ColumnDefinition, Table } from '@cloud-ru/ds-table';
685
+
686
+ type User = {
687
+ id: string;
688
+ name: string;
689
+ email: string;
690
+ role: string;
691
+ createdAt: string;
692
+ };
693
+
694
+ const USERS: User[] = [
695
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', createdAt: '12.01.2026' },
696
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', createdAt: '03.02.2026' },
697
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', createdAt: '18.03.2026' },
698
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', createdAt: '27.04.2026' },
699
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', createdAt: '09.05.2026' },
700
+ ];
701
+
702
+ const columns: ColumnDefinition<User>[] = [
703
+ // `mode: Hidden` — колонка не показывается в меню настроек и видна всегда.
704
+ {
705
+ accessorKey: 'name',
706
+ header: 'Имя',
707
+ size: 200,
708
+ columnSettings: { label: 'Имя', mode: COLUMN_SETTINGS_MODE.Locked },
709
+ },
710
+ { accessorKey: 'email', header: 'Email', size: 240, columnSettings: { label: 'Email' } },
711
+ { accessorKey: 'role', header: 'Роль', size: 140, columnSettings: { label: 'Роль' } },
712
+ // `mode: DefaultFalse` — колонка скрыта по умолчанию, включается из меню настроек.
713
+ {
714
+ accessorKey: 'createdAt',
715
+ header: 'Создан',
716
+ size: 160,
717
+ columnSettings: { label: 'Дата создания', mode: COLUMN_SETTINGS_MODE.DefaultHidden },
718
+ },
719
+ ];
720
+
721
+ export function ColumnSettings() {
722
+ return (
723
+ <Table
724
+ data={USERS}
725
+ columnDefinitions={columns}
726
+ columnsSettings={{ enableDrag: true, enableSettingsMenu: true }}
727
+ suppressPagination
728
+ outline
729
+ />
730
+ );
731
+ }
732
+ ```
733
+
734
+ #### Режим карточек
735
+
736
+ `defaultView="cards"` + `showDataView` + `headlineId`; переключатель table/cards в тулбаре.
737
+
738
+ ```tsx
739
+ import { ColumnDefinition, Table, VIEW } from '@cloud-ru/ds-table';
740
+
741
+ type User = {
742
+ id: string;
743
+ name: string;
744
+ email: string;
745
+ role: string;
746
+ balance: number;
747
+ };
748
+
749
+ const USERS: User[] = [
750
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
751
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
752
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
753
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
754
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
755
+ { id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', balance: 15600 },
756
+ ];
757
+
758
+ const columns: ColumnDefinition<User>[] = [
759
+ { accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
760
+ { accessorKey: 'email', header: 'Email', size: 240 },
761
+ { accessorKey: 'role', header: 'Роль', size: 140 },
762
+ { accessorKey: 'balance', header: 'Баланс', enableSorting: true, size: 140 },
763
+ ];
764
+
765
+ export function CardView() {
766
+ return (
767
+ <Table
768
+ data={USERS}
769
+ columnDefinitions={columns}
770
+ // Стартовый вид — карточки; `showDataView` включает переключатель table/cards
771
+ // в тулбаре (по умолчанию его нет). `headlineId` задаёт заголовок карточки.
772
+ defaultView={VIEW.Cards}
773
+ showDataView
774
+ headlineId='name'
775
+ getRowId={user => user.id}
776
+ rowSelection={{ enable: true, multiRow: true }}
777
+ sorting={{ initialState: [{ id: 'name', desc: false }] }}
778
+ outline
779
+ />
780
+ );
781
+ }
782
+ ```
783
+
784
+ #### Мобильная раскладка
785
+
786
+ `AdaptiveProvider layoutType="mobile"` + `defaultView="cards"` — список карточек; в table-виде на mobile — сетка строк. По умолчанию `stickyControls.enabled: true`, offsets `0`; отступ под sticky header документации — `layoutPresets.mobile`.
787
+
788
+ ```tsx
789
+ import { AdaptiveProvider, LAYOUT_TYPE } from '@cloud-ru/ds-adaptive';
790
+ import {
791
+ ColumnDefinition,
792
+ getStatusColumnDef,
793
+ MapStatusToAppearanceFnType,
794
+ STATUS_APPEARANCE,
795
+ Table,
796
+ VIEW,
797
+ } from '@cloud-ru/ds-table';
798
+
799
+ type User = {
800
+ id: string;
801
+ name: string;
802
+ email: string;
803
+ role: string;
804
+ status: string;
805
+ };
806
+
807
+ const USERS: User[] = [
808
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna@example.com', role: 'Owner', status: 'active' },
809
+ { id: 'u-2', name: 'Борис Петров', email: 'boris@example.com', role: 'Admin', status: 'pending' },
810
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera@example.com', role: 'Editor', status: 'active' },
811
+ ];
812
+
813
+ const mapStatusToAppearance: MapStatusToAppearanceFnType = value =>
814
+ value === 'active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Orange;
815
+
816
+ const columns: ColumnDefinition<User>[] = [
817
+ getStatusColumnDef<User>({
818
+ accessorKey: 'status',
819
+ mapStatusToAppearance,
820
+ renderDescription: value => (value === 'active' ? 'Активен' : 'Ожидает'),
821
+ header: 'Статус',
822
+ size: 160,
823
+ }),
824
+ { accessorKey: 'name', header: 'Имя', enableSorting: true },
825
+ { accessorKey: 'email', header: 'Email' },
826
+ { accessorKey: 'role', header: 'Роль' },
827
+ ];
828
+
829
+ /** Высота sticky header сайта документации (`apps/docs` → `$docs-header-height`). */
830
+ const DOCS_HEADER_HEIGHT = 52;
831
+
832
+ export function MobileLayout() {
833
+ return (
834
+ <AdaptiveProvider layoutType={LAYOUT_TYPE.Mobile}>
835
+ <div style={{ maxWidth: 375 }}>
836
+ <Table
837
+ data={USERS}
838
+ columnDefinitions={columns}
839
+ defaultView={VIEW.Cards}
840
+ headlineId='name'
841
+ sorting={{}}
842
+ columnsSettings={{ enableSettingsMenu: true }}
843
+ layoutPresets={{
844
+ mobile: {
845
+ stickyControls: { enabled: true, offsetTop: DOCS_HEADER_HEIGHT, offsetBottom: 0 },
846
+ },
847
+ }}
848
+ outline
849
+ />
850
+ </div>
851
+ </AdaptiveProvider>
852
+ );
853
+ }
854
+ ```
855
+
856
+ #### Ширина таблицы
857
+
858
+ По умолчанию таблица растягивается на контейнер (`fullWidth`). При `fullWidth={false}` на desktop обводка и сетка сжимаются до суммы фиксированных колонок — удобно в модалках и узких формах. На mobile режим fit-content не применяется.
859
+
860
+ ```tsx
861
+ import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
862
+
863
+ type User = {
864
+ id: string;
865
+ name: string;
866
+ email: string;
867
+ role: string;
868
+ balance: number;
869
+ };
870
+
871
+ const USERS: User[] = [
872
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
873
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
874
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
875
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
876
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
877
+ ];
878
+
879
+ const balanceFormatter = new Intl.NumberFormat('ru-RU', {
880
+ style: 'currency',
881
+ currency: 'RUB',
882
+ maximumFractionDigits: 0,
883
+ });
884
+
885
+ const columns: ColumnDefinition<User>[] = [
886
+ { accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
887
+ { accessorKey: 'email', header: 'Email', size: 240 },
888
+ { accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
889
+ {
890
+ accessorKey: 'balance',
891
+ header: 'Баланс',
892
+ align: 'right',
893
+ headerAlign: 'right',
894
+ enableSorting: true,
895
+ size: 140,
896
+ cell: ctx => balanceFormatter.format(Number(ctx.getValue() ?? 0)),
897
+ },
898
+ ];
899
+
900
+ const tableProps = {
901
+ data: USERS,
902
+ columnDefinitions: columns,
903
+ pageSize: 5,
904
+ pagination: { options: [5, 10] },
905
+ outline: true,
906
+ suppressToolbar: true,
907
+ };
908
+
909
+ export function FullWidth() {
910
+ return (
911
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 24, width: '100%', maxWidth: 960 }}>
912
+ <Table {...tableProps} />
913
+ <Table {...tableProps} fullWidth={false} />
914
+ </div>
915
+ );
916
+ }
917
+ ```
918
+
919
+ ### Props
920
+
921
+ **TableProps**
922
+
923
+ | Prop | Type | Default | Description |
924
+ |------|------|---------|-------------|
925
+ | `autoResetPageIndex` | `boolean` | `false` | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
926
+ | `bulkActions` | `BulkAction` | — | Список действий для массовых операций |
927
+ | `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
928
+ | `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
929
+ | `className` | `string` | — | CSS-класс |
930
+ | `columnDefinitions` | `ColumnDefinition` \| `Except` \| `TData` | — | Определение внешнего вида и функционала колонок |
931
+ | `columnFilters` | `FilterRow` \| `TFilters` | — | Фильтры |
932
+ | `columnVirtualizerInstanceRef` | `ColumnVirtualizer` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
933
+ | `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
934
+ | `columnsSettings` | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; } \| undefined` | — | Настройки колонок: `enableDrag` — переупорядочивание (заголовки таблицы и строки в меню настроек); <br/> `enableSettingsMenu` — меню показа колонок. |
935
+ | `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
936
+ | `data` | `TData` | — | Данные для отрисовки |
937
+ | `data-test-id` | `string` | — | |
938
+ | `dataError` | `boolean` | — | Флаг, показывающий что произошла ошибка запроса при пустых данных |
939
+ | `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
940
+ | `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
941
+ | `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
942
+ | `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
943
+ | `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
944
+ | `enableSelectPinned` | `boolean` | `false` | Параметр отвечает за чекбокс выбора закрепленных строк |
945
+ | `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
946
+ | `expanding` | `TData` \| `TreeColumnDefinitionProps` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
947
+ | `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
948
+ | `getRowBackgroundColor` | `TData` \| `TableRowColor` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
949
+ | `getRowId` | `TData` | — | Функция получения уникального идентификатора строки |
950
+ | `hasMore` | `boolean` | — | Есть ли ещё данные для загрузки. Управляет видимостью кнопки / активностью observer-а. |
951
+ | `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
952
+ | `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
953
+ | `infiniteLoading` | `boolean` | `false` | Режим работы "бесконечной" загрузки |
954
+ | `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
955
+ | `layoutPresets` | `LayoutPresets` \| `TableLayoutDefaults` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
956
+ | `loadMoreTrigger` | `"button"` \| `"scroll"` | `scroll` | Механизм подгрузки следующей порции данных. <br/> - `'scroll'` (по умолчанию) — IntersectionObserver на scroll-stub в конце списка. <br/> - `'button'` — кнопка «Загрузить ещё» под таблицей. |
957
+ | `loading` | `boolean` | `false` | Состояние загрузки |
958
+ | `manualFiltering` | `boolean` | `false` | |
959
+ | `manualPagination` | `boolean` | `false` | |
960
+ | `manualSorting` | `boolean` | `false` | |
961
+ | `moreActions` | `TFilters` \| `ToolbarProps` | — | Элементы выпадающего списка кнопки с действиями |
962
+ | `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
963
+ | `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
964
+ | `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
965
+ | `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки «Загрузить ещё». |
966
+ | `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
967
+ | `onRowClick` | `RowClickHandler` \| `TData` | — | Колбэк клика по строке |
968
+ | `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
969
+ | `outline` | `boolean` | `false` | Внешний бордер для тулбара и таблицы |
970
+ | `pageCount` | `number` | — | Кол-во страниц (для внешнего управления) |
971
+ | `pageSize` | `number` | `10` | Максимальное кол-во строк на страницу |
972
+ | `pagination` | `{ state?: PaginationState; options?: number[]; optionsLabel?: string \| undefined; onChange?(state: PaginationState): void; optionsRender?(value: string \| number, idx: number): string \| number; } \| undefined` | — | Параметры пагинации: `state`, `options`, `optionsLabel`, `onChange`, `optionsRender`. |
973
+ | `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
974
+ | `rowAutoHeight` | `boolean` | — | |
975
+ | `rowPinning` | `Pick<RowPinningState, "top">` | `{ top: [], }` | Определение, какие строки должны быть закреплены в таблице |
976
+ | `rowSelection` | `RowAppearance` \| `TData` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
977
+ | `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
978
+ | `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
979
+ | `savedState` | `TFilters` \| `ToolbarPersistConfig` | — | Конфиг сохранения состояния в localStorage и queryParams. <br/> `id` должен быть уникальным для разных таблиц в рамках приложения. |
980
+ | `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
981
+ | `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
982
+ | `search` | `{ initialState?: string; state?: string; placeholder?: string \| undefined; loading?: boolean \| undefined; onChange?(value: string): void; } \| undefined` | — | Параметры глобального поиска: `initialState`, `state`, `placeholder`, `loading`, `onChange`. |
983
+ | `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
984
+ | `sorting` | `{ initialState?: SortingState; state?: SortingState; onChange?(state: SortingState): void; } \| undefined` | — | Параметры отвечают за возможность сортировки: <br/> `initialState` — начальное состояние; `state` — управляемое снаружи; `onChange` — колбэк на изменение. |
985
+ | `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
986
+ | `suppressHeader` | `boolean` | `false` | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
987
+ | `suppressPagination` | `boolean` | `false` | Отключение пагинации |
988
+ | `suppressSearch` | `boolean` | `false` | Отключение поиска |
989
+ | `suppressToolbar` | `boolean` | `false` | Отключение тулбара |
990
+ | `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
991
+ | `toolbarCheckBoxMode` | `"allRows"` \| `"pageRows"` | — | Охват мастер-чекбокса выбора: текущая страница или все строки `data` (только клиентская таблица) |
992
+ | `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
993
+
994
+ ##### Related types
995
+
996
+ - `ColumnDefinition` = `NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>`
997
+
998
+ **EmptyStateProps**
999
+
1000
+ | Prop | Type | Default | Description |
1001
+ |------|------|---------|-------------|
1002
+ | `className` | `string \| undefined` | — | Дополнительный класс |
1003
+ | `content` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Подзаголовок |
1004
+ | `footer` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Вложенный контент (например ButtonGroup) |
1005
+ | `icon` | `IconPredefinedProps` | — | Иконка |
1006
+ | `title` | `string \| undefined` | — | Заголовок |
1007
+
1008
+ - `Except` = `{ [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType]; }`
1009
+
1010
+ - `RowClickHandler` = `(e: MouseEvent<HTMLDivElement>, row: RowInfo<TData>) => void`
1011
+
1012
+ - `TreeColumnDefinitionProps` = `TreeColumnDef | TreeColumnDefWithDescription<TData>`
1013
+
1014
+ - `View` = `"cards"` \| `"table"`
1015
+
1016
+ ### Смотри также
1017
+
1018
+ - **Обзор пакета** — архитектура, выбор компонента, preset-ы.
1019
+ - **`defineColumns`** — декларативные колонки для preset-ов и escape hatch.
1020
+ - **SimpleTable** — минимальный клиентский preset.
1021
+ - **AdminTable** — админ-экран на клиенте.
1022
+ - **TreeTable** — иерархические данные.
1023
+ - **InfiniteTable** — бесконечная прокрутка.
1024
+ - **ServerTable** — постраничные данные с бэкенда.
1025
+ - **Pagination** — отдельный компонент пагинации.
1026
+ - **InfoBlock** — основа пустых состояний таблицы.
1027
+ ### Адаптивность
1028
+
1029
+ `Table` — адаптивный компонент класса preset-defaults: DOM один, по раскладке меняются только дефолты пропсов. Раскладку компонент читает из контекста **`@cloud-ru/ds-adaptive`** — отдельного пропа `layoutType` нет.
1030
+
1031
+ > **Desktop-first.** Верстайте под desktop и поставьте один `<AdaptiveProvider>` в корне приложения — mobile-дефолты применяются автоматически. Override нужен только как escape-hatch.
1032
+
1033
+ На mobile тулбар, шапка и пагинация автоматически залипают при прокрутке (`stickyControls.enabled`); на desktop таблица прокручивается свободно.
1034
+ `offsetTop` / `offsetBottom` — дополнительный отступ chrome-контролов от краёв viewport (px), если над/под таблицей есть внешний sticky UI (app header, tab bar); работают только при `stickyControls.enabled`.
1035
+
1036
+ | Поле `stickyControls` | desktop | mobile |
1037
+ | ----------------------- | ------------------------- | ----------------------- |
1038
+ | `enabled` | `false` | `true` |
1039
+ | `offsetTop` | — (sticky выключен) | `0` |
1040
+ | `offsetBottom` | — (sticky выключен) | `0` |
1041
+ | `backgroundPredefined` | — (sticky выключен) | `neutralBackground1Level` |
1042
+ | `fullWidth` | `true` (явный проп) | `true` (`TABLE_LAYOUT_PRESETS`) |
1043
+ | `defaultView` | `table` | `cards` (`TABLE_LAYOUT_PRESETS`) |
1044
+
1045
+ Проп `showDataView` (видимость переключателя вида) **не** адаптивный — это обычный булев проп с дефолтом `false` на всех раскладках.
1046
+
1047
+ Ненулевые `offsetTop` / `offsetBottom` на mobile — через `layoutPresets.mobile`. Объект `stickyControls` в пресете **заменяет** DS-дефолт целиком — передайте все нужные поля (`enabled`, offsets).
1048
+
1049
+ ```tsx
1050
+ <Table
1051
+ stickyControls={{ enabled: true, offsetTop: 64 }}
1052
+ layoutPresets={{
1053
+ mobile: { stickyControls: { enabled: true, offsetTop: 48, offsetBottom: 56 } },
1054
+ }}
1055
+ />
1056
+ ```
1057
+
1058
+ Источник mobile-дефолтов — экспортируемая константа `TABLE_LAYOUT_PRESETS`.
1059
+
1060
+ #### Как переопределить
1061
+
1062
+ **Desktop-first:** перенос пропа из desktop-макета не ломает mobile. Приоритет (от высшего к низшему): `layoutPresets[layout]` (инстанс) → DS-пресет `TABLE_LAYOUT_PRESETS` → явный проп (= desktop-значение) → базовый дефолт.
1063
+
1064
+ ```tsx
1065
+ import { Table } from '@cloud-ru/ds-table'
1066
+
1067
+ // 1. Явный проп — задаёт DESKTOP-значение; mobile остаётся enabled=true (mobile не ломается)
1068
+ <Table stickyControls={{ enabled: true }} columnDefinitions={[]} data={[]} />
1069
+
1070
+ // 2. layoutPresets.mobile — единственный способ отключить sticky на mobile (явно)
1071
+ <Table layoutPresets={{ mobile: { stickyControls: { enabled: false } } }} columnDefinitions={[]} data={[]} />
1072
+
1073
+ // 2b. layoutPresets.desktop — включить sticky только на desktop, mobile-адаптив сохранён
1074
+ <Table layoutPresets={{ desktop: { stickyControls: { enabled: true } } }} columnDefinitions={[]} data={[]} />
1075
+ ```
1076
+
1077
+ DS-пресет (`TABLE_LAYOUT_PRESETS`) — точка форка mobile-дефолтов на уровне всей дизайн-системы.
1078
+
1079
+ #### Как форсировать раскладку
1080
+
1081
+ Раскладка переключается только контекстом, не пропом:
1082
+
1083
+ ```tsx
1084
+ import { AdaptiveProvider, withLayoutType } from '@cloud-ru/ds-adaptive';
1085
+ import { Table } from '@cloud-ru/ds-table';
1086
+
1087
+ // поддерево — вложенный провайдер
1088
+ <AdaptiveProvider layoutType='mobile'>
1089
+ <Table columnDefinitions={[]} data={[]} />
1090
+ </AdaptiveProvider>;
1091
+
1092
+ // компонент/секция — HOC (module-scope, не в рендере)
1093
+ const MobileTable = withLayoutType(Table, 'mobile');
1094
+ ```
1095
+
1096
+ Подробнее о модели раскладки — в **`@cloud-ru/ds-adaptive`**.
1097
+
1098
+ ## ServerTable
1099
+
1100
+ Таблица для серверных данных: постраничная загрузка items/total/limit/offset, controlled-поиск и серверная сортировка.
1101
+
1102
+ `ServerTable` — обёртка над **`Table`** для постраничных данных с бэкенда. Страница данных приходит снаружи (`items` / `total` / `limit` / `offset`), смена страницы, поиск и сортировка делегируются серверу: компонент вызывает `onChangePage`, `search.onChange` и `sorting.onChange`, а отрисовывает то, что передано в пропсах.
1103
+
1104
+ Для типовых серверных сценариев есть preset-ы `ServerSimpleTable` и `ServerAdminTable` (см. **обзор пакета**) — они маппят упрощённый API в `ServerTable`, как `SimpleTable` / `AdminTable` маппят в `Table`.
1105
+
1106
+ ### Когда использовать
1107
+
1108
+ - Данные приходят с бэкенда постранично, известно общее количество строк (`total`).
1109
+ - Поиск и сортировка выполняются на сервере, а не на клиенте.
1110
+ - Объём данных слишком велик для загрузки на клиент целиком.
1111
+
1112
+ Когда **не** нужен:
1113
+
1114
+ - Данные загружены на клиент целиком:
1115
+ - используйте **`Table`** или **`SimpleTable`** — пагинация, поиск и сортировка работают локально.
1116
+
1117
+ Рекомендации по выбору API:
1118
+
1119
+ - Простой серверный список (колонки + пагинация) — `ServerSimpleTable`.
1120
+ - Админ-экран с поиском, статусом, выбором и действиями — `ServerAdminTable`.
1121
+ - Нестандартные колонки, фильтры или поведение тулбара — `ServerTable` напрямую.
1122
+
1123
+ ### Анатомия
1124
+
1125
+ #### Постраничная загрузка (default `limit` 10, `offset` 0)
1126
+
1127
+ - `items` — строки текущей страницы.
1128
+ - `total` — общее количество строк; по нему рассчитывается число страниц.
1129
+ - `limit` / `offset` — размер страницы и смещение текущей страницы.
1130
+ - `onChangePage(offset, limit)` — вызывается при смене страницы или размера страницы; здесь выполняется запрос новой страницы.
1131
+ - `pagination.options` / `pagination.optionsLabel` — варианты числа строк на страницу и подпись к ним.
1132
+
1133
+ #### Поиск (controlled)
1134
+
1135
+ - `search.state` и `search.onChange` обязательны — значение поиска хранится снаружи, в отличие от `Table`.
1136
+ - `search.loading` — индикатор загрузки в строке поиска.
1137
+ - `search.initialValue` — начальное значение.
1138
+ - Ввод дебаунсится внутри компонента (500 мс, отдельный таймер на каждый инстанс) — `onChange` получает значение после паузы ввода. При смене запроса обычно сбрасывают `offset` в `0`.
1139
+
1140
+ #### Серверная сортировка
1141
+
1142
+ - По умолчанию включён `manualSorting` — таблица не сортирует `items` на клиенте.
1143
+ - Передайте управляемый `sorting.state` + `sorting.onChange`; при смене сортировки запросите новую страницу и сбросьте `offset` в `0`.
1144
+ - Колонки с `enableSorting: true` отображают индикатор сортировки; фактическое упорядочивание выполняет бэкенд.
1145
+
1146
+ #### Интеграция с бэкендом
1147
+
1148
+ Типичный контракт на стороне приложения:
1149
+
1150
+ 1. Хранить `items`, `total`, `loading`, `offset`, `limit`, `search`, `sorting` в state.
1151
+ 2. В `useEffect` (или data-fetch хуке) запрашивать страницу при изменении `offset` / `limit` / `search` / `sorting`.
1152
+ 3. В `onChangePage` обновлять `offset` и `limit`; в `search.onChange` и `sorting.onChange` — сбрасывать `offset` в `0`.
1153
+ 4. При параллельных запросах отбрасывать устаревшие ответы (счётчик `requestId` / `AbortController`) — иначе медленный ответ может перезаписать актуальные данные.
1154
+ 5. Пробрасывать `loading` в `ServerTable` и в `search.loading` на время запроса.
1155
+
1156
+ #### Отличия от Table
1157
+
1158
+ - Данные передаются через `items` (вместо `data`) — только текущая страница.
1159
+ - Вырезаны `pageSize`, `pageCount`, `pagination.state`, `toolbarCheckBoxMode` — пагинацией управляет бэкенд через `limit` / `offset` / `total`.
1160
+ - Серверная сортировка — `manualSorting` + управляемый `sorting.state` / `onChange`.
1161
+ - Остальное API — колонки, служебные колонки, выбор строк, дерево, режим карточек, тулбар — наследуется от `Table`.
1162
+
1163
+ ### Примеры использования
1164
+
1165
+ {/* client:only='react': SSR демо невозможен — @cloud-ru/ds-list использует в dist directory-imports, которые Node-ESM не резолвит (тот же паттерн, что в @cloud-ru/ds-chips). */}
1166
+
1167
+ #### Серверный сценарий
1168
+
1169
+ Имитация бэкенда: `onChangePage`, controlled-поиск и сортировка с `manualSorting`, сброс `offset` при фильтрах, отмена устаревших ответов через `requestId`.
1170
+
1171
+ ```tsx
1172
+ import { ColumnDefinition, ServerTable, SortingState } from '@cloud-ru/ds-table';
1173
+ import { useEffect, useRef, useState } from 'react';
1174
+
1175
+ type User = {
1176
+ id: string;
1177
+ name: string;
1178
+ email: string;
1179
+ role: string;
1180
+ balance: number;
1181
+ };
1182
+
1183
+ const NAMES = [
1184
+ 'Анна Иванова',
1185
+ 'Борис Петров',
1186
+ 'Вера Сидорова',
1187
+ 'Глеб Кузнецов',
1188
+ 'Дарья Орлова',
1189
+ 'Егор Морозов',
1190
+ 'Жанна Волкова',
1191
+ 'Захар Соколов',
1192
+ ];
1193
+
1194
+ const ROLES = ['Owner', 'Admin', 'Editor', 'Viewer'];
1195
+
1196
+ const ALL_USERS: User[] = Array.from({ length: 23 }, (_, index) => ({
1197
+ id: `u-${index + 1}`,
1198
+ name: NAMES[index % NAMES.length],
1199
+ email: `user-${index + 1}@example.com`,
1200
+ role: ROLES[index % ROLES.length],
1201
+ balance: (index * 1730) % 20000,
1202
+ }));
1203
+
1204
+ function compareUsers(a: User, b: User, columnId: string, desc: boolean): number {
1205
+ const left = a[columnId as keyof User];
1206
+ const right = b[columnId as keyof User];
1207
+ const order =
1208
+ typeof left === 'number' && typeof right === 'number' ? left - right : String(left).localeCompare(String(right));
1209
+
1210
+ return desc ? -order : order;
1211
+ }
1212
+
1213
+ type PageResponse = {
1214
+ items: User[];
1215
+ total: number;
1216
+ };
1217
+
1218
+ // Имитация бэкенда: фильтрация по имени, сортировка и срез по offset/limit с задержкой.
1219
+ function fetchUsers(offset: number, limit: number, query: string, sorting: SortingState): Promise<PageResponse> {
1220
+ return new Promise(resolve => {
1221
+ setTimeout(() => {
1222
+ const filtered = query
1223
+ ? ALL_USERS.filter(user => user.name.toLowerCase().includes(query.toLowerCase()))
1224
+ : ALL_USERS;
1225
+ const sortRule = sorting[0];
1226
+ const sorted = sortRule ? [...filtered].sort((a, b) => compareUsers(a, b, sortRule.id, sortRule.desc)) : filtered;
1227
+
1228
+ resolve({ items: sorted.slice(offset, offset + limit), total: sorted.length });
1229
+ }, 400);
1230
+ });
1231
+ }
1232
+
1233
+ const columns: ColumnDefinition<User>[] = [
1234
+ { accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
1235
+ { accessorKey: 'email', header: 'Email', size: 240 },
1236
+ { accessorKey: 'role', header: 'Роль', size: 140 },
1237
+ { accessorKey: 'balance', header: 'Баланс', align: 'right', headerAlign: 'right', enableSorting: true, size: 140 },
1238
+ ];
1239
+
1240
+ export function ServerDriven() {
1241
+ const [items, setItems] = useState<User[]>([]);
1242
+ const [total, setTotal] = useState(0);
1243
+ const [loading, setLoading] = useState(false);
1244
+ const [offset, setOffset] = useState(0);
1245
+ const [limit, setLimit] = useState(5);
1246
+ const [search, setSearch] = useState('');
1247
+ const [sorting, setSorting] = useState<SortingState>([]);
1248
+ const requestId = useRef(0);
1249
+
1250
+ useEffect(() => {
1251
+ const currentRequest = ++requestId.current;
1252
+
1253
+ setLoading(true);
1254
+ fetchUsers(offset, limit, search, sorting).then(response => {
1255
+ // Ответы устаревших запросов отбрасываются — состояние обновляет только последний.
1256
+ if (currentRequest !== requestId.current) {
1257
+ return;
1258
+ }
1259
+
1260
+ setItems(response.items);
1261
+ setTotal(response.total);
1262
+ setLoading(false);
1263
+ });
1264
+ }, [offset, limit, search, sorting]);
1265
+
1266
+ return (
1267
+ <ServerTable
1268
+ items={items}
1269
+ total={total}
1270
+ limit={limit}
1271
+ offset={offset}
1272
+ loading={loading}
1273
+ columnDefinitions={columns}
1274
+ onChangePage={(nextOffset, nextLimit) => {
1275
+ setOffset(nextOffset);
1276
+ setLimit(nextLimit);
1277
+ }}
1278
+ search={{
1279
+ state: search,
1280
+ placeholder: 'Поиск по имени',
1281
+ loading,
1282
+ onChange: value => {
1283
+ setOffset(0);
1284
+ setSearch(value);
1285
+ },
1286
+ }}
1287
+ sorting={{
1288
+ state: sorting,
1289
+ onChange: nextSorting => {
1290
+ setOffset(0);
1291
+ setSorting(nextSorting);
1292
+ },
1293
+ }}
1294
+ manualSorting
1295
+ pagination={{ options: [5, 10] }}
1296
+ outline
1297
+ />
1298
+ );
1299
+ }
1300
+ ```
1301
+
1302
+ ### Props
1303
+
1304
+ **ServerTableProps**
1305
+
1306
+ | Prop | Type | Default | Description |
1307
+ |------|------|---------|-------------|
1308
+ | `autoResetPageIndex` | `boolean` | — | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
1309
+ | `bulkActions` | `BulkAction` | — | Список действий для массовых операций |
1310
+ | `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
1311
+ | `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
1312
+ | `className` | `string` | — | CSS-класс |
1313
+ | `columnDefinitions` | `ColumnDefinition` \| `Except` \| `TData` | — | Определение внешнего вида и функционала колонок |
1314
+ | `columnFilters` | `FilterRow` \| `TFilters` | — | Фильтры |
1315
+ | `columnVirtualizerInstanceRef` | `ColumnVirtualizer` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
1316
+ | `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
1317
+ | `columnsSettings` | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; } \| undefined` | — | Настройки колонок: `enableDrag` — переупорядочивание (заголовки таблицы и строки в меню настроек); <br/> `enableSettingsMenu` — меню показа колонок. |
1318
+ | `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
1319
+ | `data-test-id` | `string` | — | |
1320
+ | `dataError` | `boolean` | — | Флаг, показывающий что произошла ошибка запроса при пустых данных |
1321
+ | `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
1322
+ | `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
1323
+ | `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
1324
+ | `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
1325
+ | `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
1326
+ | `enableSelectPinned` | `boolean` | — | Параметр отвечает за чекбокс выбора закрепленных строк |
1327
+ | `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
1328
+ | `expanding` | `TData` \| `TreeColumnDefinitionProps` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
1329
+ | `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
1330
+ | `getRowBackgroundColor` | `TData` \| `TableRowColor` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
1331
+ | `getRowId` | `TData` | — | Функция получения уникального идентификатора строки |
1332
+ | `hasMore` | `undefined` | — | |
1333
+ | `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
1334
+ | `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
1335
+ | `infiniteLoading` | `undefined` | — | |
1336
+ | `items` | `TData` | — | Данные для отрисовки |
1337
+ | `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
1338
+ | `layoutPresets` | `LayoutPresets` \| `TableLayoutDefaults` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
1339
+ | `limit` | `number` | `10` | Кол-во строк на страницу |
1340
+ | `loadMoreTrigger` | `undefined` | — | |
1341
+ | `loading` | `boolean` | — | Состояние загрузки |
1342
+ | `manualFiltering` | `boolean` | `true` | |
1343
+ | `manualPagination` | `boolean` | `true` | |
1344
+ | `manualSorting` | `boolean` | `true` | |
1345
+ | `moreActions` | `TFilters` \| `ToolbarProps` | — | Элементы выпадающего списка кнопки с действиями |
1346
+ | `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
1347
+ | `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
1348
+ | `offset` | `number` | `0` | Смещение |
1349
+ | `onChangePage` | `(offset: number, limit: number) => void` | — | |
1350
+ | `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
1351
+ | `onLoadMore` | `undefined` | — | |
1352
+ | `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
1353
+ | `onRowClick` | `RowClickHandler` \| `TData` | — | Колбэк клика по строке |
1354
+ | `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
1355
+ | `outline` | `boolean` | — | Внешний бордер для тулбара и таблицы |
1356
+ | `pagination` | `{ options?: number[]; optionsLabel?: string; } \| undefined` | — | Параметры пагинации: `options`, `optionsLabel` |
1357
+ | `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
1358
+ | `rowAutoHeight` | `boolean` | — | |
1359
+ | `rowPinning` | `Pick<RowPinningState, "top">` | — | Определение, какие строки должны быть закреплены в таблице |
1360
+ | `rowSelection` | `RowAppearance` \| `TData` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
1361
+ | `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
1362
+ | `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
1363
+ | `savedState` | `TFilters` \| `ToolbarPersistConfig` | — | Конфиг сохранения состояния в localStorage и queryParams. <br/> `id` должен быть уникальным для разных таблиц в рамках приложения. |
1364
+ | `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
1365
+ | `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
1366
+ | `search` | `{ initialState?: string; state: string; placeholder?: string; loading?: boolean \| undefined; onChange(value: string): void; } \| undefined` | — | Параметры глобального поиска: `initialState`, `state`, `placeholder`, `loading`, `onChange`. |
1367
+ | `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
1368
+ | `sorting` | `{ initialState?: SortingState; state?: SortingState; onChange?(state: SortingState): void; } \| undefined` | — | Параметры отвечают за возможность сортировки: <br/> `initialState` — начальное состояние; `state` — управляемое снаружи; `onChange` — колбэк на изменение. |
1369
+ | `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
1370
+ | `suppressHeader` | `boolean` | — | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
1371
+ | `suppressPagination` | `boolean` | — | Отключение пагинации |
1372
+ | `suppressSearch` | `boolean` | — | Отключение поиска |
1373
+ | `suppressToolbar` | `boolean` | — | Отключение тулбара |
1374
+ | `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
1375
+ | `total` | `number` | `10` | Общее кол-во строк |
1376
+ | `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
1377
+
1378
+ ##### Related types
1379
+
1380
+ - `ColumnDefinition` = `NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>`
1381
+
1382
+ **EmptyStateProps**
1383
+
1384
+ | Prop | Type | Default | Description |
1385
+ |------|------|---------|-------------|
1386
+ | `className` | `string \| undefined` | — | Дополнительный класс |
1387
+ | `content` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Подзаголовок |
1388
+ | `footer` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Вложенный контент (например ButtonGroup) |
1389
+ | `icon` | `IconPredefinedProps` | — | Иконка |
1390
+ | `title` | `string \| undefined` | — | Заголовок |
1391
+
1392
+ - `Except` = `{ [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType]; }`
1393
+
1394
+ - `RowClickHandler` = `(e: MouseEvent<HTMLDivElement>, row: RowInfo<TData>) => void`
1395
+
1396
+ **StickyControlsLayoutDefaults**
1397
+
1398
+ | Prop | Type | Default | Description |
1399
+ |------|------|---------|-------------|
1400
+ | `enabled` | `boolean \| undefined` | — | Включить sticky-хром при скролле страницы. |
1401
+ | `offsetBottom` | `number \| undefined` | — | Отступ снизу (px): высота внешнего sticky UI под таблицей (mobile tab bar). <br/> Только при `enabled: true`. |
1402
+ | `offsetTop` | `number \| undefined` | — | Отступ сверху (px): высота внешнего sticky UI над таблицей (app header, tabs). <br/> Только при `enabled: true`. |
1403
+
1404
+ **TableLayoutDefaults**
1405
+
1406
+ | Prop | Type | Default | Description |
1407
+ |------|------|---------|-------------|
1408
+ | `defaultView` | `"cards"` \| `"table"` | — | Начальный вид (uncontrolled). |
1409
+ | `fullWidth` | `boolean` | — | |
1410
+ | `stickyControls` | `StickyControlsLayoutDefaults` | — | |
1411
+
1412
+ - `TreeColumnDefinitionProps` = `TreeColumnDef | TreeColumnDefWithDescription<TData>`
1413
+
1414
+ - `View` = `"cards"` \| `"table"`
1415
+
1416
+ ### Смотри также
1417
+
1418
+ - **Обзор пакета** — `ServerSimpleTable`, `ServerAdminTable` и выбор компонента.
1419
+ - **Table** — клиентская таблица для данных, загруженных целиком.
1420
+ - **SimpleTable** — клиентский аналог `ServerSimpleTable`.
1421
+ - **AdminTable** — клиентский аналог `ServerAdminTable`.
1422
+
1423
+ ## SimpleTable
1424
+
1425
+ Минимальная клиентская таблица: данные, колонки и пагинация с предустановленными дефолтами.
1426
+
1427
+ `SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, пагинация и `outline` включены по умолчанию.
1428
+
1429
+ ### Когда использовать
1430
+
1431
+ - Справочники, настройки, демо-экраны — данные целиком на клиенте, без поиска и фильтров.
1432
+ - Нужен минимальный API вместо полного `Table`.
1433
+ - Компактная таблица в модалке или боковой панели — `fullWidth={false}` при фиксированных колонках.
1434
+
1435
+ Когда **не** нужен:
1436
+
1437
+ - Поиск, фильтры, выбор строк — используйте `AdminTable`.
1438
+ - Данные с бэкенда постранично — `ServerSimpleTable` или `ServerTable`.
1439
+
1440
+ ### Примеры использования
1441
+
1442
+ {/* client:only='react': SSR демо невозможен — @cloud-ru/ds-table тянет toolbar с directory-imports (см. table.mdx). */}
1443
+
1444
+ #### Базовое использование
1445
+
1446
+ ```tsx
1447
+ import { SimpleColumnDef, SimpleTable } from '@cloud-ru/ds-table';
1448
+
1449
+ type User = {
1450
+ id: string;
1451
+ name: string;
1452
+ email: string;
1453
+ role: string;
1454
+ balance: number;
1455
+ };
1456
+
1457
+ const USERS: User[] = [
1458
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
1459
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
1460
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
1461
+ { id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
1462
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
1463
+ ];
1464
+
1465
+ const columns: SimpleColumnDef<User>[] = [
1466
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1467
+ { key: 'email', header: 'Email', width: 240 },
1468
+ { key: 'role', header: 'Роль', sortable: true, width: 140 },
1469
+ { key: 'balance', header: 'Баланс', sortable: true, align: 'right', width: 140, format: 'currency' },
1470
+ ];
1471
+
1472
+ export function SimpleTableBasic() {
1473
+ return <SimpleTable data={USERS} columns={columns} pageSize={5} getRowId={user => user.id} outline />;
1474
+ }
1475
+ ```
1476
+
1477
+ #### Через хук useSimpleTableProps
1478
+
1479
+ ```tsx
1480
+ import { SimpleColumnDef, Table, useSimpleTableProps } from '@cloud-ru/ds-table';
1481
+
1482
+ type User = {
1483
+ id: string;
1484
+ name: string;
1485
+ email: string;
1486
+ role: string;
1487
+ balance: number;
1488
+ };
1489
+
1490
+ const USERS: User[] = [
1491
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
1492
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
1493
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
1494
+ ];
1495
+
1496
+ const columns: SimpleColumnDef<User>[] = [
1497
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1498
+ { key: 'email', header: 'Email', width: 240 },
1499
+ { key: 'role', header: 'Роль', sortable: true, width: 140 },
1500
+ ];
1501
+
1502
+ export function SimpleTableWithHook() {
1503
+ const tableProps = useSimpleTableProps({
1504
+ data: USERS,
1505
+ columns,
1506
+ pageSize: 5,
1507
+ getRowId: user => user.id,
1508
+ outline: true,
1509
+ });
1510
+
1511
+ return <Table {...tableProps} />;
1512
+ }
1513
+ ```
1514
+
1515
+ #### Карточный режим
1516
+
1517
+ ```tsx
1518
+ import { SimpleColumnDef, SimpleTable, VIEW } from '@cloud-ru/ds-table';
1519
+ import { useState } from 'react';
1520
+
1521
+ type User = {
1522
+ id: string;
1523
+ name: string;
1524
+ email: string;
1525
+ role: string;
1526
+ };
1527
+
1528
+ const USERS: User[] = [
1529
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner' },
1530
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin' },
1531
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor' },
1532
+ ];
1533
+
1534
+ const columns: SimpleColumnDef<User>[] = [
1535
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1536
+ { key: 'email', header: 'Email', width: 240 },
1537
+ { key: 'role', header: 'Роль', width: 140 },
1538
+ ];
1539
+
1540
+ export function SimpleTableCardView() {
1541
+ const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
1542
+
1543
+ return (
1544
+ <SimpleTable
1545
+ data={USERS}
1546
+ columns={columns}
1547
+ pageSize={5}
1548
+ getRowId={user => user.id}
1549
+ headlineKey='name'
1550
+ view={view}
1551
+ onViewChange={setView}
1552
+ outline
1553
+ />
1554
+ );
1555
+ }
1556
+ ```
1557
+
1558
+ ## AdminTable
1559
+
1560
+ Админ-таблица: поиск, статус, выбор строк и действия с предустановленными дефолтами.
1561
+
1562
+ `AdminTable` — preset над **`Table`** для типичных админ-экранов: поиск, колонка статуса, настройки колонок, опционально фильтры, выбор строк и действия.
1563
+
1564
+ ### Когда использовать
1565
+
1566
+ - Списки сущностей с поиском и статусом на клиенте.
1567
+ - Нужен упрощённый API вместо сборки `columnDefinitions` + toolbar-пропсов вручную.
1568
+
1569
+ Когда **не** нужен:
1570
+
1571
+ - Данные с бэкенда постранично — `ServerAdminTable`.
1572
+ - Простой справочник без поиска — `SimpleTable`.
1573
+
1574
+ ### Примеры использования
1575
+
1576
+ #### Базовое использование
1577
+
1578
+ ```tsx
1579
+ import { AdminTable, SimpleColumnDef, STATUS_APPEARANCE } from '@cloud-ru/ds-table';
1580
+
1581
+ type User = {
1582
+ id: string;
1583
+ name: string;
1584
+ email: string;
1585
+ role: string;
1586
+ status: string;
1587
+ amount: number;
1588
+ };
1589
+
1590
+ const USERS: User[] = [
1591
+ {
1592
+ id: 'u-1',
1593
+ name: 'Анна Иванова',
1594
+ email: 'anna.ivanova@example.com',
1595
+ role: 'Owner',
1596
+ status: 'active',
1597
+ amount: 12990,
1598
+ },
1599
+ {
1600
+ id: 'u-2',
1601
+ name: 'Борис Петров',
1602
+ email: 'boris.petrov@example.com',
1603
+ role: 'Admin',
1604
+ status: 'pending',
1605
+ amount: 8450,
1606
+ },
1607
+ {
1608
+ id: 'u-3',
1609
+ name: 'Вера Сидорова',
1610
+ email: 'vera.sidorova@example.com',
1611
+ role: 'Editor',
1612
+ status: 'blocked',
1613
+ amount: 4300,
1614
+ },
1615
+ {
1616
+ id: 'u-4',
1617
+ name: 'Глеб Кузнецов',
1618
+ email: 'gleb.kuznetsov@example.com',
1619
+ role: 'Viewer',
1620
+ status: 'invited',
1621
+ amount: 0,
1622
+ },
1623
+ { id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', status: 'active', amount: 990 },
1624
+ ];
1625
+
1626
+ const columns: SimpleColumnDef<User>[] = [
1627
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1628
+ { key: 'email', header: 'Email', width: 240 },
1629
+ { key: 'role', header: 'Роль', sortable: true, width: 140 },
1630
+ { key: 'amount', header: 'Сумма', sortable: true, align: 'right', width: 140, format: 'currency' },
1631
+ ];
1632
+
1633
+ const statusLabels: Record<string, string> = {
1634
+ active: 'Активен',
1635
+ pending: 'Ожидание',
1636
+ blocked: 'Заблокирован',
1637
+ invited: 'Приглашён',
1638
+ };
1639
+
1640
+ export function AdminTableBasic() {
1641
+ return (
1642
+ <AdminTable
1643
+ data={USERS}
1644
+ columns={columns}
1645
+ statusColumn={{
1646
+ key: 'status',
1647
+ mapStatusToAppearance: value => {
1648
+ switch (value) {
1649
+ case 'active':
1650
+ return STATUS_APPEARANCE.Green;
1651
+ case 'pending':
1652
+ return STATUS_APPEARANCE.Yellow;
1653
+ case 'blocked':
1654
+ return STATUS_APPEARANCE.Red;
1655
+ case 'invited':
1656
+ return STATUS_APPEARANCE.Blue;
1657
+ default:
1658
+ return STATUS_APPEARANCE.Neutral;
1659
+ }
1660
+ },
1661
+ renderDescription: status => statusLabels[status] ?? status,
1662
+ }}
1663
+ pageSize={5}
1664
+ getRowId={user => user.id}
1665
+ search
1666
+ outline
1667
+ />
1668
+ );
1669
+ }
1670
+ ```
1671
+
1672
+ #### Через хук useAdminTableProps
1673
+
1674
+ ```tsx
1675
+ import { SimpleColumnDef, STATUS_APPEARANCE, Table, useAdminTableProps } from '@cloud-ru/ds-table';
1676
+
1677
+ type User = {
1678
+ id: string;
1679
+ name: string;
1680
+ email: string;
1681
+ role: string;
1682
+ status: string;
1683
+ amount: number;
1684
+ };
1685
+
1686
+ const USERS: User[] = [
1687
+ {
1688
+ id: 'u-1',
1689
+ name: 'Анна Иванова',
1690
+ email: 'anna.ivanova@example.com',
1691
+ role: 'Owner',
1692
+ status: 'active',
1693
+ amount: 12990,
1694
+ },
1695
+ {
1696
+ id: 'u-2',
1697
+ name: 'Борис Петров',
1698
+ email: 'boris.petrov@example.com',
1699
+ role: 'Admin',
1700
+ status: 'pending',
1701
+ amount: 8450,
1702
+ },
1703
+ {
1704
+ id: 'u-3',
1705
+ name: 'Вера Сидорова',
1706
+ email: 'vera.sidorova@example.com',
1707
+ role: 'Editor',
1708
+ status: 'blocked',
1709
+ amount: 4300,
1710
+ },
1711
+ ];
1712
+
1713
+ const columns: SimpleColumnDef<User>[] = [
1714
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1715
+ { key: 'email', header: 'Email', width: 240 },
1716
+ { key: 'role', header: 'Роль', sortable: true, width: 140 },
1717
+ ];
1718
+
1719
+ export function AdminTableWithHook() {
1720
+ const tableProps = useAdminTableProps({
1721
+ data: USERS,
1722
+ columns,
1723
+ statusColumn: {
1724
+ key: 'status',
1725
+ mapStatusToAppearance: value => (value === 'active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
1726
+ renderDescription: status => (status === 'active' ? 'Активен' : 'Ожидание'),
1727
+ },
1728
+ pageSize: 5,
1729
+ getRowId: user => user.id,
1730
+ search: true,
1731
+ });
1732
+
1733
+ return <Table {...tableProps} outline />;
1734
+ }
1735
+ ```
1736
+
1737
+ #### Карточный режим
1738
+
1739
+ ```tsx
1740
+ import { AdminTable, SimpleColumnDef, VIEW } from '@cloud-ru/ds-table';
1741
+ import { useState } from 'react';
1742
+
1743
+ type User = {
1744
+ id: string;
1745
+ name: string;
1746
+ email: string;
1747
+ role: string;
1748
+ amount: number;
1749
+ };
1750
+
1751
+ const USERS: User[] = [
1752
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', amount: 12990 },
1753
+ { id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', amount: 8450 },
1754
+ { id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', amount: 4300 },
1755
+ ];
1756
+
1757
+ const columns: SimpleColumnDef<User>[] = [
1758
+ { key: 'name', header: 'Имя', sortable: true, width: 200 },
1759
+ { key: 'email', header: 'Email', width: 240 },
1760
+ { key: 'role', header: 'Роль', sortable: true, width: 140 },
1761
+ ];
1762
+
1763
+ export function AdminTableCardView() {
1764
+ const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
1765
+
1766
+ return (
1767
+ <AdminTable
1768
+ data={USERS}
1769
+ columns={columns}
1770
+ pageSize={5}
1771
+ getRowId={user => user.id}
1772
+ search
1773
+ headlineKey='name'
1774
+ view={view}
1775
+ onViewChange={setView}
1776
+ outline
1777
+ />
1778
+ );
1779
+ }
1780
+ ```
1781
+
1782
+ ## TreeTable
1783
+
1784
+ Иерархическая таблица: expanding, без пагинации, с опциональным выбором строк.
1785
+
1786
+ `TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`, без пагинации.
1787
+
1788
+ ### Когда использовать
1789
+
1790
+ - Оргструктура, вложенные ресурсы, каталоги с подуровнями.
1791
+ - Нужен expand/collapse без ручной настройки `expanding` на `Table`.
1792
+
1793
+ Когда **не** нужен:
1794
+
1795
+ - Плоский список — `SimpleTable` / `AdminTable`.
1796
+ - Закрепление строк (`rowPinning`) — только на полном `Table`.
1797
+
1798
+ ### Примеры использования
1799
+
1800
+ #### Базовое дерево
1801
+
1802
+ ```tsx
1803
+ import { SimpleColumnDef, TreeTable } from '@cloud-ru/ds-table';
1804
+
1805
+ type OrgNode = {
1806
+ id: string;
1807
+ name: string;
1808
+ role: string;
1809
+ email: string;
1810
+ children?: OrgNode[];
1811
+ };
1812
+
1813
+ const TREE: OrgNode[] = [
1814
+ {
1815
+ id: 'org-1',
1816
+ name: 'Облако',
1817
+ role: 'Отдел',
1818
+ email: 'cloud@example.com',
1819
+ children: [
1820
+ { id: 'team-1', name: 'Compute', role: 'Команда', email: 'compute@example.com' },
1821
+ { id: 'team-2', name: 'Storage', role: 'Команда', email: 'storage@example.com' },
1822
+ ],
1823
+ },
1824
+ ];
1825
+
1826
+ const columns: SimpleColumnDef<OrgNode>[] = [
1827
+ { key: 'role', header: 'Тип', width: 160 },
1828
+ { key: 'email', header: 'Email', width: 240 },
1829
+ ];
1830
+
1831
+ export function TreeTableBasic() {
1832
+ return (
1833
+ <TreeTable
1834
+ data={TREE}
1835
+ getChildren={row => row.children}
1836
+ primaryColumn={{ key: 'name', header: 'Подразделение' }}
1837
+ secondaryColumns={columns}
1838
+ getRowId={row => row.id}
1839
+ expandingInitialState={{ 'org-1': true }}
1840
+ outline
1841
+ />
1842
+ );
1843
+ }
1844
+ ```
1845
+
1846
+ #### Через хук useTreeTableProps
1847
+
1848
+ ```tsx
1849
+ import { SimpleColumnDef, Table, useTreeTableProps } from '@cloud-ru/ds-table';
1850
+
1851
+ type OrgNode = {
1852
+ id: string;
1853
+ name: string;
1854
+ role: string;
1855
+ children?: OrgNode[];
1856
+ };
1857
+
1858
+ const TREE: OrgNode[] = [
1859
+ {
1860
+ id: 'org-1',
1861
+ name: 'Облако',
1862
+ role: 'Отдел',
1863
+ children: [{ id: 'team-1', name: 'Compute', role: 'Команда' }],
1864
+ },
1865
+ ];
1866
+
1867
+ const columns: SimpleColumnDef<OrgNode>[] = [{ key: 'role', header: 'Тип', width: 160 }];
1868
+
1869
+ export function TreeTableWithHook() {
1870
+ const tableProps = useTreeTableProps({
1871
+ data: TREE,
1872
+ getChildren: row => row.children,
1873
+ primaryColumn: { key: 'name', header: 'Подразделение' },
1874
+ secondaryColumns: columns,
1875
+ getRowId: row => row.id,
1876
+ expandingInitialState: { 'org-1': true },
1877
+ });
1878
+
1879
+ return <Table {...tableProps} outline />;
1880
+ }
1881
+ ```
1882
+
1883
+ #### С выбором строк
1884
+
1885
+ ```tsx
1886
+ import { SimpleColumnDef, TreeTable } from '@cloud-ru/ds-table';
1887
+
1888
+ type OrgNode = {
1889
+ id: string;
1890
+ name: string;
1891
+ role: string;
1892
+ children?: OrgNode[];
1893
+ };
1894
+
1895
+ const TREE: OrgNode[] = [
1896
+ {
1897
+ id: 'org-1',
1898
+ name: 'Облако',
1899
+ role: 'Отдел',
1900
+ children: [
1901
+ { id: 'team-1', name: 'Compute', role: 'Команда' },
1902
+ { id: 'team-2', name: 'Storage', role: 'Команда' },
1903
+ ],
1904
+ },
1905
+ ];
1906
+
1907
+ const columns: SimpleColumnDef<OrgNode>[] = [{ key: 'role', header: 'Тип', width: 160 }];
1908
+
1909
+ export function TreeTableWithSelection() {
1910
+ return (
1911
+ <TreeTable
1912
+ data={TREE}
1913
+ getChildren={row => row.children}
1914
+ primaryColumn={{ key: 'name', header: 'Подразделение', showToggle: true }}
1915
+ secondaryColumns={columns}
1916
+ getRowId={row => row.id}
1917
+ expandingInitialState={{ 'org-1': true }}
1918
+ selection={{ multiRow: true, initialState: { 'team-1': true } }}
1919
+ outline
1920
+ />
1921
+ );
1922
+ }
1923
+ ```
1924
+
1925
+ ## InfiniteTable
1926
+
1927
+ Таблица с бесконечной прокруткой: infiniteLoading, scrollRef и виртуализация строк из коробки.
1928
+
1929
+ `InfiniteTable` — preset для длинных списков без пагинации: включает `infiniteLoading`, подключает `scrollRef` и `IntersectionObserver` через `onLoadMore` / `hasMore`, по умолчанию включает виртуализацию строк (`enableRowVirtualization`).
1930
+
1931
+ ### Когда использовать
1932
+
1933
+ - Лента записей с подгрузкой при скролле.
1934
+ - Не нужна постраничная навигация.
1935
+
1936
+ Когда **не** нужен:
1937
+
1938
+ - Классическая пагинация — `SimpleTable` / `ServerTable`.
1939
+ - Нужен полный контроль над виртуализацией колонок или кастомными параметрами virtualizer — базовый `Table`.
1940
+
1941
+ Чтобы отключить виртуализацию строк: `enableRowVirtualization={false}`.
1942
+
1943
+ ### Примеры использования
1944
+
1945
+ #### Подгрузка при скролле
1946
+
1947
+ ```tsx
1948
+ import { InfiniteTable, SimpleColumnDef } from '@cloud-ru/ds-table';
1949
+ import { useCallback, useState } from 'react';
1950
+
1951
+ type User = {
1952
+ id: string;
1953
+ name: string;
1954
+ email: string;
1955
+ role: string;
1956
+ };
1957
+
1958
+ const ALL_USERS: User[] = Array.from({ length: 20 }, (_, index) => ({
1959
+ id: `u-${index + 1}`,
1960
+ name: `Пользователь ${index + 1}`,
1961
+ email: `user${index + 1}@example.com`,
1962
+ role: index % 2 === 0 ? 'Editor' : 'Viewer',
1963
+ }));
1964
+
1965
+ const columns: SimpleColumnDef<User>[] = [
1966
+ { key: 'name', header: 'Имя', width: 200 },
1967
+ { key: 'email', header: 'Email', width: 240 },
1968
+ { key: 'role', header: 'Роль', width: 140 },
1969
+ ];
1970
+
1971
+ const PAGE = 5;
1972
+
1973
+ export function InfiniteTableBasic() {
1974
+ const [items, setItems] = useState(() => ALL_USERS.slice(0, PAGE));
1975
+ const [loading, setLoading] = useState(false);
1976
+ const hasMore = items.length < ALL_USERS.length;
1977
+
1978
+ const onLoadMore = useCallback(() => {
1979
+ setLoading(true);
1980
+ window.setTimeout(() => {
1981
+ setItems(ALL_USERS.slice(0, Math.min(items.length + PAGE, ALL_USERS.length)));
1982
+ setLoading(false);
1983
+ }, 300);
1984
+ }, [items.length]);
1985
+
1986
+ return (
1987
+ <div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 360 }}>
1988
+ <InfiniteTable
1989
+ data={items}
1990
+ columns={columns}
1991
+ getRowId={user => user.id}
1992
+ loading={loading}
1993
+ hasMore={hasMore}
1994
+ onLoadMore={onLoadMore}
1995
+ outline
1996
+ />
1997
+ </div>
1998
+ );
1999
+ }
2000
+ ```
2001
+
2002
+ #### Через хук useInfiniteTableProps
2003
+
2004
+ ```tsx
2005
+ import { SimpleColumnDef, Table, useInfiniteTableProps } from '@cloud-ru/ds-table';
2006
+ import { useCallback, useState } from 'react';
2007
+
2008
+ type User = { id: string; name: string; email: string };
2009
+
2010
+ const ALL_USERS: User[] = Array.from({ length: 12 }, (_, index) => ({
2011
+ id: `u-${index + 1}`,
2012
+ name: `Пользователь ${index + 1}`,
2013
+ email: `user${index + 1}@example.com`,
2014
+ }));
2015
+
2016
+ const columns: SimpleColumnDef<User>[] = [
2017
+ { key: 'name', header: 'Имя', width: 200 },
2018
+ { key: 'email', header: 'Email', width: 240 },
2019
+ ];
2020
+
2021
+ const PAGE = 4;
2022
+
2023
+ export function InfiniteTableWithHook() {
2024
+ const [items, setItems] = useState(() => ALL_USERS.slice(0, PAGE));
2025
+ const [loading, setLoading] = useState(false);
2026
+ const hasMore = items.length < ALL_USERS.length;
2027
+
2028
+ const onLoadMore = useCallback(() => {
2029
+ setLoading(true);
2030
+ window.setTimeout(() => {
2031
+ setItems(ALL_USERS.slice(0, Math.min(items.length + PAGE, ALL_USERS.length)));
2032
+ setLoading(false);
2033
+ }, 300);
2034
+ }, [items.length]);
2035
+
2036
+ const tableProps = useInfiniteTableProps({
2037
+ data: items,
2038
+ columns,
2039
+ getRowId: user => user.id,
2040
+ loading,
2041
+ hasMore,
2042
+ onLoadMore,
2043
+ });
2044
+
2045
+ return (
2046
+ <div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 360 }}>
2047
+ <Table {...tableProps} outline />
2048
+ </div>
2049
+ );
2050
+ }
2051
+ ```
2052
+
2053
+ #### Без подгрузки (hasMore: false)
2054
+
2055
+ ```tsx
2056
+ import { InfiniteTable, SimpleColumnDef } from '@cloud-ru/ds-table';
2057
+
2058
+ type User = { id: string; name: string; email: string };
2059
+
2060
+ const USERS: User[] = [
2061
+ { id: 'u-1', name: 'Анна Иванова', email: 'anna@example.com' },
2062
+ { id: 'u-2', name: 'Борис Петров', email: 'boris@example.com' },
2063
+ ];
2064
+
2065
+ const columns: SimpleColumnDef<User>[] = [
2066
+ { key: 'name', header: 'Имя', width: 200 },
2067
+ { key: 'email', header: 'Email', width: 240 },
2068
+ ];
2069
+
2070
+ export function InfiniteTableStatic() {
2071
+ return (
2072
+ <div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 280 }}>
2073
+ <InfiniteTable data={USERS} columns={columns} getRowId={user => user.id} hasMore={false} outline />
2074
+ </div>
2075
+ );
2076
+ }
2077
+ ```
2078
+
2079
+ ## EntitiesTable
2080
+
2081
+ Server-driven список сущностей: state пагинации/поиска, queryFn и product-дефолты поверх ServerTable.
2082
+
2083
+ `EntitiesTable` — product-preset над **`ServerTable`** для экранов «список сущностей с бэкенда»: локальный state (`offset`, `limit`, `search`, `sorting`), вызов `queryFn` и предустановленные дефолты (`savedState`, drag колонок, пагинация `[10, 25, 50, 100]`).
2084
+
2085
+ ### Когда использовать
2086
+
2087
+ - Миграция с `@cloud-ru/uikit-product-entities-table` — тот же вход: `columnDefinitions` + `queryFn`.
2088
+ - Нужен единый glue для react-query (или совместимого query-хука) без ручной сборки `ServerTable` props.
2089
+
2090
+ Когда **не** нужен:
2091
+
2092
+ - Ручной fetch и упрощённый API (`columns`, `statusColumn`) — **`ServerAdminTable`**.
2093
+ - Клиентские данные в памяти — **`AdminTable`** или **`SimpleTable`**.
2094
+
2095
+ #### EntitiesTable vs ServerAdminTable
2096
+
2097
+ | | `EntitiesTable` | `ServerAdminTable` |
2098
+ | --- | --- | --- |
2099
+ | Вход колонок | `columnDefinitions` | `columns` + `statusColumn` / `rowActions` |
2100
+ | Данные | `queryFn` (custom hook на render) | `items` / `total` / `loading` вручную |
2101
+ | State пагинации | внутри (`useEntitiesTableState`) | снаружи |
2102
+ | `savedState` | из обязательного `id` | не задаётся preset-ом |
2103
+ | Drag колонок | включён по умолчанию | только меню настроек |
2104
+
2105
+ Оба preset-а валидны; выбор — по входному API и способу загрузки данных.
2106
+
2107
+ #### Переход на ServerAdminTable
2108
+
2109
+ Если экран укладывается в `columns` + `statusColumn` и вы сами управляете fetch — уберите `queryFn`, state страницы вынесите наружу, колонки упростите. `savedState` из `id` не переносится; drag — через `columnsSettings`.
2110
+
2111
+ ```tsx
2112
+ // Было
2113
+ <EntitiesTable id="entities" queryFn={useEntitiesQuery} columnDefinitions={columnDefinitions} getRowId={row => row.id} />
2114
+
2115
+ // Стало: items/total/loading + offset/limit/search снаружи
2116
+ <ServerAdminTable
2117
+ items={items}
2118
+ total={total}
2119
+ offset={offset}
2120
+ limit={limit}
2121
+ loading={loading}
2122
+ columns={columns}
2123
+ statusColumn={statusColumn}
2124
+ getRowId={row => row.id}
2125
+ onChangePage={(nextOffset, nextLimit) => { setOffset(nextOffset); setLimit(nextLimit); }}
2126
+ search={{ state: search, onChange: value => { setOffset(0); setSearch(value); } }}
2127
+ columnsSettings={{ enableDrag: true, enableSettingsMenu: true }}
2128
+ />
2129
+ ```
2130
+
2131
+ ### Примеры использования
2132
+
2133
+ {/* client:only='react': SSR демо невозможен — @cloud-ru/ds-table тянет toolbar с directory-imports (см. table.mdx). */}
2134
+
2135
+ #### Базовое использование
2136
+
2137
+ ```tsx
2138
+ import {
2139
+ ColumnDefinition,
2140
+ EntitiesTable,
2141
+ getRowActionsColumnDef,
2142
+ getStatusColumnDef,
2143
+ STATUS_APPEARANCE,
2144
+ } from '@cloud-ru/ds-table';
2145
+
2146
+ type Entity = {
2147
+ id: string;
2148
+ name: string;
2149
+ status: 'Active' | 'Paused';
2150
+ owner: string;
2151
+ };
2152
+
2153
+ const ENTITIES: Entity[] = [
2154
+ { id: 'e-1', name: 'Compute cluster', status: 'Active', owner: 'Anna' },
2155
+ { id: 'e-2', name: 'Object storage', status: 'Paused', owner: 'Boris' },
2156
+ { id: 'e-3', name: 'CDN edge', status: 'Active', owner: 'Vera' },
2157
+ ];
2158
+
2159
+ const columnDefinitions: ColumnDefinition<Entity>[] = [
2160
+ getStatusColumnDef({
2161
+ accessorKey: 'status',
2162
+ header: 'Status',
2163
+ size: 120,
2164
+ mapStatusToAppearance: value => (value === 'Active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
2165
+ renderDescription: value => String(value),
2166
+ }),
2167
+ { id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
2168
+ { id: 'owner', accessorKey: 'owner', header: 'Owner', enableSorting: true },
2169
+ getRowActionsColumnDef({
2170
+ actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
2171
+ }),
2172
+ ];
2173
+
2174
+ function useEntitiesQuery({
2175
+ params,
2176
+ }: {
2177
+ params: { offset: number; limit: number; search?: string; ordering?: string };
2178
+ }) {
2179
+ const normalizedSearch = params.search?.trim().toLowerCase() ?? '';
2180
+ const filtered = normalizedSearch
2181
+ ? ENTITIES.filter(entity => entity.name.toLowerCase().includes(normalizedSearch))
2182
+ : ENTITIES;
2183
+
2184
+ return {
2185
+ data: {
2186
+ total: filtered.length,
2187
+ data: filtered.slice(params.offset, params.offset + params.limit),
2188
+ },
2189
+ isLoading: false,
2190
+ isFetching: false,
2191
+ isError: false,
2192
+ isSuccess: true,
2193
+ refetch: () => {},
2194
+ };
2195
+ }
2196
+
2197
+ export function EntitiesTableBasic() {
2198
+ return (
2199
+ <EntitiesTable<Entity, { params: { offset: number; limit: number; search?: string; ordering?: string } }>
2200
+ id='entities-table-basic'
2201
+ queryFn={useEntitiesQuery}
2202
+ columnDefinitions={columnDefinitions}
2203
+ defaultLimit={5}
2204
+ searchPlaceholder='Search entities'
2205
+ getRowId={entity => entity.id}
2206
+ />
2207
+ );
2208
+ }
2209
+ ```
2210
+
2211
+ #### Через useEntitiesTableState + useEntitiesTableProps
2212
+
2213
+ ```tsx
2214
+ import {
2215
+ ColumnDefinition,
2216
+ getRowActionsColumnDef,
2217
+ getStatusColumnDef,
2218
+ ServerTable,
2219
+ STATUS_APPEARANCE,
2220
+ useEntitiesTableProps,
2221
+ useEntitiesTableState,
2222
+ } from '@cloud-ru/ds-table';
2223
+
2224
+ type Entity = {
2225
+ id: string;
2226
+ name: string;
2227
+ status: 'Active' | 'Paused';
2228
+ owner: string;
2229
+ };
2230
+
2231
+ const ENTITIES: Entity[] = [
2232
+ { id: 'e-1', name: 'Compute cluster', status: 'Active', owner: 'Anna' },
2233
+ { id: 'e-2', name: 'Object storage', status: 'Paused', owner: 'Boris' },
2234
+ { id: 'e-3', name: 'CDN edge', status: 'Active', owner: 'Vera' },
2235
+ ];
2236
+
2237
+ const columnDefinitions: ColumnDefinition<Entity>[] = [
2238
+ getStatusColumnDef({
2239
+ accessorKey: 'status',
2240
+ header: 'Status',
2241
+ size: 120,
2242
+ mapStatusToAppearance: value => (value === 'Active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
2243
+ renderDescription: value => String(value),
2244
+ }),
2245
+ { id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
2246
+ { id: 'owner', accessorKey: 'owner', header: 'Owner', enableSorting: true },
2247
+ getRowActionsColumnDef({
2248
+ actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
2249
+ }),
2250
+ ];
2251
+
2252
+ function useEntitiesQuery({
2253
+ params,
2254
+ }: {
2255
+ params: { offset: number; limit: number; search?: string; ordering?: string };
2256
+ }) {
2257
+ const normalizedSearch = params.search?.trim().toLowerCase() ?? '';
2258
+ const filtered = normalizedSearch
2259
+ ? ENTITIES.filter(entity => entity.name.toLowerCase().includes(normalizedSearch))
2260
+ : ENTITIES;
2261
+
2262
+ return {
2263
+ data: {
2264
+ total: filtered.length,
2265
+ data: filtered.slice(params.offset, params.offset + params.limit),
2266
+ },
2267
+ isLoading: false,
2268
+ isFetching: false,
2269
+ isError: false,
2270
+ isSuccess: true,
2271
+ refetch: () => {},
2272
+ };
2273
+ }
2274
+
2275
+ export function EntitiesTableWithHook() {
2276
+ const tableState = useEntitiesTableState({ defaultLimit: 5 });
2277
+ const params = { params: tableState.paginationParams } as {
2278
+ params: { offset: number; limit: number; search?: string; ordering?: string };
2279
+ };
2280
+ const query = useEntitiesQuery(params);
2281
+
2282
+ const tableProps = useEntitiesTableProps({
2283
+ input: {
2284
+ id: 'entities-table-with-hook',
2285
+ columnDefinitions,
2286
+ searchPlaceholder: 'Search entities',
2287
+ getRowId: (entity: Entity) => entity.id,
2288
+ },
2289
+ tableState,
2290
+ query,
2291
+ });
2292
+
2293
+ return <ServerTable {...tableProps} />;
2294
+ }
2295
+ ```
2296
+
2297
+ #### С серверными фильтрами
2298
+
2299
+ ```tsx
2300
+ import { FiltersState } from '@cloud-ru/ds-chips';
2301
+ import {
2302
+ ColumnDefinition,
2303
+ EntitiesTable,
2304
+ getRowActionsColumnDef,
2305
+ getStatusColumnDef,
2306
+ STATUS_APPEARANCE,
2307
+ } from '@cloud-ru/ds-table';
2308
+
2309
+ type Entity = {
2310
+ id: string;
2311
+ name: string;
2312
+ status: 'Active' | 'Paused' | 'Archived';
2313
+ service: string;
2314
+ };
2315
+
2316
+ type QueryParams = FiltersState & {
2317
+ params: { offset: number; limit: number; search?: string; ordering?: string };
2318
+ single?: string;
2319
+ };
2320
+
2321
+ const ENTITIES: Entity[] = [
2322
+ { id: 'e-1', name: 'Compute cluster', status: 'Active', service: 'compute' },
2323
+ { id: 'e-2', name: 'Object storage', status: 'Paused', service: 'storage' },
2324
+ { id: 'e-3', name: 'CDN edge', status: 'Archived', service: 'cdn' },
2325
+ ];
2326
+
2327
+ const columnDefinitions: ColumnDefinition<Entity>[] = [
2328
+ getStatusColumnDef({
2329
+ accessorKey: 'status',
2330
+ header: 'Status',
2331
+ size: 120,
2332
+ mapStatusToAppearance: value => {
2333
+ if (value === 'Active') return STATUS_APPEARANCE.Green;
2334
+ if (value === 'Paused') return STATUS_APPEARANCE.Yellow;
2335
+ return STATUS_APPEARANCE.Neutral;
2336
+ },
2337
+ renderDescription: value => String(value),
2338
+ }),
2339
+ { id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
2340
+ { id: 'service', accessorKey: 'service', header: 'Service', enableSorting: true },
2341
+ getRowActionsColumnDef({
2342
+ actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
2343
+ }),
2344
+ ];
2345
+
2346
+ function useEntitiesQuery(queryProps: QueryParams) {
2347
+ const { params, single } = queryProps;
2348
+ const filtered = ENTITIES.filter(entity => {
2349
+ const matchesSearch = !params.search || entity.name.toLowerCase().includes(params.search.toLowerCase());
2350
+ const matchesStatus = !single || entity.status.toLowerCase() === single.toLowerCase();
2351
+
2352
+ return matchesSearch && matchesStatus;
2353
+ });
2354
+
2355
+ return {
2356
+ data: {
2357
+ total: filtered.length,
2358
+ data: filtered.slice(params.offset, params.offset + params.limit),
2359
+ },
2360
+ isLoading: false,
2361
+ isFetching: false,
2362
+ isError: false,
2363
+ isSuccess: true,
2364
+ refetch: () => {},
2365
+ };
2366
+ }
2367
+
2368
+ export function EntitiesTableWithFilters() {
2369
+ return (
2370
+ <EntitiesTable<Entity, QueryParams>
2371
+ id='entities-table-with-filters'
2372
+ queryFn={useEntitiesQuery}
2373
+ columnDefinitions={columnDefinitions}
2374
+ defaultLimit={5}
2375
+ searchPlaceholder='Search entities'
2376
+ getRowId={entity => entity.id}
2377
+ columnFilters={{
2378
+ filters: [
2379
+ {
2380
+ id: 'single',
2381
+ type: 'single',
2382
+ label: 'Status',
2383
+ pinned: true,
2384
+ options: [
2385
+ { value: 'active', label: 'Active' },
2386
+ { value: 'paused', label: 'Paused' },
2387
+ { value: 'archived', label: 'Archived' },
2388
+ ],
2389
+ },
2390
+ ],
2391
+ }}
2392
+ />
2393
+ );
2394
+ }
2395
+ ```
2396
+
2397
+ ### Props
2398
+
2399
+ | Prop | Type | Default | Description |
2400
+ |------|------|---------|-------------|
2401
+ | `autoResetPageIndex` | `boolean` | — | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
2402
+ | `bulkActions` | `BulkAction[]` | — | Список действий для массовых операций |
2403
+ | `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
2404
+ | `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
2405
+ | `className` | `string` | — | CSS-класс |
2406
+ | `columnDefinitions` | `ColumnDefinition<T>[]` | — | Определение внешнего вида и функционала колонок |
2407
+ | `columnFilters` | `(Omit<ChipChoiceRowProps<P>, "data-test-id" \| "size"> & { open?: boolean; initialOpen?: boolean; onOpenChange?(isOpen: boolean): void; } & { ...; }) \| undefined` | — | Фильтры |
2408
+ | `columnVirtualizerInstanceRef` | `MutableRefObject<ColumnVirtualizer>` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
2409
+ | `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
2410
+ | `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
2411
+ | `data-test-id` | `string` | — | |
2412
+ | `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
2413
+ | `defaultLimit` | `number` | — | |
2414
+ | `defaultOffset` | `number` | — | |
2415
+ | `defaultSearch` | `string` | — | |
2416
+ | `defaultSort` | `SortingState` | — | |
2417
+ | `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
2418
+ | `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
2419
+ | `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
2420
+ | `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
2421
+ | `enableSelectPinned` | `boolean` | — | Параметр отвечает за чекбокс выбора закрепленных строк |
2422
+ | `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
2423
+ | `expanding` | `{ getSubRows: (element: T) => T[]; expandingColumnDefinition: TreeColumnDefinitionProps<T>; initialState?: ExpandedState; state?: ExpandedState \| undefined; onChange?(state: ExpandedState): void; } \| undefined` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
2424
+ | `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
2425
+ | `getRowBackgroundColor` | `((data: T) => TableRowColor)` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
2426
+ | `getRowId` | `((originalRow: T, index: number, parent?: Row<T>) => string)` | — | Функция получения уникального идентификатора строки |
2427
+ | `hasMore` | `undefined` | — | |
2428
+ | `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
2429
+ | `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
2430
+ | `id` | `string` | — | |
2431
+ | `infiniteLoading` | `undefined` | — | |
2432
+ | `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
2433
+ | `layoutPresets` | `Partial<Record<LayoutType, Partial<TableLayoutDefaults>>>` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
2434
+ | `loadMoreTrigger` | `undefined` | — | |
2435
+ | `manualFiltering` | `boolean` | — | |
2436
+ | `manualPagination` | `boolean` | — | |
2437
+ | `manualSorting` | `boolean` | — | |
2438
+ | `moreActions` | `Action[]` | — | Элементы выпадающего списка кнопки с действиями |
2439
+ | `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
2440
+ | `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
2441
+ | `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
2442
+ | `onLoadMore` | `undefined` | — | |
2443
+ | `onPaginationOrDataChange` | `((data: T[]) => void)` | — | |
2444
+ | `onQuerySuccess` | `(() => void)` | — | |
2445
+ | `onRowClick` | `RowClickHandler<T>` | — | Колбэк клика по строке |
2446
+ | `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
2447
+ | `queryFn` | `EntityQueryFn<P, T>` | — | |
2448
+ | `queryProps` | `Omit<P, "params">` | — | |
2449
+ | `ref` | `Ref<EntitiesTableHandle<T>>` | — | |
2450
+ | `renderCard` | `((context: RenderCardContext<T>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
2451
+ | `rowAutoHeight` | `boolean` | — | |
2452
+ | `rowPinning` | `Pick<RowPinningState, "top">` | — | Определение, какие строки должны быть закреплены в таблице |
2453
+ | `rowSelection` | `{ initialState?: RowSelectionState; state?: RowSelectionState; enable?: boolean \| ((row: Row<T>) => boolean) \| undefined; multiRow?: boolean \| undefined; onChange?(state: RowSelectionState): void; appearance?: RowAppearance \| undefined; } \| undefined` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
2454
+ | `rowVirtualizerInstanceRef` | `MutableRefObject<RowVirtualizer>` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
2455
+ | `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
2456
+ | `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
2457
+ | `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
2458
+ | `searchPlaceholder` | `string` | — | |
2459
+ | `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
2460
+ | `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
2461
+ | `suppressHeader` | `boolean` | — | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
2462
+ | `suppressPagination` | `boolean` | — | Отключение пагинации |
2463
+ | `suppressSearch` | `boolean` | — | Отключение поиска |
2464
+ | `suppressToolbar` | `boolean` | — | Отключение тулбара |
2465
+ | `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
2466
+ | `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
2467
+
2468
+ ### Смотри также
2469
+
2470
+ - **`ServerAdminTable`** — ручной fetch и упрощённый API колонок.
2471
+ - **`ServerTable`** — escape hatch без product-дефолтов.