@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
package/CHANGELOG.md ADDED
@@ -0,0 +1,615 @@
1
+ # Changelog
2
+
3
+ All notable changes to `@viewkitjs/views`. `0.x`: the API may change between minor versions.
4
+
5
+ ## [Unreleased]
6
+
7
+ ## [0.2.0] — 2026-10-31
8
+
9
+ The grid's rendering, behind its own door, `@viewkitjs/views/grid`, and the package's documentation in `docs/`.
10
+ It needs `@viewkitjs/fields` 0.9.
11
+
12
+ ### For an adapter
13
+
14
+ - Messages: five keys are new, `views.menus.row-delete-failed`, `views.grid.paste-other-currency`,
15
+ `views.grid.paste-ambiguous-option`, `views.grid.paste-skipped` and `views.grid.fill-skipped`, and one is gone,
16
+ `views.grid.paste-failed`. A catalog that words its own messages adds the new ones and drops the old one, which
17
+ `ViewsMessage`, a closed union, no longer holds; one that leaves a key out reads it in the package's English.
18
+ Each is worded in its own line, here or under Changed.
19
+
20
+ - A new message, `views.menus.row-delete-failed` "Failed to delete the row": the plain row menu's error toast when
21
+ the delete your `onDelete` ran rejects. A catalog that leaves it out gets the English.
22
+ - The grid stops its sticky header and its group headers under `--vk-pinned-top`, the height of what your surface
23
+ pins above it (a tab strip, a toolbar), read as `0px` when you declare none: declare it where you pin something
24
+ over a grid. The grid read `--drawer-pinned-top` before: an app that set it for the grid sets `--vk-pinned-top`.
25
+ - A new, optional port, `confirm({ message, confirmLabel, subject, destructive })`, resolving to whether the person
26
+ said yes. The plain row menu's Delete asks it, `message` worded by `views.menus.row-delete-confirm`,
27
+ `confirmLabel` by `views.menus.row-delete`, and `subject` the host's `deleteLabel`. Hand your own dialog through it
28
+ to keep the plain row menu; hand nothing and Delete asks the browser's own confirm, as in 0.1.0. A rejection or a
29
+ throw counts as no.
30
+ - `Menu`: a group marked `disabled` reaches your `Menu` with every row under it marked `disabled`. Draw each row by
31
+ its own flag; nothing else is needed.
32
+ - Four slots stay as they are, and the handling in "Writing an adapter" is the contract's answer: `Menu`'s anchor (the
33
+ menu library's root, positioner and popup), `Popover`'s `chrome: "menu"` (your menu surface laid over the card, no
34
+ inset), `Command.Input`'s `chrome: "bare"` (the command library's own input) and `Sheet`'s `snap` (map it onto your
35
+ snap points, or ignore it).
36
+ - Now said, with nothing to change for an adapter that already does it: `Popover`'s `chrome: "menu"` has no card
37
+ width (it is as wide as its list); `Command.Item`'s `chosen` (you colour the item, the package's row inside draws
38
+ the check, so hide your copy's own tick); and `AppIcon` (it draws on the first paint: a static record of your icons,
39
+ never icons loaded on demand).
40
+ - `Command.Input`: the place editor focuses its country and region search through the input's `ref`, with
41
+ `preventScroll`, no longer through `autoFocus`. Forward `ref` to the input, as the contract already asks.
42
+ - `Popover`: an editor opened with `initialFocus={false}` takes its own focus with `preventScroll`, so a popup that
43
+ places itself after mounting no longer jumps the page. An editor's popover positioned `fixed` only to hide that
44
+ jump can go back to your library's default.
45
+ - `Command.Input`: the grid's Add column search focuses through the input's `ref`, with `preventScroll`, no longer
46
+ through `autoFocus`, and its popover opens with `initialFocus={false}`. Nothing in the package passes `autoFocus`
47
+ any more, so a popover positioned `fixed` only to hide the opening jump can go back to your library's default for
48
+ the whole grid.
49
+ - `Row`'s `opens`: your row says a dialog opens beside it, `aria-haspopup="dialog"` with `aria-expanded` from
50
+ `open`. The flyout is the components map's `Popover`, a dialog of plain rows, not a menu, and a row that said
51
+ `menu` had a screen reader announce a menu it never found.
52
+ - A list's CSV export of a money column writes the figure the column shows, in its reading. A column that binds its own
53
+ raw read wrote the stored amount before.
54
+
55
+ ### Added
56
+
57
+ - The `confirm` port: an app keeps the plain row menu and asks before a delete in its own dialog. `useViews().ports`
58
+ always carries one (`ViewsResolvedPorts`), the browser's where the app handed none.
59
+ - The grid, at `@viewkitjs/views/grid`: `GridTable` with its props, `useGridTablePrefs`, its group and figure types,
60
+ and the helpers a host's binding shares with it (the commit types, a column's filter values, a cell's copy text and
61
+ edit baseline, the title link's class).
62
+ - A column's menu is drawn with the package's own pieces: it opens the components map's `Popover` in the
63
+ `vk-grid-column-menu` slot, its rows are the `Row` atom, its colours the `Tag` atom, and each knob's choices fly out
64
+ of a `vk-grid-flyout` popover beside the row, one open at a time, after a short hover or at once on a tap.
65
+ - The package ships its documentation in `docs/`, starting at `docs/index.md`: getting started, from install to a grid
66
+ drawn with your own primitives; a guide per concept (the provider, ports, atoms, the display, editors and the edit
67
+ session, columns, cells, selection and the grid); and a reference per door naming every export. Every example in the
68
+ docs and the README is compiled and run against the packed package before each release.
69
+ - The contract states the four shapes of a value (stored, draft, commit, display) per type, what an edit core never
70
+ does, and how a `command` field is edited by verbs on every surface.
71
+ - `@viewkitjs/views/grid` exports `GridSortState`, `GridGroupSortOption`, `GridCellCommitFn` and `GridCellsCommitFn`
72
+ by name, the types an app writes the grid's `sort`, `sortOptions`, `onCellCommit` and `onCellsCommit` against. Before,
73
+ they were reachable only as `GridTableProps<Row>["sort"]` and the like, which still works.
74
+ - The grid draws every slot the contract names, so a skin reaches each part through `data-slot`: `vk-grid-header`
75
+ and `vk-grid-header-cell`, `vk-grid-row` and `vk-grid-cell`, `vk-grid-group` and `vk-grid-group-header`,
76
+ `vk-grid-footer` and `vk-grid-footer-cell`, `vk-grid-rail`, `vk-grid-tail` (the right tail of the header, each
77
+ row and the footer: a row's ⋯, the header's + Add column), `vk-grid-editor` (an inline editor, or
78
+ the popup of an anchored one), `vk-grid-outline` (the focused cell's ring and the range's edges) and
79
+ `vk-grid-resize-handle`. Before: only the frame, the row's ⋯ and the menus carried one.
80
+
81
+ ### Changed
82
+
83
+ - The peer `@viewkitjs/fields` is `^0.9.0` (was `^0.8.0`): install fields 0.9 beside views 0.2. Under `0.x` a
84
+ `^0.9.0` peer accepts no 0.10.
85
+
86
+ - The grid's layout variables are `--vk-*` names (the contract's Tokens, which now lists `--vk-tail-pl` too): a skin or
87
+ an app that set a `--grid-*` name, `--grid-tail-pl` included, sets its `--vk-*` name.
88
+ - The grid's own variables are `--vk-drag-shift` and `--vk-col-w-<id>` (were `--drag-shift` and `--gw-<id>`), which
89
+ the contract names internal: an app neither sets nor reads them.
90
+ - The grid counts a press as inside when it lands in the grid's React tree, not by your popover's wrapper: a press
91
+ inside a popup outside the grid's tree (a toolbar's menu, a select in a window the app opens) now clears the
92
+ focused cell, and a press on an overlay drawn inside the grid's root (a selection bar and its sheet, a
93
+ confirmation window) now keeps it.
94
+ - The grid turns mouse drag-select off itself; it no longer depends on what wraps a row.
95
+ - `densityStyle` writes `--vk-row-py`, `--vk-head-mb` and `--vk-row-gap` (were `--dt-row-py`, `--dt-head-mb` and
96
+ `--dt-row-gap`), now the contract's Tokens, with the same values at every density: an app whose rows look read or
97
+ set an old name reads or sets its `--vk-*` name.
98
+ - `ListFilterCapability` is `{ mode: "unavailable"; reason: string }`, the one answer `buildColumnFilters` reads. Its
99
+ `server` and `local` members built a column exactly as no entry: an app that hands `capabilities` to
100
+ `buildColumnFilters` drops those entries and keeps its unavailable ones.
101
+ - `formatMoney` moves from the package's root to `@viewkitjs/views/display`, beside `formatNumberValue`, and writes an
102
+ amount as a money cell does: through the presentation's `number` for the viewer, instead of in the `en-US` locale
103
+ whatever the viewer's. It takes the options a cell gets (`presentation`, `viewer`) as a fourth argument; with none it
104
+ reads in the default presentation and the neutral conventions (`en-GB`), so a dollar amount there reads
105
+ "US$109.00", not "$109.00". To keep your app's look, hand it your presentation and viewer:
106
+
107
+ ```ts
108
+ // before
109
+ import { formatMoney } from "@viewkitjs/views";
110
+ formatMoney(1234.5, "EUR"); // "€1,234.50", on every page
111
+
112
+ // after
113
+ import { formatMoney } from "@viewkitjs/views/display";
114
+ formatMoney(1234.5, "EUR", 2, { presentation, viewer }); // "1.234,50 EUR" for a Romanian viewer
115
+ ```
116
+ - Two doc comments your editor shows on hover say what their code does: `normalizeGroupSummary` returns `[]`, a bare
117
+ group name, for a value it cannot read, never the default, and `setDurationStyle` always writes the column's entry,
118
+ never dropping one.
119
+ - The contract describes `vk-grid-rail` as the checkbox lane: the group caret is drawn in `vk-grid-group-header`.
120
+ - The grid's doc comments, which your editor shows on hover, say what the code does in the library's own terms: none
121
+ names a tracker key, a plan or a path in another app any more, and a check in the package holds it.
122
+ - A paste or a fill of a money cell into a record that holds another currency is refused, with the message
123
+ `views.grid.paste-other-currency` ("This record is in EUR"); the copied currency is carried only into a record with
124
+ none of its own. Before, the copied currency was carried over, re-denominating the record. An app that words its own
125
+ messages adds this one.
126
+ - `readMoneyColumn` sets the column's `editAccessor` to the row's own amount, in every reading, keeping one the column
127
+ already has.
128
+ - A pasted label two options share is refused with the new message `views.grid.paste-ambiguous-option`, instead of
129
+ landing on one of them; an app that words its own messages adds it.
130
+ - A paste or a fill that refuses cells says why. One toast per reason it met, with how many cells that reason refused:
131
+ `views.grid.paste-skipped` and `views.grid.fill-skipped`, each `{ count, reason }` ("2 cells weren't filled: This
132
+ record is in EUR"), the `reason` one of the paste's own refusals in your words. A paste or a fill of one cell still
133
+ says the reason alone. Before, any refusal of more than one cell said only `views.grid.paste-failed` ("Failed to
134
+ paste 2 cells"), a fill included. The cells that fit are written, as before.
135
+ - `views.grid.paste-failed` is removed. An app that words its own messages replaces it with the two new keys:
136
+
137
+ ```ts
138
+ // before
139
+ case "views.grid.paste-failed":
140
+ return `${message.values.count} cells could not be pasted`;
141
+
142
+ // after
143
+ case "views.grid.paste-skipped":
144
+ return `${message.values.count} cells were not pasted: ${message.values.reason}`;
145
+ case "views.grid.fill-skipped":
146
+ return `${message.values.count} cells were not filled: ${message.values.reason}`;
147
+ ```
148
+
149
+ ### Fixed
150
+
151
+ - A menu group marked `disabled` disables its rows in every adapter: before, each row followed only its own flag, so a
152
+ disabled group's rows could still be pressed.
153
+ - The plain row menu's Delete, confirmed, tells the person when the delete fails: a rejecting `onDelete` calls the
154
+ toast port's `error` with `views.menus.row-delete-failed`. Before: the rejection went unhandled and the row stayed
155
+ with no word.
156
+ - An email, one or several, draws as plain text when the host's own slot owns the click (`slotOwnsClick`), as a
157
+ link, a domain and a phone already did, so the click reaches the host's row. Without it, each address is still a
158
+ `mailto:` link.
159
+ - A percent on Bar keeps a track you can read: the track never narrows below 1.5rem, and the figure's slot is the
160
+ figure's own width (it counted a whole character each for the point and the sign). A narrow percent column on Bar
161
+ shows the figure alone. Before: a column too narrow for both crushed a 100% bar to a dot.
162
+ - A grid copy of a phone, one or several, and a CSV export of its column through `cellCopyText`, write each phone as
163
+ `phoneText` writes it, in its international form, the main one first. Before: `[object Object]` for each.
164
+ - Opening an editor leaves the page where it was: the chips, name, number, range, value list and place editors, the
165
+ place editor's searches and the grid's long-text editor take focus with `preventScroll`. Before: on a popover that
166
+ places itself after mounting, the page jumped to where the popup sat before it was placed.
167
+ - A place and a phone drawn with no viewer (`renderFieldValue(field, value)`) take the provider's conventions, as a
168
+ date, a number, a percent and an amount do: the country is named in the app's language, a phone from the app's
169
+ region is written nationally, and its extension in the app's words. Before: the country was named in English
170
+ and the phone written internationally, so the place display and the place editor beside it disagreed.
171
+ - A percent on Bar never loses its leading digits: a figure wider than its box spills into the cell's padding, and
172
+ past that it is cut at its end with an ellipsis ("100.…"). At a 60px column and the default density a whole
173
+ figure fits at 0 decimals; 1 and 2 need a wider column. Before: the figure was cut at its front, and a 100.0 % row read "00.0 %".
174
+ - A selected range shows the values inside it: its tint drew over every cell's value, the anchor's included, so the
175
+ cells read as empty while the range was held. The tint now sits under the value; its colour, its boundary, the
176
+ anchor's ring and the fill dot are unchanged.
177
+ - Opening the grid's "+ Add column" can no longer scroll the page: its search took focus before a popover that
178
+ places itself after mounting had moved it to its anchor.
179
+ - The contract counts eighteen doors, as the package declares, and the usage skill names all of them.
180
+ - The contract says what the `viewPrefs` port is read for: no view reads it; the grid's preferences come in through
181
+ `useGridTablePrefs`, from wherever your app keeps them.
182
+ - The grid's triggers say what they open: the header cell that opens a column's menu and the footer cell that opens
183
+ its figure picker take `role="button"` and `aria-haspopup="dialog"`, and the group band's ⋯ says `dialog` too.
184
+ Before, each said `menu` over a popover that is a dialog.
185
+ - A money column read in another currency now edits the amount each row stores, in the row's own currency: its
186
+ editor opens on that amount, and undo, cut, Delete, Clear, copy, paste and fill carry it. Before, they carried the
187
+ converted figure beside the row's own currency, so an undo or a paste could store the converted figure as an amount
188
+ in the row's currency. The cell, its total, sorting, grouping and filtering still read the converted figure.
189
+ - Undoing a write into an empty number, percent or money cell empties it again. Before, it wrote 0. A fill from an
190
+ empty cell no longer writes 0 either: it empties a column that can be emptied, and skips one that can't.
191
+ - A copy of a number, percent or money cell pasted inside the grid lands as the number it copied, whatever the
192
+ conventions read a decimal point as.
193
+ - A select, status or multiselect cell copies as the labels it shows, alone, in a range and in an export, instead of
194
+ its stored keys. A pasted label lands on its option, from the grid or from a spreadsheet; a pasted key still lands
195
+ too, an exact match winning over one that differs only in case, and a copy pasted inside the grid lands on the exact
196
+ option it copied.
197
+ - With Wrap columns on, the selection rail beside a row that runs to several lines draws its line at the row's bottom
198
+ and its backing over the whole row, instead of at a one-line row's height. The checkbox stays level with the first
199
+ line.
200
+ - A fill of a money, percent or date-and-time cell no longer draws "[object Object]" in the filled cells until its
201
+ save lands, nor warns "Value was changed elsewhere" when it does. It paints nothing early, as a paste and the editor
202
+ already did: each filled cell keeps its figure until the save's refetch draws the new one. A fill of a relation, a
203
+ range or a list of several values does the same. A text, a select or a yes/no fill still shows at once.
204
+
205
+ ### Removed
206
+
207
+ - The filter capability split and its wire format, which nothing sent: `validateFilterCapabilities`,
208
+ `ListFilterCapabilityError`, `splitFilterRules`, `GridFilterSplit`, `GridPushdownSupport`, `serializeFilters`,
209
+ `effectiveDecimals`, `gridFilterSupport`, `ListWireRule`, `ListWireRuleState` and `GRID_FILTER_PARAM_MAX_BYTES`. A
210
+ list filters its rules in the browser, or evaluates its view at its source; the source registry
211
+ (`defineGridFilters` and its types) and `ListFilterCapability`, which the Filter panel reads, stay.
212
+ - `auditGridFilters`, a filter registry drift check for the filter split, which nothing called. The source registry
213
+ (`defineGridFilters` and its types) stays.
214
+ - `renderAs` on `FilterConfigBase`, which nothing read. `countsAsFilter` stays.
215
+ - `onListConfigChange` and `listWritable` on `GridTableProps`, which the grid never read. The grid reads `listConfig`
216
+ only; a settings surface of your own changes it and hands the grid the new value.
217
+
218
+ ## [0.1.0] — 2026-10-30
219
+
220
+ The first publish: the rendering contract, the provider, the atoms, the model, the field display, the editors,
221
+ cells and selection. The grid's rendering follows in 0.2.0.
222
+
223
+ ### For an adapter
224
+
225
+ Everything an adapter written against the candidate of 27 October 2026 (the first to prove the components map on
226
+ Base UI) changes or adds for 0.1.0, slot by slot. Each line names the slot, what changed, and what the adapter does.
227
+ An adapter that hands partial `atoms` and keeps the package's English needs only the components map, the icons and
228
+ the messages it translates.
229
+
230
+ #### The components map (`ViewsComponents`)
231
+
232
+ - `Checkbox`: `checked: boolean | "indeterminate"` → `checked: boolean` plus `indeterminate?: boolean`, Base UI's
233
+ shape. Hand both to your checkbox; a press on a partial box that isn't `checked` hands `true`.
234
+ - `Menu`: an item's `children` is a group drawn in place under its label, never a flyout. Drop any submenu and the
235
+ hidden trigger it needed; draw a group label and its rows. A group row is a label: its own `onSelect`, `href` and
236
+ `checked` are ignored.
237
+ - `Menu`: a checkable row (`checked` set) closes the menu like any row. A Base UI adapter keeps `closeOnClick` on its
238
+ checkbox items.
239
+ - `Popover`: `onOutsidePress`'s `event` is the pointer press, also when the focus it moves would close the popup.
240
+ An adapter whose popover closes on that focus first keeps the last press and asks the veto with it. Focus leaving
241
+ by keyboard (a Tab out) closes without asking.
242
+ - `Popover`: a popup handed `panelData` carrying `data-slot="vk-grid-column-menu"` or `data-slot="vk-grid-flyout"`
243
+ sets it on the popup element, as for every `panelData`; dress those popups by their slot where your menus read
244
+ tighter than your card popover. A flyout sits above the menu it opened from, as any later popup does. The grid
245
+ opens them from 0.2.0.
246
+ - `Calendar` takes `locale` (required, BCP 47), the conventions' locale. Hand your calendar the matching
247
+ date-library locale (month and weekday names, the week's first day), or ignore it; a week-start lookup of your own
248
+ can go.
249
+ - `ViewsCloseReason` adds `close-press` and `swipe`. Pass your library's through instead of mapping them to `none`.
250
+ - Stacking: the package's popups carry no `z-90` or `z-95`; your popup layer decides. Drop any containment worked
251
+ around them.
252
+
253
+ #### The atoms (`ViewsAtoms`)
254
+
255
+ Two new atoms. An app that hands partial `atoms` needs nothing; one whose atoms object is typed as the whole
256
+ `ViewsAtoms` adds both entries (or spreads `DEFAULT_VIEWS_ATOMS`).
257
+
258
+ - `PlatformMark` (`ViewsPlatformMarkProps`, `{ platform, className }`): a link's platform, drawn before it. The
259
+ default draws nothing, so a link looks plain. Swap it to draw your own mark by `platform.key` into
260
+ `data-slot="vk-platform"` (state `data-platform`, the key).
261
+ - `RowMenu` (`ViewsRowMenuProps`, `ViewsRowMenuItem`): the row's right-click menu. The default runs without a swap:
262
+ the components map's `Menu` at the pointer, opened by a right-click or the row's ⋯ (`data-slot="vk-grid-row-more"`),
263
+ wrapped in `data-slot="vk-row-menu"`, its Delete asking the browser's own confirm
264
+ (`views.menus.row-delete-confirm`); a long-press on a phone opens nothing. Swap it whole for your own (a dialog
265
+ before a delete, a long-press). The grid draws it from 0.2.0.
266
+ - `Row` and `RowContent` take `detail`, and `Row` takes `opens` and `open`. The default draws all three. A swapped
267
+ `Row` draws `detail` at its right edge in the subtle colour (a chosen row draws it in the brand colour and no
268
+ check); `opens` sets `aria-haspopup="menu"` and `aria-expanded` from `open`; `open` draws your pressed ground and
269
+ sets `data-open` (a new state, beside `data-chosen`, `data-disabled`, `data-muted`, `data-checked`).
270
+
271
+ #### The icons (`ViewsIcons`)
272
+
273
+ `ViewsIcons` is a full record, so an adapter maps every new name: ten.
274
+
275
+ - Field types: `domain`, `name`.
276
+ - A row's menu: `open` (Open page), `selectRow` (Select or Deselect).
277
+ - The grid's menus: `moveLeft`, `moveRight`, `group`, `clearSort`, `sortRowsUp`, `sortRowsDown`. `sortRowsUp` and
278
+ `sortRowsDown` are a menu's verbs, sorting the rows by a column; `sortAsc` and `sortDesc` stay the mark a sorted
279
+ header wears.
280
+
281
+ #### The slots
282
+
283
+ - `data-slot="vk-grid-flyout"`: a flyout a menu row opens beside its menu (see `Popover`).
284
+ - `data-slot="vk-grid-row-more"`: the row's ⋯ itself, which opens the row's menu.
285
+ - `data-slot="vk-row-menu"` and `data-slot="vk-platform"`: the default `RowMenu` and `PlatformMark`.
286
+
287
+ #### The messages (`ViewsMessage`)
288
+
289
+ One changed and 118 new, each with its English (`resolveViewsMessage` answers any key a catalog leaves out). A value
290
+ in `{ }` is interpolated.
291
+
292
+ - Changed: `views.display.boolean`'s `values.value` is `"true"` or `"false"` as text, not a boolean, so a catalog's
293
+ `select` reads it. Drop the conversion in your resolver, and compare `value === "true"`: the text `"false"` is
294
+ truthy.
295
+ - The name editor: `views.editors.name-given` "Given name", `views.editors.name-family` "Family name",
296
+ `views.editors.name-full` "Full name".
297
+ - The value list editor: `views.editors.values-add` "Add", `views.editors.values-label` "Label",
298
+ `views.editors.values-main` "Main", `views.editors.values-make-main` `{ value }` "Make {value} the main one",
299
+ `views.editors.values-remove` `{ value }` "Remove {value}".
300
+ - The place editor: `views.editors.place-country` "Country", `views.editors.place-country-search` "Search
301
+ countries", `views.editors.place-change-country` "Change country", `views.editors.place-region-search` "Search",
302
+ `views.editors.place-line1` "Address line 1", `views.editors.place-line2` "Address line 2",
303
+ `views.editors.place-region` "Region", `views.editors.place-required` `{ label }` "{label} *"; a country's own
304
+ words (`placeWordKey(kind, word)`): regions `views.editors.place-region-area` "Area", `-county` "County",
305
+ `-department` "Department", `-district` "District", `-do-si` "Do/Si", `-emirate` "Emirate", `-island` "Island",
306
+ `-oblast` "Oblast", `-parish` "Parish", `-prefecture` "Prefecture", `-province` "Province", `-state` "State";
307
+ cities `views.editors.place-city-city` "City", `-district` "District", `-post-town` "Post town", `-suburb`
308
+ "Suburb"; postal codes `views.editors.place-postal-eircode` "Eircode", `-pin` "PIN code", `-postal` "Postal
309
+ code", `-zip` "ZIP code".
310
+ - A panel's part row: `views.menus.part-row` `{ field, part }` "{field} · {part}".
311
+ - A phone: `views.display.phone-extension` `{ extension }` "ext. {extension}", `views.display.phone-as-typed` "Not
312
+ yet in international form".
313
+ - The grid's 79 (its menus, rows, header, footer, toasts and paste refusals), listed with their English under Added,
314
+ "The grid's words are message keys", `views.grid.add-column` "Add column" (the header's last cell) among them.
315
+ The grid draws them from 0.2.0; a catalog that words them now is ready.
316
+
317
+ #### The docs
318
+
319
+ - `docs/install.md`'s `messages` example scopes the translator to `views` and strips the `views.` prefix;
320
+ `docs/contract.md` gains "Writing an adapter", for the slots a Base UI adapter fills around its copies.
321
+
322
+ ### Added
323
+
324
+ - `RowMenu`, the row's right-click menu, among the atoms (`ViewsRowMenuProps`, `ViewsRowMenuItem`). Its default
325
+ draws the components map's `Menu` at the pointer, opened by a right-click or the row's ⋯
326
+ (`data-slot="vk-grid-row-more"`): Open page, the cell's Copy, Cut, Paste and Clear with their hints, Select or
327
+ Deselect, the host's verbs, and Delete, which asks the browser's own confirm (`views.menus.row-delete-confirm`)
328
+ before deleting. A row picked within 300 ms of the opening right-click runs nothing; a long-press on a phone opens
329
+ nothing. An app with its own row menu swaps it whole. Two icon names, `open` and `selectRow`.
330
+ - The grid's words are message keys: its menus, rows, header, footer, toasts and paste refusals, the figure names
331
+ and the refusals the package words, each with its English as before, so an app's `messages` words the whole grid
332
+ and nothing changes in English. `aggregateLabel(kind, messages?)` names a figure (`LIST_AGGREGATE_LABELS` stays,
333
+ in English); `gridClearRefusal`, `columnClearRefusal`, `columnEditRefusal` and `gridEditRefusal` take the resolver
334
+ last, and `gridNormalizeWrite` takes it in its options as `messages`; each defaults to `resolveViewsMessage`. 79
335
+ new keys, for an app's translator to word, with today's English (a value in `{ }` is interpolated; one listed as
336
+ choices is text, for a catalog's `select`):
337
+ - A column's menu: `views.menus.sort-asc` "Sort ascending", `views.menus.sort-desc` "Sort descending",
338
+ `views.menus.sort-clear` "Clear sort", `views.menus.group-by` `{ field }` "Group by {field}",
339
+ `views.menus.ungroup` "Ungroup", `views.menus.move-left` "Move left", `views.menus.move-right` "Move right",
340
+ `views.menus.hide-column` "Hide from view", `views.menus.format` "Format", `views.menus.date-style` `{ style }`
341
+ (`short` "Short", `long` "Long", `numeric` "Numeric", `relative` "Relative"), `views.menus.show-time` "Show
342
+ time", `views.menus.duration-style` `{ style }` (`adaptive` "Adaptive", `clock` "Clock", `units` "Units"),
343
+ `views.menus.decimals` "Decimals", `views.menus.automatic` "Automatic", `views.menus.currency` "Currency",
344
+ `views.menus.percent-display` "Display", `views.menus.percent-display-option` `{ display }` (`text` "Number",
345
+ `bar` "Bar", `ring` "Ring"), `views.menus.colour` `{ colour }` (`gray` "Gray", `blue` "Blue", `green` "Green",
346
+ `amber` "Amber", `red` "Red", `purple` "Purple", `pink` "Pink", `teal` "Teal"), `views.menus.colours-reset`
347
+ "Reset colors".
348
+ - A group's menu: `views.menus.group-options` "Group options", `views.menus.group-sort` "Sort rows",
349
+ `views.menus.search` "Search", `views.menus.group-show` "Show", `views.menus.group-count` "Count",
350
+ `views.menus.group-hide` "Hide group".
351
+ - "+ Add column": `views.grid.add-column` "Add column" (the header's last cell), `views.menus.add-column-search`
352
+ "Search columns…", `views.menus.add-column-no-match` `{ query }` "No column matches “{query}”.",
353
+ `views.menus.add-column-all-shown` "Every column is shown.".
354
+ - A row's menu: `views.menus.copy` "Copy", `views.menus.cut` "Cut", `views.menus.paste` "Paste",
355
+ `views.menus.clear` "Clear", `views.menus.edit` "Edit"; and the plain row menu's, worded now and drawn once it
356
+ ships: `views.menus.row-open` "Open page", `views.menus.row-select` `{ selected }` (`"false"` "Select", `"true"`
357
+ "Deselect"), `views.menus.row-delete` "Delete", `views.menus.row-delete-confirm` "Delete this row?".
358
+ - The footer: `views.grid.figure` `{ kind }` (`none` "None", `sum` "Sum", `avg` "Avg", `min` "Min", `max` "Max",
359
+ `count` "Count", `filled` "Filled", `unique` "Unique", `ratio` "Ratio"), `views.grid.figure-pick` "Calculate".
360
+ - The body and header: `views.grid.loading` "Loading rows", `views.grid.select-row` "Select row",
361
+ `views.grid.select-group` "Select group", `views.grid.select-all` "Select all", `views.grid.row-menu` "Row
362
+ menu", `views.grid.group-expand` "Expand group", `views.grid.group-collapse` "Collapse group",
363
+ `views.grid.change-value` "Change value", `views.grid.value` "Value", `views.grid.edit-value` "Edit value",
364
+ `views.grid.read-only` "Read-only", `views.grid.read-only-why` "Locked by workspace settings — this list is
365
+ read-only for everyone".
366
+ - Refusals: `views.grid.locked` `{ field }` "{field} is locked by workspace settings", `views.grid.not-clearable`
367
+ "This field can't be emptied", `views.grid.computed` `{ from }` "Computed from {from}",
368
+ `views.grid.cell-read-only` "Cell is read-only", `views.grid.clear-none` "Nothing in this selection can be
369
+ emptied — the fields are required", `views.grid.write-not-list` "Not a list of values",
370
+ `views.grid.write-not-boolean` "Not a yes/no value", `views.grid.write-marker` "This marker can only be cleared
371
+ here", `views.grid.write-not-email` "Not an email address", `views.grid.write-not-url` "Not a web address —
372
+ include http:// or https://", `views.grid.write-not-link` "Not a link", `views.grid.write-not-linkable` "Not one
373
+ of the linkable records".
374
+ - A paste: `views.grid.paste-refused` "Can't paste into this column", `views.grid.paste-empty` "Nothing to paste",
375
+ `views.grid.paste-not-number` "Not a number", `views.grid.paste-not-duration` "Not a duration — try 90s or 2m
376
+ 30s", `views.grid.paste-not-date` "Not a date", `views.grid.paste-not-option` `{ value }` "“{value}” is not an
377
+ option here", `views.grid.paste-pick` `{ value }` "“{value}” can't be pasted here — pick it from the list",
378
+ `views.grid.paste-not-linkable` `{ value }` "“{value}” is not linkable here", `views.grid.paste-not-range` "Not
379
+ a range — try 11–50, 200+ or up to 50", `views.grid.paste-failed` `{ count }` "Failed to paste {count} cell" (one)
380
+ or "… cells" (more).
381
+ - Warnings: `views.grid.changed-elsewhere` `{ field }` "{field} was changed elsewhere",
382
+ `views.grid.changed-elsewhere-cells` `{ count }` "{count} cells were changed elsewhere", `views.grid.saved-value`
383
+ "Showing the saved value.", `views.grid.saved-values` "Showing the saved values.", `views.grid.row-left` "Failed
384
+ to save the change: the row left the list while you were editing".
385
+ - `ListColumnsConfig` and `ListColumnItem`: a view's columns with what may be done to them (shown or hidden,
386
+ reordered, reset), the list a grid's "+ Add column" offers. A host's own richer column config may extend it.
387
+ - Several emails, phones, links or domains draw as their main value and a count ("ana@acme.ro +1"), each value's
388
+ label beside it behind the count; a phone the way its country writes it. A plain list draws as items, the first
389
+ main. `MultiValueCell` takes `details`, one word per value drawn in its popover.
390
+ - `@viewkitjs/views/editors/value-list`: `ValueListEditor` and `ValueListEditorHandle`. A row per value, with its
391
+ label, a main mark and a remove, and an Add row; each value is read by its type's own commit rule (a phone in the
392
+ host's `region`, else the conventions'), its reason said under the row. It commits the whole list once, the main
393
+ one first, as `{ value, label, main }` items; Escape discards and an untouched close writes nothing. Tab walks
394
+ each row's main mark, value, label and remove, then Add, and Enter or Space presses a mark or a remove. Five words:
395
+ `views.editors.values-add`, `views.editors.values-label`, `views.editors.values-main`,
396
+ `views.editors.values-make-main` and `views.editors.values-remove`.
397
+ - A column of several values mounts it: `GridEditorId` gains `values`, and `gridEditorKind` answers it for a
398
+ `multiple` email, phone, url or domain column. `gridPasteKind(col)`: a `multiple` column pastes as a list (outside
399
+ text splits on commas, a link's or a domain's only on a line break or a comma and a space so an address keeps its
400
+ own commas, each value read by the field), every other column as its type says. `FieldBinding.labels`
401
+ (`false`): a row that keeps only the values offers no label box; `columnFrom` copies it to `ListColumn.labels`, and
402
+ `checkBinding` refuses it on a field holding one value.
403
+
404
+ - `@viewkitjs/views/editors/location`: `LocationEditor` asks for the country first, then shows only that country's
405
+ parts in its own order, with its own words (County, State, ZIP code) and the parts it asks for marked, never
406
+ refused. Where the country has a region list, a picked region stores its name and its ISO 3166-2 code; the list
407
+ loads when the editor lands on that country (`loadRegions`, `@viewkitjs/fields/places`). A field limited to some
408
+ parts edits only those, and never loses one its country's format has no place for. Picking another country clears
409
+ the region and its code. `EDIT_CORES.location` is it. 27 new `views.editors.place-*` message keys, and
410
+ `placeWordKey(kind, word)` for the word a country's format names (`docs/contract.md`). A place's whole value
411
+ (`wrap: "full"`) is written in its country's order.
412
+ - A domain (`@viewkitjs/fields`' `domain` type) draws as a link to `https://` it, labelled as it is kept, with no
413
+ platform mark; it edits, filters and pastes as text, and a grid write is cleaned by the field's commit. A new icon
414
+ name, `domain`: an app's icons map adds its glyph.
415
+ - A url draws its platform before the link (`linkPlatform`, read with the provider's conventions, so an app's own
416
+ platforms show too) through a new atom, `PlatformMark` (`ViewsPlatformMarkProps`, `{ platform, className }`).
417
+ Its default draws nothing (see Changed). The package ships no brand art, so an app swaps in its own marks by
418
+ the platform's key, drawn into `data-slot="vk-platform"`. An app whose atoms map is typed as the whole `ViewsAtoms` adds the entry
419
+ (`DEFAULT_VIEWS_ATOMS.PlatformMark` keeps the default). A url drawn outside a provider draws its link with no
420
+ mark.
421
+ - A name draws its full name, else its given and family names, else the host's words for an empty one:
422
+ `DisplayOptions.nameFallback`, or a column's `nameFallback(row)`; it may be a record's title.
423
+ `@viewkitjs/views/editors/name`: `NameEditor`, three boxes, given, family and full; once a part is edited the full
424
+ box follows the parts until a person types in it, and an editor closed untouched writes nothing. A name column
425
+ edits in the `name` editor (`GridEditorId`), filters as text across its parts, pastes a text as its full name,
426
+ and totals by its text. The Filter panel keeps a rule on one part of a value when it edits the column's own rule.
427
+ - A Related records row's far relation, user or actor offers its far records by name: its target says
428
+ which far fields its host names (`RelationFilterTarget.named`), and `buildRelationFilters` takes `farValues`, the
429
+ host's values keyed by path (`farPathOf(relationKey, farKey)`, joined by `FAR_PATH_SEPARATOR`), asked when the row
430
+ opens. `useOpenValuesContext()` reads the nearest `OpenValuesProvider` whole. Without either, the row stays greyed.
431
+ - An engine run's actor wears the automation glyph.
432
+ - A place is a column: `columnFrom` makes one, read-only, with no sort, no group, no card zone and no paste, listed
433
+ in Filter but inert (it refused one, "location has no generic grid cell"). `renderLocation` draws a place's city
434
+ and country (`locationShort`), and the whole place on one line when the host asks for the whole value
435
+ (`wrap: "full"`, `locationText`); the country is named in the viewer's language. A footer's Filled and Unique read
436
+ a place by its whole text.
437
+ - `@viewkitjs/views/editors/open-values`: `OpenValuesProvider`, `useOpenValues(field)` and `offeredValues`. An app
438
+ hands an open field's values (what its records hold) to every editor of it; the hook asks for a field's values once
439
+ when its editor mounts, and reads none for a closed field or with no provider.
440
+ - `ChipsEditor`'s Add row comes after the matches, Enter picks the first match, the list loops, and a typed value
441
+ differing only in case from an offered one is that one, as `SelectEditor`'s creatable panel does.
442
+ - `bindFields` binds a worked-out name that names its rename (`defineFields({ rename })`) as the field it renames:
443
+ the name's own read shows it, the stored field's edit read opens its editor and the stored field's write saves it,
444
+ so a list's cell and a drawer's row rename the record through one declaration. While the stored field is empty the
445
+ editor opens on the name shown, and that name handed back unchanged reaches the stored field's write as its own
446
+ empty value. The name's own spec may not bind an edit read.
447
+ - `renderSelect` draws an open select's value as its own label. `SelectEditor` takes `creatable`: a search, and a
448
+ row after the matches that uses the typed text (`editor.use-value`) when no option's value is it, ignoring case.
449
+ Enter picks the first match; the list loops, so ArrowUp from it reaches the row.
450
+ - The command root takes `loop`: the arrows wrap from the last item to the first and back.
451
+ - `FilterConfigBase.onOpen`: a Filter row's detail opened, so a host may ask for what it offers.
452
+ `buildColumnFilters` takes `knownValues` and `onValuesWanted`: an open select or multiselect column offers the
453
+ values its host knows first, then those on screen, and its row's `onOpen` asks for them.
454
+ - The actor display: a chip with a member's avatar, or the glyph for an automation (`automation`), an
455
+ API key (`apiKey`) or the system (`system`). `ICON_NAMES` gains seven: those three and a glyph per
456
+ new type (`actor`, `rich_text`, `range`, `lookup`); an app's `ViewsIcons` is a full record and adds
457
+ all seven.
458
+ - Rich text: one line in a cell, the plain lines when wrapped, and the app's renderer in a drawer,
459
+ folded past 160px with Show more. A new component, `Markdown` (the app's markdown renderer), and two
460
+ messages, `views.display.show-more` and `views.display.show-less`.
461
+ - Range: drawn as "11–50" with its unit and period; a two-box editor (`@viewkitjs/views/editors/range`,
462
+ a new subpath, its boxes worded by `views.editors.range-low` and `views.editors.range-high`, a `seed`
463
+ for type-to-replace); a range
464
+ filter (`FilterConfigRange`, `isRangeFilter`) with presets as quick picks. `GridEditorId`,
465
+ `ListFilterEditor` and `GridPasteKind` gain `range`: a paste reads "11–50", "200+" or "up to 50".
466
+ - Lookup: drawn as its far field (`presentedDef`); no editor.
467
+ - A many relation draws its lead link first. `RelationCandidate.kind`: what a pick on a list of several
468
+ kinds stores. `checkBinding` refuses a writable binding of a relation that stores refs: the relation
469
+ editors commit a bare id.
470
+ - A breakdown: a segmented bar per option or a sparkline per time bucket, with its headline. A footer
471
+ totals the headline.
472
+ - A number's or percent's `format.bands` tint its figure with the status colours (`--vk-success`,
473
+ `--vk-warning`, `--vk-danger`); a band wins over the sign.
474
+ - An option's icon draws in its badge, its tag and the picker; `ViewsTagProps.leading`;
475
+ `PickerOption.icon`.
476
+ - A title whose identity is a figure or a moment draws through its field; `renderIdentityValue` on
477
+ `/cells`.
478
+ - Two atoms for the waits: `Loading` (the list reloading, or more rows arriving) and `LoadMore` (how a
479
+ list asks for its next page), each with a plain default an app swaps.
480
+ - `--vk-gutter` (`VK_OPTIONAL_LAYOUT`): the page's side padding, which the grid's rows line up with;
481
+ optional, `0px` without it.
482
+ - The components map grows by three optional props: the popover's `style`, the collapse's
483
+ `clipClassName` and the checkbox's `partialTone`. The toast port gains `warning`, and the icons gain
484
+ `caretRight`.
485
+ - An adapter that hands a full toast port adds `toast.warning`; one that builds a full `ViewsAtoms`
486
+ object adds `Loading` and `LoadMore` (or spreads `DEFAULT_VIEWS_ATOMS`). Atoms passed to the provider
487
+ as a partial override need nothing. The components map requires `Markdown` (the app's markdown
488
+ renderer), and the icons the seven new names.
489
+ - `@viewkitjs/views/cells`, moved from the portal: the typed cell (`renderTypedCellValue`), whose
490
+ command menu and relation destination are the app's atoms, and the column-shaped string formatters,
491
+ which take their viewer from the caller (`useCellFormat` reads the provider's).
492
+ - `@viewkitjs/views/selection`, moved from the portal: `useListSelection` (its haptics through the
493
+ provider's port), the row checkbox (the components map's), drag-select and the row-click rules.
494
+ - The app's own pieces are atoms too: `CommandMenu` (a command cell's verb menu; the default is the
495
+ components map's `Menu`) and `RelationLink` (where a relation chip goes; the default goes nowhere).
496
+ The checkbox's `onCheckedChange` hands `{ event }` as its second argument.
497
+ - `@viewkitjs/views/editors/session` (`useAnchoredEditSession`, `EDITOR_EXIT_MS`), and the host's
498
+ verb-menu types (`FieldMenus`, `FieldRowMenuItem`) at the root door, moved from the portal.
499
+ - `AppIcon` joins the components map: the app's icon component by the app's own names.
500
+ - `ViewsPopoverProps` gains `alignOffset`, `initialFocus`, `onOutsidePress` and `onEscape`; `ViewsMenuItem` gains `shortcut` and `href`.
501
+ - The components map grows for the editors: the popover's `chrome` (`panel` or `menu`), `onPanelClick` and `panelData`; the command root's `shouldFilter` and `filter`, its input's `ref`, `onKeyDown` and `chrome` (`search` or `bare`), a class on its empty state and groups; the calendar's controlled `month`, `captionLayout` and `startMonth`/`endMonth`; the tooltip's `align` and class. Every addition is optional.
502
+ - The atoms: `Row`, `RowContent`, `TickBox`, `StatusBadge`, `StatusMarker` and `Tag`, each a default
503
+ drawn from the app's theme (`DEFAULT_VIEWS_ATOMS`), swapped one at a time through the provider's
504
+ `atoms`. The contract names them, their slots and states, and the optional tokens the defaults read.
505
+ - The package's own messages: a closed list (`VIEWS_MESSAGE_KEYS`), the English resolver
506
+ `resolveViewsMessage`, and the provider's `messages`.
507
+ - The `List` atom (the inset a run of rows sits in), and a row's `size` (`compact` or `regular`) and
508
+ `wrap`. A command item takes `chosen`. The display's words are message keys under
509
+ `views.display.*`, and the rendering reads two more optional tokens, `--description-foreground`
510
+ and `--input-placeholder`.
511
+ - `@viewkitjs/views/display`: the field display, moved from the portal — `renderFieldValue` and one
512
+ renderer per storage type, drawn through the atoms, the components map and the icons; the string
513
+ formatters; `viewerFrom`. The provider takes an optional `presentation`, a function of the
514
+ package's defaults (so the app's provider imports none of the display). The display's words are
515
+ `views.display.*` keys, a span behind now is fields' `time.ago`, and nothing reads the runtime's
516
+ locale or zone.
517
+ - The field editors, moved from the portal: `@viewkitjs/views/editors` (`EDIT_CORES`, `hasEditCore`)
518
+ and one door per editor — `/editors/select`, `/relation`, `/number`, `/date`, `/chips` — drawn
519
+ through the components map (the command list, the popover, the calendar), the atoms and the icons.
520
+ An editor's words default to the provider's conventions.
521
+ - The rest intent on `/selection`: `useRestIntent(onRest, accepts?)` runs `onRest` once a mouse has
522
+ rested on a row's openable part for `REST_INTENT_MS` (100 ms), so a record's read starts before the
523
+ click. Once per visit; nothing when the pointer moves off first, with a button held, or for a finger.
524
+ - A list's panels can offer one part of a value as a row of its own, off by default: `parts: true` on
525
+ `buildColumnFilters`, `rootRulesByColumn`, `withRootRuleState` (new: the tree with its root rules replaced by the
526
+ panel's state, every rule no row can name kept), `sortableColumns` and the new `groupableOrders`. Filter rows
527
+ "Location · Country", "Location · Region", "Location · City" and "Location · Postal code" take a place's inert row;
528
+ "Name · Given name" and "Name · Family name" follow the name's own. The country row lists the host's codes under its
529
+ key, else every country by name (`conventions.locale`). Sort options "Location · City / Region / Country" and "Name ·
530
+ Family name / Given name", and Group dimensions "Location · City / Region / Country", carry `by`
531
+ (`SortableEntry`, `GroupableEntry`). A part row's key is `partKey(columnId, part)` (a sort's or group's,
532
+ `partKey(fieldKey, by)`; `parsePartKey`, `PART_KEY_SEPARATOR`), and `withRootRule` takes a part. Which parts get a
533
+ row: `FILTER_PART_ROWS`, `SORT_PART_ROWS`, `GROUP_PART_ROWS`; their words: `partWord`, `partLabel`, and the keys
534
+ `views.editors.place-country`, `views.editors.place-region`, `views.editors.place-city-city`,
535
+ `views.editors.place-postal-postal` and `views.menus.part-row`. `rowMatchesRules` filters by a part in memory; a
536
+ part rule never pushes down.
537
+ - The `Row` atom takes `detail` (what it says at its right edge: a setting's current choice or a live sample),
538
+ `opens` (it opens a flyout) and `open` (that flyout is up; the state `data-open`). The icon list gains six glyphs
539
+ for the grid's menus: `moveLeft`, `moveRight`, `group`, `clearSort`, `sortRowsUp` and `sortRowsDown` (a menu's
540
+ verbs; `sortAsc` and `sortDesc` stay the mark a sorted header wears). The grid slots gain `vk-grid-flyout`.
541
+
542
+ ### Changed
543
+
544
+ - The default `PlatformMark` draws nothing, so a url looks as a plain link. An app that wants marks swaps in an
545
+ icon per platform key; the platform is still read for filters.
546
+ - A `multiple` column mounts the value list editor and takes a paste and a cleared write, where it mounted no editor.
547
+ - Several values are items, `{ value, label, main }` (fields' Changed). An email list draws its values, the
548
+ main one first; a column's text filter holds when some value matches and a negative one when none does; `columnFrom`
549
+ marks a multiple phone, url or domain `multiple` too, so no single-value editor mounts over a list.
550
+ - `toListFilterRule` maps a rule on one part of a value only when asked (`{ parts: true }`); without it, such a rule
551
+ has no editor. A url's platform rule used to open the whole url's text box, which reads the address, not the
552
+ platform.
553
+ - A phone is its international form, `{ number, extension }` (fields' Changed). It is drawn the way its country writes
554
+ it: `0722 123 456` for a viewer whose conventions name RO (by calling code), `+40 722 123 456` elsewhere, its
555
+ extension after it (`views.display.phone-extension`), dialled by its RFC 3966 link; a phone stored as text is drawn
556
+ as before and flagged (`data-as-typed`, `views.display.phone-as-typed`). A column filter and the footer read it by
557
+ its number. `gridNormalizeWrite` takes the record's country (`{ region }`), and `FieldViewerContext` carries
558
+ `region`. The display imports `@viewkitjs/fields/phone`.
559
+ - A group header can show every figure, not one: `ListGroupSummaryPart` was `"count" | "total"`, and now also takes
560
+ `total:<columnId>`. `"total"` stays the list's first figure and each later one is `total:<columnId>`, so a stored
561
+ `["count", "total"]` reads as before. `groupFigurePart(columnId, first)` names a figure's part, `isGroupSummaryPart`
562
+ checks a stored one, and `normalizeGroupSummary` keeps every part it accepts.
563
+ - `renderUrl` links a web address stored without a scheme to `https://` plus it, so a bare host opens the site
564
+ instead of a path on the app, and draws a value of any scheme but http, https and ftp as plain text, no link.
565
+ `webHref` (`@viewkitjs/views/display`) says where a web address goes, or null when it is no link, for an app's own
566
+ links.
567
+ - `sortDirFor` opens a date that looks ahead (`looksAhead`) soonest first.
568
+ - The rendering paints its colours through its own names, `VK_COLOURS` (twenty) and
569
+ `VK_OPTIONAL_COLOURS` (the status and category hues), which the app declares once
570
+ (`docs/install.md`); it names no app variable. `APP_TOKENS` and `APP_OPTIONAL_TOKENS` are removed.
571
+ - The provider's `translate` is replaced by `messages`, a resolver in `@viewkitjs/fields`' shape;
572
+ `ViewsTranslate` is removed and `ViewsMessage` is a closed union.
573
+ - A row in the default tone takes its colour from what it sits in; a node label (a badge) is laid out
574
+ in a row instead of truncated; a muted button row brightens on hover; `aria-selected` rides only
575
+ with a stated role.
576
+ - `withRootRule` leaves a relation rule alone: setting or clearing a column's own filter keeps a
577
+ relation rule that names the same field key, since it asks about the far records, not the column's value.
578
+ - The peer `@viewkitjs/fields` is `^0.8.0`: the display, the editors and the model read what fields
579
+ 0.6.0 to 0.8.0 ship (the name, the full address and its formats, phones, several values, a link's
580
+ platform, the domain, `looksAhead`, the list writers for places and names, a commit's `stored`), beside the
581
+ vocabulary they already drew (actor, rich text, range, lookup, relation rules, open selects, `BoardLaneSpec`).
582
+ Under `0.x` a `^0.8.0` peer accepts no 0.9.
583
+ - An edit of several phones keeps an untouched phone kept as typed. `prepareFieldWrite` hands fields' two gates a
584
+ phone binding's stored value as `stored`, so a phone that comes back as it is stored is kept exactly as stored,
585
+ never read again; `prepareFieldRestore` keeps a restored snapshot's phones the same way, since it was stored once;
586
+ `gridNormalizeWrite` takes `stored` from its caller (`{ stored }`, the cell's value before the edit) and hands it
587
+ on.
588
+ - `columnFrom` marks a column `editable` only when its type has an editor, or is a boolean: a place whose
589
+ field may be edited is no longer `editable`, as no editor opens on one.
590
+
591
+ ### Fixed
592
+
593
+ - A place or a name reached through a many relation (a list of them) draws every value through the several-values
594
+ layout: the first, then "+N", the rest in its popover and all of them on the hover, each place in short (whole
595
+ under `wrap: "full"`) and each name as written. A footer counts the list filled by one written value and unique as
596
+ the set of them. Before: the cell drew nothing and the footer left the row out.
597
+ - A `command` cell of an email, a phone or a domain, one or several, keeps its value a link and puts the verbs on
598
+ the chevron beside it, as a relation, a member and a url already did. Before: the link sat inside the trigger's
599
+ button, and a click on the address followed it instead of opening the verbs.
600
+
601
+ ## [0.0.1] — unpublished
602
+
603
+ The version the workspace link carries; never on npm. The package check requires every packed
604
+ version to have its heading, and this is it.
605
+
606
+ ### Added
607
+
608
+ - The package exists: `@viewkitjs/views`, beside `@viewkitjs/fields` under the one scope. Nothing is
609
+ published yet; the portal consumes it through the workspace link.
610
+ - The rendering contract as the root door: the `vk` prefix, carried by the CSS variables and by the
611
+ grid's slot values (`vk-grid-row`) because both share a global namespace; the grid's states as
612
+ bare `data-*` attributes; the tokens the package owns and the app tokens it reads, the components
613
+ map, the ports, the icon names and the message-key namespaces (`views.*`) — `docs/contract.md`
614
+ and `src/contract.ts`, pinned to each other.
615
+ - The React door: `ViewsProvider`, `useViews`, `NOOP_PORTS`, and the types every adapter implements.
package/LICENSE.md ADDED
@@ -0,0 +1,7 @@
1
+ # ViewKit — licence
2
+
3
+ Copyright © 2026 Sheaf. All rights reserved.
4
+
5
+ This package is proprietary. It is published to the public npm registry for the convenience of installation only. No licence to use, copy, modify, merge, publish, distribute, sublicense or sell this software is granted by its availability there. Use is permitted only under a written agreement with Sheaf.
6
+
7
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.