@svgrid/grid 2.6.16 → 2.6.17

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 (449) hide show
  1. package/CHANGELOG.md +346 -346
  2. package/README.md +199 -199
  3. package/dist/DockNodeView.svelte.d.ts +1 -1
  4. package/dist/DockPopoutHost.svelte.d.ts +1 -1
  5. package/dist/FlexRender.svelte +96 -96
  6. package/dist/FlexRender.svelte.d.ts +1 -1
  7. package/dist/GridFooter.svelte +181 -178
  8. package/dist/GridFooter.svelte.d.ts +3 -3
  9. package/dist/GridMenus.svelte +705 -705
  10. package/dist/GridMenus.svelte.d.ts +3 -3
  11. package/dist/SvAccordion.svelte.d.ts +3 -3
  12. package/dist/SvAutoComplete.svelte +165 -165
  13. package/dist/SvAutoComplete.svelte.d.ts +2 -2
  14. package/dist/SvAvatar.svelte +75 -75
  15. package/dist/SvBreadcrumb.svelte.d.ts +2 -2
  16. package/dist/SvButtonGroup.svelte.d.ts +3 -3
  17. package/dist/SvCalendar.svelte +503 -503
  18. package/dist/SvCalendar.svelte.d.ts +7 -7
  19. package/dist/SvCarousel.svelte +141 -141
  20. package/dist/SvCarousel.svelte.d.ts +1 -1
  21. package/dist/SvCheckBox.svelte +102 -102
  22. package/dist/SvCheckBox.svelte.d.ts +1 -1
  23. package/dist/SvCircularProgress.svelte +109 -109
  24. package/dist/SvColorInput.svelte +181 -181
  25. package/dist/SvColorInput.svelte.d.ts +1 -1
  26. package/dist/SvComboBox.svelte +275 -275
  27. package/dist/SvComboBox.svelte.d.ts +2 -2
  28. package/dist/SvCommand.svelte.d.ts +2 -2
  29. package/dist/SvContextMenu.svelte +116 -116
  30. package/dist/SvCountryInput.svelte +163 -163
  31. package/dist/SvCountryInput.svelte.d.ts +1 -1
  32. package/dist/SvDateRangeInput.svelte.d.ts +3 -3
  33. package/dist/SvDateTimePicker.svelte.d.ts +4 -4
  34. package/dist/SvDockLayout.svelte.d.ts +2 -2
  35. package/dist/SvDockManager.svelte.d.ts +2 -2
  36. package/dist/SvDrawer.svelte +254 -254
  37. package/dist/SvDropDownList.svelte +374 -374
  38. package/dist/SvDropDownList.svelte.d.ts +2 -2
  39. package/dist/SvDurationInput.svelte +126 -126
  40. package/dist/SvDurationInput.svelte.d.ts +1 -1
  41. package/dist/SvField.svelte +293 -293
  42. package/dist/SvField.svelte.d.ts +1 -1
  43. package/dist/SvFileUpload.svelte.d.ts +3 -3
  44. package/dist/SvForm.svelte +437 -437
  45. package/dist/SvForm.svelte.d.ts +4 -4
  46. package/dist/SvGauge.svelte.d.ts +1 -1
  47. package/dist/SvGrid.controller.svelte.d.ts +28 -28
  48. package/dist/SvGrid.controller.svelte.js +117 -45
  49. package/dist/SvGrid.css +2896 -2856
  50. package/dist/SvGrid.helpers.d.ts +2 -2
  51. package/dist/SvGrid.svelte +2956 -2956
  52. package/dist/SvGrid.svelte.d.ts +3 -3
  53. package/dist/SvGrid.types.d.ts +28 -7
  54. package/dist/SvGridCellEditor.svelte +662 -662
  55. package/dist/SvGridCellEditor.svelte.d.ts +2 -2
  56. package/dist/SvGridChart.svelte +1716 -1716
  57. package/dist/SvGridChart.svelte.d.ts +1 -1
  58. package/dist/SvGridChartPanel.svelte +485 -485
  59. package/dist/SvGridChartPanel.svelte.d.ts +2 -2
  60. package/dist/SvGridChartView.svelte +70 -70
  61. package/dist/SvGridChartView.svelte.d.ts +1 -1
  62. package/dist/SvGridDropdown.svelte +728 -728
  63. package/dist/SvGridDropdown.svelte.d.ts +1 -1
  64. package/dist/SvGridSelect.svelte +266 -266
  65. package/dist/SvGridSelect.svelte.d.ts +4 -4
  66. package/dist/SvGroupCell.svelte +116 -116
  67. package/dist/SvGroupCell.svelte.d.ts +1 -1
  68. package/dist/SvHoverCard.svelte.d.ts +1 -1
  69. package/dist/SvListBox.svelte +326 -326
  70. package/dist/SvListBox.svelte.d.ts +2 -2
  71. package/dist/SvMaskedInput.svelte +122 -122
  72. package/dist/SvMaskedInput.svelte.d.ts +1 -1
  73. package/dist/SvMenu.svelte +124 -124
  74. package/dist/SvMenu.svelte.d.ts +1 -1
  75. package/dist/SvMenuList.svelte +146 -146
  76. package/dist/SvMenuList.svelte.d.ts +3 -3
  77. package/dist/SvMenubar.svelte.d.ts +3 -3
  78. package/dist/SvMultiSelect.svelte +289 -289
  79. package/dist/SvMultiSelect.svelte.d.ts +3 -3
  80. package/dist/SvNavPane.svelte.d.ts +1 -1
  81. package/dist/SvNumberInput.svelte +168 -168
  82. package/dist/SvNumberInput.svelte.d.ts +1 -1
  83. package/dist/SvOtpInput.svelte +158 -158
  84. package/dist/SvOtpInput.svelte.d.ts +1 -1
  85. package/dist/SvPasswordInput.svelte +151 -151
  86. package/dist/SvPasswordInput.svelte.d.ts +1 -1
  87. package/dist/SvPhoneInput.svelte +133 -133
  88. package/dist/SvPhoneInput.svelte.d.ts +2 -2
  89. package/dist/SvPopconfirm.svelte.d.ts +1 -1
  90. package/dist/SvPopover.svelte +197 -197
  91. package/dist/SvPopover.svelte.d.ts +1 -1
  92. package/dist/SvProgress.svelte +116 -116
  93. package/dist/SvRadioGroup.svelte +107 -107
  94. package/dist/SvRadioGroup.svelte.d.ts +3 -3
  95. package/dist/SvRating.svelte +112 -112
  96. package/dist/SvRating.svelte.d.ts +1 -1
  97. package/dist/SvResult.svelte +73 -73
  98. package/dist/SvRichText.svelte +211 -211
  99. package/dist/SvRowGroupPanel.svelte +170 -170
  100. package/dist/SvScrollArea.svelte +61 -61
  101. package/dist/SvSegmented.svelte.d.ts +3 -3
  102. package/dist/SvSlider.svelte +203 -203
  103. package/dist/SvSlider.svelte.d.ts +1 -1
  104. package/dist/SvSparkline.svelte.d.ts +1 -1
  105. package/dist/SvSplitter.svelte.d.ts +3 -3
  106. package/dist/SvStepper.svelte.d.ts +2 -2
  107. package/dist/SvSwitchButton.svelte +108 -108
  108. package/dist/SvSwitchButton.svelte.d.ts +1 -1
  109. package/dist/SvTabs.svelte.d.ts +3 -3
  110. package/dist/SvTagsInput.svelte +115 -115
  111. package/dist/SvTagsInput.svelte.d.ts +1 -1
  112. package/dist/SvTextArea.svelte.d.ts +1 -1
  113. package/dist/SvTextInput.svelte +147 -147
  114. package/dist/SvTextInput.svelte.d.ts +1 -1
  115. package/dist/SvTimePicker.svelte +245 -245
  116. package/dist/SvTimePicker.svelte.d.ts +3 -3
  117. package/dist/SvTimeline.svelte.d.ts +2 -2
  118. package/dist/SvToaster.svelte +159 -159
  119. package/dist/SvToggleButton.svelte +85 -85
  120. package/dist/SvToggleButton.svelte.d.ts +1 -1
  121. package/dist/SvTooltip.svelte +161 -161
  122. package/dist/SvTooltip.svelte.d.ts +1 -1
  123. package/dist/SvTour.svelte +208 -208
  124. package/dist/SvTour.svelte.d.ts +3 -3
  125. package/dist/SvTree.svelte +444 -444
  126. package/dist/SvTree.svelte.d.ts +3 -3
  127. package/dist/SvTreeSelect.svelte +235 -235
  128. package/dist/SvTreeSelect.svelte.d.ts +3 -3
  129. package/dist/advanced-filter.svelte.d.ts +1 -1
  130. package/dist/ai.d.ts +1 -1
  131. package/dist/ai.js +1 -1
  132. package/dist/build-api.d.ts +2 -2
  133. package/dist/build-api.js +8 -8
  134. package/dist/builtin-editors.js +1 -1
  135. package/dist/cdn/{GridMenus-CPdy5dxw.js → GridMenus-3kKYmYOE.js} +2 -2
  136. package/dist/cdn/{GridMenus-BLajq_RP.js → GridMenus-BcDiwQ9U.js} +2 -2
  137. package/dist/cdn/{SvDateTimePicker-CHnUkWcH.js → SvDateTimePicker-DSUhIta8.js} +2 -2
  138. package/dist/cdn/{SvDateTimePicker-CRQH_U7E.js → SvDateTimePicker-h9kPyszT.js} +2 -2
  139. package/dist/cdn/{SvGridCellEditor-BGUCzuPB.js → SvGridCellEditor-DkyQO6FV.js} +1 -1
  140. package/dist/cdn/{SvGridCellEditor-G8IMWIws.js → SvGridCellEditor-JpJSRhDx.js} +1 -1
  141. package/dist/cdn/{SvGridChart-BwVos976.js → SvGridChart-Bs2GIR2Q.js} +1 -1
  142. package/dist/cdn/{SvGridChart-BEJmNNx9.js → SvGridChart-CwhFz7GV.js} +1 -1
  143. package/dist/cdn/{SvGridChartPanel-BOknOkrP.js → SvGridChartPanel-1WXuStzM.js} +1 -1
  144. package/dist/cdn/{SvGridChartPanel-D2PjII4O.js → SvGridChartPanel-e5_nqNP9.js} +1 -1
  145. package/dist/cdn/{SvGridChartView-00LPUHL1.js → SvGridChartView-SmPW10dI.js} +1 -1
  146. package/dist/cdn/{SvGridChartView-BhUEJ5ki.js → SvGridChartView-eSPuJE6g.js} +1 -1
  147. package/dist/cdn/{SvGridDropdown-D0VdjeR8.js → SvGridDropdown-B1ZcLpgs.js} +1 -1
  148. package/dist/cdn/{SvGridDropdown-D13MtJ2j.js → SvGridDropdown-CtdbHcIS.js} +1 -1
  149. package/dist/cdn/{src-ogpR-lHu.js → src-D79V6bCA.js} +298 -296
  150. package/dist/cdn/{src-CKpl94Cx.js → src-DMZZVVFd.js} +297 -295
  151. package/dist/cdn/svgrid.js +6 -6
  152. package/dist/cdn/svgrid.svelte-external.js +6 -6
  153. package/dist/cell-render.d.ts +3 -3
  154. package/dist/cell-render.js +6 -6
  155. package/dist/cell-values.d.ts +1 -1
  156. package/dist/cell-values.js +1 -1
  157. package/dist/chart-export.d.ts +1 -1
  158. package/dist/chart-export.js +8 -8
  159. package/dist/clipboard.d.ts +2 -2
  160. package/dist/clipboard.js +5 -5
  161. package/dist/column-groups.js +1 -1
  162. package/dist/columns.d.ts +2 -2
  163. package/dist/columns.js +1 -1
  164. package/dist/core.d.ts +1 -1
  165. package/dist/core.js +1 -1
  166. package/dist/createAutocomplete.svelte.d.ts +1 -1
  167. package/dist/createAutocomplete.svelte.js +2 -2
  168. package/dist/createButtonGroup.svelte.js +1 -1
  169. package/dist/createCalendar.svelte.d.ts +4 -4
  170. package/dist/createCalendar.svelte.js +4 -4
  171. package/dist/createCarousel.svelte.d.ts +1 -1
  172. package/dist/createCheckbox.svelte.js +1 -1
  173. package/dist/createColorInput.svelte.js +1 -1
  174. package/dist/createCombobox.svelte.d.ts +1 -1
  175. package/dist/createCombobox.svelte.js +2 -2
  176. package/dist/createCommand.svelte.d.ts +1 -1
  177. package/dist/createCommand.svelte.js +2 -2
  178. package/dist/createCountryInput.svelte.d.ts +1 -1
  179. package/dist/createCountryInput.svelte.js +2 -2
  180. package/dist/createDateTimePicker.svelte.d.ts +1 -1
  181. package/dist/createDateTimePicker.svelte.js +3 -3
  182. package/dist/createDropdownList.svelte.d.ts +1 -1
  183. package/dist/createDropdownList.svelte.js +2 -2
  184. package/dist/createFileUpload.svelte.js +1 -1
  185. package/dist/createForm.svelte.d.ts +1 -1
  186. package/dist/createForm.svelte.js +2 -2
  187. package/dist/createGrid.svelte.d.ts +1 -1
  188. package/dist/createGrid.svelte.js +1 -1
  189. package/dist/createGridState.svelte.d.ts +1 -1
  190. package/dist/createListbox.svelte.d.ts +1 -1
  191. package/dist/createListbox.svelte.js +2 -2
  192. package/dist/createMaskedInput.svelte.js +2 -2
  193. package/dist/createMenu.svelte.d.ts +2 -2
  194. package/dist/createMenu.svelte.js +2 -2
  195. package/dist/createNumberInput.svelte.js +1 -1
  196. package/dist/createOverlay.svelte.js +3 -3
  197. package/dist/createPagination.d.ts +1 -1
  198. package/dist/createPagination.js +1 -1
  199. package/dist/createPasswordInput.svelte.js +1 -1
  200. package/dist/createPhoneInput.svelte.js +3 -3
  201. package/dist/createPopoverSelect.svelte.d.ts +1 -1
  202. package/dist/createPopoverSelect.svelte.js +3 -3
  203. package/dist/createRadioGroup.svelte.js +1 -1
  204. package/dist/createRating.svelte.js +1 -1
  205. package/dist/createSlider.svelte.js +1 -1
  206. package/dist/createSwitch.svelte.js +1 -1
  207. package/dist/createTabs.svelte.d.ts +1 -1
  208. package/dist/createTagsInput.svelte.js +1 -1
  209. package/dist/createToggle.svelte.js +1 -1
  210. package/dist/createTooltip.svelte.js +1 -1
  211. package/dist/createTree.svelte.d.ts +1 -1
  212. package/dist/datetime/date-restrict.d.ts +1 -1
  213. package/dist/datetime/date-restrict.js +1 -1
  214. package/dist/datetime/date-selection.js +1 -1
  215. package/dist/dock-context.d.ts +1 -1
  216. package/dist/dock-manager-model.d.ts +1 -1
  217. package/dist/dock-manager-model.js +1 -1
  218. package/dist/dock-popout.d.ts +1 -1
  219. package/dist/dock-popout.js +1 -1
  220. package/dist/editing.d.ts +2 -2
  221. package/dist/editing.js +5 -5
  222. package/dist/editor-registry.d.ts +1 -1
  223. package/dist/editors/cell-editors.js +1 -1
  224. package/dist/export-format.d.ts +2 -2
  225. package/dist/export-format.js +2 -2
  226. package/dist/export-provider.d.ts +1 -1
  227. package/dist/facet-buckets.d.ts +1 -1
  228. package/dist/facet-buckets.js +1 -1
  229. package/dist/features.d.ts +2 -2
  230. package/dist/features.js +2 -2
  231. package/dist/filter-operators.d.ts +2 -2
  232. package/dist/filter-operators.js +1 -1
  233. package/dist/form-field.d.ts +1 -1
  234. package/dist/grid-messages.js +1 -1
  235. package/dist/headless.d.ts +11 -4
  236. package/dist/headless.js +11 -4
  237. package/dist/index.d.ts +120 -120
  238. package/dist/index.js +111 -111
  239. package/dist/keyboard-handlers.d.ts +2 -2
  240. package/dist/keyboard-handlers.js +2 -2
  241. package/dist/keyboard.d.ts +1 -1
  242. package/dist/menus.d.ts +3 -3
  243. package/dist/menus.js +3 -3
  244. package/dist/named-views.d.ts +1 -1
  245. package/dist/pivot-view.svelte.d.ts +1 -1
  246. package/dist/recurrence.d.ts +1 -1
  247. package/dist/recurrence.js +1 -1
  248. package/dist/row-drag.js +1 -1
  249. package/dist/scheduler-ical.d.ts +1 -1
  250. package/dist/scheduler-model.d.ts +3 -3
  251. package/dist/scheduler-model.js +2 -2
  252. package/dist/scroll-sync.d.ts +2 -2
  253. package/dist/scroll-sync.js +1 -1
  254. package/dist/selection.d.ts +2 -2
  255. package/dist/selection.js +3 -3
  256. package/dist/server-data-source.d.ts +1 -1
  257. package/dist/server-group-model.d.ts +1 -1
  258. package/dist/static-functions.d.ts +1 -1
  259. package/dist/static-functions.js +1 -1
  260. package/dist/subscribe.d.ts +1 -1
  261. package/dist/summaries.d.ts +2 -2
  262. package/dist/summaries.js +3 -3
  263. package/dist/svgrid-wrapper.types.d.ts +5 -5
  264. package/dist/themes/index.d.ts +3 -1
  265. package/dist/themes/index.js +4 -2
  266. package/dist/toast-store.svelte.js +1 -1
  267. package/dist/tree-select.d.ts +1 -1
  268. package/dist/virtualization/column-virtualizer.d.ts +3 -3
  269. package/dist/virtualization/column-virtualizer.js +1 -1
  270. package/dist/virtualization/svelte-virtualizer.svelte.d.ts +3 -3
  271. package/dist/virtualization/svelte-virtualizer.svelte.js +1 -1
  272. package/dist/virtualization/virtualizer.d.ts +1 -1
  273. package/package.json +23 -11
  274. package/src/FlexRender.svelte +96 -96
  275. package/src/GridFooter.svelte +181 -178
  276. package/src/GridMenus.svelte +705 -705
  277. package/src/SvAutoComplete.svelte +165 -165
  278. package/src/SvAvatar.svelte +75 -75
  279. package/src/SvCalendar.svelte +503 -503
  280. package/src/SvCalendar.test.ts +226 -226
  281. package/src/SvCarousel.svelte +141 -141
  282. package/src/SvCheckBox.svelte +102 -102
  283. package/src/SvCircularProgress.svelte +109 -109
  284. package/src/SvColorInput.svelte +181 -181
  285. package/src/SvComboBox.svelte +275 -275
  286. package/src/SvContextMenu.svelte +116 -116
  287. package/src/SvCountryInput.svelte +163 -163
  288. package/src/SvDrawer.svelte +254 -254
  289. package/src/SvDropDownList.svelte +374 -374
  290. package/src/SvDurationInput.svelte +126 -126
  291. package/src/SvField.svelte +293 -293
  292. package/src/SvForm.svelte +437 -437
  293. package/src/SvForm.test.ts +411 -411
  294. package/src/SvGrid.controller.svelte.ts +3974 -3898
  295. package/src/SvGrid.css +2896 -2856
  296. package/src/SvGrid.svelte +2956 -2956
  297. package/src/SvGrid.types.ts +1790 -1769
  298. package/src/SvGridCellEditor.svelte +662 -662
  299. package/src/SvGridChart.svelte +1716 -1716
  300. package/src/SvGridChartPanel.svelte +485 -485
  301. package/src/SvGridChartView.svelte +70 -70
  302. package/src/SvGridDropdown.svelte +728 -728
  303. package/src/SvGridSelect.svelte +266 -266
  304. package/src/SvGroupCell.svelte +116 -116
  305. package/src/SvListBox.svelte +326 -326
  306. package/src/SvMaskedInput.svelte +122 -122
  307. package/src/SvMenu.svelte +124 -124
  308. package/src/SvMenu.test.ts +97 -97
  309. package/src/SvMenuList.svelte +146 -146
  310. package/src/SvMultiSelect.svelte +289 -289
  311. package/src/SvNumberInput.svelte +168 -168
  312. package/src/SvOtpInput.svelte +158 -158
  313. package/src/SvPasswordInput.svelte +151 -151
  314. package/src/SvPhoneInput.svelte +133 -133
  315. package/src/SvPopover.svelte +197 -197
  316. package/src/SvProgress.svelte +116 -116
  317. package/src/SvRadioGroup.svelte +107 -107
  318. package/src/SvRating.svelte +112 -112
  319. package/src/SvResult.svelte +73 -73
  320. package/src/SvRichText.svelte +211 -211
  321. package/src/SvRowGroupPanel.svelte +170 -170
  322. package/src/SvScrollArea.svelte +61 -61
  323. package/src/SvSlider.svelte +203 -203
  324. package/src/SvSwitchButton.svelte +108 -108
  325. package/src/SvTagsInput.svelte +115 -115
  326. package/src/SvTextInput.svelte +147 -147
  327. package/src/SvTimePicker.svelte +245 -245
  328. package/src/SvToaster.svelte +159 -159
  329. package/src/SvToaster.test.ts +95 -95
  330. package/src/SvToggleButton.svelte +85 -85
  331. package/src/SvTooltip.svelte +161 -161
  332. package/src/SvTour.svelte +208 -208
  333. package/src/SvTree.svelte +444 -444
  334. package/src/SvTreeSelect.svelte +235 -235
  335. package/src/a11y/dismissable.test.ts +119 -119
  336. package/src/a11y/dismissable.ts +114 -114
  337. package/src/a11y.contract.test.ts +49 -49
  338. package/src/a11y.test.ts +59 -59
  339. package/src/a11y.ts +61 -61
  340. package/src/ai.test.ts +502 -502
  341. package/src/ai.ts +1391 -1391
  342. package/src/build-api.coverage.test.ts +633 -633
  343. package/src/build-api.ts +846 -846
  344. package/src/builtin-editors.grid.test.ts +83 -83
  345. package/src/cell-formatting.ts +169 -169
  346. package/src/cell-render.test.ts +513 -513
  347. package/src/cell-render.ts +496 -496
  348. package/src/cell-values.ts +118 -118
  349. package/src/chart-export.ts +201 -201
  350. package/src/chart-view.svelte.ts +36 -36
  351. package/src/chart.ts +2295 -2295
  352. package/src/collaboration.test.ts +104 -104
  353. package/src/collaboration.ts +167 -167
  354. package/src/core.performance.test.ts +30 -30
  355. package/src/core.ts +1261 -1261
  356. package/src/createAutocomplete.svelte.ts +132 -132
  357. package/src/createCombobox.svelte.ts +191 -191
  358. package/src/createCountryInput.svelte.ts +157 -157
  359. package/src/createDropdownList.svelte.ts +168 -168
  360. package/src/createForm.svelte.ts +386 -386
  361. package/src/createGrid.svelte.ts +42 -42
  362. package/src/createGrid.test.ts +10 -10
  363. package/src/createGridState.svelte.ts +17 -17
  364. package/src/createListbox.svelte.ts +250 -250
  365. package/src/createMenu.svelte.ts +224 -224
  366. package/src/createPopoverSelect.svelte.ts +213 -213
  367. package/src/createSlider.svelte.ts +191 -191
  368. package/src/createTooltip.svelte.ts +144 -144
  369. package/src/createTree.svelte.ts +319 -319
  370. package/src/editing.test.ts +949 -949
  371. package/src/editing.ts +606 -606
  372. package/src/editor-contract.ts +170 -170
  373. package/src/editor-registry.grid.test.ts +144 -144
  374. package/src/editor-registry.ts +122 -122
  375. package/src/export-data-api.test.ts +126 -126
  376. package/src/export-format.test.ts +107 -107
  377. package/src/export-format.ts +601 -601
  378. package/src/filter-operators.ts +160 -160
  379. package/src/flex-render.ts +3 -3
  380. package/src/form-field.ts +127 -127
  381. package/src/group-display.test.ts +167 -167
  382. package/src/group-display.ts +200 -200
  383. package/src/headless.ts +87 -80
  384. package/src/index.ts +754 -754
  385. package/src/js-scroller.svelte.ts +173 -173
  386. package/src/keyboard-handlers.ts +270 -270
  387. package/src/keyboard.test.ts +59 -59
  388. package/src/keyboard.ts +97 -97
  389. package/src/list-nav.test.ts +49 -49
  390. package/src/list-nav.ts +29 -29
  391. package/src/list-option.test.ts +56 -56
  392. package/src/list-option.ts +172 -172
  393. package/src/menus.ts +567 -567
  394. package/src/merge-objects.ts +48 -48
  395. package/src/overlays.test.ts +90 -90
  396. package/src/render-component.ts +28 -28
  397. package/src/row-drag-touch.ts +211 -211
  398. package/src/row-drag.test.ts +353 -353
  399. package/src/row-drag.ts +415 -415
  400. package/src/row-resize.ts +210 -210
  401. package/src/scheduler-model.test.ts +562 -562
  402. package/src/scheduler-model.ts +872 -872
  403. package/src/selection.test.ts +754 -754
  404. package/src/selection.ts +491 -491
  405. package/src/server-data-source.test.ts +383 -383
  406. package/src/server-data-source.ts +469 -469
  407. package/src/sparkline.test.ts +68 -68
  408. package/src/sparkline.ts +169 -169
  409. package/src/spreadsheet.test.ts +488 -488
  410. package/src/spreadsheet.ts +312 -312
  411. package/src/static-functions.ts +11 -11
  412. package/src/subscribe.ts +38 -38
  413. package/src/svgrid-wrapper.types.ts +558 -558
  414. package/src/svgrid.async-editor-options.test.ts +273 -273
  415. package/src/svgrid.auto-row-height.test.ts +204 -204
  416. package/src/svgrid.behavior.test.ts +912 -704
  417. package/src/svgrid.charting.test.ts +534 -534
  418. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  419. package/src/svgrid.context-menu.test.ts +147 -147
  420. package/src/svgrid.features.test.ts +157 -157
  421. package/src/svgrid.filter-depth.test.ts +163 -163
  422. package/src/svgrid.filter-menu-listbox.svelte.test.ts +331 -331
  423. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  424. package/src/svgrid.grand-total.test.ts +188 -188
  425. package/src/svgrid.group-display-mode.test.ts +171 -171
  426. package/src/svgrid.group-footers.test.ts +121 -121
  427. package/src/svgrid.group-pagination.test.ts +153 -153
  428. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  429. package/src/svgrid.tree-data.test.ts +186 -186
  430. package/src/svgrid.wrapper.test.ts +63 -63
  431. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  432. package/src/test-setup.ts +62 -62
  433. package/src/themes/index.ts +288 -286
  434. package/src/toast-store.svelte.ts +246 -246
  435. package/src/toast-store.test.ts +147 -147
  436. package/src/tree-row-model.test.ts +168 -168
  437. package/src/ui-buttons.test.ts +144 -144
  438. package/src/ui-inputs.test.ts +118 -118
  439. package/src/ui-localization.test.ts +113 -113
  440. package/src/ui-range.test.ts +70 -70
  441. package/src/ui-selection.test.ts +155 -155
  442. package/src/ui-tier1.test.ts +142 -142
  443. package/src/virtual.test.ts +88 -88
  444. package/src/virtualization/column-virtualizer.test.ts +27 -27
  445. package/src/virtualization/column-virtualizer.ts +30 -30
  446. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  447. package/src/virtualization/types.ts +30 -30
  448. package/src/virtualization/virtualizer.test.ts +47 -47
  449. package/src/virtualization/virtualizer.ts +322 -322
@@ -1,949 +1,949 @@
1
- import { beforeEach, describe, expect, it, vi } from 'vitest'
2
- import { createEditing } from './editing'
3
-
4
- // ---------------------------------------------------------------------------
5
- // Fake controller `ctx` for the editing handlers. The handlers operate purely
6
- // through this handle (mirroring clipboard.test.ts), so a hand-rolled stub
7
- // drives every non-clipboard branch without mounting the grid. Clipboard
8
- // paste paths are covered by clipboard.test.ts and only lightly touched here.
9
- // ---------------------------------------------------------------------------
10
-
11
- interface ColSpec {
12
- id: string
13
- field?: string
14
- editable?: boolean | ((cellCtx: any) => boolean)
15
- editorType?: string
16
- editorMultiple?: boolean
17
- }
18
-
19
- interface FakeOptions {
20
- columns?: ColSpec[]
21
- data?: Array<Record<string, unknown>>
22
- groupRows?: Set<number>
23
- editingEnabled?: boolean
24
- }
25
-
26
- function makeCtx(opts: FakeOptions = {}) {
27
- const columns: ColSpec[] = opts.columns ?? [
28
- { id: 'a', field: 'a', editable: true, editorType: 'text' },
29
- { id: 'b', field: 'b', editable: true, editorType: 'number' },
30
- ]
31
- const data = (opts.data ?? [
32
- { a: 'a0', b: 0 },
33
- { a: 'a1', b: 1 },
34
- ]).map((d) => ({ ...d }))
35
-
36
- const allColumns = columns.map((c) => ({
37
- id: c.id,
38
- columnDef: {
39
- field: c.field,
40
- editable: c.editable,
41
- editorType: c.editorType,
42
- editorMultiple: c.editorMultiple,
43
- },
44
- }))
45
-
46
- let activeCell: { rowIndex: number; colIndex: number } | null = null
47
-
48
- const buildRows = (rows: Array<Record<string, unknown>>) =>
49
- rows.map((row, index) => ({
50
- id: String(index),
51
- original: row,
52
- getCanExpand: () => opts.groupRows?.has(index) ?? false,
53
- getCellValueByColumnId: (colId: string) =>
54
- (row as Record<string, unknown>)[colId],
55
- }))
56
-
57
- let backing = data
58
-
59
- const ctx: any = {
60
- allColumns,
61
- _rows: buildRows(data),
62
- get allRows() {
63
- return ctx._rows
64
- },
65
- // The full filtered model. Same rows here (the fake has no pagination);
66
- // tests that exercise the "row left the model" path override `_rows`
67
- // alone so the two genuinely diverge.
68
- get allRowsBeforePagination() {
69
- return ctx._rowsBeforePagination ?? ctx._rows
70
- },
71
- get activeCell() {
72
- return activeCell
73
- },
74
- scrollActiveCellIntoView: () => {},
75
- editingEnabled: opts.editingEnabled ?? true,
76
- editingCell: null,
77
- editorSelectAll: false,
78
- editedCellValues: {},
79
- selectionRange: { anchor: null, focus: null },
80
- gridRootEl: null,
81
- props: {},
82
- history: [] as any[],
83
- historyPtr: -1,
84
- historyVersion: 0,
85
- UNDO_LIMIT: 100,
86
- activeCalls: [] as Array<[number, number]>,
87
- selectionCalls: [] as Array<[number, number]>,
88
- setActiveCell: (r: number, c: number) => {
89
- activeCell = { rowIndex: r, colIndex: c }
90
- ctx.activeCalls.push([r, c])
91
- },
92
- setSelection: (r: number, c: number) => {
93
- ctx.selectionCalls.push([r, c])
94
- },
95
- grid: {
96
- getState: () => ({ activeCell }),
97
- store: { setState: vi.fn() },
98
- },
99
- }
100
-
101
- Object.defineProperty(ctx, 'internalData', {
102
- get: () => backing,
103
- set: (next: Array<Record<string, unknown>>) => {
104
- backing = next
105
- ctx._rows = buildRows(next)
106
- },
107
- })
108
- ctx.internalData = data
109
-
110
- return ctx
111
- }
112
-
113
- const editingFor = (opts?: FakeOptions) => {
114
- const ctx = makeCtx(opts)
115
- return { ctx, ed: createEditing(ctx) }
116
- }
117
-
118
- describe('isCellEditable', () => {
119
- it('treats undefined editable as editable', () => {
120
- const { ctx, ed } = editingFor({
121
- columns: [{ id: 'a', field: 'a' }],
122
- data: [{ a: 1 }],
123
- })
124
- expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(true)
125
- })
126
-
127
- it('treats editable:false as locked (fast path, no row needed)', () => {
128
- const { ctx, ed } = editingFor({
129
- columns: [{ id: 'a', field: 'a', editable: false }],
130
- })
131
- expect(ed.isCellEditable(ctx.allColumns[0])).toBe(false)
132
- })
133
-
134
- it('honours a cell-level predicate returning false', () => {
135
- const { ctx, ed } = editingFor({
136
- columns: [{ id: 'a', field: 'a', editable: () => false }],
137
- data: [{ a: 1 }],
138
- })
139
- expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(false)
140
- })
141
-
142
- it('honours a cell-level predicate returning true', () => {
143
- const { ctx, ed } = editingFor({
144
- columns: [{ id: 'a', field: 'a', editable: (cc: any) => cc.row.id === '0' }],
145
- data: [{ a: 1 }],
146
- })
147
- expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(true)
148
- })
149
-
150
- it('passes a usable CellContext to the predicate', () => {
151
- const spy = vi.fn().mockReturnValue(true)
152
- const { ctx, ed } = editingFor({
153
- columns: [{ id: 'a', field: 'a', editable: spy }],
154
- data: [{ a: 'hello' }],
155
- })
156
- ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])
157
- const cc = spy.mock.calls[0]![0]
158
- expect(cc.getValue()).toBe('hello')
159
- expect(cc.cell.getValue()).toBe('hello')
160
- expect(cc.cell.getContext()).toBe(cc)
161
- expect(cc.column).toBe(ctx.allColumns[0])
162
- })
163
-
164
- it('returns editable when predicate exists but no row supplied', () => {
165
- const { ctx, ed } = editingFor({
166
- columns: [{ id: 'a', field: 'a', editable: () => false }],
167
- })
168
- // No row -> cannot evaluate predicate -> defaults to editable.
169
- expect(ed.isCellEditable(ctx.allColumns[0])).toBe(true)
170
- })
171
-
172
- it('biases to not-editable when the predicate throws', () => {
173
- const { ctx, ed } = editingFor({
174
- columns: [
175
- {
176
- id: 'a',
177
- field: 'a',
178
- editable: () => {
179
- throw new Error('boom')
180
- },
181
- },
182
- ],
183
- data: [{ a: 1 }],
184
- })
185
- expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(false)
186
- })
187
- })
188
-
189
- describe('isCellEditableAt', () => {
190
- it('resolves row/column by index then defers to isCellEditable', () => {
191
- const { ed } = editingFor({
192
- columns: [
193
- { id: 'a', field: 'a', editable: true },
194
- { id: 'b', field: 'b', editable: false },
195
- ],
196
- data: [{ a: 1, b: 2 }],
197
- })
198
- expect(ed.isCellEditableAt(0, 0)).toBe(true)
199
- expect(ed.isCellEditableAt(0, 1)).toBe(false)
200
- })
201
-
202
- it('returns false when the column index is out of range', () => {
203
- const { ed } = editingFor()
204
- expect(ed.isCellEditableAt(0, 99)).toBe(false)
205
- })
206
- })
207
-
208
- describe('getRowColumnValue', () => {
209
- it('reads the base value when the column id is known', () => {
210
- const { ctx, ed } = editingFor({
211
- columns: [{ id: 'a', field: 'a' }],
212
- data: [{ a: 'x' }],
213
- })
214
- expect(ed.getRowColumnValue(ctx.allRows[0], 'a')).toBe('x')
215
- })
216
-
217
- it('falls back to row.getCellValueByColumnId for an unknown column', () => {
218
- const { ctx, ed } = editingFor({
219
- columns: [{ id: 'a', field: 'a' }],
220
- data: [{ a: 'x', ghost: 'g' }],
221
- })
222
- expect(ed.getRowColumnValue(ctx.allRows[0], 'ghost')).toBe('g')
223
- })
224
- })
225
-
226
- describe('getCellDisplayValue', () => {
227
- it('returns the base value when there is no pending edit', () => {
228
- const { ed } = editingFor()
229
- expect(ed.getCellDisplayValue('0', 'a', 'base')).toBe('base')
230
- })
231
-
232
- it('prefers an edited override keyed by rowId:colId', () => {
233
- const { ctx, ed } = editingFor()
234
- ctx.editedCellValues['0:a'] = 'edited'
235
- expect(ed.getCellDisplayValue('0', 'a', 'base')).toBe('edited')
236
- })
237
-
238
- it('treats an explicit undefined override as present', () => {
239
- const { ctx, ed } = editingFor()
240
- ctx.editedCellValues['0:a'] = undefined
241
- expect(ed.getCellDisplayValue('0', 'a', 'base')).toBeUndefined()
242
- })
243
- })
244
-
245
- describe('startEditingWithChar', () => {
246
- it('seeds the editor with the typed character and sets active/selection', () => {
247
- const { ctx, ed } = editingFor({
248
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
249
- data: [{ a: 'x' }],
250
- })
251
- expect(ed.startEditingWithChar(0, 0, 'Z')).toBe(true)
252
- expect(ctx.editingCell).toEqual({
253
- rowId: '0',
254
- columnId: 'a',
255
- editorType: 'text',
256
- value: 'Z',
257
- // The row's data object, kept so the commit still lands if a filter
258
- // drops the row from the model mid-edit (#49).
259
- rowRef: ctx.internalData[0],
260
- })
261
- expect(ctx.editorSelectAll).toBe(false)
262
- expect(ctx.activeCalls).toEqual([[0, 0]])
263
- expect(ctx.selectionCalls).toEqual([[0, 0]])
264
- })
265
-
266
- it('defaults the editor type to text when none is declared', () => {
267
- const { ctx, ed } = editingFor({
268
- columns: [{ id: 'a', field: 'a' }],
269
- data: [{ a: 'x' }],
270
- })
271
- ed.startEditingWithChar(0, 0, 'k')
272
- expect(ctx.editingCell.editorType).toBe('text')
273
- })
274
-
275
- it('returns false when editing is globally disabled', () => {
276
- const { ctx, ed } = editingFor({ editingEnabled: false })
277
- expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
278
- expect(ctx.editingCell).toBeNull()
279
- })
280
-
281
- it('returns false for a missing row or column', () => {
282
- const { ed } = editingFor()
283
- expect(ed.startEditingWithChar(99, 0, 'a')).toBe(false)
284
- expect(ed.startEditingWithChar(0, 99, 'a')).toBe(false)
285
- })
286
-
287
- it('returns false for a group row', () => {
288
- const { ed } = editingFor({
289
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
290
- data: [{ a: 'x' }],
291
- groupRows: new Set([0]),
292
- })
293
- expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
294
- })
295
-
296
- it('returns false for a non-editable cell', () => {
297
- const { ed } = editingFor({
298
- columns: [{ id: 'a', field: 'a', editable: false, editorType: 'text' }],
299
- data: [{ a: 'x' }],
300
- })
301
- expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
302
- })
303
-
304
- it('rejects type-to-edit for checkbox/date/datetime/list/chips editors', () => {
305
- for (const editorType of ['checkbox', 'date', 'datetime', 'list', 'chips']) {
306
- const { ed } = editingFor({
307
- columns: [{ id: 'a', field: 'a', editorType }],
308
- data: [{ a: 'x' }],
309
- })
310
- expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
311
- }
312
- })
313
-
314
- it('rejects a non-numeric character on a number editor', () => {
315
- const { ed } = editingFor({
316
- columns: [{ id: 'a', field: 'a', editorType: 'number' }],
317
- data: [{ a: 1 }],
318
- })
319
- expect(ed.startEditingWithChar(0, 0, 'x')).toBe(false)
320
- })
321
-
322
- it('accepts a numeric character on a number editor', () => {
323
- const { ctx, ed } = editingFor({
324
- columns: [{ id: 'a', field: 'a', editorType: 'number' }],
325
- data: [{ a: 1 }],
326
- })
327
- expect(ed.startEditingWithChar(0, 0, '7')).toBe(true)
328
- expect(ctx.editingCell.value).toBe('7')
329
- })
330
- })
331
-
332
- describe('saveEditingCell', () => {
333
- it('does nothing when there is no editing cell', () => {
334
- const { ctx, ed } = editingFor()
335
- ed.saveEditingCell()
336
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
337
- })
338
-
339
- it('parses, writes original, records edited value, and clears editing', () => {
340
- const { ctx, ed } = editingFor({
341
- columns: [{ id: 'b', field: 'b', editorType: 'number' }],
342
- data: [{ b: 0 }],
343
- })
344
- ctx.editingCell = { rowId: '0', columnId: 'b', editorType: 'number', value: '42' }
345
- ed.saveEditingCell()
346
- expect(ctx.internalData[0].b).toBe(42) // parsed to number, written to original
347
- expect(ctx.editedCellValues['0:b']).toBe(42)
348
- expect(ctx.editingCell).toBeNull()
349
- expect(ctx.grid.store.setState).toHaveBeenCalled()
350
- })
351
-
352
- it('coerces an unparseable number to null', () => {
353
- const { ctx, ed } = editingFor({
354
- columns: [{ id: 'b', field: 'b', editorType: 'number' }],
355
- data: [{ b: 5 }],
356
- })
357
- ctx.editingCell = { rowId: '0', columnId: 'b', editorType: 'number', value: 'abc' }
358
- ed.saveEditingCell()
359
- expect(ctx.internalData[0].b).toBeNull()
360
- })
361
-
362
- it('respects editorMultiple when parsing list editors', () => {
363
- const { ctx, ed } = editingFor({
364
- columns: [
365
- { id: 'a', field: 'a', editorType: 'list', editorMultiple: true },
366
- ],
367
- data: [{ a: [] }],
368
- })
369
- ctx.editingCell = {
370
- rowId: '0',
371
- columnId: 'a',
372
- editorType: 'list',
373
- value: ['x', 'y'],
374
- }
375
- ed.saveEditingCell()
376
- expect(ctx.internalData[0].a).toEqual(['x', 'y'])
377
- })
378
-
379
- it('pushes a history step and bumps the version on a real change', () => {
380
- const { ctx, ed } = editingFor({
381
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
382
- data: [{ a: 'old' }],
383
- })
384
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'new' }
385
- ed.saveEditingCell()
386
- expect(ctx.history).toHaveLength(1)
387
- expect(ctx.history[0]).toMatchObject({
388
- rowId: '0',
389
- columnId: 'a',
390
- field: 'a',
391
- before: 'old',
392
- after: 'new',
393
- })
394
- expect(ctx.historyPtr).toBe(0)
395
- expect(ctx.historyVersion).toBe(1)
396
- })
397
-
398
- it('does not push history when the value is unchanged', () => {
399
- const { ctx, ed } = editingFor({
400
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
401
- data: [{ a: 'same' }],
402
- })
403
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'same' }
404
- ed.saveEditingCell()
405
- expect(ctx.history).toHaveLength(0)
406
- expect(ctx.historyVersion).toBe(0)
407
- })
408
-
409
- it('truncates forward (redo) history when editing after an undo', () => {
410
- const { ctx, ed } = editingFor({
411
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
412
- data: [{ a: 'v0' }],
413
- })
414
- // Pretend there is forward history the user could have redone.
415
- ctx.history = [
416
- { rowId: '0', columnId: 'a', field: 'a', before: 'x', after: 'y' },
417
- { rowId: '0', columnId: 'a', field: 'a', before: 'y', after: 'z' },
418
- ]
419
- ctx.historyPtr = 0 // pointer is behind the tail
420
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'v1' }
421
- ed.saveEditingCell()
422
- // Forward step (index 1) dropped, new step appended at index 1.
423
- expect(ctx.history).toHaveLength(2)
424
- expect(ctx.history[1].after).toBe('v1')
425
- expect(ctx.historyPtr).toBe(1)
426
- })
427
-
428
- it('caps the history at UNDO_LIMIT dropping the oldest entries', () => {
429
- const { ctx, ed } = editingFor({
430
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
431
- data: [{ a: 'start' }],
432
- })
433
- ctx.UNDO_LIMIT = 3
434
- ctx.history = [
435
- { rowId: '0', columnId: 'a', field: 'a', before: '0', after: '1' },
436
- { rowId: '0', columnId: 'a', field: 'a', before: '1', after: '2' },
437
- { rowId: '0', columnId: 'a', field: 'a', before: '2', after: '3' },
438
- ]
439
- ctx.historyPtr = 2
440
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'final' }
441
- ed.saveEditingCell()
442
- expect(ctx.history).toHaveLength(3) // capped
443
- expect(ctx.history[2].after).toBe('final') // newest kept
444
- expect(ctx.history[0].after).toBe('2') // oldest dropped
445
- expect(ctx.historyPtr).toBe(2)
446
- })
447
-
448
- it('fires onCellValueChange with the post-write payload', () => {
449
- const onCellValueChange = vi.fn()
450
- const { ctx, ed } = editingFor({
451
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
452
- data: [{ a: 'before' }],
453
- })
454
- ctx.props.onCellValueChange = onCellValueChange
455
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'after' }
456
- ed.saveEditingCell()
457
- expect(onCellValueChange).toHaveBeenCalledWith(
458
- expect.objectContaining({
459
- rowIndex: 0,
460
- columnId: 'a',
461
- oldValue: 'before',
462
- newValue: 'after',
463
- }),
464
- )
465
- })
466
-
467
- it('clears editing even when row/column cannot be resolved', () => {
468
- const { ctx, ed } = editingFor()
469
- ctx.editingCell = {
470
- rowId: 'missing',
471
- columnId: 'missing',
472
- editorType: 'text',
473
- value: 'x',
474
- }
475
- ed.saveEditingCell()
476
- expect(ctx.editingCell).toBeNull()
477
- expect(ctx.history).toHaveLength(0)
478
- })
479
- })
480
-
481
- describe('applyHistoryStep', () => {
482
- const step = {
483
- rowId: '0',
484
- columnId: 'a',
485
- field: 'a',
486
- before: 'B',
487
- after: 'A',
488
- }
489
-
490
- it('applies the before value on undo', () => {
491
- const { ctx, ed } = editingFor({
492
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
493
- data: [{ a: 'A' }],
494
- })
495
- ed.applyHistoryStep(step, 'undo')
496
- expect(ctx.internalData[0].a).toBe('B')
497
- expect(ctx.editedCellValues['0:a']).toBe('B')
498
- expect(ctx.grid.store.setState).toHaveBeenCalled()
499
- })
500
-
501
- it('applies the after value on redo', () => {
502
- const { ctx, ed } = editingFor({
503
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
504
- data: [{ a: 'B' }],
505
- })
506
- ed.applyHistoryStep(step, 'redo')
507
- expect(ctx.internalData[0].a).toBe('A')
508
- })
509
-
510
- it('fires onCellValueChange with swapped old/new on undo', () => {
511
- const onCellValueChange = vi.fn()
512
- const { ctx, ed } = editingFor({
513
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
514
- data: [{ a: 'A' }],
515
- })
516
- ctx.props.onCellValueChange = onCellValueChange
517
- ed.applyHistoryStep(step, 'undo')
518
- expect(onCellValueChange).toHaveBeenCalledWith(
519
- expect.objectContaining({ oldValue: 'A', newValue: 'B' }),
520
- )
521
- })
522
-
523
- it('is a no-op when the row or column is missing', () => {
524
- const { ctx, ed } = editingFor()
525
- ed.applyHistoryStep(
526
- { rowId: 'nope', columnId: 'a', field: 'a', before: 1, after: 2 },
527
- 'undo',
528
- )
529
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
530
- })
531
- })
532
-
533
- describe('updateEditingCellValue', () => {
534
- it('updates the value while preserving the rest of the editing cell', () => {
535
- const { ctx, ed } = editingFor()
536
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'old' }
537
- ed.updateEditingCellValue('new')
538
- expect(ctx.editingCell).toEqual({
539
- rowId: '0',
540
- columnId: 'a',
541
- editorType: 'text',
542
- value: 'new',
543
- })
544
- })
545
-
546
- it('leaves a null editing cell untouched', () => {
547
- const { ctx, ed } = editingFor()
548
- ed.updateEditingCellValue('x')
549
- expect(ctx.editingCell).toBeNull()
550
- })
551
- })
552
-
553
- describe('onEditorKeyDown', () => {
554
- function fakeEvent(key: string) {
555
- return {
556
- key,
557
- stopPropagation: vi.fn(),
558
- preventDefault: vi.fn(),
559
- } as unknown as KeyboardEvent
560
- }
561
-
562
- it('Enter saves the cell and refocuses the grid root', () => {
563
- const { ctx, ed } = editingFor({
564
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
565
- data: [{ a: 'old' }],
566
- })
567
- const focus = vi.fn()
568
- ctx.gridRootEl = { focus }
569
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'new' }
570
- const ev = fakeEvent('Enter')
571
- ed.onEditorKeyDown(ev)
572
- expect(ev.stopPropagation).toHaveBeenCalled()
573
- expect(ev.preventDefault).toHaveBeenCalled()
574
- expect(ctx.internalData[0].a).toBe('new')
575
- expect(ctx.editingCell).toBeNull()
576
- expect(focus).toHaveBeenCalledWith({ preventScroll: true })
577
- })
578
-
579
- it('Escape cancels without saving and refocuses the grid root', () => {
580
- const { ctx, ed } = editingFor({
581
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
582
- data: [{ a: 'old' }],
583
- })
584
- const focus = vi.fn()
585
- ctx.gridRootEl = { focus }
586
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'discard' }
587
- const ev = fakeEvent('Escape')
588
- ed.onEditorKeyDown(ev)
589
- expect(ctx.internalData[0].a).toBe('old') // unchanged
590
- expect(ctx.editingCell).toBeNull()
591
- expect(focus).toHaveBeenCalled()
592
- })
593
-
594
- it('stops propagation for other keys without saving or cancelling', () => {
595
- const { ctx, ed } = editingFor()
596
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'x' }
597
- const ev = fakeEvent('a')
598
- ed.onEditorKeyDown(ev)
599
- expect(ev.stopPropagation).toHaveBeenCalled()
600
- expect(ev.preventDefault).not.toHaveBeenCalled()
601
- expect(ctx.editingCell).not.toBeNull()
602
- })
603
-
604
- it('tolerates a null gridRootEl on Escape', () => {
605
- const { ctx, ed } = editingFor()
606
- ctx.gridRootEl = null
607
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'x' }
608
- expect(() => ed.onEditorKeyDown(fakeEvent('Escape'))).not.toThrow()
609
- expect(ctx.editingCell).toBeNull()
610
- })
611
-
612
- // #45 in the original report: Tab used to commit and then let the browser
613
- // walk focus out of the grid, because editors stopPropagation() every key
614
- // and nothing called preventDefault() for Tab.
615
- it('Tab saves and advances the active cell one column (#48)', () => {
616
- const { ctx, ed } = editingFor({
617
- columns: [
618
- { id: 'a', field: 'a', editorType: 'text' },
619
- { id: 'b', field: 'b', editorType: 'text' },
620
- ],
621
- data: [{ a: 'old', b: 'b0' }],
622
- })
623
- ctx.gridRootEl = { focus: vi.fn() }
624
- ed.onCellDoubleClick(0, 0)
625
- ctx.editingCell = { ...ctx.editingCell, value: 'new' }
626
- const ev = fakeEvent('Tab')
627
- ed.onEditorKeyDown(ev)
628
- expect(ev.preventDefault).toHaveBeenCalled()
629
- expect(ctx.internalData[0].a).toBe('new')
630
- expect(ctx.activeCalls.at(-1)).toEqual([0, 1])
631
- })
632
-
633
- it('Shift+Tab moves back a column and wraps to the previous row (#48)', () => {
634
- const { ctx, ed } = editingFor({
635
- columns: [
636
- { id: 'a', field: 'a', editorType: 'text' },
637
- { id: 'b', field: 'b', editorType: 'text' },
638
- ],
639
- data: [
640
- { a: 'a0', b: 'b0' },
641
- { a: 'a1', b: 'b1' },
642
- ],
643
- })
644
- ctx.gridRootEl = { focus: vi.fn() }
645
- ed.onCellDoubleClick(1, 0)
646
- const ev = { ...fakeEvent('Tab'), shiftKey: true } as unknown as KeyboardEvent
647
- ;(ev as any).preventDefault = vi.fn()
648
- ;(ev as any).stopPropagation = vi.fn()
649
- ed.onEditorKeyDown(ev)
650
- // Off the left edge -> last column of the row above.
651
- expect(ctx.activeCalls.at(-1)).toEqual([0, 1])
652
- })
653
- })
654
-
655
- describe('saveEditingCell when the row leaves the row model (#49)', () => {
656
- it('writes through the captured row when a filter hides it mid-edit', () => {
657
- const { ctx, ed } = editingFor({
658
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
659
- data: [{ a: 'old' }, { a: 'other' }],
660
- })
661
- const target = ctx.internalData[0]
662
- ed.onCellDoubleClick(0, 0)
663
- ctx.editingCell = { ...ctx.editingCell, value: 'typed' }
664
- // A filter typed into the filter row drops the edited row from BOTH the
665
- // page slice and the full filtered model while the editor is still open.
666
- ctx._rows = ctx._rows.slice(1)
667
- ctx._rowsBeforePagination = ctx._rows
668
- ed.saveEditingCell()
669
- expect(target.a).toBe('typed')
670
- expect(ctx.editingCell).toBeNull()
671
- })
672
-
673
- it('still resolves a row that is only off the current page', () => {
674
- const { ctx, ed } = editingFor({
675
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
676
- data: [{ a: 'old' }, { a: 'other' }],
677
- })
678
- const target = ctx.internalData[0]
679
- ed.onCellDoubleClick(0, 0)
680
- ctx.editingCell = { ...ctx.editingCell, value: 'typed' }
681
- // Paginated away: gone from `allRows`, still in the full filtered model.
682
- ctx._rowsBeforePagination = ctx._rows
683
- ctx._rows = ctx._rows.slice(1)
684
- ed.saveEditingCell()
685
- expect(target.a).toBe('typed')
686
- })
687
- })
688
-
689
- describe('focusOnMount', () => {
690
- let rafCb: FrameRequestCallback | null = null
691
- beforeEach(() => {
692
- rafCb = null
693
- vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => {
694
- rafCb = cb
695
- return 1
696
- })
697
- })
698
-
699
- function fakeInput(value: string) {
700
- return {
701
- value,
702
- focus: vi.fn(),
703
- select: vi.fn(),
704
- setSelectionRange: vi.fn(),
705
- }
706
- }
707
-
708
- it('selects all when editorSelectAll is set', () => {
709
- const { ctx, ed } = editingFor()
710
- ctx.editorSelectAll = true
711
- const node = fakeInput('hello')
712
- ed.focusOnMount(node as any)
713
- rafCb?.(0)
714
- expect(node.focus).toHaveBeenCalledWith({ preventScroll: true })
715
- expect(node.select).toHaveBeenCalled()
716
- expect(node.setSelectionRange).not.toHaveBeenCalled()
717
- })
718
-
719
- it('places the caret at the end when not selecting all', () => {
720
- const { ctx, ed } = editingFor()
721
- ctx.editorSelectAll = false
722
- const node = fakeInput('hello')
723
- ed.focusOnMount(node as any)
724
- rafCb?.(0)
725
- expect(node.setSelectionRange).toHaveBeenCalledWith(5, 5)
726
- expect(node.select).not.toHaveBeenCalled()
727
- })
728
-
729
- it('swallows errors from inputs that reject selection ranges', () => {
730
- const { ctx, ed } = editingFor()
731
- ctx.editorSelectAll = false
732
- const node = {
733
- value: '2020-01-01',
734
- focus: vi.fn(),
735
- select: vi.fn(),
736
- setSelectionRange: () => {
737
- throw new Error('unsupported')
738
- },
739
- }
740
- ed.focusOnMount(node as any)
741
- expect(() => rafCb?.(0)).not.toThrow()
742
- expect(node.focus).toHaveBeenCalled()
743
- })
744
- })
745
-
746
- describe('onCellDoubleClick', () => {
747
- it('enters edit mode seeded with the current display value', () => {
748
- const { ctx, ed } = editingFor({
749
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
750
- data: [{ a: 'val' }],
751
- })
752
- ed.onCellDoubleClick(0, 0)
753
- expect(ctx.editorSelectAll).toBe(true)
754
- expect(ctx.editingCell).toEqual({
755
- rowId: '0',
756
- columnId: 'a',
757
- editorType: 'text',
758
- value: 'val',
759
- rowRef: ctx.internalData[0],
760
- })
761
- expect(ctx.activeCalls).toEqual([[0, 0]])
762
- expect(ctx.selectionCalls).toEqual([[0, 0]])
763
- })
764
-
765
- it('prefers an edited override as the seed value', () => {
766
- const { ctx, ed } = editingFor({
767
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
768
- data: [{ a: 'base' }],
769
- })
770
- ctx.editedCellValues['0:a'] = 'override'
771
- ed.onCellDoubleClick(0, 0)
772
- expect(ctx.editingCell.value).toBe('override')
773
- })
774
-
775
- it('returns early when editing is disabled', () => {
776
- const { ctx, ed } = editingFor({ editingEnabled: false })
777
- ed.onCellDoubleClick(0, 0)
778
- expect(ctx.editingCell).toBeNull()
779
- })
780
-
781
- it('returns early for missing row/column or group rows', () => {
782
- const { ctx, ed } = editingFor({
783
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
784
- data: [{ a: 'x' }],
785
- groupRows: new Set([0]),
786
- })
787
- ed.onCellDoubleClick(99, 0)
788
- ed.onCellDoubleClick(0, 99)
789
- ed.onCellDoubleClick(0, 0) // group row
790
- expect(ctx.editingCell).toBeNull()
791
- })
792
-
793
- it('returns early for a non-editable cell', () => {
794
- const { ctx, ed } = editingFor({
795
- columns: [{ id: 'a', field: 'a', editable: false, editorType: 'text' }],
796
- data: [{ a: 'x' }],
797
- })
798
- ed.onCellDoubleClick(0, 0)
799
- expect(ctx.editingCell).toBeNull()
800
- })
801
-
802
- it('is a no-op when already editing the same cell', () => {
803
- const { ctx, ed } = editingFor({
804
- columns: [{ id: 'a', field: 'a', editorType: 'text' }],
805
- data: [{ a: 'x' }],
806
- })
807
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'mid-edit' }
808
- ed.onCellDoubleClick(0, 0)
809
- expect(ctx.editingCell.value).toBe('mid-edit') // untouched
810
- expect(ctx.activeCalls).toEqual([]) // setActiveCell not called
811
- })
812
-
813
- it('seeds a multi-select list editor with an array', () => {
814
- const { ctx, ed } = editingFor({
815
- columns: [
816
- { id: 'a', field: 'a', editorType: 'list', editorMultiple: true },
817
- ],
818
- data: [{ a: 'one' }],
819
- })
820
- ed.onCellDoubleClick(0, 0)
821
- expect(Array.isArray(ctx.editingCell.value)).toBe(true)
822
- expect(ctx.editingCell.value).toEqual(['one'])
823
- })
824
-
825
- it('unwraps an array seed for a single-select list editor', () => {
826
- const { ctx, ed } = editingFor({
827
- columns: [{ id: 'a', field: 'a', editorType: 'list' }],
828
- data: [{ a: ['first', 'second'] }],
829
- })
830
- ed.onCellDoubleClick(0, 0)
831
- expect(ctx.editingCell.value).toBe('first')
832
- })
833
-
834
- it('uses empty string for a single-select chips editor seeded from an empty array', () => {
835
- const { ctx, ed } = editingFor({
836
- columns: [{ id: 'a', field: 'a', editorType: 'chips' }],
837
- data: [{ a: [] }],
838
- })
839
- ed.onCellDoubleClick(0, 0)
840
- expect(ctx.editingCell.value).toBe('')
841
- })
842
- })
843
-
844
- describe('clipboard fallbacks (non-paste branches only)', () => {
845
- // onGridPaste and pasteFromClipboard guard on navigator.clipboard.readText.
846
- // The actual paste transformation is covered by clipboard.test.ts; here we
847
- // only assert the early-return guards so we do not duplicate that coverage.
848
-
849
- it('pasteFromClipboard returns early when the async API is unavailable', async () => {
850
- Object.defineProperty(navigator, 'clipboard', {
851
- value: undefined,
852
- configurable: true,
853
- })
854
- const { ctx, ed } = editingFor()
855
- await ed.pasteFromClipboard()
856
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
857
- })
858
-
859
- it('pasteFromClipboard swallows a rejected readText', async () => {
860
- Object.defineProperty(navigator, 'clipboard', {
861
- value: { readText: vi.fn().mockRejectedValue(new Error('denied')) },
862
- configurable: true,
863
- })
864
- const { ctx, ed } = editingFor()
865
- await expect(ed.pasteFromClipboard()).resolves.toBeUndefined()
866
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
867
- })
868
-
869
- it('onGridPaste ignores the native event when the async API is present', () => {
870
- Object.defineProperty(navigator, 'clipboard', {
871
- value: { readText: vi.fn() },
872
- configurable: true,
873
- })
874
- const { ctx, ed } = editingFor()
875
- const ev = {
876
- clipboardData: { getData: () => 'a\tb' },
877
- preventDefault: vi.fn(),
878
- } as unknown as ClipboardEvent
879
- ed.onGridPaste(ev)
880
- expect(ev.preventDefault).not.toHaveBeenCalled()
881
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
882
- })
883
-
884
- it('onGridPaste returns early on empty clipboard text in the fallback path', () => {
885
- Object.defineProperty(navigator, 'clipboard', {
886
- value: undefined,
887
- configurable: true,
888
- })
889
- const { ctx, ed } = editingFor()
890
- const ev = {
891
- clipboardData: { getData: () => '' },
892
- preventDefault: vi.fn(),
893
- } as unknown as ClipboardEvent
894
- ed.onGridPaste(ev)
895
- expect(ev.preventDefault).not.toHaveBeenCalled()
896
- expect(ctx.grid.store.setState).not.toHaveBeenCalled()
897
- })
898
-
899
- it('onGridPaste applies pasted text via the fallback path', () => {
900
- Object.defineProperty(navigator, 'clipboard', {
901
- value: undefined,
902
- configurable: true,
903
- })
904
- const { ctx, ed } = editingFor({
905
- columns: [
906
- { id: 'a', field: 'a', editorType: 'text', editable: true },
907
- { id: 'b', field: 'b', editorType: 'text', editable: true },
908
- ],
909
- data: [
910
- { a: '', b: '' },
911
- { a: '', b: '' },
912
- ],
913
- })
914
- ctx.selectionRange = {
915
- anchor: { rowIndex: 0, colIndex: 0 },
916
- focus: { rowIndex: 0, colIndex: 0 },
917
- }
918
- const ev = {
919
- clipboardData: { getData: () => 'X\tY\nZ\tW' },
920
- preventDefault: vi.fn(),
921
- } as unknown as ClipboardEvent
922
- ed.onGridPaste(ev)
923
- expect(ev.preventDefault).toHaveBeenCalled()
924
- expect(ctx.internalData[0]).toMatchObject({ a: 'X', b: 'Y' })
925
- expect(ctx.internalData[1]).toMatchObject({ a: 'Z', b: 'W' })
926
- })
927
-
928
- it('onGridPaste bails while a cell is being edited (native editor paste wins)', () => {
929
- Object.defineProperty(navigator, 'clipboard', {
930
- value: undefined, // fallback path (Firefox / insecure) - would otherwise hijack
931
- configurable: true,
932
- })
933
- const { ctx, ed } = editingFor({
934
- columns: [{ id: 'a', field: 'a', editorType: 'text', editable: true }],
935
- data: [{ a: 'orig' }],
936
- })
937
- ctx.selectionRange = { anchor: { rowIndex: 0, colIndex: 0 }, focus: { rowIndex: 0, colIndex: 0 } }
938
- ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'orig' }
939
- const ev = {
940
- clipboardData: { getData: () => 'PASTED' },
941
- preventDefault: vi.fn(),
942
- } as unknown as ClipboardEvent
943
- ed.onGridPaste(ev)
944
- // The grid must NOT preventDefault (so the editor's native paste proceeds)
945
- // and must NOT write to the data cell.
946
- expect(ev.preventDefault).not.toHaveBeenCalled()
947
- expect(ctx.internalData[0]).toMatchObject({ a: 'orig' })
948
- })
949
- })
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest'
2
+ import { createEditing } from './editing'
3
+
4
+ // ---------------------------------------------------------------------------
5
+ // Fake controller `ctx` for the editing handlers. The handlers operate purely
6
+ // through this handle (mirroring clipboard.test.ts), so a hand-rolled stub
7
+ // drives every non-clipboard branch without mounting the grid. Clipboard
8
+ // paste paths are covered by clipboard.test.ts and only lightly touched here.
9
+ // ---------------------------------------------------------------------------
10
+
11
+ interface ColSpec {
12
+ id: string
13
+ field?: string
14
+ editable?: boolean | ((cellCtx: any) => boolean)
15
+ editorType?: string
16
+ editorMultiple?: boolean
17
+ }
18
+
19
+ interface FakeOptions {
20
+ columns?: ColSpec[]
21
+ data?: Array<Record<string, unknown>>
22
+ groupRows?: Set<number>
23
+ editingEnabled?: boolean
24
+ }
25
+
26
+ function makeCtx(opts: FakeOptions = {}) {
27
+ const columns: ColSpec[] = opts.columns ?? [
28
+ { id: 'a', field: 'a', editable: true, editorType: 'text' },
29
+ { id: 'b', field: 'b', editable: true, editorType: 'number' },
30
+ ]
31
+ const data = (opts.data ?? [
32
+ { a: 'a0', b: 0 },
33
+ { a: 'a1', b: 1 },
34
+ ]).map((d) => ({ ...d }))
35
+
36
+ const allColumns = columns.map((c) => ({
37
+ id: c.id,
38
+ columnDef: {
39
+ field: c.field,
40
+ editable: c.editable,
41
+ editorType: c.editorType,
42
+ editorMultiple: c.editorMultiple,
43
+ },
44
+ }))
45
+
46
+ let activeCell: { rowIndex: number; colIndex: number } | null = null
47
+
48
+ const buildRows = (rows: Array<Record<string, unknown>>) =>
49
+ rows.map((row, index) => ({
50
+ id: String(index),
51
+ original: row,
52
+ getCanExpand: () => opts.groupRows?.has(index) ?? false,
53
+ getCellValueByColumnId: (colId: string) =>
54
+ (row as Record<string, unknown>)[colId],
55
+ }))
56
+
57
+ let backing = data
58
+
59
+ const ctx: any = {
60
+ allColumns,
61
+ _rows: buildRows(data),
62
+ get allRows() {
63
+ return ctx._rows
64
+ },
65
+ // The full filtered model. Same rows here (the fake has no pagination);
66
+ // tests that exercise the "row left the model" path override `_rows`
67
+ // alone so the two genuinely diverge.
68
+ get allRowsBeforePagination() {
69
+ return ctx._rowsBeforePagination ?? ctx._rows
70
+ },
71
+ get activeCell() {
72
+ return activeCell
73
+ },
74
+ scrollActiveCellIntoView: () => {},
75
+ editingEnabled: opts.editingEnabled ?? true,
76
+ editingCell: null,
77
+ editorSelectAll: false,
78
+ editedCellValues: {},
79
+ selectionRange: { anchor: null, focus: null },
80
+ gridRootEl: null,
81
+ props: {},
82
+ history: [] as any[],
83
+ historyPtr: -1,
84
+ historyVersion: 0,
85
+ UNDO_LIMIT: 100,
86
+ activeCalls: [] as Array<[number, number]>,
87
+ selectionCalls: [] as Array<[number, number]>,
88
+ setActiveCell: (r: number, c: number) => {
89
+ activeCell = { rowIndex: r, colIndex: c }
90
+ ctx.activeCalls.push([r, c])
91
+ },
92
+ setSelection: (r: number, c: number) => {
93
+ ctx.selectionCalls.push([r, c])
94
+ },
95
+ grid: {
96
+ getState: () => ({ activeCell }),
97
+ store: { setState: vi.fn() },
98
+ },
99
+ }
100
+
101
+ Object.defineProperty(ctx, 'internalData', {
102
+ get: () => backing,
103
+ set: (next: Array<Record<string, unknown>>) => {
104
+ backing = next
105
+ ctx._rows = buildRows(next)
106
+ },
107
+ })
108
+ ctx.internalData = data
109
+
110
+ return ctx
111
+ }
112
+
113
+ const editingFor = (opts?: FakeOptions) => {
114
+ const ctx = makeCtx(opts)
115
+ return { ctx, ed: createEditing(ctx) }
116
+ }
117
+
118
+ describe('isCellEditable', () => {
119
+ it('treats undefined editable as editable', () => {
120
+ const { ctx, ed } = editingFor({
121
+ columns: [{ id: 'a', field: 'a' }],
122
+ data: [{ a: 1 }],
123
+ })
124
+ expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(true)
125
+ })
126
+
127
+ it('treats editable:false as locked (fast path, no row needed)', () => {
128
+ const { ctx, ed } = editingFor({
129
+ columns: [{ id: 'a', field: 'a', editable: false }],
130
+ })
131
+ expect(ed.isCellEditable(ctx.allColumns[0])).toBe(false)
132
+ })
133
+
134
+ it('honours a cell-level predicate returning false', () => {
135
+ const { ctx, ed } = editingFor({
136
+ columns: [{ id: 'a', field: 'a', editable: () => false }],
137
+ data: [{ a: 1 }],
138
+ })
139
+ expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(false)
140
+ })
141
+
142
+ it('honours a cell-level predicate returning true', () => {
143
+ const { ctx, ed } = editingFor({
144
+ columns: [{ id: 'a', field: 'a', editable: (cc: any) => cc.row.id === '0' }],
145
+ data: [{ a: 1 }],
146
+ })
147
+ expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(true)
148
+ })
149
+
150
+ it('passes a usable CellContext to the predicate', () => {
151
+ const spy = vi.fn().mockReturnValue(true)
152
+ const { ctx, ed } = editingFor({
153
+ columns: [{ id: 'a', field: 'a', editable: spy }],
154
+ data: [{ a: 'hello' }],
155
+ })
156
+ ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])
157
+ const cc = spy.mock.calls[0]![0]
158
+ expect(cc.getValue()).toBe('hello')
159
+ expect(cc.cell.getValue()).toBe('hello')
160
+ expect(cc.cell.getContext()).toBe(cc)
161
+ expect(cc.column).toBe(ctx.allColumns[0])
162
+ })
163
+
164
+ it('returns editable when predicate exists but no row supplied', () => {
165
+ const { ctx, ed } = editingFor({
166
+ columns: [{ id: 'a', field: 'a', editable: () => false }],
167
+ })
168
+ // No row -> cannot evaluate predicate -> defaults to editable.
169
+ expect(ed.isCellEditable(ctx.allColumns[0])).toBe(true)
170
+ })
171
+
172
+ it('biases to not-editable when the predicate throws', () => {
173
+ const { ctx, ed } = editingFor({
174
+ columns: [
175
+ {
176
+ id: 'a',
177
+ field: 'a',
178
+ editable: () => {
179
+ throw new Error('boom')
180
+ },
181
+ },
182
+ ],
183
+ data: [{ a: 1 }],
184
+ })
185
+ expect(ed.isCellEditable(ctx.allColumns[0], ctx.allRows[0])).toBe(false)
186
+ })
187
+ })
188
+
189
+ describe('isCellEditableAt', () => {
190
+ it('resolves row/column by index then defers to isCellEditable', () => {
191
+ const { ed } = editingFor({
192
+ columns: [
193
+ { id: 'a', field: 'a', editable: true },
194
+ { id: 'b', field: 'b', editable: false },
195
+ ],
196
+ data: [{ a: 1, b: 2 }],
197
+ })
198
+ expect(ed.isCellEditableAt(0, 0)).toBe(true)
199
+ expect(ed.isCellEditableAt(0, 1)).toBe(false)
200
+ })
201
+
202
+ it('returns false when the column index is out of range', () => {
203
+ const { ed } = editingFor()
204
+ expect(ed.isCellEditableAt(0, 99)).toBe(false)
205
+ })
206
+ })
207
+
208
+ describe('getRowColumnValue', () => {
209
+ it('reads the base value when the column id is known', () => {
210
+ const { ctx, ed } = editingFor({
211
+ columns: [{ id: 'a', field: 'a' }],
212
+ data: [{ a: 'x' }],
213
+ })
214
+ expect(ed.getRowColumnValue(ctx.allRows[0], 'a')).toBe('x')
215
+ })
216
+
217
+ it('falls back to row.getCellValueByColumnId for an unknown column', () => {
218
+ const { ctx, ed } = editingFor({
219
+ columns: [{ id: 'a', field: 'a' }],
220
+ data: [{ a: 'x', ghost: 'g' }],
221
+ })
222
+ expect(ed.getRowColumnValue(ctx.allRows[0], 'ghost')).toBe('g')
223
+ })
224
+ })
225
+
226
+ describe('getCellDisplayValue', () => {
227
+ it('returns the base value when there is no pending edit', () => {
228
+ const { ed } = editingFor()
229
+ expect(ed.getCellDisplayValue('0', 'a', 'base')).toBe('base')
230
+ })
231
+
232
+ it('prefers an edited override keyed by rowId:colId', () => {
233
+ const { ctx, ed } = editingFor()
234
+ ctx.editedCellValues['0:a'] = 'edited'
235
+ expect(ed.getCellDisplayValue('0', 'a', 'base')).toBe('edited')
236
+ })
237
+
238
+ it('treats an explicit undefined override as present', () => {
239
+ const { ctx, ed } = editingFor()
240
+ ctx.editedCellValues['0:a'] = undefined
241
+ expect(ed.getCellDisplayValue('0', 'a', 'base')).toBeUndefined()
242
+ })
243
+ })
244
+
245
+ describe('startEditingWithChar', () => {
246
+ it('seeds the editor with the typed character and sets active/selection', () => {
247
+ const { ctx, ed } = editingFor({
248
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
249
+ data: [{ a: 'x' }],
250
+ })
251
+ expect(ed.startEditingWithChar(0, 0, 'Z')).toBe(true)
252
+ expect(ctx.editingCell).toEqual({
253
+ rowId: '0',
254
+ columnId: 'a',
255
+ editorType: 'text',
256
+ value: 'Z',
257
+ // The row's data object, kept so the commit still lands if a filter
258
+ // drops the row from the model mid-edit (#49).
259
+ rowRef: ctx.internalData[0],
260
+ })
261
+ expect(ctx.editorSelectAll).toBe(false)
262
+ expect(ctx.activeCalls).toEqual([[0, 0]])
263
+ expect(ctx.selectionCalls).toEqual([[0, 0]])
264
+ })
265
+
266
+ it('defaults the editor type to text when none is declared', () => {
267
+ const { ctx, ed } = editingFor({
268
+ columns: [{ id: 'a', field: 'a' }],
269
+ data: [{ a: 'x' }],
270
+ })
271
+ ed.startEditingWithChar(0, 0, 'k')
272
+ expect(ctx.editingCell.editorType).toBe('text')
273
+ })
274
+
275
+ it('returns false when editing is globally disabled', () => {
276
+ const { ctx, ed } = editingFor({ editingEnabled: false })
277
+ expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
278
+ expect(ctx.editingCell).toBeNull()
279
+ })
280
+
281
+ it('returns false for a missing row or column', () => {
282
+ const { ed } = editingFor()
283
+ expect(ed.startEditingWithChar(99, 0, 'a')).toBe(false)
284
+ expect(ed.startEditingWithChar(0, 99, 'a')).toBe(false)
285
+ })
286
+
287
+ it('returns false for a group row', () => {
288
+ const { ed } = editingFor({
289
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
290
+ data: [{ a: 'x' }],
291
+ groupRows: new Set([0]),
292
+ })
293
+ expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
294
+ })
295
+
296
+ it('returns false for a non-editable cell', () => {
297
+ const { ed } = editingFor({
298
+ columns: [{ id: 'a', field: 'a', editable: false, editorType: 'text' }],
299
+ data: [{ a: 'x' }],
300
+ })
301
+ expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
302
+ })
303
+
304
+ it('rejects type-to-edit for checkbox/date/datetime/list/chips editors', () => {
305
+ for (const editorType of ['checkbox', 'date', 'datetime', 'list', 'chips']) {
306
+ const { ed } = editingFor({
307
+ columns: [{ id: 'a', field: 'a', editorType }],
308
+ data: [{ a: 'x' }],
309
+ })
310
+ expect(ed.startEditingWithChar(0, 0, 'a')).toBe(false)
311
+ }
312
+ })
313
+
314
+ it('rejects a non-numeric character on a number editor', () => {
315
+ const { ed } = editingFor({
316
+ columns: [{ id: 'a', field: 'a', editorType: 'number' }],
317
+ data: [{ a: 1 }],
318
+ })
319
+ expect(ed.startEditingWithChar(0, 0, 'x')).toBe(false)
320
+ })
321
+
322
+ it('accepts a numeric character on a number editor', () => {
323
+ const { ctx, ed } = editingFor({
324
+ columns: [{ id: 'a', field: 'a', editorType: 'number' }],
325
+ data: [{ a: 1 }],
326
+ })
327
+ expect(ed.startEditingWithChar(0, 0, '7')).toBe(true)
328
+ expect(ctx.editingCell.value).toBe('7')
329
+ })
330
+ })
331
+
332
+ describe('saveEditingCell', () => {
333
+ it('does nothing when there is no editing cell', () => {
334
+ const { ctx, ed } = editingFor()
335
+ ed.saveEditingCell()
336
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
337
+ })
338
+
339
+ it('parses, writes original, records edited value, and clears editing', () => {
340
+ const { ctx, ed } = editingFor({
341
+ columns: [{ id: 'b', field: 'b', editorType: 'number' }],
342
+ data: [{ b: 0 }],
343
+ })
344
+ ctx.editingCell = { rowId: '0', columnId: 'b', editorType: 'number', value: '42' }
345
+ ed.saveEditingCell()
346
+ expect(ctx.internalData[0].b).toBe(42) // parsed to number, written to original
347
+ expect(ctx.editedCellValues['0:b']).toBe(42)
348
+ expect(ctx.editingCell).toBeNull()
349
+ expect(ctx.grid.store.setState).toHaveBeenCalled()
350
+ })
351
+
352
+ it('coerces an unparseable number to null', () => {
353
+ const { ctx, ed } = editingFor({
354
+ columns: [{ id: 'b', field: 'b', editorType: 'number' }],
355
+ data: [{ b: 5 }],
356
+ })
357
+ ctx.editingCell = { rowId: '0', columnId: 'b', editorType: 'number', value: 'abc' }
358
+ ed.saveEditingCell()
359
+ expect(ctx.internalData[0].b).toBeNull()
360
+ })
361
+
362
+ it('respects editorMultiple when parsing list editors', () => {
363
+ const { ctx, ed } = editingFor({
364
+ columns: [
365
+ { id: 'a', field: 'a', editorType: 'list', editorMultiple: true },
366
+ ],
367
+ data: [{ a: [] }],
368
+ })
369
+ ctx.editingCell = {
370
+ rowId: '0',
371
+ columnId: 'a',
372
+ editorType: 'list',
373
+ value: ['x', 'y'],
374
+ }
375
+ ed.saveEditingCell()
376
+ expect(ctx.internalData[0].a).toEqual(['x', 'y'])
377
+ })
378
+
379
+ it('pushes a history step and bumps the version on a real change', () => {
380
+ const { ctx, ed } = editingFor({
381
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
382
+ data: [{ a: 'old' }],
383
+ })
384
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'new' }
385
+ ed.saveEditingCell()
386
+ expect(ctx.history).toHaveLength(1)
387
+ expect(ctx.history[0]).toMatchObject({
388
+ rowId: '0',
389
+ columnId: 'a',
390
+ field: 'a',
391
+ before: 'old',
392
+ after: 'new',
393
+ })
394
+ expect(ctx.historyPtr).toBe(0)
395
+ expect(ctx.historyVersion).toBe(1)
396
+ })
397
+
398
+ it('does not push history when the value is unchanged', () => {
399
+ const { ctx, ed } = editingFor({
400
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
401
+ data: [{ a: 'same' }],
402
+ })
403
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'same' }
404
+ ed.saveEditingCell()
405
+ expect(ctx.history).toHaveLength(0)
406
+ expect(ctx.historyVersion).toBe(0)
407
+ })
408
+
409
+ it('truncates forward (redo) history when editing after an undo', () => {
410
+ const { ctx, ed } = editingFor({
411
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
412
+ data: [{ a: 'v0' }],
413
+ })
414
+ // Pretend there is forward history the user could have redone.
415
+ ctx.history = [
416
+ { rowId: '0', columnId: 'a', field: 'a', before: 'x', after: 'y' },
417
+ { rowId: '0', columnId: 'a', field: 'a', before: 'y', after: 'z' },
418
+ ]
419
+ ctx.historyPtr = 0 // pointer is behind the tail
420
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'v1' }
421
+ ed.saveEditingCell()
422
+ // Forward step (index 1) dropped, new step appended at index 1.
423
+ expect(ctx.history).toHaveLength(2)
424
+ expect(ctx.history[1].after).toBe('v1')
425
+ expect(ctx.historyPtr).toBe(1)
426
+ })
427
+
428
+ it('caps the history at UNDO_LIMIT dropping the oldest entries', () => {
429
+ const { ctx, ed } = editingFor({
430
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
431
+ data: [{ a: 'start' }],
432
+ })
433
+ ctx.UNDO_LIMIT = 3
434
+ ctx.history = [
435
+ { rowId: '0', columnId: 'a', field: 'a', before: '0', after: '1' },
436
+ { rowId: '0', columnId: 'a', field: 'a', before: '1', after: '2' },
437
+ { rowId: '0', columnId: 'a', field: 'a', before: '2', after: '3' },
438
+ ]
439
+ ctx.historyPtr = 2
440
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'final' }
441
+ ed.saveEditingCell()
442
+ expect(ctx.history).toHaveLength(3) // capped
443
+ expect(ctx.history[2].after).toBe('final') // newest kept
444
+ expect(ctx.history[0].after).toBe('2') // oldest dropped
445
+ expect(ctx.historyPtr).toBe(2)
446
+ })
447
+
448
+ it('fires onCellValueChange with the post-write payload', () => {
449
+ const onCellValueChange = vi.fn()
450
+ const { ctx, ed } = editingFor({
451
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
452
+ data: [{ a: 'before' }],
453
+ })
454
+ ctx.props.onCellValueChange = onCellValueChange
455
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'after' }
456
+ ed.saveEditingCell()
457
+ expect(onCellValueChange).toHaveBeenCalledWith(
458
+ expect.objectContaining({
459
+ rowIndex: 0,
460
+ columnId: 'a',
461
+ oldValue: 'before',
462
+ newValue: 'after',
463
+ }),
464
+ )
465
+ })
466
+
467
+ it('clears editing even when row/column cannot be resolved', () => {
468
+ const { ctx, ed } = editingFor()
469
+ ctx.editingCell = {
470
+ rowId: 'missing',
471
+ columnId: 'missing',
472
+ editorType: 'text',
473
+ value: 'x',
474
+ }
475
+ ed.saveEditingCell()
476
+ expect(ctx.editingCell).toBeNull()
477
+ expect(ctx.history).toHaveLength(0)
478
+ })
479
+ })
480
+
481
+ describe('applyHistoryStep', () => {
482
+ const step = {
483
+ rowId: '0',
484
+ columnId: 'a',
485
+ field: 'a',
486
+ before: 'B',
487
+ after: 'A',
488
+ }
489
+
490
+ it('applies the before value on undo', () => {
491
+ const { ctx, ed } = editingFor({
492
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
493
+ data: [{ a: 'A' }],
494
+ })
495
+ ed.applyHistoryStep(step, 'undo')
496
+ expect(ctx.internalData[0].a).toBe('B')
497
+ expect(ctx.editedCellValues['0:a']).toBe('B')
498
+ expect(ctx.grid.store.setState).toHaveBeenCalled()
499
+ })
500
+
501
+ it('applies the after value on redo', () => {
502
+ const { ctx, ed } = editingFor({
503
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
504
+ data: [{ a: 'B' }],
505
+ })
506
+ ed.applyHistoryStep(step, 'redo')
507
+ expect(ctx.internalData[0].a).toBe('A')
508
+ })
509
+
510
+ it('fires onCellValueChange with swapped old/new on undo', () => {
511
+ const onCellValueChange = vi.fn()
512
+ const { ctx, ed } = editingFor({
513
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
514
+ data: [{ a: 'A' }],
515
+ })
516
+ ctx.props.onCellValueChange = onCellValueChange
517
+ ed.applyHistoryStep(step, 'undo')
518
+ expect(onCellValueChange).toHaveBeenCalledWith(
519
+ expect.objectContaining({ oldValue: 'A', newValue: 'B' }),
520
+ )
521
+ })
522
+
523
+ it('is a no-op when the row or column is missing', () => {
524
+ const { ctx, ed } = editingFor()
525
+ ed.applyHistoryStep(
526
+ { rowId: 'nope', columnId: 'a', field: 'a', before: 1, after: 2 },
527
+ 'undo',
528
+ )
529
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
530
+ })
531
+ })
532
+
533
+ describe('updateEditingCellValue', () => {
534
+ it('updates the value while preserving the rest of the editing cell', () => {
535
+ const { ctx, ed } = editingFor()
536
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'old' }
537
+ ed.updateEditingCellValue('new')
538
+ expect(ctx.editingCell).toEqual({
539
+ rowId: '0',
540
+ columnId: 'a',
541
+ editorType: 'text',
542
+ value: 'new',
543
+ })
544
+ })
545
+
546
+ it('leaves a null editing cell untouched', () => {
547
+ const { ctx, ed } = editingFor()
548
+ ed.updateEditingCellValue('x')
549
+ expect(ctx.editingCell).toBeNull()
550
+ })
551
+ })
552
+
553
+ describe('onEditorKeyDown', () => {
554
+ function fakeEvent(key: string) {
555
+ return {
556
+ key,
557
+ stopPropagation: vi.fn(),
558
+ preventDefault: vi.fn(),
559
+ } as unknown as KeyboardEvent
560
+ }
561
+
562
+ it('Enter saves the cell and refocuses the grid root', () => {
563
+ const { ctx, ed } = editingFor({
564
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
565
+ data: [{ a: 'old' }],
566
+ })
567
+ const focus = vi.fn()
568
+ ctx.gridRootEl = { focus }
569
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'new' }
570
+ const ev = fakeEvent('Enter')
571
+ ed.onEditorKeyDown(ev)
572
+ expect(ev.stopPropagation).toHaveBeenCalled()
573
+ expect(ev.preventDefault).toHaveBeenCalled()
574
+ expect(ctx.internalData[0].a).toBe('new')
575
+ expect(ctx.editingCell).toBeNull()
576
+ expect(focus).toHaveBeenCalledWith({ preventScroll: true })
577
+ })
578
+
579
+ it('Escape cancels without saving and refocuses the grid root', () => {
580
+ const { ctx, ed } = editingFor({
581
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
582
+ data: [{ a: 'old' }],
583
+ })
584
+ const focus = vi.fn()
585
+ ctx.gridRootEl = { focus }
586
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'discard' }
587
+ const ev = fakeEvent('Escape')
588
+ ed.onEditorKeyDown(ev)
589
+ expect(ctx.internalData[0].a).toBe('old') // unchanged
590
+ expect(ctx.editingCell).toBeNull()
591
+ expect(focus).toHaveBeenCalled()
592
+ })
593
+
594
+ it('stops propagation for other keys without saving or cancelling', () => {
595
+ const { ctx, ed } = editingFor()
596
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'x' }
597
+ const ev = fakeEvent('a')
598
+ ed.onEditorKeyDown(ev)
599
+ expect(ev.stopPropagation).toHaveBeenCalled()
600
+ expect(ev.preventDefault).not.toHaveBeenCalled()
601
+ expect(ctx.editingCell).not.toBeNull()
602
+ })
603
+
604
+ it('tolerates a null gridRootEl on Escape', () => {
605
+ const { ctx, ed } = editingFor()
606
+ ctx.gridRootEl = null
607
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'x' }
608
+ expect(() => ed.onEditorKeyDown(fakeEvent('Escape'))).not.toThrow()
609
+ expect(ctx.editingCell).toBeNull()
610
+ })
611
+
612
+ // #45 in the original report: Tab used to commit and then let the browser
613
+ // walk focus out of the grid, because editors stopPropagation() every key
614
+ // and nothing called preventDefault() for Tab.
615
+ it('Tab saves and advances the active cell one column (#48)', () => {
616
+ const { ctx, ed } = editingFor({
617
+ columns: [
618
+ { id: 'a', field: 'a', editorType: 'text' },
619
+ { id: 'b', field: 'b', editorType: 'text' },
620
+ ],
621
+ data: [{ a: 'old', b: 'b0' }],
622
+ })
623
+ ctx.gridRootEl = { focus: vi.fn() }
624
+ ed.onCellDoubleClick(0, 0)
625
+ ctx.editingCell = { ...ctx.editingCell, value: 'new' }
626
+ const ev = fakeEvent('Tab')
627
+ ed.onEditorKeyDown(ev)
628
+ expect(ev.preventDefault).toHaveBeenCalled()
629
+ expect(ctx.internalData[0].a).toBe('new')
630
+ expect(ctx.activeCalls.at(-1)).toEqual([0, 1])
631
+ })
632
+
633
+ it('Shift+Tab moves back a column and wraps to the previous row (#48)', () => {
634
+ const { ctx, ed } = editingFor({
635
+ columns: [
636
+ { id: 'a', field: 'a', editorType: 'text' },
637
+ { id: 'b', field: 'b', editorType: 'text' },
638
+ ],
639
+ data: [
640
+ { a: 'a0', b: 'b0' },
641
+ { a: 'a1', b: 'b1' },
642
+ ],
643
+ })
644
+ ctx.gridRootEl = { focus: vi.fn() }
645
+ ed.onCellDoubleClick(1, 0)
646
+ const ev = { ...fakeEvent('Tab'), shiftKey: true } as unknown as KeyboardEvent
647
+ ;(ev as any).preventDefault = vi.fn()
648
+ ;(ev as any).stopPropagation = vi.fn()
649
+ ed.onEditorKeyDown(ev)
650
+ // Off the left edge -> last column of the row above.
651
+ expect(ctx.activeCalls.at(-1)).toEqual([0, 1])
652
+ })
653
+ })
654
+
655
+ describe('saveEditingCell when the row leaves the row model (#49)', () => {
656
+ it('writes through the captured row when a filter hides it mid-edit', () => {
657
+ const { ctx, ed } = editingFor({
658
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
659
+ data: [{ a: 'old' }, { a: 'other' }],
660
+ })
661
+ const target = ctx.internalData[0]
662
+ ed.onCellDoubleClick(0, 0)
663
+ ctx.editingCell = { ...ctx.editingCell, value: 'typed' }
664
+ // A filter typed into the filter row drops the edited row from BOTH the
665
+ // page slice and the full filtered model while the editor is still open.
666
+ ctx._rows = ctx._rows.slice(1)
667
+ ctx._rowsBeforePagination = ctx._rows
668
+ ed.saveEditingCell()
669
+ expect(target.a).toBe('typed')
670
+ expect(ctx.editingCell).toBeNull()
671
+ })
672
+
673
+ it('still resolves a row that is only off the current page', () => {
674
+ const { ctx, ed } = editingFor({
675
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
676
+ data: [{ a: 'old' }, { a: 'other' }],
677
+ })
678
+ const target = ctx.internalData[0]
679
+ ed.onCellDoubleClick(0, 0)
680
+ ctx.editingCell = { ...ctx.editingCell, value: 'typed' }
681
+ // Paginated away: gone from `allRows`, still in the full filtered model.
682
+ ctx._rowsBeforePagination = ctx._rows
683
+ ctx._rows = ctx._rows.slice(1)
684
+ ed.saveEditingCell()
685
+ expect(target.a).toBe('typed')
686
+ })
687
+ })
688
+
689
+ describe('focusOnMount', () => {
690
+ let rafCb: FrameRequestCallback | null = null
691
+ beforeEach(() => {
692
+ rafCb = null
693
+ vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => {
694
+ rafCb = cb
695
+ return 1
696
+ })
697
+ })
698
+
699
+ function fakeInput(value: string) {
700
+ return {
701
+ value,
702
+ focus: vi.fn(),
703
+ select: vi.fn(),
704
+ setSelectionRange: vi.fn(),
705
+ }
706
+ }
707
+
708
+ it('selects all when editorSelectAll is set', () => {
709
+ const { ctx, ed } = editingFor()
710
+ ctx.editorSelectAll = true
711
+ const node = fakeInput('hello')
712
+ ed.focusOnMount(node as any)
713
+ rafCb?.(0)
714
+ expect(node.focus).toHaveBeenCalledWith({ preventScroll: true })
715
+ expect(node.select).toHaveBeenCalled()
716
+ expect(node.setSelectionRange).not.toHaveBeenCalled()
717
+ })
718
+
719
+ it('places the caret at the end when not selecting all', () => {
720
+ const { ctx, ed } = editingFor()
721
+ ctx.editorSelectAll = false
722
+ const node = fakeInput('hello')
723
+ ed.focusOnMount(node as any)
724
+ rafCb?.(0)
725
+ expect(node.setSelectionRange).toHaveBeenCalledWith(5, 5)
726
+ expect(node.select).not.toHaveBeenCalled()
727
+ })
728
+
729
+ it('swallows errors from inputs that reject selection ranges', () => {
730
+ const { ctx, ed } = editingFor()
731
+ ctx.editorSelectAll = false
732
+ const node = {
733
+ value: '2020-01-01',
734
+ focus: vi.fn(),
735
+ select: vi.fn(),
736
+ setSelectionRange: () => {
737
+ throw new Error('unsupported')
738
+ },
739
+ }
740
+ ed.focusOnMount(node as any)
741
+ expect(() => rafCb?.(0)).not.toThrow()
742
+ expect(node.focus).toHaveBeenCalled()
743
+ })
744
+ })
745
+
746
+ describe('onCellDoubleClick', () => {
747
+ it('enters edit mode seeded with the current display value', () => {
748
+ const { ctx, ed } = editingFor({
749
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
750
+ data: [{ a: 'val' }],
751
+ })
752
+ ed.onCellDoubleClick(0, 0)
753
+ expect(ctx.editorSelectAll).toBe(true)
754
+ expect(ctx.editingCell).toEqual({
755
+ rowId: '0',
756
+ columnId: 'a',
757
+ editorType: 'text',
758
+ value: 'val',
759
+ rowRef: ctx.internalData[0],
760
+ })
761
+ expect(ctx.activeCalls).toEqual([[0, 0]])
762
+ expect(ctx.selectionCalls).toEqual([[0, 0]])
763
+ })
764
+
765
+ it('prefers an edited override as the seed value', () => {
766
+ const { ctx, ed } = editingFor({
767
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
768
+ data: [{ a: 'base' }],
769
+ })
770
+ ctx.editedCellValues['0:a'] = 'override'
771
+ ed.onCellDoubleClick(0, 0)
772
+ expect(ctx.editingCell.value).toBe('override')
773
+ })
774
+
775
+ it('returns early when editing is disabled', () => {
776
+ const { ctx, ed } = editingFor({ editingEnabled: false })
777
+ ed.onCellDoubleClick(0, 0)
778
+ expect(ctx.editingCell).toBeNull()
779
+ })
780
+
781
+ it('returns early for missing row/column or group rows', () => {
782
+ const { ctx, ed } = editingFor({
783
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
784
+ data: [{ a: 'x' }],
785
+ groupRows: new Set([0]),
786
+ })
787
+ ed.onCellDoubleClick(99, 0)
788
+ ed.onCellDoubleClick(0, 99)
789
+ ed.onCellDoubleClick(0, 0) // group row
790
+ expect(ctx.editingCell).toBeNull()
791
+ })
792
+
793
+ it('returns early for a non-editable cell', () => {
794
+ const { ctx, ed } = editingFor({
795
+ columns: [{ id: 'a', field: 'a', editable: false, editorType: 'text' }],
796
+ data: [{ a: 'x' }],
797
+ })
798
+ ed.onCellDoubleClick(0, 0)
799
+ expect(ctx.editingCell).toBeNull()
800
+ })
801
+
802
+ it('is a no-op when already editing the same cell', () => {
803
+ const { ctx, ed } = editingFor({
804
+ columns: [{ id: 'a', field: 'a', editorType: 'text' }],
805
+ data: [{ a: 'x' }],
806
+ })
807
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'mid-edit' }
808
+ ed.onCellDoubleClick(0, 0)
809
+ expect(ctx.editingCell.value).toBe('mid-edit') // untouched
810
+ expect(ctx.activeCalls).toEqual([]) // setActiveCell not called
811
+ })
812
+
813
+ it('seeds a multi-select list editor with an array', () => {
814
+ const { ctx, ed } = editingFor({
815
+ columns: [
816
+ { id: 'a', field: 'a', editorType: 'list', editorMultiple: true },
817
+ ],
818
+ data: [{ a: 'one' }],
819
+ })
820
+ ed.onCellDoubleClick(0, 0)
821
+ expect(Array.isArray(ctx.editingCell.value)).toBe(true)
822
+ expect(ctx.editingCell.value).toEqual(['one'])
823
+ })
824
+
825
+ it('unwraps an array seed for a single-select list editor', () => {
826
+ const { ctx, ed } = editingFor({
827
+ columns: [{ id: 'a', field: 'a', editorType: 'list' }],
828
+ data: [{ a: ['first', 'second'] }],
829
+ })
830
+ ed.onCellDoubleClick(0, 0)
831
+ expect(ctx.editingCell.value).toBe('first')
832
+ })
833
+
834
+ it('uses empty string for a single-select chips editor seeded from an empty array', () => {
835
+ const { ctx, ed } = editingFor({
836
+ columns: [{ id: 'a', field: 'a', editorType: 'chips' }],
837
+ data: [{ a: [] }],
838
+ })
839
+ ed.onCellDoubleClick(0, 0)
840
+ expect(ctx.editingCell.value).toBe('')
841
+ })
842
+ })
843
+
844
+ describe('clipboard fallbacks (non-paste branches only)', () => {
845
+ // onGridPaste and pasteFromClipboard guard on navigator.clipboard.readText.
846
+ // The actual paste transformation is covered by clipboard.test.ts; here we
847
+ // only assert the early-return guards so we do not duplicate that coverage.
848
+
849
+ it('pasteFromClipboard returns early when the async API is unavailable', async () => {
850
+ Object.defineProperty(navigator, 'clipboard', {
851
+ value: undefined,
852
+ configurable: true,
853
+ })
854
+ const { ctx, ed } = editingFor()
855
+ await ed.pasteFromClipboard()
856
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
857
+ })
858
+
859
+ it('pasteFromClipboard swallows a rejected readText', async () => {
860
+ Object.defineProperty(navigator, 'clipboard', {
861
+ value: { readText: vi.fn().mockRejectedValue(new Error('denied')) },
862
+ configurable: true,
863
+ })
864
+ const { ctx, ed } = editingFor()
865
+ await expect(ed.pasteFromClipboard()).resolves.toBeUndefined()
866
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
867
+ })
868
+
869
+ it('onGridPaste ignores the native event when the async API is present', () => {
870
+ Object.defineProperty(navigator, 'clipboard', {
871
+ value: { readText: vi.fn() },
872
+ configurable: true,
873
+ })
874
+ const { ctx, ed } = editingFor()
875
+ const ev = {
876
+ clipboardData: { getData: () => 'a\tb' },
877
+ preventDefault: vi.fn(),
878
+ } as unknown as ClipboardEvent
879
+ ed.onGridPaste(ev)
880
+ expect(ev.preventDefault).not.toHaveBeenCalled()
881
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
882
+ })
883
+
884
+ it('onGridPaste returns early on empty clipboard text in the fallback path', () => {
885
+ Object.defineProperty(navigator, 'clipboard', {
886
+ value: undefined,
887
+ configurable: true,
888
+ })
889
+ const { ctx, ed } = editingFor()
890
+ const ev = {
891
+ clipboardData: { getData: () => '' },
892
+ preventDefault: vi.fn(),
893
+ } as unknown as ClipboardEvent
894
+ ed.onGridPaste(ev)
895
+ expect(ev.preventDefault).not.toHaveBeenCalled()
896
+ expect(ctx.grid.store.setState).not.toHaveBeenCalled()
897
+ })
898
+
899
+ it('onGridPaste applies pasted text via the fallback path', () => {
900
+ Object.defineProperty(navigator, 'clipboard', {
901
+ value: undefined,
902
+ configurable: true,
903
+ })
904
+ const { ctx, ed } = editingFor({
905
+ columns: [
906
+ { id: 'a', field: 'a', editorType: 'text', editable: true },
907
+ { id: 'b', field: 'b', editorType: 'text', editable: true },
908
+ ],
909
+ data: [
910
+ { a: '', b: '' },
911
+ { a: '', b: '' },
912
+ ],
913
+ })
914
+ ctx.selectionRange = {
915
+ anchor: { rowIndex: 0, colIndex: 0 },
916
+ focus: { rowIndex: 0, colIndex: 0 },
917
+ }
918
+ const ev = {
919
+ clipboardData: { getData: () => 'X\tY\nZ\tW' },
920
+ preventDefault: vi.fn(),
921
+ } as unknown as ClipboardEvent
922
+ ed.onGridPaste(ev)
923
+ expect(ev.preventDefault).toHaveBeenCalled()
924
+ expect(ctx.internalData[0]).toMatchObject({ a: 'X', b: 'Y' })
925
+ expect(ctx.internalData[1]).toMatchObject({ a: 'Z', b: 'W' })
926
+ })
927
+
928
+ it('onGridPaste bails while a cell is being edited (native editor paste wins)', () => {
929
+ Object.defineProperty(navigator, 'clipboard', {
930
+ value: undefined, // fallback path (Firefox / insecure) - would otherwise hijack
931
+ configurable: true,
932
+ })
933
+ const { ctx, ed } = editingFor({
934
+ columns: [{ id: 'a', field: 'a', editorType: 'text', editable: true }],
935
+ data: [{ a: 'orig' }],
936
+ })
937
+ ctx.selectionRange = { anchor: { rowIndex: 0, colIndex: 0 }, focus: { rowIndex: 0, colIndex: 0 } }
938
+ ctx.editingCell = { rowId: '0', columnId: 'a', editorType: 'text', value: 'orig' }
939
+ const ev = {
940
+ clipboardData: { getData: () => 'PASTED' },
941
+ preventDefault: vi.fn(),
942
+ } as unknown as ClipboardEvent
943
+ ed.onGridPaste(ev)
944
+ // The grid must NOT preventDefault (so the editor's native paste proceeds)
945
+ // and must NOT write to the data cell.
946
+ expect(ev.preventDefault).not.toHaveBeenCalled()
947
+ expect(ctx.internalData[0]).toMatchObject({ a: 'orig' })
948
+ })
949
+ })