@viewkitjs/views 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +196 -1
  2. package/README.md +90 -41
  3. package/dist/atoms/Row.js +1 -1
  4. package/dist/atoms/RowMenu.d.ts +1 -1
  5. package/dist/atoms/RowMenu.js +15 -4
  6. package/dist/atoms/types.d.ts +4 -4
  7. package/dist/contract.d.ts +37 -7
  8. package/dist/contract.js +24 -5
  9. package/dist/display/format.d.ts +16 -1
  10. package/dist/display/format.js +10 -1
  11. package/dist/display/index.d.ts +1 -1
  12. package/dist/display/index.js +1 -1
  13. package/dist/display/link.js +5 -3
  14. package/dist/display/location.d.ts +4 -3
  15. package/dist/display/location.js +12 -5
  16. package/dist/display/options.d.ts +1 -1
  17. package/dist/display/percent.js +10 -3
  18. package/dist/display/phone.d.ts +2 -1
  19. package/dist/display/phone.js +8 -1
  20. package/dist/display/relation.js +1 -1
  21. package/dist/editors/ChipsEditor.js +1 -1
  22. package/dist/editors/LocationEditor.js +16 -17
  23. package/dist/editors/NameEditor.js +5 -4
  24. package/dist/editors/NumberEditor.js +2 -2
  25. package/dist/editors/RangeEditor.js +2 -2
  26. package/dist/editors/ValueListEditor.d.ts +2 -2
  27. package/dist/editors/ValueListEditor.js +8 -8
  28. package/dist/editors/edit-cores.d.ts +1 -1
  29. package/dist/fields/binding.d.ts +1 -1
  30. package/dist/fields/currency.d.ts +0 -10
  31. package/dist/fields/currency.js +0 -14
  32. package/dist/fields/money.d.ts +1 -0
  33. package/dist/fields/money.js +1 -0
  34. package/dist/filters/filter-model.d.ts +0 -1
  35. package/dist/filters/registry.d.ts +3 -36
  36. package/dist/filters/registry.js +0 -38
  37. package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
  38. package/dist/grid/chrome/GridAddColumn.js +29 -0
  39. package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
  40. package/dist/grid/chrome/GridAggregateMenu.js +27 -0
  41. package/dist/grid/chrome/GridCellEditors.d.ts +64 -0
  42. package/dist/grid/chrome/GridCellEditors.js +55 -0
  43. package/dist/grid/chrome/GridCellOutline.d.ts +70 -0
  44. package/dist/grid/chrome/GridCellOutline.js +21 -0
  45. package/dist/grid/chrome/GridChipsEditor.d.ts +28 -0
  46. package/dist/grid/chrome/GridChipsEditor.js +40 -0
  47. package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
  48. package/dist/grid/chrome/GridColumnColorSection.js +40 -0
  49. package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
  50. package/dist/grid/chrome/GridColumnDateSection.js +23 -0
  51. package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
  52. package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
  53. package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
  54. package/dist/grid/chrome/GridColumnMenu.js +99 -0
  55. package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
  56. package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
  57. package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
  58. package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
  59. package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
  60. package/dist/grid/chrome/GridColumnSortSection.js +16 -0
  61. package/dist/grid/chrome/GridDateEditor.d.ts +22 -0
  62. package/dist/grid/chrome/GridDateEditor.js +31 -0
  63. package/dist/grid/chrome/GridFlyout.d.ts +44 -0
  64. package/dist/grid/chrome/GridFlyout.js +80 -0
  65. package/dist/grid/chrome/GridFooter.d.ts +23 -0
  66. package/dist/grid/chrome/GridFooter.js +81 -0
  67. package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
  68. package/dist/grid/chrome/GridGroupMenu.js +57 -0
  69. package/dist/grid/chrome/GridHeader.d.ts +61 -0
  70. package/dist/grid/chrome/GridHeader.js +37 -0
  71. package/dist/grid/chrome/GridLongTextEditor.d.ts +36 -0
  72. package/dist/grid/chrome/GridLongTextEditor.js +127 -0
  73. package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
  74. package/dist/grid/chrome/GridMenuRow.js +15 -0
  75. package/dist/grid/chrome/GridNameEditor.d.ts +19 -0
  76. package/dist/grid/chrome/GridNameEditor.js +36 -0
  77. package/dist/grid/chrome/GridNumberEditor.d.ts +35 -0
  78. package/dist/grid/chrome/GridNumberEditor.js +25 -0
  79. package/dist/grid/chrome/GridRangeEditor.d.ts +20 -0
  80. package/dist/grid/chrome/GridRangeEditor.js +25 -0
  81. package/dist/grid/chrome/GridRelationEditor.d.ts +21 -0
  82. package/dist/grid/chrome/GridRelationEditor.js +30 -0
  83. package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
  84. package/dist/grid/chrome/GridResizeHandle.js +19 -0
  85. package/dist/grid/chrome/GridRow.d.ts +25 -0
  86. package/dist/grid/chrome/GridRow.js +136 -0
  87. package/dist/grid/chrome/GridRowActions.d.ts +32 -0
  88. package/dist/grid/chrome/GridRowActions.js +25 -0
  89. package/dist/grid/chrome/GridRowCells.d.ts +4 -0
  90. package/dist/grid/chrome/GridRowCells.js +133 -0
  91. package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
  92. package/dist/grid/chrome/GridRowGlyph.js +13 -0
  93. package/dist/grid/chrome/GridSelectEditor.d.ts +18 -0
  94. package/dist/grid/chrome/GridSelectEditor.js +49 -0
  95. package/dist/grid/chrome/GridStructure.d.ts +48 -0
  96. package/dist/grid/chrome/GridStructure.js +45 -0
  97. package/dist/grid/chrome/GridTable.d.ts +4 -0
  98. package/dist/grid/chrome/GridTable.js +125 -0
  99. package/dist/grid/chrome/GridTableSurface.d.ts +15 -0
  100. package/dist/grid/chrome/GridTableSurface.js +6 -0
  101. package/dist/grid/chrome/GridTextEditor.d.ts +11 -0
  102. package/dist/grid/chrome/GridTextEditor.js +40 -0
  103. package/dist/grid/chrome/GridValueListEditor.d.ts +18 -0
  104. package/dist/grid/chrome/GridValueListEditor.js +36 -0
  105. package/dist/grid/chrome/StuckMarker.d.ts +16 -0
  106. package/dist/grid/chrome/StuckMarker.js +34 -0
  107. package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
  108. package/dist/grid/chrome/cell-clipboard.js +28 -0
  109. package/dist/grid/chrome/cells.d.ts +21 -0
  110. package/dist/grid/chrome/cells.js +20 -0
  111. package/dist/grid/chrome/checks.d.ts +35 -0
  112. package/dist/grid/chrome/checks.js +22 -0
  113. package/dist/grid/chrome/column-glyph.d.ts +14 -0
  114. package/dist/grid/chrome/column-glyph.js +44 -0
  115. package/dist/grid/chrome/editors.d.ts +9 -0
  116. package/dist/grid/chrome/editors.js +10 -0
  117. package/dist/grid/chrome/grid-cell-classes.d.ts +59 -0
  118. package/dist/grid/chrome/grid-cell-classes.js +30 -0
  119. package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
  120. package/dist/grid/chrome/grid-menu-search.js +7 -0
  121. package/dist/grid/chrome/grid-row-props.d.ts +131 -0
  122. package/dist/grid/chrome/grid-row-props.js +1 -0
  123. package/dist/grid/chrome/grid-styles.d.ts +37 -0
  124. package/dist/grid/chrome/grid-styles.js +8 -0
  125. package/dist/grid/chrome/grid-table-props.d.ts +173 -0
  126. package/dist/grid/chrome/grid-table-props.js +1 -0
  127. package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
  128. package/dist/grid/chrome/useGridBatchApi.js +35 -0
  129. package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
  130. package/dist/grid/chrome/useGridColumnLayout.js +206 -0
  131. package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
  132. package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
  133. package/dist/grid/chrome/useGridKeyboard.d.ts +47 -0
  134. package/dist/grid/chrome/useGridKeyboard.js +274 -0
  135. package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
  136. package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
  137. package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
  138. package/dist/grid/chrome/useGridRailReveal.js +67 -0
  139. package/dist/grid/chrome/useGridRangeActions.d.ts +49 -0
  140. package/dist/grid/chrome/useGridRangeActions.js +188 -0
  141. package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
  142. package/dist/grid/chrome/useGridRangeGestures.js +190 -0
  143. package/dist/grid/chrome/useGridRowContextMenu.d.ts +35 -0
  144. package/dist/grid/chrome/useGridRowContextMenu.js +127 -0
  145. package/dist/grid/chrome/useGridScaleStyles.d.ts +1 -0
  146. package/dist/grid/chrome/useGridScaleStyles.js +29 -0
  147. package/dist/grid/chrome/useGridScrollSync.d.ts +38 -0
  148. package/dist/grid/chrome/useGridScrollSync.js +176 -0
  149. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +55 -0
  150. package/dist/grid/chrome/useGridTableInteractionModel.js +197 -0
  151. package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
  152. package/dist/grid/chrome/useGridTableSelection.js +55 -0
  153. package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
  154. package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
  155. package/dist/grid/core/clipboard-model.d.ts +81 -0
  156. package/dist/grid/core/clipboard-model.js +291 -0
  157. package/dist/grid/core/column-values.d.ts +27 -0
  158. package/dist/grid/core/column-values.js +76 -0
  159. package/dist/grid/core/commit-model.d.ts +34 -0
  160. package/dist/grid/core/commit-model.js +3 -0
  161. package/dist/grid/core/coordinates.d.ts +48 -0
  162. package/dist/grid/core/coordinates.js +27 -0
  163. package/dist/grid/core/edit-values.d.ts +9 -0
  164. package/dist/grid/core/edit-values.js +1 -0
  165. package/dist/grid/core/editing-controller.d.ts +59 -0
  166. package/dist/grid/core/editing-controller.js +240 -0
  167. package/dist/grid/core/editing-model.d.ts +78 -0
  168. package/dist/grid/core/editing-model.js +136 -0
  169. package/dist/grid/core/grid-scale.d.ts +14 -0
  170. package/dist/grid/core/grid-scale.js +8 -0
  171. package/dist/grid/core/nav.d.ts +94 -0
  172. package/dist/grid/core/nav.js +92 -0
  173. package/dist/grid/core/pending-reconciliation.d.ts +50 -0
  174. package/dist/grid/core/pending-reconciliation.js +49 -0
  175. package/dist/grid/core/range-model.d.ts +25 -0
  176. package/dist/grid/core/range-model.js +59 -0
  177. package/dist/grid/core/spreadsheet-operations.d.ts +85 -0
  178. package/dist/grid/core/spreadsheet-operations.js +253 -0
  179. package/dist/grid/core/useGridEditing.d.ts +43 -0
  180. package/dist/grid/core/useGridEditing.js +90 -0
  181. package/dist/grid/core/useGridRange.d.ts +20 -0
  182. package/dist/grid/core/useGridRange.js +24 -0
  183. package/dist/grid/core/value-equality.d.ts +32 -0
  184. package/dist/grid/core/value-equality.js +34 -0
  185. package/dist/grid/index.d.ts +18 -0
  186. package/dist/grid/index.js +5 -0
  187. package/dist/grid/useGridTablePrefs.d.ts +50 -0
  188. package/dist/grid/useGridTablePrefs.js +101 -0
  189. package/dist/index.d.ts +0 -1
  190. package/dist/index.js +0 -1
  191. package/dist/internal/viewport.d.ts +5 -0
  192. package/dist/internal/viewport.js +29 -0
  193. package/dist/model/column-capabilities.d.ts +2 -2
  194. package/dist/model/column-state.d.ts +1 -1
  195. package/dist/model/density.js +3 -3
  196. package/dist/model/filter-capabilities.d.ts +1 -1
  197. package/dist/model/filter-capabilities.js +1 -1
  198. package/dist/model/index.d.ts +4 -6
  199. package/dist/model/index.js +0 -1
  200. package/dist/model/preferences.d.ts +7 -3
  201. package/dist/provider/ViewsProvider.d.ts +1 -1
  202. package/dist/provider/ViewsProvider.js +5 -1
  203. package/dist/provider/components.d.ts +16 -8
  204. package/dist/provider/context.d.ts +3 -2
  205. package/dist/provider/menu-groups.d.ts +8 -0
  206. package/dist/provider/menu-groups.js +38 -0
  207. package/dist/provider/ports.d.ts +22 -0
  208. package/dist/provider/ports.js +1 -0
  209. package/dist/react.d.ts +1 -1
  210. package/docs/contract.md +128 -56
  211. package/docs/getting-started.md +250 -0
  212. package/docs/guides/atoms.md +245 -0
  213. package/docs/guides/cells.md +302 -0
  214. package/docs/guides/columns.md +412 -0
  215. package/docs/guides/display.md +203 -0
  216. package/docs/guides/editors.md +404 -0
  217. package/docs/guides/ports.md +246 -0
  218. package/docs/guides/selection.md +270 -0
  219. package/docs/guides/the-grid.md +677 -0
  220. package/docs/guides/the-provider.md +446 -0
  221. package/docs/index.md +50 -0
  222. package/docs/install.md +9 -47
  223. package/docs/reference/cells.md +28 -0
  224. package/docs/reference/display.md +42 -0
  225. package/docs/reference/editors-chips.md +6 -0
  226. package/docs/reference/editors-date.md +6 -0
  227. package/docs/reference/editors-location.md +10 -0
  228. package/docs/reference/editors-name.md +6 -0
  229. package/docs/reference/editors-number.md +11 -0
  230. package/docs/reference/editors-open-values.md +9 -0
  231. package/docs/reference/editors-range.md +6 -0
  232. package/docs/reference/editors-relation.md +9 -0
  233. package/docs/reference/editors-select.md +8 -0
  234. package/docs/reference/editors-session.md +9 -0
  235. package/docs/reference/editors-value-list.md +6 -0
  236. package/docs/reference/editors.md +5 -0
  237. package/docs/reference/grid.md +39 -0
  238. package/docs/reference/react.md +86 -0
  239. package/docs/reference/selection.md +33 -0
  240. package/docs/reference/views.md +601 -0
  241. package/package.json +7 -3
  242. package/skills/views/SKILL.md +20 -5
  243. package/dist/filters/types.d.ts +0 -27
  244. package/dist/filters/types.js +0 -1
  245. package/dist/model/filter-pushdown.d.ts +0 -106
  246. package/dist/model/filter-pushdown.js +0 -147
@@ -0,0 +1,206 @@
1
+ "use client";
2
+ import { useCallback, useMemo, useRef, useState, } from "react";
3
+ import { baseColumnOrder, columnPlacedByView, resolveViewColumnOrder, } from "../../model/column-capabilities.js";
4
+ import { gridWidthVar } from "../core/grid-scale.js";
5
+ import { clampColumnWidth, columnHideable, isColumnHidden, prettifyOptionValue, resolveColumnOrder, resolveColumnWidths, resolveVisibleColumns, toggleColumnHidden, } from "../../model/column-state.js";
6
+ import { useViews } from "../../provider/context.js";
7
+ import { gridColumnGlyph } from "./column-glyph.js";
8
+ function setBodyResizeState(active) {
9
+ document.body.style.cursor = active ? "col-resize" : "";
10
+ document.body.style.userSelect = active ? "none" : "";
11
+ }
12
+ export function useGridColumnLayout({ rootRef, columns, columnState, onColumnStateChange, scale, freezeIdentity = true, viewBacked = false, }) {
13
+ const { icons, components } = useViews();
14
+ const orderKey = columnState?.order;
15
+ const hiddenKey = columnState?.hidden;
16
+ const shownKey = columnState?.visible;
17
+ const visibleColumns = useMemo(() => {
18
+ if (!viewBacked) {
19
+ return resolveVisibleColumns(columns, {
20
+ order: orderKey,
21
+ hidden: hiddenKey,
22
+ visible: shownKey,
23
+ });
24
+ }
25
+ const managedIds = new Set(columns.filter(columnPlacedByView).map((column) => column.id));
26
+ return resolveVisibleColumns(columns, {
27
+ order: resolveViewColumnOrder(columns, orderKey),
28
+ hidden: hiddenKey?.filter((id) => managedIds.has(id)),
29
+ visible: shownKey?.filter((id) => managedIds.has(id)),
30
+ });
31
+ }, [columns, orderKey, hiddenKey, shownKey, viewBacked]);
32
+ const effectiveWidths = useMemo(() => resolveColumnWidths(visibleColumns, columnState?.widths), [visibleColumns, columnState?.widths]);
33
+ const frozenCount = useMemo(() => {
34
+ if (!freezeIdentity)
35
+ return 0;
36
+ const i = visibleColumns.findIndex((c) => c.type === "title");
37
+ if (i < 0)
38
+ return 0;
39
+ return Math.max(0, Math.min(i + 1, visibleColumns.length - 1));
40
+ }, [freezeIdentity, visibleColumns]);
41
+ const frozenLeft = useCallback((i) => `calc(var(--vk-rail-w)` +
42
+ visibleColumns
43
+ .slice(0, i)
44
+ .map((c) => ` + var(${gridWidthVar(c.id)}) * var(--vk-scale)`)
45
+ .join("") +
46
+ `)`, [visibleColumns]);
47
+ const frozenWidth = useMemo(() => frozenCount === 0
48
+ ? "0px"
49
+ : `calc((${visibleColumns
50
+ .slice(0, frozenCount)
51
+ .map((c) => `var(${gridWidthVar(c.id)})`)
52
+ .join(" + ")}) * var(--vk-scale))`, [visibleColumns, frozenCount]);
53
+ const widthVarsStyle = useMemo(() => {
54
+ const style = {};
55
+ for (const col of visibleColumns) {
56
+ style[gridWidthVar(col.id)] = `${effectiveWidths[col.id]}px`;
57
+ }
58
+ style["--vk-frozen-w"] = frozenWidth;
59
+ style["--vk-frozen-on"] = frozenCount > 0 ? "1" : "0";
60
+ return style;
61
+ }, [effectiveWidths, visibleColumns, frozenWidth, frozenCount]);
62
+ const columnManager = useMemo(() => {
63
+ if (!onColumnStateChange)
64
+ return null;
65
+ return {
66
+ items: resolveColumnOrder(columns, viewBacked ? resolveViewColumnOrder(columns, columnState?.order) : columnState?.order).map((col) => ({
67
+ id: col.id,
68
+ label: typeof col.header === "string" && col.header ? col.header : prettifyOptionValue(col.id),
69
+ icon: gridColumnGlyph({ icons, AppIcon: components.AppIcon }, col, "h-3.5 w-3.5"),
70
+ hidden: isColumnHidden(col, viewBacked && !columnPlacedByView(col) ? undefined : columnState),
71
+ hideable: !viewBacked || columnPlacedByView(col) ? columnHideable(col) : false,
72
+ fixed: viewBacked && !columnPlacedByView(col),
73
+ })),
74
+ onToggleHidden: (id, hide) => {
75
+ const col = columns.find((candidate) => candidate.id === id);
76
+ if (viewBacked && col && !columnPlacedByView(col))
77
+ return;
78
+ if (col)
79
+ onColumnStateChange(toggleColumnHidden(columnState, col, hide));
80
+ },
81
+ onReorder: (ids) => onColumnStateChange({
82
+ ...columnState,
83
+ order: viewBacked ? resolveViewColumnOrder(columns, ids) : ids,
84
+ }),
85
+ onReset: () => onColumnStateChange({}),
86
+ dirty: Object.keys(columnState ?? {}).length > 0,
87
+ };
88
+ }, [columnState, columns, components.AppIcon, icons, onColumnStateChange, viewBacked]);
89
+ const gridTemplate = useMemo(() => [
90
+ "0px",
91
+ ...visibleColumns.map((col) => `calc(var(${gridWidthVar(col.id)}) * var(--vk-scale))`),
92
+ "minmax(var(--vk-tail-w),1fr)",
93
+ ].join(" "), [visibleColumns]);
94
+ const minWidth = useMemo(() => `calc((${visibleColumns
95
+ .map((col) => `var(${gridWidthVar(col.id)})`)
96
+ .join(" + ")}) * var(--vk-scale) + 2*var(--vk-gutter,0px) + var(--vk-indent,0px) + var(--vk-tail-w))`, [visibleColumns]);
97
+ const [resizingId, setResizingId] = useState(null);
98
+ const dragRef = useRef(null);
99
+ const rafRef = useRef(null);
100
+ const pendingXRef = useRef(0);
101
+ const lastGestureMovedRef = useRef(false);
102
+ const startResize = (col, event) => {
103
+ dragRef.current = {
104
+ col,
105
+ startX: event.clientX,
106
+ startW: effectiveWidths[col.id],
107
+ lastW: null,
108
+ moved: false,
109
+ };
110
+ lastGestureMovedRef.current = false;
111
+ setResizingId(col.id);
112
+ setBodyResizeState(true);
113
+ };
114
+ const moveResize = (event) => {
115
+ if (!dragRef.current)
116
+ return;
117
+ pendingXRef.current = event.clientX;
118
+ if (rafRef.current != null)
119
+ return;
120
+ rafRef.current = requestAnimationFrame(() => {
121
+ rafRef.current = null;
122
+ const drag = dragRef.current;
123
+ if (!drag)
124
+ return;
125
+ const delta = pendingXRef.current - drag.startX;
126
+ if (Math.abs(delta) > 2)
127
+ drag.moved = true;
128
+ const width = clampColumnWidth(drag.col, drag.startW + delta / scale);
129
+ drag.lastW = width;
130
+ rootRef.current?.style.setProperty(gridWidthVar(drag.col.id), `${width}px`);
131
+ });
132
+ };
133
+ const endResize = () => {
134
+ const drag = dragRef.current;
135
+ dragRef.current = null;
136
+ if (rafRef.current != null) {
137
+ cancelAnimationFrame(rafRef.current);
138
+ rafRef.current = null;
139
+ }
140
+ setResizingId(null);
141
+ setBodyResizeState(false);
142
+ if (!drag)
143
+ return;
144
+ lastGestureMovedRef.current = drag.moved;
145
+ if (!drag.moved || drag.lastW == null || drag.lastW === effectiveWidths[drag.col.id])
146
+ return;
147
+ onColumnStateChange?.({
148
+ ...columnState,
149
+ widths: { ...(columnState?.widths ?? {}), [drag.col.id]: drag.lastW },
150
+ });
151
+ };
152
+ const resetColumnWidth = (col) => {
153
+ if (lastGestureMovedRef.current)
154
+ return;
155
+ const widths = { ...(columnState?.widths ?? {}) };
156
+ if (!(col.id in widths))
157
+ return;
158
+ delete widths[col.id];
159
+ const next = { ...columnState };
160
+ if (Object.keys(widths).length === 0)
161
+ delete next.widths;
162
+ else
163
+ next.widths = widths;
164
+ onColumnStateChange?.(next);
165
+ };
166
+ const hideColumn = (col) => {
167
+ if (viewBacked && !columnPlacedByView(col))
168
+ return;
169
+ onColumnStateChange?.(toggleColumnHidden(columnState, col, true));
170
+ };
171
+ const moveColumn = (col, direction) => {
172
+ if (viewBacked && !columnPlacedByView(col))
173
+ return;
174
+ const ordered = baseColumnOrder(columns, columnState?.order, viewBacked);
175
+ const visibleIds = visibleColumns.map((c) => c.id);
176
+ const at = visibleIds.indexOf(col.id);
177
+ const neighbour = visibleIds[at + direction];
178
+ if (at < 0 || !neighbour)
179
+ return;
180
+ if (viewBacked && !columnPlacedByView(columns.find((c) => c.id === neighbour)))
181
+ return;
182
+ const i = ordered.indexOf(col.id);
183
+ const j = ordered.indexOf(neighbour);
184
+ [ordered[i], ordered[j]] = [ordered[j], ordered[i]];
185
+ onColumnStateChange?.({
186
+ ...columnState,
187
+ order: viewBacked ? resolveViewColumnOrder(columns, ordered) : ordered,
188
+ });
189
+ };
190
+ return {
191
+ visibleColumns,
192
+ widthVarsStyle,
193
+ frozenCount,
194
+ frozenLeft,
195
+ columnManager,
196
+ gridTemplate,
197
+ minWidth,
198
+ resizingId,
199
+ startResize,
200
+ moveResize,
201
+ endResize,
202
+ resetColumnWidth,
203
+ hideColumn,
204
+ moveColumn,
205
+ };
206
+ }
@@ -0,0 +1,20 @@
1
+ import type { MutableRefObject } from "react";
2
+ import type { ListColumn } from "../../model/column-schema.js";
3
+ import type { ListColumnState } from "../../model/column-state.js";
4
+ /** Bind visible header drag order back onto the complete stored column order. */
5
+ export declare function useGridHeaderDrag<Row>({ columns, columnState, onColumnStateChange, visibleColumnIds, scrollXRef, getScroller, viewBacked, }: {
6
+ columns: ListColumn<Row>[];
7
+ columnState?: ListColumnState;
8
+ onColumnStateChange?: (next: ListColumnState) => void;
9
+ visibleColumnIds: string[];
10
+ scrollXRef: MutableRefObject<number>;
11
+ getScroller: () => HTMLElement | undefined;
12
+ viewBacked?: boolean;
13
+ }): {
14
+ cellStyle: (id: string, index: number) => React.CSSProperties | undefined;
15
+ onCellPointerDown: (id: string, index: number) => (e: React.PointerEvent<HTMLElement>) => void;
16
+ onCellPointerMove: (e: React.PointerEvent<HTMLElement>) => void;
17
+ onCellPointerUp: (e: React.PointerEvent<HTMLElement>) => void;
18
+ onCellPointerCancel: () => void;
19
+ onCellClickCapture: (e: React.MouseEvent<HTMLElement>) => void;
20
+ };
@@ -0,0 +1,37 @@
1
+ "use client";
2
+ import { baseColumnOrder, columnPlacedByView, resolveViewColumnOrder, } from "../../model/column-capabilities.js";
3
+ import { useHeaderDragReorder } from "./useHeaderDragReorder.js";
4
+ export function useGridHeaderDrag({ columns, columnState, onColumnStateChange, visibleColumnIds, scrollXRef, getScroller, viewBacked = false, }) {
5
+ return useHeaderDragReorder({
6
+ enabled: !!onColumnStateChange,
7
+ ids: visibleColumnIds,
8
+ scrollXRef,
9
+ getScroller,
10
+ canDrag: (id) => {
11
+ const column = columns.find((candidate) => candidate.id === id);
12
+ return !viewBacked || !column || columnPlacedByView(column);
13
+ },
14
+ onReorder: (movedId, nextVisible) => {
15
+ if (!onColumnStateChange)
16
+ return;
17
+ const moved = columns.find((column) => column.id === movedId);
18
+ if (viewBacked && moved && !columnPlacedByView(moved))
19
+ return;
20
+ const completeOrder = baseColumnOrder(columns, columnState?.order, viewBacked);
21
+ const remaining = completeOrder.filter((id) => id !== movedId);
22
+ const position = nextVisible.indexOf(movedId);
23
+ const follower = nextVisible[position + 1];
24
+ const previous = nextVisible[position - 1];
25
+ const insertAt = follower != null
26
+ ? remaining.indexOf(follower)
27
+ : previous != null
28
+ ? remaining.indexOf(previous) + 1
29
+ : remaining.length;
30
+ remaining.splice(insertAt, 0, movedId);
31
+ onColumnStateChange({
32
+ ...columnState,
33
+ order: viewBacked ? resolveViewColumnOrder(columns, remaining) : remaining,
34
+ });
35
+ },
36
+ });
37
+ }
@@ -0,0 +1,47 @@
1
+ import { type RefObject } from "react";
2
+ import type { GridCellPos } from "../core/coordinates.js";
3
+ import type { GridCellRange } from "../core/useGridRange.js";
4
+ import type { ListSettingsConfig } from "../../model/column-capabilities.js";
5
+ import type { ListColumn } from "../../model/column-schema.js";
6
+ import type { GridRangeVerbs } from "./useGridRangeActions.js";
7
+ export declare function useGridKeyboard<Row>({ rootRef, focusedCell, editingCell, editingEnabled, listConfig, visibleRowIds, rowByKey, visibleColIds, visibleColumns, rows, getRowId, pendingByRow, rangeVerbsRef, focusCell, clearFocus, startEdit, cancelEdit, commitEdit, refuseEdit, undo, redo, rangeSetSingle, rangeSetRect, rangeExtendTo, ranges, }: {
8
+ rootRef: RefObject<HTMLDivElement | null>;
9
+ focusedCell: GridCellPos | null;
10
+ editingCell: GridCellPos | null;
11
+ editingEnabled: boolean;
12
+ /** Workspace-settings capability config — the keyboard routes ask the same effective
13
+ * write gate the cells do, so a lock holds here too. */
14
+ listConfig?: ListSettingsConfig;
15
+ visibleRowIds: string[];
16
+ /** Row key → the rendered row and its DATA id. Focus is a KEY; a commit needs
17
+ * the record and the id behind it. */
18
+ rowByKey: ReadonlyMap<string, {
19
+ row: Row;
20
+ rowId: string;
21
+ }>;
22
+ visibleColIds: string[];
23
+ visibleColumns: ListColumn<Row>[];
24
+ rows: Row[];
25
+ getRowId: (row: Row) => string;
26
+ pendingByRow: ReadonlyMap<string, Record<string, unknown>>;
27
+ rangeVerbsRef: RefObject<GridRangeVerbs | null>;
28
+ focusCell: (rowId: string, columnId: string) => void;
29
+ clearFocus: () => void;
30
+ /** Seed a fresh rectangle (⌘A, or extending with no range yet). */
31
+ rangeSetRect: (anchor: GridCellPos, head: GridCellPos) => void;
32
+ /** Grow the ACTIVE range to a new head, anchor untouched. */
33
+ rangeExtendTo: (pos: GridCellPos) => void;
34
+ /** Live ranges — the last one is active; read for its head. */
35
+ ranges: GridCellRange[];
36
+ startEdit: (rowId: string, columnId: string, seed?: string) => void;
37
+ cancelEdit: () => void;
38
+ commitEdit: (row: Row, rowId: string, columnId: string, previous: unknown, next: unknown) => void;
39
+ /** Say why a cell can't be written; answers whether it said anything. */
40
+ refuseEdit: (columnId: string) => boolean;
41
+ undo: (resolveRow: (rowId: string) => Row | undefined, onApply?: (pos: GridCellPos) => void) => boolean;
42
+ redo: (resolveRow: (rowId: string) => Row | undefined, onApply?: (pos: GridCellPos) => void) => boolean;
43
+ rangeSetSingle: (pos: GridCellPos) => void;
44
+ }): {
45
+ onEditorTab: (rowId: string, columnId: string, backwards: boolean) => void;
46
+ onEditorEnter: (rowId: string, columnId: string) => void;
47
+ };
@@ -0,0 +1,274 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useRef } from "react";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { cellClearPrev, cellEditBaseline } from "../core/clipboard-model.js";
5
+ import { gridBooleanMode, gridClearRefusal, columnEffectiveWritable, gridColumnHasEditor, } from "../../model/column-capabilities.js";
6
+ import { gridColumnInspectable } from "../../model/column-inspect.js";
7
+ import { activeRangeHead, gridNavIntent, nextCellLinear, nextCellPos, resolveNavTarget, wholeTableRect, } from "../core/nav.js";
8
+ import { copyCell } from "./cell-clipboard.js";
9
+ const NAV_KEYS = {
10
+ ArrowUp: "up",
11
+ ArrowDown: "down",
12
+ ArrowLeft: "left",
13
+ ArrowRight: "right",
14
+ };
15
+ const KEY_OWNING_SURFACES = 'input, textarea, select, [contenteditable="true"], [role="menu"], [role="dialog"]';
16
+ const INTERACTIVE = 'button, a[href], [role="button"], [tabindex]:not([tabindex="-1"])';
17
+ function eventBelongsElsewhere(target, root) {
18
+ if (!target?.closest)
19
+ return false;
20
+ if (target.closest(KEY_OWNING_SURFACES))
21
+ return true;
22
+ return !!target.closest(INTERACTIVE) && !root?.contains(target);
23
+ }
24
+ function revealGridCell(root, pos, behavior) {
25
+ const row = root?.querySelector(`[data-row-id="${CSS.escape(pos.rowId)}"]`);
26
+ const cell = row?.querySelector(`[data-col-id="${CSS.escape(pos.columnId)}"]`) ?? row;
27
+ cell?.scrollIntoView({ block: "nearest", inline: "nearest", behavior });
28
+ }
29
+ export function useGridKeyboard({ rootRef, focusedCell, editingCell, editingEnabled, listConfig, visibleRowIds, rowByKey, visibleColIds, visibleColumns, rows, getRowId, pendingByRow, rangeVerbsRef, focusCell, clearFocus, startEdit, cancelEdit, commitEdit, refuseEdit, undo, redo, rangeSetSingle, rangeSetRect, rangeExtendTo, ranges, }) {
30
+ const { ports, messages } = useViews();
31
+ const navFromEditorRef = useRef({ tab: () => { }, enter: () => { } });
32
+ const onEditorTab = useCallback((rowId, columnId, backwards) => navFromEditorRef.current.tab(rowId, columnId, backwards), []);
33
+ const onEditorEnter = useCallback((rowId, columnId) => navFromEditorRef.current.enter(rowId, columnId), []);
34
+ useEffect(() => {
35
+ navFromEditorRef.current = {
36
+ tab: (rowId, columnId, backwards) => {
37
+ const next = nextCellLinear({ rowId, columnId }, backwards, visibleRowIds, visibleColIds);
38
+ if (!next)
39
+ return;
40
+ focusCell(next.rowId, next.columnId);
41
+ revealGridCell(rootRef.current, next, "auto");
42
+ },
43
+ enter: (rowId, columnId) => {
44
+ const next = nextCellPos({ rowId, columnId }, "down", visibleRowIds, visibleColIds);
45
+ if (!next)
46
+ return;
47
+ focusCell(next.rowId, next.columnId);
48
+ revealGridCell(rootRef.current, next, "auto");
49
+ },
50
+ };
51
+ }, [focusCell, rootRef, visibleColIds, visibleRowIds]);
52
+ useEffect(() => {
53
+ if (!editingEnabled)
54
+ return;
55
+ const scrollToCell = (pos) => {
56
+ rangeSetSingle(pos);
57
+ requestAnimationFrame(() => revealGridCell(rootRef.current, pos, "smooth"));
58
+ };
59
+ const onKeyDown = (event) => {
60
+ if (!(event.metaKey || event.ctrlKey) || event.altKey || event.key.toLowerCase() !== "z") {
61
+ return;
62
+ }
63
+ if (eventBelongsElsewhere(event.target, rootRef.current))
64
+ return;
65
+ const resolveRow = (rowId) => rows.find((row) => getRowId(row) === rowId);
66
+ const handled = event.shiftKey
67
+ ? redo(resolveRow, scrollToCell)
68
+ : undo(resolveRow, scrollToCell);
69
+ if (handled)
70
+ event.preventDefault();
71
+ };
72
+ window.addEventListener("keydown", onKeyDown, true);
73
+ return () => window.removeEventListener("keydown", onKeyDown, true);
74
+ }, [editingEnabled, getRowId, rangeSetSingle, redo, rootRef, rows, undo]);
75
+ useEffect(() => {
76
+ if (!focusedCell)
77
+ return;
78
+ const resolveFocused = () => {
79
+ const entry = rowByKey.get(focusedCell.rowId);
80
+ return {
81
+ column: visibleColumns.find((column) => column.id === focusedCell.columnId),
82
+ row: entry?.row,
83
+ rowId: entry?.rowId ?? focusedCell.rowId,
84
+ };
85
+ };
86
+ const onKeyDown = (event) => {
87
+ if (eventBelongsElsewhere(event.target, rootRef.current))
88
+ return;
89
+ const mod = (event.metaKey || event.ctrlKey) && !event.shiftKey && !event.altKey;
90
+ const bare = !event.metaKey && !event.ctrlKey && !event.altKey && !event.shiftKey;
91
+ const navDirection = NAV_KEYS[event.key];
92
+ const navIntent = gridNavIntent(event);
93
+ if (event.key === "Escape") {
94
+ event.stopPropagation();
95
+ if (editingCell)
96
+ cancelEdit();
97
+ else
98
+ clearFocus();
99
+ }
100
+ else if (navDirection && bare && !editingCell) {
101
+ event.preventDefault();
102
+ const next = nextCellPos(focusedCell, navDirection, visibleRowIds, visibleColIds);
103
+ if (!next)
104
+ return;
105
+ focusCell(next.rowId, next.columnId);
106
+ revealGridCell(rootRef.current, next, "auto");
107
+ }
108
+ else if (navIntent && !editingCell) {
109
+ event.preventDefault();
110
+ if (navIntent.kind === "selectAll") {
111
+ const rect = wholeTableRect(visibleRowIds, visibleColIds);
112
+ if (rect)
113
+ rangeSetRect(rect.anchor, rect.head);
114
+ return;
115
+ }
116
+ const head = navIntent.extend
117
+ ? activeRangeHead(ranges, visibleRowIds, visibleColIds)
118
+ : null;
119
+ const from = head ?? focusedCell;
120
+ const next = resolveNavTarget(from, navIntent.target, visibleRowIds, visibleColIds);
121
+ if (!next)
122
+ return;
123
+ if (next.rowId === from.rowId && next.columnId === from.columnId)
124
+ return;
125
+ if (!navIntent.extend)
126
+ focusCell(next.rowId, next.columnId);
127
+ else if (head)
128
+ rangeExtendTo(next);
129
+ else
130
+ rangeSetRect(focusedCell, next);
131
+ revealGridCell(rootRef.current, next, "auto");
132
+ }
133
+ else if (event.key === "Tab" && !event.metaKey && !event.ctrlKey && !event.altKey) {
134
+ event.preventDefault();
135
+ if (editingCell)
136
+ return;
137
+ const next = nextCellLinear(focusedCell, event.shiftKey, visibleRowIds, visibleColIds);
138
+ if (!next)
139
+ return;
140
+ focusCell(next.rowId, next.columnId);
141
+ revealGridCell(rootRef.current, next, "auto");
142
+ }
143
+ else if (event.key === "Enter" && !editingCell) {
144
+ const column = visibleColumns.find((item) => item.id === focusedCell.columnId);
145
+ event.preventDefault();
146
+ if (column &&
147
+ ((editingEnabled && gridColumnHasEditor(column)) || gridColumnInspectable(column))) {
148
+ startEdit(focusedCell.rowId, focusedCell.columnId);
149
+ return;
150
+ }
151
+ if (column &&
152
+ editingEnabled &&
153
+ gridBooleanMode(column) === "toggle" &&
154
+ columnEffectiveWritable(column, listConfig)) {
155
+ const { row, rowId } = resolveFocused();
156
+ if (row != null) {
157
+ const on = cellEditBaseline(column, row, pendingByRow.get(rowId)) === true;
158
+ commitEdit(row, rowId, column.id, on, !on);
159
+ return;
160
+ }
161
+ }
162
+ const next = nextCellPos(focusedCell, "down", visibleRowIds, visibleColIds);
163
+ if (!next)
164
+ return;
165
+ focusCell(next.rowId, next.columnId);
166
+ revealGridCell(rootRef.current, next, "auto");
167
+ }
168
+ else if (mod && event.key.toLowerCase() === "c" && !editingCell) {
169
+ event.preventDefault();
170
+ if (rangeVerbsRef.current?.activeRangeIsMulti()) {
171
+ rangeVerbsRef.current.copyRange();
172
+ return;
173
+ }
174
+ const { column, row, rowId } = resolveFocused();
175
+ if (!column || row == null)
176
+ return;
177
+ const baseline = cellEditBaseline(column, row, pendingByRow.get(rowId));
178
+ void copyCell(ports.clipboard.writeText, column, baseline, column.editUnit?.value(row));
179
+ }
180
+ else if (mod && event.key.toLowerCase() === "x" && !editingCell) {
181
+ event.preventDefault();
182
+ if (rangeVerbsRef.current?.activeRangeIsMulti()) {
183
+ if (editingEnabled)
184
+ rangeVerbsRef.current.cutRange();
185
+ return;
186
+ }
187
+ const { column, row, rowId } = resolveFocused();
188
+ if (!column || row == null)
189
+ return;
190
+ if (!editingEnabled || !columnEffectiveWritable(column, listConfig))
191
+ return;
192
+ if (!gridBooleanMode(column) && !column.clearable)
193
+ return;
194
+ const baseline = cellEditBaseline(column, row, pendingByRow.get(rowId));
195
+ void copyCell(ports.clipboard.writeText, column, baseline, column.editUnit?.value(row));
196
+ commitEdit(row, rowId, column.id, cellClearPrev(column, row, pendingByRow.get(rowId)), "");
197
+ }
198
+ else if ((event.key === "Delete" || event.key === "Backspace") && !editingCell) {
199
+ event.preventDefault();
200
+ if (rangeVerbsRef.current?.activeRangeIsMulti()) {
201
+ if (editingEnabled)
202
+ rangeVerbsRef.current.clearRange();
203
+ return;
204
+ }
205
+ const { column, row, rowId } = resolveFocused();
206
+ if (!column || row == null || !editingEnabled)
207
+ return;
208
+ if (!columnEffectiveWritable(column, listConfig)) {
209
+ if (!refuseEdit(column.id))
210
+ ports.toast.error(gridClearRefusal(column, listConfig, messages));
211
+ return;
212
+ }
213
+ if (!gridBooleanMode(column) && !column.clearable) {
214
+ ports.toast.error(gridClearRefusal(column, listConfig, messages));
215
+ return;
216
+ }
217
+ commitEdit(row, rowId, column.id, cellClearPrev(column, row, pendingByRow.get(rowId)), "");
218
+ }
219
+ else if (!editingCell &&
220
+ editingEnabled &&
221
+ event.key.length === 1 &&
222
+ !event.metaKey &&
223
+ !event.ctrlKey &&
224
+ !event.altKey &&
225
+ !event.isComposing) {
226
+ const column = visibleColumns.find((item) => item.id === focusedCell.columnId);
227
+ if (!column)
228
+ return;
229
+ if (!columnEffectiveWritable(column, listConfig)) {
230
+ if (refuseEdit(column.id))
231
+ event.preventDefault();
232
+ return;
233
+ }
234
+ if (!gridColumnHasEditor(column))
235
+ return;
236
+ event.preventDefault();
237
+ const seedable = column.type !== "select" &&
238
+ column.type !== "status" &&
239
+ column.type !== "date" &&
240
+ column.type !== "multiselect" &&
241
+ !column.multiple;
242
+ startEdit(focusedCell.rowId, focusedCell.columnId, seedable ? event.key : undefined);
243
+ }
244
+ };
245
+ window.addEventListener("keydown", onKeyDown, true);
246
+ return () => window.removeEventListener("keydown", onKeyDown, true);
247
+ }, [
248
+ cancelEdit,
249
+ clearFocus,
250
+ commitEdit,
251
+ editingCell,
252
+ editingEnabled,
253
+ focusCell,
254
+ focusedCell,
255
+ getRowId,
256
+ listConfig,
257
+ messages,
258
+ pendingByRow,
259
+ ports,
260
+ refuseEdit,
261
+ rowByKey,
262
+ rangeVerbsRef,
263
+ ranges,
264
+ rangeSetRect,
265
+ rangeExtendTo,
266
+ rootRef,
267
+ rows,
268
+ startEdit,
269
+ visibleColIds,
270
+ visibleColumns,
271
+ visibleRowIds,
272
+ ]);
273
+ return { onEditorTab, onEditorEnter };
274
+ }
@@ -0,0 +1,12 @@
1
+ import type { ListColumn } from "../../model/column-schema.js";
2
+ export declare function useGridPendingReconciliation<Row>({ rows, columns, getRowId, pendingByRow, reconcile, hasInflight, pendingBaseline, }: {
3
+ rows: Row[];
4
+ columns: ListColumn<Row>[];
5
+ getRowId: (row: Row) => string;
6
+ pendingByRow: ReadonlyMap<string, Record<string, unknown>>;
7
+ reconcile: (matchedKeys: string[]) => void;
8
+ hasInflight?: (rowId: string, columnId: string) => boolean;
9
+ /** Enables the concurrent-write warning; without it reconciliation still
10
+ * clears the overlay, just silently, as it always did. */
11
+ pendingBaseline?: (rowId: string, columnId: string) => unknown;
12
+ }): void;
@@ -0,0 +1,32 @@
1
+ "use client";
2
+ import { useEffect, useRef } from "react";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { findGridPendingMatches, findSupersededCells } from "../core/pending-reconciliation.js";
5
+ import { columnLabel } from "../../model/column-capabilities.js";
6
+ export function useGridPendingReconciliation({ rows, columns, getRowId, pendingByRow, reconcile, hasInflight, pendingBaseline, }) {
7
+ const { ports, messages } = useViews();
8
+ const reconciledRowsRef = useRef(null);
9
+ useEffect(() => {
10
+ if (pendingByRow.size === 0) {
11
+ reconciledRowsRef.current = rows;
12
+ return;
13
+ }
14
+ if (reconciledRowsRef.current === rows)
15
+ return;
16
+ reconciledRowsRef.current = rows;
17
+ if (hasInflight && pendingBaseline) {
18
+ const taken = findSupersededCells(rows, columns, getRowId, pendingByRow, hasInflight, pendingBaseline);
19
+ if (taken.length === 1) {
20
+ ports.toast.warning(messages({ key: "views.grid.changed-elsewhere", values: { field: columnLabel(taken[0].column) } }), { description: messages({ key: "views.grid.saved-value" }) });
21
+ }
22
+ else if (taken.length > 1) {
23
+ ports.toast.warning(messages({ key: "views.grid.changed-elsewhere-cells", values: { count: taken.length } }), {
24
+ description: messages({ key: "views.grid.saved-values" }),
25
+ });
26
+ }
27
+ }
28
+ const matched = findGridPendingMatches(rows, columns, getRowId, pendingByRow, hasInflight);
29
+ if (matched.length > 0)
30
+ reconcile(matched);
31
+ }, [columns, getRowId, hasInflight, messages, pendingBaseline, pendingByRow, ports, reconcile, rows]);
32
+ }