@daisforge/glide-data-grid 0.0.0-stage → 6.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (871) hide show
  1. package/.eslintignore +4 -0
  2. package/.eslintrc +68 -0
  3. package/API.md +1490 -0
  4. package/CHANGELOG.md +895 -0
  5. package/LICENSE +21 -0
  6. package/README.md +189 -2
  7. package/build.sh +23 -0
  8. package/dist/cjs/cells/boolean-cell.js +87 -0
  9. package/dist/cjs/cells/boolean-cell.js.map +1 -0
  10. package/dist/cjs/cells/bubble-cell.js +53 -0
  11. package/dist/cjs/cells/bubble-cell.js.map +1 -0
  12. package/dist/cjs/cells/cell-types.js +2 -0
  13. package/dist/cjs/cells/cell-types.js.map +1 -0
  14. package/dist/cjs/cells/drilldown-cell.js +171 -0
  15. package/dist/cjs/cells/drilldown-cell.js.map +1 -0
  16. package/dist/cjs/cells/image-cell.js +94 -0
  17. package/dist/cjs/cells/image-cell.js.map +1 -0
  18. package/dist/cjs/cells/index.js +29 -0
  19. package/dist/cjs/cells/index.js.map +1 -0
  20. package/dist/cjs/cells/loading-cell.js +41 -0
  21. package/dist/cjs/cells/loading-cell.js.map +1 -0
  22. package/dist/cjs/cells/markdown-cell.js +30 -0
  23. package/dist/cjs/cells/markdown-cell.js.map +1 -0
  24. package/dist/cjs/cells/marker-cell.js +80 -0
  25. package/dist/cjs/cells/marker-cell.js.map +1 -0
  26. package/dist/cjs/cells/new-row-cell.js +53 -0
  27. package/dist/cjs/cells/new-row-cell.js.map +1 -0
  28. package/dist/cjs/cells/number-cell.js +44 -0
  29. package/dist/cjs/cells/number-cell.js.map +1 -0
  30. package/dist/cjs/cells/protected-cell.js +35 -0
  31. package/dist/cjs/cells/protected-cell.js.map +1 -0
  32. package/dist/cjs/cells/row-id-cell.js +23 -0
  33. package/dist/cjs/cells/row-id-cell.js.map +1 -0
  34. package/dist/cjs/cells/text-cell.js +48 -0
  35. package/dist/cjs/cells/text-cell.js.map +1 -0
  36. package/dist/cjs/cells/uri-cell.js +104 -0
  37. package/dist/cjs/cells/uri-cell.js.map +1 -0
  38. package/dist/cjs/common/browser-detect.js +20 -0
  39. package/dist/cjs/common/browser-detect.js.map +1 -0
  40. package/dist/cjs/common/image-window-loader.js +98 -0
  41. package/dist/cjs/common/image-window-loader.js.map +1 -0
  42. package/dist/cjs/common/is-hotkey.js +76 -0
  43. package/dist/cjs/common/is-hotkey.js.map +1 -0
  44. package/dist/cjs/common/math.js +297 -0
  45. package/dist/cjs/common/math.js.map +1 -0
  46. package/dist/cjs/common/render-state-provider.js +74 -0
  47. package/dist/cjs/common/render-state-provider.js.map +1 -0
  48. package/dist/cjs/common/resize-detector.js +27 -0
  49. package/dist/cjs/common/resize-detector.js.map +1 -0
  50. package/dist/cjs/common/styles.js +135 -0
  51. package/dist/cjs/common/styles.js.map +1 -0
  52. package/dist/cjs/common/support.js +60 -0
  53. package/dist/cjs/common/support.js.map +1 -0
  54. package/dist/cjs/common/utils.js +193 -0
  55. package/dist/cjs/common/utils.js.map +1 -0
  56. package/dist/cjs/data-editor/copy-paste.js +279 -0
  57. package/dist/cjs/data-editor/copy-paste.js.map +1 -0
  58. package/dist/cjs/data-editor/data-editor-fns.js +203 -0
  59. package/dist/cjs/data-editor/data-editor-fns.js.map +1 -0
  60. package/dist/cjs/data-editor/data-editor-keybindings.js +126 -0
  61. package/dist/cjs/data-editor/data-editor-keybindings.js.map +1 -0
  62. package/dist/cjs/data-editor/data-editor.js +3283 -0
  63. package/dist/cjs/data-editor/data-editor.js.map +1 -0
  64. package/dist/cjs/data-editor/group-rename.css +2 -0
  65. package/dist/cjs/data-editor/group-rename.js +49 -0
  66. package/dist/cjs/data-editor/group-rename.js.map +1 -0
  67. package/dist/cjs/data-editor/row-grouping-api.js +34 -0
  68. package/dist/cjs/data-editor/row-grouping-api.js.map +1 -0
  69. package/dist/cjs/data-editor/row-grouping.js +189 -0
  70. package/dist/cjs/data-editor/row-grouping.js.map +1 -0
  71. package/dist/cjs/data-editor/use-autoscroll.js +36 -0
  72. package/dist/cjs/data-editor/use-autoscroll.js.map +1 -0
  73. package/dist/cjs/data-editor/use-cells-for-selection.js +53 -0
  74. package/dist/cjs/data-editor/use-cells-for-selection.js.map +1 -0
  75. package/dist/cjs/data-editor/use-column-sizer.js +319 -0
  76. package/dist/cjs/data-editor/use-column-sizer.js.map +1 -0
  77. package/dist/cjs/data-editor/use-initial-scroll-offset.js +81 -0
  78. package/dist/cjs/data-editor/use-initial-scroll-offset.js.map +1 -0
  79. package/dist/cjs/data-editor/use-rem-adjuster.js +29 -0
  80. package/dist/cjs/data-editor/use-rem-adjuster.js.map +1 -0
  81. package/dist/cjs/data-editor/visible-region.js +2 -0
  82. package/dist/cjs/data-editor/visible-region.js.map +1 -0
  83. package/dist/cjs/data-editor-all.js +19 -0
  84. package/dist/cjs/data-editor-all.js.map +1 -0
  85. package/dist/cjs/index.js +36 -0
  86. package/dist/cjs/index.js.map +1 -0
  87. package/dist/cjs/internal/click-outside-container/click-outside-container.js +34 -0
  88. package/dist/cjs/internal/click-outside-container/click-outside-container.js.map +1 -0
  89. package/dist/cjs/internal/data-editor-container/data-grid-container.css +1 -0
  90. package/dist/cjs/internal/data-editor-container/data-grid-container.js +31 -0
  91. package/dist/cjs/internal/data-editor-container/data-grid-container.js.map +1 -0
  92. package/dist/cjs/internal/data-grid/animation-manager.js +95 -0
  93. package/dist/cjs/internal/data-grid/animation-manager.js.map +1 -0
  94. package/dist/cjs/internal/data-grid/cell-set.js +56 -0
  95. package/dist/cjs/internal/data-grid/cell-set.js.map +1 -0
  96. package/dist/cjs/internal/data-grid/color-parser.js +122 -0
  97. package/dist/cjs/internal/data-grid/color-parser.js.map +1 -0
  98. package/dist/cjs/internal/data-grid/column-resize.js +16 -0
  99. package/dist/cjs/internal/data-grid/column-resize.js.map +1 -0
  100. package/dist/cjs/internal/data-grid/data-grid-sprites.js +64 -0
  101. package/dist/cjs/internal/data-grid/data-grid-sprites.js.map +1 -0
  102. package/dist/cjs/internal/data-grid/data-grid-types.js +299 -0
  103. package/dist/cjs/internal/data-grid/data-grid-types.js.map +1 -0
  104. package/dist/cjs/internal/data-grid/data-grid.js +1514 -0
  105. package/dist/cjs/internal/data-grid/data-grid.js.map +1 -0
  106. package/dist/cjs/internal/data-grid/event-args.js +57 -0
  107. package/dist/cjs/internal/data-grid/event-args.js.map +1 -0
  108. package/dist/cjs/internal/data-grid/hidden-columns-indicator.js +47 -0
  109. package/dist/cjs/internal/data-grid/hidden-columns-indicator.js.map +1 -0
  110. package/dist/cjs/internal/data-grid/image-window-loader-interface.js +2 -0
  111. package/dist/cjs/internal/data-grid/image-window-loader-interface.js.map +1 -0
  112. package/dist/cjs/internal/data-grid/render/data-grid-freeze.js +227 -0
  113. package/dist/cjs/internal/data-grid/render/data-grid-freeze.js.map +1 -0
  114. package/dist/cjs/internal/data-grid/render/data-grid-lib.js +887 -0
  115. package/dist/cjs/internal/data-grid/render/data-grid-lib.js.map +1 -0
  116. package/dist/cjs/internal/data-grid/render/data-grid-render.blit.js +304 -0
  117. package/dist/cjs/internal/data-grid/render/data-grid-render.blit.js.map +1 -0
  118. package/dist/cjs/internal/data-grid/render/data-grid-render.cells.js +738 -0
  119. package/dist/cjs/internal/data-grid/render/data-grid-render.cells.js.map +1 -0
  120. package/dist/cjs/internal/data-grid/render/data-grid-render.hairline.js +15 -0
  121. package/dist/cjs/internal/data-grid/render/data-grid-render.hairline.js.map +1 -0
  122. package/dist/cjs/internal/data-grid/render/data-grid-render.header.js +767 -0
  123. package/dist/cjs/internal/data-grid/render/data-grid-render.header.js.map +1 -0
  124. package/dist/cjs/internal/data-grid/render/data-grid-render.js +867 -0
  125. package/dist/cjs/internal/data-grid/render/data-grid-render.js.map +1 -0
  126. package/dist/cjs/internal/data-grid/render/data-grid-render.lines.js +444 -0
  127. package/dist/cjs/internal/data-grid/render/data-grid-render.lines.js.map +1 -0
  128. package/dist/cjs/internal/data-grid/render/data-grid-render.selection-regions.js +321 -0
  129. package/dist/cjs/internal/data-grid/render/data-grid-render.selection-regions.js.map +1 -0
  130. package/dist/cjs/internal/data-grid/render/data-grid-render.walk.js +293 -0
  131. package/dist/cjs/internal/data-grid/render/data-grid-render.walk.js.map +1 -0
  132. package/dist/cjs/internal/data-grid/render/data-grid.render.rings.js +296 -0
  133. package/dist/cjs/internal/data-grid/render/data-grid.render.rings.js.map +1 -0
  134. package/dist/cjs/internal/data-grid/render/draw-checkbox.js +65 -0
  135. package/dist/cjs/internal/data-grid/render/draw-checkbox.js.map +1 -0
  136. package/dist/cjs/internal/data-grid/render/draw-edit-hover-indicator.js +38 -0
  137. package/dist/cjs/internal/data-grid/render/draw-edit-hover-indicator.js.map +1 -0
  138. package/dist/cjs/internal/data-grid/render/draw-grid-arg.js +2 -0
  139. package/dist/cjs/internal/data-grid/render/draw-grid-arg.js.map +1 -0
  140. package/dist/cjs/internal/data-grid/sprites.js +288 -0
  141. package/dist/cjs/internal/data-grid/sprites.js.map +1 -0
  142. package/dist/cjs/internal/data-grid/use-animation-queue.js +33 -0
  143. package/dist/cjs/internal/data-grid/use-animation-queue.js.map +1 -0
  144. package/dist/cjs/internal/data-grid/use-selection-behavior.js +112 -0
  145. package/dist/cjs/internal/data-grid/use-selection-behavior.js.map +1 -0
  146. package/dist/cjs/internal/data-grid-dnd/data-grid-dnd.js +249 -0
  147. package/dist/cjs/internal/data-grid-dnd/data-grid-dnd.js.map +1 -0
  148. package/dist/cjs/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.css +1 -0
  149. package/dist/cjs/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.js +21 -0
  150. package/dist/cjs/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.js.map +1 -0
  151. package/dist/cjs/internal/data-grid-overlay-editor/data-grid-overlay-editor.js +124 -0
  152. package/dist/cjs/internal/data-grid-overlay-editor/data-grid-overlay-editor.js.map +1 -0
  153. package/dist/cjs/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.css +1 -0
  154. package/dist/cjs/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.js +7 -0
  155. package/dist/cjs/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.js.map +1 -0
  156. package/dist/cjs/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.js +10 -0
  157. package/dist/cjs/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.js.map +1 -0
  158. package/dist/cjs/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.css +1 -0
  159. package/dist/cjs/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.js +20 -0
  160. package/dist/cjs/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.js.map +1 -0
  161. package/dist/cjs/internal/data-grid-overlay-editor/private/image-overlay-editor-style.css +1 -0
  162. package/dist/cjs/internal/data-grid-overlay-editor/private/image-overlay-editor-style.js +7 -0
  163. package/dist/cjs/internal/data-grid-overlay-editor/private/image-overlay-editor-style.js.map +1 -0
  164. package/dist/cjs/internal/data-grid-overlay-editor/private/image-overlay-editor.js +21 -0
  165. package/dist/cjs/internal/data-grid-overlay-editor/private/image-overlay-editor.js.map +1 -0
  166. package/dist/cjs/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.css +1 -0
  167. package/dist/cjs/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.js +11 -0
  168. package/dist/cjs/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.js.map +1 -0
  169. package/dist/cjs/internal/data-grid-overlay-editor/private/markdown-overlay-editor.js +32 -0
  170. package/dist/cjs/internal/data-grid-overlay-editor/private/markdown-overlay-editor.js.map +1 -0
  171. package/dist/cjs/internal/data-grid-overlay-editor/private/number-overlay-editor-style.css +1 -0
  172. package/dist/cjs/internal/data-grid-overlay-editor/private/number-overlay-editor-style.js +7 -0
  173. package/dist/cjs/internal/data-grid-overlay-editor/private/number-overlay-editor-style.js.map +1 -0
  174. package/dist/cjs/internal/data-grid-overlay-editor/private/number-overlay-editor.js +30 -0
  175. package/dist/cjs/internal/data-grid-overlay-editor/private/number-overlay-editor.js.map +1 -0
  176. package/dist/cjs/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.css +1 -0
  177. package/dist/cjs/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.js +7 -0
  178. package/dist/cjs/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.js.map +1 -0
  179. package/dist/cjs/internal/data-grid-overlay-editor/private/uri-overlay-editor.js +21 -0
  180. package/dist/cjs/internal/data-grid-overlay-editor/private/uri-overlay-editor.js.map +1 -0
  181. package/dist/cjs/internal/data-grid-overlay-editor/use-stay-on-screen.js +47 -0
  182. package/dist/cjs/internal/data-grid-overlay-editor/use-stay-on-screen.js.map +1 -0
  183. package/dist/cjs/internal/data-grid-search/data-grid-search-style.css +1 -0
  184. package/dist/cjs/internal/data-grid-search/data-grid-search-style.js +7 -0
  185. package/dist/cjs/internal/data-grid-search/data-grid-search-style.js.map +1 -0
  186. package/dist/cjs/internal/data-grid-search/data-grid-search.js +297 -0
  187. package/dist/cjs/internal/data-grid-search/data-grid-search.js.map +1 -0
  188. package/dist/cjs/internal/growing-entry/growing-entry-style.css +3 -0
  189. package/dist/cjs/internal/growing-entry/growing-entry-style.js +17 -0
  190. package/dist/cjs/internal/growing-entry/growing-entry-style.js.map +1 -0
  191. package/dist/cjs/internal/growing-entry/growing-entry.js +41 -0
  192. package/dist/cjs/internal/growing-entry/growing-entry.js.map +1 -0
  193. package/dist/cjs/internal/markdown-div/markdown-div.js +41 -0
  194. package/dist/cjs/internal/markdown-div/markdown-div.js.map +1 -0
  195. package/dist/cjs/internal/markdown-div/private/markdown-container.css +1 -0
  196. package/dist/cjs/internal/markdown-div/private/markdown-container.js +7 -0
  197. package/dist/cjs/internal/markdown-div/private/markdown-container.js.map +1 -0
  198. package/dist/cjs/internal/scrolling-data-grid/infinite-scroller.css +1 -0
  199. package/dist/cjs/internal/scrolling-data-grid/infinite-scroller.js +267 -0
  200. package/dist/cjs/internal/scrolling-data-grid/infinite-scroller.js.map +1 -0
  201. package/dist/cjs/internal/scrolling-data-grid/row-offsets.js +88 -0
  202. package/dist/cjs/internal/scrolling-data-grid/row-offsets.js.map +1 -0
  203. package/dist/cjs/internal/scrolling-data-grid/scrolling-data-grid.js +125 -0
  204. package/dist/cjs/internal/scrolling-data-grid/scrolling-data-grid.js.map +1 -0
  205. package/dist/cjs/internal/scrolling-data-grid/use-kinetic-scroll.js +65 -0
  206. package/dist/cjs/internal/scrolling-data-grid/use-kinetic-scroll.js.map +1 -0
  207. package/dist/cjs/internal/scrolling-data-grid/use-row-offsets.js +36 -0
  208. package/dist/cjs/internal/scrolling-data-grid/use-row-offsets.js.map +1 -0
  209. package/dist/dts/cells/boolean-cell.d.ts +3 -0
  210. package/dist/dts/cells/boolean-cell.d.ts.map +1 -0
  211. package/dist/dts/cells/bubble-cell.d.ts +3 -0
  212. package/dist/dts/cells/bubble-cell.d.ts.map +1 -0
  213. package/dist/dts/cells/cell-types.d.ts +88 -0
  214. package/dist/dts/cells/cell-types.d.ts.map +1 -0
  215. package/dist/dts/cells/drilldown-cell.d.ts +3 -0
  216. package/dist/dts/cells/drilldown-cell.d.ts.map +1 -0
  217. package/dist/dts/cells/image-cell.d.ts +4 -0
  218. package/dist/dts/cells/image-cell.d.ts.map +1 -0
  219. package/dist/dts/cells/index.d.ts +3 -0
  220. package/dist/dts/cells/index.d.ts.map +1 -0
  221. package/dist/dts/cells/loading-cell.d.ts +3 -0
  222. package/dist/dts/cells/loading-cell.d.ts.map +1 -0
  223. package/dist/dts/cells/markdown-cell.d.ts +3 -0
  224. package/dist/dts/cells/markdown-cell.d.ts.map +1 -0
  225. package/dist/dts/cells/marker-cell.d.ts +3 -0
  226. package/dist/dts/cells/marker-cell.d.ts.map +1 -0
  227. package/dist/dts/cells/new-row-cell.d.ts +3 -0
  228. package/dist/dts/cells/new-row-cell.d.ts.map +1 -0
  229. package/dist/dts/cells/number-cell.d.ts +3 -0
  230. package/dist/dts/cells/number-cell.d.ts.map +1 -0
  231. package/dist/dts/cells/protected-cell.d.ts +3 -0
  232. package/dist/dts/cells/protected-cell.d.ts.map +1 -0
  233. package/dist/dts/cells/row-id-cell.d.ts +3 -0
  234. package/dist/dts/cells/row-id-cell.d.ts.map +1 -0
  235. package/dist/dts/cells/text-cell.d.ts +3 -0
  236. package/dist/dts/cells/text-cell.d.ts.map +1 -0
  237. package/dist/dts/cells/uri-cell.d.ts +3 -0
  238. package/dist/dts/cells/uri-cell.d.ts.map +1 -0
  239. package/dist/dts/common/browser-detect.d.ts +10 -0
  240. package/dist/dts/common/browser-detect.d.ts.map +1 -0
  241. package/dist/dts/common/image-window-loader.d.ts +14 -0
  242. package/dist/dts/common/image-window-loader.d.ts.map +1 -0
  243. package/dist/dts/common/is-hotkey.d.ts +6 -0
  244. package/dist/dts/common/is-hotkey.d.ts.map +1 -0
  245. package/dist/dts/common/math.d.ts +19 -0
  246. package/dist/dts/common/math.d.ts.map +1 -0
  247. package/dist/dts/common/render-state-provider.d.ts +21 -0
  248. package/dist/dts/common/render-state-provider.d.ts.map +1 -0
  249. package/dist/dts/common/resize-detector.d.ts +10 -0
  250. package/dist/dts/common/resize-detector.d.ts.map +1 -0
  251. package/dist/dts/common/styles.d.ts +61 -0
  252. package/dist/dts/common/styles.d.ts.map +1 -0
  253. package/dist/dts/common/support.d.ts +12 -0
  254. package/dist/dts/common/support.d.ts.map +1 -0
  255. package/dist/dts/common/utils.d.ts +37 -0
  256. package/dist/dts/common/utils.d.ts.map +1 -0
  257. package/dist/dts/data-editor/copy-paste.d.ts +21 -0
  258. package/dist/dts/data-editor/copy-paste.d.ts.map +1 -0
  259. package/dist/dts/data-editor/data-editor-fns.d.ts +21 -0
  260. package/dist/dts/data-editor/data-editor-fns.d.ts.map +1 -0
  261. package/dist/dts/data-editor/data-editor-keybindings.d.ts +61 -0
  262. package/dist/dts/data-editor/data-editor-keybindings.d.ts.map +1 -0
  263. package/dist/dts/data-editor/data-editor.d.ts +604 -0
  264. package/dist/dts/data-editor/data-editor.d.ts.map +1 -0
  265. package/dist/dts/data-editor/group-rename.d.ts +11 -0
  266. package/dist/dts/data-editor/group-rename.d.ts.map +1 -0
  267. package/dist/dts/data-editor/row-grouping-api.d.ts +20 -0
  268. package/dist/dts/data-editor/row-grouping-api.d.ts.map +1 -0
  269. package/dist/dts/data-editor/row-grouping.d.ts +81 -0
  270. package/dist/dts/data-editor/row-grouping.d.ts.map +1 -0
  271. package/dist/dts/data-editor/use-autoscroll.d.ts +3 -0
  272. package/dist/dts/data-editor/use-autoscroll.d.ts.map +1 -0
  273. package/dist/dts/data-editor/use-cells-for-selection.d.ts +6 -0
  274. package/dist/dts/data-editor/use-cells-for-selection.d.ts.map +1 -0
  275. package/dist/dts/data-editor/use-column-sizer.d.ts +10 -0
  276. package/dist/dts/data-editor/use-column-sizer.d.ts.map +1 -0
  277. package/dist/dts/data-editor/use-initial-scroll-offset.d.ts +8 -0
  278. package/dist/dts/data-editor/use-initial-scroll-offset.d.ts.map +1 -0
  279. package/dist/dts/data-editor/use-rem-adjuster.d.ts +21 -0
  280. package/dist/dts/data-editor/use-rem-adjuster.d.ts.map +1 -0
  281. package/dist/dts/data-editor/visible-region.d.ts +18 -0
  282. package/dist/dts/data-editor/visible-region.d.ts.map +1 -0
  283. package/dist/dts/data-editor-all.d.ts +7 -0
  284. package/dist/dts/data-editor-all.d.ts.map +1 -0
  285. package/dist/dts/index.d.ts +52 -0
  286. package/dist/dts/index.d.ts.map +1 -0
  287. package/dist/dts/internal/click-outside-container/click-outside-container.d.ts +14 -0
  288. package/dist/dts/internal/click-outside-container/click-outside-container.d.ts.map +1 -0
  289. package/dist/dts/internal/data-editor-container/data-grid-container.d.ts +9 -0
  290. package/dist/dts/internal/data-editor-container/data-grid-container.d.ts.map +1 -0
  291. package/dist/dts/internal/data-grid/animation-manager.d.ts +25 -0
  292. package/dist/dts/internal/data-grid/animation-manager.d.ts.map +1 -0
  293. package/dist/dts/internal/data-grid/cell-set.d.ts +16 -0
  294. package/dist/dts/internal/data-grid/cell-set.d.ts.map +1 -0
  295. package/dist/dts/internal/data-grid/color-parser.d.ts +15 -0
  296. package/dist/dts/internal/data-grid/color-parser.d.ts.map +1 -0
  297. package/dist/dts/internal/data-grid/column-resize.d.ts +3 -0
  298. package/dist/dts/internal/data-grid/column-resize.d.ts.map +1 -0
  299. package/dist/dts/internal/data-grid/data-grid-sprites.d.ts +34 -0
  300. package/dist/dts/internal/data-grid/data-grid-sprites.d.ts.map +1 -0
  301. package/dist/dts/internal/data-grid/data-grid-types.d.ts +545 -0
  302. package/dist/dts/internal/data-grid/data-grid-types.d.ts.map +1 -0
  303. package/dist/dts/internal/data-grid/data-grid.d.ts +310 -0
  304. package/dist/dts/internal/data-grid/data-grid.d.ts.map +1 -0
  305. package/dist/dts/internal/data-grid/event-args.d.ts +139 -0
  306. package/dist/dts/internal/data-grid/event-args.d.ts.map +1 -0
  307. package/dist/dts/internal/data-grid/hidden-columns-indicator.d.ts +48 -0
  308. package/dist/dts/internal/data-grid/hidden-columns-indicator.d.ts.map +1 -0
  309. package/dist/dts/internal/data-grid/image-window-loader-interface.d.ts +12 -0
  310. package/dist/dts/internal/data-grid/image-window-loader-interface.d.ts.map +1 -0
  311. package/dist/dts/internal/data-grid/render/data-grid-freeze.d.ts +72 -0
  312. package/dist/dts/internal/data-grid/render/data-grid-freeze.d.ts.map +1 -0
  313. package/dist/dts/internal/data-grid/render/data-grid-lib.d.ts +138 -0
  314. package/dist/dts/internal/data-grid/render/data-grid-lib.d.ts.map +1 -0
  315. package/dist/dts/internal/data-grid/render/data-grid-render.blit.d.ts +65 -0
  316. package/dist/dts/internal/data-grid/render/data-grid-render.blit.d.ts.map +1 -0
  317. package/dist/dts/internal/data-grid/render/data-grid-render.cells.d.ts +148 -0
  318. package/dist/dts/internal/data-grid/render/data-grid-render.cells.d.ts.map +1 -0
  319. package/dist/dts/internal/data-grid/render/data-grid-render.d.ts +21 -0
  320. package/dist/dts/internal/data-grid/render/data-grid-render.d.ts.map +1 -0
  321. package/dist/dts/internal/data-grid/render/data-grid-render.hairline.d.ts +5 -0
  322. package/dist/dts/internal/data-grid/render/data-grid-render.hairline.d.ts.map +1 -0
  323. package/dist/dts/internal/data-grid/render/data-grid-render.header.d.ts +47 -0
  324. package/dist/dts/internal/data-grid/render/data-grid-render.header.d.ts.map +1 -0
  325. package/dist/dts/internal/data-grid/render/data-grid-render.lines.d.ts +11 -0
  326. package/dist/dts/internal/data-grid/render/data-grid-render.lines.d.ts.map +1 -0
  327. package/dist/dts/internal/data-grid/render/data-grid-render.selection-regions.d.ts +62 -0
  328. package/dist/dts/internal/data-grid/render/data-grid-render.selection-regions.d.ts.map +1 -0
  329. package/dist/dts/internal/data-grid/render/data-grid-render.walk.d.ts +62 -0
  330. package/dist/dts/internal/data-grid/render/data-grid-render.walk.d.ts.map +1 -0
  331. package/dist/dts/internal/data-grid/render/data-grid.render.rings.d.ts +16 -0
  332. package/dist/dts/internal/data-grid/render/data-grid.render.rings.d.ts.map +1 -0
  333. package/dist/dts/internal/data-grid/render/draw-checkbox.d.ts +3 -0
  334. package/dist/dts/internal/data-grid/render/draw-checkbox.d.ts.map +1 -0
  335. package/dist/dts/internal/data-grid/render/draw-edit-hover-indicator.d.ts +3 -0
  336. package/dist/dts/internal/data-grid/render/draw-edit-hover-indicator.d.ts.map +1 -0
  337. package/dist/dts/internal/data-grid/render/draw-grid-arg.d.ts +89 -0
  338. package/dist/dts/internal/data-grid/render/draw-grid-arg.d.ts.map +1 -0
  339. package/dist/dts/internal/data-grid/sprites.d.ts +33 -0
  340. package/dist/dts/internal/data-grid/sprites.d.ts.map +1 -0
  341. package/dist/dts/internal/data-grid/use-animation-queue.d.ts +4 -0
  342. package/dist/dts/internal/data-grid/use-animation-queue.d.ts.map +1 -0
  343. package/dist/dts/internal/data-grid/use-selection-behavior.d.ts +12 -0
  344. package/dist/dts/internal/data-grid/use-selection-behavior.d.ts.map +1 -0
  345. package/dist/dts/internal/data-grid-dnd/data-grid-dnd.d.ts +62 -0
  346. package/dist/dts/internal/data-grid-dnd/data-grid-dnd.d.ts.map +1 -0
  347. package/dist/dts/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.d.ts +8 -0
  348. package/dist/dts/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.d.ts.map +1 -0
  349. package/dist/dts/internal/data-grid-overlay-editor/data-grid-overlay-editor.d.ts +31 -0
  350. package/dist/dts/internal/data-grid-overlay-editor/data-grid-overlay-editor.d.ts.map +1 -0
  351. package/dist/dts/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.d.ts +1 -0
  352. package/dist/dts/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.d.ts.map +1 -0
  353. package/dist/dts/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.d.ts +6 -0
  354. package/dist/dts/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.d.ts.map +1 -0
  355. package/dist/dts/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.d.ts +7 -0
  356. package/dist/dts/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.d.ts.map +1 -0
  357. package/dist/dts/internal/data-grid-overlay-editor/private/image-overlay-editor-style.d.ts +1 -0
  358. package/dist/dts/internal/data-grid-overlay-editor/private/image-overlay-editor-style.d.ts.map +1 -0
  359. package/dist/dts/internal/data-grid-overlay-editor/private/image-overlay-editor.d.ts +12 -0
  360. package/dist/dts/internal/data-grid-overlay-editor/private/image-overlay-editor.d.ts.map +1 -0
  361. package/dist/dts/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.d.ts +5 -0
  362. package/dist/dts/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.d.ts.map +1 -0
  363. package/dist/dts/internal/data-grid-overlay-editor/private/markdown-overlay-editor.d.ts +13 -0
  364. package/dist/dts/internal/data-grid-overlay-editor/private/markdown-overlay-editor.d.ts.map +1 -0
  365. package/dist/dts/internal/data-grid-overlay-editor/private/number-overlay-editor-style.d.ts +1 -0
  366. package/dist/dts/internal/data-grid-overlay-editor/private/number-overlay-editor-style.d.ts.map +1 -0
  367. package/dist/dts/internal/data-grid-overlay-editor/private/number-overlay-editor.d.ts +16 -0
  368. package/dist/dts/internal/data-grid-overlay-editor/private/number-overlay-editor.d.ts.map +1 -0
  369. package/dist/dts/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.d.ts +1 -0
  370. package/dist/dts/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.d.ts.map +1 -0
  371. package/dist/dts/internal/data-grid-overlay-editor/private/uri-overlay-editor.d.ts +12 -0
  372. package/dist/dts/internal/data-grid-overlay-editor/private/uri-overlay-editor.d.ts.map +1 -0
  373. package/dist/dts/internal/data-grid-overlay-editor/use-stay-on-screen.d.ts +7 -0
  374. package/dist/dts/internal/data-grid-overlay-editor/use-stay-on-screen.d.ts.map +1 -0
  375. package/dist/dts/internal/data-grid-search/data-grid-search-style.d.ts +1 -0
  376. package/dist/dts/internal/data-grid-search/data-grid-search-style.d.ts.map +1 -0
  377. package/dist/dts/internal/data-grid-search/data-grid-search.d.ts +40 -0
  378. package/dist/dts/internal/data-grid-search/data-grid-search.d.ts.map +1 -0
  379. package/dist/dts/internal/growing-entry/growing-entry-style.d.ts +3 -0
  380. package/dist/dts/internal/growing-entry/growing-entry-style.d.ts.map +1 -0
  381. package/dist/dts/internal/growing-entry/growing-entry.d.ts +11 -0
  382. package/dist/dts/internal/growing-entry/growing-entry.d.ts.map +1 -0
  383. package/dist/dts/internal/markdown-div/markdown-div.d.ts +13 -0
  384. package/dist/dts/internal/markdown-div/markdown-div.d.ts.map +1 -0
  385. package/dist/dts/internal/markdown-div/private/markdown-container.d.ts +1 -0
  386. package/dist/dts/internal/markdown-div/private/markdown-container.d.ts.map +1 -0
  387. package/dist/dts/internal/scrolling-data-grid/infinite-scroller.d.ts +37 -0
  388. package/dist/dts/internal/scrolling-data-grid/infinite-scroller.d.ts.map +1 -0
  389. package/dist/dts/internal/scrolling-data-grid/row-offsets.d.ts +51 -0
  390. package/dist/dts/internal/scrolling-data-grid/row-offsets.d.ts.map +1 -0
  391. package/dist/dts/internal/scrolling-data-grid/scrolling-data-grid.d.ts +56 -0
  392. package/dist/dts/internal/scrolling-data-grid/scrolling-data-grid.d.ts.map +1 -0
  393. package/dist/dts/internal/scrolling-data-grid/use-kinetic-scroll.d.ts +2 -0
  394. package/dist/dts/internal/scrolling-data-grid/use-kinetic-scroll.d.ts.map +1 -0
  395. package/dist/dts/internal/scrolling-data-grid/use-row-offsets.d.ts +11 -0
  396. package/dist/dts/internal/scrolling-data-grid/use-row-offsets.d.ts.map +1 -0
  397. package/dist/esm/cells/boolean-cell.js +87 -0
  398. package/dist/esm/cells/boolean-cell.js.map +1 -0
  399. package/dist/esm/cells/bubble-cell.js +53 -0
  400. package/dist/esm/cells/bubble-cell.js.map +1 -0
  401. package/dist/esm/cells/cell-types.js +2 -0
  402. package/dist/esm/cells/cell-types.js.map +1 -0
  403. package/dist/esm/cells/drilldown-cell.js +171 -0
  404. package/dist/esm/cells/drilldown-cell.js.map +1 -0
  405. package/dist/esm/cells/image-cell.js +94 -0
  406. package/dist/esm/cells/image-cell.js.map +1 -0
  407. package/dist/esm/cells/index.js +30 -0
  408. package/dist/esm/cells/index.js.map +1 -0
  409. package/dist/esm/cells/loading-cell.js +41 -0
  410. package/dist/esm/cells/loading-cell.js.map +1 -0
  411. package/dist/esm/cells/markdown-cell.js +30 -0
  412. package/dist/esm/cells/markdown-cell.js.map +1 -0
  413. package/dist/esm/cells/marker-cell.js +80 -0
  414. package/dist/esm/cells/marker-cell.js.map +1 -0
  415. package/dist/esm/cells/new-row-cell.js +53 -0
  416. package/dist/esm/cells/new-row-cell.js.map +1 -0
  417. package/dist/esm/cells/number-cell.js +44 -0
  418. package/dist/esm/cells/number-cell.js.map +1 -0
  419. package/dist/esm/cells/protected-cell.js +35 -0
  420. package/dist/esm/cells/protected-cell.js.map +1 -0
  421. package/dist/esm/cells/row-id-cell.js +23 -0
  422. package/dist/esm/cells/row-id-cell.js.map +1 -0
  423. package/dist/esm/cells/text-cell.js +48 -0
  424. package/dist/esm/cells/text-cell.js.map +1 -0
  425. package/dist/esm/cells/uri-cell.js +104 -0
  426. package/dist/esm/cells/uri-cell.js.map +1 -0
  427. package/dist/esm/common/browser-detect.js +20 -0
  428. package/dist/esm/common/browser-detect.js.map +1 -0
  429. package/dist/esm/common/image-window-loader.js +98 -0
  430. package/dist/esm/common/image-window-loader.js.map +1 -0
  431. package/dist/esm/common/is-hotkey.js +76 -0
  432. package/dist/esm/common/is-hotkey.js.map +1 -0
  433. package/dist/esm/common/math.js +297 -0
  434. package/dist/esm/common/math.js.map +1 -0
  435. package/dist/esm/common/render-state-provider.js +74 -0
  436. package/dist/esm/common/render-state-provider.js.map +1 -0
  437. package/dist/esm/common/resize-detector.js +27 -0
  438. package/dist/esm/common/resize-detector.js.map +1 -0
  439. package/dist/esm/common/styles.js +135 -0
  440. package/dist/esm/common/styles.js.map +1 -0
  441. package/dist/esm/common/support.js +60 -0
  442. package/dist/esm/common/support.js.map +1 -0
  443. package/dist/esm/common/utils.js +193 -0
  444. package/dist/esm/common/utils.js.map +1 -0
  445. package/dist/esm/data-editor/copy-paste.js +279 -0
  446. package/dist/esm/data-editor/copy-paste.js.map +1 -0
  447. package/dist/esm/data-editor/data-editor-fns.js +210 -0
  448. package/dist/esm/data-editor/data-editor-fns.js.map +1 -0
  449. package/dist/esm/data-editor/data-editor-keybindings.js +126 -0
  450. package/dist/esm/data-editor/data-editor-keybindings.js.map +1 -0
  451. package/dist/esm/data-editor/data-editor.js +3283 -0
  452. package/dist/esm/data-editor/data-editor.js.map +1 -0
  453. package/dist/esm/data-editor/group-rename.css +2 -0
  454. package/dist/esm/data-editor/group-rename.js +49 -0
  455. package/dist/esm/data-editor/group-rename.js.map +1 -0
  456. package/dist/esm/data-editor/row-grouping-api.js +34 -0
  457. package/dist/esm/data-editor/row-grouping-api.js.map +1 -0
  458. package/dist/esm/data-editor/row-grouping.js +189 -0
  459. package/dist/esm/data-editor/row-grouping.js.map +1 -0
  460. package/dist/esm/data-editor/use-autoscroll.js +36 -0
  461. package/dist/esm/data-editor/use-autoscroll.js.map +1 -0
  462. package/dist/esm/data-editor/use-cells-for-selection.js +53 -0
  463. package/dist/esm/data-editor/use-cells-for-selection.js.map +1 -0
  464. package/dist/esm/data-editor/use-column-sizer.js +319 -0
  465. package/dist/esm/data-editor/use-column-sizer.js.map +1 -0
  466. package/dist/esm/data-editor/use-initial-scroll-offset.js +81 -0
  467. package/dist/esm/data-editor/use-initial-scroll-offset.js.map +1 -0
  468. package/dist/esm/data-editor/use-rem-adjuster.js +29 -0
  469. package/dist/esm/data-editor/use-rem-adjuster.js.map +1 -0
  470. package/dist/esm/data-editor/visible-region.js +2 -0
  471. package/dist/esm/data-editor/visible-region.js.map +1 -0
  472. package/dist/esm/data-editor-all.js +19 -0
  473. package/dist/esm/data-editor-all.js.map +1 -0
  474. package/dist/esm/index.js +36 -0
  475. package/dist/esm/index.js.map +1 -0
  476. package/dist/esm/internal/click-outside-container/click-outside-container.js +34 -0
  477. package/dist/esm/internal/click-outside-container/click-outside-container.js.map +1 -0
  478. package/dist/esm/internal/data-editor-container/data-grid-container.css +1 -0
  479. package/dist/esm/internal/data-editor-container/data-grid-container.js +31 -0
  480. package/dist/esm/internal/data-editor-container/data-grid-container.js.map +1 -0
  481. package/dist/esm/internal/data-grid/animation-manager.js +95 -0
  482. package/dist/esm/internal/data-grid/animation-manager.js.map +1 -0
  483. package/dist/esm/internal/data-grid/cell-set.js +56 -0
  484. package/dist/esm/internal/data-grid/cell-set.js.map +1 -0
  485. package/dist/esm/internal/data-grid/color-parser.js +122 -0
  486. package/dist/esm/internal/data-grid/color-parser.js.map +1 -0
  487. package/dist/esm/internal/data-grid/column-resize.js +16 -0
  488. package/dist/esm/internal/data-grid/column-resize.js.map +1 -0
  489. package/dist/esm/internal/data-grid/data-grid-sprites.js +65 -0
  490. package/dist/esm/internal/data-grid/data-grid-sprites.js.map +1 -0
  491. package/dist/esm/internal/data-grid/data-grid-types.js +299 -0
  492. package/dist/esm/internal/data-grid/data-grid-types.js.map +1 -0
  493. package/dist/esm/internal/data-grid/data-grid.js +1515 -0
  494. package/dist/esm/internal/data-grid/data-grid.js.map +1 -0
  495. package/dist/esm/internal/data-grid/event-args.js +57 -0
  496. package/dist/esm/internal/data-grid/event-args.js.map +1 -0
  497. package/dist/esm/internal/data-grid/hidden-columns-indicator.js +47 -0
  498. package/dist/esm/internal/data-grid/hidden-columns-indicator.js.map +1 -0
  499. package/dist/esm/internal/data-grid/image-window-loader-interface.js +2 -0
  500. package/dist/esm/internal/data-grid/image-window-loader-interface.js.map +1 -0
  501. package/dist/esm/internal/data-grid/render/data-grid-freeze.js +227 -0
  502. package/dist/esm/internal/data-grid/render/data-grid-freeze.js.map +1 -0
  503. package/dist/esm/internal/data-grid/render/data-grid-lib.js +888 -0
  504. package/dist/esm/internal/data-grid/render/data-grid-lib.js.map +1 -0
  505. package/dist/esm/internal/data-grid/render/data-grid-render.blit.js +305 -0
  506. package/dist/esm/internal/data-grid/render/data-grid-render.blit.js.map +1 -0
  507. package/dist/esm/internal/data-grid/render/data-grid-render.cells.js +739 -0
  508. package/dist/esm/internal/data-grid/render/data-grid-render.cells.js.map +1 -0
  509. package/dist/esm/internal/data-grid/render/data-grid-render.hairline.js +15 -0
  510. package/dist/esm/internal/data-grid/render/data-grid-render.hairline.js.map +1 -0
  511. package/dist/esm/internal/data-grid/render/data-grid-render.header.js +767 -0
  512. package/dist/esm/internal/data-grid/render/data-grid-render.header.js.map +1 -0
  513. package/dist/esm/internal/data-grid/render/data-grid-render.js +871 -0
  514. package/dist/esm/internal/data-grid/render/data-grid-render.js.map +1 -0
  515. package/dist/esm/internal/data-grid/render/data-grid-render.lines.js +449 -0
  516. package/dist/esm/internal/data-grid/render/data-grid-render.lines.js.map +1 -0
  517. package/dist/esm/internal/data-grid/render/data-grid-render.selection-regions.js +321 -0
  518. package/dist/esm/internal/data-grid/render/data-grid-render.selection-regions.js.map +1 -0
  519. package/dist/esm/internal/data-grid/render/data-grid-render.walk.js +294 -0
  520. package/dist/esm/internal/data-grid/render/data-grid-render.walk.js.map +1 -0
  521. package/dist/esm/internal/data-grid/render/data-grid.render.rings.js +298 -0
  522. package/dist/esm/internal/data-grid/render/data-grid.render.rings.js.map +1 -0
  523. package/dist/esm/internal/data-grid/render/draw-checkbox.js +65 -0
  524. package/dist/esm/internal/data-grid/render/draw-checkbox.js.map +1 -0
  525. package/dist/esm/internal/data-grid/render/draw-edit-hover-indicator.js +38 -0
  526. package/dist/esm/internal/data-grid/render/draw-edit-hover-indicator.js.map +1 -0
  527. package/dist/esm/internal/data-grid/render/draw-grid-arg.js +2 -0
  528. package/dist/esm/internal/data-grid/render/draw-grid-arg.js.map +1 -0
  529. package/dist/esm/internal/data-grid/sprites.js +288 -0
  530. package/dist/esm/internal/data-grid/sprites.js.map +1 -0
  531. package/dist/esm/internal/data-grid/use-animation-queue.js +34 -0
  532. package/dist/esm/internal/data-grid/use-animation-queue.js.map +1 -0
  533. package/dist/esm/internal/data-grid/use-selection-behavior.js +112 -0
  534. package/dist/esm/internal/data-grid/use-selection-behavior.js.map +1 -0
  535. package/dist/esm/internal/data-grid-dnd/data-grid-dnd.js +249 -0
  536. package/dist/esm/internal/data-grid-dnd/data-grid-dnd.js.map +1 -0
  537. package/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.css +1 -0
  538. package/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.js +21 -0
  539. package/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.js.map +1 -0
  540. package/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor.js +124 -0
  541. package/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor.js.map +1 -0
  542. package/dist/esm/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.css +1 -0
  543. package/dist/esm/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.js +7 -0
  544. package/dist/esm/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.js.map +1 -0
  545. package/dist/esm/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.js +10 -0
  546. package/dist/esm/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.js.map +1 -0
  547. package/dist/esm/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.css +1 -0
  548. package/dist/esm/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.js +20 -0
  549. package/dist/esm/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.js.map +1 -0
  550. package/dist/esm/internal/data-grid-overlay-editor/private/image-overlay-editor-style.css +1 -0
  551. package/dist/esm/internal/data-grid-overlay-editor/private/image-overlay-editor-style.js +7 -0
  552. package/dist/esm/internal/data-grid-overlay-editor/private/image-overlay-editor-style.js.map +1 -0
  553. package/dist/esm/internal/data-grid-overlay-editor/private/image-overlay-editor.js +21 -0
  554. package/dist/esm/internal/data-grid-overlay-editor/private/image-overlay-editor.js.map +1 -0
  555. package/dist/esm/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.css +1 -0
  556. package/dist/esm/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.js +11 -0
  557. package/dist/esm/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.js.map +1 -0
  558. package/dist/esm/internal/data-grid-overlay-editor/private/markdown-overlay-editor.js +32 -0
  559. package/dist/esm/internal/data-grid-overlay-editor/private/markdown-overlay-editor.js.map +1 -0
  560. package/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor-style.css +1 -0
  561. package/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor-style.js +7 -0
  562. package/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor-style.js.map +1 -0
  563. package/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor.js +30 -0
  564. package/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor.js.map +1 -0
  565. package/dist/esm/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.css +1 -0
  566. package/dist/esm/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.js +7 -0
  567. package/dist/esm/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.js.map +1 -0
  568. package/dist/esm/internal/data-grid-overlay-editor/private/uri-overlay-editor.js +21 -0
  569. package/dist/esm/internal/data-grid-overlay-editor/private/uri-overlay-editor.js.map +1 -0
  570. package/dist/esm/internal/data-grid-overlay-editor/use-stay-on-screen.js +47 -0
  571. package/dist/esm/internal/data-grid-overlay-editor/use-stay-on-screen.js.map +1 -0
  572. package/dist/esm/internal/data-grid-search/data-grid-search-style.css +1 -0
  573. package/dist/esm/internal/data-grid-search/data-grid-search-style.js +7 -0
  574. package/dist/esm/internal/data-grid-search/data-grid-search-style.js.map +1 -0
  575. package/dist/esm/internal/data-grid-search/data-grid-search.js +297 -0
  576. package/dist/esm/internal/data-grid-search/data-grid-search.js.map +1 -0
  577. package/dist/esm/internal/growing-entry/growing-entry-style.css +3 -0
  578. package/dist/esm/internal/growing-entry/growing-entry-style.js +17 -0
  579. package/dist/esm/internal/growing-entry/growing-entry-style.js.map +1 -0
  580. package/dist/esm/internal/growing-entry/growing-entry.js +41 -0
  581. package/dist/esm/internal/growing-entry/growing-entry.js.map +1 -0
  582. package/dist/esm/internal/markdown-div/markdown-div.js +41 -0
  583. package/dist/esm/internal/markdown-div/markdown-div.js.map +1 -0
  584. package/dist/esm/internal/markdown-div/private/markdown-container.css +1 -0
  585. package/dist/esm/internal/markdown-div/private/markdown-container.js +7 -0
  586. package/dist/esm/internal/markdown-div/private/markdown-container.js.map +1 -0
  587. package/dist/esm/internal/scrolling-data-grid/infinite-scroller.css +1 -0
  588. package/dist/esm/internal/scrolling-data-grid/infinite-scroller.js +267 -0
  589. package/dist/esm/internal/scrolling-data-grid/infinite-scroller.js.map +1 -0
  590. package/dist/esm/internal/scrolling-data-grid/row-offsets.js +88 -0
  591. package/dist/esm/internal/scrolling-data-grid/row-offsets.js.map +1 -0
  592. package/dist/esm/internal/scrolling-data-grid/scrolling-data-grid.js +125 -0
  593. package/dist/esm/internal/scrolling-data-grid/scrolling-data-grid.js.map +1 -0
  594. package/dist/esm/internal/scrolling-data-grid/use-kinetic-scroll.js +65 -0
  595. package/dist/esm/internal/scrolling-data-grid/use-kinetic-scroll.js.map +1 -0
  596. package/dist/esm/internal/scrolling-data-grid/use-row-offsets.js +36 -0
  597. package/dist/esm/internal/scrolling-data-grid/use-row-offsets.js.map +1 -0
  598. package/dist/index.css +14 -0
  599. package/package.json +83 -5
  600. package/src/cells/boolean-cell.tsx +135 -0
  601. package/src/cells/bubble-cell.tsx +68 -0
  602. package/src/cells/cell-types.ts +124 -0
  603. package/src/cells/drilldown-cell.tsx +244 -0
  604. package/src/cells/image-cell.tsx +117 -0
  605. package/src/cells/index.ts +31 -0
  606. package/src/cells/loading-cell.tsx +56 -0
  607. package/src/cells/markdown-cell.tsx +44 -0
  608. package/src/cells/marker-cell.tsx +110 -0
  609. package/src/cells/new-row-cell.tsx +60 -0
  610. package/src/cells/number-cell.tsx +64 -0
  611. package/src/cells/protected-cell.tsx +42 -0
  612. package/src/cells/row-id-cell.tsx +35 -0
  613. package/src/cells/text-cell.tsx +63 -0
  614. package/src/cells/uri-cell.tsx +155 -0
  615. package/src/common/browser-detect.ts +25 -0
  616. package/src/common/image-window-loader.ts +114 -0
  617. package/src/common/is-hotkey.ts +86 -0
  618. package/src/common/math.ts +357 -0
  619. package/src/common/render-state-provider.ts +97 -0
  620. package/src/common/resize-detector.ts +43 -0
  621. package/src/common/styles.ts +215 -0
  622. package/src/common/support.ts +67 -0
  623. package/src/common/utils.tsx +284 -0
  624. package/src/data-editor/copy-paste.ts +332 -0
  625. package/src/data-editor/data-editor-fns.ts +230 -0
  626. package/src/data-editor/data-editor-keybindings.ts +198 -0
  627. package/src/data-editor/data-editor.tsx +4916 -0
  628. package/src/data-editor/group-rename.tsx +67 -0
  629. package/src/data-editor/row-grouping-api.ts +72 -0
  630. package/src/data-editor/row-grouping.ts +326 -0
  631. package/src/data-editor/stories/column-width/column-width.stories.tsx +644 -0
  632. package/src/data-editor/stories/data-editor-repros.stories.tsx +237 -0
  633. package/src/data-editor/stories/data-editor.stories.tsx +797 -0
  634. package/src/data-editor/stories/span-cells/span-cells.stories.tsx +246 -0
  635. package/src/data-editor/stories/span-group-header/span-group-header.stories.tsx +610 -0
  636. package/src/data-editor/stories/sticky-rows-cols/sticky-rows-cols.stories.tsx +183 -0
  637. package/src/data-editor/stories/utils.tsx +827 -0
  638. package/src/data-editor/use-autoscroll.ts +41 -0
  639. package/src/data-editor/use-cells-for-selection.ts +72 -0
  640. package/src/data-editor/use-column-sizer.ts +388 -0
  641. package/src/data-editor/use-initial-scroll-offset.ts +102 -0
  642. package/src/data-editor/use-rem-adjuster.ts +59 -0
  643. package/src/data-editor/visible-region.ts +20 -0
  644. package/src/data-editor-all.tsx +36 -0
  645. package/src/docs/00-faq.stories.tsx +63 -0
  646. package/src/docs/01-getting-started.stories.tsx +299 -0
  647. package/src/docs/02-editing-data.stories.tsx +365 -0
  648. package/src/docs/03-grid-column.stories.tsx +146 -0
  649. package/src/docs/04-streaming-data.stories.tsx +434 -0
  650. package/src/docs/05-copy-paste.stories.tsx.tsx +279 -0
  651. package/src/docs/06-search.stories.tsx +219 -0
  652. package/src/docs/07-column-grouping.stories.tsx +212 -0
  653. package/src/docs/08-theming.stories.tsx +409 -0
  654. package/src/docs/09-menus.stories.tsx +344 -0
  655. package/src/docs/doc-wrapper.tsx +512 -0
  656. package/src/docs/examples/add-column.stories.tsx +62 -0
  657. package/src/docs/examples/add-data-to-middle.stories.tsx +93 -0
  658. package/src/docs/examples/add-data-to-top.stories.tsx +70 -0
  659. package/src/docs/examples/add-data.stories.tsx +74 -0
  660. package/src/docs/examples/all-cell-kinds.stories.tsx +61 -0
  661. package/src/docs/examples/append-row-handle.stories.tsx +79 -0
  662. package/src/docs/examples/automatic-row-markers.stories.tsx +57 -0
  663. package/src/docs/examples/built-in-search.stories.tsx +83 -0
  664. package/src/docs/examples/cell-activated-event.stories.tsx +92 -0
  665. package/src/docs/examples/column-group-collapse.stories.tsx +105 -0
  666. package/src/docs/examples/column-groups.stories.tsx +51 -0
  667. package/src/docs/examples/content-alignment.stories.tsx +64 -0
  668. package/src/docs/examples/controlled-search.stories.tsx +93 -0
  669. package/src/docs/examples/controlled-selection.stories.tsx +98 -0
  670. package/src/docs/examples/copy-support.stories.tsx +63 -0
  671. package/src/docs/examples/custom-editors.stories.tsx +90 -0
  672. package/src/docs/examples/custom-event-target.stories.tsx +157 -0
  673. package/src/docs/examples/custom-group-header.stories.tsx +443 -0
  674. package/src/docs/examples/custom-header-icons.stories.tsx +76 -0
  675. package/src/docs/examples/custom-header.stories.tsx +67 -0
  676. package/src/docs/examples/custom-renderers.stories.tsx +72 -0
  677. package/src/docs/examples/drag-source.stories.tsx +63 -0
  678. package/src/docs/examples/drop-events.stories.tsx +155 -0
  679. package/src/docs/examples/fill-handle.stories.tsx +118 -0
  680. package/src/docs/examples/freeze-columns.stories.tsx +59 -0
  681. package/src/docs/examples/freeze-rows.stories.tsx +71 -0
  682. package/src/docs/examples/get-mouse-args.stories.tsx +61 -0
  683. package/src/docs/examples/header-menus.stories.tsx +162 -0
  684. package/src/docs/examples/highlight-cells.stories.tsx +84 -0
  685. package/src/docs/examples/huge-uneven-rows.stories.tsx +191 -0
  686. package/src/docs/examples/imperative-scroll.stories.tsx +96 -0
  687. package/src/docs/examples/input-blending.stories.tsx +116 -0
  688. package/src/docs/examples/keybindings.stories.tsx +90 -0
  689. package/src/docs/examples/layout-integration.stories.tsx +48 -0
  690. package/src/docs/examples/multi-level-column-groups.stories.tsx +119 -0
  691. package/src/docs/examples/multi-select-columns.stories.tsx +47 -0
  692. package/src/docs/examples/new-column-button.stories.tsx +56 -0
  693. package/src/docs/examples/obscured-grid.stories.tsx +70 -0
  694. package/src/docs/examples/observe-visible-region.stories.tsx +56 -0
  695. package/src/docs/examples/one-hundred-thousand-columns.stories.tsx +31 -0
  696. package/src/docs/examples/one-million-rows.stories.tsx +37 -0
  697. package/src/docs/examples/overscroll.stories.tsx +74 -0
  698. package/src/docs/examples/padding.stories.tsx +74 -0
  699. package/src/docs/examples/paste-support.stories.tsx +73 -0
  700. package/src/docs/examples/per-column-min-max-width.stories.tsx +108 -0
  701. package/src/docs/examples/prevent-diagonal-scroll.stories.tsx +47 -0
  702. package/src/docs/examples/rapid-updates.stories.tsx +108 -0
  703. package/src/docs/examples/rearrange-columns.stories.tsx +76 -0
  704. package/src/docs/examples/reorder-rows.stories.tsx +83 -0
  705. package/src/docs/examples/resizable-columns.stories.tsx +129 -0
  706. package/src/docs/examples/right-element.stories.tsx +87 -0
  707. package/src/docs/examples/right-to-left.stories.tsx +73 -0
  708. package/src/docs/examples/row-and-header-sizes.stories.tsx +75 -0
  709. package/src/docs/examples/row-grouping.stories.tsx +142 -0
  710. package/src/docs/examples/row-hover.stories.tsx +67 -0
  711. package/src/docs/examples/row-markers.stories.tsx +74 -0
  712. package/src/docs/examples/row-selections.stories.tsx +84 -0
  713. package/src/docs/examples/scaled-view.stories.tsx +36 -0
  714. package/src/docs/examples/scroll-offset.stories.tsx +49 -0
  715. package/src/docs/examples/scroll-shadows.stories.tsx +83 -0
  716. package/src/docs/examples/search-as-filter.stories.tsx +76 -0
  717. package/src/docs/examples/selection-serialization.stories.tsx +208 -0
  718. package/src/docs/examples/server-side-data.stories.tsx +219 -0
  719. package/src/docs/examples/shadow-dom.stories.tsx +107 -0
  720. package/src/docs/examples/silly-numbers.stories.tsx +40 -0
  721. package/src/docs/examples/small-editable-grid.stories.tsx +39 -0
  722. package/src/docs/examples/smooth-scrolling-grid.stories.tsx +56 -0
  723. package/src/docs/examples/span-cell.stories.tsx +99 -0
  724. package/src/docs/examples/stretch-column-size.stories.tsx +55 -0
  725. package/src/docs/examples/ten-million-cells.stories.tsx +34 -0
  726. package/src/docs/examples/theme-per-column.stories.tsx +88 -0
  727. package/src/docs/examples/theme-per-row.stories.tsx +73 -0
  728. package/src/docs/examples/theme-support.stories.tsx +150 -0
  729. package/src/docs/examples/tooltips.stories.tsx +119 -0
  730. package/src/docs/examples/trailing-row-options.stories.tsx +106 -0
  731. package/src/docs/examples/uneven-rows.stories.tsx +44 -0
  732. package/src/docs/examples/validate-data.stories.tsx +63 -0
  733. package/src/docs/examples/wrapping-text.stories.tsx +97 -0
  734. package/src/docs/template.tsx +69 -0
  735. package/src/index.ts +89 -0
  736. package/src/internal/click-outside-container/click-outside-container.tsx +50 -0
  737. package/src/internal/data-editor-container/data-grid-container.tsx +48 -0
  738. package/src/internal/data-grid/animation-manager.ts +119 -0
  739. package/src/internal/data-grid/cell-set.ts +65 -0
  740. package/src/internal/data-grid/color-parser.ts +141 -0
  741. package/src/internal/data-grid/column-resize.ts +20 -0
  742. package/src/internal/data-grid/data-grid-sprites.ts +107 -0
  743. package/src/internal/data-grid/data-grid-types.ts +848 -0
  744. package/src/internal/data-grid/data-grid.stories.tsx +410 -0
  745. package/src/internal/data-grid/data-grid.tsx +2441 -0
  746. package/src/internal/data-grid/event-args.ts +203 -0
  747. package/src/internal/data-grid/hidden-columns-indicator.ts +78 -0
  748. package/src/internal/data-grid/image-window-loader-interface.ts +13 -0
  749. package/src/internal/data-grid/render/data-grid-freeze.ts +289 -0
  750. package/src/internal/data-grid/render/data-grid-lib.ts +1220 -0
  751. package/src/internal/data-grid/render/data-grid-render.blit.ts +409 -0
  752. package/src/internal/data-grid/render/data-grid-render.cells.ts +1061 -0
  753. package/src/internal/data-grid/render/data-grid-render.hairline.ts +17 -0
  754. package/src/internal/data-grid/render/data-grid-render.header.ts +1281 -0
  755. package/src/internal/data-grid/render/data-grid-render.lines.ts +614 -0
  756. package/src/internal/data-grid/render/data-grid-render.selection-regions.ts +386 -0
  757. package/src/internal/data-grid/render/data-grid-render.ts +1850 -0
  758. package/src/internal/data-grid/render/data-grid-render.walk.ts +433 -0
  759. package/src/internal/data-grid/render/data-grid.render.rings.ts +501 -0
  760. package/src/internal/data-grid/render/draw-checkbox.ts +122 -0
  761. package/src/internal/data-grid/render/draw-edit-hover-indicator.ts +61 -0
  762. package/src/internal/data-grid/render/draw-grid-arg.ts +104 -0
  763. package/src/internal/data-grid/sprites.ts +321 -0
  764. package/src/internal/data-grid/use-animation-queue.ts +41 -0
  765. package/src/internal/data-grid/use-selection-behavior.ts +152 -0
  766. package/src/internal/data-grid-dnd/data-grid-dnd.tsx +480 -0
  767. package/src/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.tsx +83 -0
  768. package/src/internal/data-grid-overlay-editor/data-grid-overlay-editor.tsx +262 -0
  769. package/src/internal/data-grid-overlay-editor/private/bubbles-overlay-editor-style.tsx +34 -0
  770. package/src/internal/data-grid-overlay-editor/private/bubbles-overlay-editor.tsx +21 -0
  771. package/src/internal/data-grid-overlay-editor/private/drilldown-overlay-editor.tsx +63 -0
  772. package/src/internal/data-grid-overlay-editor/private/image-overlay-editor-style.tsx +56 -0
  773. package/src/internal/data-grid-overlay-editor/private/image-overlay-editor.tsx +51 -0
  774. package/src/internal/data-grid-overlay-editor/private/markdown-overlay-editor-style.tsx +80 -0
  775. package/src/internal/data-grid-overlay-editor/private/markdown-overlay-editor.tsx +65 -0
  776. package/src/internal/data-grid-overlay-editor/private/number-overlay-editor-style.tsx +15 -0
  777. package/src/internal/data-grid-overlay-editor/private/number-overlay-editor.tsx +77 -0
  778. package/src/internal/data-grid-overlay-editor/private/uri-overlay-editor-style.tsx +53 -0
  779. package/src/internal/data-grid-overlay-editor/private/uri-overlay-editor.tsx +52 -0
  780. package/src/internal/data-grid-overlay-editor/use-stay-on-screen.ts +61 -0
  781. package/src/internal/data-grid-search/data-grid-search-style.tsx +96 -0
  782. package/src/internal/data-grid-search/data-grid-search.tsx +587 -0
  783. package/src/internal/growing-entry/growing-entry-style.tsx +62 -0
  784. package/src/internal/growing-entry/growing-entry.tsx +74 -0
  785. package/src/internal/markdown-div/markdown-div.tsx +55 -0
  786. package/src/internal/markdown-div/private/markdown-container.tsx +19 -0
  787. package/src/internal/scrolling-data-grid/infinite-scroller.tsx +379 -0
  788. package/src/internal/scrolling-data-grid/row-offsets.ts +136 -0
  789. package/src/internal/scrolling-data-grid/scrolling-data-grid.stories.tsx +164 -0
  790. package/src/internal/scrolling-data-grid/scrolling-data-grid.tsx +338 -0
  791. package/src/internal/scrolling-data-grid/use-kinetic-scroll.ts +78 -0
  792. package/src/internal/scrolling-data-grid/use-row-offsets.ts +38 -0
  793. package/src/stories/story-utils.tsx +72 -0
  794. package/test/animation-manager.test.ts +147 -0
  795. package/test/cells.test.tsx +122 -0
  796. package/test/click-outside-container.test.tsx +62 -0
  797. package/test/color-parser.test.ts +68 -0
  798. package/test/common.test.ts +74 -0
  799. package/test/compact-selection.test.ts +221 -0
  800. package/test/copy-paste.test.ts +532 -0
  801. package/test/data-editor-fns.expand-rect-spans.test.ts +126 -0
  802. package/test/data-editor-fns.test.ts +153 -0
  803. package/test/data-editor-hover-info.test.tsx +98 -0
  804. package/test/data-editor-input.test.tsx +683 -0
  805. package/test/data-editor-resizable.test.tsx +98 -0
  806. package/test/data-editor-resize-hover.test.tsx +442 -0
  807. package/test/data-editor-resize.test.tsx +271 -0
  808. package/test/data-editor.hidden-indicator.test.tsx +188 -0
  809. package/test/data-editor.span-editor-position.test.tsx +109 -0
  810. package/test/data-editor.span-fill-editor.test.tsx +118 -0
  811. package/test/data-editor.span-skip-covered.test.tsx +156 -0
  812. package/test/data-editor.sticky.test.tsx +75 -0
  813. package/test/data-editor.test.tsx +5221 -0
  814. package/test/data-grid-freeze.test.ts +198 -0
  815. package/test/data-grid-lib.cell-in-rect.test.ts +82 -0
  816. package/test/data-grid-lib.span-align.test.ts +188 -0
  817. package/test/data-grid-lib.span-cell-helpers.test.ts +95 -0
  818. package/test/data-grid-lib.span-group-header.test.ts +84 -0
  819. package/test/data-grid-lib.test.ts +457 -0
  820. package/test/data-grid-overlay.test.tsx +67 -0
  821. package/test/data-grid-render-hairline.test.ts +41 -0
  822. package/test/data-grid-render.blit-row-height.test.ts +67 -0
  823. package/test/data-grid-render.damage-regions.test.ts +69 -0
  824. package/test/data-grid-render.grid-lines-control.test.ts +193 -0
  825. package/test/data-grid-render.grid-lines-span-clip.test.ts +121 -0
  826. package/test/data-grid-render.group-drag-damage.test.ts +89 -0
  827. package/test/data-grid-render.group-fill-color.test.ts +46 -0
  828. package/test/data-grid-render.group-hover-flicker.test.ts +152 -0
  829. package/test/data-grid-render.group-selection-fill-border.test.ts +137 -0
  830. package/test/data-grid-render.group-spanned-draw.test.ts +140 -0
  831. package/test/data-grid-render.header-clip-span.test.ts +93 -0
  832. package/test/data-grid-render.selection-regions.test.ts +340 -0
  833. package/test/data-grid-render.span-bg-fills.test.ts +63 -0
  834. package/test/data-grid-render.span-bounds.test.ts +94 -0
  835. package/test/data-grid-render.span-group-header.test.ts +221 -0
  836. package/test/data-grid-render.span-hover-damage.test.ts +52 -0
  837. package/test/data-grid-render.span-intersect.test.ts +170 -0
  838. package/test/data-grid-render.span-partial-fill.test.ts +81 -0
  839. package/test/data-grid-render.span-sticky-content.test.ts +159 -0
  840. package/test/data-grid-render.sticky.test.ts +287 -0
  841. package/test/data-grid-types.test.ts +52 -0
  842. package/test/data-grid.hidden-indicator-mouse.test.tsx +352 -0
  843. package/test/data-grid.row-height-changes.test.tsx +220 -0
  844. package/test/data-grid.selection-partial-redraw.test.tsx +583 -0
  845. package/test/data-grid.span-cells.test.ts +208 -0
  846. package/test/data-grid.span-edge-cases.test.ts +146 -0
  847. package/test/data-grid.span-fill-editor.test.tsx +177 -0
  848. package/test/data-grid.span-mouse.test.tsx +299 -0
  849. package/test/data-grid.span-shallow-groups.test.ts +165 -0
  850. package/test/data-grid.span-sticky-scale.test.tsx +260 -0
  851. package/test/data-grid.test.tsx +698 -0
  852. package/test/event-args.raw-location.test.ts +70 -0
  853. package/test/hidden-columns-indicator.test.ts +35 -0
  854. package/test/image-window-loader.test.ts +211 -0
  855. package/test/math.test.ts +201 -0
  856. package/test/render-state-provider.test.ts +86 -0
  857. package/test/row-grouping-api.test.ts +77 -0
  858. package/test/row-grouping.test.ts +586 -0
  859. package/test/row-height-changes.test.ts +256 -0
  860. package/test/row-offsets.test.ts +170 -0
  861. package/test/test-utils.tsx +365 -0
  862. package/test/uri-cell.test.ts +124 -0
  863. package/test/use-animation-queue.test.ts +53 -0
  864. package/test/use-autoscroll.test.tsx +108 -0
  865. package/test/use-column-sizer.test.tsx +414 -0
  866. package/test/use-deep-memo.test.ts +41 -0
  867. package/test/use-kinetic-scroll.test.ts +57 -0
  868. package/test/use-rem-adjuster.test.ts +69 -0
  869. package/test/use-row-offsets.test.tsx +154 -0
  870. package/test/utils.test.ts +127 -0
  871. package/vitest.config.ts +40 -0
@@ -0,0 +1,4916 @@
1
+ /* eslint-disable sonarjs/no-duplicate-string */
2
+ import * as React from "react";
3
+ import { assert, assertNever, maybe } from "../common/support.js";
4
+ import clamp from "lodash/clamp.js";
5
+ import uniq from "lodash/uniq.js";
6
+ import flatten from "lodash/flatten.js";
7
+ import range from "lodash/range.js";
8
+ import debounce from "lodash/debounce.js";
9
+ import {
10
+ type EditableGridCell,
11
+ type GridCell,
12
+ GridCellKind,
13
+ type GridSelection,
14
+ isEditableGridCell,
15
+ type Rectangle,
16
+ isReadWriteCell,
17
+ type InnerGridCell,
18
+ InnerGridCellKind,
19
+ CompactSelection,
20
+ type Slice,
21
+ isInnerOnlyCell,
22
+ type ProvideEditorCallback,
23
+ type GridColumn,
24
+ isObjectEditorCallbackResult,
25
+ type Item,
26
+ type MarkerCell,
27
+ type ValidatedGridCell,
28
+ type ImageEditorType,
29
+ type CustomCell,
30
+ BooleanEmpty,
31
+ BooleanIndeterminate,
32
+ type FillHandleDirection,
33
+ type EditListItem,
34
+ type CellActivationBehavior,
35
+ type SpanAlignment,
36
+ type CellBorderResolver,
37
+ type CellBorders,
38
+ } from "../internal/data-grid/data-grid-types.js";
39
+ import DataGridSearch, { type DataGridSearchProps } from "../internal/data-grid-search/data-grid-search.js";
40
+ import { browserIsOSX } from "../common/browser-detect.js";
41
+ import {
42
+ getDataEditorTheme,
43
+ makeCSSStyle,
44
+ type FullTheme,
45
+ type Theme,
46
+ ThemeContext,
47
+ mergeAndRealizeTheme,
48
+ } from "../common/styles.js";
49
+ import type { DataGridRef } from "../internal/data-grid/data-grid.js";
50
+ import type { HiddenColumnsIndicatorInfo } from "../internal/data-grid/hidden-columns-indicator.js";
51
+ import { getScrollBarWidth, useEventListener, whenDefined } from "../common/utils.js";
52
+ import {
53
+ isGroupEqual,
54
+ itemsAreEqual,
55
+ itemIsInRect,
56
+ gridSelectionHasItem,
57
+ getFreezeTrailingHeight,
58
+ isCoveredSpanCell,
59
+ getSpanEditorPosition,
60
+ getSpanOrigin,
61
+ rangeIsFocusBlock,
62
+ } from "../internal/data-grid/render/data-grid-lib.js";
63
+ import { normalizeStickyIndexes } from "../internal/data-grid/render/data-grid-freeze.js";
64
+ import { GroupRename } from "./group-rename.js";
65
+ import { measureColumn, useColumnSizer } from "./use-column-sizer.js";
66
+ import { isHotkey } from "../common/is-hotkey.js";
67
+ import { type SelectionBlending, useSelectionBehavior } from "../internal/data-grid/use-selection-behavior.js";
68
+ import { useCellsForSelection } from "./use-cells-for-selection.js";
69
+ import { unquote, expandSelection, expandRectToSpans, copyToClipboard, toggleBoolean } from "./data-editor-fns.js";
70
+ import { DataEditorContainer } from "../internal/data-editor-container/data-grid-container.js";
71
+ import { useAutoscroll } from "./use-autoscroll.js";
72
+ import type { CustomRenderer, CellRenderer, InternalCellRenderer } from "../cells/cell-types.js";
73
+ import { decodeHTML, type CopyBuffer } from "./copy-paste.js";
74
+ import { useRemAdjuster } from "./use-rem-adjuster.js";
75
+ import { withAlpha } from "../internal/data-grid/color-parser.js";
76
+ import { combineRects, getClosestRect, pointInRect } from "../common/math.js";
77
+ import {
78
+ type HeaderClickedEventArgs,
79
+ type GroupHeaderClickedEventArgs,
80
+ type CellClickedEventArgs,
81
+ type FillPatternEventArgs,
82
+ type GridMouseEventArgs,
83
+ groupHeaderKind,
84
+ outOfBoundsKind,
85
+ type GridMouseCellEventArgs,
86
+ headerKind,
87
+ type GridDragEventArgs,
88
+ mouseEventArgsAreEqual,
89
+ type GridKeyEventArgs,
90
+ type CellActivatedEventArgs,
91
+ } from "../internal/data-grid/event-args.js";
92
+ import { type Keybinds, useKeybindingsWithDefaults } from "./data-editor-keybindings.js";
93
+ import type { Highlight } from "../internal/data-grid/render/data-grid-render.cells.js";
94
+ import { useRowGroupingInner, type RowGroupingOptions } from "./row-grouping.js";
95
+ import { useRowGrouping } from "./row-grouping-api.js";
96
+ import { useInitialScrollOffset } from "./use-initial-scroll-offset.js";
97
+ import type { VisibleRegion } from "./visible-region.js";
98
+
99
+ const DataGridOverlayEditor = React.lazy(
100
+ async () => await import("../internal/data-grid-overlay-editor/data-grid-overlay-editor.js")
101
+ );
102
+
103
+ // There must be a better way
104
+ let idCounter = 0;
105
+
106
+ export interface RowMarkerOptions {
107
+ kind: "checkbox" | "number" | "clickable-number" | "checkbox-visible" | "both" | "none";
108
+ checkboxStyle?: "circle" | "square";
109
+ startIndex?: number;
110
+ width?: number;
111
+ theme?: Partial<Theme>;
112
+ headerTheme?: Partial<Theme>;
113
+ headerAlwaysVisible?: boolean;
114
+ headerDisabled?: boolean;
115
+ }
116
+
117
+ interface MouseState {
118
+ readonly previousSelection?: GridSelection;
119
+ readonly fillHandle?: boolean;
120
+ }
121
+
122
+ type Props = Partial<
123
+ Omit<
124
+ DataGridSearchProps,
125
+ | "accessibilityHeight"
126
+ | "canvasRef"
127
+ | "cellXOffset"
128
+ | "cellYOffset"
129
+ | "className"
130
+ | "clientSize"
131
+ | "columns"
132
+ | "disabledRows"
133
+ | "drawFocusRing"
134
+ | "editorOpen"
135
+ | "enableGroups"
136
+ | "firstColAccessible"
137
+ | "firstColSticky"
138
+ | "freezeColumns"
139
+ | "hasAppendRow"
140
+ | "getCellContent"
141
+ | "getCellRenderer"
142
+ | "getCellsForSelection"
143
+ | "getRowThemeOverride"
144
+ | "gridRef"
145
+ | "groupHeaderHeight"
146
+ | "headerHeight"
147
+ | "isFilling"
148
+ | "isFocused"
149
+ | "imageWindowLoader"
150
+ | "lockColumns"
151
+ | "maxColumnWidth"
152
+ | "minColumnWidth"
153
+ | "nonGrowWidth"
154
+ | "onCanvasBlur"
155
+ | "onCanvasFocused"
156
+ | "onCellFocused"
157
+ | "onContextMenu"
158
+ | "onDragEnd"
159
+ | "onMouseDown"
160
+ | "onMouseMove"
161
+ | "onMouseUp"
162
+ | "onVisibleRegionChanged"
163
+ | "rowHeight"
164
+ | "rows"
165
+ | "scrollRef"
166
+ | "searchInputRef"
167
+ | "selectedColumns"
168
+ | "selection"
169
+ | "theme"
170
+ | "translateX"
171
+ | "translateY"
172
+ | "verticalBorder"
173
+ | "horizontalBorder"
174
+ | "getCellBorder"
175
+ >
176
+ >;
177
+
178
+ type EmitEvents = "copy" | "paste" | "delete" | "fill-right" | "fill-down";
179
+
180
+ function getSpanStops(cells: readonly (readonly GridCell[])[]): number[] {
181
+ return uniq(
182
+ flatten(
183
+ flatten(cells)
184
+ .filter(c => c.span !== undefined)
185
+ .map(c => range((c.span?.[0] ?? 0) + 1, (c.span?.[1] ?? 0) + 1))
186
+ )
187
+ );
188
+ }
189
+
190
+ function shiftSelection(input: GridSelection, offset: number): GridSelection {
191
+ if (input === undefined || offset === 0 || (input.columns.length === 0 && input.current === undefined))
192
+ return input;
193
+
194
+ return {
195
+ current:
196
+ input.current === undefined
197
+ ? undefined
198
+ : {
199
+ cell: [input.current.cell[0] + offset, input.current.cell[1]],
200
+ range: {
201
+ ...input.current.range,
202
+ x: input.current.range.x + offset,
203
+ },
204
+ rangeStack: input.current.rangeStack.map(r => ({
205
+ ...r,
206
+ x: r.x + offset,
207
+ })),
208
+ },
209
+ rows: input.rows,
210
+ columns: input.columns.offset(offset),
211
+ };
212
+ }
213
+
214
+ /**
215
+ * @category DataEditor
216
+ */
217
+ export interface DataEditorProps extends Props, Pick<DataGridSearchProps, "imageWindowLoader"> {
218
+ /** Emitted whenever the user has requested the deletion of the selection.
219
+ * @group Editing
220
+ */
221
+ readonly onDelete?: (selection: GridSelection) => boolean | GridSelection;
222
+ /** Emitted whenever a cell edit is completed.
223
+ * @group Editing
224
+ */
225
+ readonly onCellEdited?: (cell: Item, newValue: EditableGridCell) => void;
226
+ /** Emitted whenever a cell mutation is completed and provides all edits inbound as a single batch.
227
+ * @group Editing
228
+ */
229
+ readonly onCellsEdited?: (newValues: readonly EditListItem[]) => boolean | void;
230
+ /** Emitted whenever a row append operation is requested. Append location can be set in callback.
231
+ * @group Editing
232
+ */
233
+ readonly onRowAppended?: () => Promise<"top" | "bottom" | number | undefined> | void;
234
+ /** Emitted whenever a column append operation is requested. Append location can be set in callback.
235
+ * @group Editing
236
+ */
237
+ readonly onColumnAppended?: () => Promise<"left" | "right" | number | undefined> | void;
238
+ /** Emitted when a column header should show a context menu. Usually right click.
239
+ * @group Events
240
+ */
241
+ readonly onHeaderClicked?: (colIndex: number, event: HeaderClickedEventArgs) => void;
242
+ /** Emitted when a group header is clicked.
243
+ * @group Events
244
+ */
245
+ readonly onGroupHeaderClicked?: (colIndex: number, event: GroupHeaderClickedEventArgs) => void;
246
+ /** Emitted whe the user wishes to rename a group.
247
+ * @group Events
248
+ */
249
+ readonly onGroupHeaderRenamed?: (groupName: string, newVal: string) => void;
250
+ /**
251
+ * Объединяет (rowspan) пустые нижние ряды у «мелких» групп — тех, что заканчиваются
252
+ * выше самого глубокого уровня групп, — в одну высокую ячейку вместо пустой полосы
253
+ * под заголовком. Точечно на группе можно переопределить через `getGroupDetails().span`
254
+ * (поставить `false`, чтобы отключить для конкретной группы). Не задано → как раньше.
255
+ * @group Style
256
+ */
257
+ readonly spanShallowGroups?: boolean;
258
+ /**
259
+ * Выравнивание текста в объединённых ячейках шапки по умолчанию.
260
+ * Можно переопределить на колонке (`spanGroupHeaderAlign`) или на группе (`getGroupDetails().spanAlign`).
261
+ * @group Style
262
+ */
263
+ readonly spanAlign?: SpanAlignment;
264
+ /**
265
+ * Grid-дефолт слитной шапки: включает `spanGroupHeader` у ВСЕХ листовых колонок (без
266
+ * группы) — не нужно ставить флаг на каждую. Точечно перекрывается на колонке
267
+ * (`spanGroupHeader: true/false`). Колонки с группой проп не трогает.
268
+ * @group Style
269
+ */
270
+ readonly spanGroupHeader?: boolean;
271
+ /**
272
+ * Индикатор скрытых колонок: сколько колонок скрыто на левой границе колонки col.
273
+ * col === columns.length означает «справа от последней». 0 или undefined значит,
274
+ * что индикатора нет. Полоска одна независимо от числа скрытых. Ресайз на этой границе работает
275
+ * как обычно, а двойной клик вместо автосайза зовёт onHiddenColumnsIndicatorClicked.
276
+ * Можно вернуть { count, groupDepth }, где groupDepth задаёт, сколько верхних
277
+ * групп-рядов пропустить (высота полосы под сгруппированную шапку). Просто число
278
+ * означает полосу на всю высоту.
279
+ * @group Style
280
+ */
281
+ readonly hiddenColumnsIndicator?: (col: number) => number | HiddenColumnsIndicatorInfo;
282
+ /**
283
+ * Двойной клик по индикатору скрытых колонок раскрывает промежуток.
284
+ * @group Events
285
+ */
286
+ readonly onHiddenColumnsIndicatorClicked?: (
287
+ col: number,
288
+ event: HeaderClickedEventArgs | GroupHeaderClickedEventArgs
289
+ ) => void;
290
+ /** Emitted when a cell is clicked.
291
+ * @group Events
292
+ */
293
+ readonly onCellClicked?: (cell: Item, event: CellClickedEventArgs) => void;
294
+ /** Emitted when a cell is activated, by pressing Enter, Space or double clicking it.
295
+ * @group Events
296
+ */
297
+ readonly onCellActivated?: (cell: Item, event: CellActivatedEventArgs) => void;
298
+
299
+ /**
300
+ * Emitted whenever the user initiats a pattern fill using the fill handle. This event provides both
301
+ * a patternSource region and a fillDestination region, and can be prevented.
302
+ * @group Editing
303
+ */
304
+ readonly onFillPattern?: (event: FillPatternEventArgs) => void;
305
+ /** Emitted when editing has finished, regardless of data changing or not.
306
+ * @group Editing
307
+ */
308
+ readonly onFinishedEditing?: (newValue: GridCell | undefined, movement: Item) => void;
309
+ /** Emitted when a column header should show a context menu. Usually right click.
310
+ * @group Events
311
+ */
312
+ readonly onHeaderContextMenu?: (colIndex: number, event: HeaderClickedEventArgs) => void;
313
+ /** Emitted when a group header should show a context menu. Usually right click.
314
+ * @group Events
315
+ */
316
+ readonly onGroupHeaderContextMenu?: (colIndex: number, event: GroupHeaderClickedEventArgs) => void;
317
+ /** Emitted when a cell should show a context menu. Usually right click.
318
+ * @group Events
319
+ */
320
+ readonly onCellContextMenu?: (cell: Item, event: CellClickedEventArgs) => void;
321
+ /** Used for validating cell values during editing.
322
+ * @group Editing
323
+ * @param cell The cell which is being validated.
324
+ * @param newValue The new value being proposed.
325
+ * @param prevValue The previous value before the edit.
326
+ * @returns A return of false indicates the value will not be accepted. A value of
327
+ * true indicates the value will be accepted. Returning a new GridCell will immediately coerce the value to match.
328
+ */
329
+ readonly validateCell?: (
330
+ cell: Item,
331
+ newValue: EditableGridCell,
332
+ prevValue: GridCell
333
+ ) => boolean | ValidatedGridCell;
334
+
335
+ /** The columns to display in the data grid.
336
+ * @group Data
337
+ */
338
+ readonly columns: readonly GridColumn[];
339
+
340
+ /** Controls the trailing row used to insert new data into the grid.
341
+ * @group Editing
342
+ */
343
+ readonly trailingRowOptions?: {
344
+ /** If the trailing row should be tinted */
345
+ readonly tint?: boolean;
346
+ /** A hint string displayed on hover. Usually something like "New row" */
347
+ readonly hint?: string;
348
+ /** When set to true, the trailing row is always visible. */
349
+ readonly sticky?: boolean;
350
+ /** The icon to use for the cell. Either a GridColumnIcon or a member of the passed headerIcons */
351
+ readonly addIcon?: string;
352
+ /** Overrides the column to focus when a new row is created. */
353
+ readonly targetColumn?: number | GridColumn;
354
+ };
355
+ /** Controls the height of the header row
356
+ * @defaultValue 36
357
+ * @group Style
358
+ */
359
+ readonly headerHeight?: number;
360
+ /** Controls the header of the group header row
361
+ * @defaultValue `headerHeight`
362
+ * @group Style
363
+ */
364
+ readonly groupHeaderHeight?: number | number[];
365
+
366
+ /**
367
+ * The number of rows in the grid.
368
+ * @group Data
369
+ */
370
+ readonly rows: number;
371
+
372
+ /** Determines if row markers should be automatically added to the grid.
373
+ * Interactive row markers allow the user to select a row.
374
+ *
375
+ * - "clickable-number" renders a number that can be clicked to
376
+ * select the row
377
+ * - "both" causes the row marker to show up as a number but
378
+ * reveal a checkbox when the marker is hovered.
379
+ *
380
+ * @defaultValue `none`
381
+ * @group Style
382
+ */
383
+ readonly rowMarkers?: RowMarkerOptions["kind"] | RowMarkerOptions;
384
+ /**
385
+ * Sets the width of row markers in pixels, if unset row markers will automatically size.
386
+ * @group Style
387
+ * @deprecated Use `rowMarkers` instead.
388
+ */
389
+ readonly rowMarkerWidth?: number;
390
+ /** Changes the starting index for row markers.
391
+ * @defaultValue 1
392
+ * @group Style
393
+ * @deprecated Use `rowMarkers` instead.
394
+ */
395
+ readonly rowMarkerStartIndex?: number;
396
+
397
+ /** Changes the theme of the row marker column
398
+ * @group Style
399
+ * @deprecated Use `rowMarkers` instead.
400
+ */
401
+ readonly rowMarkerTheme?: Partial<Theme>;
402
+
403
+ /** Sets the width of the data grid.
404
+ * @group Style
405
+ */
406
+ readonly width?: number | string;
407
+ /** Sets the height of the data grid.
408
+ * @group Style
409
+ */
410
+ readonly height?: number | string;
411
+ /** Custom classname for data grid wrapper.
412
+ * @group Style
413
+ */
414
+ readonly className?: string;
415
+
416
+ /** If set to `default`, `gridSelection` will be coerced to always include full spans.
417
+ * @group Selection
418
+ * @defaultValue `default`
419
+ */
420
+ readonly spanRangeBehavior?: "default" | "allowPartial";
421
+
422
+ /** Controls which types of selections can exist at the same time in the grid. If selection blending is set to
423
+ * exclusive, the grid will clear other types of selections when the exclusive selection is made. By default row,
424
+ * column, and range selections are exclusive.
425
+ * @group Selection
426
+ * @defaultValue `exclusive`
427
+ * */
428
+ readonly rangeSelectionBlending?: SelectionBlending;
429
+ /** {@inheritDoc rangeSelectionBlending}
430
+ * @group Selection
431
+ */
432
+ readonly columnSelectionBlending?: SelectionBlending;
433
+ /** {@inheritDoc rangeSelectionBlending}
434
+ * @group Selection
435
+ */
436
+ readonly rowSelectionBlending?: SelectionBlending;
437
+ /** Controls if multi-selection is allowed. If disabled, shift/ctrl/command clicking will work as if no modifiers
438
+ * are pressed.
439
+ *
440
+ * When range select is set to cell, only one cell may be selected at a time. When set to rect one one rect at a
441
+ * time. The multi variants allow for multiples of the rect or cell to be selected.
442
+ * @group Selection
443
+ * @defaultValue `rect`
444
+ */
445
+ readonly rangeSelect?: "none" | "cell" | "rect" | "multi-cell" | "multi-rect";
446
+ /** {@inheritDoc rangeSelect}
447
+ * @group Selection
448
+ * @defaultValue `multi`
449
+ */
450
+ readonly columnSelect?: "none" | "single" | "multi";
451
+ /** {@inheritDoc rangeSelect}
452
+ * @group Selection
453
+ * @defaultValue `multi`
454
+ */
455
+ readonly rowSelect?: "none" | "single" | "multi";
456
+
457
+ /** Controls if range selection is allowed to span columns.
458
+ * @group Selection
459
+ * @defaultValue `true`
460
+ */
461
+ readonly rangeSelectionColumnSpanning?: boolean;
462
+
463
+ /** Sets the initial scroll Y offset.
464
+ * @see {@link scrollOffsetX}
465
+ * @group Advanced
466
+ */
467
+ readonly scrollOffsetY?: number;
468
+ /** Sets the initial scroll X offset
469
+ * @see {@link scrollOffsetY}
470
+ * @group Advanced
471
+ */
472
+ readonly scrollOffsetX?: number;
473
+
474
+ /** Determins the height of each row.
475
+ *
476
+ * Позиции строк кешируются по функции `rowHeight`: когда высоты меняются, передавай новую функцию,
477
+ * иначе glide продолжит считать по старым высотам и прокрутка разойдётся с отрисовкой.
478
+ * У функции можно указать `version`, а у следующей `changes` (`RowHeightChanges`): версию прежней функции
479
+ * и строки, у которых высота могла измениться. Тогда glide спросит высоты только у этих строк и перерисует
480
+ * экран только от первой из них. Подсказка действует на один шаг: если glide не видел прежнюю версию,
481
+ * он пересчитает всё. С `rowGrouping` и `scaleToRem` функцию оборачивают, и подсказка не используется.
482
+ * @group Style
483
+ * @defaultValue 34
484
+ */
485
+ readonly rowHeight?: DataGridSearchProps["rowHeight"];
486
+ /** Fires whenever the mouse moves
487
+ * @group Events
488
+ * @param args
489
+ */
490
+ readonly onMouseMove?: DataGridSearchProps["onMouseMove"];
491
+
492
+ /**
493
+ * The minimum width a column can be resized to.
494
+ * @defaultValue 50
495
+ * @group Style
496
+ */
497
+ readonly minColumnWidth?: DataGridSearchProps["minColumnWidth"];
498
+ /**
499
+ * The maximum width a column can be resized to.
500
+ * @defaultValue 500
501
+ * @group Style
502
+ */
503
+ readonly maxColumnWidth?: DataGridSearchProps["maxColumnWidth"];
504
+ /**
505
+ * The maximum width a column can be automatically sized to.
506
+ * @defaultValue `maxColumnWidth`
507
+ * @group Style
508
+ */
509
+ readonly maxColumnAutoWidth?: number;
510
+
511
+ /**
512
+ * Used to provide an override to the default image editor for the data grid. `provideEditor` may be a better
513
+ * choice for most people.
514
+ * @group Advanced
515
+ * */
516
+ readonly imageEditorOverride?: ImageEditorType;
517
+ /**
518
+ * If specified, it will be used to render Markdown, instead of the default Markdown renderer used by the Grid.
519
+ * You'll want to use this if you need to process your Markdown for security purposes, or if you want to use a
520
+ * renderer with different Markdown features.
521
+ * @group Advanced
522
+ */
523
+ readonly markdownDivCreateNode?: (content: string) => DocumentFragment;
524
+
525
+ /**
526
+ * Allows overriding the theme of any row
527
+ * @param row represents the row index of the row, increasing by 1 for every represented row. Collapsed rows are not included.
528
+ * @param groupRow represents the row index of the group row. Only distinct when row grouping enabled.
529
+ * @param contentRow represents the index of the row excluding group headers. Only distinct when row grouping enabled.
530
+ * @returns
531
+ */
532
+ readonly getRowThemeOverride?: (row: number, groupRow: number, contentRow: number) => Partial<Theme> | undefined;
533
+
534
+ /** Callback for providing a custom editor for a cell.
535
+ * @group Editing
536
+ */
537
+ readonly provideEditor?: ProvideEditorCallback<GridCell>;
538
+ /**
539
+ * Allows coercion of pasted values.
540
+ * @group Editing
541
+ * @param val The pasted value
542
+ * @param cell The cell being pasted into
543
+ * @returns `undefined` to accept default behavior or a `GridCell` which should be used to represent the pasted value.
544
+ */
545
+ readonly coercePasteValue?: (val: string, cell: GridCell) => GridCell | undefined;
546
+
547
+ /**
548
+ * Emitted when the grid selection is cleared.
549
+ * @group Selection
550
+ */
551
+ readonly onSelectionCleared?: () => void;
552
+
553
+ /**
554
+ * The current selection of the data grid. Contains all selected cells, ranges, rows, and columns.
555
+ * Used in conjunction with {@link onGridSelectionChange}
556
+ * method to implement a controlled selection.
557
+ * @group Selection
558
+ */
559
+ readonly gridSelection?: GridSelection;
560
+ /**
561
+ * Emitted whenever the grid selection changes. Specifying
562
+ * this function will make the grid’s selection controlled, so
563
+ * so you will need to specify {@link gridSelection} as well. See
564
+ * the "Controlled Selection" example for details.
565
+ *
566
+ * @param newSelection The new gridSelection as created by user input.
567
+ * @group Selection
568
+ */
569
+ readonly onGridSelectionChange?: (newSelection: GridSelection) => void;
570
+ /**
571
+ * Emitted whenever the visible cells change, usually due to scrolling.
572
+ * @group Events
573
+ * @param range An inclusive range of all visible cells. May include cells obscured by UI elements such
574
+ * as headers.
575
+ * @param tx The x transform of the cell region.
576
+ * @param ty The y transform of the cell region.
577
+ * @param extras Contains information about the selected cell and
578
+ * any visible freeze columns.
579
+ */
580
+ readonly onVisibleRegionChanged?: (
581
+ range: Rectangle,
582
+ tx: number,
583
+ ty: number,
584
+ extras: {
585
+ /** The selected item if visible */
586
+ selected?: Item;
587
+ /** A selection of visible freeze columns
588
+ * @deprecated
589
+ */
590
+ freezeRegion?: Rectangle;
591
+
592
+ /**
593
+ * All visible freeze regions
594
+ */
595
+ freezeRegions?: readonly Rectangle[];
596
+ }
597
+ ) => void;
598
+
599
+ /**
600
+ * The primary callback for getting cell data into the data grid.
601
+ * @group Data
602
+ * @param cell The location of the cell being requested.
603
+ * @returns A valid GridCell to be rendered by the Grid.
604
+ */
605
+ readonly getCellContent: (cell: Item) => GridCell;
606
+
607
+ /**
608
+ * Determines if row selection requires a modifier key to enable multi-selection or not. In auto mode it adapts to
609
+ * touch or mouse environments automatically, in multi-mode it always acts as if the multi key (Ctrl) is pressed.
610
+ * @group Editing
611
+ * @defaultValue `auto`
612
+ */
613
+ readonly rowSelectionMode?: "auto" | "multi";
614
+
615
+ /**
616
+ * Determines if column selection requires a modifier key to enable multi-selection or not. In auto mode it adapts to
617
+ * touch or mouse environments automatically, in multi-mode it always acts as if the multi key (Ctrl) is pressed.
618
+ * @group Editing
619
+ * @defaultValue `auto`
620
+ */
621
+ readonly columnSelectionMode?: "auto" | "multi";
622
+
623
+ /**
624
+ * Add table headers to copied data.
625
+ * @group Editing
626
+ * @defaultValue `false`
627
+ */
628
+ readonly copyHeaders?: boolean;
629
+
630
+ /**
631
+ * Determins which keybindings are enabled.
632
+ * @group Editing
633
+ */
634
+ readonly keybindings?: Partial<Keybinds>;
635
+
636
+ /**
637
+ * Determines if the data editor should immediately begin editing when the user types on a selected cell
638
+ * @group Editing
639
+ */
640
+ readonly editOnType?: boolean;
641
+
642
+ /**
643
+ * Used to fetch large amounts of cells at once. Used for copy/paste, if unset copy will not work.
644
+ *
645
+ * `getCellsForSelection` is called when the user copies a selection to the clipboard or the data editor needs to
646
+ * inspect data which may be outside the curently visible range. It must return a two-dimensional array (an array of
647
+ * rows, where each row is an array of cells) of the cells in the selection's rectangle. Note that the rectangle can
648
+ * include cells that are not currently visible.
649
+ *
650
+ * If `true` is passed instead of a callback, the data grid will internally use the `getCellContent` callback to
651
+ * provide a basic implementation of `getCellsForSelection`. This can make it easier to light up more data grid
652
+ * functionality, but may have negative side effects if your data source is not able to handle being queried for
653
+ * data outside the normal window.
654
+ *
655
+ * If `getCellsForSelection` returns a thunk, the data may be loaded asynchronously, however the data grid may be
656
+ * unable to properly react to column spans when performing range selections. Copying large amounts of data out of
657
+ * the grid will depend on the performance of the thunk as well.
658
+ * @group Data
659
+ * @param {Rectangle} selection The range of requested cells
660
+ * @param {AbortSignal} abortSignal A signal indicating the requested cells are no longer needed
661
+ * @returns A row-major collection of cells or an async thunk which returns a row-major collection.
662
+ */
663
+ readonly getCellsForSelection?: DataGridSearchProps["getCellsForSelection"] | true;
664
+
665
+ /** The number of columns which should remain in place when scrolling horizontally. The row marker column, if
666
+ * enabled is always frozen and is not included in this count.
667
+ * @defaultValue 0
668
+ * @group Style
669
+ */
670
+ readonly freezeColumns?: DataGridSearchProps["freezeColumns"];
671
+
672
+ /**
673
+ * Липкие колонки, например `[0, 3, 10]`. Колонка стоит на своём месте, пока при прокрутке не дойдёт
674
+ * до закреплённой зоны слева, и дальше остаётся в ней, как `position: sticky`. Сочетается с
675
+ * `freezeColumns`. Индексы считаются без колонки маркеров строк.
676
+ * @group Style
677
+ */
678
+ readonly stickyColumns?: readonly number[];
679
+
680
+ /**
681
+ * Липкие строки, например `[0, 5, 40]`. Строка прилипает под шапкой (и под уже прилипшими строками),
682
+ * когда при прокрутке доходит до них, как `position: sticky`.
683
+ * @group Style
684
+ */
685
+ readonly stickyRows?: readonly number[];
686
+
687
+ /**
688
+ * Controls the drawing of the left hand vertical border of a column. If set to a boolean value it controls all
689
+ * borders.
690
+ * @defaultValue `true`
691
+ * @group Style
692
+ */
693
+ readonly verticalBorder?: DataGridSearchProps["verticalBorder"] | boolean;
694
+
695
+ /**
696
+ * Управление горизонтальной линией сверху строки. Функция `(row) => boolean` — точечно
697
+ * по строкам, boolean — сразу для всех строк тела. Не задано — линии рисуются (как раньше).
698
+ * @defaultValue `true`
699
+ * @group Style
700
+ */
701
+ readonly horizontalBorder?: ((row: number) => boolean) | boolean;
702
+
703
+ /**
704
+ * Настройка рамок отдельных ячеек: стороны top, right, bottom, left,
705
+ * вкл/выкл и цвет. Перекрывает `verticalBorder`, `horizontalBorder` и тему.
706
+ * Если не задано, линии рисуются сплошными без разбивки по ячейкам.
707
+ * row и col приходят в пользовательских индексах, без служебных колонок.
708
+ * @group Style
709
+ */
710
+ readonly getCellBorder?: CellBorderResolver;
711
+
712
+ /**
713
+ * Controls the grouping of rows to be drawn in the grid.
714
+ */
715
+ readonly rowGrouping?: RowGroupingOptions;
716
+
717
+ /**
718
+ * Called when data is pasted into the grid. If left undefined, the `DataEditor` will operate in a
719
+ * fallback mode and attempt to paste the text buffer into the current cell assuming the current cell is not
720
+ * readonly and can accept the data type. If `onPaste` is set to false or the function returns false, the grid will
721
+ * simply ignore paste. If `onPaste` evaluates to true the grid will attempt to split the data by tabs and newlines
722
+ * and paste into available cells.
723
+ *
724
+ * The grid will not attempt to add additional rows if more data is pasted then can fit. In that case it is
725
+ * advisable to simply return false from onPaste and handle the paste manually.
726
+ * @group Editing
727
+ */
728
+ readonly onPaste?: ((target: Item, values: readonly (readonly string[])[]) => boolean) | boolean;
729
+
730
+ /**
731
+ * The theme used by the data grid to get all color and font information
732
+ * @group Style
733
+ */
734
+ readonly theme?: Partial<Theme>;
735
+
736
+ readonly renderers?: readonly InternalCellRenderer<InnerGridCell>[];
737
+
738
+ /**
739
+ * An array of custom renderers which can be used to extend the data grid.
740
+ * @group Advanced
741
+ */
742
+ readonly customRenderers?: readonly CustomRenderer<any>[];
743
+
744
+ /**
745
+ * Scales most elements in the theme to match rem scaling automatically
746
+ * @defaultValue false
747
+ */
748
+ readonly scaleToRem?: boolean;
749
+
750
+ /**
751
+ * Custom predicate function to decide whether the click event occurred outside the grid
752
+ * Especially used when custom editor is opened with the portal and is outside the grid, but there is no possibility
753
+ * to add a class "click-outside-ignore"
754
+ * If this function is supplied and returns false, the click event is ignored
755
+ */
756
+ readonly isOutsideClick?: (e: MouseEvent | TouchEvent) => boolean;
757
+
758
+ /**
759
+ * Controls which directions fill is allowed in.
760
+ */
761
+ readonly allowedFillDirections?: FillHandleDirection;
762
+
763
+ /**
764
+ * Determines when a cell is considered activated and will emit the `onCellActivated` event. Generally an activated
765
+ * cell will open to edit mode.
766
+ */
767
+ readonly cellActivationBehavior?: CellActivationBehavior;
768
+
769
+ /**
770
+ * Controls if focus will trap inside the data grid when doing tab and caret navigation.
771
+ */
772
+ readonly trapFocus?: boolean;
773
+
774
+ /**
775
+ * Allows overriding the default amount of bloom (the size growth of the overlay editor)
776
+ */
777
+ readonly editorBloom?: readonly [number, number];
778
+
779
+ /**
780
+ * If set to true, the data grid will attempt to scroll to keep the selction in view
781
+ */
782
+ readonly scrollToActiveCell?: boolean;
783
+
784
+ readonly drawFocusRing?: boolean | "no-editor";
785
+
786
+ /**
787
+ * Allows overriding the default portal element.
788
+ */
789
+ readonly portalElementRef?: React.RefObject<HTMLElement>;
790
+ }
791
+
792
+ type ScrollToFn = (
793
+ col: number | { amount: number; unit: "cell" | "px" },
794
+ row: number | { amount: number; unit: "cell" | "px" },
795
+ dir?: "horizontal" | "vertical" | "both",
796
+ paddingX?: number,
797
+ paddingY?: number,
798
+ options?: {
799
+ hAlign?: "start" | "center" | "end";
800
+ vAlign?: "start" | "center" | "end";
801
+ behavior?: ScrollBehavior;
802
+ }
803
+ ) => void;
804
+
805
+ /** @category DataEditor */
806
+ export interface DataEditorRef {
807
+ /**
808
+ * Programatically appends a row.
809
+ * @param col The column index to focus in the new row.
810
+ * @returns A promise which waits for the append to complete.
811
+ */
812
+ appendRow: (col: number, openOverlay?: boolean, behavior?: ScrollBehavior) => Promise<void>;
813
+ /**
814
+ * Programatically appends a column.
815
+ * @param row The row index to focus in the new column.
816
+ * @returns A promise which waits for the append to complete.
817
+ */
818
+ appendColumn: (row: number, openOverlay?: boolean) => Promise<void>;
819
+ /**
820
+ * Triggers cells to redraw.
821
+ */
822
+ updateCells: DataGridRef["damage"];
823
+ /**
824
+ * Gets the screen space bounds of the requested item.
825
+ */
826
+ getBounds: DataGridRef["getBounds"];
827
+ /**
828
+ * Triggers the data grid to focus itself or the correct accessibility element.
829
+ */
830
+ focus: DataGridRef["focus"];
831
+ /**
832
+ * Generic API for emitting events as if they had been triggered via user interaction.
833
+ */
834
+ emit: (eventName: EmitEvents) => Promise<void>;
835
+ /**
836
+ * Scrolls to the desired cell or location in the grid.
837
+ */
838
+ scrollTo: ScrollToFn;
839
+ /**
840
+ * Causes the columns in the selection to have their natural size recomputed and re-emitted as a resize event.
841
+ */
842
+ remeasureColumns: (cols: CompactSelection) => void;
843
+ /**
844
+ * Gets the mouse args from pointer event position.
845
+ */
846
+ getMouseArgsForPosition: (
847
+ posX: number,
848
+ posY: number,
849
+ ev?: MouseEvent | TouchEvent
850
+ ) => GridMouseEventArgs | undefined;
851
+ }
852
+
853
+ const loadingCell: GridCell = {
854
+ kind: GridCellKind.Loading,
855
+ allowOverlay: false,
856
+ };
857
+
858
+ export const emptyGridSelection: GridSelection = {
859
+ columns: CompactSelection.empty(),
860
+ rows: CompactSelection.empty(),
861
+ current: undefined,
862
+ };
863
+
864
+ interface IndexRun {
865
+ readonly start: number;
866
+ readonly length: number;
867
+ }
868
+
869
+ /** Склеивает отсортированные индексы в прогоны соседних: [1, 2, 3, 7] → (1, 3), (7, 1). */
870
+ function toRuns(indexes: readonly number[]): IndexRun[] {
871
+ const runs: IndexRun[] = [];
872
+ let start = 0;
873
+ let length = 0;
874
+ for (const index of indexes) {
875
+ if (length > 0 && index === start + length) {
876
+ length++;
877
+ continue;
878
+ }
879
+ if (length > 0) runs.push({ start, length });
880
+ start = index;
881
+ length = 1;
882
+ }
883
+ if (length > 0) runs.push({ start, length });
884
+ return runs;
885
+ }
886
+
887
+ const DataEditorImpl: React.ForwardRefRenderFunction<DataEditorRef, DataEditorProps> = (p, forwardedRef) => {
888
+ const [gridSelectionInner, setGridSelectionInner] = React.useState<GridSelection>(emptyGridSelection);
889
+
890
+ const [overlay, setOverlay] = React.useState<{
891
+ target: Rectangle;
892
+ content: GridCell;
893
+ theme: FullTheme;
894
+ initialValue: string | undefined;
895
+ cell: Item;
896
+ highlight: boolean;
897
+ forceEditMode: boolean;
898
+ activation: CellActivatedEventArgs;
899
+ }>();
900
+ const searchInputRef = React.useRef<HTMLInputElement | null>(null);
901
+ const canvasRef = React.useRef<HTMLCanvasElement | null>(null);
902
+ const [mouseState, setMouseState] = React.useState<MouseState>();
903
+ const lastSent = React.useRef<[number, number] | undefined>(undefined);
904
+
905
+ const safeWindow = typeof window === "undefined" ? null : window;
906
+
907
+ const {
908
+ imageEditorOverride,
909
+ getRowThemeOverride: getRowThemeOverrideIn,
910
+ markdownDivCreateNode,
911
+ width,
912
+ height,
913
+ columns: columnsIn,
914
+ rows: rowsIn,
915
+ getCellContent,
916
+ onCellClicked,
917
+ onCellActivated,
918
+ onFillPattern,
919
+ onFinishedEditing,
920
+ coercePasteValue,
921
+ drawHeader: drawHeaderIn,
922
+ drawGroupHeader: drawGroupHeaderIn,
923
+ drawCell: drawCellIn,
924
+ editorBloom,
925
+ onHeaderClicked,
926
+ onColumnProposeMove,
927
+ rangeSelectionColumnSpanning = true,
928
+ spanRangeBehavior = "default",
929
+ onGroupHeaderClicked,
930
+ onCellContextMenu,
931
+ className,
932
+ onHeaderContextMenu,
933
+ getCellsForSelection: getCellsForSelectionIn,
934
+ onGroupHeaderContextMenu,
935
+ onGroupHeaderRenamed,
936
+ onCellEdited,
937
+ onCellsEdited,
938
+ onSearchResultsChanged: onSearchResultsChangedIn,
939
+ searchResults,
940
+ onSearchValueChange,
941
+ searchValue,
942
+ onKeyDown: onKeyDownIn,
943
+ onKeyUp: onKeyUpIn,
944
+ keybindings: keybindingsIn,
945
+ editOnType = true,
946
+ onRowAppended,
947
+ onColumnAppended,
948
+ onColumnMoved,
949
+ validateCell: validateCellIn,
950
+ highlightRegions: highlightRegionsIn,
951
+ rangeSelect = "rect",
952
+ columnSelect = "multi",
953
+ rowSelect = "multi",
954
+ rangeSelectionBlending = "exclusive",
955
+ columnSelectionBlending = "exclusive",
956
+ rowSelectionBlending = "exclusive",
957
+ onDelete: onDeleteIn,
958
+ onDragStart,
959
+ onMouseMove,
960
+ onPaste,
961
+ copyHeaders = false,
962
+ freezeColumns = 0,
963
+ stickyColumns: stickyColumnsIn,
964
+ stickyRows: stickyRowsIn,
965
+ cellActivationBehavior = "second-click",
966
+ rowSelectionMode = "auto",
967
+ columnSelectionMode = "auto",
968
+ onHeaderMenuClick,
969
+ onHeaderIndicatorClick,
970
+ getGroupDetails,
971
+ spanShallowGroups,
972
+ spanAlign,
973
+ spanGroupHeader,
974
+ hiddenColumnsIndicator,
975
+ onHiddenColumnsIndicatorClicked,
976
+ rowGrouping,
977
+ onSearchClose: onSearchCloseIn,
978
+ onItemHovered,
979
+ onSelectionCleared,
980
+ showSearch: showSearchIn,
981
+ onVisibleRegionChanged,
982
+ gridSelection: gridSelectionOuter,
983
+ onGridSelectionChange,
984
+ minColumnWidth: minColumnWidthIn = 50,
985
+ maxColumnWidth: maxColumnWidthIn = 500,
986
+ maxColumnAutoWidth: maxColumnAutoWidthIn,
987
+ provideEditor,
988
+ trailingRowOptions,
989
+ freezeTrailingRows = 0,
990
+ allowedFillDirections = "orthogonal",
991
+ scrollOffsetX,
992
+ scrollOffsetY,
993
+ verticalBorder,
994
+ horizontalBorder,
995
+ getCellBorder,
996
+ onDragOverCell,
997
+ onDrop,
998
+ onColumnResize: onColumnResizeIn,
999
+ onColumnResizeEnd: onColumnResizeEndIn,
1000
+ onColumnResizeStart: onColumnResizeStartIn,
1001
+ customRenderers: additionalRenderers,
1002
+ fillHandle,
1003
+ experimental,
1004
+ fixedShadowX,
1005
+ fixedShadowY,
1006
+ headerIcons,
1007
+ imageWindowLoader,
1008
+ initialSize,
1009
+ isDraggable,
1010
+ onDragLeave,
1011
+ onRowMoved,
1012
+ overscrollX: overscrollXIn,
1013
+ overscrollY: overscrollYIn,
1014
+ preventDiagonalScrolling,
1015
+ rightElement,
1016
+ rightElementProps,
1017
+ trapFocus = false,
1018
+ smoothScrollX,
1019
+ smoothScrollY,
1020
+ scaleToRem = false,
1021
+ rowHeight: rowHeightIn = 34,
1022
+ headerHeight: headerHeightIn = 36,
1023
+ groupHeaderHeight: groupHeaderHeightIn = headerHeightIn,
1024
+ theme: themeIn,
1025
+ isOutsideClick,
1026
+ renderers,
1027
+ resizeIndicator,
1028
+ resizeIndicatorOnHover,
1029
+ scrollToActiveCell = true,
1030
+ drawFocusRing: drawFocusRingIn = true,
1031
+ portalElementRef,
1032
+ } = p;
1033
+
1034
+ const drawFocusRing = drawFocusRingIn === "no-editor" ? overlay === undefined : drawFocusRingIn;
1035
+ const editorOpen = overlay !== undefined;
1036
+
1037
+ const rowMarkersObj = typeof p.rowMarkers === "string" ? undefined : p.rowMarkers;
1038
+
1039
+ const rowMarkers = rowMarkersObj?.kind ?? (p.rowMarkers as RowMarkerOptions["kind"]) ?? "none";
1040
+ const rowMarkerWidthRaw = rowMarkersObj?.width ?? p.rowMarkerWidth;
1041
+ const rowMarkerStartIndex = rowMarkersObj?.startIndex ?? p.rowMarkerStartIndex ?? 1;
1042
+ const rowMarkerTheme = rowMarkersObj?.theme ?? p.rowMarkerTheme;
1043
+ const headerRowMarkerTheme = rowMarkersObj?.headerTheme;
1044
+ const headerRowMarkerAlwaysVisible = rowMarkersObj?.headerAlwaysVisible;
1045
+ const headerRowMarkerDisabled = rowSelect !== "multi" || rowMarkersObj?.headerDisabled === true;
1046
+ const rowMarkerCheckboxStyle = rowMarkersObj?.checkboxStyle ?? "square";
1047
+
1048
+ const minColumnWidth = Math.max(minColumnWidthIn, 20);
1049
+ const maxColumnWidth = Math.max(maxColumnWidthIn, minColumnWidth);
1050
+ const maxColumnAutoWidth = Math.max(maxColumnAutoWidthIn ?? maxColumnWidth, minColumnWidth);
1051
+
1052
+ const docStyle = React.useMemo(() => {
1053
+ if (typeof window === "undefined") return { fontSize: "16px" };
1054
+ return window.getComputedStyle(document.documentElement);
1055
+ }, []);
1056
+
1057
+ const {
1058
+ rows,
1059
+ rowNumberMapper,
1060
+ rowHeight: rowHeightPostGrouping,
1061
+ getRowThemeOverride,
1062
+ } = useRowGroupingInner(rowGrouping, rowsIn, rowHeightIn, getRowThemeOverrideIn);
1063
+
1064
+ const remSize = React.useMemo(() => Number.parseFloat(docStyle.fontSize), [docStyle]);
1065
+ const { rowHeight, headerHeight, groupHeaderHeight, theme, overscrollX, overscrollY } = useRemAdjuster({
1066
+ groupHeaderHeight: groupHeaderHeightIn,
1067
+ headerHeight: headerHeightIn,
1068
+ overscrollX: overscrollXIn,
1069
+ overscrollY: overscrollYIn,
1070
+ remSize,
1071
+ rowHeight: rowHeightPostGrouping,
1072
+ scaleToRem,
1073
+ theme: themeIn,
1074
+ });
1075
+
1076
+ const keybindings = useKeybindingsWithDefaults(keybindingsIn);
1077
+
1078
+ const rowMarkerWidth = rowMarkerWidthRaw ?? (rowsIn > 10_000 ? 48 : rowsIn > 1000 ? 44 : rowsIn > 100 ? 36 : 32);
1079
+ const hasRowMarkers = rowMarkers !== "none";
1080
+ const rowMarkerOffset = hasRowMarkers ? 1 : 0;
1081
+
1082
+ const stickyColumns = React.useMemo(
1083
+ () => normalizeStickyIndexes(stickyColumnsIn, columnsIn.length, rowMarkerOffset),
1084
+ [stickyColumnsIn, columnsIn.length, rowMarkerOffset]
1085
+ );
1086
+ const stickyRows = React.useMemo(() => normalizeStickyIndexes(stickyRowsIn, rows), [stickyRowsIn, rows]);
1087
+ const showTrailingBlankRow = trailingRowOptions !== undefined;
1088
+ const lastRowSticky = trailingRowOptions?.sticky === true;
1089
+
1090
+ const [showSearchInner, setShowSearchInner] = React.useState(false);
1091
+ const showSearch = showSearchIn ?? showSearchInner;
1092
+
1093
+ const onSearchClose = React.useCallback(() => {
1094
+ if (onSearchCloseIn !== undefined) {
1095
+ onSearchCloseIn();
1096
+ } else {
1097
+ setShowSearchInner(false);
1098
+ }
1099
+ }, [onSearchCloseIn]);
1100
+
1101
+ const gridSelectionOuterMangled: GridSelection | undefined = React.useMemo((): GridSelection | undefined => {
1102
+ return gridSelectionOuter === undefined ? undefined : shiftSelection(gridSelectionOuter, rowMarkerOffset);
1103
+ }, [gridSelectionOuter, rowMarkerOffset]);
1104
+ const gridSelection = gridSelectionOuterMangled ?? gridSelectionInner;
1105
+
1106
+ const abortControllerRef = React.useRef<AbortController | undefined>(undefined) as React.MutableRefObject<AbortController>;
1107
+ if (abortControllerRef.current === undefined) abortControllerRef.current = new AbortController();
1108
+
1109
+ React.useEffect(() => () => abortControllerRef?.current.abort(), []);
1110
+
1111
+ const [getCellsForSelection, getCellsForSeletionDirect] = useCellsForSelection(
1112
+ getCellsForSelectionIn,
1113
+ getCellContent,
1114
+ rowMarkerOffset,
1115
+ abortControllerRef.current,
1116
+ rows
1117
+ );
1118
+
1119
+ const validateCell = React.useCallback<NonNullable<typeof validateCellIn>>(
1120
+ (cell, newValue, prevValue) => {
1121
+ if (validateCellIn === undefined) return true;
1122
+ const item: Item = [cell[0] - rowMarkerOffset, cell[1]];
1123
+ return validateCellIn?.(item, newValue, prevValue);
1124
+ },
1125
+ [rowMarkerOffset, validateCellIn]
1126
+ );
1127
+
1128
+ const expectedExternalGridSelection = React.useRef<GridSelection | undefined>(gridSelectionOuter);
1129
+ const setGridSelection = React.useCallback(
1130
+ (newVal: GridSelection, expand: boolean): void => {
1131
+ if (expand) {
1132
+ newVal = expandSelection(
1133
+ newVal,
1134
+ getCellsForSelection,
1135
+ rowMarkerOffset,
1136
+ spanRangeBehavior,
1137
+ abortControllerRef.current
1138
+ );
1139
+ }
1140
+ if (onGridSelectionChange !== undefined) {
1141
+ expectedExternalGridSelection.current = shiftSelection(newVal, -rowMarkerOffset);
1142
+ onGridSelectionChange(expectedExternalGridSelection.current);
1143
+ } else {
1144
+ setGridSelectionInner(newVal);
1145
+ }
1146
+ },
1147
+ [onGridSelectionChange, getCellsForSelection, rowMarkerOffset, spanRangeBehavior]
1148
+ );
1149
+
1150
+
1151
+ const onColumnResize = whenDefined(
1152
+ onColumnResizeIn,
1153
+ React.useCallback<NonNullable<typeof onColumnResizeIn>>(
1154
+ (_, w, ind, wg) => {
1155
+ onColumnResizeIn?.(columnsIn[ind - rowMarkerOffset], w, ind - rowMarkerOffset, wg);
1156
+ },
1157
+ [onColumnResizeIn, rowMarkerOffset, columnsIn]
1158
+ )
1159
+ );
1160
+
1161
+ const onColumnResizeEnd = whenDefined(
1162
+ onColumnResizeEndIn,
1163
+ React.useCallback<NonNullable<typeof onColumnResizeEndIn>>(
1164
+ (_, w, ind, wg) => {
1165
+ onColumnResizeEndIn?.(columnsIn[ind - rowMarkerOffset], w, ind - rowMarkerOffset, wg);
1166
+ },
1167
+ [onColumnResizeEndIn, rowMarkerOffset, columnsIn]
1168
+ )
1169
+ );
1170
+
1171
+ const onColumnResizeStart = whenDefined(
1172
+ onColumnResizeStartIn,
1173
+ React.useCallback<NonNullable<typeof onColumnResizeStartIn>>(
1174
+ (_, w, ind, wg) => {
1175
+ onColumnResizeStartIn?.(columnsIn[ind - rowMarkerOffset], w, ind - rowMarkerOffset, wg);
1176
+ },
1177
+ [onColumnResizeStartIn, rowMarkerOffset, columnsIn]
1178
+ )
1179
+ );
1180
+
1181
+ const drawHeader = whenDefined(
1182
+ drawHeaderIn,
1183
+ React.useCallback<NonNullable<typeof drawHeaderIn>>(
1184
+ (args, draw) => {
1185
+ return drawHeaderIn?.({ ...args, columnIndex: args.columnIndex - rowMarkerOffset }, draw) ?? false;
1186
+ },
1187
+ [drawHeaderIn, rowMarkerOffset]
1188
+ )
1189
+ );
1190
+
1191
+ const drawCell = whenDefined(
1192
+ drawCellIn,
1193
+ React.useCallback<NonNullable<typeof drawCellIn>>(
1194
+ (args, draw) => {
1195
+ return drawCellIn?.({ ...args, col: args.col - rowMarkerOffset }, draw) ?? false;
1196
+ },
1197
+ [drawCellIn, rowMarkerOffset]
1198
+ )
1199
+ );
1200
+
1201
+ const onDelete = React.useCallback<NonNullable<DataEditorProps["onDelete"]>>(
1202
+ sel => {
1203
+ if (onDeleteIn !== undefined) {
1204
+ const result = onDeleteIn(shiftSelection(sel, -rowMarkerOffset));
1205
+ if (typeof result === "boolean") {
1206
+ return result;
1207
+ }
1208
+ return shiftSelection(result, rowMarkerOffset);
1209
+ }
1210
+ return true;
1211
+ },
1212
+ [onDeleteIn, rowMarkerOffset]
1213
+ );
1214
+
1215
+ const [setCurrent, setSelectedRows, setSelectedColumns] = useSelectionBehavior(
1216
+ gridSelection,
1217
+ setGridSelection,
1218
+ rangeSelectionBlending,
1219
+ columnSelectionBlending,
1220
+ rowSelectionBlending,
1221
+ rangeSelect,
1222
+ rangeSelectionColumnSpanning
1223
+ );
1224
+
1225
+ const mergedTheme = React.useMemo(() => {
1226
+ return mergeAndRealizeTheme(getDataEditorTheme(), theme);
1227
+ }, [theme]);
1228
+
1229
+ const [clientSize, setClientSize] = React.useState<readonly [number, number, number]>([0, 0, 0]);
1230
+
1231
+ const rendererMap = React.useMemo(() => {
1232
+ if (renderers === undefined) return {};
1233
+ const result: Partial<Record<InnerGridCellKind | GridCellKind, InternalCellRenderer<InnerGridCell>>> = {};
1234
+ for (const r of renderers) {
1235
+ result[r.kind] = r;
1236
+ }
1237
+ return result;
1238
+ }, [renderers]);
1239
+
1240
+ const getCellRenderer: <T extends InnerGridCell>(cell: T) => CellRenderer<T> | undefined = React.useCallback(
1241
+ <T extends InnerGridCell>(cell: T) => {
1242
+ if (cell.kind !== GridCellKind.Custom) {
1243
+ return rendererMap[cell.kind] as unknown as CellRenderer<T>;
1244
+ }
1245
+ return additionalRenderers?.find(x => x.isMatch(cell)) as CellRenderer<T>;
1246
+ },
1247
+ [additionalRenderers, rendererMap]
1248
+ );
1249
+
1250
+ // eslint-disable-next-line prefer-const
1251
+ let { sizedColumns: columns, nonGrowWidth } = useColumnSizer(
1252
+ columnsIn,
1253
+ rows,
1254
+ getCellsForSeletionDirect,
1255
+ clientSize[0] - (rowMarkerOffset === 0 ? 0 : rowMarkerWidth) - clientSize[2],
1256
+ minColumnWidth,
1257
+ maxColumnAutoWidth,
1258
+ mergedTheme,
1259
+ getCellRenderer,
1260
+ abortControllerRef.current
1261
+ );
1262
+ if (rowMarkers !== "none") nonGrowWidth += rowMarkerWidth;
1263
+
1264
+ const enableGroups = React.useMemo(() => {
1265
+ return columns.some(c => c.group !== undefined);
1266
+ }, [columns]);
1267
+
1268
+ const groupHeights = enableGroups
1269
+ ? Array.isArray(groupHeaderHeight)
1270
+ ? groupHeaderHeight.reduce((sum, h) => sum + h, 0)
1271
+ : groupHeaderHeight
1272
+ : 0;
1273
+ const totalHeaderHeight = headerHeight + groupHeights;
1274
+
1275
+ const numSelectedRows = gridSelection.rows.length;
1276
+ const rowMarkerChecked =
1277
+ rowMarkers === "none" ? undefined : numSelectedRows === 0 ? false : numSelectedRows === rows ? true : undefined;
1278
+
1279
+ const mangledCols = React.useMemo(() => {
1280
+ if (rowMarkers === "none") return columns;
1281
+ return [
1282
+ {
1283
+ title: "",
1284
+ width: rowMarkerWidth,
1285
+ icon: undefined,
1286
+ hasMenu: false,
1287
+ style: "normal" as const,
1288
+ themeOverride: rowMarkerTheme,
1289
+ rowMarker: rowMarkerCheckboxStyle,
1290
+ rowMarkerChecked,
1291
+ headerRowMarkerTheme,
1292
+ headerRowMarkerAlwaysVisible,
1293
+ headerRowMarkerDisabled,
1294
+ },
1295
+ ...columns,
1296
+ ];
1297
+ }, [
1298
+ rowMarkers,
1299
+ columns,
1300
+ rowMarkerWidth,
1301
+ rowMarkerTheme,
1302
+ rowMarkerCheckboxStyle,
1303
+ rowMarkerChecked,
1304
+ headerRowMarkerTheme,
1305
+ headerRowMarkerAlwaysVisible,
1306
+ headerRowMarkerDisabled,
1307
+ ]);
1308
+
1309
+ const visibleRegionRef = React.useRef<VisibleRegion>({
1310
+ height: 1,
1311
+ width: 1,
1312
+ x: 0,
1313
+ y: 0,
1314
+ });
1315
+
1316
+ const hasJustScrolled = React.useRef(false);
1317
+
1318
+ const { setVisibleRegion, visibleRegion, scrollRef } = useInitialScrollOffset(
1319
+ scrollOffsetX,
1320
+ scrollOffsetY,
1321
+ rowHeight,
1322
+ visibleRegionRef,
1323
+ () => (hasJustScrolled.current = true)
1324
+ );
1325
+
1326
+ visibleRegionRef.current = visibleRegion;
1327
+
1328
+ const cellXOffset = visibleRegion.x + rowMarkerOffset;
1329
+ const cellYOffset = visibleRegion.y;
1330
+
1331
+ const gridRef = React.useRef<DataGridRef | null>(null);
1332
+
1333
+ const focus = React.useCallback((immediate?: boolean) => {
1334
+ if (immediate === true) {
1335
+ gridRef.current?.focus();
1336
+ } else {
1337
+ window.requestAnimationFrame(() => {
1338
+ gridRef.current?.focus();
1339
+ });
1340
+ }
1341
+ }, []);
1342
+
1343
+ const mangledRows = showTrailingBlankRow ? rows + 1 : rows;
1344
+
1345
+ const mangledOnCellsEdited = React.useCallback<NonNullable<typeof onCellsEdited>>(
1346
+ (items: readonly EditListItem[]) => {
1347
+ const mangledItems =
1348
+ rowMarkerOffset === 0
1349
+ ? items
1350
+ : items.map(x => ({
1351
+ ...x,
1352
+ location: [x.location[0] - rowMarkerOffset, x.location[1]] as const,
1353
+ }));
1354
+ const r = onCellsEdited?.(mangledItems);
1355
+
1356
+ if (r !== true) {
1357
+ for (const i of mangledItems) onCellEdited?.(i.location, i.value);
1358
+ }
1359
+
1360
+ return r;
1361
+ },
1362
+ [onCellEdited, onCellsEdited, rowMarkerOffset]
1363
+ );
1364
+
1365
+ const [fillHighlightRegion, setFillHighlightRegion] = React.useState<Rectangle | undefined>();
1366
+
1367
+ // this will generally be undefined triggering the memo less often
1368
+ const selectionCurrent = gridSelection.current;
1369
+ // Под редактором без рамки фокуса блок, растянутый выделением, не обводим, как и
1370
+ // не заливаем (getFillSelection): так он выглядит как одиночная ячейка.
1371
+ const highlightRange =
1372
+ selectionCurrent !== undefined &&
1373
+ selectionCurrent.range.width * selectionCurrent.range.height > 1 &&
1374
+ !(editorOpen && !drawFocusRing && rangeIsFocusBlock(selectionCurrent, rows, getCellContent, rowMarkerOffset))
1375
+ ? selectionCurrent.range
1376
+ : undefined;
1377
+
1378
+ const highlightFocus = drawFocusRing ? gridSelection.current?.cell : undefined;
1379
+ const highlightFocusCol = highlightFocus?.[0];
1380
+ const highlightFocusRow = highlightFocus?.[1];
1381
+
1382
+ const highlightRegions = React.useMemo(() => {
1383
+ if (
1384
+ (highlightRegionsIn === undefined || highlightRegionsIn.length === 0) &&
1385
+ (highlightRange ?? highlightFocusCol ?? highlightFocusRow ?? fillHighlightRegion) === undefined
1386
+ )
1387
+ return undefined;
1388
+
1389
+ const regions: Highlight[] = [];
1390
+
1391
+ if (highlightRegionsIn !== undefined) {
1392
+ for (const r of highlightRegionsIn) {
1393
+ const maxWidth = mangledCols.length - r.range.x - rowMarkerOffset;
1394
+ if (maxWidth > 0) {
1395
+ regions.push({
1396
+ color: r.color,
1397
+ range: {
1398
+ ...r.range,
1399
+ x: r.range.x + rowMarkerOffset,
1400
+ width: Math.min(maxWidth, r.range.width),
1401
+ },
1402
+ style: r.style,
1403
+ drawAboveSelection: r.drawAboveSelection,
1404
+ });
1405
+ }
1406
+ }
1407
+ }
1408
+
1409
+ if (fillHighlightRegion !== undefined) {
1410
+ regions.push({
1411
+ color: withAlpha(mergedTheme.accentColor, 0),
1412
+ range: fillHighlightRegion,
1413
+ style: "dashed",
1414
+ });
1415
+ }
1416
+
1417
+ if (highlightRange !== undefined) {
1418
+ regions.push({
1419
+ color: withAlpha(mergedTheme.accentColor, 0.5),
1420
+ range: highlightRange,
1421
+ style: "solid-outline",
1422
+ });
1423
+ }
1424
+
1425
+ if (highlightFocusCol !== undefined && highlightFocusRow !== undefined) {
1426
+ // Объединённая ячейка (span/spanRows): рамку фокуса рисуем на весь блок,
1427
+ // а не на одну ячейку. Само выделение (current.cell) не трогаем — это
1428
+ // только рамка. span у ячейки считается без служебных колонок, поэтому
1429
+ // добавляем rowMarkerOffset; spanRows — это индексы строк, смещение не нужно.
1430
+ let fx = highlightFocusCol;
1431
+ let fy = highlightFocusRow;
1432
+ let fw = 1;
1433
+ let fh = 1;
1434
+ const focusDataCol = highlightFocusCol - rowMarkerOffset;
1435
+ if (highlightFocusRow >= 0 && highlightFocusRow < rows && focusDataCol >= 0) {
1436
+ const focusCell = getCellContent([focusDataCol, highlightFocusRow]);
1437
+ if (focusCell.span !== undefined) {
1438
+ fx = focusCell.span[0] + rowMarkerOffset;
1439
+ fw = focusCell.span[1] - focusCell.span[0] + 1;
1440
+ }
1441
+ if (focusCell.spanRows !== undefined) {
1442
+ fy = focusCell.spanRows[0];
1443
+ fh = focusCell.spanRows[1] - focusCell.spanRows[0] + 1;
1444
+ }
1445
+ }
1446
+ regions.push({
1447
+ color: mergedTheme.accentColor,
1448
+ range: { x: fx, y: fy, width: fw, height: fh },
1449
+ style: "solid-outline",
1450
+ });
1451
+ }
1452
+
1453
+ return regions.length > 0 ? regions : undefined;
1454
+ }, [
1455
+ fillHighlightRegion,
1456
+ highlightRange,
1457
+ highlightFocusCol,
1458
+ highlightFocusRow,
1459
+ highlightRegionsIn,
1460
+ mangledCols.length,
1461
+ mergedTheme.accentColor,
1462
+ rowMarkerOffset,
1463
+ getCellContent,
1464
+ rows,
1465
+ ]);
1466
+
1467
+ const mangledColsRef = React.useRef(mangledCols);
1468
+ mangledColsRef.current = mangledCols;
1469
+ const getMangledCellContent = React.useCallback(
1470
+ ([col, row]: Item, forceStrict: boolean = false): InnerGridCell => {
1471
+ const isTrailing = showTrailingBlankRow && row === mangledRows - 1;
1472
+ const isRowMarkerCol = col === 0 && hasRowMarkers;
1473
+ if (isRowMarkerCol) {
1474
+ if (isTrailing) {
1475
+ return loadingCell;
1476
+ }
1477
+ const mappedRow = rowNumberMapper(row);
1478
+ if (mappedRow === undefined) return loadingCell;
1479
+ return {
1480
+ kind: InnerGridCellKind.Marker,
1481
+ allowOverlay: false,
1482
+ checkboxStyle: rowMarkerCheckboxStyle,
1483
+ checked: gridSelection?.rows.hasIndex(row) === true,
1484
+ markerKind: rowMarkers === "clickable-number" ? "number" : rowMarkers,
1485
+ row: rowMarkerStartIndex + mappedRow,
1486
+ drawHandle: onRowMoved !== undefined,
1487
+ cursor: rowMarkers === "clickable-number" ? "pointer" : undefined,
1488
+ };
1489
+ } else if (isTrailing) {
1490
+ //If the grid is empty, we will return text
1491
+ const isFirst = col === rowMarkerOffset;
1492
+
1493
+ const maybeFirstColumnHint = isFirst ? (trailingRowOptions?.hint ?? "") : "";
1494
+ const c = mangledColsRef.current[col];
1495
+
1496
+ if (c?.trailingRowOptions?.disabled === true) {
1497
+ return loadingCell;
1498
+ } else {
1499
+ const hint = c?.trailingRowOptions?.hint ?? maybeFirstColumnHint;
1500
+ const icon = c?.trailingRowOptions?.addIcon ?? trailingRowOptions?.addIcon;
1501
+ return {
1502
+ kind: InnerGridCellKind.NewRow,
1503
+ hint,
1504
+ allowOverlay: false,
1505
+ icon,
1506
+ };
1507
+ }
1508
+ } else {
1509
+ const outerCol = col - rowMarkerOffset;
1510
+ if (forceStrict || experimental?.strict === true) {
1511
+ const vr = visibleRegionRef.current;
1512
+ const isOutsideMainArea =
1513
+ vr.x > outerCol ||
1514
+ outerCol > vr.x + vr.width ||
1515
+ vr.y > row ||
1516
+ row > vr.y + vr.height ||
1517
+ row >= rowsRef.current;
1518
+ const isSelected = outerCol === vr.extras?.selected?.[0] && row === vr.extras?.selected[1];
1519
+ let isInFreezeArea = false;
1520
+ if (vr.extras?.freezeRegions !== undefined) {
1521
+ for (const fr of vr.extras.freezeRegions) {
1522
+ if (pointInRect(fr, outerCol, row)) {
1523
+ isInFreezeArea = true;
1524
+ break;
1525
+ }
1526
+ }
1527
+ }
1528
+
1529
+ if (isOutsideMainArea && !isSelected && !isInFreezeArea) {
1530
+ return loadingCell;
1531
+ }
1532
+ }
1533
+ let result = getCellContent([outerCol, row]);
1534
+ if (rowMarkerOffset !== 0 && result.span !== undefined) {
1535
+ result = {
1536
+ ...result,
1537
+ span: [result.span[0] + rowMarkerOffset, result.span[1] + rowMarkerOffset],
1538
+ };
1539
+ }
1540
+ return result;
1541
+ }
1542
+ },
1543
+ [
1544
+ showTrailingBlankRow,
1545
+ mangledRows,
1546
+ hasRowMarkers,
1547
+ rowNumberMapper,
1548
+ rowMarkerCheckboxStyle,
1549
+ gridSelection?.rows,
1550
+ rowMarkers,
1551
+ rowMarkerStartIndex,
1552
+ onRowMoved,
1553
+ rowMarkerOffset,
1554
+ trailingRowOptions?.hint,
1555
+ trailingRowOptions?.addIcon,
1556
+ experimental?.strict,
1557
+ getCellContent,
1558
+ ]
1559
+ );
1560
+
1561
+ // Правка данных может пересобрать объединённые блоки: значение ячейки стало
1562
+ // равно соседнему, блок вырос, а выделенный диапазон остался старым — блок
1563
+ // рисуется выделенным частично. Поэтому при смене данных расширяем диапазон
1564
+ // до границ блока фокус-ячейки (только расширяем, как клик; повторный прогон
1565
+ // ничего не меняет, цикла нет). span тут уже со смещением служебных колонок.
1566
+ React.useEffect(() => {
1567
+ if (spanRangeBehavior === "allowPartial") return;
1568
+ const sel = gridSelection.current;
1569
+ if (sel === undefined) return;
1570
+ const [col, row] = sel.cell;
1571
+ if (col < rowMarkerOffset || row < 0 || row >= rows) return;
1572
+ const content = getMangledCellContent([col, row]);
1573
+ const span = "span" in content ? content.span : undefined;
1574
+ const spanRows = "spanRows" in content ? content.spanRows : undefined;
1575
+ if (span === undefined && spanRows === undefined) return;
1576
+ const blockLeft = span === undefined ? col : span[0];
1577
+ const blockRight = span === undefined ? col : span[1];
1578
+ const blockTop = spanRows === undefined ? row : spanRows[0];
1579
+ const blockBottom = spanRows === undefined ? row : spanRows[1];
1580
+ const r = sel.range;
1581
+ const left = Math.min(r.x, blockLeft);
1582
+ const top = Math.min(r.y, blockTop);
1583
+ const right = Math.max(r.x + r.width - 1, blockRight);
1584
+ const bottom = Math.max(r.y + r.height - 1, blockBottom);
1585
+ if (left === r.x && top === r.y && right === r.x + r.width - 1 && bottom === r.y + r.height - 1) {
1586
+ return;
1587
+ }
1588
+ setGridSelection(
1589
+ {
1590
+ ...gridSelection,
1591
+ current: {
1592
+ ...sel,
1593
+ range: { x: left, y: top, width: right - left + 1, height: bottom - top + 1 },
1594
+ },
1595
+ },
1596
+ false
1597
+ );
1598
+ }, [getMangledCellContent, gridSelection, rows, rowMarkerOffset, spanRangeBehavior, setGridSelection]);
1599
+
1600
+ const mangledGetGroupDetails = React.useCallback<NonNullable<DataEditorProps["getGroupDetails"]>>(
1601
+ group => {
1602
+ const base = getGroupDetails?.(group) ?? { name: group };
1603
+ // Авто-режим: spanShallowGroups включает слияние для всех мелких групп, если у
1604
+ // конкретной группы span не задан явно (span: false точечно отключает авто).
1605
+ let result = {
1606
+ ...base,
1607
+ span: base.span ?? spanShallowGroups,
1608
+ // Значение группы важнее общего spanAlign.
1609
+ spanAlign: base.spanAlign ?? spanAlign,
1610
+ };
1611
+ if (onGroupHeaderRenamed !== undefined && group !== "") {
1612
+ result = {
1613
+ icon: result.icon,
1614
+ name: result.name,
1615
+ overrideTheme: result.overrideTheme,
1616
+ span: result.span,
1617
+ spanAlign: result.spanAlign,
1618
+ actions: [
1619
+ ...(result.actions ?? []),
1620
+ {
1621
+ title: "Rename",
1622
+ icon: "renameIcon",
1623
+ onClick: e =>
1624
+ setRenameGroup({
1625
+ group: result.name,
1626
+ bounds: e.bounds,
1627
+ }),
1628
+ },
1629
+ ],
1630
+ };
1631
+ }
1632
+ return result;
1633
+ },
1634
+ [getGroupDetails, onGroupHeaderRenamed, spanShallowGroups, spanAlign]
1635
+ );
1636
+
1637
+ const setOverlaySimple = React.useCallback(
1638
+ (val: Omit<NonNullable<typeof overlay>, "theme">) => {
1639
+ const [col, row] = val.cell;
1640
+ const column = mangledCols[col];
1641
+ const groupName =
1642
+ column?.group !== undefined
1643
+ ? Array.isArray(column.group)
1644
+ ? (column.group[0] ?? "")
1645
+ : column.group
1646
+ : "";
1647
+ const groupTheme = groupName !== "" ? mangledGetGroupDetails(groupName)?.overrideTheme : undefined;
1648
+ const colTheme = column?.themeOverride;
1649
+ const rowTheme = getRowThemeOverride?.(row);
1650
+
1651
+ // Объединённая ячейка: редактор размером с главную ячейку. В блоке в несколько
1652
+ // строк он стоит по вертикали блока (spanAlign.vertical) внутри нарисованного
1653
+ // содержимого, при прилипании это видимая часть блока.
1654
+ let target = val.target;
1655
+ const { span, spanRows, spanAlign: blockSpanAlign } = val.content;
1656
+ const cellBounds =
1657
+ span !== undefined || spanRows !== undefined ? gridRef.current?.getBounds(col, row) : undefined;
1658
+ if (cellBounds !== undefined) {
1659
+ target = cellBounds;
1660
+ const content =
1661
+ spanRows !== undefined && spanRows[1] > spanRows[0]
1662
+ ? gridRef.current?.getContentBounds(col, row)
1663
+ : undefined;
1664
+ if (content !== undefined && spanRows !== undefined) {
1665
+ const editorHeight = Math.min(cellBounds.height, content.height);
1666
+ const y = getSpanEditorPosition(
1667
+ content,
1668
+ editorHeight,
1669
+ blockSpanAlign?.vertical ?? "center",
1670
+ gridRef.current?.getScrollBodyBounds(spanRows)
1671
+ );
1672
+ target = { ...cellBounds, y, height: editorHeight };
1673
+ }
1674
+ }
1675
+
1676
+ setOverlay({
1677
+ ...val,
1678
+ target,
1679
+ theme: mergeAndRealizeTheme(mergedTheme, groupTheme, colTheme, rowTheme, val.content.themeOverride),
1680
+ });
1681
+ },
1682
+ [getRowThemeOverride, mangledCols, mangledGetGroupDetails, mergedTheme]
1683
+ );
1684
+
1685
+ const reselect = React.useCallback(
1686
+ (bounds: Rectangle, activation: CellActivatedEventArgs, initialValue?: string) => {
1687
+ if (gridSelection.current === undefined) return;
1688
+
1689
+ const [col, row] = gridSelection.current.cell;
1690
+ const c = getMangledCellContent([col, row]);
1691
+ if (c.kind !== GridCellKind.Boolean && c.allowOverlay) {
1692
+ let content = c;
1693
+ if (initialValue !== undefined) {
1694
+ switch (content.kind) {
1695
+ case GridCellKind.Number: {
1696
+ const d = maybe(() => (initialValue === "-" ? -0 : Number.parseFloat(initialValue)), 0);
1697
+ content = {
1698
+ ...content,
1699
+ data: Number.isNaN(d) ? 0 : d,
1700
+ };
1701
+ break;
1702
+ }
1703
+ case GridCellKind.Text:
1704
+ case GridCellKind.Markdown:
1705
+ case GridCellKind.Uri:
1706
+ content = {
1707
+ ...content,
1708
+ data: initialValue,
1709
+ };
1710
+ break;
1711
+ }
1712
+ }
1713
+
1714
+ setOverlaySimple({
1715
+ target: bounds,
1716
+ content,
1717
+ initialValue,
1718
+ cell: [col, row],
1719
+ highlight: initialValue === undefined,
1720
+ forceEditMode: initialValue !== undefined,
1721
+ activation,
1722
+ });
1723
+ } else if (c.kind === GridCellKind.Boolean && activation.inputType === "keyboard" && c.readonly !== true) {
1724
+ mangledOnCellsEdited([
1725
+ {
1726
+ location: gridSelection.current.cell,
1727
+ value: {
1728
+ ...c,
1729
+ data: toggleBoolean(c.data),
1730
+ },
1731
+ },
1732
+ ]);
1733
+ gridRef.current?.damage([{ cell: gridSelection.current.cell }]);
1734
+ }
1735
+ },
1736
+ [getMangledCellContent, gridSelection, mangledOnCellsEdited, setOverlaySimple]
1737
+ );
1738
+
1739
+ const focusOnRowFromTrailingBlankRow = React.useCallback(
1740
+ (col: number, row: number) => {
1741
+ const bounds = gridRef.current?.getBounds(col, row);
1742
+ if (bounds === undefined || scrollRef.current === null) {
1743
+ return;
1744
+ }
1745
+
1746
+ const content = getMangledCellContent([col, row]);
1747
+ if (!content.allowOverlay) {
1748
+ return;
1749
+ }
1750
+
1751
+ setOverlaySimple({
1752
+ target: bounds,
1753
+ content,
1754
+ initialValue: undefined,
1755
+ highlight: true,
1756
+ cell: [col, row],
1757
+ forceEditMode: true,
1758
+ activation: { inputType: "keyboard", key: "Enter" },
1759
+ });
1760
+ },
1761
+ [getMangledCellContent, scrollRef, setOverlaySimple]
1762
+ );
1763
+
1764
+ const scrollTo = React.useCallback<ScrollToFn>(
1765
+ (col, row, dir = "both", paddingX = 0, paddingY = 0, options = undefined): void => {
1766
+ if (scrollRef.current !== null) {
1767
+ const grid = gridRef.current;
1768
+ const canvas = canvasRef.current;
1769
+
1770
+ const trueCol = typeof col !== "number" ? (col.unit === "cell" ? col.amount : undefined) : col;
1771
+ const trueRow = typeof row !== "number" ? (row.unit === "cell" ? row.amount : undefined) : row;
1772
+ const desiredX = typeof col !== "number" && col.unit === "px" ? col.amount : undefined;
1773
+ const desiredY = typeof row !== "number" && row.unit === "px" ? row.amount : undefined;
1774
+ if (grid !== null && canvas !== null) {
1775
+ let targetRect: Rectangle = {
1776
+ x: 0,
1777
+ y: 0,
1778
+ width: 0,
1779
+ height: 0,
1780
+ };
1781
+
1782
+ let scrollX = 0;
1783
+ let scrollY = 0;
1784
+
1785
+ if (trueCol !== undefined || trueRow !== undefined) {
1786
+ targetRect = grid.getBounds((trueCol ?? 0) + rowMarkerOffset, trueRow ?? 0) ?? targetRect;
1787
+ if (targetRect.width === 0 || targetRect.height === 0) return;
1788
+ }
1789
+
1790
+ const scrollBounds = canvas.getBoundingClientRect();
1791
+ const scale = scrollBounds.width / canvas.offsetWidth;
1792
+
1793
+ if (desiredX !== undefined) {
1794
+ targetRect = {
1795
+ ...targetRect,
1796
+ x: desiredX - scrollBounds.left - scrollRef.current.scrollLeft,
1797
+ width: 1,
1798
+ };
1799
+ }
1800
+ if (desiredY !== undefined) {
1801
+ targetRect = {
1802
+ ...targetRect,
1803
+ y: desiredY + scrollBounds.top - scrollRef.current.scrollTop,
1804
+ height: 1,
1805
+ };
1806
+ }
1807
+
1808
+ if (targetRect !== undefined) {
1809
+ const bounds = {
1810
+ x: targetRect.x - paddingX,
1811
+ y: targetRect.y - paddingY,
1812
+ width: targetRect.width + 2 * paddingX,
1813
+ height: targetRect.height + 2 * paddingY,
1814
+ };
1815
+
1816
+ let frozenWidth = 0;
1817
+ for (let i = 0; i < freezeColumns; i++) {
1818
+ frozenWidth += columns[i].width;
1819
+ }
1820
+ // Когда цель встанет у края, все липкие левее и выше неё уже прилипнут:
1821
+ // безопасное окно начинается за ними (сама цель займёт следующий слот).
1822
+ if (stickyColumns !== undefined && trueCol !== undefined) {
1823
+ for (const stickyGridColumn of stickyColumns) {
1824
+ const stickyColumn = stickyGridColumn - rowMarkerOffset;
1825
+ if (stickyColumn >= trueCol) break;
1826
+ if (stickyColumn >= freezeColumns) frozenWidth += columns[stickyColumn].width;
1827
+ }
1828
+ }
1829
+ let stickyRowsHeight = 0;
1830
+ if (stickyRows !== undefined && trueRow !== undefined) {
1831
+ for (const stickyRow of stickyRows) {
1832
+ if (stickyRow >= trueRow) break;
1833
+ stickyRowsHeight += typeof rowHeight === "number" ? rowHeight : rowHeight(stickyRow);
1834
+ }
1835
+ }
1836
+ let trailingRowHeight = 0;
1837
+ const freezeTrailingRowsEffective = freezeTrailingRows + (lastRowSticky ? 1 : 0);
1838
+ if (freezeTrailingRowsEffective > 0) {
1839
+ trailingRowHeight = getFreezeTrailingHeight(
1840
+ mangledRows,
1841
+ freezeTrailingRowsEffective,
1842
+ rowHeight
1843
+ );
1844
+ }
1845
+
1846
+ // scrollBounds is already scaled
1847
+ let sLeft = frozenWidth * scale + scrollBounds.left + rowMarkerOffset * rowMarkerWidth * scale;
1848
+ let sRight = scrollBounds.right;
1849
+ let sTop = scrollBounds.top + (totalHeaderHeight + stickyRowsHeight) * scale;
1850
+ let sBottom = scrollBounds.bottom - trailingRowHeight * scale;
1851
+
1852
+ const minx = targetRect.width + paddingX * 2;
1853
+ switch (options?.hAlign) {
1854
+ case "start":
1855
+ sRight = sLeft + minx;
1856
+ break;
1857
+ case "end":
1858
+ sLeft = sRight - minx;
1859
+ break;
1860
+ case "center":
1861
+ sLeft = Math.floor((sLeft + sRight) / 2) - minx / 2;
1862
+ sRight = sLeft + minx;
1863
+ break;
1864
+ }
1865
+
1866
+ const miny = targetRect.height + paddingY * 2;
1867
+ switch (options?.vAlign) {
1868
+ case "start":
1869
+ sBottom = sTop + miny;
1870
+ break;
1871
+ case "end":
1872
+ sTop = sBottom - miny;
1873
+ break;
1874
+ case "center":
1875
+ sTop = Math.floor((sTop + sBottom) / 2) - miny / 2;
1876
+ sBottom = sTop + miny;
1877
+ break;
1878
+ }
1879
+
1880
+ if (sLeft > bounds.x) {
1881
+ scrollX = bounds.x - sLeft;
1882
+ } else if (sRight < bounds.x + bounds.width) {
1883
+ scrollX = bounds.x + bounds.width - sRight;
1884
+ }
1885
+
1886
+ if (sTop > bounds.y) {
1887
+ scrollY = bounds.y - sTop;
1888
+ } else if (sBottom < bounds.y + bounds.height) {
1889
+ scrollY = bounds.y + bounds.height - sBottom;
1890
+ }
1891
+
1892
+ if (dir === "vertical" || (typeof col === "number" && col < freezeColumns)) {
1893
+ scrollX = 0;
1894
+ } else if (
1895
+ dir === "horizontal" ||
1896
+ (typeof row === "number" && row >= mangledRows - freezeTrailingRowsEffective)
1897
+ ) {
1898
+ scrollY = 0;
1899
+ }
1900
+
1901
+ if (scrollX !== 0 || scrollY !== 0) {
1902
+ // Remove scaling as scrollTo method is unaffected by transform scale.
1903
+ if (scale !== 1) {
1904
+ scrollX /= scale;
1905
+ scrollY /= scale;
1906
+ }
1907
+ scrollRef.current.scrollTo({
1908
+ left: scrollX + scrollRef.current.scrollLeft,
1909
+ top: scrollY + scrollRef.current.scrollTop,
1910
+ behavior: options?.behavior ?? "auto",
1911
+ });
1912
+ }
1913
+ }
1914
+ }
1915
+ }
1916
+ },
1917
+ [
1918
+ rowMarkerOffset,
1919
+ freezeTrailingRows,
1920
+ rowMarkerWidth,
1921
+ scrollRef,
1922
+ totalHeaderHeight,
1923
+ freezeColumns,
1924
+ stickyColumns,
1925
+ stickyRows,
1926
+ columns,
1927
+ mangledRows,
1928
+ lastRowSticky,
1929
+ rowHeight,
1930
+ ]
1931
+ );
1932
+
1933
+ const focusCallback = React.useRef(focusOnRowFromTrailingBlankRow);
1934
+ const getCellContentRef = React.useRef(getCellContent);
1935
+
1936
+ focusCallback.current = focusOnRowFromTrailingBlankRow;
1937
+ getCellContentRef.current = getCellContent;
1938
+
1939
+ const rowsRef = React.useRef(rows);
1940
+ rowsRef.current = rows;
1941
+
1942
+ const colsRef = React.useRef(mangledCols.length);
1943
+ colsRef.current = mangledCols.length;
1944
+
1945
+ const appendRow = React.useCallback(
1946
+ async (col: number, openOverlay: boolean = true, behavior?: ScrollBehavior): Promise<void> => {
1947
+ const c = mangledCols[col];
1948
+ if (c?.trailingRowOptions?.disabled === true) {
1949
+ return;
1950
+ }
1951
+ const appendResult = onRowAppended?.();
1952
+
1953
+ let r: "top" | "bottom" | number | undefined = undefined;
1954
+ let bottom = true;
1955
+ if (appendResult !== undefined) {
1956
+ r = await appendResult;
1957
+ if (r === "top") bottom = false;
1958
+ if (typeof r === "number") bottom = false;
1959
+ }
1960
+
1961
+ let backoff = 0;
1962
+ const doFocus = () => {
1963
+ if (rowsRef.current <= rows) {
1964
+ if (backoff < 500) {
1965
+ window.setTimeout(doFocus, backoff);
1966
+ }
1967
+ backoff = 50 + backoff * 2;
1968
+ return;
1969
+ }
1970
+
1971
+ const row = typeof r === "number" ? r : bottom ? rows : 0;
1972
+ scrollToRef.current(col - rowMarkerOffset, row, "both", 0, 0, behavior ? { behavior } : undefined);
1973
+ setCurrent(
1974
+ {
1975
+ cell: [col, row],
1976
+ range: {
1977
+ x: col,
1978
+ y: row,
1979
+ width: 1,
1980
+ height: 1,
1981
+ },
1982
+ },
1983
+ false,
1984
+ false,
1985
+ "edit"
1986
+ );
1987
+
1988
+ const cell = getCellContentRef.current([col - rowMarkerOffset, row]);
1989
+ if (cell.allowOverlay && isReadWriteCell(cell) && cell.readonly !== true && openOverlay) {
1990
+ // wait for scroll to have a chance to process
1991
+ window.setTimeout(() => {
1992
+ focusCallback.current(col, row);
1993
+ }, 0);
1994
+ }
1995
+ };
1996
+ // Queue up to allow the consumer to react to the event and let us check if they did
1997
+ doFocus();
1998
+ },
1999
+ [mangledCols, onRowAppended, rowMarkerOffset, rows, setCurrent]
2000
+ );
2001
+
2002
+ const appendColumn = React.useCallback(
2003
+ async (row: number, openOverlay: boolean = true): Promise<void> => {
2004
+ const appendResult = onColumnAppended?.();
2005
+
2006
+ let r: "left" | "right" | number | undefined = undefined;
2007
+ let right = true;
2008
+ if (appendResult !== undefined) {
2009
+ r = await appendResult;
2010
+ if (r === "left") right = false;
2011
+ if (typeof r === "number") right = false;
2012
+ }
2013
+
2014
+ let backoff = 0;
2015
+ const doFocus = () => {
2016
+ if (colsRef.current <= mangledCols.length) {
2017
+ if (backoff < 500) {
2018
+ window.setTimeout(doFocus, backoff);
2019
+ }
2020
+ backoff = 50 + backoff * 2;
2021
+ return;
2022
+ }
2023
+
2024
+ const col = typeof r === "number" ? r : right ? mangledCols.length : 0;
2025
+ scrollTo(col - rowMarkerOffset, row);
2026
+ setCurrent(
2027
+ {
2028
+ cell: [col, row],
2029
+ range: {
2030
+ x: col,
2031
+ y: row,
2032
+ width: 1,
2033
+ height: 1,
2034
+ },
2035
+ },
2036
+ false,
2037
+ false,
2038
+ "edit"
2039
+ );
2040
+
2041
+ const cell = getCellContentRef.current([col - rowMarkerOffset, row]);
2042
+ if (cell.allowOverlay && isReadWriteCell(cell) && cell.readonly !== true && openOverlay) {
2043
+ window.setTimeout(() => {
2044
+ focusCallback.current(col, row);
2045
+ }, 0);
2046
+ }
2047
+ };
2048
+ doFocus();
2049
+ },
2050
+ [mangledCols, onColumnAppended, rowMarkerOffset, scrollTo, setCurrent]
2051
+ );
2052
+
2053
+ const getCustomNewRowTargetColumn = React.useCallback(
2054
+ (col: number): number | undefined => {
2055
+ const customTargetColumn =
2056
+ columns[col]?.trailingRowOptions?.targetColumn ?? trailingRowOptions?.targetColumn;
2057
+
2058
+ if (typeof customTargetColumn === "number") {
2059
+ const customTargetOffset = hasRowMarkers ? 1 : 0;
2060
+ return customTargetColumn + customTargetOffset;
2061
+ }
2062
+
2063
+ if (typeof customTargetColumn === "object") {
2064
+ const maybeIndex = columnsIn.indexOf(customTargetColumn);
2065
+ if (maybeIndex >= 0) {
2066
+ const customTargetOffset = hasRowMarkers ? 1 : 0;
2067
+ return maybeIndex + customTargetOffset;
2068
+ }
2069
+ }
2070
+
2071
+ return undefined;
2072
+ },
2073
+ [columns, columnsIn, hasRowMarkers, trailingRowOptions?.targetColumn]
2074
+ );
2075
+
2076
+ const lastSelectedRowRef = React.useRef<number | undefined>(undefined);
2077
+ const lastSelectedColRef = React.useRef<number | undefined>(undefined);
2078
+
2079
+ const themeForCell = React.useCallback(
2080
+ (cell: InnerGridCell, pos: Item): FullTheme => {
2081
+ const [col, row] = pos;
2082
+ return mergeAndRealizeTheme(
2083
+ mergedTheme,
2084
+ mangledCols[col]?.themeOverride,
2085
+ getRowThemeOverride?.(row),
2086
+ cell.themeOverride
2087
+ );
2088
+ },
2089
+ [getRowThemeOverride, mangledCols, mergedTheme]
2090
+ );
2091
+
2092
+ const { mapper } = useRowGrouping(rowGrouping, rowsIn);
2093
+
2094
+ const rowGroupingNavBehavior = rowGrouping?.navigationBehavior;
2095
+
2096
+ const handleSelect = React.useCallback(
2097
+ (args: GridMouseEventArgs) => {
2098
+ const isMultiKey = browserIsOSX.value ? args.metaKey : args.ctrlKey;
2099
+ const isMultiRow = isMultiKey && rowSelect === "multi";
2100
+
2101
+ const [col, row] = args.location;
2102
+ const selectedColumns = gridSelection.columns;
2103
+ const selectedRows = gridSelection.rows;
2104
+ const [cellCol, cellRow] = gridSelection.current?.cell ?? [];
2105
+ // eslint-disable-next-line unicorn/prefer-switch
2106
+ if (args.kind === "cell") {
2107
+ lastSelectedColRef.current = undefined;
2108
+
2109
+ lastMouseSelectLocation.current = [col, row];
2110
+ arrowLaneRef.current = {};
2111
+
2112
+ if (col === 0 && hasRowMarkers) {
2113
+ if (
2114
+ (showTrailingBlankRow === true && row === rows) ||
2115
+ rowMarkers === "number" ||
2116
+ rowSelect === "none"
2117
+ )
2118
+ return;
2119
+
2120
+ const markerCell = getMangledCellContent(args.location);
2121
+ if (markerCell.kind !== InnerGridCellKind.Marker) {
2122
+ return;
2123
+ }
2124
+
2125
+ if (onRowMoved !== undefined) {
2126
+ const renderer = getCellRenderer(markerCell);
2127
+ assert(renderer?.kind === InnerGridCellKind.Marker);
2128
+ const postClick = renderer?.onClick?.({
2129
+ ...args,
2130
+ cell: markerCell,
2131
+ posX: args.localEventX,
2132
+ posY: args.localEventY,
2133
+ bounds: args.bounds,
2134
+ theme: themeForCell(markerCell, args.location),
2135
+ preventDefault: () => undefined,
2136
+ }) as MarkerCell | undefined;
2137
+ if (postClick === undefined || postClick.checked === markerCell.checked) return;
2138
+ }
2139
+
2140
+ setOverlay(undefined);
2141
+ focus();
2142
+ const isSelected = selectedRows.hasIndex(row);
2143
+
2144
+ const lastHighlighted = lastSelectedRowRef.current;
2145
+ if (
2146
+ rowSelect === "multi" &&
2147
+ (args.shiftKey || args.isLongTouch === true) &&
2148
+ lastHighlighted !== undefined &&
2149
+ selectedRows.hasIndex(lastHighlighted)
2150
+ ) {
2151
+ const newSlice: Slice = [Math.min(lastHighlighted, row), Math.max(lastHighlighted, row) + 1];
2152
+
2153
+ if (isMultiRow || rowSelectionMode === "multi") {
2154
+ setSelectedRows(undefined, newSlice, true);
2155
+ } else {
2156
+ setSelectedRows(CompactSelection.fromSingleSelection(newSlice), undefined, isMultiRow);
2157
+ }
2158
+ } else if (rowSelect === "multi" && (isMultiRow || args.isTouch || rowSelectionMode === "multi")) {
2159
+ if (isSelected) {
2160
+ setSelectedRows(selectedRows.remove(row), undefined, true);
2161
+ } else {
2162
+ setSelectedRows(undefined, row, true);
2163
+ lastSelectedRowRef.current = row;
2164
+ }
2165
+ } else if (isSelected && selectedRows.length === 1) {
2166
+ setSelectedRows(CompactSelection.empty(), undefined, isMultiKey);
2167
+ } else {
2168
+ setSelectedRows(CompactSelection.fromSingleSelection(row), undefined, isMultiKey);
2169
+ lastSelectedRowRef.current = row;
2170
+ }
2171
+ } else if (col >= rowMarkerOffset && showTrailingBlankRow && row === rows) {
2172
+ const customTargetColumn = getCustomNewRowTargetColumn(col);
2173
+ void appendRow(customTargetColumn ?? col);
2174
+ } else {
2175
+ if (cellCol !== col || cellRow !== row) {
2176
+ const cell = getMangledCellContent(args.location);
2177
+ const renderer = getCellRenderer(cell);
2178
+
2179
+ if (renderer?.onSelect !== undefined) {
2180
+ let prevented = false;
2181
+ renderer.onSelect({
2182
+ ...args,
2183
+ cell,
2184
+ posX: args.localEventX,
2185
+ posY: args.localEventY,
2186
+ bounds: args.bounds,
2187
+ preventDefault: () => (prevented = true),
2188
+ theme: themeForCell(cell, args.location),
2189
+ });
2190
+ if (prevented) {
2191
+ return;
2192
+ }
2193
+ }
2194
+
2195
+ if (rowGroupingNavBehavior === "block" && mapper(row).isGroupHeader) {
2196
+ return;
2197
+ }
2198
+
2199
+ const isLastStickyRow = lastRowSticky && row === rows;
2200
+
2201
+ const startedFromLastSticky =
2202
+ lastRowSticky && gridSelection !== undefined && gridSelection.current?.cell[1] === rows;
2203
+
2204
+ if (
2205
+ (args.shiftKey || args.isLongTouch === true) &&
2206
+ cellCol !== undefined &&
2207
+ cellRow !== undefined &&
2208
+ gridSelection.current !== undefined &&
2209
+ !startedFromLastSticky
2210
+ ) {
2211
+ if (isLastStickyRow) {
2212
+ // If we're making a selection and shift click in to the last sticky row,
2213
+ // just drop the event. Don't kill the selection.
2214
+ return;
2215
+ }
2216
+
2217
+ const left = Math.min(col, cellCol);
2218
+ const right = Math.max(col, cellCol);
2219
+ const top = Math.min(row, cellRow);
2220
+ const bottom = Math.max(row, cellRow);
2221
+ setCurrent(
2222
+ {
2223
+ ...gridSelection.current,
2224
+ range: {
2225
+ x: left,
2226
+ y: top,
2227
+ width: right - left + 1,
2228
+ height: bottom - top + 1,
2229
+ },
2230
+ },
2231
+ true,
2232
+ isMultiKey,
2233
+ "click"
2234
+ );
2235
+ lastSelectedRowRef.current = undefined;
2236
+ focus();
2237
+ } else {
2238
+ setCurrent(
2239
+ {
2240
+ cell: [col, row],
2241
+ range: { x: col, y: row, width: 1, height: 1 },
2242
+ },
2243
+ true,
2244
+ isMultiKey,
2245
+ "click"
2246
+ );
2247
+ lastSelectedRowRef.current = undefined;
2248
+ setOverlay(undefined);
2249
+ focus();
2250
+ }
2251
+ }
2252
+ }
2253
+ } else if (args.kind === "header") {
2254
+ lastMouseSelectLocation.current = [col, row];
2255
+ setOverlay(undefined);
2256
+ if (hasRowMarkers && col === 0) {
2257
+ lastSelectedRowRef.current = undefined;
2258
+ lastSelectedColRef.current = undefined;
2259
+ if (!headerRowMarkerDisabled && rowSelect === "multi") {
2260
+ if (selectedRows.length !== rows) {
2261
+ setSelectedRows(CompactSelection.fromSingleSelection([0, rows]), undefined, isMultiKey);
2262
+ } else {
2263
+ setSelectedRows(CompactSelection.empty(), undefined, isMultiKey);
2264
+ }
2265
+ focus();
2266
+ }
2267
+ } else {
2268
+ const lastCol = lastSelectedColRef.current;
2269
+ if (
2270
+ columnSelect === "multi" &&
2271
+ (args.shiftKey || args.isLongTouch === true) &&
2272
+ lastCol !== undefined &&
2273
+ selectedColumns.hasIndex(lastCol)
2274
+ ) {
2275
+ // Support for selecting a slice of columns:
2276
+ const newSlice: Slice = [Math.min(lastCol, col), Math.max(lastCol, col) + 1];
2277
+
2278
+ if (isMultiKey || args.isTouch || columnSelectionMode === "multi") {
2279
+ setSelectedColumns(undefined, newSlice, isMultiKey);
2280
+ } else {
2281
+ setSelectedColumns(CompactSelection.fromSingleSelection(newSlice), undefined, isMultiKey);
2282
+ }
2283
+ } else if (
2284
+ columnSelect === "multi" &&
2285
+ (isMultiKey || args.isTouch || columnSelectionMode === "multi")
2286
+ ) {
2287
+ // Support for selecting a single columns additively:
2288
+ if (selectedColumns.hasIndex(col)) {
2289
+ // If the column is already selected, deselect that column:
2290
+ setSelectedColumns(selectedColumns.remove(col), undefined, isMultiKey);
2291
+ } else {
2292
+ setSelectedColumns(undefined, col, isMultiKey);
2293
+ }
2294
+ lastSelectedColRef.current = col;
2295
+ } else if (columnSelect !== "none") {
2296
+ if (selectedColumns.hasIndex(col)) {
2297
+ // If the column is already selected, deselect that column:
2298
+ setSelectedColumns(selectedColumns.remove(col), undefined, isMultiKey);
2299
+ } else {
2300
+ setSelectedColumns(CompactSelection.fromSingleSelection(col), undefined, isMultiKey);
2301
+ }
2302
+ lastSelectedColRef.current = col;
2303
+ }
2304
+ lastSelectedRowRef.current = undefined;
2305
+ focus();
2306
+ }
2307
+ } else if (args.kind === groupHeaderKind) {
2308
+ lastMouseSelectLocation.current = [col, row];
2309
+ } else if (args.kind === outOfBoundsKind && !args.isMaybeScrollbar) {
2310
+ setGridSelection(emptyGridSelection, false);
2311
+ setOverlay(undefined);
2312
+ focus();
2313
+ onSelectionCleared?.();
2314
+ lastSelectedRowRef.current = undefined;
2315
+ lastSelectedColRef.current = undefined;
2316
+ }
2317
+ },
2318
+ [
2319
+ rowSelect,
2320
+ columnSelect,
2321
+ gridSelection,
2322
+ hasRowMarkers,
2323
+ rowMarkerOffset,
2324
+ showTrailingBlankRow,
2325
+ rows,
2326
+ rowMarkers,
2327
+ getMangledCellContent,
2328
+ onRowMoved,
2329
+ focus,
2330
+ rowSelectionMode,
2331
+ columnSelectionMode,
2332
+ getCellRenderer,
2333
+ themeForCell,
2334
+ setSelectedRows,
2335
+ getCustomNewRowTargetColumn,
2336
+ appendRow,
2337
+ rowGroupingNavBehavior,
2338
+ mapper,
2339
+ lastRowSticky,
2340
+ setCurrent,
2341
+ headerRowMarkerDisabled,
2342
+ setSelectedColumns,
2343
+ setGridSelection,
2344
+ onSelectionCleared,
2345
+ ]
2346
+ );
2347
+ const isActivelyDraggingHeader = React.useRef(false);
2348
+ const lastMouseSelectLocation = React.useRef<readonly [number, number] | undefined>(undefined);
2349
+ // Память полосы для стрелочной навигации сквозь объединённые блоки: помним
2350
+ // строку и колонку входа и при выходе из блока возвращаемся на них, а не на
2351
+ // верхнюю-левую ячейку блока (как в Excel). Клик мышью память сбрасывает.
2352
+ const arrowLaneRef = React.useRef<{ row?: number; col?: number }>({});
2353
+ const touchDownArgs = React.useRef(visibleRegion);
2354
+ const mouseDownData = React.useRef<{
2355
+ time: number;
2356
+ button: number;
2357
+ location: Item;
2358
+ } | undefined>(undefined);
2359
+ const onMouseDown = React.useCallback(
2360
+ (args: GridMouseEventArgs) => {
2361
+ isPrevented.current = false;
2362
+ touchDownArgs.current = visibleRegionRef.current;
2363
+ if (args.button !== 0 && args.button !== 1) {
2364
+ mouseDownData.current = undefined;
2365
+ return;
2366
+ }
2367
+
2368
+ const time = performance.now();
2369
+ mouseDownData.current = {
2370
+ button: args.button,
2371
+ time,
2372
+ location: args.location,
2373
+ };
2374
+
2375
+ // Индикатор скрытых колонок: не начинаем выделение шапки/группы, если курсор
2376
+ // на полосе. В колоночной зоне полоса может стоять там, где нет resize-грани
2377
+ // (край таблицы, колонка с выключенным ресайзом), поэтому ранний return по
2378
+ // isEdge ниже её не покрывает, поэтому подавляем выделение явно.
2379
+ if (
2380
+ (args.kind === groupHeaderKind || args.kind === "header") &&
2381
+ args.hiddenIndicatorCol !== undefined
2382
+ ) {
2383
+ return;
2384
+ }
2385
+
2386
+ if (args?.kind === "header") {
2387
+ isActivelyDraggingHeader.current = true;
2388
+ }
2389
+
2390
+ const fh = args.kind === "cell" && args.isFillHandle;
2391
+
2392
+ if (!fh && args.kind !== "cell" && args.isEdge) return;
2393
+
2394
+ setMouseState({
2395
+ previousSelection: gridSelection,
2396
+ fillHandle: fh,
2397
+ });
2398
+ lastMouseSelectLocation.current = undefined;
2399
+
2400
+ if (!args.isTouch && args.button === 0 && !fh) {
2401
+ handleSelect(args);
2402
+ } else if (!args.isTouch && args.button === 1) {
2403
+ lastMouseSelectLocation.current = args.location;
2404
+ }
2405
+ },
2406
+ [gridSelection, handleSelect]
2407
+ );
2408
+
2409
+ const [renameGroup, setRenameGroup] = React.useState<{
2410
+ group: string;
2411
+ bounds: Rectangle;
2412
+ }>();
2413
+
2414
+ const handleGroupHeaderSelection = React.useCallback(
2415
+ (args: GridMouseEventArgs) => {
2416
+ if (args.kind !== groupHeaderKind || columnSelect !== "multi") {
2417
+ return;
2418
+ }
2419
+ const isMultiKey = browserIsOSX.value ? args.metaKey : args.ctrlKey;
2420
+ const [col, row] = args.location;
2421
+ const selectedColumns = gridSelection.columns;
2422
+
2423
+ if (col < rowMarkerOffset) return;
2424
+
2425
+ // Determine the level of the clicked group header
2426
+ // row is -2 for level 0, -3 for level 1, etc.
2427
+ const level = row <= -2 ? -2 - row : 0;
2428
+
2429
+ const needle = mangledCols[col];
2430
+
2431
+ // Пустая («») групп-ячейка над безгруппной колонкой — это НЕ настоящая группа.
2432
+ // Клик по ней ничего не выделяет: выделять нечего (группы нет), а группового
2433
+ // highlight рисоваться не должно (иначе — артефактная accent-линия по верху шапки).
2434
+ // Настоящие группы (с именем на кликнутом уровне) идут дальше как раньше.
2435
+ const clickedGroupName = Array.isArray(needle.group)
2436
+ ? (needle.group[level] ?? "")
2437
+ : level === 0
2438
+ ? (needle.group ?? "")
2439
+ : "";
2440
+ if (clickedGroupName === "") return;
2441
+
2442
+ // Find all columns that belong to the same group at this level and all levels below
2443
+ // We need to find columns that match at the clicked level AND all parent levels.
2444
+ // spanGroupHeader-колонки в скан не попадают сами собой: у них пустая группа, а
2445
+ // isGroupEqual с нашим НЕпустым именем группы на пустой группе рвётся.
2446
+ let start = col;
2447
+ let end = col;
2448
+
2449
+ // Find start: go backwards and check if groups match at all levels from 0 to the clicked level
2450
+ for (let i = col - 1; i >= rowMarkerOffset; i--) {
2451
+ let matches = true;
2452
+ for (let l = 0; l <= level; l++) {
2453
+ if (!isGroupEqual(needle.group, mangledCols[i].group, l)) {
2454
+ matches = false;
2455
+ break;
2456
+ }
2457
+ }
2458
+ if (!matches) break;
2459
+ start--;
2460
+ }
2461
+
2462
+ // Find end: go forwards and check if groups match at all levels from 0 to the clicked level
2463
+ for (let i = col + 1; i < mangledCols.length; i++) {
2464
+ let matches = true;
2465
+ for (let l = 0; l <= level; l++) {
2466
+ if (!isGroupEqual(needle.group, mangledCols[i].group, l)) {
2467
+ matches = false;
2468
+ break;
2469
+ }
2470
+ }
2471
+ if (!matches) break;
2472
+ end++;
2473
+ }
2474
+
2475
+ focus();
2476
+ lastSelectedRowRef.current = undefined;
2477
+
2478
+ const rowsToSelect = showTrailingBlankRow ? rows + 1 : rows;
2479
+ const groupRange = {
2480
+ x: start,
2481
+ y: 0,
2482
+ width: end - start + 1,
2483
+ height: rowsToSelect,
2484
+ };
2485
+ const cell = [start, row <= -2 ? row : -2] as const;
2486
+ const expand = true;
2487
+ const append = isMultiKey || args.isTouch || columnSelectionMode === "multi";
2488
+ const newSelection: GridSelection = {
2489
+ current: { cell, range: groupRange, rangeStack: [] },
2490
+ columns: selectedColumns,
2491
+ rows: gridSelection.rows,
2492
+ };
2493
+
2494
+ if (append) {
2495
+ if (selectedColumns.hasAll([start, end + 1])) {
2496
+ let newCols = selectedColumns;
2497
+ for (let index = start; index <= end; index++) {
2498
+ newCols = newCols.remove(index);
2499
+ }
2500
+ setGridSelection(
2501
+ {
2502
+ ...newSelection,
2503
+ current: undefined,
2504
+ columns: newCols,
2505
+ },
2506
+ expand
2507
+ );
2508
+ } else {
2509
+ const newCols = selectedColumns.add([start, end + 1]);
2510
+ setGridSelection(
2511
+ {
2512
+ ...newSelection,
2513
+ columns: newCols,
2514
+ },
2515
+ expand
2516
+ );
2517
+ }
2518
+ } else {
2519
+ setGridSelection(
2520
+ {
2521
+ ...newSelection,
2522
+ columns: CompactSelection.fromSingleSelection([start, end + 1]),
2523
+ },
2524
+ expand
2525
+ );
2526
+ }
2527
+ lastSelectedColRef.current = start;
2528
+ },
2529
+ [
2530
+ columnSelect,
2531
+ focus,
2532
+ gridSelection.columns,
2533
+ gridSelection.rows,
2534
+ mangledCols,
2535
+ rowMarkerOffset,
2536
+ columnSelectionMode,
2537
+ lastSelectedColRef,
2538
+ lastSelectedRowRef,
2539
+ rows,
2540
+ setGridSelection,
2541
+ showTrailingBlankRow,
2542
+ ]
2543
+ );
2544
+
2545
+ const isPrevented = React.useRef(false);
2546
+
2547
+ const normalSizeColumn = React.useCallback(
2548
+ async (col: number): Promise<void> => {
2549
+ if (getCellsForSelection !== undefined && onColumnResize !== undefined) {
2550
+ const start = visibleRegionRef.current.y;
2551
+ const end = visibleRegionRef.current.height;
2552
+ let cells = getCellsForSelection(
2553
+ {
2554
+ x: col,
2555
+ y: start,
2556
+ width: 1,
2557
+ height: Math.min(end, rows - start),
2558
+ },
2559
+ abortControllerRef.current.signal
2560
+ );
2561
+ if (typeof cells !== "object") {
2562
+ cells = await cells();
2563
+ }
2564
+ const inputCol = columns[col - rowMarkerOffset];
2565
+ const offscreen = document.createElement("canvas");
2566
+ const ctx = offscreen.getContext("2d", { alpha: false });
2567
+ if (ctx !== null) {
2568
+ ctx.font = mergedTheme.baseFontFull;
2569
+ const newCol = measureColumn(
2570
+ ctx,
2571
+ mergedTheme,
2572
+ inputCol,
2573
+ 0,
2574
+ cells,
2575
+ minColumnWidth,
2576
+ maxColumnWidth,
2577
+ false,
2578
+ getCellRenderer
2579
+ );
2580
+ onColumnResize?.(inputCol, newCol.width, col, newCol.width);
2581
+ }
2582
+ }
2583
+ },
2584
+ [
2585
+ columns,
2586
+ getCellsForSelection,
2587
+ maxColumnWidth,
2588
+ mergedTheme,
2589
+ minColumnWidth,
2590
+ onColumnResize,
2591
+ rowMarkerOffset,
2592
+ rows,
2593
+ getCellRenderer,
2594
+ ]
2595
+ );
2596
+
2597
+ const [scrollDir, setScrollDir] = React.useState<GridMouseEventArgs["scrollEdge"]>();
2598
+
2599
+ const fillPattern = React.useCallback(
2600
+ async (previousSelection: GridSelection, currentSelection: GridSelection) => {
2601
+ const patternRange = previousSelection.current?.range;
2602
+
2603
+ if (
2604
+ patternRange === undefined ||
2605
+ getCellsForSelection === undefined ||
2606
+ currentSelection.current === undefined
2607
+ ) {
2608
+ return;
2609
+ }
2610
+ const currentRange = currentSelection.current.range;
2611
+
2612
+ if (onFillPattern !== undefined) {
2613
+ let canceled = false;
2614
+ onFillPattern({
2615
+ fillDestination: { ...currentRange, x: currentRange.x - rowMarkerOffset },
2616
+ patternSource: { ...patternRange, x: patternRange.x - rowMarkerOffset },
2617
+ preventDefault: () => (canceled = true),
2618
+ });
2619
+ if (canceled) return;
2620
+ }
2621
+
2622
+ let cells = getCellsForSelection(patternRange, abortControllerRef.current.signal);
2623
+ if (typeof cells !== "object") cells = await cells();
2624
+
2625
+ const pattern = cells;
2626
+
2627
+ // loop through all cells in currentSelection.current.range
2628
+ const editItemList: EditListItem[] = [];
2629
+ for (let x = 0; x < currentRange.width; x++) {
2630
+ for (let y = 0; y < currentRange.height; y++) {
2631
+ const cell: Item = [currentRange.x + x, currentRange.y + y];
2632
+ if (itemIsInRect(cell, patternRange)) continue;
2633
+ // Не пишем в покрытые ячейки слитого блока — значение получит только origin
2634
+ // (когда цикл дойдёт до его координаты). Иначе запись летит в середину блока.
2635
+ const targetCell = getMangledCellContent(cell);
2636
+ if (isCoveredSpanCell(targetCell, cell[0], cell[1])) {
2637
+ continue;
2638
+ }
2639
+ const patternCell = pattern[y % patternRange.height][x % patternRange.width];
2640
+ if (isInnerOnlyCell(patternCell) || !isReadWriteCell(patternCell)) continue;
2641
+ editItemList.push({
2642
+ location: cell,
2643
+ value: { ...patternCell },
2644
+ });
2645
+ }
2646
+ }
2647
+ mangledOnCellsEdited(editItemList);
2648
+
2649
+ gridRef.current?.damage(
2650
+ editItemList.map(c => ({
2651
+ cell: c.location,
2652
+ }))
2653
+ );
2654
+ },
2655
+ [getCellsForSelection, getMangledCellContent, mangledOnCellsEdited, onFillPattern, rowMarkerOffset]
2656
+ );
2657
+
2658
+ const fillRight = React.useCallback(() => {
2659
+ if (gridSelection.current === undefined || gridSelection.current.range.width <= 1) return;
2660
+
2661
+ const firstColSelection = {
2662
+ ...gridSelection,
2663
+ current: {
2664
+ ...gridSelection.current,
2665
+ range: {
2666
+ ...gridSelection.current.range,
2667
+ width: 1,
2668
+ },
2669
+ },
2670
+ };
2671
+
2672
+ void fillPattern(firstColSelection, gridSelection);
2673
+ }, [fillPattern, gridSelection]);
2674
+
2675
+ const fillDown = React.useCallback(() => {
2676
+ if (gridSelection.current === undefined || gridSelection.current.range.height <= 1) return;
2677
+
2678
+ const firstRowSelection = {
2679
+ ...gridSelection,
2680
+ current: {
2681
+ ...gridSelection.current,
2682
+ range: {
2683
+ ...gridSelection.current.range,
2684
+ height: 1,
2685
+ },
2686
+ },
2687
+ };
2688
+
2689
+ void fillPattern(firstRowSelection, gridSelection);
2690
+ }, [fillPattern, gridSelection]);
2691
+
2692
+ const onMouseUp = React.useCallback(
2693
+ (args: GridMouseEventArgs, isOutside: boolean) => {
2694
+ const mouse = mouseState;
2695
+ setMouseState(undefined);
2696
+ setFillHighlightRegion(undefined);
2697
+ setScrollDir(undefined);
2698
+ isActivelyDraggingHeader.current = false;
2699
+
2700
+ if (isOutside) return;
2701
+
2702
+ if (
2703
+ mouse?.fillHandle === true &&
2704
+ gridSelection.current !== undefined &&
2705
+ mouse.previousSelection?.current !== undefined
2706
+ ) {
2707
+ if (fillHighlightRegion === undefined) return;
2708
+ const newRange = {
2709
+ ...gridSelection,
2710
+ current: {
2711
+ ...gridSelection.current,
2712
+ range: combineRects(mouse.previousSelection.current.range, fillHighlightRegion),
2713
+ },
2714
+ };
2715
+ void fillPattern(mouse.previousSelection, newRange);
2716
+ setGridSelection(newRange, true);
2717
+ return;
2718
+ }
2719
+
2720
+ const [col, row] = args.location;
2721
+ const [lastMouseDownCol, lastMouseDownRow] = lastMouseSelectLocation.current ?? [];
2722
+
2723
+ const preventDefault = () => {
2724
+ isPrevented.current = true;
2725
+ };
2726
+
2727
+ const handleMaybeClick = (a: GridMouseCellEventArgs): boolean => {
2728
+ const isValidClick = a.isTouch || (lastMouseDownCol === col && lastMouseDownRow === row);
2729
+ if (isValidClick) {
2730
+ onCellClicked?.([col - rowMarkerOffset, row], {
2731
+ ...a,
2732
+ preventDefault,
2733
+ });
2734
+ }
2735
+ if (a.button === 1) return !isPrevented.current;
2736
+ if (!isPrevented.current) {
2737
+ const c = getMangledCellContent(args.location);
2738
+ const r = getCellRenderer(c);
2739
+ if (r !== undefined && r.onClick !== undefined && isValidClick) {
2740
+ const newVal = r.onClick({
2741
+ ...a,
2742
+ cell: c,
2743
+ posX: a.localEventX,
2744
+ posY: a.localEventY,
2745
+ bounds: a.bounds,
2746
+ theme: themeForCell(c, args.location),
2747
+ preventDefault,
2748
+ });
2749
+ if (newVal !== undefined && !isInnerOnlyCell(newVal) && isEditableGridCell(newVal)) {
2750
+ mangledOnCellsEdited([{ location: a.location, value: newVal }]);
2751
+ gridRef.current?.damage([
2752
+ {
2753
+ cell: a.location,
2754
+ },
2755
+ ]);
2756
+ }
2757
+ }
2758
+ if (isPrevented.current || gridSelection.current === undefined) return false;
2759
+
2760
+ let shouldActivate = false;
2761
+ switch (c.activationBehaviorOverride ?? cellActivationBehavior) {
2762
+ case "double-click":
2763
+ case "second-click": {
2764
+ if (mouse?.previousSelection?.current?.cell === undefined) break;
2765
+ const [selectedCol, selectedRow] = gridSelection.current.cell;
2766
+ const [prevCol, prevRow] = mouse.previousSelection.current.cell;
2767
+ const isClickOnSelected =
2768
+ col === selectedCol && col === prevCol && row === selectedRow && row === prevRow;
2769
+ shouldActivate =
2770
+ isClickOnSelected &&
2771
+ (a.isDoubleClick === true || cellActivationBehavior === "second-click");
2772
+ break;
2773
+ }
2774
+ case "single-click": {
2775
+ shouldActivate = true;
2776
+ break;
2777
+ }
2778
+ }
2779
+ if (shouldActivate) {
2780
+ const act =
2781
+ a.isDoubleClick === true
2782
+ ? "double-click"
2783
+ : (c.activationBehaviorOverride ?? cellActivationBehavior);
2784
+ const activationEvent: CellActivatedEventArgs = {
2785
+ inputType: "pointer",
2786
+ pointerActivation: act,
2787
+ pointerType: a.isTouch ? "touch" : "mouse",
2788
+ };
2789
+ onCellActivated?.([col - rowMarkerOffset, row], activationEvent);
2790
+ reselect(a.bounds, activationEvent);
2791
+ return true;
2792
+ }
2793
+ }
2794
+ return false;
2795
+ };
2796
+
2797
+ const clickLocation = args.location[0] - rowMarkerOffset;
2798
+
2799
+ if (args.isTouch) {
2800
+ const vr = visibleRegionRef.current;
2801
+ const touchVr = touchDownArgs.current;
2802
+ if (vr.x !== touchVr.x || vr.y !== touchVr.y) {
2803
+ // we scrolled, abort
2804
+ return;
2805
+ }
2806
+ // take care of context menus first if long pressed item is already selected
2807
+ if (args.isLongTouch === true) {
2808
+ if (args.kind === "cell" && itemsAreEqual(gridSelection.current?.cell, args.location)) {
2809
+ onCellContextMenu?.([clickLocation, args.location[1]], {
2810
+ ...args,
2811
+ preventDefault,
2812
+ });
2813
+ return;
2814
+ } else if (args.kind === "header" && gridSelection.columns.hasIndex(col)) {
2815
+ onHeaderContextMenu?.(clickLocation, { ...args, preventDefault });
2816
+ return;
2817
+ } else if (args.kind === groupHeaderKind) {
2818
+ if (clickLocation < 0) {
2819
+ return;
2820
+ }
2821
+
2822
+ onGroupHeaderContextMenu?.(clickLocation, { ...args, preventDefault });
2823
+ return;
2824
+ }
2825
+ }
2826
+ if (args.kind === "cell") {
2827
+ // click that cell
2828
+ if (!handleMaybeClick(args)) {
2829
+ handleSelect(args);
2830
+ }
2831
+ } else if (args.kind === groupHeaderKind) {
2832
+ onGroupHeaderClicked?.(clickLocation, { ...args, preventDefault });
2833
+ } else {
2834
+ if (args.kind === headerKind) {
2835
+ onHeaderClicked?.(clickLocation, {
2836
+ ...args,
2837
+ preventDefault,
2838
+ });
2839
+ }
2840
+ handleSelect(args);
2841
+ }
2842
+ return;
2843
+ }
2844
+
2845
+ if (args.kind === "header") {
2846
+ if (clickLocation < 0) {
2847
+ return;
2848
+ }
2849
+
2850
+ // Индикатор скрытых колонок раскрывается двойным кликом независимо от
2851
+ // resize-грани: полоса бывает на краю таблицы и у колонок с выключенным
2852
+ // ресайзом, где isEdge=false. Одиночный клик по полосе глотаем (колонку
2853
+ // не выделяем). Автосайз по двойному клику по грани оставляем как был.
2854
+ if (args.hiddenIndicatorCol !== undefined) {
2855
+ if (args.isDoubleClick === true) {
2856
+ onHiddenColumnsIndicatorClicked?.(args.hiddenIndicatorCol - rowMarkerOffset, {
2857
+ ...args,
2858
+ preventDefault,
2859
+ });
2860
+ }
2861
+ } else if (args.isEdge) {
2862
+ if (args.isDoubleClick === true) {
2863
+ void normalSizeColumn(col);
2864
+ }
2865
+ } else if (args.button === 0 && col === lastMouseDownCol && row === lastMouseDownRow) {
2866
+ onHeaderClicked?.(clickLocation, { ...args, preventDefault });
2867
+ }
2868
+ }
2869
+
2870
+ if (args.kind === groupHeaderKind) {
2871
+ if (clickLocation < 0) {
2872
+ return;
2873
+ }
2874
+
2875
+ // Индикатор скрытых колонок в групповой зоне: одиночный клик глотаем
2876
+ // (группу не выделяем), двойной раскрывает промежуток.
2877
+ if (args.hiddenIndicatorCol !== undefined) {
2878
+ if (args.isDoubleClick === true) {
2879
+ onHiddenColumnsIndicatorClicked?.(args.hiddenIndicatorCol - rowMarkerOffset, {
2880
+ ...args,
2881
+ preventDefault,
2882
+ });
2883
+ }
2884
+ } else if (args.button === 0 && col === lastMouseDownCol && row === lastMouseDownRow) {
2885
+ onGroupHeaderClicked?.(clickLocation, { ...args, preventDefault });
2886
+ if (!isPrevented.current) {
2887
+ handleGroupHeaderSelection(args);
2888
+ }
2889
+ }
2890
+ }
2891
+
2892
+ if (args.kind === "cell" && (args.button === 0 || args.button === 1)) {
2893
+ handleMaybeClick(args);
2894
+ }
2895
+
2896
+ lastMouseSelectLocation.current = undefined;
2897
+ },
2898
+ [
2899
+ mouseState,
2900
+ gridSelection,
2901
+ rowMarkerOffset,
2902
+ fillHighlightRegion,
2903
+ fillPattern,
2904
+ setGridSelection,
2905
+ onCellClicked,
2906
+ getMangledCellContent,
2907
+ getCellRenderer,
2908
+ cellActivationBehavior,
2909
+ themeForCell,
2910
+ mangledOnCellsEdited,
2911
+ onCellActivated,
2912
+ reselect,
2913
+ onCellContextMenu,
2914
+ onHeaderContextMenu,
2915
+ onGroupHeaderContextMenu,
2916
+ handleSelect,
2917
+ onGroupHeaderClicked,
2918
+ onHeaderClicked,
2919
+ onHiddenColumnsIndicatorClicked,
2920
+ normalSizeColumn,
2921
+ handleGroupHeaderSelection,
2922
+ ]
2923
+ );
2924
+
2925
+ const onMouseMoveImpl = React.useCallback(
2926
+ (args: GridMouseEventArgs) => {
2927
+ const a: GridMouseEventArgs = {
2928
+ ...args,
2929
+ location: [args.location[0] - rowMarkerOffset, args.location[1]] as any,
2930
+ };
2931
+ onMouseMove?.(a);
2932
+
2933
+ if (mouseState !== undefined && args.buttons === 0) {
2934
+ setMouseState(undefined);
2935
+ setFillHighlightRegion(undefined);
2936
+ setScrollDir(undefined);
2937
+ isActivelyDraggingHeader.current = false;
2938
+ }
2939
+
2940
+ setScrollDir(cv => {
2941
+ if (isActivelyDraggingHeader.current) return [args.scrollEdge[0], 0];
2942
+ if (args.scrollEdge[0] === cv?.[0] && args.scrollEdge[1] === cv[1]) return cv;
2943
+ return mouseState === undefined || (mouseDownData.current?.location[0] ?? 0) < rowMarkerOffset
2944
+ ? undefined
2945
+ : args.scrollEdge;
2946
+ });
2947
+ },
2948
+ [mouseState, onMouseMove, rowMarkerOffset]
2949
+ );
2950
+
2951
+ const onHeaderMenuClickInner = React.useCallback(
2952
+ (col: number, screenPosition: Rectangle) => {
2953
+ onHeaderMenuClick?.(col - rowMarkerOffset, screenPosition);
2954
+ },
2955
+ [onHeaderMenuClick, rowMarkerOffset]
2956
+ );
2957
+
2958
+ const onHeaderIndicatorClickInner = React.useCallback(
2959
+ (col: number, screenPosition: Rectangle) => {
2960
+ onHeaderIndicatorClick?.(col - rowMarkerOffset, screenPosition);
2961
+ },
2962
+ [onHeaderIndicatorClick, rowMarkerOffset]
2963
+ );
2964
+
2965
+ const currentCell = gridSelection?.current?.cell;
2966
+ const onVisibleRegionChangedImpl = React.useCallback(
2967
+ (
2968
+ region: Rectangle,
2969
+ clientWidth: number,
2970
+ clientHeight: number,
2971
+ rightElWidth: number,
2972
+ tx: number,
2973
+ ty: number
2974
+ ) => {
2975
+ hasJustScrolled.current = false;
2976
+ let selected = currentCell;
2977
+ if (selected !== undefined) {
2978
+ selected = [selected[0] - rowMarkerOffset, selected[1]];
2979
+ }
2980
+
2981
+ const freezeRegion =
2982
+ freezeColumns === 0
2983
+ ? undefined
2984
+ : {
2985
+ x: 0,
2986
+ y: region.y,
2987
+ width: freezeColumns,
2988
+ height: region.height,
2989
+ };
2990
+
2991
+ const freezeRegions: Rectangle[] = [];
2992
+ if (freezeRegion !== undefined) freezeRegions.push(freezeRegion);
2993
+ if (freezeTrailingRows > 0) {
2994
+ freezeRegions.push({
2995
+ x: region.x - rowMarkerOffset,
2996
+ y: rows - freezeTrailingRows,
2997
+ width: region.width,
2998
+ height: freezeTrailingRows,
2999
+ });
3000
+
3001
+ if (freezeColumns > 0) {
3002
+ freezeRegions.push({
3003
+ x: 0,
3004
+ y: rows - freezeTrailingRows,
3005
+ width: freezeColumns,
3006
+ height: freezeTrailingRows,
3007
+ });
3008
+ }
3009
+ }
3010
+
3011
+ // Липкие колонки и строки видны вне окна прокрутки: отдаём их регионами, чтобы потребитель
3012
+ // загрузил для них данные. Соседние индексы склеиваются в один регион.
3013
+ // Колонки уже покрытые префиксом freezeColumns, повторно не отдаём.
3014
+ const stickyColumnRuns = toRuns(
3015
+ (stickyColumns ?? [])
3016
+ .map(stickyGridColumn => stickyGridColumn - rowMarkerOffset)
3017
+ .filter(stickyColumn => stickyColumn >= freezeColumns)
3018
+ );
3019
+ const stickyRowRuns = toRuns(stickyRows ?? []);
3020
+ for (const columnRun of stickyColumnRuns) {
3021
+ freezeRegions.push({
3022
+ x: columnRun.start,
3023
+ y: region.y,
3024
+ width: columnRun.length,
3025
+ height: region.height,
3026
+ });
3027
+ }
3028
+ for (const rowRun of stickyRowRuns) {
3029
+ freezeRegions.push({
3030
+ x: region.x - rowMarkerOffset,
3031
+ y: rowRun.start,
3032
+ width: region.width,
3033
+ height: rowRun.length,
3034
+ });
3035
+ if (freezeColumns > 0) {
3036
+ freezeRegions.push({ x: 0, y: rowRun.start, width: freezeColumns, height: rowRun.length });
3037
+ }
3038
+ for (const columnRun of stickyColumnRuns) {
3039
+ freezeRegions.push({
3040
+ x: columnRun.start,
3041
+ y: rowRun.start,
3042
+ width: columnRun.length,
3043
+ height: rowRun.length,
3044
+ });
3045
+ }
3046
+ }
3047
+
3048
+ const newRegion = {
3049
+ x: region.x - rowMarkerOffset,
3050
+ y: region.y,
3051
+ width: region.width,
3052
+ height: showTrailingBlankRow && region.y + region.height >= rows ? region.height - 1 : region.height,
3053
+ tx,
3054
+ ty,
3055
+ extras: {
3056
+ selected,
3057
+ freezeRegion,
3058
+ freezeRegions,
3059
+ },
3060
+ };
3061
+ visibleRegionRef.current = newRegion;
3062
+ setVisibleRegion(newRegion);
3063
+ setClientSize([clientWidth, clientHeight, rightElWidth]);
3064
+ onVisibleRegionChanged?.(newRegion, newRegion.tx, newRegion.ty, newRegion.extras);
3065
+ },
3066
+ [
3067
+ currentCell,
3068
+ rowMarkerOffset,
3069
+ showTrailingBlankRow,
3070
+ rows,
3071
+ freezeColumns,
3072
+ freezeTrailingRows,
3073
+ stickyColumns,
3074
+ stickyRows,
3075
+ setVisibleRegion,
3076
+ onVisibleRegionChanged,
3077
+ ]
3078
+ );
3079
+
3080
+ const onColumnProposeMoveImpl = whenDefined(
3081
+ onColumnProposeMove,
3082
+ React.useCallback(
3083
+ (startIndex: number, endIndex: number) => {
3084
+ return onColumnProposeMove?.(startIndex - rowMarkerOffset, endIndex - rowMarkerOffset) !== false;
3085
+ },
3086
+ [onColumnProposeMove, rowMarkerOffset]
3087
+ )
3088
+ );
3089
+
3090
+ const onColumnMovedImpl = whenDefined(
3091
+ onColumnMoved,
3092
+ React.useCallback(
3093
+ (startIndex: number, endIndex: number) => {
3094
+ onColumnMoved?.(startIndex - rowMarkerOffset, endIndex - rowMarkerOffset);
3095
+ if (columnSelect !== "none") {
3096
+ setSelectedColumns(CompactSelection.fromSingleSelection(endIndex), undefined, true);
3097
+ }
3098
+ },
3099
+ [columnSelect, onColumnMoved, rowMarkerOffset, setSelectedColumns]
3100
+ )
3101
+ );
3102
+
3103
+ const isActivelyDragging = React.useRef(false);
3104
+ const onDragStartImpl = React.useCallback(
3105
+ (args: GridDragEventArgs) => {
3106
+ if (args.location[0] === 0 && rowMarkerOffset > 0) {
3107
+ args.preventDefault();
3108
+ return;
3109
+ }
3110
+ onDragStart?.({
3111
+ ...args,
3112
+ location: [args.location[0] - rowMarkerOffset, args.location[1]] as any,
3113
+ });
3114
+
3115
+ if (!args.defaultPrevented()) {
3116
+ isActivelyDragging.current = true;
3117
+ }
3118
+ setMouseState(undefined);
3119
+ },
3120
+ [onDragStart, rowMarkerOffset]
3121
+ );
3122
+
3123
+ const onDragEnd = React.useCallback(() => {
3124
+ isActivelyDragging.current = false;
3125
+ }, []);
3126
+
3127
+ const rowGroupingSelectionBehavior = rowGrouping?.selectionBehavior;
3128
+
3129
+ const getSelectionRowLimits = React.useCallback(
3130
+ (selectedRow: number): readonly [number, number] | undefined => {
3131
+ if (rowGroupingSelectionBehavior !== "block-spanning") return undefined;
3132
+
3133
+ const { isGroupHeader, path, groupRows } = mapper(selectedRow);
3134
+
3135
+ if (isGroupHeader) {
3136
+ return [selectedRow, selectedRow];
3137
+ }
3138
+
3139
+ const groupRowIndex = path[path.length - 1];
3140
+ const lowerBounds = selectedRow - groupRowIndex;
3141
+ const upperBounds = selectedRow + groupRows - groupRowIndex - 1;
3142
+
3143
+ return [lowerBounds, upperBounds];
3144
+ },
3145
+ [mapper, rowGroupingSelectionBehavior]
3146
+ );
3147
+
3148
+ const hoveredRef = React.useRef<GridMouseEventArgs | undefined>(undefined);
3149
+ const onItemHoveredImpl = React.useCallback(
3150
+ (args: GridMouseEventArgs) => {
3151
+ // make sure we still have a button down
3152
+ if (mouseEventArgsAreEqual(args, hoveredRef.current)) return;
3153
+ hoveredRef.current = args;
3154
+ if (mouseDownData?.current?.button !== undefined && mouseDownData.current.button >= 1) return;
3155
+ if (
3156
+ args.buttons !== 0 &&
3157
+ mouseState !== undefined &&
3158
+ mouseDownData.current?.location[0] === 0 &&
3159
+ rowMarkerOffset === 1 &&
3160
+ rowSelect === "multi" &&
3161
+ mouseState.previousSelection &&
3162
+ !mouseState.previousSelection.rows.hasIndex(mouseDownData.current.location[1]) &&
3163
+ gridSelection.rows.hasIndex(mouseDownData.current.location[1])
3164
+ ) {
3165
+ const start = Math.min(mouseDownData.current.location[1], args.location[1]);
3166
+ const end = Math.max(mouseDownData.current.location[1], args.location[1]) + 1;
3167
+ setSelectedRows(CompactSelection.fromSingleSelection([start, end]), undefined, false);
3168
+ }
3169
+ // Only handle rect selection if not already processed by row selection:
3170
+ else if (
3171
+ args.buttons !== 0 &&
3172
+ mouseState !== undefined &&
3173
+ gridSelection.current !== undefined &&
3174
+ !isActivelyDragging.current &&
3175
+ !isActivelyDraggingHeader.current &&
3176
+ (rangeSelect === "rect" || rangeSelect === "multi-rect")
3177
+ ) {
3178
+ const [selectedCol, selectedRow] = gridSelection.current.cell;
3179
+ // eslint-disable-next-line prefer-const
3180
+ let [col, row] = args.location;
3181
+
3182
+ if (row < 0) {
3183
+ row = visibleRegionRef.current.y;
3184
+ }
3185
+
3186
+ if (mouseState.fillHandle === true && mouseState.previousSelection?.current !== undefined) {
3187
+ const prevRange = mouseState.previousSelection.current.range;
3188
+ row = Math.min(row, showTrailingBlankRow ? rows - 1 : rows);
3189
+ const rect = getClosestRect(prevRange, col, row, allowedFillDirections);
3190
+ // Пунктир протяжки прилипает к границам слитых блоков: частично
3191
+ // задетый блок захватывается целиком (как и последующая запись).
3192
+ const snapped =
3193
+ rect === undefined
3194
+ ? rect
3195
+ : expandRectToSpans(rect, getCellsForSelection, rowMarkerOffset, abortControllerRef.current);
3196
+ setFillHighlightRegion(snapped);
3197
+ } else {
3198
+ const startedFromLastStickyRow = showTrailingBlankRow && selectedRow === rows;
3199
+ if (startedFromLastStickyRow) return;
3200
+
3201
+ const landedOnLastStickyRow = showTrailingBlankRow && row === rows;
3202
+ if (landedOnLastStickyRow) {
3203
+ if (args.kind === outOfBoundsKind) row--;
3204
+ else return;
3205
+ }
3206
+
3207
+ col = Math.max(col, rowMarkerOffset);
3208
+ const clampLimits = getSelectionRowLimits(selectedRow);
3209
+ row = clampLimits === undefined ? row : clamp(row, clampLimits[0], clampLimits[1]);
3210
+
3211
+ // FIXME: Restrict row based on rowGrouping.selectionBehavior here
3212
+
3213
+ const deltaX = col - selectedCol;
3214
+ const deltaY = row - selectedRow;
3215
+
3216
+ const newRange: Rectangle = {
3217
+ x: deltaX >= 0 ? selectedCol : col,
3218
+ y: deltaY >= 0 ? selectedRow : row,
3219
+ width: Math.abs(deltaX) + 1,
3220
+ height: Math.abs(deltaY) + 1,
3221
+ };
3222
+
3223
+ setCurrent(
3224
+ {
3225
+ ...gridSelection.current,
3226
+ range: newRange,
3227
+ },
3228
+ true,
3229
+ false,
3230
+ "drag"
3231
+ );
3232
+ }
3233
+ }
3234
+
3235
+ onItemHovered?.({
3236
+ ...args,
3237
+ location: [args.location[0] - rowMarkerOffset, args.location[1]] as any,
3238
+ // rawLocation сдвигаем на служебные колонки так же, как location.
3239
+ ...(args.kind === "cell" && args.rawLocation !== undefined
3240
+ ? { rawLocation: [args.rawLocation[0] - rowMarkerOffset, args.rawLocation[1]] as any }
3241
+ : undefined),
3242
+ });
3243
+ },
3244
+ [
3245
+ mouseState,
3246
+ rowMarkerOffset,
3247
+ rowSelect,
3248
+ gridSelection,
3249
+ rangeSelect,
3250
+ onItemHovered,
3251
+ setSelectedRows,
3252
+ showTrailingBlankRow,
3253
+ rows,
3254
+ allowedFillDirections,
3255
+ getSelectionRowLimits,
3256
+ setCurrent,
3257
+ getCellsForSelection,
3258
+ ]
3259
+ );
3260
+
3261
+ const adjustSelectionOnScroll = React.useCallback(() => {
3262
+ const args = hoveredRef.current;
3263
+ if (args === undefined) return;
3264
+ const [xDir, yDir] = args.scrollEdge;
3265
+ let [col, row] = args.location;
3266
+ const visible = visibleRegionRef.current;
3267
+ if (xDir === -1) {
3268
+ col = visible.extras?.freezeRegion?.x ?? visible.x;
3269
+ } else if (xDir === 1) {
3270
+ col = visible.x + visible.width;
3271
+ }
3272
+ if (yDir === -1) {
3273
+ row = Math.max(0, visible.y);
3274
+ } else if (yDir === 1) {
3275
+ row = Math.min(rows - 1, visible.y + visible.height);
3276
+ }
3277
+ col = clamp(col, 0, mangledCols.length - 1);
3278
+ row = clamp(row, 0, rows - 1);
3279
+ onItemHoveredImpl({
3280
+ ...args,
3281
+ location: [col, row] as any,
3282
+ });
3283
+ }, [mangledCols.length, onItemHoveredImpl, rows]);
3284
+
3285
+ useAutoscroll(scrollDir, scrollRef, adjustSelectionOnScroll);
3286
+
3287
+ // 1 === move one
3288
+ // 2 === move to end
3289
+ const adjustSelection = React.useCallback(
3290
+ (direction: [0 | 1 | -1 | 2 | -2, 0 | 1 | -1 | 2 | -2]) => {
3291
+ if (gridSelection.current === undefined) return;
3292
+
3293
+ const [x, y] = direction;
3294
+ const [col, row] = gridSelection.current.cell;
3295
+ const old = gridSelection.current.range;
3296
+ let left = old.x;
3297
+ let right = old.x + old.width;
3298
+ let top = old.y;
3299
+ let bottom = old.y + old.height;
3300
+
3301
+ const [minRow, maxRowRaw] = getSelectionRowLimits(row) ?? [0, rows - 1];
3302
+ const maxRow = maxRowRaw + 1; // we need an inclusive value
3303
+
3304
+ // take care of vertical first in case new spans come in
3305
+ if (y !== 0) {
3306
+ switch (y) {
3307
+ case 2: {
3308
+ // go to end
3309
+ bottom = maxRow;
3310
+ top = row;
3311
+ scrollTo(0, bottom, "vertical");
3312
+
3313
+ break;
3314
+ }
3315
+ case -2: {
3316
+ // go to start
3317
+ top = minRow;
3318
+ bottom = row + 1;
3319
+ scrollTo(0, top, "vertical");
3320
+
3321
+ break;
3322
+ }
3323
+ case 1: {
3324
+ // motion down
3325
+ if (top < row) {
3326
+ top++;
3327
+ scrollTo(0, top, "vertical");
3328
+ } else {
3329
+ bottom = Math.min(maxRow, bottom + 1);
3330
+ scrollTo(0, bottom, "vertical");
3331
+ }
3332
+
3333
+ break;
3334
+ }
3335
+ case -1: {
3336
+ // motion up
3337
+ if (bottom > row + 1) {
3338
+ bottom--;
3339
+ scrollTo(0, bottom, "vertical");
3340
+ } else {
3341
+ top = Math.max(minRow, top - 1);
3342
+ scrollTo(0, top, "vertical");
3343
+ }
3344
+
3345
+ break;
3346
+ }
3347
+ default: {
3348
+ assertNever(y);
3349
+ }
3350
+ }
3351
+ }
3352
+
3353
+ if (x !== 0) {
3354
+ if (x === 2) {
3355
+ right = mangledCols.length;
3356
+ left = col;
3357
+ scrollTo(right - 1 - rowMarkerOffset, 0, "horizontal");
3358
+ } else if (x === -2) {
3359
+ left = rowMarkerOffset;
3360
+ right = col + 1;
3361
+ scrollTo(left - rowMarkerOffset, 0, "horizontal");
3362
+ } else {
3363
+ let disallowed: number[] = [];
3364
+ if (getCellsForSelection !== undefined) {
3365
+ const cells = getCellsForSelection(
3366
+ {
3367
+ x: left,
3368
+ y: top,
3369
+ width: right - left - rowMarkerOffset,
3370
+ height: bottom - top,
3371
+ },
3372
+ abortControllerRef.current.signal
3373
+ );
3374
+
3375
+ if (typeof cells === "object") {
3376
+ disallowed = getSpanStops(cells);
3377
+ }
3378
+ }
3379
+ if (x === 1) {
3380
+ // motion right
3381
+ let done = false;
3382
+ if (left < col) {
3383
+ if (disallowed.length > 0) {
3384
+ const target = range(left + 1, col + 1).find(
3385
+ n => !disallowed.includes(n - rowMarkerOffset)
3386
+ );
3387
+ if (target !== undefined) {
3388
+ left = target;
3389
+ done = true;
3390
+ }
3391
+ } else {
3392
+ left++;
3393
+ done = true;
3394
+ }
3395
+ if (done) scrollTo(left, 0, "horizontal");
3396
+ }
3397
+ if (!done) {
3398
+ right = Math.min(mangledCols.length, right + 1);
3399
+ scrollTo(right - 1 - rowMarkerOffset, 0, "horizontal");
3400
+ }
3401
+ } else if (x === -1) {
3402
+ // motion left
3403
+ let done = false;
3404
+ if (right > col + 1) {
3405
+ if (disallowed.length > 0) {
3406
+ const target = range(right - 1, col, -1).find(
3407
+ n => !disallowed.includes(n - rowMarkerOffset)
3408
+ );
3409
+ if (target !== undefined) {
3410
+ right = target;
3411
+ done = true;
3412
+ }
3413
+ } else {
3414
+ right--;
3415
+ done = true;
3416
+ }
3417
+ if (done) scrollTo(right - rowMarkerOffset, 0, "horizontal");
3418
+ }
3419
+ if (!done) {
3420
+ left = Math.max(rowMarkerOffset, left - 1);
3421
+ scrollTo(left - rowMarkerOffset, 0, "horizontal");
3422
+ }
3423
+ } else {
3424
+ assertNever(x);
3425
+ }
3426
+ }
3427
+ }
3428
+
3429
+ setCurrent(
3430
+ {
3431
+ cell: gridSelection.current.cell,
3432
+ range: {
3433
+ x: left,
3434
+ y: top,
3435
+ width: right - left,
3436
+ height: bottom - top,
3437
+ },
3438
+ },
3439
+ true,
3440
+ false,
3441
+ "keyboard-select"
3442
+ );
3443
+ },
3444
+ [
3445
+ getCellsForSelection,
3446
+ getSelectionRowLimits,
3447
+ gridSelection,
3448
+ mangledCols.length,
3449
+ rowMarkerOffset,
3450
+ rows,
3451
+ scrollTo,
3452
+ setCurrent,
3453
+ ]
3454
+ );
3455
+
3456
+ const scrollToActiveCellRef = React.useRef(scrollToActiveCell);
3457
+ scrollToActiveCellRef.current = scrollToActiveCell;
3458
+
3459
+ const updateSelectedCell = React.useCallback(
3460
+ (col: number, row: number, fromEditingTrailingRow: boolean, freeMove: boolean): boolean => {
3461
+ const rowMax = mangledRows - (fromEditingTrailingRow ? 0 : 1);
3462
+ col = clamp(col, rowMarkerOffset, columns.length - 1 + rowMarkerOffset);
3463
+ row = clamp(row, 0, rowMax);
3464
+
3465
+ const curCol = currentCell?.[0];
3466
+ const curRow = currentCell?.[1];
3467
+
3468
+ if (col === curCol && row === curRow) return false;
3469
+ if (freeMove && gridSelection.current !== undefined) {
3470
+ const newStack = [...gridSelection.current.rangeStack];
3471
+ if (gridSelection.current.range.width > 1 || gridSelection.current.range.height > 1) {
3472
+ newStack.push(gridSelection.current.range);
3473
+ }
3474
+ setGridSelection(
3475
+ {
3476
+ ...gridSelection,
3477
+ current: {
3478
+ cell: [col, row],
3479
+ range: { x: col, y: row, width: 1, height: 1 },
3480
+ rangeStack: newStack,
3481
+ },
3482
+ },
3483
+ true
3484
+ );
3485
+ } else {
3486
+ setCurrent(
3487
+ {
3488
+ cell: [col, row],
3489
+ range: { x: col, y: row, width: 1, height: 1 },
3490
+ },
3491
+ true,
3492
+ false,
3493
+ "keyboard-nav"
3494
+ );
3495
+ }
3496
+
3497
+ if (lastSent.current !== undefined && lastSent.current[0] === col && lastSent.current[1] === row) {
3498
+ lastSent.current = undefined;
3499
+ }
3500
+
3501
+ if (scrollToActiveCellRef.current) {
3502
+ scrollTo(col - rowMarkerOffset, row);
3503
+ }
3504
+
3505
+ return true;
3506
+ },
3507
+ [
3508
+ mangledRows,
3509
+ rowMarkerOffset,
3510
+ columns.length,
3511
+ currentCell,
3512
+ gridSelection,
3513
+ scrollTo,
3514
+ setGridSelection,
3515
+ setCurrent,
3516
+ ]
3517
+ );
3518
+
3519
+ const onFinishEditing = React.useCallback(
3520
+ (newValue: GridCell | undefined, movement: readonly [-1 | 0 | 1, -1 | 0 | 1]) => {
3521
+ if (overlay?.cell !== undefined && newValue !== undefined && isEditableGridCell(newValue)) {
3522
+ mangledOnCellsEdited([{ location: overlay.cell, value: newValue }]);
3523
+ window.requestAnimationFrame(() => {
3524
+ gridRef.current?.damage([
3525
+ {
3526
+ cell: overlay.cell,
3527
+ },
3528
+ ]);
3529
+ });
3530
+ }
3531
+ focus(true);
3532
+ setOverlay(undefined);
3533
+
3534
+ const [movX, movY] = movement;
3535
+ if (gridSelection.current !== undefined && (movX !== 0 || movY !== 0)) {
3536
+ const isEditingLastRow = gridSelection.current.cell[1] === mangledRows - 1 && newValue !== undefined;
3537
+ const isEditingLastCol =
3538
+ gridSelection.current.cell[0] === mangledCols.length - 1 && newValue !== undefined;
3539
+ let updateSelected = true;
3540
+ if (isEditingLastRow && movY === 1 && onRowAppended !== undefined) {
3541
+ updateSelected = false;
3542
+ const col = gridSelection.current.cell[0] + movX;
3543
+ const customTargetColumn = getCustomNewRowTargetColumn(col);
3544
+ void appendRow(customTargetColumn ?? col, false);
3545
+ }
3546
+ if (isEditingLastCol && movX === 1 && onColumnAppended !== undefined) {
3547
+ updateSelected = false;
3548
+ const row = gridSelection.current.cell[1] + movY;
3549
+ void appendColumn(row, false);
3550
+ }
3551
+ if (updateSelected) {
3552
+ updateSelectedCell(
3553
+ clamp(gridSelection.current.cell[0] + movX, 0, mangledCols.length - 1),
3554
+ clamp(gridSelection.current.cell[1] + movY, 0, mangledRows - 1),
3555
+ isEditingLastRow,
3556
+ false
3557
+ );
3558
+ }
3559
+ }
3560
+ onFinishedEditing?.(newValue, movement);
3561
+ },
3562
+ [
3563
+ overlay?.cell,
3564
+ focus,
3565
+ gridSelection,
3566
+ onFinishedEditing,
3567
+ mangledOnCellsEdited,
3568
+ mangledRows,
3569
+ updateSelectedCell,
3570
+ mangledCols.length,
3571
+ appendRow,
3572
+ appendColumn,
3573
+ onRowAppended,
3574
+ onColumnAppended,
3575
+ getCustomNewRowTargetColumn,
3576
+ ]
3577
+ );
3578
+
3579
+ const overlayID = React.useMemo(() => {
3580
+ return `gdg-overlay-${idCounter++}`;
3581
+ }, []);
3582
+
3583
+ const deleteRange = React.useCallback(
3584
+ (r: Rectangle) => {
3585
+ focus();
3586
+ const editList: EditListItem[] = [];
3587
+ for (let x = r.x; x < r.x + r.width; x++) {
3588
+ for (let y = r.y; y < r.y + r.height; y++) {
3589
+ const cellValue = getCellContent([x - rowMarkerOffset, y]);
3590
+ // Покрытая ячейка слитого блока: очистку выполнит origin (если он в диапазоне),
3591
+ // здесь пропускаем — иначе onCellEdited летит в середину блока.
3592
+ if (isCoveredSpanCell(cellValue, x - rowMarkerOffset, y)) {
3593
+ continue;
3594
+ }
3595
+ if (!cellValue.allowOverlay && cellValue.kind !== GridCellKind.Boolean) continue;
3596
+ let newVal: InnerGridCell | undefined = undefined;
3597
+ if (cellValue.kind === GridCellKind.Custom) {
3598
+ const toDelete = getCellRenderer(cellValue);
3599
+ const editor = toDelete?.provideEditor?.({
3600
+ ...cellValue,
3601
+ location: [x - rowMarkerOffset, y],
3602
+ });
3603
+ if (toDelete?.onDelete !== undefined) {
3604
+ newVal = toDelete.onDelete(cellValue);
3605
+ } else if (isObjectEditorCallbackResult(editor)) {
3606
+ newVal = editor?.deletedValue?.(cellValue);
3607
+ }
3608
+ } else if (
3609
+ (isEditableGridCell(cellValue) && cellValue.allowOverlay) ||
3610
+ cellValue.kind === GridCellKind.Boolean
3611
+ ) {
3612
+ const toDelete = getCellRenderer(cellValue);
3613
+ newVal = toDelete?.onDelete?.(cellValue);
3614
+ }
3615
+ if (newVal !== undefined && !isInnerOnlyCell(newVal) && isEditableGridCell(newVal)) {
3616
+ editList.push({ location: [x, y], value: newVal });
3617
+ }
3618
+ }
3619
+ }
3620
+ mangledOnCellsEdited(editList);
3621
+ gridRef.current?.damage(editList.map(x => ({ cell: x.location })));
3622
+ },
3623
+ [focus, getCellContent, getCellRenderer, mangledOnCellsEdited, rowMarkerOffset]
3624
+ );
3625
+
3626
+ const overlayOpen = overlay !== undefined;
3627
+
3628
+ const handleFixedKeybindings = React.useCallback(
3629
+ (event: GridKeyEventArgs): boolean => {
3630
+ const cancel = () => {
3631
+ event.stopPropagation();
3632
+ event.preventDefault();
3633
+ };
3634
+
3635
+ const details = {
3636
+ didMatch: false,
3637
+ };
3638
+
3639
+ const { bounds } = event;
3640
+ const selectedColumns = gridSelection.columns;
3641
+ const selectedRows = gridSelection.rows;
3642
+
3643
+ const keys = keybindings;
3644
+
3645
+ if (!overlayOpen && isHotkey(keys.clear, event, details)) {
3646
+ setGridSelection(emptyGridSelection, false);
3647
+ onSelectionCleared?.();
3648
+ } else if (!overlayOpen && isHotkey(keys.selectAll, event, details)) {
3649
+ setGridSelection(
3650
+ {
3651
+ columns: CompactSelection.empty(),
3652
+ rows: CompactSelection.empty(),
3653
+ current: {
3654
+ cell: gridSelection.current?.cell ?? [rowMarkerOffset, 0],
3655
+ range: {
3656
+ x: rowMarkerOffset,
3657
+ y: 0,
3658
+ width: columnsIn.length,
3659
+ height: rows,
3660
+ },
3661
+ rangeStack: [],
3662
+ },
3663
+ },
3664
+ false
3665
+ );
3666
+ } else if (isHotkey(keys.search, event, details)) {
3667
+ searchInputRef?.current?.focus({ preventScroll: true });
3668
+ setShowSearchInner(true);
3669
+ } else if (isHotkey(keys.delete, event, details)) {
3670
+ const callbackResult = onDelete?.(gridSelection) ?? true;
3671
+ if (callbackResult !== false) {
3672
+ const toDelete = callbackResult === true ? gridSelection : callbackResult;
3673
+
3674
+ // delete order:
3675
+ // 1) primary range
3676
+ // 2) secondary ranges
3677
+ // 3) columns
3678
+ // 4) rows
3679
+
3680
+ if (toDelete.current !== undefined) {
3681
+ deleteRange(toDelete.current.range);
3682
+ for (const r of toDelete.current.rangeStack) {
3683
+ deleteRange(r);
3684
+ }
3685
+ }
3686
+
3687
+ for (const r of toDelete.rows) {
3688
+ deleteRange({
3689
+ x: rowMarkerOffset,
3690
+ y: r,
3691
+ width: columnsIn.length,
3692
+ height: 1,
3693
+ });
3694
+ }
3695
+
3696
+ for (const col of toDelete.columns) {
3697
+ deleteRange({
3698
+ x: col,
3699
+ y: 0,
3700
+ width: 1,
3701
+ height: rows,
3702
+ });
3703
+ }
3704
+ }
3705
+ }
3706
+
3707
+ if (details.didMatch) {
3708
+ cancel();
3709
+ return true;
3710
+ }
3711
+
3712
+ if (gridSelection.current === undefined) return false;
3713
+ let [col, row] = gridSelection.current.cell;
3714
+ const [startCol, startRow] = gridSelection.current.cell;
3715
+ let freeMove = false;
3716
+ let cancelOnlyOnMove = false;
3717
+ // Направление одиночного шага стрелкой ([dx, dy]); задаётся только клавишами
3718
+ // перехода на соседнюю ячейку. Нужен для merged-aware навигации ниже.
3719
+ let arrowStep: readonly [number, number] | undefined = undefined;
3720
+
3721
+ if (isHotkey(keys.scrollToSelectedCell, event, details)) {
3722
+ scrollToRef.current(col - rowMarkerOffset, row);
3723
+ } else if (columnSelect !== "none" && isHotkey(keys.selectColumn, event, details)) {
3724
+ if (selectedColumns.hasIndex(col)) {
3725
+ setSelectedColumns(selectedColumns.remove(col), undefined, true);
3726
+ } else {
3727
+ if (columnSelect === "single") {
3728
+ setSelectedColumns(CompactSelection.fromSingleSelection(col), undefined, true);
3729
+ } else {
3730
+ setSelectedColumns(undefined, col, true);
3731
+ }
3732
+ }
3733
+ } else if (rowSelect !== "none" && isHotkey(keys.selectRow, event, details)) {
3734
+ if (selectedRows.hasIndex(row)) {
3735
+ setSelectedRows(selectedRows.remove(row), undefined, true);
3736
+ } else {
3737
+ if (rowSelect === "single") {
3738
+ setSelectedRows(CompactSelection.fromSingleSelection(row), undefined, true);
3739
+ } else {
3740
+ setSelectedRows(undefined, row, true);
3741
+ }
3742
+ }
3743
+ } else if (!overlayOpen && bounds !== undefined && isHotkey(keys.activateCell, event, details)) {
3744
+ if (row === rows && showTrailingBlankRow) {
3745
+ window.setTimeout(() => {
3746
+ const customTargetColumn = getCustomNewRowTargetColumn(col);
3747
+ void appendRow(customTargetColumn ?? col);
3748
+ }, 0);
3749
+ } else {
3750
+ const activationEvent: CellActivatedEventArgs = {
3751
+ inputType: "keyboard",
3752
+ key: event.key,
3753
+ };
3754
+ onCellActivated?.([col - rowMarkerOffset, row], activationEvent);
3755
+ reselect(bounds, activationEvent);
3756
+ }
3757
+ } else if (gridSelection.current.range.height > 1 && isHotkey(keys.downFill, event, details)) {
3758
+ fillDown();
3759
+ } else if (gridSelection.current.range.width > 1 && isHotkey(keys.rightFill, event, details)) {
3760
+ fillRight();
3761
+ } else if (isHotkey(keys.goToNextPage, event, details)) {
3762
+ row += Math.max(1, visibleRegionRef.current.height - 4); // partial cell accounting
3763
+ } else if (isHotkey(keys.goToPreviousPage, event, details)) {
3764
+ row -= Math.max(1, visibleRegionRef.current.height - 4); // partial cell accounting
3765
+ } else if (isHotkey(keys.goToFirstCell, event, details)) {
3766
+ setOverlay(undefined);
3767
+ row = 0;
3768
+ col = 0;
3769
+ } else if (isHotkey(keys.goToLastCell, event, details)) {
3770
+ setOverlay(undefined);
3771
+ row = Number.MAX_SAFE_INTEGER;
3772
+ col = Number.MAX_SAFE_INTEGER;
3773
+ } else if (isHotkey(keys.selectToFirstCell, event, details)) {
3774
+ setOverlay(undefined);
3775
+ adjustSelection([-2, -2]);
3776
+ } else if (isHotkey(keys.selectToLastCell, event, details)) {
3777
+ setOverlay(undefined);
3778
+ adjustSelection([2, 2]);
3779
+ } else if (!overlayOpen) {
3780
+ if (isHotkey(keys.goDownCell, event, details)) {
3781
+ row += 1;
3782
+ arrowStep = [0, 1];
3783
+ } else if (isHotkey(keys.goUpCell, event, details)) {
3784
+ row -= 1;
3785
+ arrowStep = [0, -1];
3786
+ } else if (isHotkey(keys.goRightCell, event, details)) {
3787
+ col += 1;
3788
+ arrowStep = [1, 0];
3789
+ } else if (isHotkey(keys.goLeftCell, event, details)) {
3790
+ col -= 1;
3791
+ arrowStep = [-1, 0];
3792
+ } else if (isHotkey(keys.goDownCellRetainSelection, event, details)) {
3793
+ row += 1;
3794
+ freeMove = true;
3795
+ arrowStep = [0, 1];
3796
+ } else if (isHotkey(keys.goUpCellRetainSelection, event, details)) {
3797
+ row -= 1;
3798
+ freeMove = true;
3799
+ arrowStep = [0, -1];
3800
+ } else if (isHotkey(keys.goRightCellRetainSelection, event, details)) {
3801
+ col += 1;
3802
+ freeMove = true;
3803
+ arrowStep = [1, 0];
3804
+ } else if (isHotkey(keys.goLeftCellRetainSelection, event, details)) {
3805
+ col -= 1;
3806
+ freeMove = true;
3807
+ arrowStep = [-1, 0];
3808
+ } else if (isHotkey(keys.goToLastRow, event, details)) {
3809
+ // Прыжок в начало или конец сбрасывает память полосы, как клик.
3810
+ arrowLaneRef.current = {};
3811
+ row = rows - 1;
3812
+ } else if (isHotkey(keys.goToFirstRow, event, details)) {
3813
+ arrowLaneRef.current = {};
3814
+ row = Number.MIN_SAFE_INTEGER;
3815
+ } else if (isHotkey(keys.goToLastColumn, event, details)) {
3816
+ arrowLaneRef.current = {};
3817
+ col = Number.MAX_SAFE_INTEGER;
3818
+ } else if (isHotkey(keys.goToFirstColumn, event, details)) {
3819
+ arrowLaneRef.current = {};
3820
+ col = Number.MIN_SAFE_INTEGER;
3821
+ } else if (rangeSelect === "rect" || rangeSelect === "multi-rect") {
3822
+ if (isHotkey(keys.selectGrowDown, event, details)) {
3823
+ adjustSelection([0, 1]);
3824
+ } else if (isHotkey(keys.selectGrowUp, event, details)) {
3825
+ adjustSelection([0, -1]);
3826
+ } else if (isHotkey(keys.selectGrowRight, event, details)) {
3827
+ adjustSelection([1, 0]);
3828
+ } else if (isHotkey(keys.selectGrowLeft, event, details)) {
3829
+ adjustSelection([-1, 0]);
3830
+ } else if (isHotkey(keys.selectToLastRow, event, details)) {
3831
+ adjustSelection([0, 2]);
3832
+ } else if (isHotkey(keys.selectToFirstRow, event, details)) {
3833
+ adjustSelection([0, -2]);
3834
+ } else if (isHotkey(keys.selectToLastColumn, event, details)) {
3835
+ adjustSelection([2, 0]);
3836
+ } else if (isHotkey(keys.selectToFirstColumn, event, details)) {
3837
+ adjustSelection([-2, 0]);
3838
+ }
3839
+ }
3840
+ cancelOnlyOnMove = details.didMatch;
3841
+ } else {
3842
+ if (isHotkey(keys.closeOverlay, event, details)) {
3843
+ setOverlay(undefined);
3844
+ }
3845
+
3846
+ if (isHotkey(keys.acceptOverlayDown, event, details)) {
3847
+ setOverlay(undefined);
3848
+ row++;
3849
+ }
3850
+
3851
+ if (isHotkey(keys.acceptOverlayUp, event, details)) {
3852
+ setOverlay(undefined);
3853
+ row--;
3854
+ }
3855
+
3856
+ if (isHotkey(keys.acceptOverlayLeft, event, details)) {
3857
+ setOverlay(undefined);
3858
+ col--;
3859
+ }
3860
+
3861
+ if (isHotkey(keys.acceptOverlayRight, event, details)) {
3862
+ setOverlay(undefined);
3863
+ col++;
3864
+ }
3865
+ }
3866
+ // #endregion
3867
+
3868
+ // Стрелочная навигация с учётом объединений: один шаг перепрыгивает весь
3869
+ // блок, а не идёт по его покрытым ячейкам. По оси движения берём дальнюю
3870
+ // грань блока и шагаем за неё. Поперёк движения работает память полосы:
3871
+ // строку и колонку входа помним и выходим на них, а не на верх блока.
3872
+ if (arrowStep !== undefined) {
3873
+ const startCell = getMangledCellContent([startCol, startRow]);
3874
+ const [blockLeft, blockRight] = startCell.span ?? [startCol, startCol];
3875
+ const [blockTop, blockBottom] = startCell.spanRows ?? [startRow, startRow];
3876
+ const [dx, dy] = arrowStep;
3877
+ const lane = arrowLaneRef.current;
3878
+ if (dy !== 0) {
3879
+ row = dy > 0 ? blockBottom + 1 : blockTop - 1;
3880
+ // Колонка входа: на обычной ячейке запоминаем текущую; внутри
3881
+ // широкого блока используем запомненную, если она внутри блока.
3882
+ if (
3883
+ startCell.span === undefined ||
3884
+ lane.col === undefined ||
3885
+ lane.col < blockLeft ||
3886
+ lane.col > blockRight
3887
+ ) {
3888
+ lane.col = startCol;
3889
+ }
3890
+ col = lane.col;
3891
+ } else if (dx !== 0) {
3892
+ col = dx > 0 ? blockRight + 1 : blockLeft - 1;
3893
+ // Строка входа: то же самое для высокого блока.
3894
+ if (
3895
+ startCell.spanRows === undefined ||
3896
+ lane.row === undefined ||
3897
+ lane.row < blockTop ||
3898
+ lane.row > blockBottom
3899
+ ) {
3900
+ lane.row = startRow;
3901
+ }
3902
+ row = lane.row;
3903
+ }
3904
+ }
3905
+
3906
+ const mustRestrictRow = rowGroupingNavBehavior !== undefined && rowGroupingNavBehavior !== "normal";
3907
+
3908
+ if (mustRestrictRow && row !== startRow) {
3909
+ const skipUp =
3910
+ rowGroupingNavBehavior === "skip-up" ||
3911
+ rowGroupingNavBehavior === "skip" ||
3912
+ rowGroupingNavBehavior === "block";
3913
+ const skipDown =
3914
+ rowGroupingNavBehavior === "skip-down" ||
3915
+ rowGroupingNavBehavior === "skip" ||
3916
+ rowGroupingNavBehavior === "block";
3917
+ const didMoveUp = row < startRow;
3918
+ if (didMoveUp && skipUp) {
3919
+ while (row >= 0 && mapper(row).isGroupHeader) {
3920
+ row--;
3921
+ }
3922
+
3923
+ if (row < 0) {
3924
+ row = startRow;
3925
+ }
3926
+ } else if (!didMoveUp && skipDown) {
3927
+ while (row < rows && mapper(row).isGroupHeader) {
3928
+ row++;
3929
+ }
3930
+
3931
+ if (row >= rows) {
3932
+ row = startRow;
3933
+ }
3934
+ }
3935
+ }
3936
+
3937
+ // Ход по оси задаёт полосу этой оси заново: вертикальный шаг запоминает
3938
+ // строку уже после пропуска строк-заголовков групп, горизонтальный — колонку.
3939
+ if (arrowStep !== undefined) {
3940
+ const [dx, dy] = arrowStep;
3941
+ if (dy !== 0) {
3942
+ arrowLaneRef.current.row = row;
3943
+ } else if (dx !== 0) {
3944
+ arrowLaneRef.current.col = col;
3945
+ }
3946
+ }
3947
+
3948
+ // Приземление нормализуем к origin блока-соседа (как это делает клик), чтобы
3949
+ // фокус всегда стоял на origin и следующий шаг стрелкой был корректным.
3950
+ if (arrowStep !== undefined) {
3951
+ const inBounds =
3952
+ row >= 0 &&
3953
+ row < rows &&
3954
+ col >= rowMarkerOffset &&
3955
+ col <= columns.length - 1 + rowMarkerOffset;
3956
+ if (inBounds) {
3957
+ const landed = getMangledCellContent([col, row]);
3958
+ [col, row] = getSpanOrigin(landed, col, row);
3959
+ }
3960
+ }
3961
+
3962
+ const moved = updateSelectedCell(col, row, false, freeMove);
3963
+
3964
+ const didMatch = details.didMatch;
3965
+
3966
+ if (didMatch && (moved || !cancelOnlyOnMove || trapFocus)) {
3967
+ cancel();
3968
+ }
3969
+
3970
+ return didMatch;
3971
+ },
3972
+ [
3973
+ rowGroupingNavBehavior,
3974
+ overlayOpen,
3975
+ gridSelection,
3976
+ keybindings,
3977
+ columnSelect,
3978
+ rowSelect,
3979
+ rangeSelect,
3980
+ rowMarkerOffset,
3981
+ mapper,
3982
+ rows,
3983
+ columns.length,
3984
+ getMangledCellContent,
3985
+ updateSelectedCell,
3986
+ setGridSelection,
3987
+ onSelectionCleared,
3988
+ columnsIn.length,
3989
+ onDelete,
3990
+ trapFocus,
3991
+ deleteRange,
3992
+ setSelectedColumns,
3993
+ setSelectedRows,
3994
+ showTrailingBlankRow,
3995
+ getCustomNewRowTargetColumn,
3996
+ appendRow,
3997
+ onCellActivated,
3998
+ reselect,
3999
+ fillDown,
4000
+ fillRight,
4001
+ adjustSelection,
4002
+ ]
4003
+ );
4004
+
4005
+ const onKeyDown = React.useCallback(
4006
+ (event: GridKeyEventArgs) => {
4007
+ let cancelled = false;
4008
+ if (onKeyDownIn !== undefined) {
4009
+ onKeyDownIn({
4010
+ ...event,
4011
+ ...(event.location && {
4012
+ location: [event.location[0] - rowMarkerOffset, event.location[1]] as any,
4013
+ }),
4014
+ cancel: () => {
4015
+ cancelled = true;
4016
+ },
4017
+ });
4018
+ }
4019
+
4020
+ if (cancelled) return;
4021
+
4022
+ if (handleFixedKeybindings(event)) return;
4023
+
4024
+ if (gridSelection.current === undefined) return;
4025
+ const [col, row] = gridSelection.current.cell;
4026
+ const vr = visibleRegionRef.current;
4027
+
4028
+ if (
4029
+ editOnType &&
4030
+ !event.metaKey &&
4031
+ !event.ctrlKey &&
4032
+ gridSelection.current !== undefined &&
4033
+ event.key.length === 1 &&
4034
+ /[\p{L}\p{M}\p{N}\p{S}\p{P}]/u.test(event.key) &&
4035
+ event.bounds !== undefined &&
4036
+ isReadWriteCell(getCellContent([col - rowMarkerOffset, Math.max(0, Math.min(row, rows - 1))]))
4037
+ ) {
4038
+ if (
4039
+ (!showTrailingBlankRow || row !== rows) &&
4040
+ (vr.y > row || row > vr.y + vr.height || vr.x > col || col > vr.x + vr.width)
4041
+ ) {
4042
+ return;
4043
+ }
4044
+ const activationEvent: CellActivatedEventArgs = {
4045
+ inputType: "keyboard",
4046
+ key: event.key,
4047
+ };
4048
+ onCellActivated?.([col - rowMarkerOffset, row], activationEvent);
4049
+ reselect(event.bounds, activationEvent, event.key);
4050
+ event.stopPropagation();
4051
+ event.preventDefault();
4052
+ }
4053
+ },
4054
+ [
4055
+ editOnType,
4056
+ onKeyDownIn,
4057
+ handleFixedKeybindings,
4058
+ gridSelection,
4059
+ getCellContent,
4060
+ rowMarkerOffset,
4061
+ rows,
4062
+ showTrailingBlankRow,
4063
+ onCellActivated,
4064
+ reselect,
4065
+ ]
4066
+ );
4067
+
4068
+ const onContextMenu = React.useCallback(
4069
+ (args: GridMouseEventArgs, preventDefault: () => void) => {
4070
+ const adjustedCol = args.location[0] - rowMarkerOffset;
4071
+ if (args.kind === "header") {
4072
+ onHeaderContextMenu?.(adjustedCol, { ...args, preventDefault });
4073
+ }
4074
+
4075
+ if (args.kind === groupHeaderKind) {
4076
+ if (adjustedCol < 0) {
4077
+ return;
4078
+ }
4079
+ onGroupHeaderContextMenu?.(adjustedCol, { ...args, preventDefault });
4080
+ }
4081
+
4082
+ if (args.kind === "cell") {
4083
+ const [col, row] = args.location;
4084
+ onCellContextMenu?.([adjustedCol, row], {
4085
+ ...args,
4086
+ preventDefault,
4087
+ });
4088
+
4089
+ if (!gridSelectionHasItem(gridSelection, args.location)) {
4090
+ updateSelectedCell(col, row, false, false);
4091
+ }
4092
+ }
4093
+ },
4094
+ [
4095
+ gridSelection,
4096
+ onCellContextMenu,
4097
+ onGroupHeaderContextMenu,
4098
+ onHeaderContextMenu,
4099
+ rowMarkerOffset,
4100
+ updateSelectedCell,
4101
+ ]
4102
+ );
4103
+
4104
+ const onPasteInternal = React.useCallback(
4105
+ async (e?: ClipboardEvent) => {
4106
+ if (!keybindings.paste) return;
4107
+ function pasteToCell(
4108
+ inner: InnerGridCell,
4109
+ target: Item,
4110
+ rawValue: string | boolean | string[] | number | boolean | BooleanEmpty | BooleanIndeterminate,
4111
+ formatted?: string | string[]
4112
+ ): EditListItem | undefined {
4113
+ const stringifiedRawValue =
4114
+ typeof rawValue === "object" ? (rawValue?.join("\n") ?? "") : (rawValue?.toString() ?? "");
4115
+
4116
+ if (!isInnerOnlyCell(inner) && isReadWriteCell(inner) && inner.readonly !== true) {
4117
+ const coerced = coercePasteValue?.(stringifiedRawValue, inner);
4118
+ if (coerced !== undefined && isEditableGridCell(coerced)) {
4119
+ if (process.env.NODE_ENV !== "production" && coerced.kind !== inner.kind) {
4120
+ // eslint-disable-next-line no-console
4121
+ console.warn("Coercion should not change cell kind.");
4122
+ }
4123
+ return {
4124
+ location: target,
4125
+ value: coerced,
4126
+ };
4127
+ }
4128
+ const r = getCellRenderer(inner);
4129
+ if (r === undefined) return undefined;
4130
+ if (r.kind === GridCellKind.Custom) {
4131
+ assert(inner.kind === GridCellKind.Custom);
4132
+ const newVal = (r as unknown as CustomRenderer<CustomCell<any>>).onPaste?.(
4133
+ stringifiedRawValue,
4134
+ inner.data
4135
+ );
4136
+ if (newVal === undefined) return undefined;
4137
+ return {
4138
+ location: target,
4139
+ value: {
4140
+ ...inner,
4141
+ data: newVal,
4142
+ },
4143
+ };
4144
+ } else {
4145
+ const newVal = r.onPaste?.(stringifiedRawValue, inner, {
4146
+ formatted,
4147
+ formattedString: typeof formatted === "string" ? formatted : formatted?.join("\n"),
4148
+ rawValue,
4149
+ });
4150
+ if (newVal === undefined) return undefined;
4151
+ assert(newVal.kind === inner.kind);
4152
+ return {
4153
+ location: target,
4154
+ value: newVal,
4155
+ };
4156
+ }
4157
+ }
4158
+ return undefined;
4159
+ }
4160
+
4161
+ const selectedColumns = gridSelection.columns;
4162
+ const selectedRows = gridSelection.rows;
4163
+ const focused =
4164
+ scrollRef.current?.contains(document.activeElement) === true ||
4165
+ canvasRef.current?.contains(document.activeElement) === true;
4166
+
4167
+ let target: Item | undefined;
4168
+
4169
+ if (gridSelection.current !== undefined) {
4170
+ target = [gridSelection.current.range.x, gridSelection.current.range.y];
4171
+ } else if (selectedColumns.length === 1) {
4172
+ target = [selectedColumns.first() ?? 0, 0];
4173
+ } else if (selectedRows.length === 1) {
4174
+ target = [rowMarkerOffset, selectedRows.first() ?? 0];
4175
+ }
4176
+
4177
+ if (focused && target !== undefined) {
4178
+ let data: CopyBuffer | undefined;
4179
+ let text: string | undefined;
4180
+
4181
+ const textPlain = "text/plain";
4182
+ const textHtml = "text/html";
4183
+
4184
+ if (navigator.clipboard.read !== undefined) {
4185
+ const clipboardContent = await navigator.clipboard.read();
4186
+
4187
+ for (const item of clipboardContent) {
4188
+ if (item.types.includes(textHtml)) {
4189
+ const htmlBlob = await item.getType(textHtml);
4190
+ const html = await htmlBlob.text();
4191
+ const decoded = decodeHTML(html);
4192
+ if (decoded !== undefined) {
4193
+ data = decoded;
4194
+ break;
4195
+ }
4196
+ }
4197
+ if (item.types.includes(textPlain)) {
4198
+ // eslint-disable-next-line unicorn/no-await-expression-member
4199
+ text = await (await item.getType(textPlain)).text();
4200
+ }
4201
+ }
4202
+ } else if (navigator.clipboard.readText !== undefined) {
4203
+ text = await navigator.clipboard.readText();
4204
+ } else if (e !== undefined && e?.clipboardData !== null) {
4205
+ if (e.clipboardData.types.includes(textHtml)) {
4206
+ const html = e.clipboardData.getData(textHtml);
4207
+ data = decodeHTML(html);
4208
+ }
4209
+ if (data === undefined && e.clipboardData.types.includes(textPlain)) {
4210
+ text = e.clipboardData.getData(textPlain);
4211
+ }
4212
+ } else {
4213
+ return; // I didn't want to read that paste value anyway
4214
+ }
4215
+
4216
+ const [targetCol, targetRow] = target;
4217
+
4218
+ const editList: EditListItem[] = [];
4219
+ do {
4220
+ if (onPaste === undefined) {
4221
+ const cellData = getMangledCellContent(target);
4222
+ const rawValue = text ?? data?.map(r => r.map(cb => cb.rawValue).join("\t")).join("\t") ?? "";
4223
+ const newVal = pasteToCell(cellData, target, rawValue, undefined);
4224
+ if (newVal !== undefined) {
4225
+ editList.push(newVal);
4226
+ }
4227
+ break;
4228
+ }
4229
+
4230
+ if (data === undefined) {
4231
+ if (text === undefined) return;
4232
+ data = unquote(text);
4233
+ }
4234
+
4235
+ if (
4236
+ onPaste === false ||
4237
+ (typeof onPaste === "function" &&
4238
+ onPaste?.(
4239
+ [target[0] - rowMarkerOffset, target[1]],
4240
+ data.map(r => r.map(cb => cb.rawValue?.toString() ?? ""))
4241
+ ) !== true)
4242
+ ) {
4243
+ return;
4244
+ }
4245
+
4246
+ for (const [row, dataRow] of data.entries()) {
4247
+ if (row + targetRow >= rows) break;
4248
+ for (const [col, dataItem] of dataRow.entries()) {
4249
+ const index = [col + targetCol, row + targetRow] as const;
4250
+ const [writeCol, writeRow] = index;
4251
+ if (writeCol >= mangledCols.length) continue;
4252
+ if (writeRow >= mangledRows) continue;
4253
+ const cellData = getMangledCellContent(index);
4254
+ // Покрытая ячейка слитого блока: пишем только в origin, покрытые
4255
+ // координаты пропускаем — иначе вставка попадёт в середину блока.
4256
+ if (isCoveredSpanCell(cellData, writeCol, writeRow)) {
4257
+ continue;
4258
+ }
4259
+ const newVal = pasteToCell(cellData, index, dataItem.rawValue, dataItem.formatted);
4260
+ if (newVal !== undefined) {
4261
+ editList.push(newVal);
4262
+ }
4263
+ }
4264
+ }
4265
+ // eslint-disable-next-line no-constant-condition
4266
+ } while (false);
4267
+
4268
+ mangledOnCellsEdited(editList);
4269
+
4270
+ gridRef.current?.damage(
4271
+ editList.map(c => ({
4272
+ cell: c.location,
4273
+ }))
4274
+ );
4275
+ }
4276
+ },
4277
+ [
4278
+ coercePasteValue,
4279
+ getCellRenderer,
4280
+ getMangledCellContent,
4281
+ gridSelection,
4282
+ keybindings.paste,
4283
+ scrollRef,
4284
+ mangledCols.length,
4285
+ mangledOnCellsEdited,
4286
+ mangledRows,
4287
+ onPaste,
4288
+ rowMarkerOffset,
4289
+ rows,
4290
+ ]
4291
+ );
4292
+
4293
+ useEventListener("paste", onPasteInternal, safeWindow, false, true);
4294
+
4295
+ // While this function is async, we deeply prefer not to await if we don't have to. This will lead to unpacking
4296
+ // promises in rather awkward ways when possible to avoid awaiting. We have to use fallback copy mechanisms when
4297
+ // an await has happened.
4298
+ const onCopy = React.useCallback(
4299
+ async (e?: ClipboardEvent, ignoreFocus?: boolean) => {
4300
+ if (!keybindings.copy) return;
4301
+ const focused =
4302
+ ignoreFocus === true ||
4303
+ scrollRef.current?.contains(document.activeElement) === true ||
4304
+ canvasRef.current?.contains(document.activeElement) === true;
4305
+
4306
+ const selectedColumns = gridSelection.columns;
4307
+ const selectedRows = gridSelection.rows;
4308
+
4309
+ const copyToClipboardWithHeaders = (
4310
+ cells: readonly (readonly GridCell[])[],
4311
+ columnIndexes: readonly number[]
4312
+ ) => {
4313
+ if (!copyHeaders) {
4314
+ copyToClipboard(cells, columnIndexes, e);
4315
+ } else {
4316
+ const headers = columnIndexes.map(index => ({
4317
+ kind: GridCellKind.Text,
4318
+ data: columnsIn[index].title,
4319
+ displayData: columnsIn[index].title,
4320
+ allowOverlay: false,
4321
+ })) as GridCell[];
4322
+ copyToClipboard([headers, ...cells], columnIndexes, e);
4323
+ }
4324
+ };
4325
+
4326
+ if (focused && getCellsForSelection !== undefined) {
4327
+ if (gridSelection.current !== undefined) {
4328
+ let thunk = getCellsForSelection(gridSelection.current.range, abortControllerRef.current.signal);
4329
+ if (typeof thunk !== "object") {
4330
+ thunk = await thunk();
4331
+ }
4332
+ copyToClipboardWithHeaders(
4333
+ thunk,
4334
+ range(
4335
+ gridSelection.current.range.x - rowMarkerOffset,
4336
+ gridSelection.current.range.x + gridSelection.current.range.width - rowMarkerOffset
4337
+ )
4338
+ );
4339
+ } else if (selectedRows !== undefined && selectedRows.length > 0) {
4340
+ const toCopy = [...selectedRows];
4341
+ const cells = toCopy.map(rowIndex => {
4342
+ const thunk = getCellsForSelection(
4343
+ {
4344
+ x: rowMarkerOffset,
4345
+ y: rowIndex,
4346
+ width: columnsIn.length,
4347
+ height: 1,
4348
+ },
4349
+ abortControllerRef.current.signal
4350
+ );
4351
+ if (typeof thunk === "object") {
4352
+ return thunk[0];
4353
+ }
4354
+ return thunk().then(v => v[0]);
4355
+ });
4356
+ if (cells.some(x => x instanceof Promise)) {
4357
+ const settled = await Promise.all(cells);
4358
+ copyToClipboardWithHeaders(settled, range(columnsIn.length));
4359
+ } else {
4360
+ copyToClipboardWithHeaders(cells as (readonly GridCell[])[], range(columnsIn.length));
4361
+ }
4362
+ } else if (selectedColumns.length > 0) {
4363
+ const results: (readonly (readonly GridCell[])[])[] = [];
4364
+ const cols: number[] = [];
4365
+ for (const col of selectedColumns) {
4366
+ let thunk = getCellsForSelection(
4367
+ {
4368
+ x: col,
4369
+ y: 0,
4370
+ width: 1,
4371
+ height: rows,
4372
+ },
4373
+ abortControllerRef.current.signal
4374
+ );
4375
+ if (typeof thunk !== "object") {
4376
+ thunk = await thunk();
4377
+ }
4378
+ results.push(thunk);
4379
+ cols.push(col - rowMarkerOffset);
4380
+ }
4381
+ if (results.length === 1) {
4382
+ copyToClipboardWithHeaders(results[0], cols);
4383
+ } else {
4384
+ // FIXME: this is dumb
4385
+ const toCopy = results.reduce((pv, cv) => pv.map((row, index) => [...row, ...cv[index]]));
4386
+ copyToClipboardWithHeaders(toCopy, cols);
4387
+ }
4388
+ }
4389
+ }
4390
+ },
4391
+ [
4392
+ columnsIn,
4393
+ getCellsForSelection,
4394
+ gridSelection,
4395
+ keybindings.copy,
4396
+ rowMarkerOffset,
4397
+ scrollRef,
4398
+ rows,
4399
+ copyHeaders,
4400
+ ]
4401
+ );
4402
+
4403
+ useEventListener("copy", onCopy, safeWindow, false, false);
4404
+
4405
+ const onCut = React.useCallback(
4406
+ async (e?: ClipboardEvent) => {
4407
+ if (!keybindings.cut) return;
4408
+ const focused =
4409
+ scrollRef.current?.contains(document.activeElement) === true ||
4410
+ canvasRef.current?.contains(document.activeElement) === true;
4411
+
4412
+ if (!focused) return;
4413
+ await onCopy(e);
4414
+ if (gridSelection.current !== undefined) {
4415
+ let effectiveSelection: GridSelection = {
4416
+ current: {
4417
+ cell: gridSelection.current.cell,
4418
+ range: gridSelection.current.range,
4419
+ rangeStack: [],
4420
+ },
4421
+ rows: CompactSelection.empty(),
4422
+ columns: CompactSelection.empty(),
4423
+ };
4424
+ const onDeleteResult = onDelete?.(effectiveSelection);
4425
+ if (onDeleteResult === false) return;
4426
+ effectiveSelection = onDeleteResult === true ? effectiveSelection : onDeleteResult;
4427
+ if (effectiveSelection.current === undefined) return;
4428
+ deleteRange(effectiveSelection.current.range);
4429
+ }
4430
+ },
4431
+ [deleteRange, gridSelection, keybindings.cut, onCopy, scrollRef, onDelete]
4432
+ );
4433
+
4434
+ useEventListener("cut", onCut, safeWindow, false, false);
4435
+
4436
+ const onSearchResultsChanged = React.useCallback(
4437
+ (results: readonly Item[], navIndex: number) => {
4438
+ if (onSearchResultsChangedIn !== undefined) {
4439
+ if (rowMarkerOffset !== 0) {
4440
+ results = results.map(item => [item[0] - rowMarkerOffset, item[1]]);
4441
+ }
4442
+ onSearchResultsChangedIn(results, navIndex);
4443
+ return;
4444
+ }
4445
+ if (results.length === 0 || navIndex === -1) return;
4446
+
4447
+ const [col, row] = results[navIndex];
4448
+ if (lastSent.current !== undefined && lastSent.current[0] === col && lastSent.current[1] === row) {
4449
+ return;
4450
+ }
4451
+ lastSent.current = [col, row];
4452
+ updateSelectedCell(col, row, false, false);
4453
+ },
4454
+ [onSearchResultsChangedIn, rowMarkerOffset, updateSelectedCell]
4455
+ );
4456
+
4457
+ // this effects purpose in life is to scroll the newly selected cell into view when and ONLY when that cell
4458
+ // is from an external gridSelection change. Also note we want the unmangled out selection because scrollTo
4459
+ // expects unmangled indexes
4460
+ const [outCol, outRow] = gridSelectionOuter?.current?.cell ?? [];
4461
+ const scrollToRef = React.useRef(scrollTo);
4462
+ scrollToRef.current = scrollTo;
4463
+ React.useLayoutEffect(() => {
4464
+ if (
4465
+ scrollToActiveCellRef.current &&
4466
+ !hasJustScrolled.current &&
4467
+ outCol !== undefined &&
4468
+ outRow !== undefined &&
4469
+ (outCol !== expectedExternalGridSelection.current?.current?.cell[0] ||
4470
+ outRow !== expectedExternalGridSelection.current?.current?.cell[1])
4471
+ ) {
4472
+ scrollToRef.current(outCol, outRow);
4473
+ }
4474
+ hasJustScrolled.current = false; //only allow skipping a single scroll
4475
+ }, [outCol, outRow]);
4476
+
4477
+ const selectionOutOfBounds =
4478
+ gridSelection.current !== undefined &&
4479
+ (gridSelection.current.cell[0] >= mangledCols.length || gridSelection.current.cell[1] >= mangledRows);
4480
+ React.useLayoutEffect(() => {
4481
+ if (selectionOutOfBounds) {
4482
+ setGridSelection(emptyGridSelection, false);
4483
+ }
4484
+ }, [selectionOutOfBounds, setGridSelection]);
4485
+
4486
+ const disabledRows = React.useMemo(() => {
4487
+ if (showTrailingBlankRow === true && trailingRowOptions?.tint === true) {
4488
+ return CompactSelection.fromSingleSelection(mangledRows - 1);
4489
+ }
4490
+ return CompactSelection.empty();
4491
+ }, [mangledRows, showTrailingBlankRow, trailingRowOptions?.tint]);
4492
+
4493
+ const mangledVerticalBorder = React.useCallback(
4494
+ (col: number) => {
4495
+ return typeof verticalBorder === "boolean"
4496
+ ? verticalBorder
4497
+ : (verticalBorder?.(col - rowMarkerOffset) ?? true);
4498
+ },
4499
+ [rowMarkerOffset, verticalBorder]
4500
+ );
4501
+
4502
+ // Горизонтальные линии по строкам. row в тело-индексах (без служебных колонок его
4503
+ // не сдвигаем — это индекс строки). boolean применяем ко всем строкам.
4504
+ const mangledHorizontalBorder = React.useMemo(() => {
4505
+ if (horizontalBorder === undefined) return undefined;
4506
+ if (typeof horizontalBorder === "boolean") {
4507
+ const value = horizontalBorder;
4508
+ return () => value;
4509
+ }
4510
+ return horizontalBorder;
4511
+ }, [horizontalBorder]);
4512
+
4513
+ // Рамки отдельных ячеек: сдвигаем col на служебные колонки (нумерация, чекбокс).
4514
+ // В служебных колонках (col < rowMarkerOffset) переопределений нет.
4515
+ const mangledGetCellBorder = React.useMemo<CellBorderResolver | undefined>(() => {
4516
+ if (getCellBorder === undefined) return undefined;
4517
+ return (col: number, row: number): CellBorders | undefined => {
4518
+ const userCol = col - rowMarkerOffset;
4519
+ if (userCol < 0) return undefined;
4520
+ return getCellBorder(userCol, row);
4521
+ };
4522
+ }, [getCellBorder, rowMarkerOffset]);
4523
+
4524
+ // Индикатор скрытых колонок: переводим границы из пользовательских индексов во
4525
+ // внутренние (со сдвигом на служебную rowMarker-колонку). На границах служебной
4526
+ // зоны (col <= rowMarkerOffset слева) индикатор не рисуем.
4527
+ const mangledHiddenColumnsIndicator = React.useMemo(() => {
4528
+ if (hiddenColumnsIndicator === undefined) return undefined;
4529
+ return (col: number) => {
4530
+ const userCol = col - rowMarkerOffset;
4531
+ if (userCol < 0) return 0;
4532
+ return hiddenColumnsIndicator(userCol);
4533
+ };
4534
+ }, [hiddenColumnsIndicator, rowMarkerOffset]);
4535
+
4536
+ const renameGroupNode = React.useMemo(() => {
4537
+ if (renameGroup === undefined || canvasRef.current === null) return null;
4538
+ const { bounds, group } = renameGroup;
4539
+ const canvasBounds = canvasRef.current.getBoundingClientRect();
4540
+ return (
4541
+ <GroupRename
4542
+ bounds={bounds}
4543
+ group={group}
4544
+ canvasBounds={canvasBounds}
4545
+ onClose={() => setRenameGroup(undefined)}
4546
+ onFinish={(newVal: string) => {
4547
+ setRenameGroup(undefined);
4548
+ onGroupHeaderRenamed?.(group, newVal);
4549
+ }}
4550
+ />
4551
+ );
4552
+ }, [onGroupHeaderRenamed, renameGroup]);
4553
+
4554
+ const mangledFreezeColumns = Math.min(mangledCols.length, freezeColumns + (hasRowMarkers ? 1 : 0));
4555
+
4556
+ React.useImperativeHandle(
4557
+ forwardedRef,
4558
+ () => ({
4559
+ appendRow: (col: number, openOverlay?: boolean) => appendRow(col + rowMarkerOffset, openOverlay),
4560
+ appendColumn: (row: number, openOverlay?: boolean) => appendColumn(row, openOverlay),
4561
+ updateCells: damageList => {
4562
+ if (rowMarkerOffset !== 0) {
4563
+ damageList = damageList.map(x => ({ cell: [x.cell[0] + rowMarkerOffset, x.cell[1]] }));
4564
+ }
4565
+ return gridRef.current?.damage(damageList);
4566
+ },
4567
+ getBounds: (col, row) => {
4568
+ if (canvasRef?.current === null || scrollRef?.current === null) {
4569
+ return undefined;
4570
+ }
4571
+
4572
+ if (col === undefined && row === undefined) {
4573
+ // Return the bounds of the entire scroll area:
4574
+ const rect = canvasRef.current.getBoundingClientRect();
4575
+ const scale = rect.width / scrollRef.current.clientWidth;
4576
+ return {
4577
+ x: rect.x - scrollRef.current.scrollLeft * scale,
4578
+ y: rect.y - scrollRef.current.scrollTop * scale,
4579
+ width: scrollRef.current.scrollWidth * scale,
4580
+ height: scrollRef.current.scrollHeight * scale,
4581
+ };
4582
+ }
4583
+ return gridRef.current?.getBounds((col ?? 0) + rowMarkerOffset, row);
4584
+ },
4585
+ focus: () => gridRef.current?.focus(),
4586
+ emit: async e => {
4587
+ switch (e) {
4588
+ case "delete":
4589
+ onKeyDown({
4590
+ bounds: undefined,
4591
+ cancel: () => undefined,
4592
+ stopPropagation: () => undefined,
4593
+ preventDefault: () => undefined,
4594
+ ctrlKey: false,
4595
+ key: "Delete",
4596
+ keyCode: 46,
4597
+ metaKey: false,
4598
+ shiftKey: false,
4599
+ altKey: false,
4600
+ rawEvent: undefined,
4601
+ location: undefined,
4602
+ });
4603
+ break;
4604
+ case "fill-right":
4605
+ onKeyDown({
4606
+ bounds: undefined,
4607
+ cancel: () => undefined,
4608
+ stopPropagation: () => undefined,
4609
+ preventDefault: () => undefined,
4610
+ ctrlKey: true,
4611
+ key: "r",
4612
+ keyCode: 82,
4613
+ metaKey: false,
4614
+ shiftKey: false,
4615
+ altKey: false,
4616
+ rawEvent: undefined,
4617
+ location: undefined,
4618
+ });
4619
+ break;
4620
+ case "fill-down":
4621
+ onKeyDown({
4622
+ bounds: undefined,
4623
+ cancel: () => undefined,
4624
+ stopPropagation: () => undefined,
4625
+ preventDefault: () => undefined,
4626
+ ctrlKey: true,
4627
+ key: "d",
4628
+ keyCode: 68,
4629
+ metaKey: false,
4630
+ shiftKey: false,
4631
+ altKey: false,
4632
+ rawEvent: undefined,
4633
+ location: undefined,
4634
+ });
4635
+ break;
4636
+ case "copy":
4637
+ await onCopy(undefined, true);
4638
+ break;
4639
+ case "paste":
4640
+ await onPasteInternal();
4641
+ break;
4642
+ }
4643
+ },
4644
+ scrollTo,
4645
+ remeasureColumns: cols => {
4646
+ for (const col of cols) {
4647
+ void normalSizeColumn(col + rowMarkerOffset);
4648
+ }
4649
+ },
4650
+ getMouseArgsForPosition: (
4651
+ posX: number,
4652
+ posY: number,
4653
+ ev?: MouseEvent | TouchEvent
4654
+ ): GridMouseEventArgs | undefined => {
4655
+ if (gridRef?.current === null) {
4656
+ return undefined;
4657
+ }
4658
+
4659
+ const args = gridRef.current.getMouseArgsForPosition(posX, posY, ev);
4660
+ if (args === undefined) {
4661
+ return undefined;
4662
+ }
4663
+
4664
+ return {
4665
+ ...args,
4666
+ location: [args.location[0] - rowMarkerOffset, args.location[1]] as any,
4667
+ };
4668
+ },
4669
+ }),
4670
+ [
4671
+ appendRow,
4672
+ appendColumn,
4673
+ normalSizeColumn,
4674
+ scrollRef,
4675
+ onCopy,
4676
+ onKeyDown,
4677
+ onPasteInternal,
4678
+ rowMarkerOffset,
4679
+ scrollTo,
4680
+ ]
4681
+ );
4682
+
4683
+ const [selCol, selRow] = currentCell ?? [];
4684
+ const onCellFocused = React.useCallback(
4685
+ (cell: Item) => {
4686
+ const [col, row] = cell;
4687
+
4688
+ if (row === -1) {
4689
+ if (columnSelect !== "none") {
4690
+ setSelectedColumns(CompactSelection.fromSingleSelection(col), undefined, false);
4691
+ focus();
4692
+ }
4693
+ return;
4694
+ }
4695
+
4696
+ if (selCol === col && selRow === row) return;
4697
+ setCurrent(
4698
+ {
4699
+ cell,
4700
+ range: { x: col, y: row, width: 1, height: 1 },
4701
+ },
4702
+ true,
4703
+ false,
4704
+ "keyboard-nav"
4705
+ );
4706
+ scrollTo(col, row);
4707
+ },
4708
+ [columnSelect, focus, scrollTo, selCol, selRow, setCurrent, setSelectedColumns]
4709
+ );
4710
+
4711
+ const [isFocused, setIsFocused] = React.useState(false);
4712
+ const setIsFocusedDebounced = React.useRef(
4713
+ debounce((val: boolean) => {
4714
+ setIsFocused(val);
4715
+ }, 5)
4716
+ );
4717
+
4718
+ const onCanvasFocused = React.useCallback(() => {
4719
+ setIsFocusedDebounced.current(true);
4720
+
4721
+ // check for mouse state, don't do anything if the user is clicked to focus.
4722
+ if (
4723
+ gridSelection.current === undefined &&
4724
+ gridSelection.columns.length === 0 &&
4725
+ gridSelection.rows.length === 0 &&
4726
+ mouseState === undefined
4727
+ ) {
4728
+ setCurrent(
4729
+ {
4730
+ cell: [rowMarkerOffset, cellYOffset],
4731
+ range: {
4732
+ x: rowMarkerOffset,
4733
+ y: cellYOffset,
4734
+ width: 1,
4735
+ height: 1,
4736
+ },
4737
+ },
4738
+ true,
4739
+ false,
4740
+ "keyboard-select"
4741
+ );
4742
+ }
4743
+ }, [cellYOffset, gridSelection, mouseState, rowMarkerOffset, setCurrent]);
4744
+
4745
+ const onFocusOut = React.useCallback(() => {
4746
+ setIsFocusedDebounced.current(false);
4747
+ }, []);
4748
+
4749
+ const [idealWidth, idealHeight] = React.useMemo(() => {
4750
+ let h: number;
4751
+ const scrollbarWidth = experimental?.scrollbarWidthOverride ?? getScrollBarWidth();
4752
+ const rowsCountWithTrailingRow = rows + (showTrailingBlankRow ? 1 : 0);
4753
+ if (typeof rowHeight === "number") {
4754
+ h = totalHeaderHeight + rowsCountWithTrailingRow * rowHeight;
4755
+ } else {
4756
+ let avg = 0;
4757
+ const toAverage = Math.min(rowsCountWithTrailingRow, 10);
4758
+ for (let i = 0; i < toAverage; i++) {
4759
+ avg += rowHeight(i);
4760
+ }
4761
+ avg = Math.floor(avg / toAverage);
4762
+
4763
+ h = totalHeaderHeight + rowsCountWithTrailingRow * avg;
4764
+ }
4765
+ h += scrollbarWidth;
4766
+
4767
+ const w = mangledCols.reduce((acc, x) => x.width + acc, 0) + scrollbarWidth;
4768
+
4769
+ // We need to set a reasonable cap here as some browsers will just ignore huge values
4770
+ // rather than treat them as huge values.
4771
+ return [`${Math.min(100_000, w)}px`, `${Math.min(100_000, h)}px`];
4772
+ }, [mangledCols, experimental?.scrollbarWidthOverride, rowHeight, rows, showTrailingBlankRow, totalHeaderHeight]);
4773
+
4774
+ const cssStyle = React.useMemo(() => {
4775
+ return makeCSSStyle(mergedTheme);
4776
+ }, [mergedTheme]);
4777
+
4778
+ return (
4779
+ <ThemeContext.Provider value={mergedTheme}>
4780
+ <DataEditorContainer
4781
+ style={cssStyle}
4782
+ className={className}
4783
+ inWidth={width ?? idealWidth}
4784
+ inHeight={height ?? idealHeight}>
4785
+ <DataGridSearch
4786
+ fillHandle={fillHandle}
4787
+ drawFocusRing={drawFocusRing}
4788
+ editorOpen={editorOpen}
4789
+ experimental={experimental}
4790
+ fixedShadowX={fixedShadowX}
4791
+ fixedShadowY={fixedShadowY}
4792
+ getRowThemeOverride={getRowThemeOverride}
4793
+ headerIcons={headerIcons}
4794
+ imageWindowLoader={imageWindowLoader}
4795
+ initialSize={initialSize}
4796
+ isDraggable={isDraggable}
4797
+ onDragLeave={onDragLeave}
4798
+ onRowMoved={onRowMoved}
4799
+ overscrollX={overscrollX}
4800
+ overscrollY={overscrollY}
4801
+ preventDiagonalScrolling={preventDiagonalScrolling}
4802
+ rightElement={rightElement}
4803
+ rightElementProps={rightElementProps}
4804
+ smoothScrollX={smoothScrollX}
4805
+ smoothScrollY={smoothScrollY}
4806
+ className={className}
4807
+ enableGroups={enableGroups}
4808
+ onCanvasFocused={onCanvasFocused}
4809
+ onCanvasBlur={onFocusOut}
4810
+ canvasRef={canvasRef}
4811
+ onContextMenu={onContextMenu}
4812
+ theme={mergedTheme}
4813
+ cellXOffset={cellXOffset}
4814
+ cellYOffset={cellYOffset}
4815
+ accessibilityHeight={visibleRegion.height}
4816
+ onDragEnd={onDragEnd}
4817
+ columns={mangledCols}
4818
+ nonGrowWidth={nonGrowWidth}
4819
+ drawHeader={drawHeader}
4820
+ drawGroupHeader={drawGroupHeaderIn}
4821
+ onColumnProposeMove={onColumnProposeMoveImpl}
4822
+ drawCell={drawCell}
4823
+ disabledRows={disabledRows}
4824
+ freezeColumns={mangledFreezeColumns}
4825
+ stickyColumns={stickyColumns}
4826
+ stickyRows={stickyRows}
4827
+ spanAlign={spanAlign}
4828
+ spanGroupHeader={spanGroupHeader}
4829
+ lockColumns={rowMarkerOffset}
4830
+ firstColAccessible={rowMarkerOffset === 0}
4831
+ getCellContent={getMangledCellContent}
4832
+ minColumnWidth={minColumnWidth}
4833
+ maxColumnWidth={maxColumnWidth}
4834
+ searchInputRef={searchInputRef}
4835
+ showSearch={showSearch}
4836
+ onSearchClose={onSearchClose}
4837
+ highlightRegions={highlightRegions}
4838
+ getCellsForSelection={getCellsForSelection}
4839
+ getGroupDetails={mangledGetGroupDetails}
4840
+ headerHeight={headerHeight}
4841
+ isFocused={isFocused}
4842
+ groupHeaderHeight={enableGroups ? groupHeaderHeight : 0}
4843
+ freezeTrailingRows={
4844
+ freezeTrailingRows + (showTrailingBlankRow && trailingRowOptions?.sticky === true ? 1 : 0)
4845
+ }
4846
+ hasAppendRow={showTrailingBlankRow}
4847
+ onColumnResize={onColumnResize}
4848
+ onColumnResizeEnd={onColumnResizeEnd}
4849
+ onColumnResizeStart={onColumnResizeStart}
4850
+ onCellFocused={onCellFocused}
4851
+ onColumnMoved={onColumnMovedImpl}
4852
+ onDragStart={onDragStartImpl}
4853
+ onHeaderMenuClick={onHeaderMenuClickInner}
4854
+ onHeaderIndicatorClick={onHeaderIndicatorClickInner}
4855
+ onItemHovered={onItemHoveredImpl}
4856
+ isFilling={mouseState?.fillHandle === true}
4857
+ onMouseMove={onMouseMoveImpl}
4858
+ onKeyDown={onKeyDown}
4859
+ onKeyUp={onKeyUpIn}
4860
+ onMouseDown={onMouseDown}
4861
+ onMouseUp={onMouseUp}
4862
+ onDragOverCell={onDragOverCell}
4863
+ onDrop={onDrop}
4864
+ onSearchResultsChanged={onSearchResultsChanged}
4865
+ onVisibleRegionChanged={onVisibleRegionChangedImpl}
4866
+ clientSize={clientSize}
4867
+ rowHeight={rowHeight}
4868
+ searchResults={searchResults}
4869
+ searchValue={searchValue}
4870
+ onSearchValueChange={onSearchValueChange}
4871
+ rows={mangledRows}
4872
+ scrollRef={scrollRef}
4873
+ selection={gridSelection}
4874
+ translateX={visibleRegion.tx}
4875
+ translateY={visibleRegion.ty}
4876
+ verticalBorder={mangledVerticalBorder}
4877
+ horizontalBorder={mangledHorizontalBorder}
4878
+ getCellBorder={mangledGetCellBorder}
4879
+ hiddenColumnsIndicator={mangledHiddenColumnsIndicator}
4880
+ gridRef={gridRef}
4881
+ getCellRenderer={getCellRenderer}
4882
+ resizeIndicator={resizeIndicator}
4883
+ resizeIndicatorOnHover={resizeIndicatorOnHover}
4884
+ setScrollDir={setScrollDir}
4885
+ />
4886
+ {renameGroupNode}
4887
+ {overlay !== undefined && (
4888
+ <React.Suspense fallback={null}>
4889
+ <DataGridOverlayEditor
4890
+ {...overlay}
4891
+ validateCell={validateCell}
4892
+ bloom={editorBloom}
4893
+ id={overlayID}
4894
+ getCellRenderer={getCellRenderer}
4895
+ className={experimental?.isSubGrid === true ? "click-outside-ignore" : undefined}
4896
+ provideEditor={provideEditor}
4897
+ imageEditorOverride={imageEditorOverride}
4898
+ portalElementRef={portalElementRef}
4899
+ onFinishEditing={onFinishEditing}
4900
+ markdownDivCreateNode={markdownDivCreateNode}
4901
+ isOutsideClick={isOutsideClick}
4902
+ customEventTarget={experimental?.eventTarget}
4903
+ />
4904
+ </React.Suspense>
4905
+ )}
4906
+ </DataEditorContainer>
4907
+ </ThemeContext.Provider>
4908
+ );
4909
+ };
4910
+
4911
+ /**
4912
+ * The primary component of Glide Data Grid.
4913
+ * @category DataEditor
4914
+ * @param {DataEditorProps} props
4915
+ */
4916
+ export const DataEditor = React.forwardRef(DataEditorImpl);