@tanstack/table-core 8.19.2 → 9.0.0-alpha.10

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 (302) hide show
  1. package/dist/cjs/aggregationFns.cjs +94 -0
  2. package/dist/cjs/aggregationFns.cjs.map +1 -0
  3. package/dist/cjs/aggregationFns.d.cts +14 -0
  4. package/dist/cjs/columnHelper.cjs +19 -0
  5. package/dist/cjs/columnHelper.cjs.map +1 -0
  6. package/dist/cjs/columnHelper.d.cts +9 -0
  7. package/dist/cjs/core/cell.cjs +38 -0
  8. package/dist/cjs/core/cell.cjs.map +1 -0
  9. package/dist/cjs/core/cell.d.cts +50 -0
  10. package/dist/cjs/core/column.cjs +81 -0
  11. package/dist/cjs/core/column.cjs.map +1 -0
  12. package/dist/cjs/core/column.d.cts +56 -0
  13. package/dist/cjs/core/headers.cjs +310 -0
  14. package/dist/cjs/core/headers.cjs.map +1 -0
  15. package/dist/cjs/core/headers.d.cts +195 -0
  16. package/dist/cjs/core/row.cjs +92 -0
  17. package/dist/cjs/core/row.cjs.map +1 -0
  18. package/dist/cjs/core/row.d.cts +92 -0
  19. package/dist/cjs/core/table.cjs +232 -0
  20. package/dist/cjs/core/table.cjs.map +1 -0
  21. package/dist/cjs/core/table.d.cts +229 -0
  22. package/dist/cjs/features/ColumnFaceting.cjs +29 -0
  23. package/dist/cjs/features/ColumnFaceting.cjs.map +1 -0
  24. package/dist/cjs/features/ColumnFaceting.d.cts +35 -0
  25. package/dist/cjs/features/ColumnFiltering.cjs +137 -0
  26. package/dist/cjs/features/ColumnFiltering.cjs.map +1 -0
  27. package/dist/cjs/features/ColumnFiltering.d.cts +195 -0
  28. package/dist/cjs/features/ColumnGrouping.cjs +133 -0
  29. package/dist/cjs/features/ColumnGrouping.cjs.map +1 -0
  30. package/dist/cjs/features/ColumnGrouping.d.cts +202 -0
  31. package/dist/cjs/features/ColumnOrdering.cjs +76 -0
  32. package/dist/cjs/features/ColumnOrdering.cjs.map +1 -0
  33. package/dist/cjs/features/ColumnOrdering.d.cts +54 -0
  34. package/dist/cjs/features/ColumnPinning.cjs +145 -0
  35. package/dist/cjs/features/ColumnPinning.cjs.map +1 -0
  36. package/dist/cjs/features/ColumnPinning.d.cts +127 -0
  37. package/dist/cjs/features/ColumnSizing.cjs +307 -0
  38. package/dist/cjs/features/ColumnSizing.cjs.map +1 -0
  39. package/dist/cjs/features/ColumnSizing.d.cts +194 -0
  40. package/dist/cjs/features/ColumnVisibility.cjs +144 -0
  41. package/dist/cjs/features/ColumnVisibility.cjs.map +1 -0
  42. package/dist/cjs/features/ColumnVisibility.d.cts +130 -0
  43. package/dist/cjs/features/GlobalFaceting.cjs +29 -0
  44. package/dist/cjs/features/GlobalFaceting.cjs.map +1 -0
  45. package/dist/cjs/features/GlobalFaceting.d.cts +27 -0
  46. package/dist/cjs/features/GlobalFiltering.cjs +50 -0
  47. package/dist/cjs/features/GlobalFiltering.cjs.map +1 -0
  48. package/dist/cjs/features/GlobalFiltering.d.cts +80 -0
  49. package/dist/cjs/features/RowExpanding.cjs +152 -0
  50. package/dist/cjs/features/RowExpanding.cjs.map +1 -0
  51. package/dist/cjs/features/RowExpanding.d.cts +155 -0
  52. package/dist/cjs/features/RowPagination.cjs +161 -0
  53. package/dist/cjs/features/RowPagination.cjs.map +1 -0
  54. package/dist/cjs/features/RowPagination.d.cts +166 -0
  55. package/dist/cjs/features/RowPinning.cjs +132 -0
  56. package/dist/cjs/features/RowPinning.cjs.map +1 -0
  57. package/dist/cjs/features/RowPinning.d.cts +99 -0
  58. package/dist/cjs/features/RowSelection.cjs +296 -0
  59. package/dist/cjs/features/RowSelection.cjs.map +1 -0
  60. package/dist/cjs/features/RowSelection.d.cts +177 -0
  61. package/dist/cjs/features/RowSorting.cjs +200 -0
  62. package/dist/cjs/features/RowSorting.cjs.map +1 -0
  63. package/dist/cjs/features/RowSorting.d.cts +238 -0
  64. package/dist/cjs/filterFns.cjs +88 -0
  65. package/dist/cjs/filterFns.cjs.map +1 -0
  66. package/dist/cjs/filterFns.d.cts +14 -0
  67. package/{build/lib/index.js → dist/cjs/index.cjs} +41 -53
  68. package/dist/cjs/index.cjs.map +1 -0
  69. package/dist/cjs/index.d.cts +34 -0
  70. package/{build/lib/sortingFns.js → dist/cjs/sortingFns.cjs} +23 -52
  71. package/dist/cjs/sortingFns.cjs.map +1 -0
  72. package/dist/cjs/sortingFns.d.cts +12 -0
  73. package/dist/cjs/types.d.cts +120 -0
  74. package/{build/lib/utils/filterRowsUtils.js → dist/cjs/utils/filterRowsUtils.cjs} +34 -46
  75. package/dist/cjs/utils/filterRowsUtils.cjs.map +1 -0
  76. package/dist/cjs/utils/filterRowsUtils.d.cts +3 -0
  77. package/dist/cjs/utils/getCoreRowModel.cjs +54 -0
  78. package/dist/cjs/utils/getCoreRowModel.cjs.map +1 -0
  79. package/dist/cjs/utils/getCoreRowModel.d.cts +3 -0
  80. package/dist/cjs/utils/getExpandedRowModel.cjs +41 -0
  81. package/dist/cjs/utils/getExpandedRowModel.cjs.map +1 -0
  82. package/dist/cjs/utils/getExpandedRowModel.d.cts +8 -0
  83. package/dist/cjs/utils/getFacetedMinMaxValues.cjs +35 -0
  84. package/dist/cjs/utils/getFacetedMinMaxValues.cjs.map +1 -0
  85. package/dist/cjs/utils/getFacetedMinMaxValues.d.cts +3 -0
  86. package/dist/cjs/utils/getFacetedRowModel.cjs +35 -0
  87. package/dist/cjs/utils/getFacetedRowModel.cjs.map +1 -0
  88. package/dist/cjs/utils/getFacetedRowModel.d.cts +3 -0
  89. package/dist/cjs/utils/getFacetedUniqueValues.cjs +37 -0
  90. package/dist/cjs/utils/getFacetedUniqueValues.cjs.map +1 -0
  91. package/dist/cjs/utils/getFacetedUniqueValues.d.cts +3 -0
  92. package/dist/cjs/utils/getFilteredRowModel.cjs +116 -0
  93. package/dist/cjs/utils/getFilteredRowModel.cjs.map +1 -0
  94. package/dist/cjs/utils/getFilteredRowModel.d.cts +3 -0
  95. package/dist/cjs/utils/getGroupedRowModel.cjs +118 -0
  96. package/dist/cjs/utils/getGroupedRowModel.cjs.map +1 -0
  97. package/dist/cjs/utils/getGroupedRowModel.d.cts +3 -0
  98. package/dist/cjs/utils/getPaginationRowModel.cjs +49 -0
  99. package/dist/cjs/utils/getPaginationRowModel.cjs.map +1 -0
  100. package/dist/cjs/utils/getPaginationRowModel.d.cts +5 -0
  101. package/dist/cjs/utils/getSortedRowModel.cjs +88 -0
  102. package/dist/cjs/utils/getSortedRowModel.cjs.map +1 -0
  103. package/dist/cjs/utils/getSortedRowModel.d.cts +3 -0
  104. package/{build/lib/utils.js → dist/cjs/utils.cjs} +26 -39
  105. package/dist/cjs/utils.cjs.map +1 -0
  106. package/dist/cjs/utils.d.cts +39 -0
  107. package/{build/lib → dist/esm}/aggregationFns.d.ts +2 -1
  108. package/dist/esm/aggregationFns.js +94 -0
  109. package/dist/esm/aggregationFns.js.map +1 -0
  110. package/{build/lib → dist/esm}/columnHelper.d.ts +3 -2
  111. package/dist/esm/columnHelper.js +19 -0
  112. package/{build/lib → dist/esm}/columnHelper.js.map +1 -1
  113. package/{build/lib → dist/esm}/core/cell.d.ts +2 -1
  114. package/dist/esm/core/cell.js +38 -0
  115. package/dist/esm/core/cell.js.map +1 -0
  116. package/{build/lib → dist/esm}/core/column.d.ts +2 -1
  117. package/dist/esm/core/column.js +81 -0
  118. package/dist/esm/core/column.js.map +1 -0
  119. package/{build/lib → dist/esm}/core/headers.d.ts +1 -0
  120. package/dist/esm/core/headers.js +310 -0
  121. package/dist/esm/core/headers.js.map +1 -0
  122. package/{build/lib → dist/esm}/core/row.d.ts +2 -1
  123. package/dist/esm/core/row.js +92 -0
  124. package/dist/esm/core/row.js.map +1 -0
  125. package/{build/lib → dist/esm}/core/table.d.ts +10 -1
  126. package/dist/esm/core/table.js +232 -0
  127. package/dist/esm/core/table.js.map +1 -0
  128. package/{build/lib → dist/esm}/features/ColumnFaceting.d.ts +1 -0
  129. package/{build/lib → dist/esm}/features/ColumnFaceting.js +6 -19
  130. package/{build/lib → dist/esm}/features/ColumnFaceting.js.map +1 -1
  131. package/{build/lib → dist/esm}/features/ColumnFiltering.d.ts +1 -0
  132. package/dist/esm/features/ColumnFiltering.js +137 -0
  133. package/dist/esm/features/ColumnFiltering.js.map +1 -0
  134. package/{build/lib → dist/esm}/features/ColumnGrouping.d.ts +1 -0
  135. package/dist/esm/features/ColumnGrouping.js +133 -0
  136. package/dist/esm/features/ColumnGrouping.js.map +1 -0
  137. package/{build/lib → dist/esm}/features/ColumnOrdering.d.ts +1 -0
  138. package/dist/esm/features/ColumnOrdering.js +76 -0
  139. package/dist/esm/features/ColumnOrdering.js.map +1 -0
  140. package/{build/lib → dist/esm}/features/ColumnPinning.d.ts +1 -0
  141. package/dist/esm/features/ColumnPinning.js +145 -0
  142. package/dist/esm/features/ColumnPinning.js.map +1 -0
  143. package/{build/lib → dist/esm}/features/ColumnSizing.d.ts +2 -1
  144. package/dist/esm/features/ColumnSizing.js +307 -0
  145. package/dist/esm/features/ColumnSizing.js.map +1 -0
  146. package/{build/lib → dist/esm}/features/ColumnVisibility.d.ts +1 -0
  147. package/dist/esm/features/ColumnVisibility.js +144 -0
  148. package/dist/esm/features/ColumnVisibility.js.map +1 -0
  149. package/{build/lib → dist/esm}/features/GlobalFaceting.d.ts +1 -0
  150. package/{build/lib → dist/esm}/features/GlobalFaceting.js +8 -21
  151. package/dist/esm/features/GlobalFaceting.js.map +1 -0
  152. package/{build/lib → dist/esm}/features/GlobalFiltering.d.ts +1 -0
  153. package/dist/esm/features/GlobalFiltering.js +50 -0
  154. package/dist/esm/features/GlobalFiltering.js.map +1 -0
  155. package/{build/lib → dist/esm}/features/RowExpanding.d.ts +1 -0
  156. package/{build/lib → dist/esm}/features/RowExpanding.js +37 -58
  157. package/dist/esm/features/RowExpanding.js.map +1 -0
  158. package/{build/lib → dist/esm}/features/RowPagination.d.ts +1 -0
  159. package/dist/esm/features/RowPagination.js +161 -0
  160. package/dist/esm/features/RowPagination.js.map +1 -0
  161. package/{build/lib → dist/esm}/features/RowPinning.d.ts +1 -0
  162. package/dist/esm/features/RowPinning.js +132 -0
  163. package/dist/esm/features/RowPinning.js.map +1 -0
  164. package/{build/lib → dist/esm}/features/RowSelection.d.ts +1 -0
  165. package/dist/esm/features/RowSelection.js +296 -0
  166. package/dist/esm/features/RowSelection.js.map +1 -0
  167. package/{build/lib → dist/esm}/features/RowSorting.d.ts +1 -0
  168. package/dist/esm/features/RowSorting.js +200 -0
  169. package/dist/esm/features/RowSorting.js.map +1 -0
  170. package/{build/lib → dist/esm}/filterFns.d.ts +2 -1
  171. package/dist/esm/filterFns.js +88 -0
  172. package/dist/esm/filterFns.js.map +1 -0
  173. package/dist/esm/index.d.ts +34 -0
  174. package/dist/esm/index.js +88 -0
  175. package/dist/esm/index.js.map +1 -0
  176. package/{build/lib → dist/esm}/sortingFns.d.ts +2 -1
  177. package/dist/esm/sortingFns.js +91 -0
  178. package/dist/esm/sortingFns.js.map +1 -0
  179. package/{build/lib → dist/esm}/types.d.ts +29 -28
  180. package/{build/lib → dist/esm}/utils/filterRowsUtils.d.ts +1 -0
  181. package/dist/esm/utils/filterRowsUtils.js +99 -0
  182. package/dist/esm/utils/filterRowsUtils.js.map +1 -0
  183. package/{build/lib → dist/esm}/utils/getCoreRowModel.d.ts +1 -0
  184. package/dist/esm/utils/getCoreRowModel.js +54 -0
  185. package/dist/esm/utils/getCoreRowModel.js.map +1 -0
  186. package/{build/lib → dist/esm}/utils/getExpandedRowModel.d.ts +1 -0
  187. package/dist/esm/utils/getExpandedRowModel.js +41 -0
  188. package/dist/esm/utils/getExpandedRowModel.js.map +1 -0
  189. package/{build/lib → dist/esm}/utils/getFacetedMinMaxValues.d.ts +1 -0
  190. package/dist/esm/utils/getFacetedMinMaxValues.js +35 -0
  191. package/dist/esm/utils/getFacetedMinMaxValues.js.map +1 -0
  192. package/{build/lib → dist/esm}/utils/getFacetedRowModel.d.ts +1 -0
  193. package/dist/esm/utils/getFacetedRowModel.js +35 -0
  194. package/{build/lib → dist/esm}/utils/getFacetedRowModel.js.map +1 -1
  195. package/{build/lib → dist/esm}/utils/getFacetedUniqueValues.d.ts +1 -0
  196. package/dist/esm/utils/getFacetedUniqueValues.js +37 -0
  197. package/dist/esm/utils/getFacetedUniqueValues.js.map +1 -0
  198. package/{build/lib → dist/esm}/utils/getFilteredRowModel.d.ts +1 -0
  199. package/dist/esm/utils/getFilteredRowModel.js +116 -0
  200. package/{build/lib → dist/esm}/utils/getFilteredRowModel.js.map +1 -1
  201. package/{build/lib → dist/esm}/utils/getGroupedRowModel.d.ts +1 -0
  202. package/dist/esm/utils/getGroupedRowModel.js +118 -0
  203. package/dist/esm/utils/getGroupedRowModel.js.map +1 -0
  204. package/{build/lib → dist/esm}/utils/getPaginationRowModel.d.ts +1 -0
  205. package/dist/esm/utils/getPaginationRowModel.js +49 -0
  206. package/dist/esm/utils/getPaginationRowModel.js.map +1 -0
  207. package/{build/lib → dist/esm}/utils/getSortedRowModel.d.ts +1 -0
  208. package/dist/esm/utils/getSortedRowModel.js +88 -0
  209. package/{build/lib → dist/esm}/utils/getSortedRowModel.js.map +1 -1
  210. package/{build/lib → dist/esm}/utils.d.ts +2 -1
  211. package/dist/esm/utils.js +98 -0
  212. package/{build/lib → dist/esm}/utils.js.map +1 -1
  213. package/package.json +14 -10
  214. package/src/core/cell.ts +2 -2
  215. package/src/core/column.ts +2 -2
  216. package/src/core/headers.ts +5 -5
  217. package/src/core/row.ts +4 -4
  218. package/src/core/table.ts +43 -7
  219. package/src/features/ColumnFaceting.ts +1 -1
  220. package/src/features/ColumnFiltering.ts +6 -6
  221. package/src/features/ColumnGrouping.ts +7 -7
  222. package/src/features/ColumnOrdering.ts +4 -4
  223. package/src/features/ColumnPinning.ts +5 -5
  224. package/src/features/ColumnSizing.ts +6 -6
  225. package/src/features/ColumnVisibility.ts +5 -5
  226. package/src/features/GlobalFaceting.ts +1 -1
  227. package/src/features/GlobalFiltering.ts +4 -4
  228. package/src/features/RowExpanding.ts +4 -4
  229. package/src/features/RowPagination.ts +3 -3
  230. package/src/features/RowPinning.ts +4 -4
  231. package/src/features/RowSelection.ts +4 -4
  232. package/src/features/RowSorting.ts +5 -5
  233. package/src/types.ts +8 -8
  234. package/src/utils/filterRowsUtils.ts +3 -3
  235. package/src/utils/getCoreRowModel.ts +2 -2
  236. package/src/utils/getGroupedRowModel.ts +2 -2
  237. package/build/lib/aggregationFns.js +0 -108
  238. package/build/lib/aggregationFns.js.map +0 -1
  239. package/build/lib/columnHelper.js +0 -71
  240. package/build/lib/core/cell.js +0 -42
  241. package/build/lib/core/cell.js.map +0 -1
  242. package/build/lib/core/column.js +0 -80
  243. package/build/lib/core/column.js.map +0 -1
  244. package/build/lib/core/headers.js +0 -270
  245. package/build/lib/core/headers.js.map +0 -1
  246. package/build/lib/core/row.js +0 -89
  247. package/build/lib/core/row.js.map +0 -1
  248. package/build/lib/core/table.js +0 -212
  249. package/build/lib/core/table.js.map +0 -1
  250. package/build/lib/features/ColumnFiltering.js +0 -151
  251. package/build/lib/features/ColumnFiltering.js.map +0 -1
  252. package/build/lib/features/ColumnGrouping.js +0 -142
  253. package/build/lib/features/ColumnGrouping.js.map +0 -1
  254. package/build/lib/features/ColumnOrdering.js +0 -84
  255. package/build/lib/features/ColumnOrdering.js.map +0 -1
  256. package/build/lib/features/ColumnPinning.js +0 -130
  257. package/build/lib/features/ColumnPinning.js.map +0 -1
  258. package/build/lib/features/ColumnSizing.js +0 -270
  259. package/build/lib/features/ColumnSizing.js.map +0 -1
  260. package/build/lib/features/ColumnVisibility.js +0 -99
  261. package/build/lib/features/ColumnVisibility.js.map +0 -1
  262. package/build/lib/features/GlobalFaceting.js.map +0 -1
  263. package/build/lib/features/GlobalFiltering.js +0 -63
  264. package/build/lib/features/GlobalFiltering.js.map +0 -1
  265. package/build/lib/features/RowExpanding.js.map +0 -1
  266. package/build/lib/features/RowPagination.js +0 -169
  267. package/build/lib/features/RowPagination.js.map +0 -1
  268. package/build/lib/features/RowPinning.js +0 -145
  269. package/build/lib/features/RowPinning.js.map +0 -1
  270. package/build/lib/features/RowSelection.js +0 -391
  271. package/build/lib/features/RowSelection.js.map +0 -1
  272. package/build/lib/features/RowSorting.js +0 -226
  273. package/build/lib/features/RowSorting.js.map +0 -1
  274. package/build/lib/filterFns.js +0 -96
  275. package/build/lib/filterFns.js.map +0 -1
  276. package/build/lib/index.d.ts +0 -34
  277. package/build/lib/index.esm.js +0 -3522
  278. package/build/lib/index.esm.js.map +0 -1
  279. package/build/lib/index.js.map +0 -1
  280. package/build/lib/index.mjs +0 -3522
  281. package/build/lib/index.mjs.map +0 -1
  282. package/build/lib/sortingFns.js.map +0 -1
  283. package/build/lib/utils/filterRowsUtils.js.map +0 -1
  284. package/build/lib/utils/getCoreRowModel.js +0 -65
  285. package/build/lib/utils/getCoreRowModel.js.map +0 -1
  286. package/build/lib/utils/getExpandedRowModel.js +0 -46
  287. package/build/lib/utils/getExpandedRowModel.js.map +0 -1
  288. package/build/lib/utils/getFacetedMinMaxValues.js +0 -43
  289. package/build/lib/utils/getFacetedMinMaxValues.js.map +0 -1
  290. package/build/lib/utils/getFacetedRowModel.js +0 -36
  291. package/build/lib/utils/getFacetedUniqueValues.js +0 -39
  292. package/build/lib/utils/getFacetedUniqueValues.js.map +0 -1
  293. package/build/lib/utils/getFilteredRowModel.js +0 -111
  294. package/build/lib/utils/getGroupedRowModel.js +0 -150
  295. package/build/lib/utils/getGroupedRowModel.js.map +0 -1
  296. package/build/lib/utils/getPaginationRowModel.js +0 -60
  297. package/build/lib/utils/getPaginationRowModel.js.map +0 -1
  298. package/build/lib/utils/getSortedRowModel.js +0 -102
  299. package/build/umd/index.development.js +0 -3578
  300. package/build/umd/index.development.js.map +0 -1
  301. package/build/umd/index.production.js +0 -12
  302. package/build/umd/index.production.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ColumnOrdering.cjs","sources":["../../../src/features/ColumnOrdering.ts"],"sourcesContent":["import { getMemoOptions, makeStateUpdater, memo } from '../utils'\n\nimport {\n Column,\n OnChangeFn,\n RowData,\n Table,\n TableFeature,\n Updater,\n} from '../types'\n\nimport { orderColumns } from './ColumnGrouping'\nimport { ColumnPinningPosition, _getVisibleLeafColumns } from '..'\n\nexport interface ColumnOrderTableState {\n columnOrder: ColumnOrderState\n}\n\nexport type ColumnOrderState = string[]\n\nexport interface ColumnOrderOptions {\n /**\n * If provided, this function will be called with an `updaterFn` when `state.columnOrder` changes. This overrides the default internal state management, so you will need to persist the state change either fully or partially outside of the table.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#oncolumnorderchange)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n onColumnOrderChange?: OnChangeFn<ColumnOrderState>\n}\n\nexport interface ColumnOrderColumn {\n /**\n * Returns the index of the column in the order of the visible columns. Optionally pass a `position` parameter to get the index of the column in a sub-section of the table\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getindex)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n getIndex: (position?: ColumnPinningPosition | 'center') => number\n /**\n * Returns `true` if the column is the first column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the first in a sub-section of the table.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getisfirstcolumn)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean\n /**\n * Returns `true` if the column is the last column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the last in a sub-section of the table.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getislastcolumn)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean\n}\n\nexport interface ColumnOrderDefaultOptions {\n onColumnOrderChange: OnChangeFn<ColumnOrderState>\n}\n\nexport interface ColumnOrderInstance<TData extends RowData> {\n _getOrderColumnsFn: () => (\n columns: Column<TData, unknown>[]\n ) => Column<TData, unknown>[]\n /**\n * Resets the **columnOrder** state to `initialState.columnOrder`, or `true` can be passed to force a default blank state reset to `[]`.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#resetcolumnorder)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n resetColumnOrder: (defaultState?: boolean) => void\n /**\n * Sets or updates the `state.columnOrder` state.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#setcolumnorder)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)\n */\n setColumnOrder: (updater: Updater<ColumnOrderState>) => void\n}\n\n//\n\nexport const ColumnOrdering: TableFeature = {\n _getInitialState: (state): ColumnOrderTableState => {\n return {\n columnOrder: [],\n ...state,\n }\n },\n\n _getDefaultOptions: <TData extends RowData>(\n table: Table<TData>\n ): ColumnOrderDefaultOptions => {\n return {\n onColumnOrderChange: makeStateUpdater('columnOrder', table),\n }\n },\n\n _createColumn: <TData extends RowData>(\n column: Column<TData, unknown>,\n table: Table<TData>\n ): void => {\n column.getIndex = memo(\n position => [_getVisibleLeafColumns(table, position)],\n columns => columns.findIndex(d => d.id === column.id),\n getMemoOptions(table.options, 'debugColumns', 'getIndex')\n )\n column.getIsFirstColumn = position => {\n const columns = _getVisibleLeafColumns(table, position)\n return columns[0]?.id === column.id\n }\n column.getIsLastColumn = position => {\n const columns = _getVisibleLeafColumns(table, position)\n return columns[columns.length - 1]?.id === column.id\n }\n },\n\n _createTable: <TData extends RowData>(table: Table<TData>): void => {\n table.setColumnOrder = updater =>\n table.options.onColumnOrderChange?.(updater)\n table.resetColumnOrder = defaultState => {\n table.setColumnOrder(\n defaultState ? [] : table.initialState.columnOrder ?? []\n )\n }\n table._getOrderColumnsFn = memo(\n () => [\n table.getState().columnOrder,\n table.getState().grouping,\n table.options.groupedColumnMode,\n ],\n (columnOrder, grouping, groupedColumnMode) =>\n (columns: Column<TData, unknown>[]) => {\n // Sort grouped columns to the start of the column list\n // before the headers are built\n let orderedColumns: Column<TData, unknown>[] = []\n\n // If there is no order, return the normal columns\n if (!columnOrder?.length) {\n orderedColumns = columns\n } else {\n const columnOrderCopy = [...columnOrder]\n\n // If there is an order, make a copy of the columns\n const columnsCopy = [...columns]\n\n // And make a new ordered array of the columns\n\n // Loop over the columns and place them in order into the new array\n while (columnsCopy.length && columnOrderCopy.length) {\n const targetColumnId = columnOrderCopy.shift()\n const foundIndex = columnsCopy.findIndex(\n d => d.id === targetColumnId\n )\n if (foundIndex > -1) {\n orderedColumns.push(columnsCopy.splice(foundIndex, 1)[0]!)\n }\n }\n\n // If there are any columns left, add them to the end\n orderedColumns = [...orderedColumns, ...columnsCopy]\n }\n\n return orderColumns(orderedColumns, grouping, groupedColumnMode)\n },\n getMemoOptions(table.options, 'debugTable', '_getOrderColumnsFn')\n )\n },\n}\n"],"names":["makeStateUpdater","memo","_getVisibleLeafColumns","getMemoOptions","orderColumns"],"mappings":";;;;;AA0EO,MAAM,iBAA+B;AAAA,EAC1C,kBAAkB,CAAC,UAAiC;AAC3C,WAAA;AAAA,MACL,aAAa,CAAC;AAAA,MACd,GAAG;AAAA,IAAA;AAAA,EAEP;AAAA,EAEA,oBAAoB,CAClB,UAC8B;AACvB,WAAA;AAAA,MACL,qBAAqBA,MAAAA,iBAAiB,eAAe,KAAK;AAAA,IAAA;AAAA,EAE9D;AAAA,EAEA,eAAe,CACb,QACA,UACS;AACT,WAAO,WAAWC,MAAA;AAAA,MAChB,CAAY,aAAA,CAACC,iBAAAA,uBAAuB,OAAO,QAAQ,CAAC;AAAA,MACpD,aAAW,QAAQ,UAAU,OAAK,EAAE,OAAO,OAAO,EAAE;AAAA,MACpDC,MAAAA,eAAe,MAAM,SAAS,gBAAgB,UAAU;AAAA,IAAA;AAE1D,WAAO,mBAAmB,CAAY,aAAA;;AAC9B,YAAA,UAAUD,iBAAAA,uBAAuB,OAAO,QAAQ;AACtD,eAAO,aAAQ,CAAC,MAAT,mBAAY,QAAO,OAAO;AAAA,IAAA;AAEnC,WAAO,kBAAkB,CAAY,aAAA;;AAC7B,YAAA,UAAUA,iBAAAA,uBAAuB,OAAO,QAAQ;AACtD,eAAO,aAAQ,QAAQ,SAAS,CAAC,MAA1B,mBAA6B,QAAO,OAAO;AAAA,IAAA;AAAA,EAEtD;AAAA,EAEA,cAAc,CAAwB,UAA8B;AAClE,UAAM,iBAAiB,CAAA,YAAA;;AACrB,+BAAM,SAAQ,wBAAd,4BAAoC;AAAA;AACtC,UAAM,mBAAmB,CAAgB,iBAAA;AACjC,YAAA;AAAA,QACJ,eAAe,CAAA,IAAK,MAAM,aAAa,eAAe,CAAC;AAAA,MAAA;AAAA,IACzD;AAEF,UAAM,qBAAqBD,MAAA;AAAA,MACzB,MAAM;AAAA,QACJ,MAAM,WAAW;AAAA,QACjB,MAAM,WAAW;AAAA,QACjB,MAAM,QAAQ;AAAA,MAChB;AAAA,MACA,CAAC,aAAa,UAAU,sBACtB,CAAC,YAAsC;AAGrC,YAAI,iBAA2C,CAAA;AAG3C,YAAA,EAAC,2CAAa,SAAQ;AACP,2BAAA;AAAA,QAAA,OACZ;AACC,gBAAA,kBAAkB,CAAC,GAAG,WAAW;AAGjC,gBAAA,cAAc,CAAC,GAAG,OAAO;AAKxB,iBAAA,YAAY,UAAU,gBAAgB,QAAQ;AAC7C,kBAAA,iBAAiB,gBAAgB;AACvC,kBAAM,aAAa,YAAY;AAAA,cAC7B,CAAA,MAAK,EAAE,OAAO;AAAA,YAAA;AAEhB,gBAAI,aAAa,IAAI;AACnB,6BAAe,KAAK,YAAY,OAAO,YAAY,CAAC,EAAE,CAAC,CAAE;AAAA,YAC3D;AAAA,UACF;AAGA,2BAAiB,CAAC,GAAG,gBAAgB,GAAG,WAAW;AAAA,QACrD;AAEO,eAAAG,4BAAa,gBAAgB,UAAU,iBAAiB;AAAA,MACjE;AAAA,MACFD,MAAAA,eAAe,MAAM,SAAS,cAAc,oBAAoB;AAAA,IAAA;AAAA,EAEpE;AACF;;"}
@@ -0,0 +1,54 @@
1
+ import { Column, OnChangeFn, RowData, TableFeature, Updater } from '../types';
2
+ import { ColumnPinningPosition } from '..';
3
+
4
+ export interface ColumnOrderTableState {
5
+ columnOrder: ColumnOrderState;
6
+ }
7
+ export type ColumnOrderState = string[];
8
+ export interface ColumnOrderOptions {
9
+ /**
10
+ * If provided, this function will be called with an `updaterFn` when `state.columnOrder` changes. This overrides the default internal state management, so you will need to persist the state change either fully or partially outside of the table.
11
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#oncolumnorderchange)
12
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
13
+ */
14
+ onColumnOrderChange?: OnChangeFn<ColumnOrderState>;
15
+ }
16
+ export interface ColumnOrderColumn {
17
+ /**
18
+ * Returns the index of the column in the order of the visible columns. Optionally pass a `position` parameter to get the index of the column in a sub-section of the table
19
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getindex)
20
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
21
+ */
22
+ getIndex: (position?: ColumnPinningPosition | 'center') => number;
23
+ /**
24
+ * Returns `true` if the column is the first column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the first in a sub-section of the table.
25
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getisfirstcolumn)
26
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
27
+ */
28
+ getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean;
29
+ /**
30
+ * Returns `true` if the column is the last column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the last in a sub-section of the table.
31
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#getislastcolumn)
32
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
33
+ */
34
+ getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean;
35
+ }
36
+ export interface ColumnOrderDefaultOptions {
37
+ onColumnOrderChange: OnChangeFn<ColumnOrderState>;
38
+ }
39
+ export interface ColumnOrderInstance<TData extends RowData> {
40
+ _getOrderColumnsFn: () => (columns: Column<TData, unknown>[]) => Column<TData, unknown>[];
41
+ /**
42
+ * Resets the **columnOrder** state to `initialState.columnOrder`, or `true` can be passed to force a default blank state reset to `[]`.
43
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#resetcolumnorder)
44
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
45
+ */
46
+ resetColumnOrder: (defaultState?: boolean) => void;
47
+ /**
48
+ * Sets or updates the `state.columnOrder` state.
49
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-ordering#setcolumnorder)
50
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-ordering)
51
+ */
52
+ setColumnOrder: (updater: Updater<ColumnOrderState>) => void;
53
+ }
54
+ export declare const ColumnOrdering: TableFeature;
@@ -0,0 +1,145 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const utils = require("../utils.cjs");
4
+ const getDefaultColumnPinningState = () => ({
5
+ left: [],
6
+ right: []
7
+ });
8
+ const ColumnPinning = {
9
+ _getInitialState: (state) => {
10
+ return {
11
+ columnPinning: getDefaultColumnPinningState(),
12
+ ...state
13
+ };
14
+ },
15
+ _getDefaultOptions: (table) => {
16
+ return {
17
+ onColumnPinningChange: utils.makeStateUpdater("columnPinning", table)
18
+ };
19
+ },
20
+ _createColumn: (column, table) => {
21
+ column.pin = (position) => {
22
+ const columnIds = column.getLeafColumns().map((d) => d.id).filter(Boolean);
23
+ table.setColumnPinning((old) => {
24
+ if (position === "right") {
25
+ return {
26
+ left: ((old == null ? void 0 : old.left) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d))),
27
+ right: [
28
+ ...((old == null ? void 0 : old.right) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d))),
29
+ ...columnIds
30
+ ]
31
+ };
32
+ }
33
+ if (position === "left") {
34
+ return {
35
+ left: [
36
+ ...((old == null ? void 0 : old.left) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d))),
37
+ ...columnIds
38
+ ],
39
+ right: ((old == null ? void 0 : old.right) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d)))
40
+ };
41
+ }
42
+ return {
43
+ left: ((old == null ? void 0 : old.left) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d))),
44
+ right: ((old == null ? void 0 : old.right) ?? []).filter((d) => !(columnIds == null ? void 0 : columnIds.includes(d)))
45
+ };
46
+ });
47
+ };
48
+ column.getCanPin = () => {
49
+ const leafColumns = column.getLeafColumns();
50
+ return leafColumns.some(
51
+ (d) => (d.columnDef.enablePinning ?? true) && (table.options.enableColumnPinning ?? table.options.enablePinning ?? true)
52
+ );
53
+ };
54
+ column.getIsPinned = () => {
55
+ const leafColumnIds = column.getLeafColumns().map((d) => d.id);
56
+ const { left, right } = table.getState().columnPinning;
57
+ const isLeft = leafColumnIds.some((d) => left == null ? void 0 : left.includes(d));
58
+ const isRight = leafColumnIds.some((d) => right == null ? void 0 : right.includes(d));
59
+ return isLeft ? "left" : isRight ? "right" : false;
60
+ };
61
+ column.getPinnedIndex = () => {
62
+ var _a, _b;
63
+ const position = column.getIsPinned();
64
+ return position ? ((_b = (_a = table.getState().columnPinning) == null ? void 0 : _a[position]) == null ? void 0 : _b.indexOf(column.id)) ?? -1 : 0;
65
+ };
66
+ },
67
+ _createRow: (row, table) => {
68
+ row.getCenterVisibleCells = utils.memo(
69
+ () => [
70
+ row._getAllVisibleCells(),
71
+ table.getState().columnPinning.left,
72
+ table.getState().columnPinning.right
73
+ ],
74
+ (allCells, left, right) => {
75
+ const leftAndRight = [...left ?? [], ...right ?? []];
76
+ return allCells.filter((d) => !leftAndRight.includes(d.column.id));
77
+ },
78
+ utils.getMemoOptions(table.options, "debugRows", "getCenterVisibleCells")
79
+ );
80
+ row.getLeftVisibleCells = utils.memo(
81
+ () => [row._getAllVisibleCells(), table.getState().columnPinning.left],
82
+ (allCells, left) => {
83
+ const cells = (left ?? []).map((columnId) => allCells.find((cell) => cell.column.id === columnId)).filter(Boolean).map((d) => ({ ...d, position: "left" }));
84
+ return cells;
85
+ },
86
+ utils.getMemoOptions(table.options, "debugRows", "getLeftVisibleCells")
87
+ );
88
+ row.getRightVisibleCells = utils.memo(
89
+ () => [row._getAllVisibleCells(), table.getState().columnPinning.right],
90
+ (allCells, right) => {
91
+ const cells = (right ?? []).map((columnId) => allCells.find((cell) => cell.column.id === columnId)).filter(Boolean).map((d) => ({ ...d, position: "right" }));
92
+ return cells;
93
+ },
94
+ utils.getMemoOptions(table.options, "debugRows", "getRightVisibleCells")
95
+ );
96
+ },
97
+ _createTable: (table) => {
98
+ table.setColumnPinning = (updater) => {
99
+ var _a, _b;
100
+ return (_b = (_a = table.options).onColumnPinningChange) == null ? void 0 : _b.call(_a, updater);
101
+ };
102
+ table.resetColumnPinning = (defaultState) => {
103
+ var _a;
104
+ return table.setColumnPinning(
105
+ defaultState ? getDefaultColumnPinningState() : ((_a = table.initialState) == null ? void 0 : _a.columnPinning) ?? getDefaultColumnPinningState()
106
+ );
107
+ };
108
+ table.getIsSomeColumnsPinned = (position) => {
109
+ var _a, _b, _c;
110
+ const pinningState = table.getState().columnPinning;
111
+ if (!position) {
112
+ return Boolean(((_a = pinningState.left) == null ? void 0 : _a.length) || ((_b = pinningState.right) == null ? void 0 : _b.length));
113
+ }
114
+ return Boolean((_c = pinningState[position]) == null ? void 0 : _c.length);
115
+ };
116
+ table.getLeftLeafColumns = utils.memo(
117
+ () => [table.getAllLeafColumns(), table.getState().columnPinning.left],
118
+ (allColumns, left) => {
119
+ return (left ?? []).map((columnId) => allColumns.find((column) => column.id === columnId)).filter(Boolean);
120
+ },
121
+ utils.getMemoOptions(table.options, "debugColumns", "getLeftLeafColumns")
122
+ );
123
+ table.getRightLeafColumns = utils.memo(
124
+ () => [table.getAllLeafColumns(), table.getState().columnPinning.right],
125
+ (allColumns, right) => {
126
+ return (right ?? []).map((columnId) => allColumns.find((column) => column.id === columnId)).filter(Boolean);
127
+ },
128
+ utils.getMemoOptions(table.options, "debugColumns", "getRightLeafColumns")
129
+ );
130
+ table.getCenterLeafColumns = utils.memo(
131
+ () => [
132
+ table.getAllLeafColumns(),
133
+ table.getState().columnPinning.left,
134
+ table.getState().columnPinning.right
135
+ ],
136
+ (allColumns, left, right) => {
137
+ const leftAndRight = [...left ?? [], ...right ?? []];
138
+ return allColumns.filter((d) => !leftAndRight.includes(d.id));
139
+ },
140
+ utils.getMemoOptions(table.options, "debugColumns", "getCenterLeafColumns")
141
+ );
142
+ }
143
+ };
144
+ exports.ColumnPinning = ColumnPinning;
145
+ //# sourceMappingURL=ColumnPinning.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ColumnPinning.cjs","sources":["../../../src/features/ColumnPinning.ts"],"sourcesContent":["import {\n OnChangeFn,\n Updater,\n Table,\n Column,\n Row,\n Cell,\n RowData,\n TableFeature,\n} from '../types'\nimport { getMemoOptions, makeStateUpdater, memo } from '../utils'\n\nexport type ColumnPinningPosition = false | 'left' | 'right'\n\nexport interface ColumnPinningState {\n left?: string[]\n right?: string[]\n}\n\nexport interface ColumnPinningTableState {\n columnPinning: ColumnPinningState\n}\n\nexport interface ColumnPinningOptions {\n /**\n * Enables/disables column pinning for the table. Defaults to `true`.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablecolumnpinning)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n enableColumnPinning?: boolean\n /**\n * @deprecated Use `enableColumnPinning` or `enableRowPinning` instead.\n * Enables/disables all pinning for the table. Defaults to `true`.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablepinning)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n enablePinning?: boolean\n /**\n * If provided, this function will be called with an `updaterFn` when `state.columnPinning` changes. This overrides the default internal state management, so you will also need to supply `state.columnPinning` from your own managed state.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#oncolumnpinningchange)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/oncolumnpinningchange)\n */\n onColumnPinningChange?: OnChangeFn<ColumnPinningState>\n}\n\nexport interface ColumnPinningDefaultOptions {\n onColumnPinningChange: OnChangeFn<ColumnPinningState>\n}\n\nexport interface ColumnPinningColumnDef {\n /**\n * Enables/disables column pinning for this column. Defaults to `true`.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablepinning-1)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n enablePinning?: boolean\n}\n\nexport interface ColumnPinningColumn {\n /**\n * Returns whether or not the column can be pinned.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcanpin)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getCanPin: () => boolean\n /**\n * Returns the pinned position of the column. (`'left'`, `'right'` or `false`)\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getispinned)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getIsPinned: () => ColumnPinningPosition\n /**\n * Returns the numeric pinned index of the column within a pinned column group.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getpinnedindex)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getPinnedIndex: () => number\n /**\n * Pins a column to the `'left'` or `'right'`, or unpins the column to the center if `false` is passed.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#pin)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n pin: (position: ColumnPinningPosition) => void\n}\n\nexport interface ColumnPinningRow<TData extends RowData> {\n /**\n * Returns all center pinned (unpinned) leaf cells in the row.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcentervisiblecells)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getCenterVisibleCells: () => Cell<TData, unknown>[]\n /**\n * Returns all left pinned leaf cells in the row.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getleftvisiblecells)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getLeftVisibleCells: () => Cell<TData, unknown>[]\n /**\n * Returns all right pinned leaf cells in the row.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getrightvisiblecells)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getRightVisibleCells: () => Cell<TData, unknown>[]\n}\n\nexport interface ColumnPinningInstance<TData extends RowData> {\n /**\n * Returns all center pinned (unpinned) leaf columns.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcenterleafcolumns)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getCenterLeafColumns: () => Column<TData, unknown>[]\n /**\n * Returns whether or not any columns are pinned. Optionally specify to only check for pinned columns in either the `left` or `right` position.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getissomecolumnspinned)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getIsSomeColumnsPinned: (position?: ColumnPinningPosition) => boolean\n /**\n * Returns all left pinned leaf columns.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getleftleafcolumns)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getLeftLeafColumns: () => Column<TData, unknown>[]\n /**\n * Returns all right pinned leaf columns.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getrightleafcolumns)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n getRightLeafColumns: () => Column<TData, unknown>[]\n /**\n * Resets the **columnPinning** state to `initialState.columnPinning`, or `true` can be passed to force a default blank state reset to `{ left: [], right: [], }`.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#resetcolumnpinning)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n resetColumnPinning: (defaultState?: boolean) => void\n /**\n * Sets or updates the `state.columnPinning` state.\n * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#setcolumnpinning)\n * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)\n */\n setColumnPinning: (updater: Updater<ColumnPinningState>) => void\n}\n\n//\n\nconst getDefaultColumnPinningState = (): ColumnPinningState => ({\n left: [],\n right: [],\n})\n\nexport const ColumnPinning: TableFeature = {\n _getInitialState: (state): ColumnPinningTableState => {\n return {\n columnPinning: getDefaultColumnPinningState(),\n ...state,\n }\n },\n\n _getDefaultOptions: <TData extends RowData>(\n table: Table<TData>\n ): ColumnPinningDefaultOptions => {\n return {\n onColumnPinningChange: makeStateUpdater('columnPinning', table),\n }\n },\n\n _createColumn: <TData extends RowData, TValue>(\n column: Column<TData, TValue>,\n table: Table<TData>\n ): void => {\n column.pin = position => {\n const columnIds = column\n .getLeafColumns()\n .map(d => d.id)\n .filter(Boolean) as string[]\n\n table.setColumnPinning(old => {\n if (position === 'right') {\n return {\n left: (old?.left ?? []).filter(d => !columnIds?.includes(d)),\n right: [\n ...(old?.right ?? []).filter(d => !columnIds?.includes(d)),\n ...columnIds,\n ],\n }\n }\n\n if (position === 'left') {\n return {\n left: [\n ...(old?.left ?? []).filter(d => !columnIds?.includes(d)),\n ...columnIds,\n ],\n right: (old?.right ?? []).filter(d => !columnIds?.includes(d)),\n }\n }\n\n return {\n left: (old?.left ?? []).filter(d => !columnIds?.includes(d)),\n right: (old?.right ?? []).filter(d => !columnIds?.includes(d)),\n }\n })\n }\n\n column.getCanPin = () => {\n const leafColumns = column.getLeafColumns()\n\n return leafColumns.some(\n d =>\n (d.columnDef.enablePinning ?? true) &&\n (table.options.enableColumnPinning ??\n table.options.enablePinning ??\n true)\n )\n }\n\n column.getIsPinned = () => {\n const leafColumnIds = column.getLeafColumns().map(d => d.id)\n\n const { left, right } = table.getState().columnPinning\n\n const isLeft = leafColumnIds.some(d => left?.includes(d))\n const isRight = leafColumnIds.some(d => right?.includes(d))\n\n return isLeft ? 'left' : isRight ? 'right' : false\n }\n\n column.getPinnedIndex = () => {\n const position = column.getIsPinned()\n\n return position\n ? table.getState().columnPinning?.[position]?.indexOf(column.id) ?? -1\n : 0\n }\n },\n\n _createRow: <TData extends RowData>(\n row: Row<TData>,\n table: Table<TData>\n ): void => {\n row.getCenterVisibleCells = memo(\n () => [\n row._getAllVisibleCells(),\n table.getState().columnPinning.left,\n table.getState().columnPinning.right,\n ],\n (allCells, left, right) => {\n const leftAndRight: string[] = [...(left ?? []), ...(right ?? [])]\n\n return allCells.filter(d => !leftAndRight.includes(d.column.id))\n },\n getMemoOptions(table.options, 'debugRows', 'getCenterVisibleCells')\n )\n row.getLeftVisibleCells = memo(\n () => [row._getAllVisibleCells(), table.getState().columnPinning.left],\n (allCells, left) => {\n const cells = (left ?? [])\n .map(columnId => allCells.find(cell => cell.column.id === columnId)!)\n .filter(Boolean)\n .map(d => ({ ...d, position: 'left' }) as Cell<TData, unknown>)\n\n return cells\n },\n getMemoOptions(table.options, 'debugRows', 'getLeftVisibleCells')\n )\n row.getRightVisibleCells = memo(\n () => [row._getAllVisibleCells(), table.getState().columnPinning.right],\n (allCells, right) => {\n const cells = (right ?? [])\n .map(columnId => allCells.find(cell => cell.column.id === columnId)!)\n .filter(Boolean)\n .map(d => ({ ...d, position: 'right' }) as Cell<TData, unknown>)\n\n return cells\n },\n getMemoOptions(table.options, 'debugRows', 'getRightVisibleCells')\n )\n },\n\n _createTable: <TData extends RowData>(table: Table<TData>): void => {\n table.setColumnPinning = updater =>\n table.options.onColumnPinningChange?.(updater)\n\n table.resetColumnPinning = defaultState =>\n table.setColumnPinning(\n defaultState\n ? getDefaultColumnPinningState()\n : table.initialState?.columnPinning ?? getDefaultColumnPinningState()\n )\n\n table.getIsSomeColumnsPinned = position => {\n const pinningState = table.getState().columnPinning\n\n if (!position) {\n return Boolean(pinningState.left?.length || pinningState.right?.length)\n }\n return Boolean(pinningState[position]?.length)\n }\n\n table.getLeftLeafColumns = memo(\n () => [table.getAllLeafColumns(), table.getState().columnPinning.left],\n (allColumns, left) => {\n return (left ?? [])\n .map(columnId => allColumns.find(column => column.id === columnId)!)\n .filter(Boolean)\n },\n getMemoOptions(table.options, 'debugColumns', 'getLeftLeafColumns')\n )\n\n table.getRightLeafColumns = memo(\n () => [table.getAllLeafColumns(), table.getState().columnPinning.right],\n (allColumns, right) => {\n return (right ?? [])\n .map(columnId => allColumns.find(column => column.id === columnId)!)\n .filter(Boolean)\n },\n getMemoOptions(table.options, 'debugColumns', 'getRightLeafColumns')\n )\n\n table.getCenterLeafColumns = memo(\n () => [\n table.getAllLeafColumns(),\n table.getState().columnPinning.left,\n table.getState().columnPinning.right,\n ],\n (allColumns, left, right) => {\n const leftAndRight: string[] = [...(left ?? []), ...(right ?? [])]\n\n return allColumns.filter(d => !leftAndRight.includes(d.id))\n },\n getMemoOptions(table.options, 'debugColumns', 'getCenterLeafColumns')\n )\n },\n}\n"],"names":["makeStateUpdater","memo","getMemoOptions"],"mappings":"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"}
@@ -0,0 +1,127 @@
1
+ import { OnChangeFn, Updater, Column, Cell, RowData, TableFeature } from '../types';
2
+
3
+ export type ColumnPinningPosition = false | 'left' | 'right';
4
+ export interface ColumnPinningState {
5
+ left?: string[];
6
+ right?: string[];
7
+ }
8
+ export interface ColumnPinningTableState {
9
+ columnPinning: ColumnPinningState;
10
+ }
11
+ export interface ColumnPinningOptions {
12
+ /**
13
+ * Enables/disables column pinning for the table. Defaults to `true`.
14
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablecolumnpinning)
15
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
16
+ */
17
+ enableColumnPinning?: boolean;
18
+ /**
19
+ * @deprecated Use `enableColumnPinning` or `enableRowPinning` instead.
20
+ * Enables/disables all pinning for the table. Defaults to `true`.
21
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablepinning)
22
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
23
+ */
24
+ enablePinning?: boolean;
25
+ /**
26
+ * If provided, this function will be called with an `updaterFn` when `state.columnPinning` changes. This overrides the default internal state management, so you will also need to supply `state.columnPinning` from your own managed state.
27
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#oncolumnpinningchange)
28
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/oncolumnpinningchange)
29
+ */
30
+ onColumnPinningChange?: OnChangeFn<ColumnPinningState>;
31
+ }
32
+ export interface ColumnPinningDefaultOptions {
33
+ onColumnPinningChange: OnChangeFn<ColumnPinningState>;
34
+ }
35
+ export interface ColumnPinningColumnDef {
36
+ /**
37
+ * Enables/disables column pinning for this column. Defaults to `true`.
38
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#enablepinning-1)
39
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
40
+ */
41
+ enablePinning?: boolean;
42
+ }
43
+ export interface ColumnPinningColumn {
44
+ /**
45
+ * Returns whether or not the column can be pinned.
46
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcanpin)
47
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
48
+ */
49
+ getCanPin: () => boolean;
50
+ /**
51
+ * Returns the pinned position of the column. (`'left'`, `'right'` or `false`)
52
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getispinned)
53
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
54
+ */
55
+ getIsPinned: () => ColumnPinningPosition;
56
+ /**
57
+ * Returns the numeric pinned index of the column within a pinned column group.
58
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getpinnedindex)
59
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
60
+ */
61
+ getPinnedIndex: () => number;
62
+ /**
63
+ * Pins a column to the `'left'` or `'right'`, or unpins the column to the center if `false` is passed.
64
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#pin)
65
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
66
+ */
67
+ pin: (position: ColumnPinningPosition) => void;
68
+ }
69
+ export interface ColumnPinningRow<TData extends RowData> {
70
+ /**
71
+ * Returns all center pinned (unpinned) leaf cells in the row.
72
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcentervisiblecells)
73
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
74
+ */
75
+ getCenterVisibleCells: () => Cell<TData, unknown>[];
76
+ /**
77
+ * Returns all left pinned leaf cells in the row.
78
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getleftvisiblecells)
79
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
80
+ */
81
+ getLeftVisibleCells: () => Cell<TData, unknown>[];
82
+ /**
83
+ * Returns all right pinned leaf cells in the row.
84
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getrightvisiblecells)
85
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
86
+ */
87
+ getRightVisibleCells: () => Cell<TData, unknown>[];
88
+ }
89
+ export interface ColumnPinningInstance<TData extends RowData> {
90
+ /**
91
+ * Returns all center pinned (unpinned) leaf columns.
92
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getcenterleafcolumns)
93
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
94
+ */
95
+ getCenterLeafColumns: () => Column<TData, unknown>[];
96
+ /**
97
+ * Returns whether or not any columns are pinned. Optionally specify to only check for pinned columns in either the `left` or `right` position.
98
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getissomecolumnspinned)
99
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
100
+ */
101
+ getIsSomeColumnsPinned: (position?: ColumnPinningPosition) => boolean;
102
+ /**
103
+ * Returns all left pinned leaf columns.
104
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getleftleafcolumns)
105
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
106
+ */
107
+ getLeftLeafColumns: () => Column<TData, unknown>[];
108
+ /**
109
+ * Returns all right pinned leaf columns.
110
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#getrightleafcolumns)
111
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
112
+ */
113
+ getRightLeafColumns: () => Column<TData, unknown>[];
114
+ /**
115
+ * Resets the **columnPinning** state to `initialState.columnPinning`, or `true` can be passed to force a default blank state reset to `{ left: [], right: [], }`.
116
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#resetcolumnpinning)
117
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
118
+ */
119
+ resetColumnPinning: (defaultState?: boolean) => void;
120
+ /**
121
+ * Sets or updates the `state.columnPinning` state.
122
+ * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-pinning#setcolumnpinning)
123
+ * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-pinning)
124
+ */
125
+ setColumnPinning: (updater: Updater<ColumnPinningState>) => void;
126
+ }
127
+ export declare const ColumnPinning: TableFeature;