@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
@@ -1,21 +1,17 @@
1
1
  "use client";
2
- import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useViews } from "../../provider/context.js";
4
4
  import { cx } from "../../internal/cx.js";
5
5
  import { GridHeadCheck } from "./checks.js";
6
6
  import { StuckMarker } from "./StuckMarker.js";
7
- import { GridFrozenShadow } from "./GridCellOutline.js";
7
+ import { GridWindowRows } from "./grid-row-window.js";
8
8
  import { GridGroupMenu } from "./GridGroupMenu.js";
9
- import { GRID_BLEED, GRID_HEADER_BG, GRID_ROW_PAD } from "./grid-styles.js";
9
+ import { GRID_CHROME_FOCUS, GRID_HEADER_BG, GRID_ROW_PAD } from "./grid-styles.js";
10
10
  function GridCollapseRegion({ collapsed, children, }) {
11
11
  const { Collapse } = useViews().components;
12
- return (_jsx(Collapse, { open: !collapsed, clipClassName: cx("pt-[2px] mt-[-2px] pb-2 -mb-2", GRID_BLEED, GRID_ROW_PAD), children: children }));
12
+ return (_jsx(Collapse, { open: !collapsed, clipClassName: "pt-[2px] mt-[-2px] pb-2 -mb-2", children: children }));
13
13
  }
14
- function GridRowsScroller({ minWidth, surface, children, }) {
15
- const { register, onScroll, className } = surface;
16
- return (_jsx(_Fragment, { children: _jsxs("div", { className: cx("relative flow-root", GRID_BLEED), children: [_jsx("div", { ref: register, onScroll: onScroll, "data-grid-scroller": true, className: cx(className, "pt-[2px] mt-[-2px] pb-2 -mb-2"), children: _jsx("div", { style: { minWidth }, children: children }) }), _jsx(GridFrozenShadow, {})] }) }));
17
- }
18
- function GridGroupSection({ group, collapsed, count, isMobile, selectable, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, minWidth, surface, headerWheelRef, headerPanHandlers, }) {
14
+ function GridGroupSection({ group, collapsed, count, selectable, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, keptFor, barIndex, ariaColCount, }) {
19
15
  const { icons, messages } = useViews();
20
16
  const Caret = collapsed ? icons.caretRight : icons.caretDown;
21
17
  const summaryParts = groupSummary ?? [];
@@ -31,15 +27,15 @@ function GridGroupSection({ group, collapsed, count, isMobile, selectable, sort,
31
27
  node: (_jsxs(_Fragment, { children: [figure.label, " ", figure.render(group)] })),
32
28
  });
33
29
  }
34
- return (_jsxs("div", { "data-slot": "vk-grid-group", className: "mt-5 first:mt-0", children: [_jsx(StuckMarker, {}), _jsxs("div", { className: cx("sticky top-(--vk-pinned-top,0px) z-30 touch-pan-y data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG, GRID_BLEED, GRID_ROW_PAD), ref: headerWheelRef, ...headerPanHandlers, children: [_jsxs("div", { "data-slot": "vk-grid-group-header", className: "group/gridlabel relative mb-1.5 flex h-(--vk-label-h) select-none items-center gap-2", children: [_jsx("button", { type: "button", "aria-label": messages({ key: collapsed ? "views.grid.group-expand" : "views.grid.group-collapse" }), "aria-expanded": !collapsed, onClick: () => onToggleGroup?.(group.key), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-sm text-(color:--vk-fg-subtle) hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)", children: _jsx(Caret, { className: "h-(--vk-glyph) w-(--vk-glyph)" }) }), _jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem-(1.5rem-var(--vk-glyph))/2)] truncate text-(length:--vk-text) font-medium", children: renderGroupLabel?.(group) ?? group.label ?? "—" }), parts.length > 0 && (_jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem)] flex min-w-0 items-baseline gap-1.5 overflow-hidden text-(length:--vk-text) text-(color:--vk-fg-subtle) tabular-nums", children: parts.map((part) => (_jsxs("span", { className: "flex items-baseline gap-1.5 whitespace-nowrap", children: [_jsx("span", { className: "text-(color:--vk-fg-subtlest)", children: "\u00B7" }), _jsx("span", { children: part.node })] }, part.key))) })), ((sort && sortOptions && sortOptions.length > 0) || onHideGroup) && (_jsx(GridGroupMenu, { sort: sort, sortOptions: sortOptions ?? [], summary: summaryParts, onSummaryChange: onGroupSummaryChange, figures: figures, onHide: onHideGroup ? () => onHideGroup(group.key) : undefined }))] }), !isMobile && (_jsx(GridCollapseRegion, { collapsed: collapsed, children: renderHeader(false, selectable ? renderGroupCheckbox(group.items) : undefined) }))] }), _jsx(GridCollapseRegion, { collapsed: collapsed, children: _jsxs(GridRowsScroller, { minWidth: minWidth, surface: surface, children: [isMobile && renderHeader(true), group.items.map((row, index, items) => renderRow(row, index, items, group.key)), renderFooter(group)] }) })] }));
30
+ return (_jsxs("div", { "data-slot": "vk-grid-group", "data-group-key": group.key, className: "mt-5 first:mt-0", children: [_jsx(StuckMarker, {}), _jsxs("div", { "data-slot": "vk-grid-group-head", className: cx("sticky top-0 z-30 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: [_jsx("div", { "data-slot": "vk-grid-group-header", role: "row", "aria-rowindex": barIndex, "aria-level": 1, "aria-expanded": !collapsed, className: cx("group/gridlabel sticky left-0 mb-1.5 flex h-(--vk-label-h) w-max max-w-[100cqw] select-none items-center gap-2", GRID_ROW_PAD), children: _jsxs("div", { "data-bar-name": true, tabIndex: -1, role: "gridcell", "aria-colindex": 1, "aria-colspan": ariaColCount, className: cx("flex min-w-0 items-center gap-2 rounded-sm", GRID_CHROME_FOCUS), children: [_jsx("button", { type: "button", tabIndex: -1, "aria-label": messages({ key: collapsed ? "views.grid.group-expand" : "views.grid.group-collapse" }), "aria-expanded": !collapsed, onClick: () => onToggleGroup?.(group.key), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-sm text-(color:--vk-fg-subtle) hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)", children: _jsx(Caret, { className: "h-(--vk-glyph) w-(--vk-glyph)" }) }), _jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem-(1.5rem-var(--vk-glyph))/2)] truncate text-(length:--vk-text) font-medium", children: renderGroupLabel?.(group) ?? group.label ?? "—" }), parts.length > 0 && (_jsx("span", { className: "ml-[calc(var(--vk-px)-0.5rem)] flex min-w-0 items-baseline gap-1.5 overflow-hidden text-(length:--vk-text) text-(color:--vk-fg-subtle) tabular-nums", children: parts.map((part) => (_jsxs("span", { className: "flex items-baseline gap-1.5 whitespace-nowrap", children: [_jsx("span", { "aria-hidden": true, className: "text-(color:--vk-fg-subtlest)", children: "\u00B7" }), _jsx("span", { children: part.node })] }, part.key))) })), ((sort && sortOptions && sortOptions.length > 0) || onHideGroup) && (_jsx(GridGroupMenu, { sort: sort, sortOptions: sortOptions ?? [], summary: summaryParts, onSummaryChange: onGroupSummaryChange, figures: figures, onHide: onHideGroup ? () => onHideGroup(group.key) : undefined }))] }) }), _jsx(GridCollapseRegion, { collapsed: collapsed, children: renderHeader(selectable ? renderGroupCheckbox(group.items) : undefined, group.key) })] }), _jsxs(GridCollapseRegion, { collapsed: collapsed, children: [_jsx(GridWindowRows, { groupKey: group.key, items: group.items, collapsed: collapsed, kept: keptFor(group.key), renderRow: renderRow }), renderFooter(group)] })] }));
35
31
  }
36
- export function GridBody({ empty, emptyState, grouped, groups, rows, isMobile, selectable, selecting, allSelected, someSelected, selectAll, clearSelection, isCollapsed, countOf, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, minWidth, surface, headerWheelRef, headerPanHandlers, }) {
32
+ export function GridBody({ empty, emptyState, grouped, groups, rows, selectable, selecting, allSelected, someSelected, selectAll, clearSelection, isCollapsed, countOf, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, keptFor, barIndexOf, ariaColCount, }) {
37
33
  const { messages } = useViews();
38
34
  if (empty) {
39
- return (_jsxs(_Fragment, { children: [renderHeader(false), emptyState] }));
35
+ return (_jsxs(_Fragment, { children: [_jsx(StuckMarker, {}), _jsx("div", { "data-slot": "vk-grid-head", className: cx("sticky top-0 z-20 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: renderHeader(undefined, groups[0]?.key ?? "__all__") }), _jsx("div", { role: "row", "aria-rowindex": 2, children: _jsx("div", { role: "gridcell", "aria-colspan": ariaColCount, children: _jsx("div", { className: "sticky left-0 w-[100cqw]", children: emptyState }) }) })] }));
40
36
  }
41
37
  if (!grouped) {
42
- return (_jsxs(_Fragment, { children: [!isMobile && _jsx(StuckMarker, {}), !isMobile && (_jsx("div", { className: cx("sticky top-(--vk-pinned-top,0px) z-20 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), ref: headerWheelRef, children: renderHeader(false, selectable ? (_jsx(GridHeadCheck, { selecting: selecting, allSelected: allSelected, someSelected: someSelected, onToggle: (next) => (next ? selectAll() : clearSelection()), "aria-label": messages({ key: "views.grid.select-all" }) })) : undefined) })), _jsxs(GridRowsScroller, { minWidth: minWidth, surface: surface, children: [isMobile && renderHeader(true), rows.map((row, index, items) => renderRow(row, index, items, groups[0]?.key ?? "__all__")), groups[0] != null && renderFooter(groups[0])] })] }));
38
+ return (_jsxs(_Fragment, { children: [_jsx(StuckMarker, {}), _jsx("div", { "data-slot": "vk-grid-head", className: cx("sticky top-0 z-20 data-[stuck=true]:bg-(color:--vk-ground)", GRID_HEADER_BG), children: renderHeader(selectable ? (_jsx(GridHeadCheck, { selecting: selecting, allSelected: allSelected, someSelected: someSelected, onToggle: (next) => (next ? selectAll() : clearSelection()), "aria-label": messages({ key: "views.grid.select-all" }) })) : undefined, groups[0]?.key ?? "__all__") }), _jsx(GridWindowRows, { groupKey: groups[0]?.key ?? "__all__", items: rows, collapsed: false, kept: keptFor(groups[0]?.key ?? "__all__"), renderRow: renderRow }), groups[0] != null && renderFooter(groups[0])] }));
43
39
  }
44
- return groups.map((group) => (_jsx(GridGroupSection, { group: group, collapsed: isCollapsed?.(group.key) ?? false, count: countOf ? countOf(group) : group.items.length, isMobile: isMobile, selectable: selectable, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: figures, countNoun: countNoun, renderHeader: renderHeader, renderGroupCheckbox: renderGroupCheckbox, renderRow: renderRow, renderFooter: renderFooter, minWidth: minWidth, surface: surface, headerWheelRef: headerWheelRef, headerPanHandlers: headerPanHandlers }, group.key)));
40
+ return groups.map((group) => (_jsx(GridGroupSection, { group: group, collapsed: isCollapsed?.(group.key) ?? false, count: countOf ? countOf(group) : group.items.length, selectable: selectable, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: figures, countNoun: countNoun, renderHeader: renderHeader, renderGroupCheckbox: renderGroupCheckbox, renderRow: renderRow, renderFooter: renderFooter, keptFor: keptFor, barIndex: barIndexOf?.(group.key), ariaColCount: ariaColCount }, group.key)));
45
41
  }
@@ -1,23 +1,28 @@
1
1
  "use client";
2
2
  import { jsx as _jsx } from "react/jsx-runtime";
3
- import { useDeferredValue, useMemo, useRef } from "react";
3
+ import { useDeferredValue, useMemo, useRef, useState } from "react";
4
+ import { createGridHoverStore, GridHoverContext } from "./grid-hover.js";
4
5
  import { useViews } from "../../provider/context.js";
5
6
  import { GridRailProbe, useGridRailReveal } from "./useGridRailReveal.js";
6
7
  import { useGridBatchApi } from "./useGridBatchApi.js";
7
8
  import { gridRowKey } from "../core/coordinates.js";
8
- import { useIsMobile } from "../../internal/viewport.js";
9
+ import { useDesktop } from "../../provider/desktop.js";
9
10
  import { GridRow } from "./GridRow.js";
10
11
  import { GridHeadCheck } from "./checks.js";
11
12
  import { useGridColumnLayout } from "./useGridColumnLayout.js";
12
- import { useGridScrollSync } from "./useGridScrollSync.js";
13
+ import { useGridScrollArea } from "./useGridScrollArea.js";
13
14
  import { GridHeader } from "./GridHeader.js";
14
- import { GridFooter } from "./GridFooter.js";
15
+ import { GridFooter, gridFooterShown } from "./GridFooter.js";
16
+ import { gridAriaLayout } from "../core/grid-aria.js";
15
17
  import { GridBody } from "./GridStructure.js";
16
18
  import { useGridScaleStyles } from "./useGridScaleStyles.js";
17
19
  import { useGridTableInteractionModel } from "./useGridTableInteractionModel.js";
18
20
  import { useGridTableSelection } from "./useGridTableSelection.js";
19
21
  import { useGridHeaderDrag } from "./useGridHeaderDrag.js";
20
22
  import { GridTableSurface } from "./GridTableSurface.js";
23
+ import { gridFlatRows } from "../core/flat-rows.js";
24
+ import { GridRowWindowContext, useGridRowWindow } from "./grid-row-window.js";
25
+ import { GRID_ROW_PX } from "./useGridScaleStyles.js";
21
26
  export function GridTable(props) {
22
27
  const { atoms, messages } = useViews();
23
28
  const { Loading } = atoms;
@@ -32,10 +37,10 @@ function GridTableContent(props) {
32
37
  const { atoms, messages } = useViews();
33
38
  const { LoadMore } = atoms;
34
39
  const verticalBorders = props.verticalBorders ?? true;
35
- const wrapCells = props.wrapCells ?? false;
36
40
  const scale = props.scale ?? 1;
37
- const isMobile = useIsMobile();
41
+ const phone = !useDesktop();
38
42
  const rootRef = useRef(null);
43
+ const [hoverStore] = useState(createGridHoverStore);
39
44
  const { visibleColumns, widthVarsStyle, frozenCount, frozenLeft, columnManager, gridTemplate, minWidth, resizingId, startResize, moveResize, endResize, resetColumnWidth, hideColumn, moveColumn, } = useGridColumnLayout({
40
45
  rootRef,
41
46
  columns,
@@ -45,21 +50,27 @@ function GridTableContent(props) {
45
50
  freezeIdentity,
46
51
  viewBacked: props.viewBacked,
47
52
  });
48
- const showAddColumn = !!columnManager && !isMobile;
49
- const scaleVarsStyle = useGridScaleStyles(scale, grouped, isMobile, showAddColumn);
53
+ const showAddColumn = !!columnManager && !phone;
54
+ const scaleVarsStyle = useGridScaleStyles(scale, grouped, phone, showAddColumn);
50
55
  const flatRows = useMemo(() => groups.flatMap((g) => g.items), [groups]);
56
+ const shutKey = JSON.stringify(grouped ? groups.filter((g) => isCollapsed?.(g.key)).map((g) => g.key) : []);
57
+ const flat = useMemo(() => {
58
+ const shut = new Set(JSON.parse(shutKey));
59
+ return gridFlatRows({ groups, grouped, isCollapsed: (key) => shut.has(key), getRowId });
60
+ }, [groups, grouped, shutKey, getRowId]);
51
61
  const rowIndex = useMemo(() => {
52
62
  const byKey = new Map();
53
- for (const group of groups) {
54
- for (const row of group.items) {
63
+ for (const section of flat.sections) {
64
+ for (const row of section.items) {
55
65
  const rowId = getRowId(row);
56
- const key = gridRowKey(group.key, rowId);
66
+ const key = gridRowKey(section.groupKey, rowId);
57
67
  byKey.set(key, { key, rowId, row });
58
68
  }
59
69
  }
60
70
  return byKey;
61
- }, [groups, getRowId]);
62
- const visibleRowKeys = useMemo(() => [...rowIndex.keys()], [rowIndex]);
71
+ }, [flat, getRowId]);
72
+ const visibleRowKeys = flat.visible;
73
+ const rowWindow = useGridRowWindow({ rootRef, flat, rowHeight: GRID_ROW_PX * scale });
63
74
  const { selectable, selecting, selectionState: sel, checkDrag, groupSelection, } = useGridTableSelection({
64
75
  rootRef,
65
76
  groups,
@@ -69,16 +80,70 @@ function GridTableContent(props) {
69
80
  selection,
70
81
  });
71
82
  const visibleColIds = useMemo(() => visibleColumns.map((c) => c.id), [visibleColumns]);
72
- const { rowSpansMap, selectValuesByColumn, onRangeCopy, onRangeCut, onRangeClear, onRangePaste, onPasteAtCell, inActiveRange, rangeCanClear, editingEnabled, focusedCell, editingCell, pendingByRow, settlementByRow, editSeed, focusCellSync, startEditSync, cancelEdit, commitEdit, commitBatch, refuseEdit, onExtendCell, onAddCell, handleRootPointerDown, handleRootPointerDownCapture, handleRootClickCapture, onEditorTab, onEditorEnter, } = useGridTableInteractionModel({
83
+ const sectionRowKeys = useMemo(() => flat.sections.map((s) => s.items.map((row) => gridRowKey(s.groupKey, getRowId(row)))), [flat, getRowId]);
84
+ const groupByKey = new Map(groups.map((group) => [group.key, group]));
85
+ const footerShown = (groupKey) => {
86
+ const group = grouped ? groupByKey.get(groupKey) : groups[0];
87
+ if (!group)
88
+ return false;
89
+ const hostCells = visibleColumns.map((column) => renderAggregate?.(column.id, group) ?? null);
90
+ return gridFooterShown({ interactive: !!onAggregateChange, hostCells });
91
+ };
92
+ const barMenu = grouped && ((!!sort && (sortOptions?.length ?? 0) > 0) || !!onHideGroup);
93
+ const footerKey = flat.sections.map((s) => (!s.collapsed && footerShown(s.groupKey) ? "1" : "0")).join("");
94
+ const focusShape = useMemo(() => ({
95
+ grouped,
96
+ selectable,
97
+ columnIds: visibleColIds,
98
+ addColumn: showAddColumn,
99
+ sections: flat.sections.map((s, index) => ({
100
+ groupKey: s.groupKey,
101
+ collapsed: s.collapsed,
102
+ rowKeys: sectionRowKeys[index] ?? [],
103
+ footer: footerKey[index] === "1",
104
+ menu: barMenu,
105
+ })),
106
+ }), [barMenu, flat, footerKey, grouped, sectionRowKeys, selectable, showAddColumn, visibleColIds]);
107
+ const groupOfRow = (rowKey) => flat.place.get(rowKey)?.groupKey;
108
+ const more = !!loadMore?.hasMore;
109
+ const aria = useMemo(() => gridAriaLayout({
110
+ sections: flat.sections.map((s, index) => ({
111
+ groupKey: s.groupKey,
112
+ collapsed: s.collapsed,
113
+ count: s.items.length,
114
+ footer: footerKey[index] === "1",
115
+ })),
116
+ grouped,
117
+ selectable,
118
+ columnIds: visibleColIds,
119
+ more,
120
+ }), [flat, footerKey, grouped, selectable, visibleColIds, more]);
121
+ const ariaTailIndex = aria.colCount + 1;
122
+ const ariaColOffset = selectable ? 1 : 0;
123
+ const { rowSpansMap, selectValuesByColumn, onRangeCopy, onRangeCut, onRangeClear, onRangePaste, onPasteAtCell, inActiveRange, rangeCanClear, editingEnabled, focusedCell, editingCell, pendingByRow, settlementByRow, editSeed, editWhole, focusCellSync, startEditSync, cancelEdit, commitEdit, commitBatch, refuseEdit, onExtendCell, onAddCell, handleRootPointerDown, handleRootPointerDownCapture, handleRootClickCapture, onEditorTab, onEditorEnter, enterGrid, focus, } = useGridTableInteractionModel({
73
124
  rootRef,
74
125
  props,
75
126
  rows: flatRows,
76
127
  visibleRows: visibleRowKeys,
128
+ heldRows: flat.order,
129
+ focusShape,
130
+ groupOfRow,
77
131
  rowIndex,
78
132
  visibleColumns,
79
133
  selecting,
134
+ revealRow: rowWindow.revealRow,
80
135
  });
81
- const { scrollXRef, getScroller, surface, registerHeader, headerWheelRef, headerPanHandlers } = useGridScrollSync(rootRef);
136
+ const railRow = focus.chrome?.kind === "rail" ? focus.chrome.rowKey : undefined;
137
+ const keptFor = (groupKey) => {
138
+ const kept = [];
139
+ for (const key of [focusedCell?.rowId, editingCell?.rowId, railRow]) {
140
+ const place = key != null ? flat.place.get(key) : undefined;
141
+ if (place?.groupKey === groupKey)
142
+ kept.push(place.index);
143
+ }
144
+ return kept;
145
+ };
146
+ const { areaRef, scrollXRef, getScroller } = useGridScrollArea(rootRef);
82
147
  const total = useMemo(() => groups.reduce((n, g) => n + g.items.length, 0), [groups]);
83
148
  const empty = grouped ? groups.length === 0 : total === 0;
84
149
  const rail = useGridRailReveal({ rootRef, earned: selecting || !!props.alwaysCheckboxes });
@@ -105,21 +170,23 @@ function GridTableContent(props) {
105
170
  const rowId = getRowId(row);
106
171
  const rowKey = gridRowKey(groupKey, rowId);
107
172
  const above = index > 0 ? items[index - 1] : null;
108
- return (_jsx(GridRow, { row: row, id: rowId, rowKey: rowKey, gridTemplate: gridTemplate, columns: visibleColumns, selectable: selectable, selected: sel.isSelected(rowId), selectedAbove: above != null && sel.isSelected(getRowId(above)), selecting: selecting, toggle: sel.toggle, toggleRange: sel.toggleRange, contextMenu: props.contextMenu ?? props.rowMenu, rowClassName: rowClassName, rowHref: rowHref, onOpenRow: onOpenRow, onPrefetchRow: onPrefetchRow, onOpenRelation: props.onOpenRelation, entityIcon: props.entityIcon, commands: props.commands, onRowDelete: onRowDelete, deleteLabel: props.deleteLabel, rowActions: rowActions, rowIcon: showRowIcon ? rowIcon : undefined, frozenCount: frozenCount, frozenLeft: frozenLeft, verticalBorders: verticalBorders, wrapCells: wrapCells, optionColors: optionColors, dateStyles: dateStyles, durationStyles: durationStyles, numberFormats: numberFormats, showTimeOverrides: showTimeOverrides, percentDisplays: percentDisplays, editingEnabled: editingEnabled, listConfig: listConfig, focusedColId: focusedCell?.rowId === rowKey ? focusedCell.columnId : null, editingColId: editingCell?.rowId === rowKey ? editingCell.columnId : null, editSeed: editingCell?.rowId === rowKey ? editSeed : null, onEditorTab: onEditorTab, onEditorEnter: onEditorEnter, pendingByCol: pendingByRow.get(rowId), settlementByCol: settlementByRow.get(rowId), selectValues: selectValuesByColumn, rowRange: rowRangeFor(rowKey), onFocusCell: focusCellSync, onStartEdit: startEditSync, onRefuseEdit: refuseEdit, onExtendCell: onExtendCell, onAddCell: onAddCell, onCommitCell: commitEdit, onCancelEdit: cancelEdit, inActiveRange: inActiveRange, rangeCanClear: rangeCanClear, onRangeCopy: onRangeCopy, onRangeCut: onRangeCut, onRangePaste: onRangePaste, onRangeClear: onRangeClear, onPasteAtCell: onPasteAtCell }, rowKey));
173
+ return (_jsx(GridRow, { row: row, id: rowId, rowKey: rowKey, columns: visibleColumns, selectable: selectable, selected: sel.isSelected(rowId), selectedAbove: above != null && sel.isSelected(getRowId(above)), selecting: selecting, toggle: sel.toggle, toggleRange: sel.toggleRange, contextMenu: props.contextMenu ?? props.rowMenu, rowClassName: rowClassName, rowHref: rowHref, onOpenRow: onOpenRow, onPrefetchRow: onPrefetchRow, onOpenRelation: props.onOpenRelation, entityIcon: props.entityIcon, commands: props.commands, onRowDelete: onRowDelete, deleteLabel: props.deleteLabel, rowActions: rowActions, rowIcon: showRowIcon ? rowIcon : undefined, frozenCount: frozenCount, frozenLeft: frozenLeft, verticalBorders: verticalBorders, optionColors: optionColors, dateStyles: dateStyles, durationStyles: durationStyles, numberFormats: numberFormats, showTimeOverrides: showTimeOverrides, percentDisplays: percentDisplays, editingEnabled: editingEnabled, listConfig: listConfig, focusedColId: focusedCell?.rowId === rowKey ? focusedCell.columnId : null, editingColId: editingCell?.rowId === rowKey ? editingCell.columnId : null, editSeed: editingCell?.rowId === rowKey ? editSeed : null, editWhole: editingCell?.rowId === rowKey && editWhole, onEditorTab: onEditorTab, onEditorEnter: onEditorEnter, pendingByCol: pendingByRow.get(rowId), settlementByCol: settlementByRow.get(rowId), selectValues: selectValuesByColumn, rowRange: rowRangeFor(rowKey), ariaRowIndex: aria.rowIndex(groupKey, index), ariaLevel: grouped ? 2 : undefined, ariaPosInSet: grouped ? index + 1 : undefined, ariaSetSize: grouped ? items.length : undefined, ariaColOffset: ariaColOffset, ariaTailIndex: ariaTailIndex, onFocusCell: focusCellSync, onStartEdit: startEditSync, onRefuseEdit: refuseEdit, onExtendCell: onExtendCell, onAddCell: onAddCell, onCommitCell: commitEdit, onCancelEdit: cancelEdit, inActiveRange: inActiveRange, rangeCanClear: rangeCanClear, onRangeCopy: onRangeCopy, onRangeCut: onRangeCut, onRangePaste: onRangePaste, onRangeClear: onRangeClear, onPasteAtCell: onPasteAtCell }, rowKey));
109
174
  };
110
- const header = (inline, checkbox) => (_jsx(GridHeader, { inline: inline, showAddColumn: showAddColumn && !inline, checkbox: checkbox, columns: visibleColumns, columnManager: columnManager, gridTemplate: gridTemplate, minWidth: minWidth, sort: sort, selectValues: selectValuesByColumn, optionColors: optionColors, onOptionColorChange: onOptionColorChange, dateStyles: dateStyles, onDateStyleChange: onDateStyleChange, durationStyles: durationStyles, onDurationStyleChange: onDurationStyleChange, numberFormats: numberFormats, onNumberFormatChange: onNumberFormatChange, showTimeOverrides: showTimeOverrides, onShowTimeChange: onShowTimeChange, percentDisplays: percentDisplays, onPercentDisplayChange: onPercentDisplayChange, columnStateEnabled: !!onColumnStateChange, listConfig: listConfig, groupBy: groupBy, viewBacked: props.viewBacked, formatsWritable: props.formatsWritable, renderAddColumn: props.renderAddColumn, renderColumnMenuRows: props.renderColumnMenuRows, resizingId: resizingId, startResize: startResize, moveResize: moveResize, endResize: endResize, resetColumnWidth: resetColumnWidth, hideColumn: hideColumn, moveColumn: moveColumn, headerDrag: headerDrag, registerHeader: registerHeader, frozenCount: frozenCount, frozenLeft: frozenLeft }));
111
- const footer = (group) => (_jsx(GridFooter, { group: group, columns: visibleColumns, gridTemplate: gridTemplate, selecting: selecting, aggregates: aggregates, numberFormats: numberFormats, renderAggregate: renderAggregate, onAggregateChange: onAggregateChange, viewBacked: props.viewBacked, frozenCount: frozenCount, frozenLeft: frozenLeft, continuation: props.renderGroupFooter?.(group), defaultCurrency: props.defaultCurrency }));
175
+ const header = (checkbox, groupKey) => (_jsx(GridHeader, { showAddColumn: showAddColumn, checkbox: checkbox, groupKey: groupKey, ariaRowIndex: empty ? 1 : groupKey != null ? aria.headIndex(groupKey) : undefined, ariaLevel: grouped ? 2 : undefined, ariaColOffset: ariaColOffset, ariaTailIndex: ariaTailIndex, columns: visibleColumns, columnManager: columnManager, minWidth: minWidth, sort: sort, selectValues: selectValuesByColumn, optionColors: optionColors, onOptionColorChange: onOptionColorChange, dateStyles: dateStyles, onDateStyleChange: onDateStyleChange, durationStyles: durationStyles, onDurationStyleChange: onDurationStyleChange, numberFormats: numberFormats, onNumberFormatChange: onNumberFormatChange, showTimeOverrides: showTimeOverrides, onShowTimeChange: onShowTimeChange, percentDisplays: percentDisplays, onPercentDisplayChange: onPercentDisplayChange, columnStateEnabled: !!onColumnStateChange, listConfig: listConfig, groupBy: groupBy, viewBacked: props.viewBacked, formatsWritable: props.formatsWritable, renderAddColumn: props.renderAddColumn, renderColumnMenuRows: props.renderColumnMenuRows, resizingId: resizingId, startResize: startResize, moveResize: moveResize, endResize: endResize, resetColumnWidth: resetColumnWidth, hideColumn: hideColumn, moveColumn: moveColumn, headerDrag: headerDrag, frozenCount: frozenCount, frozenLeft: frozenLeft }));
176
+ const footer = (group) => (_jsx(GridFooter, { group: group, ariaRowIndex: aria.footIndex(grouped ? group.key : (flat.sections[0]?.groupKey ?? group.key)), ariaLevel: grouped ? 2 : undefined, ariaColOffset: ariaColOffset, columns: visibleColumns, selecting: selecting, aggregates: aggregates, numberFormats: numberFormats, renderAggregate: renderAggregate, onAggregateChange: onAggregateChange, viewBacked: props.viewBacked, frozenCount: frozenCount, frozenLeft: frozenLeft, continuation: props.renderGroupFooter?.(group), defaultCurrency: props.defaultCurrency }));
112
177
  const groupCheckbox = (items) => (_jsx(GridHeadCheck, { selecting: selecting, ...groupSelection(items), "aria-label": messages({ key: "views.grid.select-group" }) }));
113
- return (_jsx(GridTableSurface, { rootRef: rootRef, style: { ...widthVarsStyle, ...scaleVarsStyle }, selecting: selecting, railRootProps: rail.rootProps, onPointerDown: (event) => {
114
- if (checkDrag.tryArm(event))
115
- return;
116
- handleRootPointerDown(event);
117
- }, onPointerDownCapture: handleRootPointerDownCapture, onClickCapture: (event) => {
118
- if (checkDrag.consumeDrag()) {
119
- event.preventDefault();
120
- event.stopPropagation();
121
- return;
122
- }
123
- handleRootClickCapture(event);
124
- }, railProbe: _jsx(GridRailProbe, { probeRef: rail.probeRef }), body: _jsx(GridBody, { empty: empty, emptyState: emptyState, grouped: grouped, groups: groups, rows: flatRows, isMobile: isMobile, selectable: selectable, selecting: selecting, allSelected: sel.allSelected, someSelected: sel.someSelected, selectAll: sel.selectAll, clearSelection: sel.clear, isCollapsed: isCollapsed, countOf: countOf, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: groupFigures, countNoun: countNoun, renderHeader: header, renderGroupCheckbox: groupCheckbox, renderRow: renderRow, renderFooter: footer, minWidth: minWidth, surface: surface, headerWheelRef: headerWheelRef, headerPanHandlers: headerPanHandlers }), loadMore: loadMore?.hasMore ? _jsx(LoadMore, { onReveal: loadMore.onReveal, label: loadMore.label }) : undefined, selectionBar: selection?.renderBar(sel, batchApi) }));
178
+ return (_jsx(GridHoverContext.Provider, { value: hoverStore, children: _jsx(GridRowWindowContext.Provider, { value: rowWindow.store, children: _jsx(GridTableSurface, { rootRef: rootRef, areaRef: areaRef, minWidth: minWidth, columnsTemplate: gridTemplate, gridAria: empty
179
+ ? { role: "grid", rowCount: 2, colCount: ariaTailIndex }
180
+ : { role: aria.role, rowCount: aria.rowCount, colCount: ariaTailIndex }, style: { ...widthVarsStyle, ...scaleVarsStyle }, selecting: selecting, railRootProps: rail.rootProps, onPointerDown: (event) => {
181
+ if (checkDrag.tryArm(event))
182
+ return;
183
+ handleRootPointerDown(event);
184
+ }, onPointerDownCapture: handleRootPointerDownCapture, onClickCapture: (event) => {
185
+ if (checkDrag.consumeDrag()) {
186
+ event.preventDefault();
187
+ event.stopPropagation();
188
+ return;
189
+ }
190
+ handleRootClickCapture(event);
191
+ }, railProbe: _jsx(GridRailProbe, { probeRef: rail.probeRef }), onGuardFocus: enterGrid, body: _jsx(GridBody, { empty: empty, emptyState: emptyState, grouped: grouped, groups: groups, rows: flatRows, selectable: selectable, selecting: selecting, allSelected: sel.allSelected, someSelected: sel.someSelected, selectAll: sel.selectAll, clearSelection: sel.clear, isCollapsed: isCollapsed, countOf: countOf, sort: sort, sortOptions: sortOptions, groupSummary: groupSummary, onToggleGroup: onToggleGroup, onGroupSummaryChange: onGroupSummaryChange, renderGroupLabel: renderGroupLabel, onHideGroup: onHideGroup, figures: groupFigures, countNoun: countNoun, renderHeader: header, renderGroupCheckbox: groupCheckbox, renderRow: renderRow, renderFooter: footer, keptFor: keptFor, barIndexOf: aria.barIndex, ariaColCount: ariaTailIndex }), loadMore: loadMore?.hasMore ? _jsx(LoadMore, { onReveal: loadMore.onReveal, label: loadMore.label }) : undefined, selectionBar: selection?.renderBar(sel, batchApi) }) }) }));
125
192
  }
@@ -1,8 +1,45 @@
1
- import type { CSSProperties, HTMLAttributes, PointerEventHandler, MouseEventHandler, ReactNode, RefObject } from "react";
2
- export declare function GridTableSurface({ rootRef, style, selecting, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, }: {
1
+ import type { CSSProperties, HTMLAttributes, PointerEventHandler, MouseEventHandler, ReactNode, RefCallback, RefObject } from "react";
2
+ /**
3
+ * The grid's frame and its one scroll area.
4
+ *
5
+ * The FRAME (`data-slot="vk-grid"`) fills the box its app gives it: `height: 100%` where the app
6
+ * gives a definite height, `flex: 1 1 0` where the app is a flex column, `min-height: 0` either way so
7
+ * the box can shrink below its rows. It doesn't scroll. It holds the CSS variables, the rail's
8
+ * signal, the pointer handlers, the selection bar and the rail probe.
9
+ *
10
+ * The AREA (`data-slot="vk-grid-scroll"`) is the one element that scrolls, both ways, on every
11
+ * screen. Every group's head pins at its top and every frozen cell sticks to its left because they
12
+ * sit in the same scrollport as the rows. It bleeds into the page's side padding (`--vk-gutter`), so
13
+ * the rows run edge to edge and their content lines up with the page. Its overflow is inline, both axes
14
+ * spelled out: it is the one property the grid's working rests on, under any stylesheet. `@container` lets a group's label
15
+ * keep to the visible width (`100cqw`) while the table is wider. `overscroll-x-contain`: a sideways
16
+ * scroll that reaches the table's edge stops there and never swipes the browser back a page. Down
17
+ * and up chain as usual, so where the app gives the grid no height a wheel over it still scrolls the
18
+ * page.
19
+ *
20
+ * A frame with no height (an app that hasn't given one) grows to its rows: the page scrolls it, and
21
+ * its heads don't pin.
22
+ */
23
+ export declare function GridTableSurface({ rootRef, areaRef, style, selecting, minWidth, columnsTemplate, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, onGuardFocus, gridAria, }: {
24
+ /** What a screen reader is told of the whole table: a grid (a tree grid when grouped), its rows (-1 while more
25
+ * remain to load) and its columns. */
26
+ gridAria?: {
27
+ role: "grid" | "treegrid";
28
+ rowCount: number;
29
+ colCount: number;
30
+ };
3
31
  rootRef: RefObject<HTMLDivElement | null>;
32
+ /** A guard took the focus: `from` is where it came from (the browser's Tab from before or after the grid, or the
33
+ * grid itself handing focus on as it is left). */
34
+ onGuardFocus?: (which: "start" | "end", from: Element | null) => void;
35
+ /** The scroll area's ref (`useGridScrollArea`). */
36
+ areaRef: RefCallback<HTMLDivElement>;
4
37
  style: CSSProperties;
5
38
  selecting: boolean;
39
+ /** The table's minimum width: the content box is never narrower, so every head spans the table. */
40
+ minWidth: string;
41
+ /** The columns' template, set once on the area as `--vk-cols`: every row, head and footer reads it. */
42
+ columnsTemplate: string;
6
43
  railRootProps: HTMLAttributes<HTMLDivElement>;
7
44
  onPointerDown: PointerEventHandler<HTMLDivElement>;
8
45
  /** Marks a press as the grid's own, its portaled popups' included: the click-away reads it. */
@@ -1,6 +1,15 @@
1
1
  "use client";
2
- import { jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { cx } from "../../internal/cx.js";
4
- export function GridTableSurface({ rootRef, style, selecting, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, }) {
5
- return (_jsxs("div", { ref: rootRef, style: style, className: cx("group/gridtable relative animate-fade-in", selecting && "pb-14"), "data-slot": "vk-grid", ...railRootProps, onPointerDown: onPointerDown, onPointerDownCapture: onPointerDownCapture, onClickCapture: onClickCapture, children: [body, loadMore, selectionBar, railProbe] }));
4
+ import { GRID_BLEED } from "./grid-styles.js";
5
+ export function GridTableSurface({ rootRef, areaRef, style, selecting, minWidth, columnsTemplate, railRootProps, onPointerDown, onPointerDownCapture, onClickCapture, railProbe, body, loadMore, selectionBar, onGuardFocus, gridAria, }) {
6
+ return (_jsxs("div", { ref: rootRef, style: style, tabIndex: -1, className: "group/gridtable relative flex h-full min-h-0 flex-1 flex-col animate-fade-in outline-none", "data-slot": "vk-grid", ...railRootProps, onPointerDown: onPointerDown, onPointerDownCapture: onPointerDownCapture, onClickCapture: onClickCapture, children: [_jsx("span", { "data-grid-guard": "start", tabIndex: 0, className: "absolute size-0 overflow-hidden outline-none", onFocus: (event) => onGuardFocus?.("start", event.relatedTarget) }), _jsx("div", { ref: areaRef, "data-slot": "vk-grid-scroll", className: cx("@container min-h-0 flex-1 overscroll-x-contain", GRID_BLEED), style: {
7
+ overflowX: "auto",
8
+ overflowY: "auto",
9
+ scrollPaddingBottom: "var(--vk-scroll-inset-bottom,0px)",
10
+ "--vk-cols": columnsTemplate,
11
+ }, children: _jsxs("div", { className: "relative", role: gridAria?.role, "aria-rowcount": gridAria?.rowCount, "aria-colcount": gridAria?.colCount, "aria-multiselectable": gridAria ? true : undefined, style: {
12
+ minWidth,
13
+ paddingBottom: `calc(${selecting ? "3.5rem" : "0.5rem"} + var(--vk-scroll-inset-bottom,0px))`,
14
+ }, children: [body, loadMore ? (_jsx("div", { role: "row", children: _jsx("div", { role: "gridcell", "aria-colspan": gridAria?.colCount, children: loadMore }) })) : null] }) }), _jsx("span", { "data-grid-guard": "end", tabIndex: 0, className: "absolute size-0 overflow-hidden outline-none", onFocus: (event) => onGuardFocus?.("end", event.relatedTarget) }), selectionBar, railProbe] }));
6
15
  }
@@ -1,5 +1,36 @@
1
- export declare function GridTextEditor({ initial, strong, onCommit, onCancel, onTab, onEnter, }: {
1
+ import { type ReactNode } from "react";
2
+ import { type OpenableType } from "../../editors/open-value.js";
3
+ import { type TextEditorType } from "../../editors/TextEditor.js";
4
+ /** The text editor's type for a grid column's type: the six text types as they are, a title and
5
+ * anything else as plain text. */
6
+ export declare function gridTextEditorType(colType: string | undefined): TextEditorType;
7
+ /**
8
+ * The GRID's text cell, hosting the shared `TextEditor` through the grid's edit session. On a
9
+ * desktop it types in the cell (the spreadsheet's typing): Enter, Tab and a click away write at
10
+ * once and move on as the key says; Escape throws the edit away; an unchanged value writes nothing
11
+ * and still moves on. A value the grid would refuse (an email that isn't one) stays in the cell
12
+ * with its reason under it.
13
+ *
14
+ * On a phone it opens in the sheet, titled with the column's header (`EditorPanel`, `sheetOnPhone`):
15
+ * ✕ and a swipe change nothing, ✓ saves and closes without moving the selection, and the write waits
16
+ * for the sheet to slide away.
17
+ */
18
+ export declare function GridTextEditor({ initial, seed, type, title, strong, open, refuse, onCommit, onCancel, onTab, onEnter, }: {
19
+ /** The stored email, phone, link or domain the sheet's open action follows (mail, call or browse), drawn
20
+ * beside the box on a phone, where a tap on the cell edits it. Gone once the box is typed over: it opens
21
+ * what is stored, never a draft. */
22
+ open?: {
23
+ type: OpenableType;
24
+ value: unknown;
25
+ };
26
+ /** The stored value; also the draft when no `seed` is given. */
2
27
  initial: string;
28
+ /** Type-to-replace: the character that opened this editor; the draft opens on it. */
29
+ seed?: string;
30
+ /** The field's text type: the keyboard the box brings. Default `text`. */
31
+ type?: TextEditorType;
32
+ /** The sheet's title on a phone: the column's header. */
33
+ title?: ReactNode;
3
34
  /** Title columns render medium-weight — match it while editing. */
4
35
  strong?: boolean;
5
36
  onCommit: (value: string) => void;
@@ -8,4 +39,7 @@ export declare function GridTextEditor({ initial, strong, onCommit, onCancel, on
8
39
  onTab?: (backwards: boolean) => void;
9
40
  /** Commit happened via Enter — advance one row down (Sheets). */
10
41
  onEnter?: () => void;
42
+ /** The grid's judgement of a value before it is written: its reason when it would refuse it.
43
+ * A refused value stays in the box with that reason. */
44
+ refuse?: (value: string) => string | null;
11
45
  }): import("react/jsx-runtime").JSX.Element;
@@ -1,40 +1,38 @@
1
1
  "use client";
2
- import { jsx as _jsx } from "react/jsx-runtime";
3
- import { useEffect, useRef } from "react";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef, useState } from "react";
4
+ import { EditorPanel } from "../../editors/EditorPanel.js";
5
+ import { OpenValueAction } from "../../editors/open-value.js";
6
+ import { TextEditor, } from "../../editors/TextEditor.js";
4
7
  import { cx } from "../../internal/cx.js";
5
- export function GridTextEditor({ initial, strong = false, onCommit, onCancel, onTab, onEnter, }) {
6
- const inputRef = useRef(null);
7
- const doneRef = useRef(false);
8
- useEffect(() => {
9
- const el = inputRef.current;
10
- if (!el)
11
- return;
12
- el.focus();
13
- const len = el.value.length;
14
- el.setSelectionRange(len, len);
15
- }, []);
16
- const commit = () => {
17
- if (doneRef.current)
18
- return;
19
- doneRef.current = true;
20
- onCommit(inputRef.current?.value ?? "");
21
- };
22
- return (_jsx("input", { ref: inputRef, defaultValue: initial, "data-slot": "vk-grid-editor", "data-grid-editor": true, onKeyDown: (e) => {
23
- e.stopPropagation();
24
- if (e.key === "Enter") {
25
- e.preventDefault();
26
- commit();
27
- onEnter?.();
28
- }
29
- else if (e.key === "Escape") {
30
- doneRef.current = true;
31
- onCancel();
32
- }
33
- else if (e.key === "Tab") {
34
- e.preventDefault();
35
- const backwards = e.shiftKey;
36
- commit();
37
- onTab?.(backwards);
38
- }
39
- }, onBlur: () => commit(), onClick: (e) => e.stopPropagation(), className: cx("h-full w-full min-w-0 select-text bg-transparent text-(length:--vk-text) text-(color:--vk-fg) outline-hidden placeholder:text-(color:--vk-fg-subtlest)", strong && "font-medium") }));
8
+ import { GridRefusal, useGridEditSession } from "./grid-edit-session.js";
9
+ const TEXT_TYPES = new Set([
10
+ "text",
11
+ "url",
12
+ "domain",
13
+ "email",
14
+ "phone",
15
+ "rich_text",
16
+ ]);
17
+ export function gridTextEditorType(colType) {
18
+ return colType && TEXT_TYPES.has(colType) ? colType : "text";
19
+ }
20
+ export function GridTextEditor({ initial, seed, type = "text", title, strong = false, open, refuse, onCommit, onCancel, onTab, onEnter, }) {
21
+ const editorRef = useRef(null);
22
+ const { session, close } = useGridEditSession({
23
+ editorRef,
24
+ inPlace: true,
25
+ refuse: refuse && ((value) => refuse(value)),
26
+ onCommit: (payload) => onCommit(payload),
27
+ onCancel,
28
+ onTab,
29
+ onEnter,
30
+ });
31
+ const [stored, setStored] = useState(seed === undefined);
32
+ return (_jsx(EditorPanel, { session: session, title: title ?? "", anchor: null, inPlace: true, sheetOnPhone: true, children: (surface) => {
33
+ const editor = (_jsx(TextEditor, { ref: editorRef, type: type, initial: initial, seed: seed, closeOnBlur: surface === "in-place", chrome: surface === "sheet" ? "field" : "bare", boxData: { "data-slot": "vk-grid-editor", "data-grid-editor": "" }, onRequestClose: close, className: surface === "sheet"
34
+ ? "w-full min-w-0 select-text"
35
+ : cx("h-full w-full min-w-0 select-text bg-transparent text-(length:--vk-text) text-(color:--vk-fg) outline-hidden placeholder:text-(color:--vk-fg-subtlest)", strong && "font-medium") }));
36
+ return surface === "sheet" ? (open ? (_jsxs("div", { className: "flex items-center gap-2 px-4 pb-4", onInput: (e) => setStored(e.target.value === initial), children: [_jsx("div", { className: "min-w-0 flex-1", children: editor }), stored && _jsx(OpenValueAction, { type: open.type, value: open.value, label: initial })] })) : (_jsx("div", { className: "px-4 pb-4", children: editor }))) : (_jsxs("span", { className: "relative flex h-full w-full min-w-0", children: [editor, _jsx(GridRefusal, { reason: session.refusal })] }));
37
+ } }));
40
38
  }
@@ -1,15 +1,27 @@
1
+ import { type ReactNode } from "react";
1
2
  import type { FieldDefOf, MultipleType, ValueItem } from "@viewkitjs/fields";
2
3
  /**
3
4
  * The GRID's host around the shared `ValueListEditor`. Anchored, like the name
4
5
  * editor: a list of rows does not fit a cell, so it opens in a panel under it
5
- * while the cell's own values stay on screen. No seed: a key typed on a list
6
- * cell opens the list as it is (`useGridKeyboard`'s `seedable`).
6
+ * while the cell's own values stay on screen. The edit session owns the
7
+ * one-answer guard and the exit gap; the editor panel opens the popover on a
8
+ * desktop and the sheet on a phone, titled with the column's header. No seed: a
9
+ * key typed on a list cell opens the list as it is (`useGridKeyboard`'s
10
+ * `seedable`).
7
11
  */
8
- export declare function GridValueListEditor({ field, initial, labels, allowEmpty, onCommit, onCancel, onTab, onEnter, }: {
12
+ export declare function GridValueListEditor({ field, title, initial, labels, allowEmpty, region, refuse, onCommit, onCancel, onTab, onEnter, }: {
9
13
  field: FieldDefOf<MultipleType>;
14
+ /** The field's name: the sheet's title on a phone. */
15
+ title: ReactNode;
10
16
  initial: unknown;
11
17
  labels: boolean;
18
+ /** Every value removed commits `null`; without it, an emptied list closes unchanged. */
12
19
  allowEmpty?: boolean;
20
+ /** The row's country, where a phone typed without its code is read. */
21
+ region?: string | null;
22
+ /** The grid's judgement of the list it is about to write: its reason, or null. A refused list stays open
23
+ * with the reason under it. */
24
+ refuse?: (payload: ValueItem<unknown>[] | null) => string | null;
13
25
  onCommit: (payload: ValueItem<unknown>[] | null) => void;
14
26
  onCancel: () => void;
15
27
  onTab?: (backwards: boolean) => void;
@@ -1,36 +1,19 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useRef } from "react";
4
- import { useAnchoredEditSession } from "../../editors/edit-session.js";
4
+ import { EditorPanel } from "../../editors/EditorPanel.js";
5
5
  import { ValueListEditor } from "../../editors/ValueListEditor.js";
6
- import { useViews } from "../../provider/context.js";
7
- export function GridValueListEditor({ field, initial, labels, allowEmpty = false, onCommit, onCancel, onTab, onEnter, }) {
8
- const { Popover } = useViews().components;
6
+ import { useGridEditSession } from "./grid-edit-session.js";
7
+ export function GridValueListEditor({ field, title, initial, labels, allowEmpty = false, region, refuse, onCommit, onCancel, onTab, onEnter, }) {
9
8
  const anchorRef = useRef(null);
10
9
  const editorRef = useRef(null);
11
- const viaRef = useRef(null);
12
- const { open, close } = useAnchoredEditSession({
10
+ const { session, close } = useGridEditSession({
13
11
  editorRef,
14
- onDone: (resolution) => {
15
- if (resolution.kind === "commit") {
16
- onCommit(resolution.payload);
17
- if (viaRef.current === "enter")
18
- onEnter?.();
19
- if (viaRef.current === "tab")
20
- onTab?.(false);
21
- if (viaRef.current === "shift-tab")
22
- onTab?.(true);
23
- }
24
- else
25
- onCancel();
26
- },
12
+ refuse: refuse ? (payload) => refuse(payload) : undefined,
13
+ onCommit: (payload) => onCommit(payload),
14
+ onCancel,
15
+ onTab,
16
+ onEnter,
27
17
  });
28
- const closeVia = (reason) => {
29
- viaRef.current = reason;
30
- close(reason);
31
- };
32
- return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(Popover, { open: open, onOpenChange: (next) => {
33
- if (!next)
34
- closeVia("outside");
35
- }, anchor: anchorRef, align: "start", sideOffset: 4, onEscape: () => closeVia("escape"), onOutsidePress: () => closeVia("outside"), initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "z-90 w-96 p-2", children: _jsx(ValueListEditor, { ref: editorRef, field: field, initial: initial, labels: labels, allowEmpty: allowEmpty, onRequestClose: closeVia }) })] }));
18
+ return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(EditorPanel, { session: session, title: title, anchor: anchorRef, align: "start", sideOffset: 4, initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "z-90 w-96 p-2", children: (surface) => (_jsx(ValueListEditor, { ref: editorRef, field: field, initial: initial, labels: labels, allowEmpty: allowEmpty, region: region, openLinks: surface === "sheet", onRequestClose: close })) })] }));
36
19
  }
@@ -0,0 +1,11 @@
1
+ import type { GridCellPos } from "../core/coordinates.js";
2
+ /**
3
+ * True when something inside the cell clips its value across: the ellipsis a `truncate` draws.
4
+ * Only an element that clips counts, and never the cell itself: a focused cell drops its clip and
5
+ * draws its fill handle past its edge, which widens what it scrolls without cutting anything off.
6
+ * An element with no box of its own (an inline span, width 0) counts for nothing. False for no cell.
7
+ */
8
+ export declare function gridCellCutOff(cell: Element | null): boolean;
9
+ /** The drawn cell at `pos` inside `root` (the grid's frame), or null when the page holds no such
10
+ * row. */
11
+ export declare function findGridCell(root: ParentNode | null, pos: GridCellPos): Element | null;
@@ -0,0 +1,20 @@
1
+ function clips(el) {
2
+ const style = getComputedStyle(el);
3
+ if (style.overflowX && style.overflowX !== "visible")
4
+ return true;
5
+ const across = style.overflow.split(" ")[0];
6
+ return !!across && across !== "visible";
7
+ }
8
+ export function gridCellCutOff(cell) {
9
+ if (!cell)
10
+ return false;
11
+ for (const el of cell.querySelectorAll("*")) {
12
+ if (el.clientWidth > 0 && el.scrollWidth > el.clientWidth && clips(el))
13
+ return true;
14
+ }
15
+ return false;
16
+ }
17
+ export function findGridCell(root, pos) {
18
+ const row = root?.querySelector(`[data-row-id="${CSS.escape(pos.rowId)}"]`);
19
+ return row?.querySelector(`[data-col-id="${CSS.escape(pos.columnId)}"]`) ?? null;
20
+ }
@@ -1,6 +1,5 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { cx } from "../../internal/cx.js";
4
3
  import { GridActionButton } from "./GridRowActions.js";
5
4
  import { renderTypedCellValue } from "../../cells/cell-values.js";
6
5
  export { formatDate, formatNumber } from "../../cells/cell-format.js";
@@ -11,7 +10,7 @@ export function renderTypedCell(col, row, opts) {
11
10
  const indicator = col.indicator?.(row);
12
11
  if (!indicator)
13
12
  return cell;
14
- return (_jsxs("span", { className: cx("flex min-w-0 flex-1 flex-wrap content-start items-center gap-x-1.5 overflow-hidden", !opts?.wrap && "h-(--vk-line-h) leading-(--vk-line-h)"), children: [_jsx("span", { className: cx("max-w-full", opts?.wrap ? "min-w-0" : "flex-none truncate"), children: cell }), indicator] }));
13
+ return (_jsxs("span", { className: "flex h-(--vk-line-h) min-w-0 flex-1 flex-wrap content-start items-center gap-x-1.5 overflow-hidden leading-(--vk-line-h)", children: [_jsx("span", { className: "max-w-full flex-none truncate", children: cell }), indicator] }));
15
14
  }
16
15
  export function renderActionCell(col, row) {
17
16
  if (!col.actions?.length)