@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,15 @@
1
+ import type { PercentDisplay } from "@viewkitjs/fields";
2
+ import type { ListColumn } from "../../model/column-schema.js";
3
+ import { type GridFlyouts } from "./GridFlyout.js";
4
+ /** The percent row in the header menu — how the figure is drawn, one row
5
+ * whose choices fly out. Split out of GridColumnMenu for the line ceiling;
6
+ * the policy is split, not raise. */
7
+ export declare function GridColumnPercentSection<Row>({ column, percentDisplay, onPercentDisplayChange, fieldKey, flyouts, onClose, }: {
8
+ column: ListColumn<Row>;
9
+ /** The workspace's choice for this field, when one is stored. */
10
+ percentDisplay?: PercentDisplay;
11
+ onPercentDisplayChange: (fieldKey: string, display: PercentDisplay) => void;
12
+ fieldKey: string;
13
+ flyouts: GridFlyouts;
14
+ onClose: () => void;
15
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,16 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { GridFlyoutRow } from "./GridFlyout.js";
5
+ import { KnobGlyph } from "./GridMenuRow.js";
6
+ const DISPLAYS = ["text", "bar", "ring"];
7
+ export function GridColumnPercentSection({ column, percentDisplay, onPercentDisplayChange, fieldKey, flyouts, onClose, }) {
8
+ const active = percentDisplay ?? column.format?.percentDisplay ?? "text";
9
+ const { atoms, messages } = useViews();
10
+ const { Row } = atoms;
11
+ const displayLabel = (display) => messages({ key: "views.menus.percent-display-option", values: { display } });
12
+ return (_jsx(GridFlyoutRow, { id: "percent-display", flyouts: flyouts, label: messages({ key: "views.menus.percent-display" }), detail: displayLabel(active), leading: _jsx(KnobGlyph, { name: "progress" }), children: DISPLAYS.map((display) => (_jsx(Row, { chosen: active === display, label: displayLabel(display), onClick: () => {
13
+ onPercentDisplayChange(fieldKey, display);
14
+ onClose();
15
+ } }, display))) }));
16
+ }
@@ -0,0 +1,18 @@
1
+ import type { OrderDir } from "../../grouping/sort-groups.js";
2
+ /**
3
+ * The sort rows in the header menu — ascending, descending, and Clear sort
4
+ * while this column IS the sort. Split out of GridColumnMenu for the line
5
+ * ceiling; the policy is split, not raise.
6
+ */
7
+ export declare function GridColumnSortSection({ sortKey, value, dir, onChange, onClose, }: {
8
+ /** The key this column sorts by (`effectiveSortKey`). */
9
+ sortKey: string;
10
+ /** The list's current sort key and direction. */
11
+ value: string;
12
+ dir: OrderDir;
13
+ onChange: (next: {
14
+ value: string;
15
+ dir: OrderDir;
16
+ }) => void;
17
+ onClose: () => void;
18
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,16 @@
1
+ "use client";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { GridMenuRow } from "./GridMenuRow.js";
5
+ export function GridColumnSortSection({ sortKey, value, dir, onChange, onClose, }) {
6
+ const { messages } = useViews();
7
+ const active = value === sortKey;
8
+ const pick = (next) => {
9
+ onChange({ value: sortKey, dir: next });
10
+ onClose();
11
+ };
12
+ return (_jsxs(_Fragment, { children: [_jsx(GridMenuRow, { label: messages({ key: "views.menus.sort-asc" }), icon: "sortRowsUp", active: active && dir === "asc", onClick: () => pick("asc") }), _jsx(GridMenuRow, { label: messages({ key: "views.menus.sort-desc" }), icon: "sortRowsDown", active: active && dir === "desc", onClick: () => pick("desc") }), active && (_jsx(GridMenuRow, { label: messages({ key: "views.menus.sort-clear" }), icon: "clearSort", onClick: () => {
13
+ onChange({ value: "", dir: "asc" });
14
+ onClose();
15
+ } }))] }));
16
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The GRID's host around the shared `DateEditor` (`@viewkitjs/views/editors/date`) —
3
+ * the editing core is one component across every surface; this host only owns
4
+ * the grid's mechanics: anchor to the cell rect, open on mount, WHICH close
5
+ * happened, the exit animation gap, and the write. The core answers what the
6
+ * close means (`resolveClose`); the host applies it after the popover has
7
+ * played out. Time is present in the payload ("YYYY-MM-DDTHH:MM") unless the
8
+ * column is a calendar-day field (`dayOnly`), preserving the editor's original
9
+ * grid behavior — the column's Show-time setting is display only.
10
+ */
11
+ export declare function GridDateEditor({ initial, dayOnly, onCommit, onCancel, }: {
12
+ /** The stored value (ISO string) — selects the day + opening month. */
13
+ initial?: string;
14
+ /** The column presents a calendar-day field (`date`): the commit is the day
15
+ * alone — the shape the row stores and the write gate judges through
16
+ * `zodFor`. The panel still shows its time chip; a day field's row has no
17
+ * clock for it to land in. */
18
+ dayOnly?: boolean;
19
+ /** "YYYY-MM-DDTHH:MM" (local); "YYYY-MM-DD" when `dayOnly`. */
20
+ onCommit: (value: string) => void;
21
+ onCancel: () => void;
22
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,31 @@
1
+ "use client";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef, useState } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ import { DateEditor } from "../../editors/DateEditor.js";
6
+ export function GridDateEditor({ initial, dayOnly = false, onCommit, onCancel, }) {
7
+ const { Popover } = useViews().components;
8
+ const [open, setOpen] = useState(true);
9
+ const editorRef = useRef(null);
10
+ const anchorRef = useRef(null);
11
+ const closedRef = useRef(false);
12
+ const EXIT_MS = 160;
13
+ const close = (reason) => {
14
+ if (closedRef.current)
15
+ return;
16
+ closedRef.current = true;
17
+ const resolution = editorRef.current?.resolveClose(reason) ?? { kind: "noop" };
18
+ setOpen(false);
19
+ window.setTimeout(() => {
20
+ if (resolution.kind === "commit") {
21
+ onCommit(dayOnly ? resolution.payload.slice(0, 10) : resolution.payload);
22
+ }
23
+ else
24
+ onCancel();
25
+ }, EXIT_MS);
26
+ };
27
+ return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(Popover, { open: open, onOpenChange: (next) => {
28
+ if (!next)
29
+ close("outside");
30
+ }, anchor: anchorRef, align: "start", sideOffset: 4, onEscape: () => close("escape"), onOutsidePress: () => close("outside"), initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "z-90 w-auto", children: _jsx(DateEditor, { ref: editorRef, initial: initial, onRequestClose: close }) })] }));
31
+ }
@@ -0,0 +1,44 @@
1
+ import { type PointerEvent as ReactPointerEvent, type ReactElement, type ReactNode } from "react";
2
+ /** How long the pointer rests on a row before its flyout opens: a sweep down the list opens none. */
3
+ export declare const GRID_FLYOUT_HOVER_MS = 150;
4
+ export type GridFlyouts = {
5
+ /** The flyout showing now, by row id. */
6
+ openId: string | null;
7
+ /** Opens `id` after the hover delay; `null` closes whatever is open. */
8
+ hoverTo: (id: string | null) => void;
9
+ /** Drops a pending hover; an open flyout stays (the pointer is usually on its way in). */
10
+ cancelHover: () => void;
11
+ toggle: (id: string) => void;
12
+ /** Opens `id` at once, dropping a pending hover; never closes it. */
13
+ open: (id: string) => void;
14
+ close: () => void;
15
+ /** For the list that holds the rows: resting on a plain row closes the open flyout. */
16
+ onListPointerOver: (event: ReactPointerEvent<HTMLElement>) => void;
17
+ /** A flyout row hands its pointer events here, its popup's too through the React tree, so the list leaves them be. */
18
+ claim: (event: ReactPointerEvent<HTMLElement>) => void;
19
+ };
20
+ /**
21
+ * THE FLYOUTS' STATE — one open at a time across every `GridFlyoutRow` in a menu. The menu
22
+ * that holds the rows owns it and calls `close()` when it closes itself.
23
+ */
24
+ export declare function useGridFlyouts(): GridFlyouts;
25
+ /** Whether a press landed inside a grid flyout, read from its slot: the menu that opened it stays open. */
26
+ export declare function insideGridFlyout(event: Event): boolean;
27
+ /**
28
+ * A menu row that opens its choices BESIDE the menu: the map's Popover anchored on the row.
29
+ * A resting pointer opens it after a short delay; a mouse click opens it at once and never
30
+ * closes it (the hover usually got there first); a tap toggles it, the only way in on a phone.
31
+ * The row and its popup sit inside one element, so the popup's pointer events reach `claim`
32
+ * through the React tree, and the menu's list leaves the flyout open while the pointer is in it.
33
+ */
34
+ export declare function GridFlyoutRow({ id, flyouts, label, detail, leading, title, children, }: {
35
+ id: string;
36
+ flyouts: GridFlyouts;
37
+ label: ReactNode;
38
+ /** The current choice, the row's right-hand detail. */
39
+ detail?: ReactNode;
40
+ leading?: ReactNode;
41
+ title?: string;
42
+ /** The flyout's rows. */
43
+ children: ReactNode;
44
+ }): ReactElement;
@@ -0,0 +1,80 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useRef, useState, } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ export const GRID_FLYOUT_HOVER_MS = 150;
6
+ export function useGridFlyouts() {
7
+ const [openId, setOpenId] = useState(null);
8
+ const timerRef = useRef(null);
9
+ const claimed = useRef(new WeakSet());
10
+ const cancelHover = () => {
11
+ if (timerRef.current != null) {
12
+ window.clearTimeout(timerRef.current);
13
+ timerRef.current = null;
14
+ }
15
+ };
16
+ useEffect(() => cancelHover, []);
17
+ const hoverTo = (id) => {
18
+ cancelHover();
19
+ timerRef.current = window.setTimeout(() => {
20
+ timerRef.current = null;
21
+ setOpenId(id);
22
+ }, GRID_FLYOUT_HOVER_MS);
23
+ };
24
+ return {
25
+ openId,
26
+ hoverTo,
27
+ cancelHover,
28
+ toggle: (id) => {
29
+ cancelHover();
30
+ setOpenId((current) => (current === id ? null : id));
31
+ },
32
+ open: (id) => {
33
+ cancelHover();
34
+ setOpenId(id);
35
+ },
36
+ close: () => {
37
+ cancelHover();
38
+ setOpenId(null);
39
+ },
40
+ onListPointerOver: (event) => {
41
+ if (claimed.current.has(event.nativeEvent))
42
+ return;
43
+ if (openId != null)
44
+ hoverTo(null);
45
+ },
46
+ claim: (event) => {
47
+ claimed.current.add(event.nativeEvent);
48
+ },
49
+ };
50
+ }
51
+ export function insideGridFlyout(event) {
52
+ const target = event.target;
53
+ return target?.closest?.('[data-slot="vk-grid-flyout"]') != null;
54
+ }
55
+ export function GridFlyoutRow({ id, flyouts, label, detail, leading, title, children, }) {
56
+ const { atoms, components, icons } = useViews();
57
+ const { Row, List } = atoms;
58
+ const { Popover } = components;
59
+ const ChevronRight = icons.chevronRight;
60
+ const anchor = useRef(null);
61
+ const pressedWith = useRef(null);
62
+ const open = flyouts.openId === id;
63
+ return (_jsxs("div", { ref: anchor, onPointerOver: flyouts.claim, onPointerDown: (event) => {
64
+ if (anchor.current?.contains(event.target))
65
+ pressedWith.current = event.pointerType;
66
+ }, onMouseEnter: () => flyouts.hoverTo(id), onMouseLeave: () => {
67
+ pressedWith.current = null;
68
+ flyouts.cancelHover();
69
+ }, children: [_jsx(Row, { label: label, detail: detail, leading: leading, title: title, opens: true, open: open, trailing: _jsx(ChevronRight, { className: "size-3.5 shrink-0 text-(color:--vk-fg-subtlest)" }), onClick: () => {
70
+ const pointer = pressedWith.current;
71
+ pressedWith.current = null;
72
+ if (pointer === "mouse")
73
+ flyouts.open(id);
74
+ else
75
+ flyouts.toggle(id);
76
+ } }), _jsx(Popover, { open: open, onOpenChange: (next) => {
77
+ if (!next && flyouts.openId === id)
78
+ flyouts.close();
79
+ }, anchor: anchor, side: "right", align: "start", sideOffset: -2, alignOffset: -4, initialFocus: false, chrome: "menu", panelData: { "data-slot": "vk-grid-flyout" }, className: "min-w-32 max-w-80", onOutsidePress: (event) => anchor.current?.contains(event.target) ? false : undefined, children: _jsx(List, { children: children }) })] }));
80
+ }
@@ -0,0 +1,23 @@
1
+ import type { ReactNode } from "react";
2
+ import type { ListGroup } from "../../grouping/types.js";
3
+ import { type DisplayCurrency } from "../../fields/currency.js";
4
+ import type { ListAggregateKind, ListColumn } from "../../model/column-schema.js";
5
+ import type { ListNumberFormatOverrides } from "../../model/column-format.js";
6
+ export declare function GridFooter<Row>({ group, columns, gridTemplate, selecting, aggregates, numberFormats, renderAggregate, onAggregateChange, viewBacked, frozenCount, frozenLeft, continuation, defaultCurrency, }: {
7
+ group: ListGroup<Row>;
8
+ columns: ListColumn<Row>[];
9
+ gridTemplate: string;
10
+ selecting: boolean;
11
+ aggregates?: Record<string, ListAggregateKind>;
12
+ numberFormats?: ListNumberFormatOverrides;
13
+ renderAggregate?: (columnId: string, group: ListGroup<Row>) => ReactNode;
14
+ onAggregateChange?: (columnId: string, kind: ListAggregateKind) => void;
15
+ viewBacked?: boolean;
16
+ /** How many LEADING columns are pinned to the left edge (0 = nothing). */
17
+ frozenCount?: number;
18
+ /** Sticky `left` for the frozen column at visible index i. */
19
+ frozenLeft?: (i: number) => string;
20
+ continuation?: ReactNode;
21
+ /** The reader's default currency (the host's answer): a money column read in Original totals in it. */
22
+ defaultCurrency?: DisplayCurrency;
23
+ }): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
@@ -0,0 +1,81 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { cx } from "../../internal/cx.js";
4
+ import { CellSuffix } from "../../display/format.js";
5
+ import { figureFor, ratioFigure } from "../../figures.js";
6
+ import { aggregateLabel, aggregateOptions, computeAggregate, figureKeyOf, moneyFigureCode, moneyTotal, resolveAggregateKind, } from "../../model/aggregates.js";
7
+ import { DEFAULT_DISPLAY_CURRENCY } from "../../fields/currency.js";
8
+ import { fieldTypeOf } from "../../model/field-type-of.js";
9
+ import { fieldKeyOf } from "../../model/view-rules.js";
10
+ import { formatNumber } from "./cells.js";
11
+ import { useCellFormat } from "../../cells/use-cell-format.js";
12
+ import { useViews } from "../../provider/context.js";
13
+ import { GridAggregateMenu } from "./GridAggregateMenu.js";
14
+ import { GridRailSpacer } from "./checks.js";
15
+ import { GRID_CONTENT_PAD, GRID_GROUND } from "./grid-styles.js";
16
+ export function GridFooter({ group, columns, gridTemplate, selecting, aggregates, numberFormats, renderAggregate, onAggregateChange, viewBacked = false, frozenCount = 0, frozenLeft, continuation, defaultCurrency = DEFAULT_DISPLAY_CURRENCY, }) {
17
+ const interactive = !!onAggregateChange;
18
+ const cellFormat = useCellFormat();
19
+ const { messages } = useViews();
20
+ const hostCells = columns.map((column) => renderAggregate?.(column.id, group) ?? null);
21
+ const sourced = group.figures
22
+ ? { totalled: new Set(Object.keys(group.figures.fields)), defaultCurrency }
23
+ : undefined;
24
+ if (!interactive && hostCells.every((cell) => cell == null))
25
+ return continuation;
26
+ const footer = (_jsxs("div", { "data-slot": "vk-grid-footer", className: cx("grid", GRID_CONTENT_PAD), style: { gridTemplateColumns: gridTemplate }, children: [_jsx(GridRailSpacer, { selecting: selecting }), columns.map((column, index) => {
27
+ const kind = resolveAggregateKind(column, aggregates, sourced);
28
+ const columnInteractive = interactive && (!viewBacked || column.field != null);
29
+ const host = hostCells[index];
30
+ const ratioParts = column.field?.type === "formula" ? column.field.ratio : undefined;
31
+ const fromSource = host == null && kind !== "none" && group.figures
32
+ ? kind === "ratio" && ratioParts
33
+ ? ratioFigure(group.figures, ratioParts.numerator, ratioParts.denominator)
34
+ : figureFor(kind, group.figures, figureKeyOf(column, defaultCurrency))
35
+ : undefined;
36
+ const money = host == null && kind !== "none" && !group.figures
37
+ ? moneyTotal(kind, column, group.items, defaultCurrency)
38
+ : undefined;
39
+ const computed = host == null && kind !== "none" && !group.figures && money === undefined
40
+ ? computeAggregate(kind, column, group.items)
41
+ : null;
42
+ const countLike = kind === "count" || kind === "filled" || kind === "unique";
43
+ const decimals = numberFormats?.[fieldKeyOf(column)]?.decimals;
44
+ const sourceCode = fromSource != null && !countLike && fieldTypeOf(column) === "currency"
45
+ ? moneyFigureCode(column, defaultCurrency)
46
+ : undefined;
47
+ const value = host != null
48
+ ? host
49
+ : fromSource !== undefined
50
+ ? fromSource == null || sourceCode === null
51
+ ? null
52
+ : countLike
53
+ ? String(fromSource)
54
+ : formatNumber(fromSource, column, {
55
+ ...cellFormat,
56
+ decimals,
57
+ currency: sourceCode,
58
+ })
59
+ : money
60
+ ? formatNumber(money.amount, column, {
61
+ ...cellFormat,
62
+ decimals,
63
+ currency: money.code,
64
+ })
65
+ : computed != null
66
+ ? countLike
67
+ ? String(computed)
68
+ : formatNumber(computed, column, { ...cellFormat, decimals })
69
+ : null;
70
+ const label = host == null && kind !== "none" ? aggregateLabel(kind, messages) : null;
71
+ const suffix = host == null && column.aggregateSuffix && !countLike && kind !== "ratio"
72
+ ? column.aggregateSuffix
73
+ : null;
74
+ const frozen = index < frozenCount && !!frozenLeft;
75
+ const cell = (_jsx("div", { "data-slot": "vk-grid-footer-cell", style: frozen ? { left: frozenLeft(index) } : undefined, className: cx("group/gridagg flex h-(--vk-footer-h) min-w-0 items-center gap-1.5 overflow-hidden whitespace-nowrap px-(--vk-px)", column.align === "right" && "justify-end", column.align === "center" && "justify-center", columnInteractive && "cursor-pointer select-none hover:bg-(color:--vk-hovered)", frozen ? cx("sticky z-7", GRID_GROUND) : "relative"), children: value != null ? (_jsxs(_Fragment, { children: [label && (_jsx("span", { className: "text-(length:--vk-text-10) uppercase tracking-wide text-(color:--vk-fg-subtlest)", children: label })), _jsxs("span", { className: "text-(length:--vk-text) font-medium tabular-nums", children: [value, suffix && _jsx(CellSuffix, { children: suffix })] })] })) : columnInteractive ? (_jsx("span", { className: "text-(length:--vk-text-10) uppercase tracking-wide text-(color:--vk-fg-subtlest) opacity-0 group-hover/gridagg:opacity-100", children: messages({ key: "views.grid.figure-pick" }) })) : null }, column.id));
76
+ if (!columnInteractive)
77
+ return cell;
78
+ return (_jsx(GridAggregateMenu, { column: column, options: aggregateOptions(column, sourced), current: kind, onChange: (next) => onAggregateChange(column.id, next), align: column.align === "right" ? "end" : column.align === "center" ? "center" : "start", children: cell }, column.id));
79
+ }), _jsx("div", { "data-slot": "vk-grid-tail", className: "h-(--vk-footer-h)" })] }));
80
+ return (_jsxs(_Fragment, { children: [footer, continuation] }));
81
+ }
@@ -0,0 +1,37 @@
1
+ import { type ReactNode } from "react";
2
+ import type { OrderDir } from "../../grouping/sort-groups.js";
3
+ import type { GridSortState } from "./GridColumnMenu.js";
4
+ import type { ListGroupSummaryPart } from "../../model/preferences.js";
5
+ /** A sortable column, mirrored from the list's SortConfig options. */
6
+ export type GridGroupSortOption = {
7
+ value: string;
8
+ label: string;
9
+ defaultDir?: OrderDir;
10
+ };
11
+ /**
12
+ * The group-header `…` menu — a second remote for the list's row sort (all
13
+ * groups at once), surfaced on the group band. Reveals on hover of the group
14
+ * label; opens the map's popover, in its slot, of the same sortable columns the
15
+ * view-options Sort panel drives. Clicks stop propagation so the group's
16
+ * collapse toggle stays put.
17
+ */
18
+ export declare function GridGroupMenu({ sort, sortOptions, summary, onSummaryChange, figures, onHide, }: {
19
+ /** Absent when the list offers no row sort here — the menu then carries only
20
+ * what else it has (Hide group). */
21
+ sort?: GridSortState;
22
+ sortOptions: GridGroupSortOption[];
23
+ /** Hides this group in the view — what the host's group panel's eye does.
24
+ * Absent where a list cannot hide one. */
25
+ onHide?: () => void;
26
+ /** Which figures the group header shows next to the name. A SET — count and
27
+ * total answer different questions and are wanted together. */
28
+ summary?: ListGroupSummaryPart[];
29
+ onSummaryChange?: (part: ListGroupSummaryPart, next: boolean) => void;
30
+ /** The figures the header can show beside its count, in the list's order, each named by its COLUMN — "People",
31
+ * not "Total". A generic label made the option unreadable: you could not tell what a group would show
32
+ * without picking it and looking. None: no Show rows. */
33
+ figures?: {
34
+ part: ListGroupSummaryPart;
35
+ label: ReactNode;
36
+ }[];
37
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,57 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { useState } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ import { cx } from "../../internal/cx.js";
6
+ import { GridMenuRow, GridMenuSeparator } from "./GridMenuRow.js";
7
+ import { GRID_MENU_SEARCH_AFTER, matchMenuOptions } from "./grid-menu-search.js";
8
+ const EYEBROW = "px-2 pb-1 pt-2 text-[11px] font-medium uppercase tracking-wide text-(color:--vk-fg-subtle)";
9
+ export function GridGroupMenu({ sort, sortOptions, summary, onSummaryChange, figures = [], onHide, }) {
10
+ const [open, setOpen] = useState(false);
11
+ const [anchor, setAnchor] = useState(null);
12
+ const { atoms, components, icons, messages } = useViews();
13
+ const { Popover, Command } = components;
14
+ const { List, Row, RowContent } = atoms;
15
+ const More = icons.more;
16
+ const [query, setQuery] = useState("");
17
+ const close = () => {
18
+ setOpen(false);
19
+ setQuery("");
20
+ };
21
+ const offered = sort ? sortOptions : [];
22
+ const searchable = offered.length > GRID_MENU_SEARCH_AFTER;
23
+ const sorts = matchMenuOptions(offered, query);
24
+ const pick = (opt) => {
25
+ if (!sort)
26
+ return;
27
+ const active = sort.value === opt.value;
28
+ const dir = active
29
+ ? sort.dir === "asc"
30
+ ? "desc"
31
+ : "asc"
32
+ : (opt.defaultDir ?? "asc");
33
+ sort.onChange({ value: opt.value, dir });
34
+ close();
35
+ };
36
+ const sortGlyph = (opt) => {
37
+ const active = sort.value === opt.value;
38
+ const Glyph = active && sort.dir === "desc" ? icons.sortRowsDown : icons.sortRowsUp;
39
+ return (_jsx(Glyph, { className: cx("size-3.5", active ? "text-(color:--vk-fg-brand)" : "text-(color:--vk-fg-subtlest)") }));
40
+ };
41
+ return (_jsxs(_Fragment, { children: [_jsx("button", { ref: setAnchor, type: "button", "aria-label": messages({ key: "views.menus.group-options" }), "aria-haspopup": "dialog", "aria-expanded": open, onClick: (e) => {
42
+ e.stopPropagation();
43
+ if (open)
44
+ close();
45
+ else
46
+ setOpen(true);
47
+ }, className: cx("inline-flex h-6 w-6 shrink-0 items-center justify-center rounded-md text-(color:--vk-fg-subtle)", "transition-opacity hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)", "md:opacity-0 md:group-hover/gridlabel:opacity-100 aria-expanded:opacity-100"), children: _jsx(More, { className: "h-3.5 w-3.5" }) }), _jsx(Popover, { open: open, onOpenChange: (next) => (next ? setOpen(true) : close()), anchor: anchor, side: "bottom", align: "start", sideOffset: 4, initialFocus: false, chrome: "menu", panelData: { "data-slot": "vk-grid-group-menu" }, onPanelClick: (e) => e.stopPropagation(), className: "w-52", onOutsidePress: (event) => (anchor?.contains(event.target) ? false : undefined), children: _jsxs(List, { children: [offered.length > 0 && _jsx("div", { className: EYEBROW, children: messages({ key: "views.menus.group-sort" }) }), searchable ? (_jsxs(Command.Root, { shouldFilter: false, loop: true, label: messages({ key: "views.menus.search" }), children: [_jsx(Command.Input, { value: query, onValueChange: setQuery, placeholder: messages({ key: "views.menus.search" }) }), _jsx(Command.List, { className: "max-h-64 overscroll-contain", children: _jsx(Command.Group, { className: "p-0", children: sorts.map((opt) => {
48
+ const active = sort.value === opt.value;
49
+ return (_jsx(Command.Item, { value: opt.value, onSelect: () => pick(opt), chosen: active, children: _jsx(RowContent, { label: opt.label, leading: sortGlyph(opt), chosen: active }) }, opt.value));
50
+ }) }) })] })) : (sorts.map((opt) => (_jsx(Row, { chosen: sort.value === opt.value, label: opt.label, leading: sortGlyph(opt), onClick: () => pick(opt) }, opt.value)))), figures.length > 0 && onSummaryChange && (_jsxs(_Fragment, { children: [offered.length > 0 && _jsx(GridMenuSeparator, {}), _jsx("div", { className: EYEBROW, children: messages({ key: "views.menus.group-show" }) }), [
51
+ { part: "count", label: messages({ key: "views.menus.group-count" }) },
52
+ ...figures,
53
+ ].map((s) => (_jsx(Row, { chosen: (summary ?? []).includes(s.part), label: s.label, onClick: () => onSummaryChange(s.part, !(summary ?? []).includes(s.part)) }, s.part)))] })), onHide && (_jsxs(_Fragment, { children: [(offered.length > 0 || (figures.length > 0 && onSummaryChange)) && _jsx(GridMenuSeparator, {}), _jsx(GridMenuRow, { label: messages({ key: "views.menus.group-hide" }), icon: "hide", onClick: () => {
54
+ onHide();
55
+ close();
56
+ } })] }))] }) })] }));
57
+ }
@@ -0,0 +1,61 @@
1
+ import type { ReactNode } from "react";
2
+ import type { ListColumnsConfig } from "../../model/column-state.js";
3
+ import type { ListSettingsConfig } from "../../model/column-capabilities.js";
4
+ import type { ListColumn, ListOptionColorOverrides, ListSelectColor } from "../../model/column-schema.js";
5
+ import type { ListDateStyle, ListDateStyleOverrides, ListDurationStyle, ListDurationStyleOverrides, ListNumberFormatOverrides, ListPercentDisplayOverrides, ListShowTimeOverrides } from "../../model/column-format.js";
6
+ import type { PercentDisplay } from "@viewkitjs/fields";
7
+ import { type GridGroupByState, type GridSortState } from "./GridColumnMenu.js";
8
+ import type { useHeaderDragReorder } from "./useHeaderDragReorder.js";
9
+ type HeaderDrag = ReturnType<typeof useHeaderDragReorder>;
10
+ export declare function GridHeader<Row>({ inline, showAddColumn, checkbox, columns, columnManager, gridTemplate, minWidth, sort, selectValues, optionColors, onOptionColorChange, dateStyles, onDateStyleChange, durationStyles, onDurationStyleChange, numberFormats, onNumberFormatChange, showTimeOverrides, onShowTimeChange, percentDisplays, onPercentDisplayChange, columnStateEnabled, listConfig, groupBy, resizingId, startResize, moveResize, endResize, resetColumnWidth, hideColumn, moveColumn, headerDrag, registerHeader, frozenCount, frozenLeft, viewBacked, formatsWritable, renderAddColumn, renderColumnMenuRows, }: {
11
+ inline: boolean;
12
+ /** The table sized the tail for "+ Add column": the desktop strip of a grid with column state. */
13
+ showAddColumn?: boolean;
14
+ checkbox?: ReactNode;
15
+ columns: ListColumn<Row>[];
16
+ columnManager: ListColumnsConfig | null;
17
+ gridTemplate: string;
18
+ minWidth: string;
19
+ sort?: GridSortState;
20
+ selectValues: Record<string, string[]>;
21
+ optionColors?: ListOptionColorOverrides;
22
+ onOptionColorChange?: (key: string, value: string, color: ListSelectColor | null) => void;
23
+ dateStyles?: ListDateStyleOverrides;
24
+ onDateStyleChange?: (key: string, style: ListDateStyle) => void;
25
+ durationStyles?: ListDurationStyleOverrides;
26
+ onDurationStyleChange?: (key: string, style: ListDurationStyle) => void;
27
+ numberFormats?: ListNumberFormatOverrides;
28
+ onNumberFormatChange?: (key: string, patch: {
29
+ decimals?: number | null;
30
+ currency?: string;
31
+ }) => void;
32
+ showTimeOverrides?: ListShowTimeOverrides;
33
+ onShowTimeChange?: (key: string, show: boolean) => void;
34
+ percentDisplays?: ListPercentDisplayOverrides;
35
+ onPercentDisplayChange?: (key: string, display: PercentDisplay) => void;
36
+ columnStateEnabled: boolean;
37
+ /** Workspace list config — the read-only indicator reads its `readOnly`. */
38
+ listConfig?: ListSettingsConfig;
39
+ /** The view's group, for the header menu's Group by / Ungroup row. */
40
+ groupBy?: GridGroupByState;
41
+ resizingId: string | null;
42
+ startResize: (column: ListColumn<Row>, event: React.PointerEvent<HTMLElement>) => void;
43
+ moveResize: (event: React.PointerEvent<HTMLElement>) => void;
44
+ endResize: () => void;
45
+ resetColumnWidth: (column: ListColumn<Row>) => void;
46
+ hideColumn: (column: ListColumn<Row>) => void;
47
+ moveColumn: (column: ListColumn<Row>, direction: -1 | 1) => void;
48
+ headerDrag: HeaderDrag;
49
+ registerHeader: (element: HTMLElement | null) => (() => void) | undefined;
50
+ /** How many LEADING columns are pinned to the left edge (0 = nothing). */
51
+ frozenCount?: number;
52
+ /** Sticky `left` for the frozen column at visible index i — a calc() over the
53
+ * width vars, so live resize re-lays the frozen stack without React. */
54
+ frozenLeft?: (i: number) => string;
55
+ viewBacked?: boolean;
56
+ /** The host's rules and slots, passed on from the grid's props (grid-table-props). */
57
+ formatsWritable?: boolean;
58
+ renderAddColumn?: (columns: ListColumnsConfig) => ReactNode;
59
+ renderColumnMenuRows?: (fieldKey: string, close: () => void) => ReactNode;
60
+ }): import("react/jsx-runtime").JSX.Element;
61
+ export {};
@@ -0,0 +1,37 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { cx } from "../../internal/cx.js";
4
+ import { columnHideable } from "../../model/column-state.js";
5
+ import { fieldKeyOf } from "../../model/view-rules.js";
6
+ import { GridFrozenShadow } from "./GridCellOutline.js";
7
+ import { GridRailSpacer } from "./checks.js";
8
+ import { GridAddColumn } from "./GridAddColumn.js";
9
+ import { GridColumnMenu, gridColumnMenuEnabled, } from "./GridColumnMenu.js";
10
+ import { GridResizeHandle } from "./GridResizeHandle.js";
11
+ import { GRID_BLEED, GRID_CONTENT_PAD, GRID_HEADER_BG, GRID_HEADER_BG_FROZEN, GRID_HEADER_BG_FROZEN_HOVER, } from "./grid-styles.js";
12
+ import { useViews } from "../../provider/context.js";
13
+ import { gridColumnGlyph } from "./column-glyph.js";
14
+ import { columnPlacedByView } from "../../model/column-capabilities.js";
15
+ export function GridHeader({ inline, showAddColumn = false, checkbox, columns, columnManager, gridTemplate, minWidth, sort, selectValues, optionColors, onOptionColorChange, dateStyles, onDateStyleChange, durationStyles, onDurationStyleChange, numberFormats, onNumberFormatChange, showTimeOverrides, onShowTimeChange, percentDisplays, onPercentDisplayChange, columnStateEnabled, listConfig, groupBy, resizingId, startResize, moveResize, endResize, resetColumnWidth, hideColumn, moveColumn, headerDrag, registerHeader, frozenCount = 0, frozenLeft, viewBacked = false, formatsWritable, renderAddColumn, renderColumnMenuRows, }) {
16
+ const { icons, components, messages } = useViews();
17
+ const addColumn = columnManager && showAddColumn
18
+ ? renderAddColumn?.(columnManager) || _jsx(GridAddColumn, { columns: columnManager })
19
+ : null;
20
+ const cells = (_jsxs(_Fragment, { children: [checkbox ?? _jsx(GridRailSpacer, { selecting: false, bordered: true }), columns.map((column, index) => {
21
+ const canMove = columnStateEnabled && (!viewBacked || columnPlacedByView(column));
22
+ const canHide = canMove && columnHideable(column) && columns.length > 1;
23
+ const menuEnabled = gridColumnMenuEnabled(column);
24
+ const frozen = index < frozenCount && !!frozenLeft;
25
+ const cell = (_jsxs("div", { "data-slot": "vk-grid-header-cell", "data-headcell": column.id, style: {
26
+ ...headerDrag.cellStyle(column.id, index),
27
+ ...(frozen ? { left: frozenLeft(index) } : null),
28
+ }, onPointerDown: headerDrag.onCellPointerDown(column.id, index), onPointerMove: headerDrag.onCellPointerMove, onPointerUp: headerDrag.onCellPointerUp, onPointerCancel: headerDrag.onCellPointerCancel, onClickCapture: headerDrag.onCellClickCapture, className: cx("flex h-(--vk-head-h) min-w-0 select-none items-center gap-1.5 overflow-hidden whitespace-nowrap border-b border-(color:--vk-border-subtle) px-(--vk-px) text-(length:--vk-head-text) text-(color:--vk-fg-subtle)", !frozen && "hover:bg-(color:--vk-hovered)", column.align === "center" && "justify-center", menuEnabled ? "cursor-pointer" : "cursor-default", "translate-x-(--vk-drag-shift,0px)", frozen ? cx("sticky z-7", GRID_HEADER_BG_FROZEN, GRID_HEADER_BG_FROZEN_HOVER) : "relative"), children: [gridColumnGlyph({ icons, AppIcon: components.AppIcon }, column, "h-(--vk-head-glyph) w-(--vk-head-glyph) shrink-0 opacity-70"), column.header ? _jsx("span", { className: "truncate", children: column.header }) : null, columnStateEnabled && (_jsx(GridResizeHandle, { active: resizingId === column.id, onResizeStart: (event) => startResize(column, event), onResizeMove: moveResize, onResizeEnd: endResize, onReset: () => resetColumnWidth(column) }))] }, column.id));
29
+ if (!menuEnabled)
30
+ return cell;
31
+ return (_jsx(GridColumnMenu, { column: column, values: selectValues[column.id] ?? [], viewBacked: viewBacked, sort: sort, groupBy: groupBy, optionColors: optionColors?.[fieldKeyOf(column)], onOptionColorChange: onOptionColorChange, dateStyle: dateStyles?.[fieldKeyOf(column)], onDateStyleChange: onDateStyleChange, durationStyle: durationStyles?.[fieldKeyOf(column)], onDurationStyleChange: onDurationStyleChange, numberFormat: numberFormats?.[fieldKeyOf(column)], onNumberFormatChange: onNumberFormatChange, showTime: showTimeOverrides?.[fieldKeyOf(column)] ?? column.format?.withTime ?? false, onShowTimeChange: column.type === "datetime" ? onShowTimeChange : undefined, percentDisplay: percentDisplays?.[fieldKeyOf(column)], onPercentDisplayChange: onPercentDisplayChange, onMoveLeft: canMove && index > 0 ? () => moveColumn(column, -1) : undefined, onMoveRight: canMove && index < columns.length - 1 ? () => moveColumn(column, 1) : undefined, onHide: canHide ? () => hideColumn(column) : undefined, formatsWritable: formatsWritable, renderColumnMenuRows: renderColumnMenuRows, children: cell }, column.id));
32
+ }), _jsxs("div", { "data-slot": "vk-grid-tail", className: cx("flex h-(--vk-head-h) min-w-0 items-center gap-2 border-b border-(color:--vk-border-subtle)", addColumn ? "pl-0" : "pl-(--vk-px)"), children: [listConfig?.readOnly && (_jsxs("span", { title: messages({ key: "views.grid.read-only-why" }), className: cx("inline-flex shrink-0 items-center gap-1 whitespace-nowrap text-(length:--vk-head-text) text-(color:--vk-fg-subtle)", !!addColumn && "pl-(--vk-px)"), children: [_jsx(icons.lock, { className: "h-3 w-3" }), messages({ key: "views.grid.read-only" })] })), addColumn && _jsx("div", { className: "flex h-full min-w-0 flex-1 items-stretch", children: addColumn })] })] }));
33
+ if (inline) {
34
+ return (_jsx("div", { "data-slot": "vk-grid-header", className: cx("group/gridhead grid", GRID_CONTENT_PAD), style: { gridTemplateColumns: gridTemplate, minWidth }, children: cells }));
35
+ }
36
+ return (_jsxs("div", { className: cx("group/gridhead relative", GRID_HEADER_BG, GRID_BLEED), children: [_jsx("div", { ref: registerHeader, className: "overflow-x-hidden", children: _jsx("div", { "data-slot": "vk-grid-header", className: cx("grid", GRID_CONTENT_PAD), style: { gridTemplateColumns: gridTemplate, minWidth }, children: cells }) }), _jsx(GridFrozenShadow, {})] }));
37
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * The GRID's long-text panel — reading and editing a paragraph in ONE surface.
3
+ *
4
+ * A `format.long` text is a paragraph, and a paragraph in a 37px cell is one
5
+ * clipped line with no way in. So editing it does not swap the cell for a
6
+ * one-line input: it opens a panel ON the cell (top-left on the cell's
7
+ * top-left, the column's width) holding the whole value in a textarea, the
8
+ * caret at the end — Attio's model. Inspection is the same panel with the
9
+ * textarea read-only: the value is selectable, copyable, and never written.
10
+ *
11
+ * Anchored like the select and date editors: the cell's own content stays on
12
+ * screen behind the popover, `useAnchoredEditSession` owns the one-answer
13
+ * guard and the exit gap, and Radix owns the viewport — with no room below
14
+ * the panel opens above the cell.
15
+ *
16
+ * Keys are a paragraph's: Enter is a newline; ⌘-Enter commits and advances;
17
+ * Tab commits and moves; Escape cancels; an outside click commits. The host
18
+ * grid's click-away listener clears the cell's focus after that commit.
19
+ */
20
+ export declare function GridLongTextEditor({ initial, seed, readOnly, markdown, onCommit, onCancel, onTab, onEnter, }: {
21
+ /** The stored value the session opens on ("" when unset). */
22
+ initial: string;
23
+ /** Type-to-replace: the character that opened this editor replaces the value. */
24
+ seed?: string;
25
+ /** Inspection: the panel shows the value, selectable, and never commits. */
26
+ readOnly?: boolean;
27
+ /** Markdown keeps its first line's indent: it is tidied only at its edges
28
+ * (`normalizeMarkdown`), where plain long text is trimmed. */
29
+ markdown?: boolean;
30
+ onCommit: (value: string) => void;
31
+ onCancel: () => void;
32
+ /** Commit happened via Tab — move to the next cell in reading order. */
33
+ onTab?: (backwards: boolean) => void;
34
+ /** Commit happened via ⌘-Enter — advance one row down. */
35
+ onEnter?: () => void;
36
+ }): import("react/jsx-runtime").JSX.Element;