@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,173 @@
1
+ import type { ReactNode } from "react";
2
+ import type { DisplayCurrency } from "../../fields/currency.js";
3
+ import type { ViewsRowMenuItem } from "../../atoms/types.js";
4
+ import type { FieldMenus } from "../../fields/menus.js";
5
+ import type { ListGroup } from "../../grouping/types.js";
6
+ import type { ListSelectionConfig } from "../../selection/types.js";
7
+ import type { ListSettingsConfig } from "../../model/column-capabilities.js";
8
+ import type { ListAggregateKind, ListCellAction, ListColumn, ListOptionColorOverrides, ListRelationValue, ListSelectColor } from "../../model/column-schema.js";
9
+ import type { ListDateStyle, ListDateStyleOverrides, ListDurationStyle, ListDurationStyleOverrides, ListNumberFormatOverrides, ListPercentDisplayOverrides, ListShowTimeOverrides } from "../../model/column-format.js";
10
+ import type { ListColumnState, ListColumnsConfig } from "../../model/column-state.js";
11
+ import type { PercentDisplay } from "@viewkitjs/fields";
12
+ import type { ListGroupSummaryPart } from "../../model/preferences.js";
13
+ import type { ListRowIconAccessor } from "../../model/row-icon.js";
14
+ import type { GridCellCommitFn, GridCellsCommitFn } from "../core/commit-model.js";
15
+ import type { GridGroupByState, GridSortState } from "./GridColumnMenu.js";
16
+ import type { GridGroupSortOption } from "./GridGroupMenu.js";
17
+ /** A group count's noun, singular and plural ("company", "companies"): "2 companies". None: a bare
18
+ * count. */
19
+ export type GroupCountNoun = {
20
+ one: string;
21
+ other: string;
22
+ };
23
+ /** One figure a group header can show: the part that turns it on, its column's header (what the menu and
24
+ * the header call it), and how it draws for a group. */
25
+ export type GridGroupFigure<Row> = {
26
+ part: ListGroupSummaryPart;
27
+ label: ReactNode;
28
+ render: (group: ListGroup<Row>) => ReactNode;
29
+ };
30
+ /** A view's identity: when it changes, the whole body is replaced, and the grid shows its wait for
31
+ * one commit first. */
32
+ type GridTransitionKey = string | number | boolean | null | undefined;
33
+ export type GridTableProps<Row> = {
34
+ /** View/filter identity that replaces the whole collection body. */
35
+ transitionKey?: GridTransitionKey;
36
+ transitionPending?: boolean;
37
+ transitionLabel?: string;
38
+ groups: ListGroup<Row>[];
39
+ grouped: boolean;
40
+ getRowId: (row: Row) => string;
41
+ columns: ListColumn<Row>[];
42
+ isCollapsed?: (key: string) => boolean;
43
+ onToggleGroup?: (key: string) => void;
44
+ renderGroupLabel?: (group: ListGroup<Row>) => ReactNode;
45
+ /** Hide a group in the view, from its band's menu. Absent where a
46
+ * list cannot hide one. */
47
+ onHideGroup?: (key: string) => void;
48
+ /** Source-paged group continuation, rendered after this group's loaded rows. */
49
+ renderGroupFooter?: (group: ListGroup<Row>) => ReactNode;
50
+ renderAggregate?: (columnId: string, group: ListGroup<Row>) => ReactNode;
51
+ countOf?: (group: ListGroup<Row>) => number;
52
+ onOpenRow: (row: Row) => void;
53
+ /** Warm the row detail only from an actual primary pointer intent. */
54
+ onPrefetchRow?: (row: Row) => void;
55
+ /**
56
+ * Open the entity a `relation` cell points at.
57
+ *
58
+ * ONE handler for the whole grid, mirroring `onOpenRow`, rather than a
59
+ * callback per column: column definitions stay declarative (a builder that
60
+ * needs a bag of callbacks is telling you those cells want to be real typed
61
+ * columns), and a stable array memoizes properly.
62
+ *
63
+ * The host gets the resolved value back, so `value.entity` is what tells it
64
+ * WHICH drawer to open — the grid deliberately knows nothing about routes or
65
+ * drawers. Omit it and relation cells render inert.
66
+ */
67
+ onOpenRelation?: (value: ListRelationValue, columnId: string, row: Row) => void;
68
+ /**
69
+ * This app's glyph for an entity KIND, used by every `relation` cell that
70
+ * doesn't carry its own. Kept as a resolver so the grid never learns one
71
+ * application's vocabulary — see `GridCellOptions.entityIcon`.
72
+ */
73
+ entityIcon?: (kind: string | undefined) => ReactNode;
74
+ /**
75
+ * The verbs a `command` column's cell opens, by field key (spec §5: "every
76
+ * surface opens the verb menu, the host supplies the verbs"). The SAME map a
77
+ * host hands the drawer's `FieldPanel`, so Mark won / Mark lost / Reopen are
78
+ * declared once and reached from the panel, the grid and the card alike.
79
+ * Omit it and a command column is a read-only badge.
80
+ */
81
+ commands?: FieldMenus<Row>;
82
+ rowHref?: (row: Row) => string | undefined;
83
+ /** The row's action items. Named to match `ListViewProps.rowMenu` so a
84
+ * dual-renderer page passes ONE builder to both mounts. The grid has no
85
+ * kebab — these surface on right-click and in the row's ⋯ tail button — but
86
+ * the source of the items is the same, and a page that filled ListView's
87
+ * `rowMenu` and forgot the grid's used to silently lose every row action in
88
+ * the grid look. */
89
+ rowMenu?: (row: Row) => ViewsRowMenuItem[];
90
+ /** Override when the context menu must differ from `rowMenu`. Defaults to it. */
91
+ contextMenu?: (row: Row) => ViewsRowMenuItem[];
92
+ rowClassName?: (row: Row) => string | undefined;
93
+ onRowDelete?: (id: string) => Promise<void>;
94
+ deleteLabel?: string;
95
+ rowActions?: ListCellAction<Row>[];
96
+ /** The leading glyph in the title cell, as a DESCRIPTOR — the grid decides
97
+ * size and color from it. See `ListRowIconAccessor`. */
98
+ rowIcon?: ListRowIconAccessor<Row>;
99
+ showRowIcon?: boolean;
100
+ selection?: ListSelectionConfig;
101
+ loadMore?: {
102
+ hasMore: boolean;
103
+ onReveal: () => void;
104
+ label?: string;
105
+ };
106
+ emptyState?: ReactNode;
107
+ /** The reader's default currency: a money column read in Original totals in it. The host's
108
+ * answer (the portal: the reader's preference); default `DEFAULT_DISPLAY_CURRENCY`. */
109
+ defaultCurrency?: DisplayCurrency;
110
+ verticalBorders?: boolean;
111
+ sort?: GridSortState;
112
+ /** The view's group, for the header menu's Group by / Ungroup — present on
113
+ * view-backed lists only, the way `sort` is. */
114
+ groupBy?: GridGroupByState;
115
+ sortOptions?: GridGroupSortOption[];
116
+ /** Which figures ride beside a group name — a set, not a choice. */
117
+ groupSummary?: ListGroupSummaryPart[];
118
+ aggregates?: Record<string, ListAggregateKind>;
119
+ onAggregateChange?: (columnId: string, kind: ListAggregateKind) => void;
120
+ /** A saved view can change aggregate choices only for field-backed columns. */
121
+ viewBacked?: boolean;
122
+ onGroupSummaryChange?: (part: ListGroupSummaryPart, next: boolean) => void;
123
+ /** The figures a group header can show, in the list's order: each part, its column's header and its drawing. */
124
+ groupFigures?: GridGroupFigure<Row>[];
125
+ /** The group count's noun: "2 companies". None: a bare count. */
126
+ countNoun?: GroupCountNoun;
127
+ optionColors?: ListOptionColorOverrides;
128
+ onOptionColorChange?: (key: string, value: string, color: ListSelectColor | null) => void;
129
+ dateStyles?: ListDateStyleOverrides;
130
+ onDateStyleChange?: (key: string, style: ListDateStyle) => void;
131
+ durationStyles?: ListDurationStyleOverrides;
132
+ onDurationStyleChange?: (key: string, style: ListDurationStyle) => void;
133
+ numberFormats?: ListNumberFormatOverrides;
134
+ /** `decimals: null` = the field's own (Automatic). */
135
+ onNumberFormatChange?: (key: string, patch: {
136
+ decimals?: number | null;
137
+ currency?: string;
138
+ }) => void;
139
+ showTimeOverrides?: ListShowTimeOverrides;
140
+ onShowTimeChange?: (key: string, show: boolean) => void;
141
+ percentDisplays?: ListPercentDisplayOverrides;
142
+ onPercentDisplayChange?: (key: string, display: PercentDisplay) => void;
143
+ /** Whether a format knob can be stored (decimals, a date's style, a percent's display, an option's colour):
144
+ * false hides them from the column menu, where there is nothing to store them against. A reader's own
145
+ * currency reading stays. Default true. */
146
+ formatsWritable?: boolean;
147
+ /** The host's own "+ Add column", the header row's last cell (a field editor's, for an admin). Nothing, or a
148
+ * falsy answer, draws the grid's own: the columns the view hides. */
149
+ renderAddColumn?: (columns: ListColumnsConfig) => ReactNode;
150
+ /** The host's rows in a column's menu for the column's field, above Hide (a field editor's Edit field and
151
+ * Archive field); `close` shuts the menu. Null for a field the host adds nothing to. */
152
+ renderColumnMenuRows?: (fieldKey: string, close: () => void) => ReactNode;
153
+ columnState?: ListColumnState;
154
+ onColumnStateChange?: (next: ListColumnState) => void;
155
+ scale?: number;
156
+ onCellCommit?: GridCellCommitFn<Row>;
157
+ onCellsCommit?: GridCellsCommitFn<Row>;
158
+ /** Per-user "Freeze identity columns" toggle: pins every column through the
159
+ * title to the left edge while the rest scrolls under them. */
160
+ freezeIdentity?: boolean;
161
+ /** Per-user "Wrap columns" toggle: typed cells wrap to at most 3 lines and
162
+ * rows grow to fit their tallest cell, instead of one line per row. */
163
+ wrapCells?: boolean;
164
+ /** Per-user "Show checkboxes always" toggle: holds the checkbox rail open
165
+ * instead of revealing it on hover. Same state a live selection forces. */
166
+ alwaysCheckboxes?: boolean;
167
+ /** Workspace-settings capability config for THIS list (table read-only / per-column
168
+ * locks), inherited by every user. The CONFIG layer of
169
+ * `declaration → config → prefs` — it may only SUBTRACT from what the
170
+ * columns declare. UI constraint only; the host's API guards its own writes. */
171
+ listConfig?: ListSettingsConfig;
172
+ };
173
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,34 @@
1
+ import type { ListBatchApi } from "../../selection/types.js";
2
+ import type { GridEditCell } from "../core/useGridEditing.js";
3
+ import type { ListSettingsConfig } from "../../model/column-capabilities.js";
4
+ import type { ListColumn } from "../../model/column-schema.js";
5
+ /**
6
+ * The batch bar's route into the grid's own write machinery.
7
+ *
8
+ * A verb like "set status on 12 rows" is not a different kind of write from
9
+ * editing one status cell — it is the same write, twelve times. Sending it
10
+ * through `commitBatchChecked` therefore buys everything the cell editors
11
+ * already have: the optimistic overlay (rows repaint on the click rather than
12
+ * when the server round-trip returns), ONE history entry so ⌘Z reverts the
13
+ * whole batch in a single step, and rollback if the write fails.
14
+ *
15
+ * Its own module rather than more lines in GridTable: that file sits under an
16
+ * oversized-debt ceiling whose policy says split the responsibility rather than
17
+ * raise the number.
18
+ */
19
+ export declare function useGridBatchApi<Row>({ enabled, columns, listConfig, rows, getRowId, pendingByRow, commitBatch, }: {
20
+ /** The grid can write at all (the host passed a commit handler). */
21
+ enabled: boolean;
22
+ /** Visible columns — the id resolves against what the user can actually see. */
23
+ columns: ListColumn<Row>[];
24
+ listConfig: ListSettingsConfig | undefined;
25
+ /** Every loaded row, for resolving selected ids to row objects. */
26
+ rows: Row[];
27
+ getRowId: (row: Row) => string;
28
+ /** Optimistic values already in flight — the undo baseline reads through them
29
+ * so a second batch over the same cells doesn't record a stale `prev`. */
30
+ pendingByRow: ReadonlyMap<string, Record<string, unknown>>;
31
+ commitBatch: (edits: (GridEditCell<Row> & {
32
+ row: Row;
33
+ })[]) => Promise<boolean>;
34
+ }): ListBatchApi | undefined;
@@ -0,0 +1,35 @@
1
+ "use client";
2
+ import { useMemo } from "react";
3
+ import { cellEditBaseline, cellPrevPayload } from "./cell-clipboard.js";
4
+ import { columnEffectiveWritable } from "../../model/column-capabilities.js";
5
+ export function useGridBatchApi({ enabled, columns, listConfig, rows, getRowId, pendingByRow, commitBatch, }) {
6
+ return useMemo(() => {
7
+ if (!enabled)
8
+ return undefined;
9
+ return {
10
+ setColumnValue: (rowIds, columnId, value) => {
11
+ const col = columns.find((c) => c.id === columnId);
12
+ if (!col || !columnEffectiveWritable(col, listConfig))
13
+ return Promise.resolve(false);
14
+ const byId = new Map(rows.map((r) => [getRowId(r), r]));
15
+ const overlay = col.type !== "number" && col.type !== "date";
16
+ const edits = [];
17
+ for (const rowId of rowIds) {
18
+ const row = byId.get(rowId);
19
+ if (row == null)
20
+ continue;
21
+ edits.push({
22
+ row,
23
+ rowId,
24
+ columnId,
25
+ prev: cellPrevPayload(col, cellEditBaseline(col, row, pendingByRow.get(rowId)), col.editUnit?.value(row)),
26
+ next: value,
27
+ overlay,
28
+ rowSnapshot: row,
29
+ });
30
+ }
31
+ return commitBatch(edits);
32
+ },
33
+ };
34
+ }, [enabled, columns, listConfig, rows, getRowId, pendingByRow, commitBatch]);
35
+ }
@@ -0,0 +1,30 @@
1
+ import { type PointerEvent as ReactPointerEvent, type RefObject } from "react";
2
+ import type { ListColumnsConfig } from "../../model/column-state.js";
3
+ import type { ListColumn } from "../../model/column-schema.js";
4
+ import { type ListColumnState } from "../../model/column-state.js";
5
+ export declare function useGridColumnLayout<Row>({ rootRef, columns, columnState, onColumnStateChange, scale, freezeIdentity, viewBacked, }: {
6
+ rootRef: RefObject<HTMLDivElement | null>;
7
+ columns: ListColumn<Row>[];
8
+ columnState?: ListColumnState;
9
+ onColumnStateChange?: (state: ListColumnState) => void;
10
+ scale: number;
11
+ /** Pin the identity columns (everything through the title) to the left edge. */
12
+ freezeIdentity?: boolean;
13
+ /** Saved views persist layout only for field-backed columns. */
14
+ viewBacked?: boolean;
15
+ }): {
16
+ visibleColumns: ListColumn<Row>[];
17
+ widthVarsStyle: import("react").CSSProperties;
18
+ frozenCount: number;
19
+ frozenLeft: (i: number) => string;
20
+ columnManager: ListColumnsConfig | null;
21
+ gridTemplate: string;
22
+ minWidth: string;
23
+ resizingId: string | null;
24
+ startResize: (col: ListColumn<Row>, event: ReactPointerEvent<HTMLElement>) => void;
25
+ moveResize: (event: ReactPointerEvent<HTMLElement>) => void;
26
+ endResize: () => void;
27
+ resetColumnWidth: (col: ListColumn<Row>) => void;
28
+ hideColumn: (col: ListColumn<Row>) => void;
29
+ moveColumn: (col: ListColumn<Row>, direction: -1 | 1) => void;
30
+ };
@@ -0,0 +1,206 @@
1
+ "use client";
2
+ import { useCallback, useMemo, useRef, useState, } from "react";
3
+ import { baseColumnOrder, columnPlacedByView, resolveViewColumnOrder, } from "../../model/column-capabilities.js";
4
+ import { gridWidthVar } from "../core/grid-scale.js";
5
+ import { clampColumnWidth, columnHideable, isColumnHidden, prettifyOptionValue, resolveColumnOrder, resolveColumnWidths, resolveVisibleColumns, toggleColumnHidden, } from "../../model/column-state.js";
6
+ import { useViews } from "../../provider/context.js";
7
+ import { gridColumnGlyph } from "./column-glyph.js";
8
+ function setBodyResizeState(active) {
9
+ document.body.style.cursor = active ? "col-resize" : "";
10
+ document.body.style.userSelect = active ? "none" : "";
11
+ }
12
+ export function useGridColumnLayout({ rootRef, columns, columnState, onColumnStateChange, scale, freezeIdentity = true, viewBacked = false, }) {
13
+ const { icons, components } = useViews();
14
+ const orderKey = columnState?.order;
15
+ const hiddenKey = columnState?.hidden;
16
+ const shownKey = columnState?.visible;
17
+ const visibleColumns = useMemo(() => {
18
+ if (!viewBacked) {
19
+ return resolveVisibleColumns(columns, {
20
+ order: orderKey,
21
+ hidden: hiddenKey,
22
+ visible: shownKey,
23
+ });
24
+ }
25
+ const managedIds = new Set(columns.filter(columnPlacedByView).map((column) => column.id));
26
+ return resolveVisibleColumns(columns, {
27
+ order: resolveViewColumnOrder(columns, orderKey),
28
+ hidden: hiddenKey?.filter((id) => managedIds.has(id)),
29
+ visible: shownKey?.filter((id) => managedIds.has(id)),
30
+ });
31
+ }, [columns, orderKey, hiddenKey, shownKey, viewBacked]);
32
+ const effectiveWidths = useMemo(() => resolveColumnWidths(visibleColumns, columnState?.widths), [visibleColumns, columnState?.widths]);
33
+ const frozenCount = useMemo(() => {
34
+ if (!freezeIdentity)
35
+ return 0;
36
+ const i = visibleColumns.findIndex((c) => c.type === "title");
37
+ if (i < 0)
38
+ return 0;
39
+ return Math.max(0, Math.min(i + 1, visibleColumns.length - 1));
40
+ }, [freezeIdentity, visibleColumns]);
41
+ const frozenLeft = useCallback((i) => `calc(var(--vk-rail-w)` +
42
+ visibleColumns
43
+ .slice(0, i)
44
+ .map((c) => ` + var(${gridWidthVar(c.id)}) * var(--vk-scale)`)
45
+ .join("") +
46
+ `)`, [visibleColumns]);
47
+ const frozenWidth = useMemo(() => frozenCount === 0
48
+ ? "0px"
49
+ : `calc((${visibleColumns
50
+ .slice(0, frozenCount)
51
+ .map((c) => `var(${gridWidthVar(c.id)})`)
52
+ .join(" + ")}) * var(--vk-scale))`, [visibleColumns, frozenCount]);
53
+ const widthVarsStyle = useMemo(() => {
54
+ const style = {};
55
+ for (const col of visibleColumns) {
56
+ style[gridWidthVar(col.id)] = `${effectiveWidths[col.id]}px`;
57
+ }
58
+ style["--vk-frozen-w"] = frozenWidth;
59
+ style["--vk-frozen-on"] = frozenCount > 0 ? "1" : "0";
60
+ return style;
61
+ }, [effectiveWidths, visibleColumns, frozenWidth, frozenCount]);
62
+ const columnManager = useMemo(() => {
63
+ if (!onColumnStateChange)
64
+ return null;
65
+ return {
66
+ items: resolveColumnOrder(columns, viewBacked ? resolveViewColumnOrder(columns, columnState?.order) : columnState?.order).map((col) => ({
67
+ id: col.id,
68
+ label: typeof col.header === "string" && col.header ? col.header : prettifyOptionValue(col.id),
69
+ icon: gridColumnGlyph({ icons, AppIcon: components.AppIcon }, col, "h-3.5 w-3.5"),
70
+ hidden: isColumnHidden(col, viewBacked && !columnPlacedByView(col) ? undefined : columnState),
71
+ hideable: !viewBacked || columnPlacedByView(col) ? columnHideable(col) : false,
72
+ fixed: viewBacked && !columnPlacedByView(col),
73
+ })),
74
+ onToggleHidden: (id, hide) => {
75
+ const col = columns.find((candidate) => candidate.id === id);
76
+ if (viewBacked && col && !columnPlacedByView(col))
77
+ return;
78
+ if (col)
79
+ onColumnStateChange(toggleColumnHidden(columnState, col, hide));
80
+ },
81
+ onReorder: (ids) => onColumnStateChange({
82
+ ...columnState,
83
+ order: viewBacked ? resolveViewColumnOrder(columns, ids) : ids,
84
+ }),
85
+ onReset: () => onColumnStateChange({}),
86
+ dirty: Object.keys(columnState ?? {}).length > 0,
87
+ };
88
+ }, [columnState, columns, components.AppIcon, icons, onColumnStateChange, viewBacked]);
89
+ const gridTemplate = useMemo(() => [
90
+ "0px",
91
+ ...visibleColumns.map((col) => `calc(var(${gridWidthVar(col.id)}) * var(--vk-scale))`),
92
+ "minmax(var(--vk-tail-w),1fr)",
93
+ ].join(" "), [visibleColumns]);
94
+ const minWidth = useMemo(() => `calc((${visibleColumns
95
+ .map((col) => `var(${gridWidthVar(col.id)})`)
96
+ .join(" + ")}) * var(--vk-scale) + 2*var(--vk-gutter,0px) + var(--vk-indent,0px) + var(--vk-tail-w))`, [visibleColumns]);
97
+ const [resizingId, setResizingId] = useState(null);
98
+ const dragRef = useRef(null);
99
+ const rafRef = useRef(null);
100
+ const pendingXRef = useRef(0);
101
+ const lastGestureMovedRef = useRef(false);
102
+ const startResize = (col, event) => {
103
+ dragRef.current = {
104
+ col,
105
+ startX: event.clientX,
106
+ startW: effectiveWidths[col.id],
107
+ lastW: null,
108
+ moved: false,
109
+ };
110
+ lastGestureMovedRef.current = false;
111
+ setResizingId(col.id);
112
+ setBodyResizeState(true);
113
+ };
114
+ const moveResize = (event) => {
115
+ if (!dragRef.current)
116
+ return;
117
+ pendingXRef.current = event.clientX;
118
+ if (rafRef.current != null)
119
+ return;
120
+ rafRef.current = requestAnimationFrame(() => {
121
+ rafRef.current = null;
122
+ const drag = dragRef.current;
123
+ if (!drag)
124
+ return;
125
+ const delta = pendingXRef.current - drag.startX;
126
+ if (Math.abs(delta) > 2)
127
+ drag.moved = true;
128
+ const width = clampColumnWidth(drag.col, drag.startW + delta / scale);
129
+ drag.lastW = width;
130
+ rootRef.current?.style.setProperty(gridWidthVar(drag.col.id), `${width}px`);
131
+ });
132
+ };
133
+ const endResize = () => {
134
+ const drag = dragRef.current;
135
+ dragRef.current = null;
136
+ if (rafRef.current != null) {
137
+ cancelAnimationFrame(rafRef.current);
138
+ rafRef.current = null;
139
+ }
140
+ setResizingId(null);
141
+ setBodyResizeState(false);
142
+ if (!drag)
143
+ return;
144
+ lastGestureMovedRef.current = drag.moved;
145
+ if (!drag.moved || drag.lastW == null || drag.lastW === effectiveWidths[drag.col.id])
146
+ return;
147
+ onColumnStateChange?.({
148
+ ...columnState,
149
+ widths: { ...(columnState?.widths ?? {}), [drag.col.id]: drag.lastW },
150
+ });
151
+ };
152
+ const resetColumnWidth = (col) => {
153
+ if (lastGestureMovedRef.current)
154
+ return;
155
+ const widths = { ...(columnState?.widths ?? {}) };
156
+ if (!(col.id in widths))
157
+ return;
158
+ delete widths[col.id];
159
+ const next = { ...columnState };
160
+ if (Object.keys(widths).length === 0)
161
+ delete next.widths;
162
+ else
163
+ next.widths = widths;
164
+ onColumnStateChange?.(next);
165
+ };
166
+ const hideColumn = (col) => {
167
+ if (viewBacked && !columnPlacedByView(col))
168
+ return;
169
+ onColumnStateChange?.(toggleColumnHidden(columnState, col, true));
170
+ };
171
+ const moveColumn = (col, direction) => {
172
+ if (viewBacked && !columnPlacedByView(col))
173
+ return;
174
+ const ordered = baseColumnOrder(columns, columnState?.order, viewBacked);
175
+ const visibleIds = visibleColumns.map((c) => c.id);
176
+ const at = visibleIds.indexOf(col.id);
177
+ const neighbour = visibleIds[at + direction];
178
+ if (at < 0 || !neighbour)
179
+ return;
180
+ if (viewBacked && !columnPlacedByView(columns.find((c) => c.id === neighbour)))
181
+ return;
182
+ const i = ordered.indexOf(col.id);
183
+ const j = ordered.indexOf(neighbour);
184
+ [ordered[i], ordered[j]] = [ordered[j], ordered[i]];
185
+ onColumnStateChange?.({
186
+ ...columnState,
187
+ order: viewBacked ? resolveViewColumnOrder(columns, ordered) : ordered,
188
+ });
189
+ };
190
+ return {
191
+ visibleColumns,
192
+ widthVarsStyle,
193
+ frozenCount,
194
+ frozenLeft,
195
+ columnManager,
196
+ gridTemplate,
197
+ minWidth,
198
+ resizingId,
199
+ startResize,
200
+ moveResize,
201
+ endResize,
202
+ resetColumnWidth,
203
+ hideColumn,
204
+ moveColumn,
205
+ };
206
+ }
@@ -0,0 +1,20 @@
1
+ import type { MutableRefObject } from "react";
2
+ import type { ListColumn } from "../../model/column-schema.js";
3
+ import type { ListColumnState } from "../../model/column-state.js";
4
+ /** Bind visible header drag order back onto the complete stored column order. */
5
+ export declare function useGridHeaderDrag<Row>({ columns, columnState, onColumnStateChange, visibleColumnIds, scrollXRef, getScroller, viewBacked, }: {
6
+ columns: ListColumn<Row>[];
7
+ columnState?: ListColumnState;
8
+ onColumnStateChange?: (next: ListColumnState) => void;
9
+ visibleColumnIds: string[];
10
+ scrollXRef: MutableRefObject<number>;
11
+ getScroller: () => HTMLElement | undefined;
12
+ viewBacked?: boolean;
13
+ }): {
14
+ cellStyle: (id: string, index: number) => React.CSSProperties | undefined;
15
+ onCellPointerDown: (id: string, index: number) => (e: React.PointerEvent<HTMLElement>) => void;
16
+ onCellPointerMove: (e: React.PointerEvent<HTMLElement>) => void;
17
+ onCellPointerUp: (e: React.PointerEvent<HTMLElement>) => void;
18
+ onCellPointerCancel: () => void;
19
+ onCellClickCapture: (e: React.MouseEvent<HTMLElement>) => void;
20
+ };
@@ -0,0 +1,37 @@
1
+ "use client";
2
+ import { baseColumnOrder, columnPlacedByView, resolveViewColumnOrder, } from "../../model/column-capabilities.js";
3
+ import { useHeaderDragReorder } from "./useHeaderDragReorder.js";
4
+ export function useGridHeaderDrag({ columns, columnState, onColumnStateChange, visibleColumnIds, scrollXRef, getScroller, viewBacked = false, }) {
5
+ return useHeaderDragReorder({
6
+ enabled: !!onColumnStateChange,
7
+ ids: visibleColumnIds,
8
+ scrollXRef,
9
+ getScroller,
10
+ canDrag: (id) => {
11
+ const column = columns.find((candidate) => candidate.id === id);
12
+ return !viewBacked || !column || columnPlacedByView(column);
13
+ },
14
+ onReorder: (movedId, nextVisible) => {
15
+ if (!onColumnStateChange)
16
+ return;
17
+ const moved = columns.find((column) => column.id === movedId);
18
+ if (viewBacked && moved && !columnPlacedByView(moved))
19
+ return;
20
+ const completeOrder = baseColumnOrder(columns, columnState?.order, viewBacked);
21
+ const remaining = completeOrder.filter((id) => id !== movedId);
22
+ const position = nextVisible.indexOf(movedId);
23
+ const follower = nextVisible[position + 1];
24
+ const previous = nextVisible[position - 1];
25
+ const insertAt = follower != null
26
+ ? remaining.indexOf(follower)
27
+ : previous != null
28
+ ? remaining.indexOf(previous) + 1
29
+ : remaining.length;
30
+ remaining.splice(insertAt, 0, movedId);
31
+ onColumnStateChange({
32
+ ...columnState,
33
+ order: viewBacked ? resolveViewColumnOrder(columns, remaining) : remaining,
34
+ });
35
+ },
36
+ });
37
+ }
@@ -0,0 +1,47 @@
1
+ import { type RefObject } from "react";
2
+ import type { GridCellPos } from "../core/coordinates.js";
3
+ import type { GridCellRange } from "../core/useGridRange.js";
4
+ import type { ListSettingsConfig } from "../../model/column-capabilities.js";
5
+ import type { ListColumn } from "../../model/column-schema.js";
6
+ import type { GridRangeVerbs } from "./useGridRangeActions.js";
7
+ export declare function useGridKeyboard<Row>({ rootRef, focusedCell, editingCell, editingEnabled, listConfig, visibleRowIds, rowByKey, visibleColIds, visibleColumns, rows, getRowId, pendingByRow, rangeVerbsRef, focusCell, clearFocus, startEdit, cancelEdit, commitEdit, refuseEdit, undo, redo, rangeSetSingle, rangeSetRect, rangeExtendTo, ranges, }: {
8
+ rootRef: RefObject<HTMLDivElement | null>;
9
+ focusedCell: GridCellPos | null;
10
+ editingCell: GridCellPos | null;
11
+ editingEnabled: boolean;
12
+ /** Workspace-settings capability config — the keyboard routes ask the same effective
13
+ * write gate the cells do, so a lock holds here too. */
14
+ listConfig?: ListSettingsConfig;
15
+ visibleRowIds: string[];
16
+ /** Row key → the rendered row and its DATA id. Focus is a KEY; a commit needs
17
+ * the record and the id behind it. */
18
+ rowByKey: ReadonlyMap<string, {
19
+ row: Row;
20
+ rowId: string;
21
+ }>;
22
+ visibleColIds: string[];
23
+ visibleColumns: ListColumn<Row>[];
24
+ rows: Row[];
25
+ getRowId: (row: Row) => string;
26
+ pendingByRow: ReadonlyMap<string, Record<string, unknown>>;
27
+ rangeVerbsRef: RefObject<GridRangeVerbs | null>;
28
+ focusCell: (rowId: string, columnId: string) => void;
29
+ clearFocus: () => void;
30
+ /** Seed a fresh rectangle (⌘A, or extending with no range yet). */
31
+ rangeSetRect: (anchor: GridCellPos, head: GridCellPos) => void;
32
+ /** Grow the ACTIVE range to a new head, anchor untouched. */
33
+ rangeExtendTo: (pos: GridCellPos) => void;
34
+ /** Live ranges — the last one is active; read for its head. */
35
+ ranges: GridCellRange[];
36
+ startEdit: (rowId: string, columnId: string, seed?: string) => void;
37
+ cancelEdit: () => void;
38
+ commitEdit: (row: Row, rowId: string, columnId: string, previous: unknown, next: unknown) => void;
39
+ /** Say why a cell can't be written; answers whether it said anything. */
40
+ refuseEdit: (columnId: string) => boolean;
41
+ undo: (resolveRow: (rowId: string) => Row | undefined, onApply?: (pos: GridCellPos) => void) => boolean;
42
+ redo: (resolveRow: (rowId: string) => Row | undefined, onApply?: (pos: GridCellPos) => void) => boolean;
43
+ rangeSetSingle: (pos: GridCellPos) => void;
44
+ }): {
45
+ onEditorTab: (rowId: string, columnId: string, backwards: boolean) => void;
46
+ onEditorEnter: (rowId: string, columnId: string) => void;
47
+ };