@viewkitjs/views 0.1.0 → 0.3.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 (390) hide show
  1. package/CHANGELOG.md +767 -1
  2. package/README.md +92 -41
  3. package/dist/atoms/LoadMore.js +11 -1
  4. package/dist/atoms/Row.js +1 -1
  5. package/dist/atoms/RowMenu.d.ts +1 -1
  6. package/dist/atoms/RowMenu.js +20 -6
  7. package/dist/atoms/types.d.ts +4 -4
  8. package/dist/cells/cell-format.d.ts +3 -3
  9. package/dist/cells/cell-title.d.ts +1 -2
  10. package/dist/cells/cell-title.js +2 -2
  11. package/dist/cells/cell-values.js +6 -3
  12. package/dist/contract.d.ts +79 -8
  13. package/dist/contract.js +55 -8
  14. package/dist/display/converted.d.ts +19 -0
  15. package/dist/display/converted.js +12 -0
  16. package/dist/display/format.d.ts +16 -1
  17. package/dist/display/format.js +10 -1
  18. package/dist/display/index.d.ts +2 -1
  19. package/dist/display/index.js +2 -1
  20. package/dist/display/link-click.d.ts +11 -0
  21. package/dist/display/link-click.js +3 -0
  22. package/dist/display/link.js +12 -6
  23. package/dist/display/location.d.ts +4 -3
  24. package/dist/display/location.js +12 -5
  25. package/dist/display/multi-value.d.ts +1 -1
  26. package/dist/display/multi-value.js +1 -1
  27. package/dist/display/options.d.ts +8 -2
  28. package/dist/display/percent.js +10 -3
  29. package/dist/display/phone.d.ts +2 -1
  30. package/dist/display/phone.js +11 -2
  31. package/dist/display/relation.js +1 -1
  32. package/dist/editors/ChipsEditor.d.ts +9 -4
  33. package/dist/editors/ChipsEditor.js +7 -3
  34. package/dist/editors/DateEditor.d.ts +21 -6
  35. package/dist/editors/DateEditor.js +118 -30
  36. package/dist/editors/EditorPanel.d.ts +61 -0
  37. package/dist/editors/EditorPanel.js +54 -0
  38. package/dist/editors/LocationEditor.d.ts +3 -0
  39. package/dist/editors/LocationEditor.js +28 -21
  40. package/dist/editors/NameEditor.d.ts +3 -0
  41. package/dist/editors/NameEditor.js +15 -10
  42. package/dist/editors/NumberEditor.d.ts +3 -0
  43. package/dist/editors/NumberEditor.js +7 -7
  44. package/dist/editors/RangeEditor.d.ts +16 -1
  45. package/dist/editors/RangeEditor.js +22 -6
  46. package/dist/editors/RelationEditor.d.ts +13 -28
  47. package/dist/editors/RelationEditor.js +17 -40
  48. package/dist/editors/RelationSetEditor.d.ts +53 -0
  49. package/dist/editors/RelationSetEditor.js +112 -0
  50. package/dist/editors/SelectEditor.d.ts +21 -3
  51. package/dist/editors/SelectEditor.js +55 -9
  52. package/dist/editors/TextEditor.d.ts +51 -0
  53. package/dist/editors/TextEditor.js +81 -0
  54. package/dist/editors/ValueListEditor.d.ts +5 -2
  55. package/dist/editors/ValueListEditor.js +11 -9
  56. package/dist/editors/edit-cores.d.ts +13 -10
  57. package/dist/editors/edit-cores.js +7 -6
  58. package/dist/editors/edit-session.d.ts +21 -11
  59. package/dist/editors/edit-session.js +19 -5
  60. package/dist/editors/keep-inside.d.ts +12 -0
  61. package/dist/editors/keep-inside.js +20 -0
  62. package/dist/editors/open-value.d.ts +21 -0
  63. package/dist/editors/open-value.js +36 -0
  64. package/dist/editors/open-values.d.ts +4 -0
  65. package/dist/editors/open-values.js +7 -0
  66. package/dist/editors/relation-kinds.d.ts +7 -0
  67. package/dist/editors/relation-kinds.js +21 -0
  68. package/dist/editors/relation-panel.d.ts +69 -0
  69. package/dist/editors/relation-panel.js +40 -0
  70. package/dist/field-row/FieldNoteLine.d.ts +14 -0
  71. package/dist/field-row/FieldNoteLine.js +14 -0
  72. package/dist/field-row/FieldRow.d.ts +73 -0
  73. package/dist/field-row/FieldRow.js +157 -0
  74. package/dist/field-row/FieldRowLane.d.ts +19 -0
  75. package/dist/field-row/FieldRowLane.js +11 -0
  76. package/dist/field-row/editors/RowChipsEditor.d.ts +11 -0
  77. package/dist/field-row/editors/RowChipsEditor.js +25 -0
  78. package/dist/field-row/editors/RowDateEditor.d.ts +16 -0
  79. package/dist/field-row/editors/RowDateEditor.js +18 -0
  80. package/dist/field-row/editors/RowEditor.d.ts +39 -0
  81. package/dist/field-row/editors/RowEditor.js +64 -0
  82. package/dist/field-row/editors/RowNameEditor.d.ts +4 -0
  83. package/dist/field-row/editors/RowNameEditor.js +15 -0
  84. package/dist/field-row/editors/RowNumberEditor.d.ts +12 -0
  85. package/dist/field-row/editors/RowNumberEditor.js +18 -0
  86. package/dist/field-row/editors/RowPlaceEditor.d.ts +8 -0
  87. package/dist/field-row/editors/RowPlaceEditor.js +18 -0
  88. package/dist/field-row/editors/RowRangeEditor.d.ts +4 -0
  89. package/dist/field-row/editors/RowRangeEditor.js +15 -0
  90. package/dist/field-row/editors/RowRelationEditor.d.ts +20 -0
  91. package/dist/field-row/editors/RowRelationEditor.js +77 -0
  92. package/dist/field-row/editors/RowSelectEditor.d.ts +13 -0
  93. package/dist/field-row/editors/RowSelectEditor.js +23 -0
  94. package/dist/field-row/editors/RowTextEditor.d.ts +15 -0
  95. package/dist/field-row/editors/RowTextEditor.js +16 -0
  96. package/dist/field-row/editors/RowValueListEditor.d.ts +4 -0
  97. package/dist/field-row/editors/RowValueListEditor.js +21 -0
  98. package/dist/field-row/editors/host.d.ts +59 -0
  99. package/dist/field-row/editors/host.js +1 -0
  100. package/dist/field-row/editors/row-session.d.ts +49 -0
  101. package/dist/field-row/editors/row-session.js +49 -0
  102. package/dist/field-row/index.d.ts +5 -0
  103. package/dist/field-row/index.js +5 -0
  104. package/dist/field-row/row-target.d.ts +20 -0
  105. package/dist/field-row/row-target.js +3 -0
  106. package/dist/field-row/useFieldWrite.d.ts +45 -0
  107. package/dist/field-row/useFieldWrite.js +190 -0
  108. package/dist/field-row/useRowSettlement.d.ts +33 -0
  109. package/dist/field-row/useRowSettlement.js +23 -0
  110. package/dist/fields/binding.d.ts +7 -2
  111. package/dist/fields/binding.js +13 -6
  112. package/dist/fields/currency.d.ts +0 -10
  113. package/dist/fields/currency.js +0 -14
  114. package/dist/fields/edit-core-types.d.ts +9 -9
  115. package/dist/fields/edit-core-types.js +6 -6
  116. package/dist/fields/money.d.ts +6 -0
  117. package/dist/fields/money.js +11 -0
  118. package/dist/fields/number-edit.d.ts +6 -0
  119. package/dist/fields/number-edit.js +4 -0
  120. package/dist/fields/prepare-write.js +6 -1
  121. package/dist/fields/relation-source-types.d.ts +12 -0
  122. package/dist/fields/write-target.d.ts +50 -0
  123. package/dist/fields/write-target.js +10 -0
  124. package/dist/filters/filter-model.d.ts +0 -1
  125. package/dist/filters/registry.d.ts +3 -36
  126. package/dist/filters/registry.js +0 -38
  127. package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
  128. package/dist/grid/chrome/GridAddColumn.js +29 -0
  129. package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
  130. package/dist/grid/chrome/GridAggregateMenu.js +29 -0
  131. package/dist/grid/chrome/GridCellEditors.d.ts +71 -0
  132. package/dist/grid/chrome/GridCellEditors.js +126 -0
  133. package/dist/grid/chrome/GridCellOutline.d.ts +49 -0
  134. package/dist/grid/chrome/GridCellOutline.js +16 -0
  135. package/dist/grid/chrome/GridChipsEditor.d.ts +38 -0
  136. package/dist/grid/chrome/GridChipsEditor.js +35 -0
  137. package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
  138. package/dist/grid/chrome/GridColumnColorSection.js +40 -0
  139. package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
  140. package/dist/grid/chrome/GridColumnDateSection.js +23 -0
  141. package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
  142. package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
  143. package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
  144. package/dist/grid/chrome/GridColumnMenu.js +103 -0
  145. package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
  146. package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
  147. package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
  148. package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
  149. package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
  150. package/dist/grid/chrome/GridColumnSortSection.js +16 -0
  151. package/dist/grid/chrome/GridDateEditor.d.ts +34 -0
  152. package/dist/grid/chrome/GridDateEditor.js +19 -0
  153. package/dist/grid/chrome/GridFlyout.d.ts +44 -0
  154. package/dist/grid/chrome/GridFlyout.js +80 -0
  155. package/dist/grid/chrome/GridFooter.d.ts +33 -0
  156. package/dist/grid/chrome/GridFooter.js +85 -0
  157. package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
  158. package/dist/grid/chrome/GridGroupMenu.js +64 -0
  159. package/dist/grid/chrome/GridHeader.d.ts +66 -0
  160. package/dist/grid/chrome/GridHeader.js +42 -0
  161. package/dist/grid/chrome/GridLongTextEditor.d.ts +55 -0
  162. package/dist/grid/chrome/GridLongTextEditor.js +69 -0
  163. package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
  164. package/dist/grid/chrome/GridMenuRow.js +15 -0
  165. package/dist/grid/chrome/GridNameEditor.d.ts +24 -0
  166. package/dist/grid/chrome/GridNameEditor.js +21 -0
  167. package/dist/grid/chrome/GridNumberEditor.d.ts +49 -0
  168. package/dist/grid/chrome/GridNumberEditor.js +51 -0
  169. package/dist/grid/chrome/GridPlaceEditor.d.ts +26 -0
  170. package/dist/grid/chrome/GridPlaceEditor.js +22 -0
  171. package/dist/grid/chrome/GridRangeEditor.d.ts +30 -0
  172. package/dist/grid/chrome/GridRangeEditor.js +21 -0
  173. package/dist/grid/chrome/GridRelationEditor.d.ts +45 -0
  174. package/dist/grid/chrome/GridRelationEditor.js +92 -0
  175. package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
  176. package/dist/grid/chrome/GridResizeHandle.js +19 -0
  177. package/dist/grid/chrome/GridRow.d.ts +31 -0
  178. package/dist/grid/chrome/GridRow.js +179 -0
  179. package/dist/grid/chrome/GridRowActions.d.ts +32 -0
  180. package/dist/grid/chrome/GridRowActions.js +25 -0
  181. package/dist/grid/chrome/GridRowCells.d.ts +4 -0
  182. package/dist/grid/chrome/GridRowCells.js +128 -0
  183. package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
  184. package/dist/grid/chrome/GridRowGlyph.js +13 -0
  185. package/dist/grid/chrome/GridSelectEditor.d.ts +33 -0
  186. package/dist/grid/chrome/GridSelectEditor.js +43 -0
  187. package/dist/grid/chrome/GridStructure.d.ts +47 -0
  188. package/dist/grid/chrome/GridStructure.js +41 -0
  189. package/dist/grid/chrome/GridTable.d.ts +4 -0
  190. package/dist/grid/chrome/GridTable.js +192 -0
  191. package/dist/grid/chrome/GridTableSurface.d.ts +52 -0
  192. package/dist/grid/chrome/GridTableSurface.js +15 -0
  193. package/dist/grid/chrome/GridTextEditor.d.ts +45 -0
  194. package/dist/grid/chrome/GridTextEditor.js +38 -0
  195. package/dist/grid/chrome/GridValueListEditor.d.ts +30 -0
  196. package/dist/grid/chrome/GridValueListEditor.js +19 -0
  197. package/dist/grid/chrome/StuckMarker.d.ts +16 -0
  198. package/dist/grid/chrome/StuckMarker.js +34 -0
  199. package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
  200. package/dist/grid/chrome/cell-clipboard.js +28 -0
  201. package/dist/grid/chrome/cell-cut-off.d.ts +11 -0
  202. package/dist/grid/chrome/cell-cut-off.js +20 -0
  203. package/dist/grid/chrome/cells.d.ts +21 -0
  204. package/dist/grid/chrome/cells.js +19 -0
  205. package/dist/grid/chrome/checks.d.ts +32 -0
  206. package/dist/grid/chrome/checks.js +32 -0
  207. package/dist/grid/chrome/column-glyph.d.ts +14 -0
  208. package/dist/grid/chrome/column-glyph.js +44 -0
  209. package/dist/grid/chrome/editors.d.ts +9 -0
  210. package/dist/grid/chrome/editors.js +10 -0
  211. package/dist/grid/chrome/grid-cell-classes.d.ts +53 -0
  212. package/dist/grid/chrome/grid-cell-classes.js +32 -0
  213. package/dist/grid/chrome/grid-cell-link.d.ts +13 -0
  214. package/dist/grid/chrome/grid-cell-link.js +9 -0
  215. package/dist/grid/chrome/grid-edit-session.d.ts +63 -0
  216. package/dist/grid/chrome/grid-edit-session.js +118 -0
  217. package/dist/grid/chrome/grid-hover.d.ts +60 -0
  218. package/dist/grid/chrome/grid-hover.js +81 -0
  219. package/dist/grid/chrome/grid-menu-focus.d.ts +43 -0
  220. package/dist/grid/chrome/grid-menu-focus.js +93 -0
  221. package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
  222. package/dist/grid/chrome/grid-menu-search.js +7 -0
  223. package/dist/grid/chrome/grid-row-menu-key.d.ts +15 -0
  224. package/dist/grid/chrome/grid-row-menu-key.js +36 -0
  225. package/dist/grid/chrome/grid-row-props.d.ts +143 -0
  226. package/dist/grid/chrome/grid-row-props.js +1 -0
  227. package/dist/grid/chrome/grid-row-window.d.ts +61 -0
  228. package/dist/grid/chrome/grid-row-window.js +212 -0
  229. package/dist/grid/chrome/grid-scroll-owner.d.ts +38 -0
  230. package/dist/grid/chrome/grid-scroll-owner.js +75 -0
  231. package/dist/grid/chrome/grid-styles.d.ts +40 -0
  232. package/dist/grid/chrome/grid-styles.js +9 -0
  233. package/dist/grid/chrome/grid-table-props.d.ts +172 -0
  234. package/dist/grid/chrome/grid-table-props.js +1 -0
  235. package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
  236. package/dist/grid/chrome/useGridBatchApi.js +35 -0
  237. package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
  238. package/dist/grid/chrome/useGridColumnLayout.js +206 -0
  239. package/dist/grid/chrome/useGridFocus.d.ts +45 -0
  240. package/dist/grid/chrome/useGridFocus.js +122 -0
  241. package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
  242. package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
  243. package/dist/grid/chrome/useGridKeyboard.d.ts +64 -0
  244. package/dist/grid/chrome/useGridKeyboard.js +450 -0
  245. package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
  246. package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
  247. package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
  248. package/dist/grid/chrome/useGridRailReveal.js +67 -0
  249. package/dist/grid/chrome/useGridRangeActions.d.ts +51 -0
  250. package/dist/grid/chrome/useGridRangeActions.js +195 -0
  251. package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
  252. package/dist/grid/chrome/useGridRangeGestures.js +237 -0
  253. package/dist/grid/chrome/useGridRowContextMenu.d.ts +37 -0
  254. package/dist/grid/chrome/useGridRowContextMenu.js +153 -0
  255. package/dist/grid/chrome/useGridScaleStyles.d.ts +3 -0
  256. package/dist/grid/chrome/useGridScaleStyles.js +28 -0
  257. package/dist/grid/chrome/useGridScrollArea.d.ts +21 -0
  258. package/dist/grid/chrome/useGridScrollArea.js +65 -0
  259. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +78 -0
  260. package/dist/grid/chrome/useGridTableInteractionModel.js +249 -0
  261. package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
  262. package/dist/grid/chrome/useGridTableSelection.js +55 -0
  263. package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
  264. package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
  265. package/dist/grid/core/clipboard-model.d.ts +83 -0
  266. package/dist/grid/core/clipboard-model.js +291 -0
  267. package/dist/grid/core/column-values.d.ts +27 -0
  268. package/dist/grid/core/column-values.js +76 -0
  269. package/dist/grid/core/commit-model.d.ts +41 -0
  270. package/dist/grid/core/commit-model.js +3 -0
  271. package/dist/grid/core/coordinates.d.ts +48 -0
  272. package/dist/grid/core/coordinates.js +27 -0
  273. package/dist/grid/core/edge-scroll.d.ts +21 -0
  274. package/dist/grid/core/edge-scroll.js +23 -0
  275. package/dist/grid/core/edit-values.d.ts +9 -0
  276. package/dist/grid/core/edit-values.js +1 -0
  277. package/dist/grid/core/editing-controller.d.ts +60 -0
  278. package/dist/grid/core/editing-controller.js +266 -0
  279. package/dist/grid/core/editing-model.d.ts +87 -0
  280. package/dist/grid/core/editing-model.js +148 -0
  281. package/dist/grid/core/flat-rows.d.ts +35 -0
  282. package/dist/grid/core/flat-rows.js +20 -0
  283. package/dist/grid/core/grid-aria.d.ts +27 -0
  284. package/dist/grid/core/grid-aria.js +39 -0
  285. package/dist/grid/core/grid-focus.d.ts +54 -0
  286. package/dist/grid/core/grid-focus.js +148 -0
  287. package/dist/grid/core/grid-scale.d.ts +14 -0
  288. package/dist/grid/core/grid-scale.js +8 -0
  289. package/dist/grid/core/nav.d.ts +94 -0
  290. package/dist/grid/core/nav.js +92 -0
  291. package/dist/grid/core/pending-reconciliation.d.ts +53 -0
  292. package/dist/grid/core/pending-reconciliation.js +51 -0
  293. package/dist/grid/core/range-model.d.ts +25 -0
  294. package/dist/grid/core/range-model.js +59 -0
  295. package/dist/grid/core/row-window.d.ts +40 -0
  296. package/dist/grid/core/row-window.js +43 -0
  297. package/dist/grid/core/spreadsheet-operations.d.ts +101 -0
  298. package/dist/grid/core/spreadsheet-operations.js +280 -0
  299. package/dist/grid/core/useGridEditing.d.ts +46 -0
  300. package/dist/grid/core/useGridEditing.js +93 -0
  301. package/dist/grid/core/useGridRange.d.ts +20 -0
  302. package/dist/grid/core/useGridRange.js +24 -0
  303. package/dist/grid/core/value-equality.d.ts +54 -0
  304. package/dist/grid/core/value-equality.js +80 -0
  305. package/dist/grid/index.d.ts +18 -0
  306. package/dist/grid/index.js +5 -0
  307. package/dist/grid/useGridTablePrefs.d.ts +49 -0
  308. package/dist/grid/useGridTablePrefs.js +99 -0
  309. package/dist/index.d.ts +1 -1
  310. package/dist/index.js +1 -1
  311. package/dist/internal/viewport.d.ts +3 -0
  312. package/dist/internal/viewport.js +15 -0
  313. package/dist/model/column-capabilities.d.ts +3 -2
  314. package/dist/model/column-capabilities.js +28 -8
  315. package/dist/model/column-from.js +3 -0
  316. package/dist/model/column-inspect.d.ts +10 -2
  317. package/dist/model/column-inspect.js +9 -0
  318. package/dist/model/column-schema.d.ts +6 -1
  319. package/dist/model/column-state.d.ts +1 -1
  320. package/dist/model/column-types.d.ts +3 -1
  321. package/dist/model/column-types.js +1 -1
  322. package/dist/model/density.js +3 -3
  323. package/dist/model/filter-capabilities.d.ts +1 -1
  324. package/dist/model/filter-capabilities.js +1 -1
  325. package/dist/model/index.d.ts +4 -6
  326. package/dist/model/index.js +0 -1
  327. package/dist/model/preferences.d.ts +7 -7
  328. package/dist/model/preferences.js +0 -1
  329. package/dist/model/prefs-buckets.d.ts +0 -1
  330. package/dist/model/prefs-buckets.js +0 -3
  331. package/dist/model/render-count.d.ts +6 -0
  332. package/dist/model/render-count.js +11 -0
  333. package/dist/provider/ViewsProvider.d.ts +6 -2
  334. package/dist/provider/ViewsProvider.js +12 -2
  335. package/dist/provider/components.d.ts +35 -9
  336. package/dist/provider/components.js +4 -2
  337. package/dist/provider/context.d.ts +8 -4
  338. package/dist/provider/desktop.d.ts +9 -0
  339. package/dist/provider/desktop.js +22 -0
  340. package/dist/provider/menu-groups.d.ts +8 -0
  341. package/dist/provider/menu-groups.js +38 -0
  342. package/dist/provider/plain-input.d.ts +8 -0
  343. package/dist/provider/plain-input.js +5 -0
  344. package/dist/provider/ports.d.ts +22 -0
  345. package/dist/provider/ports.js +1 -0
  346. package/dist/react.d.ts +3 -2
  347. package/dist/react.js +1 -0
  348. package/dist/selection/SelectCheckbox.d.ts +3 -1
  349. package/dist/selection/SelectCheckbox.js +2 -2
  350. package/dist/selection/useCheckDragSelect.js +6 -5
  351. package/docs/contract.md +202 -72
  352. package/docs/getting-started.md +250 -0
  353. package/docs/guides/atoms.md +245 -0
  354. package/docs/guides/cells.md +302 -0
  355. package/docs/guides/columns.md +413 -0
  356. package/docs/guides/display.md +204 -0
  357. package/docs/guides/editors.md +462 -0
  358. package/docs/guides/ports.md +246 -0
  359. package/docs/guides/selection.md +270 -0
  360. package/docs/guides/the-grid.md +696 -0
  361. package/docs/guides/the-provider.md +448 -0
  362. package/docs/index.md +52 -0
  363. package/docs/install.md +9 -47
  364. package/docs/reference/cells.md +28 -0
  365. package/docs/reference/display.md +44 -0
  366. package/docs/reference/editors-chips.md +6 -0
  367. package/docs/reference/editors-date.md +6 -0
  368. package/docs/reference/editors-location.md +10 -0
  369. package/docs/reference/editors-name.md +6 -0
  370. package/docs/reference/editors-number.md +11 -0
  371. package/docs/reference/editors-open-values.md +10 -0
  372. package/docs/reference/editors-panel.md +12 -0
  373. package/docs/reference/editors-range.md +6 -0
  374. package/docs/reference/editors-relation.md +12 -0
  375. package/docs/reference/editors-select.md +9 -0
  376. package/docs/reference/editors-session.md +11 -0
  377. package/docs/reference/editors-text.md +9 -0
  378. package/docs/reference/editors-value-list.md +6 -0
  379. package/docs/reference/editors.md +5 -0
  380. package/docs/reference/field-row.md +16 -0
  381. package/docs/reference/grid.md +39 -0
  382. package/docs/reference/react.md +89 -0
  383. package/docs/reference/selection.md +33 -0
  384. package/docs/reference/views.md +622 -0
  385. package/package.json +27 -4
  386. package/skills/views/SKILL.md +20 -5
  387. package/dist/filters/types.d.ts +0 -27
  388. package/dist/filters/types.js +0 -1
  389. package/dist/model/filter-pushdown.d.ts +0 -106
  390. package/dist/model/filter-pushdown.js +0 -147
@@ -0,0 +1,43 @@
1
+ "use client";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef } from "react";
4
+ import { SelectEditor, pickerOptionsFromField, } from "../../editors/SelectEditor.js";
5
+ import { EditorPanel } from "../../editors/EditorPanel.js";
6
+ import { resolveCategoryColor } from "@viewkitjs/fields/design/category-colors";
7
+ import { isOpenVocabulary } from "@viewkitjs/fields";
8
+ import { prettifyOptionValue } from "../../model/column-state.js";
9
+ import { offeredValues, useOpenValues } from "../../editors/open-values.js";
10
+ import { useGridEditSession } from "./grid-edit-session.js";
11
+ export function GridSelectEditor({ column, title, values, current, clearable = false, seed, optionColors, refuse, onCommit, onCancel, }) {
12
+ const editorRef = useRef(null);
13
+ const anchorRef = useRef(null);
14
+ const { session, close, sheet } = useGridEditSession({
15
+ editorRef,
16
+ refuse: refuse && ((value) => refuse(value)),
17
+ onCommit: (value) => onCommit(value),
18
+ onCancel,
19
+ });
20
+ const known = useOpenValues(column.field);
21
+ const optionLabel = (value) => column.options?.find((o) => o.value === value)?.label ?? prettifyOptionValue(value);
22
+ const field = column.field && (column.field.type === "select" || column.field.type === "status") ? column.field : null;
23
+ const declared = column.options?.filter((o) => !o.archived).map((o) => o.value);
24
+ const bareValues = declared && declared.length > 0 ? [...declared, ...(current && !declared.includes(current) ? [current] : [])] : values;
25
+ const pickerOptions = field
26
+ ? pickerOptionsFromField(field, {
27
+ optionColors,
28
+ extraValues: isOpenVocabulary(field) ? offeredValues(field, known, values) : [],
29
+ current,
30
+ })
31
+ : bareValues.map((value) => column.type === "status"
32
+ ? {
33
+ value,
34
+ label: optionLabel(value),
35
+ slot: column.options?.find((o) => o.value === value)?.slot ?? "muted",
36
+ }
37
+ : {
38
+ value,
39
+ label: optionLabel(value),
40
+ color: resolveCategoryColor(value, column.options, optionColors),
41
+ });
42
+ return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(EditorPanel, { session: session, title: title, anchor: anchorRef, align: "start", sideOffset: 4, initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "w-48 z-90", children: _jsx(SelectEditor, { ref: editorRef, options: pickerOptions, initial: current, clearable: clearable, creatable: !!column.field && isOpenVocabulary(column.field), seed: seed, focusSearch: !sheet, onRequestClose: close }) })] }));
43
+ }
@@ -0,0 +1,47 @@
1
+ import type { ReactNode } from "react";
2
+ import type { ListGroup } from "../../grouping/types.js";
3
+ import type { ListGroupSummaryPart } from "../../model/preferences.js";
4
+ import { type GridGroupSortOption } from "./GridGroupMenu.js";
5
+ import type { GridSortState } from "./GridColumnMenu.js";
6
+ import type { GridGroupFigure, GroupCountNoun } from "./grid-table-props.js";
7
+ export declare function GridBody<Row>({ empty, emptyState, grouped, groups, rows, selectable, selecting, allSelected, someSelected, selectAll, clearSelection, isCollapsed, countOf, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, keptFor, barIndexOf, ariaColCount, }: {
8
+ /** Each bar's row number among every row of the grid (`core/grid-aria.ts`). */
9
+ barIndexOf?: (groupKey: string) => number | undefined;
10
+ /** The grid's columns, which a bar's one cell spans. */
11
+ ariaColCount?: number;
12
+ empty: boolean;
13
+ emptyState?: ReactNode;
14
+ grouped: boolean;
15
+ groups: ListGroup<Row>[];
16
+ rows: Row[];
17
+ selectable: boolean;
18
+ selecting: boolean;
19
+ allSelected: boolean;
20
+ someSelected: boolean;
21
+ selectAll: () => void;
22
+ clearSelection: () => void;
23
+ isCollapsed?: (key: string) => boolean;
24
+ countOf?: (group: ListGroup<Row>) => number;
25
+ sort?: GridSortState;
26
+ sortOptions?: GridGroupSortOption[];
27
+ groupSummary?: ListGroupSummaryPart[];
28
+ onToggleGroup?: (key: string) => void;
29
+ onGroupSummaryChange?: (part: ListGroupSummaryPart, next: boolean) => void;
30
+ renderGroupLabel?: (group: ListGroup<Row>) => ReactNode;
31
+ onHideGroup?: (key: string) => void;
32
+ /** The figures the header can show, in the list's order. */
33
+ figures?: GridGroupFigure<Row>[];
34
+ /** The count's noun: "2 companies". None: a bare count. */
35
+ countNoun?: GroupCountNoun;
36
+ /** The column names' row, ending its rail lane with `checkbox` where it has one. */
37
+ renderHeader: (checkbox?: ReactNode, groupKey?: string) => ReactNode;
38
+ renderGroupCheckbox: (items: Row[]) => ReactNode;
39
+ /** Receives map's full triple: the row needs its INDEX and the sibling
40
+ * list to know whether the row above it is selected (see `selectedAbove`). */
41
+ /** The group key rides along: a row drawn under two groups is two rows on
42
+ * screen, and each needs its own identity. See `gridRowKey`. */
43
+ renderRow: (row: Row, index: number, items: Row[], groupKey: string) => ReactNode;
44
+ renderFooter: (group: ListGroup<Row>) => ReactNode;
45
+ /** The indices a section draws wherever they are: the focused and the editing row. */
46
+ keptFor: (groupKey: string) => readonly number[];
47
+ }): import("react/jsx-runtime").JSX.Element | import("react/jsx-runtime").JSX.Element[];
@@ -0,0 +1,41 @@
1
+ "use client";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { cx } from "../../internal/cx.js";
5
+ import { GridHeadCheck } from "./checks.js";
6
+ import { StuckMarker } from "./StuckMarker.js";
7
+ import { GridWindowRows } from "./grid-row-window.js";
8
+ import { GridGroupMenu } from "./GridGroupMenu.js";
9
+ import { GRID_CHROME_FOCUS, GRID_HEADER_BG, GRID_ROW_PAD } from "./grid-styles.js";
10
+ function GridCollapseRegion({ collapsed, children, }) {
11
+ const { Collapse } = useViews().components;
12
+ return (_jsx(Collapse, { open: !collapsed, clipClassName: "pt-[2px] mt-[-2px] pb-2 -mb-2", children: children }));
13
+ }
14
+ function GridGroupSection({ group, collapsed, count, selectable, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, keptFor, barIndex, ariaColCount, }) {
15
+ const { icons, messages } = useViews();
16
+ const Caret = collapsed ? icons.caretRight : icons.caretDown;
17
+ const summaryParts = groupSummary ?? [];
18
+ const shownFigures = (figures ?? []).filter((figure) => summaryParts.includes(figure.part));
19
+ const parts = [];
20
+ if (summaryParts.includes("count")) {
21
+ const noun = countNoun ? (count === 1 ? countNoun.one : countNoun.other) : null;
22
+ parts.push({ key: "count", node: noun ? `${count} ${noun}` : count });
23
+ }
24
+ for (const figure of shownFigures) {
25
+ parts.push({
26
+ key: figure.part,
27
+ node: (_jsxs(_Fragment, { children: [figure.label, " ", figure.render(group)] })),
28
+ });
29
+ }
30
+ return (_jsxs("div", { "data-slot": "vk-grid-group", "data-group-key": group.key, className: "mt-5 first:mt-0", children: [_jsx(StuckMarker, {}), _jsxs("div", { "data-slot": "vk-grid-group-head", className: cx("sticky top-0 z-30 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: [_jsx("div", { "data-slot": "vk-grid-group-header", role: "row", "aria-rowindex": barIndex, "aria-level": 1, "aria-expanded": !collapsed, className: cx("group/gridlabel sticky left-0 mb-1.5 flex h-(--vk-label-h) w-max max-w-[100cqw] select-none items-center gap-2", GRID_ROW_PAD), children: _jsxs("div", { "data-bar-name": true, tabIndex: -1, role: "gridcell", "aria-colindex": 1, "aria-colspan": ariaColCount, className: cx("flex min-w-0 items-center gap-2 rounded-sm", GRID_CHROME_FOCUS), children: [_jsx("button", { type: "button", tabIndex: -1, "aria-label": messages({ key: collapsed ? "views.grid.group-expand" : "views.grid.group-collapse" }), "aria-expanded": !collapsed, onClick: () => onToggleGroup?.(group.key), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-sm text-(color:--vk-fg-subtle) hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)", children: _jsx(Caret, { className: "h-(--vk-glyph) w-(--vk-glyph)" }) }), _jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem-(1.5rem-var(--vk-glyph))/2)] truncate text-(length:--vk-text) font-medium", children: renderGroupLabel?.(group) ?? group.label ?? "—" }), parts.length > 0 && (_jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem)] flex min-w-0 items-baseline gap-1.5 overflow-hidden text-(length:--vk-text) text-(color:--vk-fg-subtle) tabular-nums", children: parts.map((part) => (_jsxs("span", { className: "flex items-baseline gap-1.5 whitespace-nowrap", children: [_jsx("span", { "aria-hidden": true, className: "text-(color:--vk-fg-subtlest)", children: "\u00B7" }), _jsx("span", { children: part.node })] }, part.key))) })), ((sort && sortOptions && sortOptions.length > 0) || onHideGroup) && (_jsx(GridGroupMenu, { sort: sort, sortOptions: sortOptions ?? [], summary: summaryParts, onSummaryChange: onGroupSummaryChange, figures: figures, onHide: onHideGroup ? () => onHideGroup(group.key) : undefined }))] }) }), _jsx(GridCollapseRegion, { collapsed: collapsed, children: renderHeader(selectable ? renderGroupCheckbox(group.items) : undefined, group.key) })] }), _jsxs(GridCollapseRegion, { collapsed: collapsed, children: [_jsx(GridWindowRows, { groupKey: group.key, items: group.items, collapsed: collapsed, kept: keptFor(group.key), renderRow: renderRow }), renderFooter(group)] })] }));
31
+ }
32
+ export function GridBody({ empty, emptyState, grouped, groups, rows, selectable, selecting, allSelected, someSelected, selectAll, clearSelection, isCollapsed, countOf, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, keptFor, barIndexOf, ariaColCount, }) {
33
+ const { messages } = useViews();
34
+ if (empty) {
35
+ return (_jsxs(_Fragment, { children: [_jsx(StuckMarker, {}), _jsx("div", { "data-slot": "vk-grid-head", className: cx("sticky top-0 z-20 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: renderHeader(undefined, groups[0]?.key ?? "__all__") }), _jsx("div", { role: "row", "aria-rowindex": 2, children: _jsx("div", { role: "gridcell", "aria-colspan": ariaColCount, children: _jsx("div", { className: "sticky left-0 w-[100cqw]", children: emptyState }) }) })] }));
36
+ }
37
+ if (!grouped) {
38
+ return (_jsxs(_Fragment, { children: [_jsx(StuckMarker, {}), _jsx("div", { "data-slot": "vk-grid-head", className: cx("sticky top-0 z-20 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: renderHeader(selectable ? (_jsx(GridHeadCheck, { selecting: selecting, allSelected: allSelected, someSelected: someSelected, onToggle: (next) => (next ? selectAll() : clearSelection()), "aria-label": messages({ key: "views.grid.select-all" }) })) : undefined, groups[0]?.key ?? "__all__") }), _jsx(GridWindowRows, { groupKey: groups[0]?.key ?? "__all__", items: rows, collapsed: false, kept: keptFor(groups[0]?.key ?? "__all__"), renderRow: renderRow }), groups[0] != null && renderFooter(groups[0])] }));
39
+ }
40
+ return groups.map((group) => (_jsx(GridGroupSection, { group: group, collapsed: isCollapsed?.(group.key) ?? false, count: countOf ? countOf(group) : group.items.length, selectable: selectable, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: figures, countNoun: countNoun, renderHeader: renderHeader, renderGroupCheckbox: renderGroupCheckbox, renderRow: renderRow, renderFooter: renderFooter, keptFor: keptFor, barIndex: barIndexOf?.(group.key), ariaColCount: ariaColCount }, group.key)));
41
+ }
@@ -0,0 +1,4 @@
1
+ import type { GridTableProps } from "./grid-table-props.js";
2
+ export type { GridTableProps } from "./grid-table-props.js";
3
+ /** Spreadsheet sibling to ListView, including editing and synchronized grouped rails. */
4
+ export declare function GridTable<Row>(props: GridTableProps<Row>): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,192 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useDeferredValue, useMemo, useRef, useState } from "react";
4
+ import { createGridHoverStore, GridHoverContext } from "./grid-hover.js";
5
+ import { useViews } from "../../provider/context.js";
6
+ import { GridRailProbe, useGridRailReveal } from "./useGridRailReveal.js";
7
+ import { useGridBatchApi } from "./useGridBatchApi.js";
8
+ import { gridRowKey } from "../core/coordinates.js";
9
+ import { useDesktop } from "../../provider/desktop.js";
10
+ import { GridRow } from "./GridRow.js";
11
+ import { GridHeadCheck } from "./checks.js";
12
+ import { useGridColumnLayout } from "./useGridColumnLayout.js";
13
+ import { useGridScrollArea } from "./useGridScrollArea.js";
14
+ import { GridHeader } from "./GridHeader.js";
15
+ import { GridFooter, gridFooterShown } from "./GridFooter.js";
16
+ import { gridAriaLayout } from "../core/grid-aria.js";
17
+ import { GridBody } from "./GridStructure.js";
18
+ import { useGridScaleStyles } from "./useGridScaleStyles.js";
19
+ import { useGridTableInteractionModel } from "./useGridTableInteractionModel.js";
20
+ import { useGridTableSelection } from "./useGridTableSelection.js";
21
+ import { useGridHeaderDrag } from "./useGridHeaderDrag.js";
22
+ import { GridTableSurface } from "./GridTableSurface.js";
23
+ import { gridFlatRows } from "../core/flat-rows.js";
24
+ import { GridRowWindowContext, useGridRowWindow } from "./grid-row-window.js";
25
+ import { GRID_ROW_PX } from "./useGridScaleStyles.js";
26
+ export function GridTable(props) {
27
+ const { atoms, messages } = useViews();
28
+ const { Loading } = atoms;
29
+ const deferredKey = useDeferredValue(props.transitionKey);
30
+ if (props.transitionPending || !Object.is(deferredKey, props.transitionKey)) {
31
+ return _jsx(Loading, { placement: "body", label: props.transitionLabel ?? messages({ key: "views.grid.loading" }) });
32
+ }
33
+ return _jsx(GridTableContent, { ...props });
34
+ }
35
+ function GridTableContent(props) {
36
+ const { groups, grouped, getRowId, columns, isCollapsed, onToggleGroup, renderGroupLabel, onHideGroup, renderAggregate, countOf, onOpenRow, onPrefetchRow, rowHref, rowClassName, onRowDelete, rowActions, rowIcon, showRowIcon = true, freezeIdentity = true, selection, loadMore, emptyState, sort, groupBy, sortOptions, groupSummary, aggregates, onAggregateChange, onGroupSummaryChange, groupFigures, countNoun, optionColors, onOptionColorChange, dateStyles, onDateStyleChange, durationStyles, onDurationStyleChange, numberFormats, onNumberFormatChange, showTimeOverrides, onShowTimeChange, percentDisplays, onPercentDisplayChange, columnState, onColumnStateChange, listConfig, } = props;
37
+ const { atoms, messages } = useViews();
38
+ const { LoadMore } = atoms;
39
+ const verticalBorders = props.verticalBorders ?? true;
40
+ const scale = props.scale ?? 1;
41
+ const phone = !useDesktop();
42
+ const rootRef = useRef(null);
43
+ const [hoverStore] = useState(createGridHoverStore);
44
+ const { visibleColumns, widthVarsStyle, frozenCount, frozenLeft, columnManager, gridTemplate, minWidth, resizingId, startResize, moveResize, endResize, resetColumnWidth, hideColumn, moveColumn, } = useGridColumnLayout({
45
+ rootRef,
46
+ columns,
47
+ columnState,
48
+ onColumnStateChange,
49
+ scale,
50
+ freezeIdentity,
51
+ viewBacked: props.viewBacked,
52
+ });
53
+ const showAddColumn = !!columnManager && !phone;
54
+ const scaleVarsStyle = useGridScaleStyles(scale, grouped, phone, showAddColumn);
55
+ const flatRows = useMemo(() => groups.flatMap((g) => g.items), [groups]);
56
+ const shutKey = JSON.stringify(grouped ? groups.filter((g) => isCollapsed?.(g.key)).map((g) => g.key) : []);
57
+ const flat = useMemo(() => {
58
+ const shut = new Set(JSON.parse(shutKey));
59
+ return gridFlatRows({ groups, grouped, isCollapsed: (key) => shut.has(key), getRowId });
60
+ }, [groups, grouped, shutKey, getRowId]);
61
+ const rowIndex = useMemo(() => {
62
+ const byKey = new Map();
63
+ for (const section of flat.sections) {
64
+ for (const row of section.items) {
65
+ const rowId = getRowId(row);
66
+ const key = gridRowKey(section.groupKey, rowId);
67
+ byKey.set(key, { key, rowId, row });
68
+ }
69
+ }
70
+ return byKey;
71
+ }, [flat, getRowId]);
72
+ const visibleRowKeys = flat.visible;
73
+ const rowWindow = useGridRowWindow({ rootRef, flat, rowHeight: GRID_ROW_PX * scale });
74
+ const { selectable, selecting, selectionState: sel, checkDrag, groupSelection, } = useGridTableSelection({
75
+ rootRef,
76
+ groups,
77
+ grouped,
78
+ isCollapsed,
79
+ getRowId,
80
+ selection,
81
+ });
82
+ const visibleColIds = useMemo(() => visibleColumns.map((c) => c.id), [visibleColumns]);
83
+ const sectionRowKeys = useMemo(() => flat.sections.map((s) => s.items.map((row) => gridRowKey(s.groupKey, getRowId(row)))), [flat, getRowId]);
84
+ const groupByKey = new Map(groups.map((group) => [group.key, group]));
85
+ const footerShown = (groupKey) => {
86
+ const group = grouped ? groupByKey.get(groupKey) : groups[0];
87
+ if (!group)
88
+ return false;
89
+ const hostCells = visibleColumns.map((column) => renderAggregate?.(column.id, group) ?? null);
90
+ return gridFooterShown({ interactive: !!onAggregateChange, hostCells });
91
+ };
92
+ const barMenu = grouped && ((!!sort && (sortOptions?.length ?? 0) > 0) || !!onHideGroup);
93
+ const footerKey = flat.sections.map((s) => (!s.collapsed && footerShown(s.groupKey) ? "1" : "0")).join("");
94
+ const focusShape = useMemo(() => ({
95
+ grouped,
96
+ selectable,
97
+ columnIds: visibleColIds,
98
+ addColumn: showAddColumn,
99
+ sections: flat.sections.map((s, index) => ({
100
+ groupKey: s.groupKey,
101
+ collapsed: s.collapsed,
102
+ rowKeys: sectionRowKeys[index] ?? [],
103
+ footer: footerKey[index] === "1",
104
+ menu: barMenu,
105
+ })),
106
+ }), [barMenu, flat, footerKey, grouped, sectionRowKeys, selectable, showAddColumn, visibleColIds]);
107
+ const groupOfRow = (rowKey) => flat.place.get(rowKey)?.groupKey;
108
+ const more = !!loadMore?.hasMore;
109
+ const aria = useMemo(() => gridAriaLayout({
110
+ sections: flat.sections.map((s, index) => ({
111
+ groupKey: s.groupKey,
112
+ collapsed: s.collapsed,
113
+ count: s.items.length,
114
+ footer: footerKey[index] === "1",
115
+ })),
116
+ grouped,
117
+ selectable,
118
+ columnIds: visibleColIds,
119
+ more,
120
+ }), [flat, footerKey, grouped, selectable, visibleColIds, more]);
121
+ const ariaTailIndex = aria.colCount + 1;
122
+ const ariaColOffset = selectable ? 1 : 0;
123
+ const { rowSpansMap, selectValuesByColumn, onRangeCopy, onRangeCut, onRangeClear, onRangePaste, onPasteAtCell, inActiveRange, rangeCanClear, editingEnabled, focusedCell, editingCell, pendingByRow, settlementByRow, editSeed, editWhole, focusCellSync, startEditSync, cancelEdit, commitEdit, commitBatch, refuseEdit, onExtendCell, onAddCell, handleRootPointerDown, handleRootPointerDownCapture, handleRootClickCapture, onEditorTab, onEditorEnter, enterGrid, focus, } = useGridTableInteractionModel({
124
+ rootRef,
125
+ props,
126
+ rows: flatRows,
127
+ visibleRows: visibleRowKeys,
128
+ heldRows: flat.order,
129
+ focusShape,
130
+ groupOfRow,
131
+ rowIndex,
132
+ visibleColumns,
133
+ selecting,
134
+ revealRow: rowWindow.revealRow,
135
+ });
136
+ const railRow = focus.chrome?.kind === "rail" ? focus.chrome.rowKey : undefined;
137
+ const keptFor = (groupKey) => {
138
+ const kept = [];
139
+ for (const key of [focusedCell?.rowId, editingCell?.rowId, railRow]) {
140
+ const place = key != null ? flat.place.get(key) : undefined;
141
+ if (place?.groupKey === groupKey)
142
+ kept.push(place.index);
143
+ }
144
+ return kept;
145
+ };
146
+ const { areaRef, scrollXRef, getScroller } = useGridScrollArea(rootRef);
147
+ const total = useMemo(() => groups.reduce((n, g) => n + g.items.length, 0), [groups]);
148
+ const empty = grouped ? groups.length === 0 : total === 0;
149
+ const rail = useGridRailReveal({ rootRef, earned: selecting || !!props.alwaysCheckboxes });
150
+ const batchApi = useGridBatchApi({
151
+ enabled: editingEnabled,
152
+ columns: visibleColumns,
153
+ listConfig,
154
+ rows: flatRows,
155
+ getRowId,
156
+ pendingByRow,
157
+ commitBatch,
158
+ });
159
+ const headerDrag = useGridHeaderDrag({
160
+ columns,
161
+ columnState,
162
+ onColumnStateChange,
163
+ visibleColumnIds: visibleColIds,
164
+ scrollXRef,
165
+ getScroller,
166
+ viewBacked: props.viewBacked,
167
+ });
168
+ const rowRangeFor = (rowKey) => rowSpansMap.get(rowKey);
169
+ const renderRow = (row, index, items, groupKey) => {
170
+ const rowId = getRowId(row);
171
+ const rowKey = gridRowKey(groupKey, rowId);
172
+ const above = index > 0 ? items[index - 1] : null;
173
+ return (_jsx(GridRow, { row: row, id: rowId, rowKey: rowKey, columns: visibleColumns, selectable: selectable, selected: sel.isSelected(rowId), selectedAbove: above != null && sel.isSelected(getRowId(above)), selecting: selecting, toggle: sel.toggle, toggleRange: sel.toggleRange, contextMenu: props.contextMenu ?? props.rowMenu, rowClassName: rowClassName, rowHref: rowHref, onOpenRow: onOpenRow, onPrefetchRow: onPrefetchRow, onOpenRelation: props.onOpenRelation, entityIcon: props.entityIcon, commands: props.commands, onRowDelete: onRowDelete, deleteLabel: props.deleteLabel, rowActions: rowActions, rowIcon: showRowIcon ? rowIcon : undefined, frozenCount: frozenCount, frozenLeft: frozenLeft, verticalBorders: verticalBorders, optionColors: optionColors, dateStyles: dateStyles, durationStyles: durationStyles, numberFormats: numberFormats, showTimeOverrides: showTimeOverrides, percentDisplays: percentDisplays, editingEnabled: editingEnabled, listConfig: listConfig, focusedColId: focusedCell?.rowId === rowKey ? focusedCell.columnId : null, editingColId: editingCell?.rowId === rowKey ? editingCell.columnId : null, editSeed: editingCell?.rowId === rowKey ? editSeed : null, editWhole: editingCell?.rowId === rowKey && editWhole, onEditorTab: onEditorTab, onEditorEnter: onEditorEnter, pendingByCol: pendingByRow.get(rowId), settlementByCol: settlementByRow.get(rowId), selectValues: selectValuesByColumn, rowRange: rowRangeFor(rowKey), ariaRowIndex: aria.rowIndex(groupKey, index), ariaLevel: grouped ? 2 : undefined, ariaPosInSet: grouped ? index + 1 : undefined, ariaSetSize: grouped ? items.length : undefined, ariaColOffset: ariaColOffset, ariaTailIndex: ariaTailIndex, onFocusCell: focusCellSync, onStartEdit: startEditSync, onRefuseEdit: refuseEdit, onExtendCell: onExtendCell, onAddCell: onAddCell, onCommitCell: commitEdit, onCancelEdit: cancelEdit, inActiveRange: inActiveRange, rangeCanClear: rangeCanClear, onRangeCopy: onRangeCopy, onRangeCut: onRangeCut, onRangePaste: onRangePaste, onRangeClear: onRangeClear, onPasteAtCell: onPasteAtCell }, rowKey));
174
+ };
175
+ const header = (checkbox, groupKey) => (_jsx(GridHeader, { showAddColumn: showAddColumn, checkbox: checkbox, groupKey: groupKey, ariaRowIndex: empty ? 1 : groupKey != null ? aria.headIndex(groupKey) : undefined, ariaLevel: grouped ? 2 : undefined, ariaColOffset: ariaColOffset, ariaTailIndex: ariaTailIndex, columns: visibleColumns, columnManager: columnManager, minWidth: minWidth, sort: sort, selectValues: selectValuesByColumn, optionColors: optionColors, onOptionColorChange: onOptionColorChange, dateStyles: dateStyles, onDateStyleChange: onDateStyleChange, durationStyles: durationStyles, onDurationStyleChange: onDurationStyleChange, numberFormats: numberFormats, onNumberFormatChange: onNumberFormatChange, showTimeOverrides: showTimeOverrides, onShowTimeChange: onShowTimeChange, percentDisplays: percentDisplays, onPercentDisplayChange: onPercentDisplayChange, columnStateEnabled: !!onColumnStateChange, listConfig: listConfig, groupBy: groupBy, viewBacked: props.viewBacked, formatsWritable: props.formatsWritable, renderAddColumn: props.renderAddColumn, renderColumnMenuRows: props.renderColumnMenuRows, resizingId: resizingId, startResize: startResize, moveResize: moveResize, endResize: endResize, resetColumnWidth: resetColumnWidth, hideColumn: hideColumn, moveColumn: moveColumn, headerDrag: headerDrag, frozenCount: frozenCount, frozenLeft: frozenLeft }));
176
+ const footer = (group) => (_jsx(GridFooter, { group: group, ariaRowIndex: aria.footIndex(grouped ? group.key : (flat.sections[0]?.groupKey ?? group.key)), ariaLevel: grouped ? 2 : undefined, ariaColOffset: ariaColOffset, columns: visibleColumns, selecting: selecting, aggregates: aggregates, numberFormats: numberFormats, renderAggregate: renderAggregate, onAggregateChange: onAggregateChange, viewBacked: props.viewBacked, frozenCount: frozenCount, frozenLeft: frozenLeft, continuation: props.renderGroupFooter?.(group), defaultCurrency: props.defaultCurrency }));
177
+ const groupCheckbox = (items) => (_jsx(GridHeadCheck, { selecting: selecting, ...groupSelection(items), "aria-label": messages({ key: "views.grid.select-group" }) }));
178
+ return (_jsx(GridHoverContext.Provider, { value: hoverStore, children: _jsx(GridRowWindowContext.Provider, { value: rowWindow.store, children: _jsx(GridTableSurface, { rootRef: rootRef, areaRef: areaRef, minWidth: minWidth, columnsTemplate: gridTemplate, gridAria: empty
179
+ ? { role: "grid", rowCount: 2, colCount: ariaTailIndex }
180
+ : { role: aria.role, rowCount: aria.rowCount, colCount: ariaTailIndex }, style: { ...widthVarsStyle, ...scaleVarsStyle }, selecting: selecting, railRootProps: rail.rootProps, onPointerDown: (event) => {
181
+ if (checkDrag.tryArm(event))
182
+ return;
183
+ handleRootPointerDown(event);
184
+ }, onPointerDownCapture: handleRootPointerDownCapture, onClickCapture: (event) => {
185
+ if (checkDrag.consumeDrag()) {
186
+ event.preventDefault();
187
+ event.stopPropagation();
188
+ return;
189
+ }
190
+ handleRootClickCapture(event);
191
+ }, railProbe: _jsx(GridRailProbe, { probeRef: rail.probeRef }), onGuardFocus: enterGrid, body: _jsx(GridBody, { empty: empty, emptyState: emptyState, grouped: grouped, groups: groups, rows: flatRows, selectable: selectable, selecting: selecting, allSelected: sel.allSelected, someSelected: sel.someSelected, selectAll: sel.selectAll, clearSelection: sel.clear, isCollapsed: isCollapsed, countOf: countOf, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: groupFigures, countNoun: countNoun, renderHeader: header, renderGroupCheckbox: groupCheckbox, renderRow: renderRow, renderFooter: footer, keptFor: keptFor, barIndexOf: aria.barIndex, ariaColCount: ariaTailIndex }), loadMore: loadMore?.hasMore ? _jsx(LoadMore, { onReveal: loadMore.onReveal, label: loadMore.label }) : undefined, selectionBar: selection?.renderBar(sel, batchApi) }) }) }));
192
+ }
@@ -0,0 +1,52 @@
1
+ import type { CSSProperties, HTMLAttributes, PointerEventHandler, MouseEventHandler, ReactNode, RefCallback, RefObject } from "react";
2
+ /**
3
+ * The grid's frame and its one scroll area.
4
+ *
5
+ * The FRAME (`data-slot="vk-grid"`) fills the box its app gives it: `height: 100%` where the app
6
+ * gives a definite height, `flex: 1 1 0` where the app is a flex column, `min-height: 0` either way so
7
+ * the box can shrink below its rows. It doesn't scroll. It holds the CSS variables, the rail's
8
+ * signal, the pointer handlers, the selection bar and the rail probe.
9
+ *
10
+ * The AREA (`data-slot="vk-grid-scroll"`) is the one element that scrolls, both ways, on every
11
+ * screen. Every group's head pins at its top and every frozen cell sticks to its left because they
12
+ * sit in the same scrollport as the rows. It bleeds into the page's side padding (`--vk-gutter`), so
13
+ * the rows run edge to edge and their content lines up with the page. Its overflow is inline, both axes
14
+ * spelled out: it is the one property the grid's working rests on, under any stylesheet. `@container` lets a group's label
15
+ * keep to the visible width (`100cqw`) while the table is wider. `overscroll-x-contain`: a sideways
16
+ * scroll that reaches the table's edge stops there and never swipes the browser back a page. Down
17
+ * and up chain as usual, so where the app gives the grid no height a wheel over it still scrolls the
18
+ * page.
19
+ *
20
+ * A frame with no height (an app that hasn't given one) grows to its rows: the page scrolls it, and
21
+ * its heads don't pin.
22
+ */
23
+ export declare function GridTableSurface({ rootRef, areaRef, style, selecting, minWidth, columnsTemplate, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, onGuardFocus, gridAria, }: {
24
+ /** What a screen reader is told of the whole table: a grid (a tree grid when grouped), its rows (-1 while more
25
+ * remain to load) and its columns. */
26
+ gridAria?: {
27
+ role: "grid" | "treegrid";
28
+ rowCount: number;
29
+ colCount: number;
30
+ };
31
+ rootRef: RefObject<HTMLDivElement | null>;
32
+ /** A guard took the focus: `from` is where it came from (the browser's Tab from before or after the grid, or the
33
+ * grid itself handing focus on as it is left). */
34
+ onGuardFocus?: (which: "start" | "end", from: Element | null) => void;
35
+ /** The scroll area's ref (`useGridScrollArea`). */
36
+ areaRef: RefCallback<HTMLDivElement>;
37
+ style: CSSProperties;
38
+ selecting: boolean;
39
+ /** The table's minimum width: the content box is never narrower, so every head spans the table. */
40
+ minWidth: string;
41
+ /** The columns' template, set once on the area as `--vk-cols`: every row, head and footer reads it. */
42
+ columnsTemplate: string;
43
+ railRootProps: HTMLAttributes<HTMLDivElement>;
44
+ onPointerDown: PointerEventHandler<HTMLDivElement>;
45
+ /** Marks a press as the grid's own, its portaled popups' included: the click-away reads it. */
46
+ onPointerDownCapture: PointerEventHandler<HTMLDivElement>;
47
+ onClickCapture: MouseEventHandler<HTMLDivElement>;
48
+ railProbe: ReactNode;
49
+ body: ReactNode;
50
+ loadMore?: ReactNode;
51
+ selectionBar?: ReactNode;
52
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,15 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { cx } from "../../internal/cx.js";
4
+ import { GRID_BLEED } from "./grid-styles.js";
5
+ export function GridTableSurface({ rootRef, areaRef, style, selecting, minWidth, columnsTemplate, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, onGuardFocus, gridAria, }) {
6
+ return (_jsxs("div", { ref: rootRef, style: style, tabIndex: -1, className: "group/gridtable relative flex h-full min-h-0 flex-1 flex-col animate-fade-in outline-none", "data-slot": "vk-grid", ...railRootProps, onPointerDown: onPointerDown, onPointerDownCapture: onPointerDownCapture, onClickCapture: onClickCapture, children: [_jsx("span", { "data-grid-guard": "start", tabIndex: 0, className: "absolute size-0 overflow-hidden outline-none", onFocus: (event) => onGuardFocus?.("start", event.relatedTarget) }), _jsx("div", { ref: areaRef, "data-slot": "vk-grid-scroll", className: cx("@container min-h-0 flex-1 overscroll-x-contain", GRID_BLEED), style: {
7
+ overflowX: "auto",
8
+ overflowY: "auto",
9
+ scrollPaddingBottom: "var(--vk-scroll-inset-bottom,0px)",
10
+ "--vk-cols": columnsTemplate,
11
+ }, children: _jsxs("div", { className: "relative", role: gridAria?.role, "aria-rowcount": gridAria?.rowCount, "aria-colcount": gridAria?.colCount, "aria-multiselectable": gridAria ? true : undefined, style: {
12
+ minWidth,
13
+ paddingBottom: `calc(${selecting ? "3.5rem" : "0.5rem"} + var(--vk-scroll-inset-bottom,0px))`,
14
+ }, children: [body, loadMore ? (_jsx("div", { role: "row", children: _jsx("div", { role: "gridcell", "aria-colspan": gridAria?.colCount, children: loadMore }) })) : null] }) }), _jsx("span", { "data-grid-guard": "end", tabIndex: 0, className: "absolute size-0 overflow-hidden outline-none", onFocus: (event) => onGuardFocus?.("end", event.relatedTarget) }), selectionBar, railProbe] }));
15
+ }
@@ -0,0 +1,45 @@
1
+ import { type ReactNode } from "react";
2
+ import { type OpenableType } from "../../editors/open-value.js";
3
+ import { type TextEditorType } from "../../editors/TextEditor.js";
4
+ /** The text editor's type for a grid column's type: the six text types as they are, a title and
5
+ * anything else as plain text. */
6
+ export declare function gridTextEditorType(colType: string | undefined): TextEditorType;
7
+ /**
8
+ * The GRID's text cell, hosting the shared `TextEditor` through the grid's edit session. On a
9
+ * desktop it types in the cell (the spreadsheet's typing): Enter, Tab and a click away write at
10
+ * once and move on as the key says; Escape throws the edit away; an unchanged value writes nothing
11
+ * and still moves on. A value the grid would refuse (an email that isn't one) stays in the cell
12
+ * with its reason under it.
13
+ *
14
+ * On a phone it opens in the sheet, titled with the column's header (`EditorPanel`, `sheetOnPhone`):
15
+ * ✕ and a swipe change nothing, ✓ saves and closes without moving the selection, and the write waits
16
+ * for the sheet to slide away.
17
+ */
18
+ export declare function GridTextEditor({ initial, seed, type, title, strong, open, refuse, onCommit, onCancel, onTab, onEnter, }: {
19
+ /** The stored email, phone, link or domain the sheet's open action follows (mail, call or browse), drawn
20
+ * beside the box on a phone, where a tap on the cell edits it. Gone once the box is typed over: it opens
21
+ * what is stored, never a draft. */
22
+ open?: {
23
+ type: OpenableType;
24
+ value: unknown;
25
+ };
26
+ /** The stored value; also the draft when no `seed` is given. */
27
+ initial: string;
28
+ /** Type-to-replace: the character that opened this editor; the draft opens on it. */
29
+ seed?: string;
30
+ /** The field's text type: the keyboard the box brings. Default `text`. */
31
+ type?: TextEditorType;
32
+ /** The sheet's title on a phone: the column's header. */
33
+ title?: ReactNode;
34
+ /** Title columns render medium-weight — match it while editing. */
35
+ strong?: boolean;
36
+ onCommit: (value: string) => void;
37
+ onCancel: () => void;
38
+ /** Commit happened via Tab — move to the next cell in reading order. */
39
+ onTab?: (backwards: boolean) => void;
40
+ /** Commit happened via Enter — advance one row down (Sheets). */
41
+ onEnter?: () => void;
42
+ /** The grid's judgement of a value before it is written: its reason when it would refuse it.
43
+ * A refused value stays in the box with that reason. */
44
+ refuse?: (value: string) => string | null;
45
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,38 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef, useState } from "react";
4
+ import { EditorPanel } from "../../editors/EditorPanel.js";
5
+ import { OpenValueAction } from "../../editors/open-value.js";
6
+ import { TextEditor, } from "../../editors/TextEditor.js";
7
+ import { cx } from "../../internal/cx.js";
8
+ import { GridRefusal, useGridEditSession } from "./grid-edit-session.js";
9
+ const TEXT_TYPES = new Set([
10
+ "text",
11
+ "url",
12
+ "domain",
13
+ "email",
14
+ "phone",
15
+ "rich_text",
16
+ ]);
17
+ export function gridTextEditorType(colType) {
18
+ return colType && TEXT_TYPES.has(colType) ? colType : "text";
19
+ }
20
+ export function GridTextEditor({ initial, seed, type = "text", title, strong = false, open, refuse, onCommit, onCancel, onTab, onEnter, }) {
21
+ const editorRef = useRef(null);
22
+ const { session, close } = useGridEditSession({
23
+ editorRef,
24
+ inPlace: true,
25
+ refuse: refuse && ((value) => refuse(value)),
26
+ onCommit: (payload) => onCommit(payload),
27
+ onCancel,
28
+ onTab,
29
+ onEnter,
30
+ });
31
+ const [stored, setStored] = useState(seed === undefined);
32
+ return (_jsx(EditorPanel, { session: session, title: title ?? "", anchor: null, inPlace: true, sheetOnPhone: true, children: (surface) => {
33
+ const editor = (_jsx(TextEditor, { ref: editorRef, type: type, initial: initial, seed: seed, closeOnBlur: surface === "in-place", chrome: surface === "sheet" ? "field" : "bare", boxData: { "data-slot": "vk-grid-editor", "data-grid-editor": "" }, onRequestClose: close, className: surface === "sheet"
34
+ ? "w-full min-w-0 select-text"
35
+ : cx("h-full w-full min-w-0 select-text bg-transparent text-(length:--vk-text) text-(color:--vk-fg) outline-hidden placeholder:text-(color:--vk-fg-subtlest)", strong && "font-medium") }));
36
+ return surface === "sheet" ? (open ? (_jsxs("div", { className: "flex items-center gap-2 px-4 pb-4", onInput: (e) => setStored(e.target.value === initial), children: [_jsx("div", { className: "min-w-0 flex-1", children: editor }), stored && _jsx(OpenValueAction, { type: open.type, value: open.value, label: initial })] })) : (_jsx("div", { className: "px-4 pb-4", children: editor }))) : (_jsxs("span", { className: "relative flex h-full w-full min-w-0", children: [editor, _jsx(GridRefusal, { reason: session.refusal })] }));
37
+ } }));
38
+ }
@@ -0,0 +1,30 @@
1
+ import { type ReactNode } from "react";
2
+ import type { FieldDefOf, MultipleType, ValueItem } from "@viewkitjs/fields";
3
+ /**
4
+ * The GRID's host around the shared `ValueListEditor`. Anchored, like the name
5
+ * editor: a list of rows does not fit a cell, so it opens in a panel under it
6
+ * while the cell's own values stay on screen. The edit session owns the
7
+ * one-answer guard and the exit gap; the editor panel opens the popover on a
8
+ * desktop and the sheet on a phone, titled with the column's header. No seed: a
9
+ * key typed on a list cell opens the list as it is (`useGridKeyboard`'s
10
+ * `seedable`).
11
+ */
12
+ export declare function GridValueListEditor({ field, title, initial, labels, allowEmpty, region, refuse, onCommit, onCancel, onTab, onEnter, }: {
13
+ field: FieldDefOf<MultipleType>;
14
+ /** The field's name: the sheet's title on a phone. */
15
+ title: ReactNode;
16
+ initial: unknown;
17
+ labels: boolean;
18
+ /** Every value removed commits `null`; without it, an emptied list closes unchanged. */
19
+ allowEmpty?: boolean;
20
+ /** The row's country, where a phone typed without its code is read. */
21
+ region?: string | null;
22
+ /** The grid's judgement of the list it is about to write: its reason, or null. A refused list stays open
23
+ * with the reason under it. */
24
+ refuse?: (payload: ValueItem<unknown>[] | null) => string | null;
25
+ onCommit: (payload: ValueItem<unknown>[] | null) => void;
26
+ onCancel: () => void;
27
+ onTab?: (backwards: boolean) => void;
28
+ /** Commit happened via Enter — advance one row down. */
29
+ onEnter?: () => void;
30
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,19 @@
1
+ "use client";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef } from "react";
4
+ import { EditorPanel } from "../../editors/EditorPanel.js";
5
+ import { ValueListEditor } from "../../editors/ValueListEditor.js";
6
+ import { useGridEditSession } from "./grid-edit-session.js";
7
+ export function GridValueListEditor({ field, title, initial, labels, allowEmpty = false, region, refuse, onCommit, onCancel, onTab, onEnter, }) {
8
+ const anchorRef = useRef(null);
9
+ const editorRef = useRef(null);
10
+ const { session, close } = useGridEditSession({
11
+ editorRef,
12
+ refuse: refuse ? (payload) => refuse(payload) : undefined,
13
+ onCommit: (payload) => onCommit(payload),
14
+ onCancel,
15
+ onTab,
16
+ onEnter,
17
+ });
18
+ return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(EditorPanel, { session: session, title: title, anchor: anchorRef, align: "start", sideOffset: 4, initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "z-90 w-96 p-2", children: (surface) => (_jsx(ValueListEditor, { ref: editorRef, field: field, initial: initial, labels: labels, allowEmpty: allowEmpty, region: region, openLinks: surface === "sheet", onRequestClose: close })) })] }));
19
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Says when the sticky header right after it is STUCK — `data-stuck="true"`
3
+ * on that header, while it stands below where it would rest (Mihai,
4
+ * 2026-10-05).
5
+ *
6
+ * The header's ground leaves a 2px sliver at its foot see-through
7
+ * (GRID_HEADER_BG): at rest it is where the first row's selection ring draws
8
+ * its top edge. Stuck, rows pass under the header, and through that sliver a
9
+ * row's top showed a pixel or two above the header's line. So the header goes
10
+ * solid while stuck (`data-[stuck=true]:bg-(color:--vk-ground)`) and keeps the sliver
11
+ * at rest, where nothing passes under it.
12
+ *
13
+ * Zero-height and in flow, so it marks exactly where the header would rest;
14
+ * the header is stuck once its top has left that mark.
15
+ */
16
+ export declare function StuckMarker(): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,34 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useEffect, useRef } from "react";
4
+ export function StuckMarker() {
5
+ const ref = useRef(null);
6
+ useEffect(() => {
7
+ const marker = ref.current;
8
+ const header = marker?.nextElementSibling;
9
+ if (!marker || !header)
10
+ return;
11
+ let raf = 0;
12
+ const apply = () => {
13
+ raf = 0;
14
+ const stuck = header.getBoundingClientRect().top - marker.getBoundingClientRect().top > 0.5;
15
+ if ((header.dataset.stuck === "true") !== stuck)
16
+ header.dataset.stuck = String(stuck);
17
+ };
18
+ const schedule = () => {
19
+ if (!raf)
20
+ raf = requestAnimationFrame(apply);
21
+ };
22
+ apply();
23
+ window.addEventListener("scroll", schedule, true);
24
+ window.addEventListener("resize", schedule);
25
+ return () => {
26
+ window.removeEventListener("scroll", schedule, true);
27
+ window.removeEventListener("resize", schedule);
28
+ if (raf)
29
+ cancelAnimationFrame(raf);
30
+ delete header.dataset.stuck;
31
+ };
32
+ }, []);
33
+ return _jsx("div", { ref: ref, "aria-hidden": true, className: "h-0" });
34
+ }
@@ -0,0 +1,9 @@
1
+ import type { ViewsClipboardPort } from "../../provider/ports.js";
2
+ import { type GridCellClipboard, type GridClipboardCell } from "../core/clipboard-model.js";
3
+ import type { ListColumn } from "../../model/column-schema.js";
4
+ export { cellClearPrev, cellEditBaseline, cellPrevPayload, rowHoldsCurrency, coercePaste, parseTsvText, type GridPasteSource, } from "../core/clipboard-model.js";
5
+ export declare function getGridClipboard(): GridCellClipboard | null;
6
+ /** Puts one cell's text on the system clipboard through the app's port, and keeps the typed entry
7
+ * the grid pastes from — which survives a refused system write. */
8
+ export declare function copyCell<Row>(write: ViewsClipboardPort["writeText"], col: ListColumn<Row>, baseline: unknown, unit?: string): Promise<string>;
9
+ export declare function copyCells(write: ViewsClipboardPort["writeText"], matrix: GridClipboardCell[][]): Promise<string>;