@viewkitjs/views 0.0.0-stage → 0.2.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 (451) hide show
  1. package/CHANGELOG.md +615 -0
  2. package/LICENSE.md +7 -0
  3. package/README.md +99 -2
  4. package/dist/atoms/CommandMenu.d.ts +2 -0
  5. package/dist/atoms/CommandMenu.js +20 -0
  6. package/dist/atoms/List.d.ts +2 -0
  7. package/dist/atoms/List.js +6 -0
  8. package/dist/atoms/LoadMore.d.ts +2 -0
  9. package/dist/atoms/LoadMore.js +25 -0
  10. package/dist/atoms/Loading.d.ts +2 -0
  11. package/dist/atoms/Loading.js +7 -0
  12. package/dist/atoms/PlatformMark.d.ts +2 -0
  13. package/dist/atoms/PlatformMark.js +4 -0
  14. package/dist/atoms/RelationLink.d.ts +2 -0
  15. package/dist/atoms/RelationLink.js +6 -0
  16. package/dist/atoms/Row.d.ts +3 -0
  17. package/dist/atoms/Row.js +30 -0
  18. package/dist/atoms/RowMenu.d.ts +2 -0
  19. package/dist/atoms/RowMenu.js +112 -0
  20. package/dist/atoms/StatusBadge.d.ts +2 -0
  21. package/dist/atoms/StatusBadge.js +7 -0
  22. package/dist/atoms/StatusMarker.d.ts +2 -0
  23. package/dist/atoms/StatusMarker.js +19 -0
  24. package/dist/atoms/Tag.d.ts +2 -0
  25. package/dist/atoms/Tag.js +13 -0
  26. package/dist/atoms/TickBox.d.ts +2 -0
  27. package/dist/atoms/TickBox.js +8 -0
  28. package/dist/atoms/defaults.d.ts +2 -0
  29. package/dist/atoms/defaults.js +27 -0
  30. package/dist/atoms/tones.d.ts +5 -0
  31. package/dist/atoms/tones.js +28 -0
  32. package/dist/atoms/types.d.ts +178 -0
  33. package/dist/atoms/types.js +3 -0
  34. package/dist/cells/cell-format.d.ts +138 -0
  35. package/dist/cells/cell-format.js +16 -0
  36. package/dist/cells/cell-title.d.ts +17 -0
  37. package/dist/cells/cell-title.js +8 -0
  38. package/dist/cells/cell-values.d.ts +28 -0
  39. package/dist/cells/cell-values.js +87 -0
  40. package/dist/cells/index.d.ts +4 -0
  41. package/dist/cells/index.js +4 -0
  42. package/dist/cells/legacy-field.d.ts +52 -0
  43. package/dist/cells/legacy-field.js +164 -0
  44. package/dist/cells/relation-wrap.d.ts +3 -0
  45. package/dist/cells/relation-wrap.js +24 -0
  46. package/dist/cells/use-cell-format.d.ts +5 -0
  47. package/dist/cells/use-cell-format.js +10 -0
  48. package/dist/contract.d.ts +461 -0
  49. package/dist/contract.js +682 -0
  50. package/dist/display/actor.d.ts +4 -0
  51. package/dist/display/actor.js +26 -0
  52. package/dist/display/boolean.d.ts +18 -0
  53. package/dist/display/boolean.js +43 -0
  54. package/dist/display/breakdown.d.ts +15 -0
  55. package/dist/display/breakdown.js +32 -0
  56. package/dist/display/currency.d.ts +9 -0
  57. package/dist/display/currency.js +29 -0
  58. package/dist/display/date.d.ts +12 -0
  59. package/dist/display/date.js +26 -0
  60. package/dist/display/display-cores.d.ts +31 -0
  61. package/dist/display/display-cores.js +57 -0
  62. package/dist/display/entity-chip.d.ts +26 -0
  63. package/dist/display/entity-chip.js +9 -0
  64. package/dist/display/format.d.ts +66 -0
  65. package/dist/display/format.js +190 -0
  66. package/dist/display/index.d.ts +8 -0
  67. package/dist/display/index.js +7 -0
  68. package/dist/display/link.d.ts +29 -0
  69. package/dist/display/link.js +50 -0
  70. package/dist/display/location.d.ts +8 -0
  71. package/dist/display/location.js +22 -0
  72. package/dist/display/multi-value.d.ts +18 -0
  73. package/dist/display/multi-value.js +28 -0
  74. package/dist/display/name.d.ts +6 -0
  75. package/dist/display/name.js +14 -0
  76. package/dist/display/number.d.ts +11 -0
  77. package/dist/display/number.js +27 -0
  78. package/dist/display/options.d.ts +153 -0
  79. package/dist/display/options.js +1 -0
  80. package/dist/display/percent.d.ts +4 -0
  81. package/dist/display/percent.js +40 -0
  82. package/dist/display/phone.d.ts +11 -0
  83. package/dist/display/phone.js +45 -0
  84. package/dist/display/range.d.ts +6 -0
  85. package/dist/display/range.js +29 -0
  86. package/dist/display/relation.d.ts +4 -0
  87. package/dist/display/relation.js +29 -0
  88. package/dist/display/rich-text.d.ts +10 -0
  89. package/dist/display/rich-text.js +34 -0
  90. package/dist/display/select.d.ts +6 -0
  91. package/dist/display/select.js +38 -0
  92. package/dist/display/text-class.d.ts +23 -0
  93. package/dist/display/text-class.js +5 -0
  94. package/dist/display/text.d.ts +19 -0
  95. package/dist/display/text.js +8 -0
  96. package/dist/display/use-display-options.d.ts +2 -0
  97. package/dist/display/use-display-options.js +14 -0
  98. package/dist/display/user.d.ts +11 -0
  99. package/dist/display/user.js +10 -0
  100. package/dist/display/value-list.d.ts +10 -0
  101. package/dist/display/value-list.js +12 -0
  102. package/dist/display/viewer.d.ts +4 -0
  103. package/dist/display/viewer.js +11 -0
  104. package/dist/display/web-href.d.ts +8 -0
  105. package/dist/display/web-href.js +12 -0
  106. package/dist/editors/ChipsEditor.d.ts +59 -0
  107. package/dist/editors/ChipsEditor.js +73 -0
  108. package/dist/editors/DateEditor.d.ts +25 -0
  109. package/dist/editors/DateEditor.js +122 -0
  110. package/dist/editors/LocationEditor.d.ts +22 -0
  111. package/dist/editors/LocationEditor.js +228 -0
  112. package/dist/editors/NameEditor.d.ts +22 -0
  113. package/dist/editors/NameEditor.js +92 -0
  114. package/dist/editors/NumberEditor.d.ts +67 -0
  115. package/dist/editors/NumberEditor.js +86 -0
  116. package/dist/editors/RangeEditor.d.ts +22 -0
  117. package/dist/editors/RangeEditor.js +70 -0
  118. package/dist/editors/RelationEditor.d.ts +65 -0
  119. package/dist/editors/RelationEditor.js +64 -0
  120. package/dist/editors/SelectEditor.d.ts +72 -0
  121. package/dist/editors/SelectEditor.js +59 -0
  122. package/dist/editors/ValueListEditor.d.ts +38 -0
  123. package/dist/editors/ValueListEditor.js +217 -0
  124. package/dist/editors/edit-cores.d.ts +83 -0
  125. package/dist/editors/edit-cores.js +38 -0
  126. package/dist/editors/edit-session.d.ts +74 -0
  127. package/dist/editors/edit-session.js +35 -0
  128. package/dist/editors/open-values.d.ts +28 -0
  129. package/dist/editors/open-values.js +26 -0
  130. package/dist/editors/relation-source.d.ts +66 -0
  131. package/dist/editors/relation-source.js +102 -0
  132. package/dist/fields/binding.d.ts +87 -0
  133. package/dist/fields/binding.js +117 -0
  134. package/dist/fields/currency.d.ts +82 -0
  135. package/dist/fields/currency.js +41 -0
  136. package/dist/fields/denomination.d.ts +42 -0
  137. package/dist/fields/denomination.js +11 -0
  138. package/dist/fields/edit-core-types.d.ts +40 -0
  139. package/dist/fields/edit-core-types.js +29 -0
  140. package/dist/fields/format-knobs.d.ts +34 -0
  141. package/dist/fields/format-knobs.js +36 -0
  142. package/dist/fields/menus.d.ts +28 -0
  143. package/dist/fields/menus.js +1 -0
  144. package/dist/fields/money.d.ts +60 -0
  145. package/dist/fields/money.js +78 -0
  146. package/dist/fields/number-edit.d.ts +11 -0
  147. package/dist/fields/number-edit.js +17 -0
  148. package/dist/fields/prepare-write.d.ts +55 -0
  149. package/dist/fields/prepare-write.js +67 -0
  150. package/dist/fields/relation-source-types.d.ts +54 -0
  151. package/dist/fields/relation-source-types.js +1 -0
  152. package/dist/figures.d.ts +52 -0
  153. package/dist/figures.js +63 -0
  154. package/dist/filters/date-filter.d.ts +2 -0
  155. package/dist/filters/date-filter.js +1 -0
  156. package/dist/filters/filter-model.d.ts +176 -0
  157. package/dist/filters/filter-model.js +41 -0
  158. package/dist/filters/number-filter.d.ts +2 -0
  159. package/dist/filters/number-filter.js +1 -0
  160. package/dist/filters/range-filter.d.ts +2 -0
  161. package/dist/filters/range-filter.js +1 -0
  162. package/dist/filters/registry.d.ts +103 -0
  163. package/dist/filters/registry.js +8 -0
  164. package/dist/filters/relation-filter.d.ts +16 -0
  165. package/dist/filters/relation-filter.js +53 -0
  166. package/dist/filters/text-filter.d.ts +2 -0
  167. package/dist/filters/text-filter.js +1 -0
  168. package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
  169. package/dist/grid/chrome/GridAddColumn.js +29 -0
  170. package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
  171. package/dist/grid/chrome/GridAggregateMenu.js +27 -0
  172. package/dist/grid/chrome/GridCellEditors.d.ts +64 -0
  173. package/dist/grid/chrome/GridCellEditors.js +55 -0
  174. package/dist/grid/chrome/GridCellOutline.d.ts +70 -0
  175. package/dist/grid/chrome/GridCellOutline.js +21 -0
  176. package/dist/grid/chrome/GridChipsEditor.d.ts +28 -0
  177. package/dist/grid/chrome/GridChipsEditor.js +40 -0
  178. package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
  179. package/dist/grid/chrome/GridColumnColorSection.js +40 -0
  180. package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
  181. package/dist/grid/chrome/GridColumnDateSection.js +23 -0
  182. package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
  183. package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
  184. package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
  185. package/dist/grid/chrome/GridColumnMenu.js +99 -0
  186. package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
  187. package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
  188. package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
  189. package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
  190. package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
  191. package/dist/grid/chrome/GridColumnSortSection.js +16 -0
  192. package/dist/grid/chrome/GridDateEditor.d.ts +22 -0
  193. package/dist/grid/chrome/GridDateEditor.js +31 -0
  194. package/dist/grid/chrome/GridFlyout.d.ts +44 -0
  195. package/dist/grid/chrome/GridFlyout.js +80 -0
  196. package/dist/grid/chrome/GridFooter.d.ts +23 -0
  197. package/dist/grid/chrome/GridFooter.js +81 -0
  198. package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
  199. package/dist/grid/chrome/GridGroupMenu.js +57 -0
  200. package/dist/grid/chrome/GridHeader.d.ts +61 -0
  201. package/dist/grid/chrome/GridHeader.js +37 -0
  202. package/dist/grid/chrome/GridLongTextEditor.d.ts +36 -0
  203. package/dist/grid/chrome/GridLongTextEditor.js +127 -0
  204. package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
  205. package/dist/grid/chrome/GridMenuRow.js +15 -0
  206. package/dist/grid/chrome/GridNameEditor.d.ts +19 -0
  207. package/dist/grid/chrome/GridNameEditor.js +36 -0
  208. package/dist/grid/chrome/GridNumberEditor.d.ts +35 -0
  209. package/dist/grid/chrome/GridNumberEditor.js +25 -0
  210. package/dist/grid/chrome/GridRangeEditor.d.ts +20 -0
  211. package/dist/grid/chrome/GridRangeEditor.js +25 -0
  212. package/dist/grid/chrome/GridRelationEditor.d.ts +21 -0
  213. package/dist/grid/chrome/GridRelationEditor.js +30 -0
  214. package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
  215. package/dist/grid/chrome/GridResizeHandle.js +19 -0
  216. package/dist/grid/chrome/GridRow.d.ts +25 -0
  217. package/dist/grid/chrome/GridRow.js +136 -0
  218. package/dist/grid/chrome/GridRowActions.d.ts +32 -0
  219. package/dist/grid/chrome/GridRowActions.js +25 -0
  220. package/dist/grid/chrome/GridRowCells.d.ts +4 -0
  221. package/dist/grid/chrome/GridRowCells.js +133 -0
  222. package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
  223. package/dist/grid/chrome/GridRowGlyph.js +13 -0
  224. package/dist/grid/chrome/GridSelectEditor.d.ts +18 -0
  225. package/dist/grid/chrome/GridSelectEditor.js +49 -0
  226. package/dist/grid/chrome/GridStructure.d.ts +48 -0
  227. package/dist/grid/chrome/GridStructure.js +45 -0
  228. package/dist/grid/chrome/GridTable.d.ts +4 -0
  229. package/dist/grid/chrome/GridTable.js +125 -0
  230. package/dist/grid/chrome/GridTableSurface.d.ts +15 -0
  231. package/dist/grid/chrome/GridTableSurface.js +6 -0
  232. package/dist/grid/chrome/GridTextEditor.d.ts +11 -0
  233. package/dist/grid/chrome/GridTextEditor.js +40 -0
  234. package/dist/grid/chrome/GridValueListEditor.d.ts +18 -0
  235. package/dist/grid/chrome/GridValueListEditor.js +36 -0
  236. package/dist/grid/chrome/StuckMarker.d.ts +16 -0
  237. package/dist/grid/chrome/StuckMarker.js +34 -0
  238. package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
  239. package/dist/grid/chrome/cell-clipboard.js +28 -0
  240. package/dist/grid/chrome/cells.d.ts +21 -0
  241. package/dist/grid/chrome/cells.js +20 -0
  242. package/dist/grid/chrome/checks.d.ts +35 -0
  243. package/dist/grid/chrome/checks.js +22 -0
  244. package/dist/grid/chrome/column-glyph.d.ts +14 -0
  245. package/dist/grid/chrome/column-glyph.js +44 -0
  246. package/dist/grid/chrome/editors.d.ts +9 -0
  247. package/dist/grid/chrome/editors.js +10 -0
  248. package/dist/grid/chrome/grid-cell-classes.d.ts +59 -0
  249. package/dist/grid/chrome/grid-cell-classes.js +30 -0
  250. package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
  251. package/dist/grid/chrome/grid-menu-search.js +7 -0
  252. package/dist/grid/chrome/grid-row-props.d.ts +131 -0
  253. package/dist/grid/chrome/grid-row-props.js +1 -0
  254. package/dist/grid/chrome/grid-styles.d.ts +37 -0
  255. package/dist/grid/chrome/grid-styles.js +8 -0
  256. package/dist/grid/chrome/grid-table-props.d.ts +173 -0
  257. package/dist/grid/chrome/grid-table-props.js +1 -0
  258. package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
  259. package/dist/grid/chrome/useGridBatchApi.js +35 -0
  260. package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
  261. package/dist/grid/chrome/useGridColumnLayout.js +206 -0
  262. package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
  263. package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
  264. package/dist/grid/chrome/useGridKeyboard.d.ts +47 -0
  265. package/dist/grid/chrome/useGridKeyboard.js +274 -0
  266. package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
  267. package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
  268. package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
  269. package/dist/grid/chrome/useGridRailReveal.js +67 -0
  270. package/dist/grid/chrome/useGridRangeActions.d.ts +49 -0
  271. package/dist/grid/chrome/useGridRangeActions.js +188 -0
  272. package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
  273. package/dist/grid/chrome/useGridRangeGestures.js +190 -0
  274. package/dist/grid/chrome/useGridRowContextMenu.d.ts +35 -0
  275. package/dist/grid/chrome/useGridRowContextMenu.js +127 -0
  276. package/dist/grid/chrome/useGridScaleStyles.d.ts +1 -0
  277. package/dist/grid/chrome/useGridScaleStyles.js +29 -0
  278. package/dist/grid/chrome/useGridScrollSync.d.ts +38 -0
  279. package/dist/grid/chrome/useGridScrollSync.js +176 -0
  280. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +55 -0
  281. package/dist/grid/chrome/useGridTableInteractionModel.js +197 -0
  282. package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
  283. package/dist/grid/chrome/useGridTableSelection.js +55 -0
  284. package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
  285. package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
  286. package/dist/grid/core/clipboard-model.d.ts +81 -0
  287. package/dist/grid/core/clipboard-model.js +291 -0
  288. package/dist/grid/core/column-values.d.ts +27 -0
  289. package/dist/grid/core/column-values.js +76 -0
  290. package/dist/grid/core/commit-model.d.ts +34 -0
  291. package/dist/grid/core/commit-model.js +3 -0
  292. package/dist/grid/core/coordinates.d.ts +48 -0
  293. package/dist/grid/core/coordinates.js +27 -0
  294. package/dist/grid/core/edit-values.d.ts +9 -0
  295. package/dist/grid/core/edit-values.js +1 -0
  296. package/dist/grid/core/editing-controller.d.ts +59 -0
  297. package/dist/grid/core/editing-controller.js +240 -0
  298. package/dist/grid/core/editing-model.d.ts +78 -0
  299. package/dist/grid/core/editing-model.js +136 -0
  300. package/dist/grid/core/grid-scale.d.ts +14 -0
  301. package/dist/grid/core/grid-scale.js +8 -0
  302. package/dist/grid/core/nav.d.ts +94 -0
  303. package/dist/grid/core/nav.js +92 -0
  304. package/dist/grid/core/pending-reconciliation.d.ts +50 -0
  305. package/dist/grid/core/pending-reconciliation.js +49 -0
  306. package/dist/grid/core/range-model.d.ts +25 -0
  307. package/dist/grid/core/range-model.js +59 -0
  308. package/dist/grid/core/spreadsheet-operations.d.ts +85 -0
  309. package/dist/grid/core/spreadsheet-operations.js +253 -0
  310. package/dist/grid/core/useGridEditing.d.ts +43 -0
  311. package/dist/grid/core/useGridEditing.js +90 -0
  312. package/dist/grid/core/useGridRange.d.ts +20 -0
  313. package/dist/grid/core/useGridRange.js +24 -0
  314. package/dist/grid/core/value-equality.d.ts +32 -0
  315. package/dist/grid/core/value-equality.js +34 -0
  316. package/dist/grid/index.d.ts +18 -0
  317. package/dist/grid/index.js +5 -0
  318. package/dist/grid/useGridTablePrefs.d.ts +50 -0
  319. package/dist/grid/useGridTablePrefs.js +101 -0
  320. package/dist/grouping/sort-groups.d.ts +18 -0
  321. package/dist/grouping/sort-groups.js +33 -0
  322. package/dist/grouping/types.d.ts +10 -0
  323. package/dist/grouping/types.js +1 -0
  324. package/dist/index.d.ts +28 -0
  325. package/dist/index.js +28 -0
  326. package/dist/internal/chip.d.ts +4 -0
  327. package/dist/internal/chip.js +3 -0
  328. package/dist/internal/cx.d.ts +3 -0
  329. package/dist/internal/cx.js +3 -0
  330. package/dist/internal/viewport.d.ts +5 -0
  331. package/dist/internal/viewport.js +29 -0
  332. package/dist/model/aggregates.d.ts +59 -0
  333. package/dist/model/aggregates.js +186 -0
  334. package/dist/model/card-density.d.ts +8 -0
  335. package/dist/model/card-density.js +10 -0
  336. package/dist/model/card-layout.d.ts +85 -0
  337. package/dist/model/card-layout.js +90 -0
  338. package/dist/model/column-capabilities.d.ts +162 -0
  339. package/dist/model/column-capabilities.js +233 -0
  340. package/dist/model/column-filters.d.ts +106 -0
  341. package/dist/model/column-filters.js +321 -0
  342. package/dist/model/column-format.d.ts +103 -0
  343. package/dist/model/column-format.js +1 -0
  344. package/dist/model/column-from.d.ts +28 -0
  345. package/dist/model/column-from.js +160 -0
  346. package/dist/model/column-inspect.d.ts +18 -0
  347. package/dist/model/column-inspect.js +6 -0
  348. package/dist/model/column-knobs.d.ts +20 -0
  349. package/dist/model/column-knobs.js +16 -0
  350. package/dist/model/column-money.d.ts +13 -0
  351. package/dist/model/column-money.js +27 -0
  352. package/dist/model/column-order.d.ts +36 -0
  353. package/dist/model/column-order.js +68 -0
  354. package/dist/model/column-schema.d.ts +335 -0
  355. package/dist/model/column-schema.js +1 -0
  356. package/dist/model/column-sort.d.ts +17 -0
  357. package/dist/model/column-sort.js +11 -0
  358. package/dist/model/column-state.d.ts +77 -0
  359. package/dist/model/column-state.js +95 -0
  360. package/dist/model/column-types.d.ts +109 -0
  361. package/dist/model/column-types.js +50 -0
  362. package/dist/model/column-warnings.d.ts +44 -0
  363. package/dist/model/column-warnings.js +24 -0
  364. package/dist/model/density.d.ts +3 -0
  365. package/dist/model/density.js +13 -0
  366. package/dist/model/field-type-of.d.ts +21 -0
  367. package/dist/model/field-type-of.js +11 -0
  368. package/dist/model/filter-capabilities.d.ts +1 -0
  369. package/dist/model/filter-capabilities.js +1 -0
  370. package/dist/model/index.d.ts +38 -0
  371. package/dist/model/index.js +20 -0
  372. package/dist/model/part-rows.d.ts +28 -0
  373. package/dist/model/part-rows.js +40 -0
  374. package/dist/model/preferences.d.ts +155 -0
  375. package/dist/model/preferences.js +84 -0
  376. package/dist/model/prefs-buckets.d.ts +173 -0
  377. package/dist/model/prefs-buckets.js +71 -0
  378. package/dist/model/relation-filters.d.ts +45 -0
  379. package/dist/model/relation-filters.js +78 -0
  380. package/dist/model/render-count.d.ts +2 -0
  381. package/dist/model/render-count.js +24 -0
  382. package/dist/model/row-icon.d.ts +23 -0
  383. package/dist/model/row-icon.js +5 -0
  384. package/dist/model/view-rules.d.ts +73 -0
  385. package/dist/model/view-rules.js +216 -0
  386. package/dist/provider/ViewsProvider.d.ts +26 -0
  387. package/dist/provider/ViewsProvider.js +16 -0
  388. package/dist/provider/components.d.ts +230 -0
  389. package/dist/provider/components.js +3 -0
  390. package/dist/provider/context.d.ts +20 -0
  391. package/dist/provider/context.js +10 -0
  392. package/dist/provider/icons.d.ts +6 -0
  393. package/dist/provider/icons.js +1 -0
  394. package/dist/provider/menu-groups.d.ts +8 -0
  395. package/dist/provider/menu-groups.js +38 -0
  396. package/dist/provider/ports.d.ts +57 -0
  397. package/dist/provider/ports.js +9 -0
  398. package/dist/react.d.ts +9 -0
  399. package/dist/react.js +4 -0
  400. package/dist/selection/SelectCheckbox.d.ts +17 -0
  401. package/dist/selection/SelectCheckbox.js +11 -0
  402. package/dist/selection/index.d.ts +7 -0
  403. package/dist/selection/index.js +6 -0
  404. package/dist/selection/model.d.ts +55 -0
  405. package/dist/selection/model.js +86 -0
  406. package/dist/selection/row-click.d.ts +35 -0
  407. package/dist/selection/row-click.js +20 -0
  408. package/dist/selection/types.d.ts +17 -0
  409. package/dist/selection/types.js +1 -0
  410. package/dist/selection/useCheckDragSelect.d.ts +61 -0
  411. package/dist/selection/useCheckDragSelect.js +165 -0
  412. package/dist/selection/useListSelection.d.ts +39 -0
  413. package/dist/selection/useListSelection.js +48 -0
  414. package/dist/selection/useListSelectionShortcuts.d.ts +6 -0
  415. package/dist/selection/useListSelectionShortcuts.js +14 -0
  416. package/dist/selection/useRestIntent.d.ts +18 -0
  417. package/dist/selection/useRestIntent.js +35 -0
  418. package/docs/contract.md +525 -0
  419. package/docs/getting-started.md +250 -0
  420. package/docs/guides/atoms.md +245 -0
  421. package/docs/guides/cells.md +302 -0
  422. package/docs/guides/columns.md +412 -0
  423. package/docs/guides/display.md +203 -0
  424. package/docs/guides/editors.md +404 -0
  425. package/docs/guides/ports.md +246 -0
  426. package/docs/guides/selection.md +270 -0
  427. package/docs/guides/the-grid.md +677 -0
  428. package/docs/guides/the-provider.md +446 -0
  429. package/docs/index.md +50 -0
  430. package/docs/install.md +67 -0
  431. package/docs/reference/cells.md +28 -0
  432. package/docs/reference/display.md +42 -0
  433. package/docs/reference/editors-chips.md +6 -0
  434. package/docs/reference/editors-date.md +6 -0
  435. package/docs/reference/editors-location.md +10 -0
  436. package/docs/reference/editors-name.md +6 -0
  437. package/docs/reference/editors-number.md +11 -0
  438. package/docs/reference/editors-open-values.md +9 -0
  439. package/docs/reference/editors-range.md +6 -0
  440. package/docs/reference/editors-relation.md +9 -0
  441. package/docs/reference/editors-select.md +8 -0
  442. package/docs/reference/editors-session.md +9 -0
  443. package/docs/reference/editors-value-list.md +6 -0
  444. package/docs/reference/editors.md +5 -0
  445. package/docs/reference/grid.md +39 -0
  446. package/docs/reference/react.md +86 -0
  447. package/docs/reference/selection.md +33 -0
  448. package/docs/reference/views.md +601 -0
  449. package/docs/reshaping.md +19 -0
  450. package/package.json +118 -3
  451. package/skills/views/SKILL.md +102 -0
@@ -0,0 +1,188 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useMemo, useRef } from "react";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { gridRectContains, gridRectIsMulti } from "../core/coordinates.js";
5
+ import { computeRowRangeSpans } from "../core/range-model.js";
6
+ import { resolveActiveRangeRect } from "../core/range-model.js";
7
+ import { deriveGridSelectValues } from "../core/column-values.js";
8
+ import { buildGridCopyMatrix, extendGridFillPreview, gridRectHasClearable, planGridClear, planGridFill, planGridPaste, } from "../core/spreadsheet-operations.js";
9
+ import { copyCells, getGridClipboard, parseTsvText } from "./cell-clipboard.js";
10
+ export function useGridRangeActions({ ranges, focusedCell, editingCell, editingEnabled, fillTargetRow, visibleRowIds, visibleColumns, spreadsheetModel, commitBatch, focusCell, rangeSetRect, rangeExtendTo, }) {
11
+ const { ports, messages } = useViews();
12
+ const visibleColIds = useMemo(() => visibleColumns.map((col) => col.id), [visibleColumns]);
13
+ const spanRanges = useMemo(() => extendGridFillPreview(ranges, fillTargetRow, visibleRowIds, visibleColIds), [fillTargetRow, ranges, visibleColIds, visibleRowIds]);
14
+ const rowSpansMap = useMemo(() => computeRowRangeSpans(spanRanges, visibleRowIds, visibleColIds), [spanRanges, visibleColIds, visibleRowIds]);
15
+ const selectValuesByColumn = useMemo(() => deriveGridSelectValues(visibleColumns, spreadsheetModel.rows), [spreadsheetModel.rows, visibleColumns]);
16
+ const sayRefusals = useCallback((verb, plan) => {
17
+ if (plan.targetCount === 1 && plan.refusals.length === 1) {
18
+ ports.toast.error(plan.refusals[0].reason);
19
+ return;
20
+ }
21
+ for (const { reason, count } of plan.refusals) {
22
+ ports.toast.error(messages({ key: verb === "paste" ? "views.grid.paste-skipped" : "views.grid.fill-skipped", values: { count, reason } }));
23
+ }
24
+ }, [messages, ports]);
25
+ const finishFill = useCallback((targetRowId) => {
26
+ if (!editingEnabled)
27
+ return;
28
+ const plan = planGridFill(spreadsheetModel, ranges, focusedCell, targetRowId);
29
+ if (plan.edits.length > 0)
30
+ commitBatch(plan.edits);
31
+ if (plan.selectionHead)
32
+ rangeExtendTo(plan.selectionHead);
33
+ sayRefusals("fill", plan);
34
+ }, [commitBatch, editingEnabled, focusedCell, rangeExtendTo, ranges, sayRefusals, spreadsheetModel]);
35
+ const rangeVerbs = useMemo(() => {
36
+ const rectOfActiveRange = () => resolveActiveRangeRect(ranges, focusedCell, visibleRowIds, visibleColIds);
37
+ const activeRangeIsMulti = () => {
38
+ const rect = rectOfActiveRange();
39
+ return !!rect && gridRectIsMulti(rect);
40
+ };
41
+ const cellInActiveRange = (rowId, columnId) => {
42
+ if (!activeRangeIsMulti())
43
+ return false;
44
+ const rect = rectOfActiveRange();
45
+ return gridRectContains(rect, visibleRowIds.indexOf(rowId), visibleColIds.indexOf(columnId));
46
+ };
47
+ const copyRange = () => {
48
+ const rect = rectOfActiveRange();
49
+ if (!rect)
50
+ return;
51
+ const matrix = buildGridCopyMatrix(spreadsheetModel, rect);
52
+ if (matrix.length > 0)
53
+ void copyCells(ports.clipboard.writeText, matrix);
54
+ };
55
+ const activeRangeHasClearable = () => {
56
+ if (!editingEnabled)
57
+ return false;
58
+ const rect = rectOfActiveRange();
59
+ return !!rect && gridRectHasClearable(visibleColumns, rect);
60
+ };
61
+ const clearRange = () => {
62
+ if (!editingEnabled)
63
+ return;
64
+ const rect = rectOfActiveRange();
65
+ if (!rect)
66
+ return;
67
+ if (!activeRangeHasClearable()) {
68
+ ports.toast.error(messages({ key: "views.grid.clear-none" }));
69
+ return;
70
+ }
71
+ const edits = planGridClear(spreadsheetModel, rect);
72
+ if (edits.length > 0)
73
+ commitBatch(edits);
74
+ };
75
+ const cutRange = () => {
76
+ copyRange();
77
+ if (activeRangeHasClearable())
78
+ clearRange();
79
+ };
80
+ const pasteMatrix = (matrix, anchor) => {
81
+ if (!editingEnabled)
82
+ return;
83
+ const plan = planGridPaste(spreadsheetModel, matrix, anchor, rectOfActiveRange(), selectValuesByColumn);
84
+ if (plan.edits.length > 0) {
85
+ commitBatch(plan.edits);
86
+ if (plan.selection) {
87
+ focusCell(plan.selection.anchor.rowId, plan.selection.anchor.columnId);
88
+ rangeSetRect(plan.selection.anchor, plan.selection.head);
89
+ }
90
+ }
91
+ sayRefusals("paste", plan);
92
+ };
93
+ const pasteAtCell = (rowId, columnId) => {
94
+ const clipboard = getGridClipboard();
95
+ if (!clipboard)
96
+ return;
97
+ const rowIdx = visibleRowIds.indexOf(rowId);
98
+ const colIdx = visibleColIds.indexOf(columnId);
99
+ if (rowIdx < 0 || colIdx < 0)
100
+ return;
101
+ pasteMatrix(clipboard.matrix ?? [[clipboard]], { rowIdx, colIdx });
102
+ };
103
+ const pasteAtRangeOrigin = () => {
104
+ const rect = rectOfActiveRange();
105
+ if (rect)
106
+ pasteAtCell(visibleRowIds[rect.r1], visibleColIds[rect.c1]);
107
+ };
108
+ return {
109
+ copyRange,
110
+ cutRange,
111
+ clearRange,
112
+ pasteMatrix,
113
+ pasteAtCell,
114
+ pasteAtRangeOrigin,
115
+ activeRangeIsMulti,
116
+ activeRangeHasClearable,
117
+ cellInActiveRange,
118
+ };
119
+ }, [
120
+ commitBatch,
121
+ editingEnabled,
122
+ focusCell,
123
+ focusedCell,
124
+ messages,
125
+ ports,
126
+ rangeSetRect,
127
+ ranges,
128
+ sayRefusals,
129
+ selectValuesByColumn,
130
+ spreadsheetModel,
131
+ visibleColIds,
132
+ visibleColumns,
133
+ visibleRowIds,
134
+ ]);
135
+ const rangeVerbsRef = useRef(null);
136
+ useEffect(() => {
137
+ rangeVerbsRef.current = rangeVerbs;
138
+ }, [rangeVerbs]);
139
+ const onRangeCopy = useCallback(() => rangeVerbsRef.current?.copyRange(), []);
140
+ const onRangeCut = useCallback(() => rangeVerbsRef.current?.cutRange(), []);
141
+ const onRangeClear = useCallback(() => rangeVerbsRef.current?.clearRange(), []);
142
+ const onRangePaste = useCallback(() => rangeVerbsRef.current?.pasteAtRangeOrigin(), []);
143
+ const onPasteAtCell = useCallback((rowId, columnId) => rangeVerbsRef.current?.pasteAtCell(rowId, columnId), []);
144
+ const inActiveRange = useCallback((rowId, columnId) => rangeVerbsRef.current?.cellInActiveRange(rowId, columnId) ?? false, []);
145
+ const rangeCanClear = useCallback(() => rangeVerbsRef.current?.activeRangeHasClearable() ?? false, []);
146
+ useEffect(() => {
147
+ if (!focusedCell || editingCell || !editingEnabled)
148
+ return;
149
+ const onPaste = (event) => {
150
+ const target = event.target;
151
+ if (target?.closest?.('input, textarea, select, [contenteditable="true"], [role="menu"]')) {
152
+ return;
153
+ }
154
+ const text = event.clipboardData?.getData("text/plain") ?? "";
155
+ const clipboard = getGridClipboard();
156
+ const internal = clipboard && (clipboard.text === text || text === "") ? clipboard : null;
157
+ if (!internal && text === "")
158
+ return;
159
+ event.preventDefault();
160
+ const matrix = internal
161
+ ? (internal.matrix ?? [[internal]])
162
+ : parseTsvText(text);
163
+ if (matrix.length === 0)
164
+ return;
165
+ const rowIdx = visibleRowIds.indexOf(focusedCell.rowId);
166
+ const colIdx = visibleColIds.indexOf(focusedCell.columnId);
167
+ if (rowIdx < 0 || colIdx < 0)
168
+ return;
169
+ rangeVerbsRef.current?.pasteMatrix(matrix, { rowIdx, colIdx });
170
+ };
171
+ window.addEventListener("paste", onPaste);
172
+ return () => window.removeEventListener("paste", onPaste);
173
+ }, [editingCell, editingEnabled, focusedCell, visibleColIds, visibleRowIds]);
174
+ return {
175
+ visibleColIds,
176
+ rowSpansMap,
177
+ selectValuesByColumn,
178
+ finishFill,
179
+ onRangeCopy,
180
+ onRangeCut,
181
+ onRangeClear,
182
+ onRangePaste,
183
+ onPasteAtCell,
184
+ inActiveRange,
185
+ rangeCanClear,
186
+ rangeVerbsRef,
187
+ };
188
+ }
@@ -0,0 +1,32 @@
1
+ import { type RefObject } from "react";
2
+ import type { GridCellPos } from "../core/coordinates.js";
3
+ /**
4
+ * Whether a pointer event on a scrolling element landed on one of its
5
+ * scrollbars rather than its content. A scrollbar is drawn inside the border
6
+ * box but outside the client box, so a pointer past `clientWidth` /
7
+ * `clientHeight` (measured from the padding edge) is on the bar.
8
+ */
9
+ export declare function onScrollbar(el: HTMLElement, event: {
10
+ clientX: number;
11
+ clientY: number;
12
+ }): boolean;
13
+ export declare function useGridRangeGestures({ rootRef, focusedCell, editingCell, editingEnabled, selecting, focusCell, clearFocus, rangeBeginDrag, rangeExtendTo, rangeAddCell, finishFillRef, }: {
14
+ rootRef: RefObject<HTMLDivElement | null>;
15
+ focusedCell: GridCellPos | null;
16
+ editingCell: GridCellPos | null;
17
+ editingEnabled: boolean;
18
+ selecting: boolean;
19
+ focusCell: (rowId: string, columnId: string) => void;
20
+ clearFocus: () => void;
21
+ rangeBeginDrag: (pos: GridCellPos, additive: boolean) => void;
22
+ rangeExtendTo: (pos: GridCellPos, fallbackAnchor?: GridCellPos) => void;
23
+ rangeAddCell: (pos: GridCellPos) => void;
24
+ finishFillRef: RefObject<(targetRowId: string) => void>;
25
+ }): {
26
+ fillTargetRow: string | null;
27
+ onExtendCell: (rowId: string, columnId: string) => void;
28
+ onAddCell: (rowId: string, columnId: string) => void;
29
+ handleRootPointerDown: (event: React.PointerEvent) => void;
30
+ handleRootPointerDownCapture: (event: React.PointerEvent) => void;
31
+ handleRootClickCapture: (event: React.MouseEvent) => void;
32
+ };
@@ -0,0 +1,190 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useRef, useState } from "react";
3
+ import { ROW_INTERACTIVE_SELECTOR } from "../../selection/row-click.js";
4
+ const MOUSE_DRAG_SELECT = false;
5
+ function setBodySelectionDisabled(disabled) {
6
+ document.body.style.userSelect = disabled ? "none" : "";
7
+ }
8
+ export function onScrollbar(el, event) {
9
+ if (!el.clientWidth || !el.clientHeight)
10
+ return false;
11
+ const rect = el.getBoundingClientRect();
12
+ const x = event.clientX - rect.left - el.clientLeft;
13
+ const y = event.clientY - rect.top - el.clientTop;
14
+ return x >= el.clientWidth || y >= el.clientHeight;
15
+ }
16
+ export function useGridRangeGestures({ rootRef, focusedCell, editingCell, editingEnabled, selecting, focusCell, clearFocus, rangeBeginDrag, rangeExtendTo, rangeAddCell, finishFillRef, }) {
17
+ const focusedRef = useRef(focusedCell);
18
+ useEffect(() => {
19
+ focusedRef.current = focusedCell;
20
+ }, [focusedCell]);
21
+ const onExtendCell = useCallback((rowId, columnId) => {
22
+ const pos = { rowId, columnId };
23
+ rangeExtendTo(pos, focusedRef.current ?? pos);
24
+ if (!focusedRef.current)
25
+ focusCell(rowId, columnId);
26
+ }, [focusCell, rangeExtendTo]);
27
+ const onAddCell = useCallback((rowId, columnId) => {
28
+ rangeAddCell({ rowId, columnId });
29
+ focusCell(rowId, columnId);
30
+ }, [focusCell, rangeAddCell]);
31
+ const cellDragRef = useRef(null);
32
+ const didCellDragRef = useRef(false);
33
+ const fillDragRef = useRef(false);
34
+ const [fillTargetRow, setFillTargetRow] = useState(null);
35
+ const fillTargetRef = useRef(null);
36
+ const handleRootPointerDown = (event) => {
37
+ if (event.button !== 0 || event.pointerType !== "mouse")
38
+ return;
39
+ if (selecting || editingCell)
40
+ return;
41
+ const target = event.target;
42
+ if (editingEnabled && target.closest("[data-fill-dot]")) {
43
+ event.preventDefault();
44
+ fillDragRef.current = true;
45
+ setBodySelectionDisabled(true);
46
+ return;
47
+ }
48
+ if (!MOUSE_DRAG_SELECT)
49
+ return;
50
+ if (target.closest(ROW_INTERACTIVE_SELECTOR) || target.closest("[data-action-menu]"))
51
+ return;
52
+ const cell = target.closest("[data-col-id]");
53
+ const row = target.closest("[data-row-id]");
54
+ if (!cell || !row)
55
+ return;
56
+ cellDragRef.current = {
57
+ startX: event.clientX,
58
+ startY: event.clientY,
59
+ rowId: row.getAttribute("data-row-id"),
60
+ columnId: cell.getAttribute("data-col-id"),
61
+ additive: event.metaKey || event.ctrlKey,
62
+ extend: event.shiftKey,
63
+ active: false,
64
+ };
65
+ };
66
+ const handleRootClickCapture = (event) => {
67
+ if (!didCellDragRef.current)
68
+ return;
69
+ didCellDragRef.current = false;
70
+ event.preventDefault();
71
+ event.stopPropagation();
72
+ };
73
+ useEffect(() => {
74
+ const onMove = (event) => {
75
+ if (fillDragRef.current) {
76
+ const element = document.elementFromPoint(event.clientX, event.clientY);
77
+ const row = element?.closest?.("[data-row-id]");
78
+ if (row && rootRef.current?.contains(row)) {
79
+ const rowId = row.getAttribute("data-row-id");
80
+ if (rowId !== fillTargetRef.current) {
81
+ fillTargetRef.current = rowId;
82
+ setFillTargetRow(rowId);
83
+ }
84
+ }
85
+ return;
86
+ }
87
+ const drag = cellDragRef.current;
88
+ if (!drag)
89
+ return;
90
+ if (!drag.active) {
91
+ if (Math.abs(event.clientX - drag.startX) < 4 &&
92
+ Math.abs(event.clientY - drag.startY) < 4) {
93
+ return;
94
+ }
95
+ drag.active = true;
96
+ setBodySelectionDisabled(true);
97
+ const start = { rowId: drag.rowId, columnId: drag.columnId };
98
+ if (drag.extend) {
99
+ rangeExtendTo(start, focusedRef.current ?? start);
100
+ if (!focusedRef.current)
101
+ focusCell(start.rowId, start.columnId);
102
+ }
103
+ else {
104
+ rangeBeginDrag(start, drag.additive);
105
+ focusCell(start.rowId, start.columnId);
106
+ }
107
+ }
108
+ const element = document.elementFromPoint(event.clientX, event.clientY);
109
+ const cell = element?.closest?.("[data-col-id]");
110
+ const row = element?.closest?.("[data-row-id]");
111
+ if (cell && row && rootRef.current?.contains(row)) {
112
+ rangeExtendTo({
113
+ rowId: row.getAttribute("data-row-id"),
114
+ columnId: cell.getAttribute("data-col-id"),
115
+ });
116
+ }
117
+ };
118
+ const onUp = () => {
119
+ if (fillDragRef.current) {
120
+ fillDragRef.current = false;
121
+ setBodySelectionDisabled(false);
122
+ const target = fillTargetRef.current;
123
+ fillTargetRef.current = null;
124
+ setFillTargetRow(null);
125
+ if (target) {
126
+ didCellDragRef.current = true;
127
+ finishFillRef.current(target);
128
+ }
129
+ return;
130
+ }
131
+ const drag = cellDragRef.current;
132
+ cellDragRef.current = null;
133
+ if (drag?.active) {
134
+ didCellDragRef.current = true;
135
+ setBodySelectionDisabled(false);
136
+ }
137
+ };
138
+ window.addEventListener("pointermove", onMove);
139
+ window.addEventListener("pointerup", onUp);
140
+ return () => {
141
+ window.removeEventListener("pointermove", onMove);
142
+ window.removeEventListener("pointerup", onUp);
143
+ };
144
+ }, [finishFillRef, focusCell, rangeBeginDrag, rangeExtendTo, rootRef]);
145
+ const editingRef = useRef(editingCell);
146
+ useEffect(() => {
147
+ editingRef.current = editingCell;
148
+ }, [editingCell]);
149
+ const treePressRef = useRef(null);
150
+ const handleRootPointerDownCapture = (event) => {
151
+ treePressRef.current = event.nativeEvent;
152
+ };
153
+ useEffect(() => {
154
+ if (!focusedCell)
155
+ return;
156
+ const onPointerDown = (event) => {
157
+ const inTree = treePressRef.current === event;
158
+ treePressRef.current = null;
159
+ const target = event.target;
160
+ if (!target)
161
+ return;
162
+ if (inTree && !rootRef.current?.contains(target))
163
+ return;
164
+ if (rootRef.current?.contains(target)) {
165
+ if (target.closest?.("[data-col-id]"))
166
+ return;
167
+ if (target.dataset?.gridScroller != null && onScrollbar(target, event))
168
+ return;
169
+ }
170
+ if (editingRef.current) {
171
+ window.setTimeout(() => {
172
+ if (!editingRef.current)
173
+ clearFocus();
174
+ }, 0);
175
+ return;
176
+ }
177
+ clearFocus();
178
+ };
179
+ window.addEventListener("pointerdown", onPointerDown);
180
+ return () => window.removeEventListener("pointerdown", onPointerDown);
181
+ }, [clearFocus, focusedCell, rootRef]);
182
+ return {
183
+ fillTargetRow,
184
+ onExtendCell,
185
+ onAddCell,
186
+ handleRootPointerDown,
187
+ handleRootPointerDownCapture,
188
+ handleRootClickCapture,
189
+ };
190
+ }
@@ -0,0 +1,35 @@
1
+ import type { ViewsRowMenuItem } from "../../atoms/types.js";
2
+ import type { ListColumn } from "../../model/column-schema.js";
3
+ import type { GridRowRangeSpan } from "../core/useGridRange.js";
4
+ export declare function useGridRowContextMenu<Row>({ row, id, rowKey, columns, selecting, selectable, selected, toggle, editingEnabled, pendingByCol, selectValues, rowRange, contextMenu, inActiveRange, rangeCanClear, onRangeCopy, onRangeCut, onRangePaste, onRangeClear, onPasteAtCell, onCommitCell, onFocusCell, }: {
5
+ row: Row;
6
+ /** The DATA id — what a commit and the selection toggle address. */
7
+ id: string;
8
+ /** This RENDERED row's identity — what a position (range, focus, paste
9
+ * target) is in terms of. See `GridCellPos`. */
10
+ rowKey: string;
11
+ columns: ListColumn<Row>[];
12
+ selecting: boolean;
13
+ selectable: boolean;
14
+ selected: boolean;
15
+ toggle: (id: string, next?: boolean) => void;
16
+ editingEnabled: boolean;
17
+ pendingByCol?: Record<string, unknown>;
18
+ selectValues?: Record<string, string[]>;
19
+ rowRange?: GridRowRangeSpan[];
20
+ contextMenu?: (row: Row) => ViewsRowMenuItem[];
21
+ inActiveRange: (rowId: string, columnId: string) => boolean;
22
+ rangeCanClear: () => boolean;
23
+ onRangeCopy: () => void;
24
+ onRangeCut: () => void;
25
+ onRangePaste: () => void;
26
+ onRangeClear: () => void;
27
+ onPasteAtCell: (rowId: string, columnId: string) => void;
28
+ onCommitCell: (row: Row, rowId: string, columnId: string, previous: unknown, next: unknown, options?: {
29
+ overlay?: boolean;
30
+ }) => void;
31
+ onFocusCell: (rowId: string, columnId: string) => void;
32
+ }): {
33
+ contextItems: ViewsRowMenuItem[];
34
+ handleContextMenu: (event: React.MouseEvent<HTMLElement>) => void;
35
+ };
@@ -0,0 +1,127 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useState } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ import { gridColumnHasEditor } from "../../model/column-capabilities.js";
6
+ import { cellClearPrev, cellEditBaseline, cellPrevPayload, coercePaste, copyCell, getGridClipboard, rowHoldsCurrency, } from "./cell-clipboard.js";
7
+ export function useGridRowContextMenu({ row, id, rowKey, columns, selecting, selectable, selected, toggle, editingEnabled, pendingByCol, selectValues, rowRange, contextMenu, inActiveRange, rangeCanClear, onRangeCopy, onRangeCut, onRangePaste, onRangeClear, onPasteAtCell, onCommitCell, onFocusCell, }) {
8
+ const { conventions, ports, messages, icons } = useViews();
9
+ const copyLabel = messages({ key: "views.menus.copy" });
10
+ const cutLabel = messages({ key: "views.menus.cut" });
11
+ const pasteLabel = messages({ key: "views.menus.paste" });
12
+ const clearLabel = messages({ key: "views.menus.clear" });
13
+ const [menuColumnId, setMenuColumnId] = useState(null);
14
+ const menuColumn = menuColumnId
15
+ ? columns.find((column) => column.id === menuColumnId)
16
+ : undefined;
17
+ const editBaseline = (column) => cellEditBaseline(column, row, pendingByCol);
18
+ const canEdit = (column) => editingEnabled && gridColumnHasEditor(column);
19
+ const cellItems = [];
20
+ if (menuColumn && !selecting && inActiveRange(rowKey, menuColumn.id)) {
21
+ const clipboard = getGridClipboard();
22
+ cellItems.push({
23
+ label: copyLabel,
24
+ icon: _jsx(icons.copy, { className: "h-4 w-4" }),
25
+ shortcut: "⌘C",
26
+ onClick: onRangeCopy,
27
+ });
28
+ if (editingEnabled) {
29
+ const canClear = rangeCanClear();
30
+ cellItems.push({
31
+ label: cutLabel,
32
+ icon: _jsx(icons.cut, { className: "h-4 w-4" }),
33
+ shortcut: "⌘X",
34
+ disabled: !canClear,
35
+ onClick: onRangeCut,
36
+ }, {
37
+ label: pasteLabel,
38
+ icon: _jsx(icons.paste, { className: "h-4 w-4" }),
39
+ shortcut: "⌘V",
40
+ disabled: !clipboard,
41
+ onClick: onRangePaste,
42
+ }, {
43
+ label: clearLabel,
44
+ icon: _jsx(icons.clear, { className: "h-4 w-4" }),
45
+ disabled: !canClear,
46
+ onClick: onRangeClear,
47
+ });
48
+ }
49
+ cellItems.push({ separator: true });
50
+ }
51
+ else if (menuColumn && !selecting) {
52
+ const unit = menuColumn.editUnit?.value(row);
53
+ const canWrite = canEdit(menuColumn);
54
+ const canClear = canWrite && !!menuColumn.clearable;
55
+ const clipboard = getGridClipboard();
56
+ const paste = canWrite && clipboard && !clipboard.matrix
57
+ ? coercePaste(menuColumn, clipboard, {
58
+ conventions,
59
+ messages,
60
+ currentUnit: unit,
61
+ holdsCurrency: rowHoldsCurrency(menuColumn, row),
62
+ values: selectValues?.[menuColumn.id],
63
+ })
64
+ : null;
65
+ cellItems.push({
66
+ label: copyLabel,
67
+ icon: _jsx(icons.copy, { className: "h-4 w-4" }),
68
+ shortcut: "⌘C",
69
+ onClick: () => void copyCell(ports.clipboard.writeText, menuColumn, editBaseline(menuColumn), unit),
70
+ });
71
+ if (editingEnabled) {
72
+ cellItems.push({
73
+ label: cutLabel,
74
+ icon: _jsx(icons.cut, { className: "h-4 w-4" }),
75
+ shortcut: "⌘X",
76
+ disabled: !canClear,
77
+ onClick: () => {
78
+ void copyCell(ports.clipboard.writeText, menuColumn, editBaseline(menuColumn), unit);
79
+ onCommitCell(row, id, menuColumn.id, cellClearPrev(menuColumn, row, pendingByCol), "");
80
+ },
81
+ }, {
82
+ label: pasteLabel,
83
+ icon: _jsx(icons.paste, { className: "h-4 w-4" }),
84
+ shortcut: "⌘V",
85
+ disabled: clipboard?.matrix ? false : !paste?.ok,
86
+ onClick: () => {
87
+ if (clipboard?.matrix) {
88
+ onPasteAtCell(rowKey, menuColumn.id);
89
+ }
90
+ else if (paste?.ok) {
91
+ onCommitCell(row, id, menuColumn.id, cellPrevPayload(menuColumn, editBaseline(menuColumn), unit), paste.next, { overlay: paste.overlay });
92
+ }
93
+ },
94
+ }, {
95
+ label: clearLabel,
96
+ icon: _jsx(icons.clear, { className: "h-4 w-4" }),
97
+ disabled: !canClear,
98
+ onClick: () => onCommitCell(row, id, menuColumn.id, cellClearPrev(menuColumn, row, pendingByCol), ""),
99
+ });
100
+ }
101
+ cellItems.push({ separator: true });
102
+ }
103
+ const selectItems = selectable
104
+ ? [
105
+ {
106
+ label: messages({ key: "views.menus.row-select", values: { selected: selected ? "true" : "false" } }),
107
+ icon: _jsx(icons.selectRow, { className: "h-4 w-4" }),
108
+ onClick: () => toggle(id),
109
+ },
110
+ { separator: true },
111
+ ]
112
+ : [];
113
+ const contextItems = [...cellItems, ...selectItems, ...(contextMenu?.(row) ?? [])];
114
+ const handleContextMenu = (event) => {
115
+ const target = event.target;
116
+ const columnId = target.closest("[data-col-id]")?.getAttribute("data-col-id");
117
+ const column = columnId ? columns.find((item) => item.id === columnId) : undefined;
118
+ setMenuColumnId(column?.id ?? null);
119
+ if (column && !selecting) {
120
+ const index = columns.findIndex((item) => item.id === column.id);
121
+ const inRange = rowRange?.some((span) => index >= span.startCol && index <= span.endCol);
122
+ if (!inRange)
123
+ onFocusCell(rowKey, column.id);
124
+ }
125
+ };
126
+ return { contextItems, handleContextMenu };
127
+ }
@@ -0,0 +1 @@
1
+ export declare function useGridScaleStyles(scale: number, grouped: boolean, isMobile: boolean, addColumn?: boolean): import("react").CSSProperties;
@@ -0,0 +1,29 @@
1
+ "use client";
2
+ import { useMemo } from "react";
3
+ export function useGridScaleStyles(scale, grouped, isMobile, addColumn = false) {
4
+ return useMemo(() => ({
5
+ "--vk-scale": String(scale),
6
+ "--vk-indent": isMobile ? "0px" : "24px",
7
+ "--vk-row-h": "calc(37px * var(--vk-scale))",
8
+ "--vk-line-h": "calc(22px * var(--vk-scale))",
9
+ "--vk-cell-py": "calc((var(--vk-row-h) - var(--vk-line-h) - 1px) / 2)",
10
+ "--vk-tail-py": "max(0px, calc((var(--vk-row-h) - 2rem - 1px) / 2))",
11
+ "--vk-head-h": "calc(32px * var(--vk-scale))",
12
+ "--vk-head-text": "calc(12px * var(--vk-scale))",
13
+ "--vk-head-glyph": "calc(12px * var(--vk-scale))",
14
+ "--vk-footer-h": "calc(36px * var(--vk-scale))",
15
+ "--vk-label-h": "calc(36px * var(--vk-scale))",
16
+ "--vk-text": "calc(14px * var(--vk-scale))",
17
+ "--vk-text-xs": "calc(12px * var(--vk-scale))",
18
+ "--vk-text-10": "calc(10px * var(--vk-scale))",
19
+ "--vk-px": "calc(12px * var(--vk-scale))",
20
+ "--vk-rail-gap": "3px",
21
+ "--vk-rail-w": "min(32px, calc(var(--vk-gutter,0px) + var(--vk-indent,0px)))",
22
+ "--vk-tail-w": addColumn ? "calc(140px + var(--vk-px))" : "calc(36px + var(--vk-px))",
23
+ "--vk-tail-pl": addColumn
24
+ ? "max(0px, calc(var(--vk-px) + var(--vk-head-glyph) / 2 - 18px))"
25
+ : "var(--vk-px)",
26
+ "--vk-glyph": "calc(14px * var(--vk-scale))",
27
+ "--vk-scroll-mt": `calc(${grouped ? "var(--vk-label-h) + 6px" : "0px"} + ${isMobile ? "0px" : "var(--vk-head-h)"} + 4px)`,
28
+ }), [addColumn, grouped, isMobile, scale]);
29
+ }
@@ -0,0 +1,38 @@
1
+ import { type RefObject, type UIEvent } from "react";
2
+ /** What a group's rows scroller spreads on itself: its registration, its scroll handler, its
3
+ * overflow classes. Named, so its readers never spell it as an indexed type. */
4
+ export type GridScrollSurface = {
5
+ /** A ref callback: what it returns is React's ref cleanup, which a wrapper must hand back. */
6
+ register: (element: HTMLElement | null) => (() => void) | undefined;
7
+ onScroll: (event: UIEvent<HTMLElement>) => void;
8
+ className: string;
9
+ };
10
+ /**
11
+ * Horizontal lock-step scrolling for per-group scrollers and sticky headers.
12
+ *
13
+ * The page-sticky headers live OUTSIDE the scrollers (so they can pin
14
+ * vertically) but are themselves `overflow-x-hidden` scroll containers, driven
15
+ * programmatically.
16
+ *
17
+ * They must NOT be slid by `transform: translate3d(-x)`. Two bugs came from
18
+ * that: a transform has no end-stop, so the header over-travelled past its own
19
+ * content at the end of a scroll; and frozen header columns had to
20
+ * counter-transform in JS, which drifted a frame behind the compositor-driven
21
+ * body. As real scrollers, `scrollLeft` clamps itself and frozen header cells
22
+ * use plain `position: sticky` — pinned by the compositor, never lagging.
23
+ *
24
+ * Idempotent writes (`!== x` guards) make echoed scroll events terminate.
25
+ */
26
+ export declare function useGridScrollSync(rootRef: RefObject<HTMLDivElement | null>): {
27
+ scrollXRef: RefObject<number>;
28
+ getScroller: () => HTMLElement | undefined;
29
+ surface: GridScrollSurface;
30
+ registerHeader: (element: HTMLElement | null) => (() => void) | undefined;
31
+ headerWheelRef: (element: HTMLElement | null) => (() => void) | undefined;
32
+ headerPanHandlers: {
33
+ onPointerDown: (event: React.PointerEvent) => void;
34
+ onPointerMove: (event: React.PointerEvent) => void;
35
+ onPointerUp: () => void;
36
+ onPointerCancel: () => void;
37
+ };
38
+ };