@viewkitjs/views 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/CHANGELOG.md +767 -1
  2. package/README.md +92 -41
  3. package/dist/atoms/LoadMore.js +11 -1
  4. package/dist/atoms/Row.js +1 -1
  5. package/dist/atoms/RowMenu.d.ts +1 -1
  6. package/dist/atoms/RowMenu.js +20 -6
  7. package/dist/atoms/types.d.ts +4 -4
  8. package/dist/cells/cell-format.d.ts +3 -3
  9. package/dist/cells/cell-title.d.ts +1 -2
  10. package/dist/cells/cell-title.js +2 -2
  11. package/dist/cells/cell-values.js +6 -3
  12. package/dist/contract.d.ts +79 -8
  13. package/dist/contract.js +55 -8
  14. package/dist/display/converted.d.ts +19 -0
  15. package/dist/display/converted.js +12 -0
  16. package/dist/display/format.d.ts +16 -1
  17. package/dist/display/format.js +10 -1
  18. package/dist/display/index.d.ts +2 -1
  19. package/dist/display/index.js +2 -1
  20. package/dist/display/link-click.d.ts +11 -0
  21. package/dist/display/link-click.js +3 -0
  22. package/dist/display/link.js +12 -6
  23. package/dist/display/location.d.ts +4 -3
  24. package/dist/display/location.js +12 -5
  25. package/dist/display/multi-value.d.ts +1 -1
  26. package/dist/display/multi-value.js +1 -1
  27. package/dist/display/options.d.ts +8 -2
  28. package/dist/display/percent.js +10 -3
  29. package/dist/display/phone.d.ts +2 -1
  30. package/dist/display/phone.js +11 -2
  31. package/dist/display/relation.js +1 -1
  32. package/dist/editors/ChipsEditor.d.ts +9 -4
  33. package/dist/editors/ChipsEditor.js +7 -3
  34. package/dist/editors/DateEditor.d.ts +21 -6
  35. package/dist/editors/DateEditor.js +118 -30
  36. package/dist/editors/EditorPanel.d.ts +61 -0
  37. package/dist/editors/EditorPanel.js +54 -0
  38. package/dist/editors/LocationEditor.d.ts +3 -0
  39. package/dist/editors/LocationEditor.js +28 -21
  40. package/dist/editors/NameEditor.d.ts +3 -0
  41. package/dist/editors/NameEditor.js +15 -10
  42. package/dist/editors/NumberEditor.d.ts +3 -0
  43. package/dist/editors/NumberEditor.js +7 -7
  44. package/dist/editors/RangeEditor.d.ts +16 -1
  45. package/dist/editors/RangeEditor.js +22 -6
  46. package/dist/editors/RelationEditor.d.ts +13 -28
  47. package/dist/editors/RelationEditor.js +17 -40
  48. package/dist/editors/RelationSetEditor.d.ts +53 -0
  49. package/dist/editors/RelationSetEditor.js +112 -0
  50. package/dist/editors/SelectEditor.d.ts +21 -3
  51. package/dist/editors/SelectEditor.js +55 -9
  52. package/dist/editors/TextEditor.d.ts +51 -0
  53. package/dist/editors/TextEditor.js +81 -0
  54. package/dist/editors/ValueListEditor.d.ts +5 -2
  55. package/dist/editors/ValueListEditor.js +11 -9
  56. package/dist/editors/edit-cores.d.ts +13 -10
  57. package/dist/editors/edit-cores.js +7 -6
  58. package/dist/editors/edit-session.d.ts +21 -11
  59. package/dist/editors/edit-session.js +19 -5
  60. package/dist/editors/keep-inside.d.ts +12 -0
  61. package/dist/editors/keep-inside.js +20 -0
  62. package/dist/editors/open-value.d.ts +21 -0
  63. package/dist/editors/open-value.js +36 -0
  64. package/dist/editors/open-values.d.ts +4 -0
  65. package/dist/editors/open-values.js +7 -0
  66. package/dist/editors/relation-kinds.d.ts +7 -0
  67. package/dist/editors/relation-kinds.js +21 -0
  68. package/dist/editors/relation-panel.d.ts +69 -0
  69. package/dist/editors/relation-panel.js +40 -0
  70. package/dist/field-row/FieldNoteLine.d.ts +14 -0
  71. package/dist/field-row/FieldNoteLine.js +14 -0
  72. package/dist/field-row/FieldRow.d.ts +73 -0
  73. package/dist/field-row/FieldRow.js +157 -0
  74. package/dist/field-row/FieldRowLane.d.ts +19 -0
  75. package/dist/field-row/FieldRowLane.js +11 -0
  76. package/dist/field-row/editors/RowChipsEditor.d.ts +11 -0
  77. package/dist/field-row/editors/RowChipsEditor.js +25 -0
  78. package/dist/field-row/editors/RowDateEditor.d.ts +16 -0
  79. package/dist/field-row/editors/RowDateEditor.js +18 -0
  80. package/dist/field-row/editors/RowEditor.d.ts +39 -0
  81. package/dist/field-row/editors/RowEditor.js +64 -0
  82. package/dist/field-row/editors/RowNameEditor.d.ts +4 -0
  83. package/dist/field-row/editors/RowNameEditor.js +15 -0
  84. package/dist/field-row/editors/RowNumberEditor.d.ts +12 -0
  85. package/dist/field-row/editors/RowNumberEditor.js +18 -0
  86. package/dist/field-row/editors/RowPlaceEditor.d.ts +8 -0
  87. package/dist/field-row/editors/RowPlaceEditor.js +18 -0
  88. package/dist/field-row/editors/RowRangeEditor.d.ts +4 -0
  89. package/dist/field-row/editors/RowRangeEditor.js +15 -0
  90. package/dist/field-row/editors/RowRelationEditor.d.ts +20 -0
  91. package/dist/field-row/editors/RowRelationEditor.js +77 -0
  92. package/dist/field-row/editors/RowSelectEditor.d.ts +13 -0
  93. package/dist/field-row/editors/RowSelectEditor.js +23 -0
  94. package/dist/field-row/editors/RowTextEditor.d.ts +15 -0
  95. package/dist/field-row/editors/RowTextEditor.js +16 -0
  96. package/dist/field-row/editors/RowValueListEditor.d.ts +4 -0
  97. package/dist/field-row/editors/RowValueListEditor.js +21 -0
  98. package/dist/field-row/editors/host.d.ts +59 -0
  99. package/dist/field-row/editors/host.js +1 -0
  100. package/dist/field-row/editors/row-session.d.ts +49 -0
  101. package/dist/field-row/editors/row-session.js +49 -0
  102. package/dist/field-row/index.d.ts +5 -0
  103. package/dist/field-row/index.js +5 -0
  104. package/dist/field-row/row-target.d.ts +20 -0
  105. package/dist/field-row/row-target.js +3 -0
  106. package/dist/field-row/useFieldWrite.d.ts +45 -0
  107. package/dist/field-row/useFieldWrite.js +190 -0
  108. package/dist/field-row/useRowSettlement.d.ts +33 -0
  109. package/dist/field-row/useRowSettlement.js +23 -0
  110. package/dist/fields/binding.d.ts +7 -2
  111. package/dist/fields/binding.js +13 -6
  112. package/dist/fields/currency.d.ts +0 -10
  113. package/dist/fields/currency.js +0 -14
  114. package/dist/fields/edit-core-types.d.ts +9 -9
  115. package/dist/fields/edit-core-types.js +6 -6
  116. package/dist/fields/money.d.ts +6 -0
  117. package/dist/fields/money.js +11 -0
  118. package/dist/fields/number-edit.d.ts +6 -0
  119. package/dist/fields/number-edit.js +4 -0
  120. package/dist/fields/prepare-write.js +6 -1
  121. package/dist/fields/relation-source-types.d.ts +12 -0
  122. package/dist/fields/write-target.d.ts +50 -0
  123. package/dist/fields/write-target.js +10 -0
  124. package/dist/filters/filter-model.d.ts +0 -1
  125. package/dist/filters/registry.d.ts +3 -36
  126. package/dist/filters/registry.js +0 -38
  127. package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
  128. package/dist/grid/chrome/GridAddColumn.js +29 -0
  129. package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
  130. package/dist/grid/chrome/GridAggregateMenu.js +29 -0
  131. package/dist/grid/chrome/GridCellEditors.d.ts +71 -0
  132. package/dist/grid/chrome/GridCellEditors.js +126 -0
  133. package/dist/grid/chrome/GridCellOutline.d.ts +49 -0
  134. package/dist/grid/chrome/GridCellOutline.js +16 -0
  135. package/dist/grid/chrome/GridChipsEditor.d.ts +38 -0
  136. package/dist/grid/chrome/GridChipsEditor.js +35 -0
  137. package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
  138. package/dist/grid/chrome/GridColumnColorSection.js +40 -0
  139. package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
  140. package/dist/grid/chrome/GridColumnDateSection.js +23 -0
  141. package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
  142. package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
  143. package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
  144. package/dist/grid/chrome/GridColumnMenu.js +103 -0
  145. package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
  146. package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
  147. package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
  148. package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
  149. package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
  150. package/dist/grid/chrome/GridColumnSortSection.js +16 -0
  151. package/dist/grid/chrome/GridDateEditor.d.ts +34 -0
  152. package/dist/grid/chrome/GridDateEditor.js +19 -0
  153. package/dist/grid/chrome/GridFlyout.d.ts +44 -0
  154. package/dist/grid/chrome/GridFlyout.js +80 -0
  155. package/dist/grid/chrome/GridFooter.d.ts +33 -0
  156. package/dist/grid/chrome/GridFooter.js +85 -0
  157. package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
  158. package/dist/grid/chrome/GridGroupMenu.js +64 -0
  159. package/dist/grid/chrome/GridHeader.d.ts +66 -0
  160. package/dist/grid/chrome/GridHeader.js +42 -0
  161. package/dist/grid/chrome/GridLongTextEditor.d.ts +55 -0
  162. package/dist/grid/chrome/GridLongTextEditor.js +69 -0
  163. package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
  164. package/dist/grid/chrome/GridMenuRow.js +15 -0
  165. package/dist/grid/chrome/GridNameEditor.d.ts +24 -0
  166. package/dist/grid/chrome/GridNameEditor.js +21 -0
  167. package/dist/grid/chrome/GridNumberEditor.d.ts +49 -0
  168. package/dist/grid/chrome/GridNumberEditor.js +51 -0
  169. package/dist/grid/chrome/GridPlaceEditor.d.ts +26 -0
  170. package/dist/grid/chrome/GridPlaceEditor.js +22 -0
  171. package/dist/grid/chrome/GridRangeEditor.d.ts +30 -0
  172. package/dist/grid/chrome/GridRangeEditor.js +21 -0
  173. package/dist/grid/chrome/GridRelationEditor.d.ts +45 -0
  174. package/dist/grid/chrome/GridRelationEditor.js +92 -0
  175. package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
  176. package/dist/grid/chrome/GridResizeHandle.js +19 -0
  177. package/dist/grid/chrome/GridRow.d.ts +31 -0
  178. package/dist/grid/chrome/GridRow.js +179 -0
  179. package/dist/grid/chrome/GridRowActions.d.ts +32 -0
  180. package/dist/grid/chrome/GridRowActions.js +25 -0
  181. package/dist/grid/chrome/GridRowCells.d.ts +4 -0
  182. package/dist/grid/chrome/GridRowCells.js +128 -0
  183. package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
  184. package/dist/grid/chrome/GridRowGlyph.js +13 -0
  185. package/dist/grid/chrome/GridSelectEditor.d.ts +33 -0
  186. package/dist/grid/chrome/GridSelectEditor.js +43 -0
  187. package/dist/grid/chrome/GridStructure.d.ts +47 -0
  188. package/dist/grid/chrome/GridStructure.js +41 -0
  189. package/dist/grid/chrome/GridTable.d.ts +4 -0
  190. package/dist/grid/chrome/GridTable.js +192 -0
  191. package/dist/grid/chrome/GridTableSurface.d.ts +52 -0
  192. package/dist/grid/chrome/GridTableSurface.js +15 -0
  193. package/dist/grid/chrome/GridTextEditor.d.ts +45 -0
  194. package/dist/grid/chrome/GridTextEditor.js +38 -0
  195. package/dist/grid/chrome/GridValueListEditor.d.ts +30 -0
  196. package/dist/grid/chrome/GridValueListEditor.js +19 -0
  197. package/dist/grid/chrome/StuckMarker.d.ts +16 -0
  198. package/dist/grid/chrome/StuckMarker.js +34 -0
  199. package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
  200. package/dist/grid/chrome/cell-clipboard.js +28 -0
  201. package/dist/grid/chrome/cell-cut-off.d.ts +11 -0
  202. package/dist/grid/chrome/cell-cut-off.js +20 -0
  203. package/dist/grid/chrome/cells.d.ts +21 -0
  204. package/dist/grid/chrome/cells.js +19 -0
  205. package/dist/grid/chrome/checks.d.ts +32 -0
  206. package/dist/grid/chrome/checks.js +32 -0
  207. package/dist/grid/chrome/column-glyph.d.ts +14 -0
  208. package/dist/grid/chrome/column-glyph.js +44 -0
  209. package/dist/grid/chrome/editors.d.ts +9 -0
  210. package/dist/grid/chrome/editors.js +10 -0
  211. package/dist/grid/chrome/grid-cell-classes.d.ts +53 -0
  212. package/dist/grid/chrome/grid-cell-classes.js +32 -0
  213. package/dist/grid/chrome/grid-cell-link.d.ts +13 -0
  214. package/dist/grid/chrome/grid-cell-link.js +9 -0
  215. package/dist/grid/chrome/grid-edit-session.d.ts +63 -0
  216. package/dist/grid/chrome/grid-edit-session.js +118 -0
  217. package/dist/grid/chrome/grid-hover.d.ts +60 -0
  218. package/dist/grid/chrome/grid-hover.js +81 -0
  219. package/dist/grid/chrome/grid-menu-focus.d.ts +43 -0
  220. package/dist/grid/chrome/grid-menu-focus.js +93 -0
  221. package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
  222. package/dist/grid/chrome/grid-menu-search.js +7 -0
  223. package/dist/grid/chrome/grid-row-menu-key.d.ts +15 -0
  224. package/dist/grid/chrome/grid-row-menu-key.js +36 -0
  225. package/dist/grid/chrome/grid-row-props.d.ts +143 -0
  226. package/dist/grid/chrome/grid-row-props.js +1 -0
  227. package/dist/grid/chrome/grid-row-window.d.ts +61 -0
  228. package/dist/grid/chrome/grid-row-window.js +212 -0
  229. package/dist/grid/chrome/grid-scroll-owner.d.ts +38 -0
  230. package/dist/grid/chrome/grid-scroll-owner.js +75 -0
  231. package/dist/grid/chrome/grid-styles.d.ts +40 -0
  232. package/dist/grid/chrome/grid-styles.js +9 -0
  233. package/dist/grid/chrome/grid-table-props.d.ts +172 -0
  234. package/dist/grid/chrome/grid-table-props.js +1 -0
  235. package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
  236. package/dist/grid/chrome/useGridBatchApi.js +35 -0
  237. package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
  238. package/dist/grid/chrome/useGridColumnLayout.js +206 -0
  239. package/dist/grid/chrome/useGridFocus.d.ts +45 -0
  240. package/dist/grid/chrome/useGridFocus.js +122 -0
  241. package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
  242. package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
  243. package/dist/grid/chrome/useGridKeyboard.d.ts +64 -0
  244. package/dist/grid/chrome/useGridKeyboard.js +450 -0
  245. package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
  246. package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
  247. package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
  248. package/dist/grid/chrome/useGridRailReveal.js +67 -0
  249. package/dist/grid/chrome/useGridRangeActions.d.ts +51 -0
  250. package/dist/grid/chrome/useGridRangeActions.js +195 -0
  251. package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
  252. package/dist/grid/chrome/useGridRangeGestures.js +237 -0
  253. package/dist/grid/chrome/useGridRowContextMenu.d.ts +37 -0
  254. package/dist/grid/chrome/useGridRowContextMenu.js +153 -0
  255. package/dist/grid/chrome/useGridScaleStyles.d.ts +3 -0
  256. package/dist/grid/chrome/useGridScaleStyles.js +28 -0
  257. package/dist/grid/chrome/useGridScrollArea.d.ts +21 -0
  258. package/dist/grid/chrome/useGridScrollArea.js +65 -0
  259. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +78 -0
  260. package/dist/grid/chrome/useGridTableInteractionModel.js +249 -0
  261. package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
  262. package/dist/grid/chrome/useGridTableSelection.js +55 -0
  263. package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
  264. package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
  265. package/dist/grid/core/clipboard-model.d.ts +83 -0
  266. package/dist/grid/core/clipboard-model.js +291 -0
  267. package/dist/grid/core/column-values.d.ts +27 -0
  268. package/dist/grid/core/column-values.js +76 -0
  269. package/dist/grid/core/commit-model.d.ts +41 -0
  270. package/dist/grid/core/commit-model.js +3 -0
  271. package/dist/grid/core/coordinates.d.ts +48 -0
  272. package/dist/grid/core/coordinates.js +27 -0
  273. package/dist/grid/core/edge-scroll.d.ts +21 -0
  274. package/dist/grid/core/edge-scroll.js +23 -0
  275. package/dist/grid/core/edit-values.d.ts +9 -0
  276. package/dist/grid/core/edit-values.js +1 -0
  277. package/dist/grid/core/editing-controller.d.ts +60 -0
  278. package/dist/grid/core/editing-controller.js +266 -0
  279. package/dist/grid/core/editing-model.d.ts +87 -0
  280. package/dist/grid/core/editing-model.js +148 -0
  281. package/dist/grid/core/flat-rows.d.ts +35 -0
  282. package/dist/grid/core/flat-rows.js +20 -0
  283. package/dist/grid/core/grid-aria.d.ts +27 -0
  284. package/dist/grid/core/grid-aria.js +39 -0
  285. package/dist/grid/core/grid-focus.d.ts +54 -0
  286. package/dist/grid/core/grid-focus.js +148 -0
  287. package/dist/grid/core/grid-scale.d.ts +14 -0
  288. package/dist/grid/core/grid-scale.js +8 -0
  289. package/dist/grid/core/nav.d.ts +94 -0
  290. package/dist/grid/core/nav.js +92 -0
  291. package/dist/grid/core/pending-reconciliation.d.ts +53 -0
  292. package/dist/grid/core/pending-reconciliation.js +51 -0
  293. package/dist/grid/core/range-model.d.ts +25 -0
  294. package/dist/grid/core/range-model.js +59 -0
  295. package/dist/grid/core/row-window.d.ts +40 -0
  296. package/dist/grid/core/row-window.js +43 -0
  297. package/dist/grid/core/spreadsheet-operations.d.ts +101 -0
  298. package/dist/grid/core/spreadsheet-operations.js +280 -0
  299. package/dist/grid/core/useGridEditing.d.ts +46 -0
  300. package/dist/grid/core/useGridEditing.js +93 -0
  301. package/dist/grid/core/useGridRange.d.ts +20 -0
  302. package/dist/grid/core/useGridRange.js +24 -0
  303. package/dist/grid/core/value-equality.d.ts +54 -0
  304. package/dist/grid/core/value-equality.js +80 -0
  305. package/dist/grid/index.d.ts +18 -0
  306. package/dist/grid/index.js +5 -0
  307. package/dist/grid/useGridTablePrefs.d.ts +49 -0
  308. package/dist/grid/useGridTablePrefs.js +99 -0
  309. package/dist/index.d.ts +1 -1
  310. package/dist/index.js +1 -1
  311. package/dist/internal/viewport.d.ts +3 -0
  312. package/dist/internal/viewport.js +15 -0
  313. package/dist/model/column-capabilities.d.ts +3 -2
  314. package/dist/model/column-capabilities.js +28 -8
  315. package/dist/model/column-from.js +3 -0
  316. package/dist/model/column-inspect.d.ts +10 -2
  317. package/dist/model/column-inspect.js +9 -0
  318. package/dist/model/column-schema.d.ts +6 -1
  319. package/dist/model/column-state.d.ts +1 -1
  320. package/dist/model/column-types.d.ts +3 -1
  321. package/dist/model/column-types.js +1 -1
  322. package/dist/model/density.js +3 -3
  323. package/dist/model/filter-capabilities.d.ts +1 -1
  324. package/dist/model/filter-capabilities.js +1 -1
  325. package/dist/model/index.d.ts +4 -6
  326. package/dist/model/index.js +0 -1
  327. package/dist/model/preferences.d.ts +7 -7
  328. package/dist/model/preferences.js +0 -1
  329. package/dist/model/prefs-buckets.d.ts +0 -1
  330. package/dist/model/prefs-buckets.js +0 -3
  331. package/dist/model/render-count.d.ts +6 -0
  332. package/dist/model/render-count.js +11 -0
  333. package/dist/provider/ViewsProvider.d.ts +6 -2
  334. package/dist/provider/ViewsProvider.js +12 -2
  335. package/dist/provider/components.d.ts +35 -9
  336. package/dist/provider/components.js +4 -2
  337. package/dist/provider/context.d.ts +8 -4
  338. package/dist/provider/desktop.d.ts +9 -0
  339. package/dist/provider/desktop.js +22 -0
  340. package/dist/provider/menu-groups.d.ts +8 -0
  341. package/dist/provider/menu-groups.js +38 -0
  342. package/dist/provider/plain-input.d.ts +8 -0
  343. package/dist/provider/plain-input.js +5 -0
  344. package/dist/provider/ports.d.ts +22 -0
  345. package/dist/provider/ports.js +1 -0
  346. package/dist/react.d.ts +3 -2
  347. package/dist/react.js +1 -0
  348. package/dist/selection/SelectCheckbox.d.ts +3 -1
  349. package/dist/selection/SelectCheckbox.js +2 -2
  350. package/dist/selection/useCheckDragSelect.js +6 -5
  351. package/docs/contract.md +202 -72
  352. package/docs/getting-started.md +250 -0
  353. package/docs/guides/atoms.md +245 -0
  354. package/docs/guides/cells.md +302 -0
  355. package/docs/guides/columns.md +413 -0
  356. package/docs/guides/display.md +204 -0
  357. package/docs/guides/editors.md +462 -0
  358. package/docs/guides/ports.md +246 -0
  359. package/docs/guides/selection.md +270 -0
  360. package/docs/guides/the-grid.md +696 -0
  361. package/docs/guides/the-provider.md +448 -0
  362. package/docs/index.md +52 -0
  363. package/docs/install.md +9 -47
  364. package/docs/reference/cells.md +28 -0
  365. package/docs/reference/display.md +44 -0
  366. package/docs/reference/editors-chips.md +6 -0
  367. package/docs/reference/editors-date.md +6 -0
  368. package/docs/reference/editors-location.md +10 -0
  369. package/docs/reference/editors-name.md +6 -0
  370. package/docs/reference/editors-number.md +11 -0
  371. package/docs/reference/editors-open-values.md +10 -0
  372. package/docs/reference/editors-panel.md +12 -0
  373. package/docs/reference/editors-range.md +6 -0
  374. package/docs/reference/editors-relation.md +12 -0
  375. package/docs/reference/editors-select.md +9 -0
  376. package/docs/reference/editors-session.md +11 -0
  377. package/docs/reference/editors-text.md +9 -0
  378. package/docs/reference/editors-value-list.md +6 -0
  379. package/docs/reference/editors.md +5 -0
  380. package/docs/reference/field-row.md +16 -0
  381. package/docs/reference/grid.md +39 -0
  382. package/docs/reference/react.md +89 -0
  383. package/docs/reference/selection.md +33 -0
  384. package/docs/reference/views.md +622 -0
  385. package/package.json +27 -4
  386. package/skills/views/SKILL.md +20 -5
  387. package/dist/filters/types.d.ts +0 -27
  388. package/dist/filters/types.js +0 -1
  389. package/dist/model/filter-pushdown.d.ts +0 -106
  390. package/dist/model/filter-pushdown.js +0 -147
package/CHANGELOG.md CHANGED
@@ -4,21 +4,787 @@ All notable changes to `@viewkitjs/views`. `0.x`: the API may change between min
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
- The grid's rendering, which ships in 0.2.0.
7
+ ## [0.3.0] — 2026-11-11
8
+
9
+ Two projects in one release. The field editors: every editor closes through one edit session, and on a phone in
10
+ your `Sheet`; one text editor for every kind of text; a save can answer the value your server kept; an optional
11
+ `Input` that every editor's text box draws through; and a record's field row, ready-made, from
12
+ `@viewkitjs/views/field-row`. And the grid: it scrolls inside itself, draws only the rows on screen, is worked by
13
+ keyboard alone, and is read by a screen reader as a grid. It needs `@viewkitjs/fields` 0.10.
14
+
15
+ What an app changes when it takes this version:
16
+
17
+ - **Install `@viewkitjs/fields` 0.10** beside it: the peer is `^0.10.0` (Changed).
18
+ - **The grid needs a box with a height.** It scrolls inside itself, in both directions, so give its container the
19
+ height the page has left; Changed shows a page before and after. Stop declaring `--vk-pinned-top`, and find the
20
+ scroll area by `[data-slot="vk-grid-scroll"]` where you used `data-grid-scroller` (Removed). An adapter's
21
+ `Collapse` crops with `overflow: clip`, never `overflow: hidden`, or the frozen columns stop sticking (For an
22
+ adapter).
23
+ - **Wrapping is gone.** Delete `wrapCells` where you hand it to `GridTable`, any switch that sets `gridWrapCells`,
24
+ `{ wrap: true }` where you hand it to `renderTypedCellValue`, and any CSS of yours that sets or reads
25
+ `--vk-chrome-h`, `--vk-cell-py` or `--vk-tail-py` (Removed).
26
+ - **↓ stops on a group's footer**, then on the next group's bar and its column names, before that group's rows; ↑
27
+ walks the same way back (Changed).
28
+ - **An adapter's `Menu` puts the focus on its first row when it opens**, as its `Popover` already does, and a
29
+ `RowMenu` of your own opens on any `contextmenu` (For an adapter).
30
+ - **A table typed over `EDIT_CORES`** names a host for `text`, `url`, `domain`, `email`, `phone` and `rich_text`,
31
+ where it answered `null` (Changed).
32
+ - **Your grid tests.** The grid's keys listen on the grid, so press them on the focused cell, not on `window`. Below
33
+ your desktop query the first click opens a cell's editor: answer the query in your `matchMedia` stub to keep a
34
+ desktop's clicks. The name's buttons and a pick-list's ▾ are drawn only under the mouse: hover first (Changed).
35
+
36
+ New, and optional: the command list's root takes `defaultValue`, which an adapter hands its command library (cmdk's
37
+ root takes it under that name), and a list that ignores it opens on its first row, as before; a field row's host
38
+ closes with a `RowClosed`; `SelectEditor` takes `focusList`. Eight message keys are new, and an app that words its own
39
+ messages adds them: `views.editors.discard`, `views.editors.save`, `views.editors.open-email`,
40
+ `views.editors.open-phone`, `views.editors.open-link`, `views.grid.clear-required`, `views.display.converted-from`
41
+ and `views.display.as-shown`.
42
+
43
+ Nothing else an app calls changes its signature. What is new is optional, and Changed says what behaves
44
+ differently: among it, a screen between 768px and 1023px wide is now drawn as a phone unless your provider's
45
+ `desktopQuery` says otherwise. The field row, the edit session and the phone's sheet are new since 0.2.0, so a line
46
+ below that fixes or changes one of them describes this release's own work, not a change from 0.2.0.
47
+
48
+ Known in 0.3.0: a date typed into a grid date cell and left by Tab is saved, but the cell stays blank until a reload.
49
+ In Safari, a Tab out of a grid date cell's open editor leaves the selection on that cell, so the next → lands one cell
50
+ short. 0.3.1 fixes both.
51
+
52
+ ### For an adapter
53
+
54
+ - `Popover`: 0.2.0 said a popover positioned `fixed` only to hide the opening jump could go back to your library's
55
+ default. That holds only where your `Command` doesn't scroll as it mounts. The chips, select and relation editors,
56
+ and the grid's Add column and group menu, mount a `Command.Root` with its rows before your popover has placed its
57
+ popup, and a command library that scrolls its selected item into view on mount (cmdk does) scrolls the page
58
+ towards the unplaced popup, which `preventScroll` on the focus can't stop. On such a library, keep the popover
59
+ `fixed`, or stop your `Command` scrolling on mount. The contract's "Writing an adapter" says so.
60
+ - Your `Collapse` now holds the grid's rows and frozen columns inside its clip. The clip must crop without
61
+ scrolling (`overflow: clip`, never `overflow: hidden`), or the frozen columns stop sticking.
62
+ - `Checkbox` is handed `tabIndex` (`-1` in the grid); pass it to the element that takes focus.
63
+ - A `Popover` opened by a key in the grid's column menu or a group's ⋯ menu is asked for `initialFocus`; focus its first row when it is true, as the contract already says.
64
+ - The grid sends the row-menu keys to your `RowMenu` as a `contextmenu` on the cell with no press before it: a `RowMenu` of your own opens on any `contextmenu`.
65
+ - Your `Menu` puts focus on its first row when it opens, as your `Popover` does by default. A menu that gives focus back to nothing when it closes is fine: the grid puts it back on the cell.
66
+ - Hand the command list's root its `defaultValue` (cmdk's root takes it under that name). While no item has that
67
+ value, highlight none, never the first item, which in a relation picker is None. A list that ignores the prop keeps
68
+ the old behaviour: it opens on its first row.
69
+ - Your `Popover` may keep its panel on the page while it plays its exit, and give the focus back to nothing when it leaves: the grid waits for it to go, then puts the focus back on its cell. Focus that a press or a pick moved elsewhere stays there.
70
+ - Your `Command.Input` should name its highlighted item in `aria-activedescendant`, and your `Command.Root` should leave alone an arrow key whose default the input prevented, as cmdk does. The group menu reads the highlight there to hand the arrows on at the list's ends; a list that names none keeps its arrows to itself.
71
+ - The select's None row now reaches your command list with a value of its own, never `""`, and the list asks for its
72
+ opening row through its root's `defaultValue`. A list that ignores `defaultValue` opens on None, and its arrows still
73
+ walk every row.
74
+ - Your `Command.Root` should move its highlight to the first item on Home and the last on End, as cmdk does. The group menu sends them into the search field when the arrows come into the list from below; a list that ignores them keeps its highlight where it was.
75
+ - While your list reloads, it may keep the grid on the page `inert`: the grid waits for the inert to lift before it puts the focus back on its cell.
8
76
 
9
77
  ### Added
10
78
 
79
+ - A grid write can answer what your server kept: `{ status: "confirmed", stored }`, from `onCellCommit`, or as one
80
+ of `onCellsCommit`'s outcomes. Answer it when what was stored isn't what the cell sent (an invisible character
81
+ stripped, a label read as its key, `""` kept as `null`), with the value as your rows read it in that column. The cell
82
+ shows it at once in place of what was typed, ⌘Z keeps its step and restores from it (unless `history` says
83
+ otherwise), and when your rows carry it the cell clears with no "changed elsewhere" warning, for an object such as a
84
+ name too. Until now such a write left the typed value on the cell, or warned that someone else had changed it, and the
85
+ way around it was to reject the write, which lost its undo step. An answer without `stored` behaves as before.
86
+ - `EditorPanel`, from `@viewkitjs/views/editors/panel`: opens an editor as your popover on the desktop and your sheet on the phone, chosen once when the editor opens. On the phone the sheet carries the field's name as its title and a bar with ✕ and ✓: ✕, a swipe and a tap outside change nothing, ✓ closes as done, and a pick in a select saves on its own. A picker always opens the sheet on the phone. A type-in editor stays where the value stands (`inPlace`), and goes into the sheet on the phone only when you pass `sheetOnPhone`. A value your `onAttempt` refuses stays open with its reason under the editor; its children may be a function of the `EditorSurface` it chose, so an in-place host can draw that reason in its own box.
87
+ - An optional `desktopQuery` on `ViewsProvider`, and `DEFAULT_DESKTOP_QUERY` from `@viewkitjs/views/react`: the media query that means a desktop, `(min-width: 1024px)` unless you hand in the one your own shell switches on.
88
+ - The edit session hands back `refusal`: the reason your `onAttempt` gave with `{ accepted: false, reason }`, until the next attempt. Its types `EditSession` and `EditSessionAttempt` are exported.
89
+ - The contract names the panel's slots (`EDITOR_SLOTS`: `vk-editor-panel`, `vk-editor-bar`, `vk-editor-refusal`) and two messages, `views.editors.discard` and `views.editors.save`. An app that words its own messages adds them.
90
+ - `TextEditor`, from `@viewkitjs/views/editors/text`: the one editor for text, link, email, phone, domain, long text and rich text. It trims what was typed (rich text is tidied only at its edges), an unchanged value closes without a save, and each type brings its own phone keyboard (`TEXT_INPUT_TYPE`). A paragraph (`multiline`) takes Enter as a newline and closes on ⌘ or Ctrl Enter. Its single-line box draws through your `Input`, and carries `data-slot="vk-text-editor"`, a new member of `EDITOR_SLOTS`.
91
+ - An optional `Input` in the components map: a single-line text box, `ViewsInputProps`. Every editor's text box draws through it when you pass one: the number, the range, the date and its time, a name's three boxes, a place's parts, a value list's value and label, and the text editor. Without one they draw a plain `<input>`, as before, so nothing you pass today changes. Forward every prop to your element, `ref` included. `chrome` says whether the box sits bare (a grid cell, a panel that frames it: the default) or wears your field's frame (`field`).
92
+ - `OPTIONAL_COMPONENT_NAMES`, beside `COMPONENT_NAMES`: the components you may leave out. `COMPONENT_NAMES` still lists the ones you must hand in.
93
+ - `ViewsResolvedComponents`, from `@viewkitjs/views/react`: the map as `useViews()` hands it on, with `Input` always there.
94
+ - A closed select or status with more than 8 options opens with a search on top that filters its options by
95
+ label; Enter picks the first match, and there is no row to use typed text. 8 or fewer stay a plain list.
96
+ `SELECT_SEARCH_PAST` (from `@viewkitjs/views/editors/select`) is that number.
97
+ - `SelectEditor` takes `seed`, the text its search opens with, and `focusSearch`, which puts the caret in the
98
+ search as it opens. A list with no search ignores both.
99
+ - `region` on a field binding and on a list column: `(row) => string | null | undefined`, the record's country. A
100
+ phone typed or pasted without its country code is read in it: by `prepareFieldWrite`, by the grid's write gate on
101
+ an edit, a paste and a fill, by the grid's phone cell and by its editor of several phones. Absent, the conventions'
102
+ region reads it, as before. `columnFrom` carries a binding's `region` onto its column.
103
+
104
+ ```ts
105
+ bindField(fields.phones, { read: (row) => row.phones, write, region: (row) => row.countryCode });
106
+ ```
107
+
108
+ - `hostOwnsPlainClick` in the display options: an email, phone, url or domain still draws as a link, marked
109
+ `data-cell-link`, but no longer stops its click, so a host that owns the plain click (the grid) can decide.
110
+ - `--vk-scroll-inset-bottom`, a length your app may declare (undeclared, `0px`): how much of the grid's foot you
111
+ cover with something you float there, such as a phone's bottom bar. The grid's scroll area runs underneath it,
112
+ the last row scrolls clear of it, and a cell the keyboard reveals stops above it.
113
+ - The slots `vk-grid-scroll` (the one scroll area), `vk-grid-head` (an ungrouped grid's pinned header) and
114
+ `vk-grid-group-head` (a group's pinned name bar and header row).
115
+ - A plain text or a text name that its cell cuts off opens whole in a box over the cell, on a second click, a
116
+ double-click or Enter: editable where the cell can be written, read-only (selectable, copyable) where it can't. It
117
+ is still a line: Enter saves and moves down, and a newline is written as a space. On a phone the tap opens it whole
118
+ in your `Sheet`.
119
+ - `TextEditor` (`@viewkitjs/views/editors/text`) takes `wraps`: a line shown whole, in a textarea that wraps, where
120
+ Enter closes and a newline is a space. Default `false`, so your editors don't change.
121
+ - `isWholeTextColumn` and `gridTextOpensBox(column, whole)`, from `@viewkitjs/views`: whether a column's text
122
+ opens whole in the box over its cell when the cell cuts it off, and whether an open text cell is drawn in that
123
+ box rather than in the cell, for a grid host of your own.
124
+ - The grid can be worked by keyboard alone. Tab enters it at its focused cell, or at the first cell on screen when none is focused, and every cell takes the browser's own focus, so the arrows, Home and End, Enter, typing, copy, cut, paste and Delete work from there. Tab past the grid's last cell, or Shift+Tab before its first, leaves it.
125
+ - Escape with nothing open still clears the cell, and now also lets go of the grid: the next Tab or Shift+Tab leaves it, and an arrow comes back in where you were.
126
+ - A group collapses and opens by keyboard: ↑ from its column names reaches its bar, where Enter, Space or ← collapse it and Enter, Space or → open it. → on an open bar reaches its ⋯ menu. Collapsing a group with focus inside it moves the focus to its bar.
127
+ - ← from a row's first cell reaches its checkbox, and Space ticks it. The select-all, and a group's box, are reached the same way from the column names.
128
+ - A screen reader reads the grid as a grid, or as a tree grid when it is grouped. Every row is numbered among all of them, whether or not it is drawn: a group's bar, its column names and its footer are rows too, so the total runs a little above the number of records. A cell is read with its column's name, a group's bar with its name, its count and whether it is open, and a grouped record with its place in its group ("3 of 25"). While more rows remain to load, a row reads its number with no total.
129
+ - A sorted column's name says which way it sorts, a ticked row and the cells of a range say they are selected, and a cell that can't be written says it is read-only.
130
+ - A place column is editable in the grid. A `location` column whose field is a place, and whose binding writes it,
131
+ is now `editable` and opens `LocationEditor` (the country first, then that country's parts): in your `Popover`
132
+ under the cell on a desktop, in your `Sheet` on a phone. A place missing a part its country asks for still saves,
133
+ the part marked in the editor; a place emptied where the column can't be emptied keeps the editor open with the
134
+ column's reason; Escape throws the edit away. A paste into a place is still refused. `GRID_TYPE_RULES.location.editor`
135
+ is `"place"`, a new member of `GridEditorId`. A place your binding gives no write, or marks `mutability: "never"`,
136
+ stays read-only as before.
137
+ - `EDITOR_INNER_ESCAPE`, from `@viewkitjs/views/editors/panel`: the attribute an editor puts on an inner list of its
138
+ own while Escape there closes the list rather than the edit. `EditorPanel`'s popover answers `false` to `onEscape`
139
+ for an Escape from inside it, so a popover that hears Escape on the document first (Radix's does) stays open.
140
+ `LocationEditor` carries it on its country and region lists, which close back to the boxes on Escape.
141
+ - In the grid, a select or status column that may be emptied (`clearable`) opens its list with None first, and
142
+ picking None empties the cell; Delete still clears it. A column that can't be emptied shows no None.
143
+ - A letter typed on a select or status cell opens its list already filtered by that letter, when the list has a
144
+ search; a list with no search opens as before.
145
+ - `pickerOptionsFromField` takes `current`, the value your surface holds: it is offered after the options when no
146
+ active option is it (a stray value, or an archived option's), so that surface's list shows it checked.
147
+ - In the grid, Tab in a multiselect's editor saves the set and moves to the next cell, Shift-Tab to the one before.
148
+ Enter still adds the highlighted value and keeps the editor open.
149
+ - `ChipsEditor` takes `creatable` (default true). With `false` it filters what it offers as you type and offers no
150
+ row to add the typed text. `takesNewValues(field)`, from `@viewkitjs/views/editors/open-values`, says which a
151
+ field is: a multiselect whose vocabulary is not `"closed"` takes new values.
152
+ - `ChipsEditor` asks its host to close with `tab` or `shift-tab`; its answer is the same as an outside click's.
153
+ - `RelationEditor` takes `seed`, the text its search opens with, and `focusSearch`, which puts the caret in the search
154
+ as it opens without scrolling. Both are optional; without them it opens as before.
155
+ - A relation's binding may carry `create` (`RelationCellCreate`: `label(query)` and `onCreate(query, link)`). The grid
156
+ pins it under a relation cell's candidates: a click closes the picker and calls `onCreate` with the trimmed query;
157
+ the app opens its own form with it, and calling `link(id, kind?)` once that form saves links the new record to the
158
+ cell as a change of its own, with its own undo. With a static candidate list, the new record must be among the
159
+ candidates before `link` is called, since the grid links only a record its list offers. A member field refuses a
160
+ create row, and so does a binding without a write.
161
+ - `RelationSetEditor` (from `@viewkitjs/views/editors/relation`), the editor of a relation holding several records:
162
+ clicks add and remove records with the list open, the linked records drawn first; a close by a click outside, the
163
+ sheet's ✓, Tab or Shift-Tab answers the whole set as one change, and Escape or the sheet's ✕ throws it away. With
164
+ `lead`, the first link leads, a "Make lead" action marks another, and removing the lead passes it to the next. A
165
+ link keeps the role it was stored with; a new link has none. It answers `RelationDraftLink[]`.
166
+ - The date editor takes three optional props. `dayOnly` is for a calendar-day field: the panel draws no time box,
167
+ commits `YYYY-MM-DD`, and a click on a day saves it and asks your host to close with `pick`. `clearable` ends the
168
+ panel with a Clear row where the date may be empty: a click asks to close with `pick` and commits `""`, the empty
169
+ value your host maps to null (nothing, when there was no date). `seed` opens the date box holding a character typed
170
+ on the cell, the caret after it; Enter saves the date it reads, and a seed that reads no date writes nothing.
171
+ - Today, Tomorrow and Next Monday sit above the calendar, each setting its day as a calendar click does; on a
172
+ datetime the time is kept and the panel stays open. Next Monday on a Monday is the Monday a week on.
173
+ - `NumberEditor` takes `code`: the code of a currency the field fixes, drawn beside the amount while it is typed and
174
+ never part of the commit (a `unit` wins over it). `numberEditCode(field)` reads it from a field: a money field with
175
+ `code: { fixed }` gives its code, every other field none.
176
+ - `RangeEditor` takes `bands` (a range field's `presets`), `bandsAt` and `boxClassName`. The bands list under the two
177
+ boxes, in a small menu by default (`"popover"`) or in the editor's own column (`"below"`) where it already sits in a
178
+ sheet or a panel. A click on a band saves it, read and judged exactly as typed ends are; the boxes stay, so a value
179
+ between bands is still typed. `boxClassName` dresses the box that holds the two inputs.
180
+ - `@viewkitjs/views/field-row`: a record's field row, ready-made. `FieldRow` draws one field of a record as its
181
+ label, its value and, on a click, its type's editor in place: a picker anchored under the value in your
182
+ `Popover` on a desktop and in your `Sheet` on a phone, a typed value in its own box on every width, a boolean from its own control, a `command` field's verbs through your
183
+ `CommandMenu` atom. `useFieldWrite` is the write path behind it: a commit is admitted or refused at once, one
184
+ record's writes run one at a time, each settles on your save's receipt, and a failure rolls back with a retry,
185
+ toasted through your toast port. Build your record's panel around the rows; the row knows no entity.
186
+ - Three optional inputs for what only your app knows: `useFieldWrite`'s `refusalOf` (reads a failed save's own
187
+ sentence, shown on the row and after the toast's failure line) and `timing` (follows each edit to the paint),
188
+ and the row's `kindIcon` (your icon name for a record kind, worn by a relation's candidates).
189
+ - From `@viewkitjs/views` (the model, no React): the shapes a record's writes go through, `EntityWriteTarget`,
190
+ `EntityWriteReceipt`, `FieldWriteAdmission`, `FieldWriteAdmissionGuard`, `LockedResolver`, `FieldNote` and
191
+ `FieldWriteReconciliationRequired`, so a write target and its tests load none of the rendering. The field-row door
192
+ re-exports them.
193
+ - The field row's editors open through the editor panel: a picker (a select, a date, several tags, a relation, several values, a place) opens in your `Popover` on a desktop and in your `Sheet` on a phone, titled with the field's name and carrying its ✕ and ✓, so the row draws with `Sheet` from your provider's components. Typed values (text, a number, money, a range, a name) stay in their own box on every width.
194
+ - Every editor in a field row follows the same three rules: Escape always throws the edit away, a value refused on the spot stays open with its reason, shown once (in the panel, or under the box), and a sheet's swipe or ✕ changes nothing. A retry refused on the spot keeps its line, with the refusal's reason.
195
+ - A relation in a field row saves what its row stores: a bare id, a ref with the picked record's kind where the field stores refs, or the whole set with its lead.
196
+ - A place edits in a field row, in the place editor under the value; an emptied place the field can't take stays open, saying so.
197
+ - A relation holding several records edits in a field row: records are added and removed with the list open, one is marked lead where the field leads by a flag, and the set saves as one change. It opens on the labels the row shows, so a searched relation's linked records read by name.
198
+ - A date field in a field row has no time box, and ends with a Clear row where it may be empty.
199
+ - Several values in a field row read a phone typed without its country code in the record's country (the binding's `region`), and an emptied list the field can't take stays open, saying so.
200
+ - `RowEditorProps.shown`: the row's display value, handed to every host.
201
+ - `ValueListEditor` takes `openLinks`: each stored email, phone, link or domain carries a small open action beside it
202
+ (mail, call or browse). A row typed over, or added, has none until it is saved, so it never opens half an address.
203
+ - Three messages name the action: `views.editors.open-email`, `views.editors.open-phone` and
204
+ `views.editors.open-link` (`{ value }`: "Email {value}", "Call {value}", "Open {value}").
205
+ - In `RelationSetEditor`, Space on a highlighted linked record makes it the lead, as its Make lead action does, while
206
+ the search is empty; with a query typed, Space types. It needs a command list that names its highlighted row by
207
+ `aria-activedescendant` and the row's value by `data-value`, as cmdk does.
208
+ - A money figure shown converted into another currency than its record's own now says so, the same way on every
209
+ surface: it carries ≈, and its title names the currency it was converted from ("Converted from USD"). A grid
210
+ cell, a card, a board, a calendar and the list look all draw it, through `renderTypedCellValue`; a field row
211
+ draws it when its host reads the record in another currency (it hands the converted figure as `value` and that
212
+ currency as `opts.currency`).
213
+ - The money editor opened from such a figure, in the grid, a field row or a card, names it under the record's own
214
+ amount it opens on: "≈ €7,147 as shown". The two read as one value, so nobody "corrects" the stored amount to the
215
+ converted one.
216
+ - `convertedFromOf(column, row)` (from `@viewkitjs/views`): the currency a column's figure was converted from for
217
+ this row, or null. `ConvertedFigure` and `ConversionLine` (from `@viewkitjs/views/display`): the mark and the
218
+ editor's line, for an app's own surface. Two messages word them: `views.display.converted-from` (`{ code }`,
219
+ "Converted from {code}") and `views.display.as-shown` ("as shown").
220
+
221
+ Nothing an app calls changes: each editor still opens on, and saves, the amount in the record's own currency.
222
+ - A row's menu opens from the keyboard. On a focused cell, Shift+F10, the menu key, or ⌘⇧\ (Ctrl+Shift+\ off a Mac, as in Google Sheets) opens the menu a right-click on that cell opens, under the cell, with focus on its first row. Escape or a pick closes it and puts focus back on the cell. Safari may keep ⌘⇧\ for its tab overview; fn+Shift+F10 opens the menu there.
223
+ - The name's actions (`rowActions`) are now rows of the row's menu too, after Select, so Shift+F10, the menu key, ⌘⇧\ (Ctrl+Shift+\ off a Mac) and a right-click reach them, and a screen reader reads them. Before, only a pointer over the row reached them. An action shows there when it gives a glyph, a click and a label for the row.
224
+ - `DateEditor` takes `focusDate`: the date box takes the focus as the panel opens, without scrolling, so the keyboard
225
+ is in the panel. Off by default; leave it off on a phone, whose sheet opens with the keyboard down. A `seed` still
226
+ focuses the box either way.
227
+ - The command list's root takes `defaultValue`: the value of the item highlighted as the list opens.
228
+ - `LocationEditor` takes `chrome` (`"bare"`, the default, or `"field"`), handed to each part's `Input`; `DateEditor`
229
+ takes `fill`, which spans the calendar across its panel.
230
+ - `NameEditor` takes `chrome` (`"bare"`, the default, or `"field"`), handed to each box's `Input`.
231
+ - `SelectEditor` takes `focusList`, for a host that opened it from the keyboard. A plain list (eight options or
232
+ fewer) then puts the focus on the row it holds, or on None when it may be emptied and holds nothing, so an Enter at
233
+ once changes nothing; ↓ and ↑ move the focus between its rows, round at either end, and Enter picks the focused
234
+ row. Off by default: a list opened by a pointer moves no focus, as before. A list with a search ignores it;
235
+ `focusSearch` gives that one the keys.
236
+
237
+ ### Changed
238
+
239
+ - The peer `@viewkitjs/fields` is `^0.10.0` (was `^0.9.0`): install fields 0.10 beside views 0.3. Under `0.x` a
240
+ `^0.10.0` peer accepts no 0.11.
241
+ - Escape always throws the edit away. The edit session answers Escape with a discard without asking the editor, and the date editor discards on Escape where it used to save a changed date, the grid's date cell included.
242
+ - An editor of your own that calls `useAnchoredEditSession` keeps its call as it is: the session only adds `refusal` to what it hands back. Escape throws its edit away too.
243
+ - On a phone, a grid cell's select, status, date, tags, relation, number, money and range editor opens in your `Sheet`, titled with the column's header, with ✕ and ✓. "A phone" is anything below your provider's desktop query, `(min-width: 1024px)` unless you hand in your own. ✕, a swipe, the backdrop and Escape change nothing; ✓ saves; a pick in a select or a relation saves on its own. The value is written once the sheet has slid away. A number or a range typed in the sheet is no longer saved by its box losing focus, so tapping ✕ after typing saves nothing. On the desktop each editor opens where it did before.
244
+ - In a select, status, date, tags, relation, number or range editor, a value the grid refuses on the spot now keeps the editor open with the reason. Before, it closed the editor and said the reason in a toast. These are the refusals your field's own rules make, such as a number below its minimum or a fraction in an integer field. Change the value, or press Escape to throw the edit away. Leave the cell while the reason stands and nothing is written; the reason is said in a toast. On a desktop a number or a range shows the reason under the cell, and a picker under its list. On a phone each shows it in the sheet. A clear, a paste, a fill or the Delete key over cells still says a refusal in a toast, and so do the text, long text, name and list-of-values editors. A write your server refuses rolls the cell back with your message, as before.
245
+ - These editors close through the shared edit session, so they keep its rules: Escape always throws the edit away, a refused value stays open with its reason, and a swiped sheet changes nothing. A picked value still lands after the popover's exit. If the cell is left before then, the value is still written, and the focus stays where it was put.
246
+ - The sheet's panel carries `data-slot="vk-editor-panel"`, and a reason under a number or a range carries `data-slot="vk-editor-refusal"`. `vk-grid-editor` stays on the desktop's popover and on a number or range typed in the cell.
247
+ - `EDIT_CORES` names `TextEditor` for `text`, `url`, `domain`, `email`, `phone` and `rich_text`, where it held `null`, and `hasEditCore` answers `true` for them: it says whether a type has an editor of its own. A table of yours typed over `EDIT_CORES` that answers `null` for one of these now has to name a host for it.
248
+ - The grid's text cell trims what was typed, brings each type's phone keyboard, and on a phone opens in a sheet titled with the column's header, with ✕ and ✓, as long text now does too. ✕ and a swipe change nothing; ✓ saves and closes without moving the selection; the save lands once the sheet has slid away. A phone here is a window narrower than the provider's `desktopQuery`, `(min-width: 1024px)` unless you hand in your own: hand in your shell's own query if you want the sheet only where your shell switches to its phone layout. On a desktop it still types in the cell, and Enter still saves and moves down at once; a cell opened by typing compares against the value the row stored. A value the grid would refuse (an email that isn't one) stays in the cell with its reason under it, and the long-text panel keeps it open with its reason, instead of closing into a toast. Long text closes on Ctrl Enter as well as ⌘ Enter.
249
+ - In the grid, a click on an email, phone, link or domain selects the cell like any other cell, a second click or a
250
+ double-click opens its editor, and on a phone a tap opens it. A ⌘-click (Ctrl-click on Windows) on the value opens
251
+ the link. A value in a cell's `+N` list still opens on a plain click.
252
+ - The grid scrolls inside itself, in both directions, on every screen. Its frame fills the box you give it, and
253
+ each group's name bar and header row stay pinned at the top of the grid's own scroll area until the next group
254
+ pushes them off. Before, your page scrolled the rows and the grid pinned its headers to your page.
255
+ - **Your list page's layout changes once.** Give the grid's container the height the page has left, as a definite
256
+ height or as a flex column. The page itself stops scrolling the grid. Every box between your container and the
257
+ grid passes the height down; `min-height: 0` lets a flex child shrink below its rows.
258
+
259
+ Before (the page scrolls; the toolbar and the grid stack in a page that grows):
260
+
261
+ ```tsx
262
+ <main className="overflow-y-auto">
263
+ <Toolbar />
264
+ <GridTable {...props} />
265
+ </main>
266
+ ```
267
+
268
+ After (the page holds still; the grid fills what the toolbar leaves and scrolls itself):
269
+
270
+ ```tsx
271
+ <main className="flex h-dvh flex-col">
272
+ <Toolbar />
273
+ <div className="flex min-h-0 flex-1 flex-col">
274
+ <GridTable {...props} />
275
+ </div>
276
+ </main>
277
+ ```
278
+
279
+ A container with no height gets a grid that grows to its rows: your page scrolls it, as before, but its
280
+ headers no longer pin.
281
+ - Sideways scrolling is the browser's own: a trackpad, Shift and the wheel, the scrollbar or a finger. The header
282
+ and the rows move together because they are in one scroll area, and the first column stays frozen.
283
+ - On a phone the header row pins at the top of the grid, as on a desktop.
284
+ - What counts as a phone is your desktop query alone (by default `(min-width: 1024px)`). A screen between 768px
285
+ and 1023px wide is now drawn as a phone: grouped rows have no indent under the group's caret, and the header
286
+ has no "+ Add column" (your app's own column picker is the way in). It already opened editors in your `Sheet` and opened
287
+ a record from a tap on its name. To keep a desktop's drawing there, hand the provider a `desktopQuery` that
288
+ matches it.
289
+ - The default load-more watches the grid's own scroll area and asks for more rows 600px before its end.
290
+ - On a phone (anything below your provider's desktop query), one tap on a cell opens its field's editor in your
291
+ `Sheet`. Before, a tap selected a cell and a second tap opened it, and a pick-list opened from a tap on its ▾. A
292
+ cell that opens nothing is selected and the grid says why, as a desktop's second click does.
293
+ - On a phone, a tap anywhere on the name's cell opens the record (your `onOpenRow`), not only a tap on the name's
294
+ text. The name is edited inside the record.
295
+ - A cell of several emails, phones, links or domains opens its value list in your `Sheet` on a phone, titled with the
296
+ column's header, instead of your `Popover`.
297
+ - On a desktop nothing changes: a click selects, and a second click, a double-click, Enter or typing edits.
298
+ - A test of yours that clicks the grid on a screen your desktop query doesn't match now opens the editor on the first
299
+ click. Answer your desktop query (by default `(min-width: 1024px)`) in your `matchMedia` stub to keep a desktop's
300
+ clicks.
301
+ - A read-only text that its cell cuts off can now be opened to read; one that fits still opens nothing.
302
+ - Typing a letter on a cut-off text still replaces the value in the cell's one-line box. Links, emails, phones and
303
+ domains keep their one-line box, cut off or not.
304
+ - The grid draws only the rows on screen, with ten more each side, so 10,000 rows open, scroll and edit about as
305
+ fast as 50. A stretch a fast fling reaches before its rows are drawn shows empty row lines for a frame. The focused
306
+ row and the row being edited stay drawn when they scroll away, so an editor never loses its text.
307
+ - The browser's own find (⌘F) finds only the rows drawn; your list's own search finds the rest.
308
+ - A row no longer carries its own inline `grid-template-columns`: the columns' template is set once on the grid's
309
+ scroll area, and every row, column-name row and footer reads it.
310
+ - Two new slots: `data-slot="vk-grid-rows"` holds a group's rows, and `data-slot="vk-grid-gap"` stands for the
311
+ rows not drawn, as tall as they are.
312
+ - The outline a grid cell shows under the pointer is now drawn by the hovered cell's own `::after`, only while it is
313
+ hovered. No cell carries an element for it any more, so a row draws one element fewer for each column but the
314
+ name. It looks the same, in light and dark. If your own CSS styles a grid cell's `::after`, it now meets this
315
+ outline on hover.
316
+ - A row's action buttons on the name (your `rowActions` and the built-in Edit) are drawn only on the row under the
317
+ mouse, and a pick-list's ▾ (a select, status, relation or tags cell) only on the cell under the mouse or the cell
318
+ whose picker is open. Every other row draws neither, so a row draws fewer elements. They look and work as
319
+ before: hovering a cell shows its ▾, and one click on it opens the picker.
320
+ - On a phone, anything below your provider's desktop query, a pick-list's ▾ is never drawn: the whole cell opens the
321
+ picker (one tap opens a cell's editor on a phone). A touch never counts as a hover.
322
+ - A test of yours that finds the name's buttons or a ▾ in a row it has not hovered no longer finds them. Hover the
323
+ row or the cell first (a `pointerover` with `pointerType: "mouse"`), on a screen that answers your desktop query.
324
+ - ↓ from a group's last row now stops on its footer (when it has one), then on the next group's bar and its column names, before reaching that group's rows; before, it jumped straight to the next group's first row. ↑ walks the same way back. Tab and the Shift+arrow ranges still move from row to row across groups.
325
+ - The grid's keys listen on the grid instead of the window; only ⌘Z still listens on the window, so an undo works wherever the focus is. A test that pressed the grid's keys on `window` or `document.body` presses them on the focused cell (`document.activeElement`) instead, as a keyboard does.
326
+ - The grid's row checkboxes, its group bars' buttons and "+ Add column" are no longer Tab stops of their own; the arrows reach them as above.
327
+ - A closed select no longer offers the values other records hold that no option names: a stray value shows only
328
+ on the record that holds it. The grid does this itself. A host of your own that passed every record's values as
329
+ `extraValues` to a closed select now passes the record's own value as `current`, and keeps `extraValues` for an
330
+ open select's values:
331
+
332
+ ```tsx
333
+ // before
334
+ pickerOptionsFromField(field, { extraValues: valuesOnScreen });
335
+ // now, for a closed select
336
+ pickerOptionsFromField(field, { current: record.stage });
337
+ ```
338
+ - A closed multiselect in the grid offers its options alone, never the values other records hold that no option
339
+ names, and offers no row to add typed text. A value the cell already holds stays as a chip, and is saved as it is
340
+ when the set is.
341
+ - Saving a closed multiselect through `prepareFieldWrite` reads the record's current value, so a value the set
342
+ already holds passes though no option names it; only values added now must be options.
343
+ - The grid's editor for several emails, phones, links or domains now asks the grid before it closes, as the other
344
+ editors do: a list the grid would refuse (a value listed twice, an address that isn't one) stays open with the
345
+ reason under it instead of closing into a toast.
346
+ - Removing every value from a list whose column can't be emptied keeps the editor open, saying the field can't be
347
+ emptied (in the column's own `reasons.clearable` words when it declares them). Escape still throws the edit away.
348
+ Before, the editor closed and quietly dropped the whole edit.
349
+ - A letter typed on a selected relation or member cell opens its picker already searching for that letter; a
350
+ remote search runs once typing pauses.
351
+ - On a desktop a relation or member picker opens with the caret in its search; on a phone its sheet opens on the
352
+ list with the keyboard down, and a tap on the search raises it.
353
+ - A writable relation that stores refs (it names `kinds`, or carries `links`) binds a write: `bindField` no longer
354
+ refuses it. The grid edits and saves it; a surface you build on `RelationEditor` alone (a record's field row, a
355
+ card, a form field) still commits one bare id, so keep such a relation off those surfaces until they edit it.
356
+ - In the grid, a relation holding several records edits in `RelationSetEditor` and saves the whole set in the stored
357
+ shape: ids, or links with their kind, stored role and one lead where the field leads by a flag. A one relation of
358
+ several kinds saves `{ kind, id }`.
359
+ - The grid's write gate takes a relation's whole set and a ref, each id held to the candidates when the list is
360
+ static. A relation column with no field still takes an id alone.
361
+ - In the grid, a `date` field's editor has no time box, and a click on a day or a quick day saves it at once, on the
362
+ desktop and in the phone's sheet. A `datetime` keeps its time box (an empty time starts at 00:00), stays open after
363
+ a day click, and ✓ in the phone's sheet saves the day and the time.
364
+ - In the grid, a date column that may be emptied (`clearable`) ends its editor with a Clear row; a required date shows
365
+ none, and Delete still clears.
366
+ - In the grid, a character typed on a date cell opens its editor with that character in the date box, as on a text
367
+ cell. Before, it opened the editor on the stored date and dropped the character.
368
+ - Every date editor now shows the three quick days, yours included: a host that passes none of the new props keeps
369
+ its panel otherwise. A click on a day of the next or the previous month also moves the calendar to that month.
370
+ - In the grid, a money cell of one fixed currency shows its code (EUR) beside the amount while it is typed, as a
371
+ per-record currency's chip and a money range already did.
372
+ - In the grid, a range field with presets lists them under its two boxes: in a menu under the cell on the desktop, in
373
+ the sheet with the boxes on a phone.
374
+ - In the field row, a money field of one fixed currency shows its code beside the amount while it is typed, and a
375
+ range field with presets lists them in a menu under its two boxes.
376
+ - `useAnchoredEditSession`'s docs say what its deferred mode (`onDone`) is kept for: compatibility, for an app that
377
+ still opens it. The package's own grid name editor is its one user here. Nothing in the mode changes, and a new
378
+ host should prefer the admitted mode (`onAttempt` and `onClose`).
379
+ - Delete, Clear or Cut over several cells empties what it can, then says in one toast which fields it left because
380
+ they can't be emptied ("Not emptied: Stage and Owner can't be empty"). Before, those cells kept their values
381
+ without a word, and a selection holding only such fields said "Nothing in this selection can be emptied".
382
+ - A new message key for an adapter's words: `views.grid.clear-required`, with `{ fields }`, the fields' names
383
+ already joined in the viewer's locale.
384
+ - On a phone, where a tap on a grid's email, phone, link or domain cell opens its editor in the sheet, the sheet now
385
+ carries the open action: beside a single value's box, and on each row of several. The desktop is unchanged: a
386
+ ⌘- or Ctrl-click on the cell still follows its link.
387
+ - If your `contextMenu` already lists one of your `rowActions` under the same label, the menu shows it once, as yours. Listed under another label, it shows twice: give both the same label, or leave it out of one.
388
+ - `RowEditor`'s `onClose`, and every row host's, now receives `{ focusBack }`: `true` when the editor closed from the
389
+ keys or a pick off a sheet, and the row should take the focus back. A caller that mounts `RowEditor` itself and
390
+ ignores the argument keeps today's behaviour; one that wants the row's, focuses its own trigger when it is `true`.
391
+
392
+ ### Fixed
393
+
394
+ - The grid reference said `freezeIdentity` defaults to true. That is the bare `GridTable` prop's default; a grid wired
395
+ through `useGridTablePrefs` takes the preference `gridFreezeIdentity`, which `LIST_VIEW_PREF_DEFAULTS` sets to
396
+ false, so its title column starts unfrozen until the person turns it on. The reference and the grid guide now name
397
+ both, and how to open a grid frozen: `gridFreezeIdentity: true` in your starting prefs. Nothing in the code changed.
398
+ - A column locked in your `listConfig` refused an edit of one cell but still took a clear, a cut, a paste or a fill
399
+ over several cells, a paste into one cell, and the cut, paste and clear of a single cell's context menu: the write
400
+ reached your commit handler. The grid now refuses every one of them itself, before your handler runs. A clear,
401
+ cut, paste or fill over several cells writes the columns that aren't locked and says the lock once per locked
402
+ column, in the sentence an edit of one cell says (`views.grid.locked`, "Status is locked by workspace settings");
403
+ a paste or a fill of several cells says it the way it says its other refusals (`views.grid.paste-skipped` or
404
+ `views.grid.fill-skipped`, "2 cells weren't pasted: Status is locked by workspace settings"). Nothing in your code
405
+ changes.
406
+ - A grid phone cell opened on `[object Object]`, and a record's phone row opened empty: both now open on the phone written out, and an unchanged phone closes without a save. An unchanged text cell closes without handing the grid a value; Enter and Tab still move on.
407
+ - On a grid scrolled sideways with no column frozen, the checkbox a row shows while you point at it, and the
408
+ header's select-all, now sit on the checkbox lane's surface, in the row's hover tint, instead of drawing over the
409
+ text of the cell passing beneath. Only that row's part of the lane comes up; unscrolled, and with a column frozen,
410
+ the lane draws as before.
411
+ - A column's menu and a footer's figure picker opened only by pointer. The arrows now reach a group's column names (↑ from its first row) and its footer (↓ from its last), Enter or Space opens the menu or the picker, and Escape or a pick puts focus back on the cell. A column's menu opened by a key starts with its first row focused; opened by a pointer, it opens as before.
412
+ - A column that shows only its glyph had no name for a screen reader. It is now named after its field's label.
413
+ - `prepareFieldWrite` refused an edit of a url kept without its scheme (`acme.com`) when it came back as stored; it
414
+ now keeps it, as it keeps a phone.
415
+ - After a fill drag let go past the edge of the grid's visible area, the first click on a cell did nothing and only
416
+ the second selected it. The first click now selects the cell, as any other click does. The click a fill drag makes
417
+ as it ends on the grid still changes nothing.
418
+ - Dragging the fill dot past the top or bottom of the grid's visible area did nothing: the fill stopped at the last
419
+ row on screen. Held near or past that edge, the drag now scrolls whatever scrolls the grid (the page, or a
420
+ scrolling box around the grid), faster the further past the edge the pointer is, and keeps extending the fill to
421
+ the row at the edge; letting go fills to that row.
422
+ - An undo or a redo brings the cell it changed into view and selects it, as it always meant to: it used to look for
423
+ the row in a way that never found it, so the grid stayed where it was.
424
+ - Emptying a grid cell (typing it empty, Delete, Cut, a clear over a range) warned "changed elsewhere" when your
425
+ rows came back holding `null` for it after the save had settled, though nobody else had changed anything. The
426
+ grid now reads `null`, `undefined`, a blank text and an empty list as one empty value when it decides whether
427
+ someone else changed a cell, so that warning no longer appears. A save that answers as it did before sees nothing
428
+ else change: a genuine third value still warns, and you need not answer `stored: null` to keep it quiet.
429
+ - On a phone, a grid cell whose number, money, range or text editor was open in the sheet went blank behind the
430
+ sheet until it closed. The cell now keeps showing its value while the sheet is open, as a picker's cell does. On a
431
+ desktop the editor still takes the value's place in the cell.
432
+ - A tap inside an editor's sheet bubbled through React's tree to whatever the editor opened from, so in a grid in
433
+ selection mode it could toggle the row behind the sheet. `EditorPanel` now keeps a click, a double-click or a
434
+ context menu inside its sheet to itself, for every host. `onPanelClick` is called for a click in the sheet as well
435
+ as in the popover; the popover's behaviour is unchanged.
436
+ - A grid column your list's settings locked while one of its cells' editors was open closed the editor into a toast
437
+ when it tried to save, and left it mounted with nothing to answer it until the next click. The editor now asks the
438
+ lock before it closes, as it asks the write gate, so it stays open with the lock's sentence and Escape leaves it.
439
+ A write the grid refuses on its way to your save also closes that cell's editor.
440
+ - `useAnchoredEditSession`, in its `onAttempt` mode, ignores a close that arrives while `onAttempt` runs. Before, a
441
+ host that wrote inside `onAttempt` and whose editor closes on blur could write twice when the write moved the focus:
442
+ the blur closed the session again and asked `onAttempt` a second time. A refused attempt still leaves the session
443
+ open for the next one, with its reason in `refusal`, and so does an `onAttempt` that throws. Nothing changes in how
444
+ you call it.
445
+ - The date editor reads a stored date with no time (`2026-12-01`) as that day in every time zone. West of UTC it
446
+ opened on the day before, and a change to the time alone saved the day before; east of UTC its time box showed the
447
+ zone's offset (02:00 in Bucharest) as a time. A date field in the grid now opens on its stored day and saves as that
448
+ day. A stored date and time reads as it did.
449
+ - The range editor's two boxes no longer run out past the start of a narrow cell on the desktop. Each keeps its width
450
+ where the cell has room and shrinks where it has not.
451
+ - `EditorPanel` reports a focus leaving its popover with no press (a Tab out of it, the popover's `focus-out`) as
452
+ `close("blur")`, where it reported `close("outside")`. A host that spends the click after an outside press, so it
453
+ can't open what sits under the popover, no longer spends the next click after a keyboard exit. Every editor in the
454
+ package answers `"blur"` as it answers `"outside"`; a host of your own that tells the two apart now hears `"blur"`
455
+ for a focus leaving.
456
+ - With a group collapsed, the keyboard walked into its hidden rows. Tab, Enter, the arrows and a Shift+arrow range now skip a collapsed group's rows, and a copy, a clear, a paste and a fill over a range across it don't touch them, as a spreadsheet skips filtered rows.
457
+ - Collapsing a group while one of its cells was being edited could close the editor. The edit now stays open, and nothing is lost, where your `Collapse` keeps a shut group mounted.
458
+ - A writable field row whose value has several parts (several values, a place, a name) no longer draws a button inside its own button. Its "+N" is plain text, and a press anywhere on the value opens the editor, which lists every value. Several links in a writable row draw as text too; a read-only row keeps its links and its "+N" list, and a single link keeps its anchor.
459
+ - In `RelationSetEditor`, an Enter after the pointer moved the highlight off the first linked record now acts on the
460
+ highlighted record. Only while the highlight still sits on the record it opened on, and nothing was typed or
461
+ arrowed, does an Enter do nothing. A set that opens empty has no such guard.
462
+ - `prepareFieldWrite` passes a relation's stored value to the field's accept rule, so a link whose stored role was
463
+ archived since no longer refuses the save of its set.
464
+ - In the grid, a record your create form links to a relation holding several records joins the set however soon you
465
+ call the link: one called before the editor has finished closing is written right after the editor's own save,
466
+ never under it.
467
+ - The default row menu, opened by a key after a tap on the row, opened nothing, and opened by a key after a click it ignored a pick for its first 300 ms. A key now forgets the press before it.
468
+ - A row's checkbox reached by keyboard lost its focus when the grid scrolled its row far out of view. Its row now stays drawn, and the checkbox keeps the focus, as a focused cell's row does.
469
+ - A writable field row nests no link or button inside its edit button, whatever its value draws.
470
+ - A single email, phone, link or domain in a writable row reads as plain text inside the button, and an open action
471
+ sits beside it, outside the button: a mail to the address, a call to the number, the site in the browser, the same
472
+ action a phone's sheet carries. A press on the row, on the value's text included, opens its editor.
473
+ - A writable rich text keeps its formatting, its links and its "Show more", which now sit outside the row's button:
474
+ the value lies over the button, so a press on its text still opens the editor while a link or "Show more" takes
475
+ its own press.
476
+ - A read-only row is unchanged: its links stay links.
477
+ - On a datetime, Enter after a quick day (Today, Tomorrow, Next Monday) or a calendar day saves the day and time
478
+ `DateEditor` shows. The click left the focus on the day just pressed, so Enter pressed it again and nothing asked
479
+ to close. On a desktop width a pick now puts the focus back in the date box, as a time picked from the list puts
480
+ it in the time box. On a phone the focus stays where it was, so the keyboard doesn't rise, and the sheet's ✓ saves.
481
+ - `EditorPanel` reports a press outside its popover only while its session is open. Your popover may stay mounted
482
+ while it plays its exit after a close, its outside press still live; a press there reached the session's `close`
483
+ as `"outside"` again. A host that spends the click after an outside press, so it can't open what sits under the
484
+ popover, spent the next click after a Tab out of the editor. Nothing changes while the editor is open.
485
+ - `DateEditor` can be left by Tab. Tab from its last control asks to close with `"tab"`, and Shift-Tab from its
486
+ first with `"shift-tab"`, keeping what was typed or picked; Tab between its own controls (the date box, the time
487
+ box, the quick days, the calendar) moves as before. A popover that keeps the focus in a loop held the keyboard in
488
+ the panel, which could be left only by Escape, throwing the edit away. The editor now draws a root element with
489
+ `display: contents` (`data-slot="vk-date-editor"`) around its parts, which changes no layout.
490
+ - The grid's date cell moves to the next cell on a Tab out of its editor, and to the one before on Shift-Tab, as
491
+ every other cell editor does.
492
+ - On a desktop, Enter or Tab in an editor that opens over its cell (a text cut off in its cell, a date, a pick-list, chips, a place, a relation) moves the grid's focus to the next cell at once, while the editor plays its close. A key typed straight after it, the next value, an arrow or ⌘Z, now acts on the grid; it used to be lost for about 180 ms, and a click on the next cell in that moment opened its editor. A key in that moment writes the saved value first, so ⌘Z undoes it.
493
+ - The grid's date cell, opened by Enter, a double-click or a click on the cell already selected, puts the focus in its
494
+ date box on a desktop. The focus stayed on the cell, where the grid keeps Tab while a cell is editing, so Tab could
495
+ not leave the editor and only Escape, which throws the edit away, closed it. Tab now walks the panel's controls and,
496
+ from its last, saves and moves to the next cell; Shift-Tab from the date box moves to the cell before.
497
+ - In `DateEditor`, Tab out of the time box closes its quick-pick of times, so the next Tab reaches the quick days
498
+ rather than walking every quarter hour of the day.
499
+ - A field row's closed select of more than eight options opens on a desktop with the caret in its search, as the
500
+ grid's does, so the first keys filter the list. The search opened without the caret, and typing filtered nothing
501
+ until a click into it. On a phone the sheet still opens with the keyboard down.
502
+ - `RelationEditor`, and so every relation and member picker (a grid cell, a field row, a card), opens with the linked
503
+ record highlighted. It opened on the None row above the candidates, so an Enter pressed at once emptied the field.
504
+ When a remote search's page doesn't hold the linked record, nothing is highlighted until a key or typed text moves
505
+ the highlight, and an Enter at once does nothing. With nothing linked it opens on None, or on the first candidate,
506
+ as before; opened by a typed letter, on the first match.
507
+ - A value cut short among several (several emails, phones, links or places, a multiselect, a relation's records) now
508
+ ends in "…" wherever it is drawn: a grid cell, a field row, a card, the list look. The ellipsis sits on each value's
509
+ own box; before, the value was clipped mid-word with nothing marking the cut. The count of hidden values (+N) is
510
+ unchanged.
511
+ - On a phone, a record's field row opens a place in the sheet with each part drawn as a box: the parts ask the app's
512
+ `Input` for its field frame (`chrome: "field"`), as a typed cell's sheet already does, and a part picked from a list
513
+ (a region, the country) takes a frame of the same height. On a desktop the popover's compact rows are unchanged.
514
+ - On a phone, a field row's date sheet draws its calendar across the sheet's whole width: the app's `Calendar` gets
515
+ `className: "w-full"` there. An adapter whose calendar merges its own classes with that one needs no change.
516
+ - On a phone, a grid's name cell opens its three boxes in the sheet, titled with the column's header, with ✕ and ✓,
517
+ as every other cell does: ✕ and a swipe change nothing, ✓ saves. In the sheet the boxes wear the app's field frame.
518
+ On a desktop it still opens under the cell. It now closes by the same rules as the grid's other editors.
519
+ - `EditorPanel` brings an in-place editor's box into view as it opens, at the nearest edge, when its `anchor` is that
520
+ box. The grid's number, money and range cells edit in their own box, and one partly past the edge of the grid's
521
+ scroller (its last column at the window's edge) opened cut off, its value out of sight.
522
+ - In the grid, what a type-in cell hangs under itself (a refusal; under a money cell, the figure a converted amount
523
+ shows) ends at the cell's right edge when, started at its left, it would run past the window or the grid's
524
+ scroller.
525
+ - Escape from a column's menu, a footer's figure picker or a group's ⋯ menu left the focus on the page when your `Popover` plays an exit, so the arrows did nothing. The focus now goes back to the column name, the footer cell or the bar's ⋯ once the panel has left the page.
526
+ - In a column's menu and the figure picker, ↓ and ↑ now move between the rows, round at either end, and Enter picks the focused one. Before, only Tab moved, so ↓ then Enter picked the first row.
527
+ - On a grouped grid, ⌘Z or ⇧⌘Z that changed a value cleared the selection and dropped the focus to the page, so the next arrow did nothing. The undone cell is now selected and holds the focus, and the next key moves from it. An undo of a row no longer shown leaves the focus where it was.
528
+ - In a group's ⋯ menu, ↓ and ↑ now move between the rows (the sort choices, the Show toggles, Hide), round at either end, and Enter picks the focused one. Before, only Tab moved, so ↓ then Enter picked the first row. Past eight sort choices, where the menu searches them, ↓ past the last match goes on to the Show rows and ↑ from there comes back.
529
+ - `SelectEditor`'s list of more than 8 options that may be emptied (`clearable`) opens with the value it holds
530
+ highlighted, or None when it holds nothing, so an Enter pressed at once changes nothing. The arrows walk every row,
531
+ None included, and Enter on None empties the field. It opened with nothing highlighted: ArrowDown never moved, and
532
+ None could not be reached from the keyboard. Opened with a `seed`, it opens on the first match, as before. A list
533
+ that can't be emptied, and a list of 8 or fewer, behave as before.
534
+ - A field row whose editor closes by Tab, Shift-Tab, Escape, Enter or a pick puts the focus back on its own
535
+ button, on a desktop, so the next Tab moves on from that row. The focus fell to the page, and the next Tab started
536
+ again from the top. When the write is still saving, the focus goes back once it has saved, unless it was moved in
537
+ the meantime. An outside press leaves the focus where it put it, and a phone's sheet is unchanged.
538
+ - An empty list whose columns are wider than its box shows your empty message whole and centred in the width you
539
+ can see, instead of centring it on the table's full width, past the box's edge. The grid keeps the message in view
540
+ itself; you hand it `emptyState` as it is. If you wrapped your message to keep it in view (a sticky, `100cqw`-wide
541
+ element), you can drop that wrapper.
542
+ - A grid's number or money editor opened in a cell too narrow for the amount and its currency grows past the cell to
543
+ show both in full, away from the side the column aligns to (a right-aligned column's grows left, the amount still
544
+ flush with its edge), up to 320px, past which the amount scrolls in its box. It had been the cell's width, so the
545
+ end of the amount was cut with nothing marking the cut. A cell wide enough opens its editor as before, and the line
546
+ under the cell (the converted figure, a refusal) stays where it was.
547
+ - A phone number too long for its box ends in "…", alone or as one of several, in a grid cell, a field row and a
548
+ card. It had been cut mid-digit with nothing marking the cut. Its link and the count of the others are unchanged;
549
+ the number underlines on its link's hover, as a relation's name does.
550
+ - In the place editor drawn in your app's field frame (a field row's place on a phone), the country's box is as high
551
+ as every other part's box. It had been sized to its text, shorter than the boxes under it. The bare editor (a
552
+ popover on the desktop) is unchanged.
553
+ - In the name editor drawn in your app's field frame (a grid's name cell on a phone), the Full name box spans the
554
+ editor's width and is as high as the Given and Family boxes above it. It had been held narrower than they are,
555
+ which cut a longer name short. The bare editor (a popover on the desktop) is unchanged.
556
+ - In a group's ⋯ menu that searches its sort choices (more than eight), ↓ from the last row now comes round to the first sort choice, and ↑ from the row below the list comes back to the last one. Before, ↓ from the last row went back to the last sort choice, so ↓ bounced between the last two rows.
557
+ - A sort picked by keyboard from a column's menu or a group's ⋯ menu left the focus on the page when your list reloads on a sort and holds the table it is leaving `inert` meanwhile. The focus now goes back to the column name or the ⋯ once the table is no longer inert, unless it has moved somewhere else first.
558
+
559
+ ### Removed
560
+
561
+ - `--vk-pinned-top`. The grid no longer reads it, because its headers pin inside its own scroll area; stop
562
+ declaring it for the grid.
563
+ - The `data-grid-scroller` attribute. `[data-slot="vk-grid-scroll"]` is the one element that scrolls.
564
+ - Wrapping leaves the grid. Every row is one height, and a cell's text stays on one line, cut off at the cell's edge.
565
+ - `GridTable` no longer takes `wrapCells`. Delete the prop where you pass it: `<GridTable wrapCells={wrap} … />`
566
+ becomes `<GridTable … />`.
567
+ - The preference `gridWrapCells` is gone from `ListViewPrefs` and `LIST_VIEW_PREF_DEFAULTS`, and `wrapCells` from
568
+ a view's layout (`ListViewLayout`, `LIST_LAYOUT_DEFAULTS`), so `gridProps` from `useGridTablePrefs` no longer
569
+ carries it. Delete any switch that set it: `setPrefs({ gridWrapCells: next })` no longer type-checks. A value
570
+ you already stored is ignored, and an old blob's `gridWrapCells` is no longer carried into a layout.
571
+ - `GridCellOptions` no longer has `wrap`: `renderTypedCellValue(col, row, { wrap: true })` becomes
572
+ `renderTypedCellValue(col, row)`. `DisplayOptions.wrap` is unchanged, so a field drawn outside the grid still wraps
573
+ as before.
574
+ - `--vk-chrome-h`, `--vk-cell-py` and `--vk-tail-py` leave `VK_TOKENS`. Only a wrapped row read them, and the
575
+ grid no longer sets or reads them: delete any CSS of yours that sets them, and any that reads them, which would
576
+ now get nothing.
577
+
578
+ ## [0.2.0] — 2026-10-31
579
+
580
+ The grid's rendering, behind its own door, `@viewkitjs/views/grid`, and the package's documentation in `docs/`.
581
+ It needs `@viewkitjs/fields` 0.9.
582
+
583
+ ### For an adapter
584
+
585
+ - Messages: five keys are new, `views.menus.row-delete-failed`, `views.grid.paste-other-currency`,
586
+ `views.grid.paste-ambiguous-option`, `views.grid.paste-skipped` and `views.grid.fill-skipped`, and one is gone,
587
+ `views.grid.paste-failed`. A catalog that words its own messages adds the new ones and drops the old one, which
588
+ `ViewsMessage`, a closed union, no longer holds; one that leaves a key out reads it in the package's English.
589
+ Each is worded in its own line, here or under Changed.
590
+
591
+ - A new message, `views.menus.row-delete-failed` "Failed to delete the row": the plain row menu's error toast when
592
+ the delete your `onDelete` ran rejects. A catalog that leaves it out gets the English.
593
+ - The grid stops its sticky header and its group headers under `--vk-pinned-top`, the height of what your surface
594
+ pins above it (a tab strip, a toolbar), read as `0px` when you declare none: declare it where you pin something
595
+ over a grid. The grid read `--drawer-pinned-top` before: an app that set it for the grid sets `--vk-pinned-top`.
596
+ - A new, optional port, `confirm({ message, confirmLabel, subject, destructive })`, resolving to whether the person
597
+ said yes. The plain row menu's Delete asks it, `message` worded by `views.menus.row-delete-confirm`,
598
+ `confirmLabel` by `views.menus.row-delete`, and `subject` the host's `deleteLabel`. Hand your own dialog through it
599
+ 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
600
+ throw counts as no.
601
+ - `Menu`: a group marked `disabled` reaches your `Menu` with every row under it marked `disabled`. Draw each row by
602
+ its own flag; nothing else is needed.
603
+ - Four slots stay as they are, and the handling in "Writing an adapter" is the contract's answer: `Menu`'s anchor (the
604
+ menu library's root, positioner and popup), `Popover`'s `chrome: "menu"` (your menu surface laid over the card, no
605
+ inset), `Command.Input`'s `chrome: "bare"` (the command library's own input) and `Sheet`'s `snap` (map it onto your
606
+ snap points, or ignore it).
607
+ - Now said, with nothing to change for an adapter that already does it: `Popover`'s `chrome: "menu"` has no card
608
+ width (it is as wide as its list); `Command.Item`'s `chosen` (you colour the item, the package's row inside draws
609
+ the check, so hide your copy's own tick); and `AppIcon` (it draws on the first paint: a static record of your icons,
610
+ never icons loaded on demand).
611
+ - `Command.Input`: the place editor focuses its country and region search through the input's `ref`, with
612
+ `preventScroll`, no longer through `autoFocus`. Forward `ref` to the input, as the contract already asks.
613
+ - `Popover`: an editor opened with `initialFocus={false}` takes its own focus with `preventScroll`, so a popup that
614
+ places itself after mounting no longer jumps the page. An editor's popover positioned `fixed` only to hide that
615
+ jump can go back to your library's default.
616
+ - `Command.Input`: the grid's Add column search focuses through the input's `ref`, with `preventScroll`, no longer
617
+ through `autoFocus`, and its popover opens with `initialFocus={false}`. Nothing in the package passes `autoFocus`
618
+ any more, so a popover positioned `fixed` only to hide the opening jump can go back to your library's default for
619
+ the whole grid.
620
+ - `Row`'s `opens`: your row says a dialog opens beside it, `aria-haspopup="dialog"` with `aria-expanded` from
621
+ `open`. The flyout is the components map's `Popover`, a dialog of plain rows, not a menu, and a row that said
622
+ `menu` had a screen reader announce a menu it never found.
623
+ - A list's CSV export of a money column writes the figure the column shows, in its reading. A column that binds its own
624
+ raw read wrote the stored amount before.
625
+
626
+ ### Added
627
+
628
+ - The `confirm` port: an app keeps the plain row menu and asks before a delete in its own dialog. `useViews().ports`
629
+ always carries one (`ViewsResolvedPorts`), the browser's where the app handed none.
630
+ - The grid, at `@viewkitjs/views/grid`: `GridTable` with its props, `useGridTablePrefs`, its group and figure types,
631
+ and the helpers a host's binding shares with it (the commit types, a column's filter values, a cell's copy text and
632
+ edit baseline, the title link's class).
11
633
  - A column's menu is drawn with the package's own pieces: it opens the components map's `Popover` in the
12
634
  `vk-grid-column-menu` slot, its rows are the `Row` atom, its colours the `Tag` atom, and each knob's choices fly out
13
635
  of a `vk-grid-flyout` popover beside the row, one open at a time, after a short hover or at once on a tap.
636
+ - The package ships its documentation in `docs/`, starting at `docs/index.md`: getting started, from install to a grid
637
+ drawn with your own primitives; a guide per concept (the provider, ports, atoms, the display, editors and the edit
638
+ session, columns, cells, selection and the grid); and a reference per door naming every export. Every example in the
639
+ docs and the README is compiled and run against the packed package before each release.
640
+ - The contract states the four shapes of a value (stored, draft, commit, display) per type, what an edit core never
641
+ does, and how a `command` field is edited by verbs on every surface.
642
+ - `@viewkitjs/views/grid` exports `GridSortState`, `GridGroupSortOption`, `GridCellCommitFn` and `GridCellsCommitFn`
643
+ by name, the types an app writes the grid's `sort`, `sortOptions`, `onCellCommit` and `onCellsCommit` against. Before,
644
+ they were reachable only as `GridTableProps<Row>["sort"]` and the like, which still works.
645
+ - The grid draws every slot the contract names, so a skin reaches each part through `data-slot`: `vk-grid-header`
646
+ and `vk-grid-header-cell`, `vk-grid-row` and `vk-grid-cell`, `vk-grid-group` and `vk-grid-group-header`,
647
+ `vk-grid-footer` and `vk-grid-footer-cell`, `vk-grid-rail`, `vk-grid-tail` (the right tail of the header, each
648
+ row and the footer: a row's ⋯, the header's + Add column), `vk-grid-editor` (an inline editor, or
649
+ the popup of an anchored one), `vk-grid-outline` (the focused cell's ring and the range's edges) and
650
+ `vk-grid-resize-handle`. Before: only the frame, the row's ⋯ and the menus carried one.
14
651
 
15
652
  ### Changed
16
653
 
654
+ - The peer `@viewkitjs/fields` is `^0.9.0` (was `^0.8.0`): install fields 0.9 beside views 0.2. Under `0.x` a
655
+ `^0.9.0` peer accepts no 0.10.
656
+
657
+ - The grid's layout variables are `--vk-*` names (the contract's Tokens, which now lists `--vk-tail-pl` too): a skin or
658
+ an app that set a `--grid-*` name, `--grid-tail-pl` included, sets its `--vk-*` name.
659
+ - The grid's own variables are `--vk-drag-shift` and `--vk-col-w-<id>` (were `--drag-shift` and `--gw-<id>`), which
660
+ the contract names internal: an app neither sets nor reads them.
17
661
  - The grid counts a press as inside when it lands in the grid's React tree, not by your popover's wrapper: a press
18
662
  inside a popup outside the grid's tree (a toolbar's menu, a select in a window the app opens) now clears the
19
663
  focused cell, and a press on an overlay drawn inside the grid's root (a selection bar and its sheet, a
20
664
  confirmation window) now keeps it.
21
665
  - The grid turns mouse drag-select off itself; it no longer depends on what wraps a row.
666
+ - `densityStyle` writes `--vk-row-py`, `--vk-head-mb` and `--vk-row-gap` (were `--dt-row-py`, `--dt-head-mb` and
667
+ `--dt-row-gap`), now the contract's Tokens, with the same values at every density: an app whose rows look read or
668
+ set an old name reads or sets its `--vk-*` name.
669
+ - `ListFilterCapability` is `{ mode: "unavailable"; reason: string }`, the one answer `buildColumnFilters` reads. Its
670
+ `server` and `local` members built a column exactly as no entry: an app that hands `capabilities` to
671
+ `buildColumnFilters` drops those entries and keeps its unavailable ones.
672
+ - `formatMoney` moves from the package's root to `@viewkitjs/views/display`, beside `formatNumberValue`, and writes an
673
+ amount as a money cell does: through the presentation's `number` for the viewer, instead of in the `en-US` locale
674
+ whatever the viewer's. It takes the options a cell gets (`presentation`, `viewer`) as a fourth argument; with none it
675
+ reads in the default presentation and the neutral conventions (`en-GB`), so a dollar amount there reads
676
+ "US$109.00", not "$109.00". To keep your app's look, hand it your presentation and viewer:
677
+
678
+ ```ts
679
+ // before
680
+ import { formatMoney } from "@viewkitjs/views";
681
+ formatMoney(1234.5, "EUR"); // "€1,234.50", on every page
682
+
683
+ // after
684
+ import { formatMoney } from "@viewkitjs/views/display";
685
+ formatMoney(1234.5, "EUR", 2, { presentation, viewer }); // "1.234,50 EUR" for a Romanian viewer
686
+ ```
687
+ - Two doc comments your editor shows on hover say what their code does: `normalizeGroupSummary` returns `[]`, a bare
688
+ group name, for a value it cannot read, never the default, and `setDurationStyle` always writes the column's entry,
689
+ never dropping one.
690
+ - The contract describes `vk-grid-rail` as the checkbox lane: the group caret is drawn in `vk-grid-group-header`.
691
+ - The grid's doc comments, which your editor shows on hover, say what the code does in the library's own terms: none
692
+ names a tracker key, a plan or a path in another app any more, and a check in the package holds it.
693
+ - A paste or a fill of a money cell into a record that holds another currency is refused, with the message
694
+ `views.grid.paste-other-currency` ("This record is in EUR"); the copied currency is carried only into a record with
695
+ none of its own. Before, the copied currency was carried over, re-denominating the record. An app that words its own
696
+ messages adds this one.
697
+ - `readMoneyColumn` sets the column's `editAccessor` to the row's own amount, in every reading, keeping one the column
698
+ already has.
699
+ - A pasted label two options share is refused with the new message `views.grid.paste-ambiguous-option`, instead of
700
+ landing on one of them; an app that words its own messages adds it.
701
+ - A paste or a fill that refuses cells says why. One toast per reason it met, with how many cells that reason refused:
702
+ `views.grid.paste-skipped` and `views.grid.fill-skipped`, each `{ count, reason }` ("2 cells weren't filled: This
703
+ 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
704
+ says the reason alone. Before, any refusal of more than one cell said only `views.grid.paste-failed` ("Failed to
705
+ paste 2 cells"), a fill included. The cells that fit are written, as before.
706
+ - `views.grid.paste-failed` is removed. An app that words its own messages replaces it with the two new keys:
707
+
708
+ ```ts
709
+ // before
710
+ case "views.grid.paste-failed":
711
+ return `${message.values.count} cells could not be pasted`;
712
+
713
+ // after
714
+ case "views.grid.paste-skipped":
715
+ return `${message.values.count} cells were not pasted: ${message.values.reason}`;
716
+ case "views.grid.fill-skipped":
717
+ return `${message.values.count} cells were not filled: ${message.values.reason}`;
718
+ ```
719
+
720
+ ### Fixed
721
+
722
+ - A menu group marked `disabled` disables its rows in every adapter: before, each row followed only its own flag, so a
723
+ disabled group's rows could still be pressed.
724
+ - The plain row menu's Delete, confirmed, tells the person when the delete fails: a rejecting `onDelete` calls the
725
+ toast port's `error` with `views.menus.row-delete-failed`. Before: the rejection went unhandled and the row stayed
726
+ with no word.
727
+ - An email, one or several, draws as plain text when the host's own slot owns the click (`slotOwnsClick`), as a
728
+ link, a domain and a phone already did, so the click reaches the host's row. Without it, each address is still a
729
+ `mailto:` link.
730
+ - A percent on Bar keeps a track you can read: the track never narrows below 1.5rem, and the figure's slot is the
731
+ figure's own width (it counted a whole character each for the point and the sign). A narrow percent column on Bar
732
+ shows the figure alone. Before: a column too narrow for both crushed a 100% bar to a dot.
733
+ - A grid copy of a phone, one or several, and a CSV export of its column through `cellCopyText`, write each phone as
734
+ `phoneText` writes it, in its international form, the main one first. Before: `[object Object]` for each.
735
+ - Opening an editor leaves the page where it was: the chips, name, number, range, value list and place editors, the
736
+ place editor's searches and the grid's long-text editor take focus with `preventScroll`. Before: on a popover that
737
+ places itself after mounting, the page jumped to where the popup sat before it was placed.
738
+ - A place and a phone drawn with no viewer (`renderFieldValue(field, value)`) take the provider's conventions, as a
739
+ date, a number, a percent and an amount do: the country is named in the app's language, a phone from the app's
740
+ region is written nationally, and its extension in the app's words. Before: the country was named in English
741
+ and the phone written internationally, so the place display and the place editor beside it disagreed.
742
+ - A percent on Bar never loses its leading digits: a figure wider than its box spills into the cell's padding, and
743
+ past that it is cut at its end with an ellipsis ("100.…"). At a 60px column and the default density a whole
744
+ 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 %".
745
+ - A selected range shows the values inside it: its tint drew over every cell's value, the anchor's included, so the
746
+ cells read as empty while the range was held. The tint now sits under the value; its colour, its boundary, the
747
+ anchor's ring and the fill dot are unchanged.
748
+ - Opening the grid's "+ Add column" can no longer scroll the page: its search took focus before a popover that
749
+ places itself after mounting had moved it to its anchor.
750
+ - The contract counts eighteen doors, as the package declares, and the usage skill names all of them.
751
+ - The contract says what the `viewPrefs` port is read for: no view reads it; the grid's preferences come in through
752
+ `useGridTablePrefs`, from wherever your app keeps them.
753
+ - The grid's triggers say what they open: the header cell that opens a column's menu and the footer cell that opens
754
+ its figure picker take `role="button"` and `aria-haspopup="dialog"`, and the group band's ⋯ says `dialog` too.
755
+ Before, each said `menu` over a popover that is a dialog.
756
+ - A money column read in another currency now edits the amount each row stores, in the row's own currency: its
757
+ editor opens on that amount, and undo, cut, Delete, Clear, copy, paste and fill carry it. Before, they carried the
758
+ converted figure beside the row's own currency, so an undo or a paste could store the converted figure as an amount
759
+ in the row's currency. The cell, its total, sorting, grouping and filtering still read the converted figure.
760
+ - Undoing a write into an empty number, percent or money cell empties it again. Before, it wrote 0. A fill from an
761
+ empty cell no longer writes 0 either: it empties a column that can be emptied, and skips one that can't.
762
+ - A copy of a number, percent or money cell pasted inside the grid lands as the number it copied, whatever the
763
+ conventions read a decimal point as.
764
+ - A select, status or multiselect cell copies as the labels it shows, alone, in a range and in an export, instead of
765
+ its stored keys. A pasted label lands on its option, from the grid or from a spreadsheet; a pasted key still lands
766
+ too, an exact match winning over one that differs only in case, and a copy pasted inside the grid lands on the exact
767
+ option it copied.
768
+ - With Wrap columns on, the selection rail beside a row that runs to several lines draws its line at the row's bottom
769
+ and its backing over the whole row, instead of at a one-line row's height. The checkbox stays level with the first
770
+ line.
771
+ - A fill of a money, percent or date-and-time cell no longer draws "[object Object]" in the filled cells until its
772
+ save lands, nor warns "Value was changed elsewhere" when it does. It paints nothing early, as a paste and the editor
773
+ already did: each filled cell keeps its figure until the save's refetch draws the new one. A fill of a relation, a
774
+ range or a list of several values does the same. A text, a select or a yes/no fill still shows at once.
775
+
776
+ ### Removed
777
+
778
+ - The filter capability split and its wire format, which nothing sent: `validateFilterCapabilities`,
779
+ `ListFilterCapabilityError`, `splitFilterRules`, `GridFilterSplit`, `GridPushdownSupport`, `serializeFilters`,
780
+ `effectiveDecimals`, `gridFilterSupport`, `ListWireRule`, `ListWireRuleState` and `GRID_FILTER_PARAM_MAX_BYTES`. A
781
+ list filters its rules in the browser, or evaluates its view at its source; the source registry
782
+ (`defineGridFilters` and its types) and `ListFilterCapability`, which the Filter panel reads, stay.
783
+ - `auditGridFilters`, a filter registry drift check for the filter split, which nothing called. The source registry
784
+ (`defineGridFilters` and its types) stays.
785
+ - `renderAs` on `FilterConfigBase`, which nothing read. `countsAsFilter` stays.
786
+ - `onListConfigChange` and `listWritable` on `GridTableProps`, which the grid never read. The grid reads `listConfig`
787
+ only; a settings surface of your own changes it and hands the grid the new value.
22
788
 
23
789
  ## [0.1.0] — 2026-10-30
24
790