@viewkitjs/views 0.2.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 (292) hide show
  1. package/CHANGELOG.md +571 -0
  2. package/README.md +5 -3
  3. package/dist/atoms/LoadMore.js +11 -1
  4. package/dist/atoms/RowMenu.js +5 -2
  5. package/dist/cells/cell-format.d.ts +3 -3
  6. package/dist/cells/cell-title.d.ts +1 -2
  7. package/dist/cells/cell-title.js +2 -2
  8. package/dist/cells/cell-values.js +6 -3
  9. package/dist/contract.d.ts +50 -9
  10. package/dist/contract.js +33 -5
  11. package/dist/display/converted.d.ts +19 -0
  12. package/dist/display/converted.js +12 -0
  13. package/dist/display/index.d.ts +1 -0
  14. package/dist/display/index.js +1 -0
  15. package/dist/display/link-click.d.ts +11 -0
  16. package/dist/display/link-click.js +3 -0
  17. package/dist/display/link.js +7 -3
  18. package/dist/display/multi-value.d.ts +1 -1
  19. package/dist/display/multi-value.js +1 -1
  20. package/dist/display/options.d.ts +7 -1
  21. package/dist/display/phone.js +3 -1
  22. package/dist/editors/ChipsEditor.d.ts +9 -4
  23. package/dist/editors/ChipsEditor.js +6 -2
  24. package/dist/editors/DateEditor.d.ts +21 -6
  25. package/dist/editors/DateEditor.js +118 -30
  26. package/dist/editors/EditorPanel.d.ts +61 -0
  27. package/dist/editors/EditorPanel.js +54 -0
  28. package/dist/editors/LocationEditor.d.ts +3 -0
  29. package/dist/editors/LocationEditor.js +14 -6
  30. package/dist/editors/NameEditor.d.ts +3 -0
  31. package/dist/editors/NameEditor.js +11 -7
  32. package/dist/editors/NumberEditor.d.ts +3 -0
  33. package/dist/editors/NumberEditor.js +6 -6
  34. package/dist/editors/RangeEditor.d.ts +16 -1
  35. package/dist/editors/RangeEditor.js +21 -5
  36. package/dist/editors/RelationEditor.d.ts +13 -28
  37. package/dist/editors/RelationEditor.js +17 -40
  38. package/dist/editors/RelationSetEditor.d.ts +53 -0
  39. package/dist/editors/RelationSetEditor.js +112 -0
  40. package/dist/editors/SelectEditor.d.ts +21 -3
  41. package/dist/editors/SelectEditor.js +55 -9
  42. package/dist/editors/TextEditor.d.ts +51 -0
  43. package/dist/editors/TextEditor.js +81 -0
  44. package/dist/editors/ValueListEditor.d.ts +3 -0
  45. package/dist/editors/ValueListEditor.js +4 -2
  46. package/dist/editors/edit-cores.d.ts +12 -9
  47. package/dist/editors/edit-cores.js +7 -6
  48. package/dist/editors/edit-session.d.ts +21 -11
  49. package/dist/editors/edit-session.js +19 -5
  50. package/dist/editors/keep-inside.d.ts +12 -0
  51. package/dist/editors/keep-inside.js +20 -0
  52. package/dist/editors/open-value.d.ts +21 -0
  53. package/dist/editors/open-value.js +36 -0
  54. package/dist/editors/open-values.d.ts +4 -0
  55. package/dist/editors/open-values.js +7 -0
  56. package/dist/editors/relation-kinds.d.ts +7 -0
  57. package/dist/editors/relation-kinds.js +21 -0
  58. package/dist/editors/relation-panel.d.ts +69 -0
  59. package/dist/editors/relation-panel.js +40 -0
  60. package/dist/field-row/FieldNoteLine.d.ts +14 -0
  61. package/dist/field-row/FieldNoteLine.js +14 -0
  62. package/dist/field-row/FieldRow.d.ts +73 -0
  63. package/dist/field-row/FieldRow.js +157 -0
  64. package/dist/field-row/FieldRowLane.d.ts +19 -0
  65. package/dist/field-row/FieldRowLane.js +11 -0
  66. package/dist/field-row/editors/RowChipsEditor.d.ts +11 -0
  67. package/dist/field-row/editors/RowChipsEditor.js +25 -0
  68. package/dist/field-row/editors/RowDateEditor.d.ts +16 -0
  69. package/dist/field-row/editors/RowDateEditor.js +18 -0
  70. package/dist/field-row/editors/RowEditor.d.ts +39 -0
  71. package/dist/field-row/editors/RowEditor.js +64 -0
  72. package/dist/field-row/editors/RowNameEditor.d.ts +4 -0
  73. package/dist/field-row/editors/RowNameEditor.js +15 -0
  74. package/dist/field-row/editors/RowNumberEditor.d.ts +12 -0
  75. package/dist/field-row/editors/RowNumberEditor.js +18 -0
  76. package/dist/field-row/editors/RowPlaceEditor.d.ts +8 -0
  77. package/dist/field-row/editors/RowPlaceEditor.js +18 -0
  78. package/dist/field-row/editors/RowRangeEditor.d.ts +4 -0
  79. package/dist/field-row/editors/RowRangeEditor.js +15 -0
  80. package/dist/field-row/editors/RowRelationEditor.d.ts +20 -0
  81. package/dist/field-row/editors/RowRelationEditor.js +77 -0
  82. package/dist/field-row/editors/RowSelectEditor.d.ts +13 -0
  83. package/dist/field-row/editors/RowSelectEditor.js +23 -0
  84. package/dist/field-row/editors/RowTextEditor.d.ts +15 -0
  85. package/dist/field-row/editors/RowTextEditor.js +16 -0
  86. package/dist/field-row/editors/RowValueListEditor.d.ts +4 -0
  87. package/dist/field-row/editors/RowValueListEditor.js +21 -0
  88. package/dist/field-row/editors/host.d.ts +59 -0
  89. package/dist/field-row/editors/host.js +1 -0
  90. package/dist/field-row/editors/row-session.d.ts +49 -0
  91. package/dist/field-row/editors/row-session.js +49 -0
  92. package/dist/field-row/index.d.ts +5 -0
  93. package/dist/field-row/index.js +5 -0
  94. package/dist/field-row/row-target.d.ts +20 -0
  95. package/dist/field-row/row-target.js +3 -0
  96. package/dist/field-row/useFieldWrite.d.ts +45 -0
  97. package/dist/field-row/useFieldWrite.js +190 -0
  98. package/dist/field-row/useRowSettlement.d.ts +33 -0
  99. package/dist/field-row/useRowSettlement.js +23 -0
  100. package/dist/fields/binding.d.ts +6 -1
  101. package/dist/fields/binding.js +13 -6
  102. package/dist/fields/edit-core-types.d.ts +9 -9
  103. package/dist/fields/edit-core-types.js +6 -6
  104. package/dist/fields/money.d.ts +5 -0
  105. package/dist/fields/money.js +10 -0
  106. package/dist/fields/number-edit.d.ts +6 -0
  107. package/dist/fields/number-edit.js +4 -0
  108. package/dist/fields/prepare-write.js +6 -1
  109. package/dist/fields/relation-source-types.d.ts +12 -0
  110. package/dist/fields/write-target.d.ts +50 -0
  111. package/dist/fields/write-target.js +10 -0
  112. package/dist/grid/chrome/GridAddColumn.js +1 -1
  113. package/dist/grid/chrome/GridAggregateMenu.d.ts +1 -1
  114. package/dist/grid/chrome/GridAggregateMenu.js +8 -6
  115. package/dist/grid/chrome/GridCellEditors.d.ts +7 -0
  116. package/dist/grid/chrome/GridCellEditors.js +87 -16
  117. package/dist/grid/chrome/GridCellOutline.d.ts +22 -43
  118. package/dist/grid/chrome/GridCellOutline.js +2 -7
  119. package/dist/grid/chrome/GridChipsEditor.d.ts +16 -6
  120. package/dist/grid/chrome/GridChipsEditor.js +21 -26
  121. package/dist/grid/chrome/GridColumnMenu.d.ts +1 -1
  122. package/dist/grid/chrome/GridColumnMenu.js +7 -3
  123. package/dist/grid/chrome/GridDateEditor.d.ts +23 -11
  124. package/dist/grid/chrome/GridDateEditor.js +13 -25
  125. package/dist/grid/chrome/GridFooter.d.ts +12 -2
  126. package/dist/grid/chrome/GridFooter.js +10 -6
  127. package/dist/grid/chrome/GridGroupMenu.js +20 -13
  128. package/dist/grid/chrome/GridHeader.d.ts +9 -4
  129. package/dist/grid/chrome/GridHeader.js +15 -10
  130. package/dist/grid/chrome/GridLongTextEditor.d.ts +28 -9
  131. package/dist/grid/chrome/GridLongTextEditor.js +16 -74
  132. package/dist/grid/chrome/GridNameEditor.d.ts +11 -6
  133. package/dist/grid/chrome/GridNameEditor.js +12 -27
  134. package/dist/grid/chrome/GridNumberEditor.d.ts +20 -6
  135. package/dist/grid/chrome/GridNumberEditor.js +46 -20
  136. package/dist/grid/chrome/GridPlaceEditor.d.ts +26 -0
  137. package/dist/grid/chrome/GridPlaceEditor.js +22 -0
  138. package/dist/grid/chrome/GridRangeEditor.d.ts +15 -5
  139. package/dist/grid/chrome/GridRangeEditor.js +16 -20
  140. package/dist/grid/chrome/GridRelationEditor.d.ts +38 -14
  141. package/dist/grid/chrome/GridRelationEditor.js +86 -24
  142. package/dist/grid/chrome/GridRow.d.ts +7 -1
  143. package/dist/grid/chrome/GridRow.js +57 -14
  144. package/dist/grid/chrome/GridRowActions.js +1 -1
  145. package/dist/grid/chrome/GridRowCells.js +18 -23
  146. package/dist/grid/chrome/GridSelectEditor.d.ts +19 -4
  147. package/dist/grid/chrome/GridSelectEditor.js +21 -27
  148. package/dist/grid/chrome/GridStructure.d.ts +9 -10
  149. package/dist/grid/chrome/GridStructure.js +10 -14
  150. package/dist/grid/chrome/GridTable.js +97 -30
  151. package/dist/grid/chrome/GridTableSurface.d.ts +39 -2
  152. package/dist/grid/chrome/GridTableSurface.js +12 -3
  153. package/dist/grid/chrome/GridTextEditor.d.ts +35 -1
  154. package/dist/grid/chrome/GridTextEditor.js +35 -37
  155. package/dist/grid/chrome/GridValueListEditor.d.ts +15 -3
  156. package/dist/grid/chrome/GridValueListEditor.js +10 -27
  157. package/dist/grid/chrome/cell-cut-off.d.ts +11 -0
  158. package/dist/grid/chrome/cell-cut-off.js +20 -0
  159. package/dist/grid/chrome/cells.js +1 -2
  160. package/dist/grid/chrome/checks.d.ts +2 -5
  161. package/dist/grid/chrome/checks.js +15 -5
  162. package/dist/grid/chrome/editors.d.ts +1 -1
  163. package/dist/grid/chrome/editors.js +1 -1
  164. package/dist/grid/chrome/grid-cell-classes.d.ts +2 -8
  165. package/dist/grid/chrome/grid-cell-classes.js +10 -8
  166. package/dist/grid/chrome/grid-cell-link.d.ts +13 -0
  167. package/dist/grid/chrome/grid-cell-link.js +9 -0
  168. package/dist/grid/chrome/grid-edit-session.d.ts +63 -0
  169. package/dist/grid/chrome/grid-edit-session.js +118 -0
  170. package/dist/grid/chrome/grid-hover.d.ts +60 -0
  171. package/dist/grid/chrome/grid-hover.js +81 -0
  172. package/dist/grid/chrome/grid-menu-focus.d.ts +43 -0
  173. package/dist/grid/chrome/grid-menu-focus.js +93 -0
  174. package/dist/grid/chrome/grid-row-menu-key.d.ts +15 -0
  175. package/dist/grid/chrome/grid-row-menu-key.js +36 -0
  176. package/dist/grid/chrome/grid-row-props.d.ts +16 -4
  177. package/dist/grid/chrome/grid-row-window.d.ts +61 -0
  178. package/dist/grid/chrome/grid-row-window.js +212 -0
  179. package/dist/grid/chrome/grid-scroll-owner.d.ts +38 -0
  180. package/dist/grid/chrome/grid-scroll-owner.js +75 -0
  181. package/dist/grid/chrome/grid-styles.d.ts +4 -1
  182. package/dist/grid/chrome/grid-styles.js +1 -0
  183. package/dist/grid/chrome/grid-table-props.d.ts +2 -3
  184. package/dist/grid/chrome/useGridFocus.d.ts +45 -0
  185. package/dist/grid/chrome/useGridFocus.js +122 -0
  186. package/dist/grid/chrome/useGridKeyboard.d.ts +21 -4
  187. package/dist/grid/chrome/useGridKeyboard.js +214 -38
  188. package/dist/grid/chrome/useGridRangeActions.d.ts +3 -1
  189. package/dist/grid/chrome/useGridRangeActions.js +17 -10
  190. package/dist/grid/chrome/useGridRangeGestures.js +68 -21
  191. package/dist/grid/chrome/useGridRowContextMenu.d.ts +4 -2
  192. package/dist/grid/chrome/useGridRowContextMenu.js +28 -2
  193. package/dist/grid/chrome/useGridScaleStyles.d.ts +3 -1
  194. package/dist/grid/chrome/useGridScaleStyles.js +6 -7
  195. package/dist/grid/chrome/useGridScrollArea.d.ts +21 -0
  196. package/dist/grid/chrome/useGridScrollArea.js +65 -0
  197. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +28 -5
  198. package/dist/grid/chrome/useGridTableInteractionModel.js +66 -14
  199. package/dist/grid/chrome/useHeaderDragReorder.d.ts +2 -2
  200. package/dist/grid/core/clipboard-model.d.ts +2 -0
  201. package/dist/grid/core/clipboard-model.js +1 -1
  202. package/dist/grid/core/commit-model.d.ts +7 -0
  203. package/dist/grid/core/edge-scroll.d.ts +21 -0
  204. package/dist/grid/core/edge-scroll.js +23 -0
  205. package/dist/grid/core/editing-controller.d.ts +2 -1
  206. package/dist/grid/core/editing-controller.js +35 -9
  207. package/dist/grid/core/editing-model.d.ts +9 -0
  208. package/dist/grid/core/editing-model.js +12 -0
  209. package/dist/grid/core/flat-rows.d.ts +35 -0
  210. package/dist/grid/core/flat-rows.js +20 -0
  211. package/dist/grid/core/grid-aria.d.ts +27 -0
  212. package/dist/grid/core/grid-aria.js +39 -0
  213. package/dist/grid/core/grid-focus.d.ts +54 -0
  214. package/dist/grid/core/grid-focus.js +148 -0
  215. package/dist/grid/core/nav.d.ts +2 -2
  216. package/dist/grid/core/pending-reconciliation.d.ts +3 -0
  217. package/dist/grid/core/pending-reconciliation.js +5 -3
  218. package/dist/grid/core/row-window.d.ts +40 -0
  219. package/dist/grid/core/row-window.js +43 -0
  220. package/dist/grid/core/spreadsheet-operations.d.ts +17 -1
  221. package/dist/grid/core/spreadsheet-operations.js +33 -6
  222. package/dist/grid/core/useGridEditing.d.ts +3 -0
  223. package/dist/grid/core/useGridEditing.js +6 -3
  224. package/dist/grid/core/value-equality.d.ts +23 -1
  225. package/dist/grid/core/value-equality.js +46 -0
  226. package/dist/grid/useGridTablePrefs.d.ts +0 -1
  227. package/dist/grid/useGridTablePrefs.js +1 -3
  228. package/dist/index.d.ts +1 -0
  229. package/dist/index.js +1 -0
  230. package/dist/internal/viewport.d.ts +0 -2
  231. package/dist/internal/viewport.js +0 -14
  232. package/dist/model/column-capabilities.d.ts +2 -1
  233. package/dist/model/column-capabilities.js +28 -8
  234. package/dist/model/column-from.js +3 -0
  235. package/dist/model/column-inspect.d.ts +10 -2
  236. package/dist/model/column-inspect.js +9 -0
  237. package/dist/model/column-schema.d.ts +6 -1
  238. package/dist/model/column-types.d.ts +3 -1
  239. package/dist/model/column-types.js +1 -1
  240. package/dist/model/preferences.d.ts +0 -4
  241. package/dist/model/preferences.js +0 -1
  242. package/dist/model/prefs-buckets.d.ts +0 -1
  243. package/dist/model/prefs-buckets.js +0 -3
  244. package/dist/model/render-count.d.ts +6 -0
  245. package/dist/model/render-count.js +11 -0
  246. package/dist/provider/ViewsProvider.d.ts +5 -1
  247. package/dist/provider/ViewsProvider.js +9 -3
  248. package/dist/provider/components.d.ts +19 -1
  249. package/dist/provider/components.js +4 -2
  250. package/dist/provider/context.d.ts +5 -2
  251. package/dist/provider/desktop.d.ts +9 -0
  252. package/dist/provider/desktop.js +22 -0
  253. package/dist/provider/plain-input.d.ts +8 -0
  254. package/dist/provider/plain-input.js +5 -0
  255. package/dist/react.d.ts +2 -1
  256. package/dist/react.js +1 -0
  257. package/dist/selection/SelectCheckbox.d.ts +3 -1
  258. package/dist/selection/SelectCheckbox.js +2 -2
  259. package/dist/selection/useCheckDragSelect.js +6 -5
  260. package/docs/contract.md +93 -35
  261. package/docs/guides/atoms.md +1 -1
  262. package/docs/guides/cells.md +2 -2
  263. package/docs/guides/columns.md +3 -2
  264. package/docs/guides/display.md +1 -0
  265. package/docs/guides/editors.md +71 -13
  266. package/docs/guides/the-grid.md +32 -13
  267. package/docs/guides/the-provider.md +3 -1
  268. package/docs/index.md +3 -1
  269. package/docs/install.md +1 -1
  270. package/docs/reference/cells.md +1 -1
  271. package/docs/reference/display.md +3 -1
  272. package/docs/reference/editors-chips.md +2 -2
  273. package/docs/reference/editors-date.md +3 -3
  274. package/docs/reference/editors-location.md +1 -1
  275. package/docs/reference/editors-number.md +1 -1
  276. package/docs/reference/editors-open-values.md +1 -0
  277. package/docs/reference/editors-panel.md +12 -0
  278. package/docs/reference/editors-range.md +1 -1
  279. package/docs/reference/editors-relation.md +6 -3
  280. package/docs/reference/editors-select.md +3 -2
  281. package/docs/reference/editors-session.md +4 -2
  282. package/docs/reference/editors-text.md +9 -0
  283. package/docs/reference/editors-value-list.md +1 -1
  284. package/docs/reference/editors.md +2 -2
  285. package/docs/reference/field-row.md +16 -0
  286. package/docs/reference/grid.md +3 -3
  287. package/docs/reference/react.md +8 -5
  288. package/docs/reference/views.md +36 -15
  289. package/package.json +23 -4
  290. package/skills/views/SKILL.md +4 -4
  291. package/dist/grid/chrome/useGridScrollSync.d.ts +0 -38
  292. package/dist/grid/chrome/useGridScrollSync.js +0 -176
package/CHANGELOG.md CHANGED
@@ -4,6 +4,577 @@ All notable changes to `@viewkitjs/views`. `0.x`: the API may change between min
4
4
 
5
5
  ## [Unreleased]
6
6
 
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.
76
+
77
+ ### Added
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
+
7
578
  ## [0.2.0] — 2026-10-31
8
579
 
9
580
  The grid's rendering, behind its own door, `@viewkitjs/views/grid`, and the package's documentation in `docs/`.