@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.
- package/CHANGELOG.md +196 -1
- package/README.md +90 -41
- package/dist/atoms/Row.js +1 -1
- package/dist/atoms/RowMenu.d.ts +1 -1
- package/dist/atoms/RowMenu.js +15 -4
- package/dist/atoms/types.d.ts +4 -4
- package/dist/contract.d.ts +37 -7
- package/dist/contract.js +24 -5
- package/dist/display/format.d.ts +16 -1
- package/dist/display/format.js +10 -1
- package/dist/display/index.d.ts +1 -1
- package/dist/display/index.js +1 -1
- package/dist/display/link.js +5 -3
- package/dist/display/location.d.ts +4 -3
- package/dist/display/location.js +12 -5
- package/dist/display/options.d.ts +1 -1
- package/dist/display/percent.js +10 -3
- package/dist/display/phone.d.ts +2 -1
- package/dist/display/phone.js +8 -1
- package/dist/display/relation.js +1 -1
- package/dist/editors/ChipsEditor.js +1 -1
- package/dist/editors/LocationEditor.js +16 -17
- package/dist/editors/NameEditor.js +5 -4
- package/dist/editors/NumberEditor.js +2 -2
- package/dist/editors/RangeEditor.js +2 -2
- package/dist/editors/ValueListEditor.d.ts +2 -2
- package/dist/editors/ValueListEditor.js +8 -8
- package/dist/editors/edit-cores.d.ts +1 -1
- package/dist/fields/binding.d.ts +1 -1
- package/dist/fields/currency.d.ts +0 -10
- package/dist/fields/currency.js +0 -14
- package/dist/fields/money.d.ts +1 -0
- package/dist/fields/money.js +1 -0
- package/dist/filters/filter-model.d.ts +0 -1
- package/dist/filters/registry.d.ts +3 -36
- package/dist/filters/registry.js +0 -38
- package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
- package/dist/grid/chrome/GridAddColumn.js +29 -0
- package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
- package/dist/grid/chrome/GridAggregateMenu.js +27 -0
- package/dist/grid/chrome/GridCellEditors.d.ts +64 -0
- package/dist/grid/chrome/GridCellEditors.js +55 -0
- package/dist/grid/chrome/GridCellOutline.d.ts +70 -0
- package/dist/grid/chrome/GridCellOutline.js +21 -0
- package/dist/grid/chrome/GridChipsEditor.d.ts +28 -0
- package/dist/grid/chrome/GridChipsEditor.js +40 -0
- package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
- package/dist/grid/chrome/GridColumnColorSection.js +40 -0
- package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
- package/dist/grid/chrome/GridColumnDateSection.js +23 -0
- package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
- package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
- package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
- package/dist/grid/chrome/GridColumnMenu.js +99 -0
- package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
- package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
- package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
- package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
- package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
- package/dist/grid/chrome/GridColumnSortSection.js +16 -0
- package/dist/grid/chrome/GridDateEditor.d.ts +22 -0
- package/dist/grid/chrome/GridDateEditor.js +31 -0
- package/dist/grid/chrome/GridFlyout.d.ts +44 -0
- package/dist/grid/chrome/GridFlyout.js +80 -0
- package/dist/grid/chrome/GridFooter.d.ts +23 -0
- package/dist/grid/chrome/GridFooter.js +81 -0
- package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
- package/dist/grid/chrome/GridGroupMenu.js +57 -0
- package/dist/grid/chrome/GridHeader.d.ts +61 -0
- package/dist/grid/chrome/GridHeader.js +37 -0
- package/dist/grid/chrome/GridLongTextEditor.d.ts +36 -0
- package/dist/grid/chrome/GridLongTextEditor.js +127 -0
- package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
- package/dist/grid/chrome/GridMenuRow.js +15 -0
- package/dist/grid/chrome/GridNameEditor.d.ts +19 -0
- package/dist/grid/chrome/GridNameEditor.js +36 -0
- package/dist/grid/chrome/GridNumberEditor.d.ts +35 -0
- package/dist/grid/chrome/GridNumberEditor.js +25 -0
- package/dist/grid/chrome/GridRangeEditor.d.ts +20 -0
- package/dist/grid/chrome/GridRangeEditor.js +25 -0
- package/dist/grid/chrome/GridRelationEditor.d.ts +21 -0
- package/dist/grid/chrome/GridRelationEditor.js +30 -0
- package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
- package/dist/grid/chrome/GridResizeHandle.js +19 -0
- package/dist/grid/chrome/GridRow.d.ts +25 -0
- package/dist/grid/chrome/GridRow.js +136 -0
- package/dist/grid/chrome/GridRowActions.d.ts +32 -0
- package/dist/grid/chrome/GridRowActions.js +25 -0
- package/dist/grid/chrome/GridRowCells.d.ts +4 -0
- package/dist/grid/chrome/GridRowCells.js +133 -0
- package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
- package/dist/grid/chrome/GridRowGlyph.js +13 -0
- package/dist/grid/chrome/GridSelectEditor.d.ts +18 -0
- package/dist/grid/chrome/GridSelectEditor.js +49 -0
- package/dist/grid/chrome/GridStructure.d.ts +48 -0
- package/dist/grid/chrome/GridStructure.js +45 -0
- package/dist/grid/chrome/GridTable.d.ts +4 -0
- package/dist/grid/chrome/GridTable.js +125 -0
- package/dist/grid/chrome/GridTableSurface.d.ts +15 -0
- package/dist/grid/chrome/GridTableSurface.js +6 -0
- package/dist/grid/chrome/GridTextEditor.d.ts +11 -0
- package/dist/grid/chrome/GridTextEditor.js +40 -0
- package/dist/grid/chrome/GridValueListEditor.d.ts +18 -0
- package/dist/grid/chrome/GridValueListEditor.js +36 -0
- package/dist/grid/chrome/StuckMarker.d.ts +16 -0
- package/dist/grid/chrome/StuckMarker.js +34 -0
- package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
- package/dist/grid/chrome/cell-clipboard.js +28 -0
- package/dist/grid/chrome/cells.d.ts +21 -0
- package/dist/grid/chrome/cells.js +20 -0
- package/dist/grid/chrome/checks.d.ts +35 -0
- package/dist/grid/chrome/checks.js +22 -0
- package/dist/grid/chrome/column-glyph.d.ts +14 -0
- package/dist/grid/chrome/column-glyph.js +44 -0
- package/dist/grid/chrome/editors.d.ts +9 -0
- package/dist/grid/chrome/editors.js +10 -0
- package/dist/grid/chrome/grid-cell-classes.d.ts +59 -0
- package/dist/grid/chrome/grid-cell-classes.js +30 -0
- package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
- package/dist/grid/chrome/grid-menu-search.js +7 -0
- package/dist/grid/chrome/grid-row-props.d.ts +131 -0
- package/dist/grid/chrome/grid-row-props.js +1 -0
- package/dist/grid/chrome/grid-styles.d.ts +37 -0
- package/dist/grid/chrome/grid-styles.js +8 -0
- package/dist/grid/chrome/grid-table-props.d.ts +173 -0
- package/dist/grid/chrome/grid-table-props.js +1 -0
- package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
- package/dist/grid/chrome/useGridBatchApi.js +35 -0
- package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
- package/dist/grid/chrome/useGridColumnLayout.js +206 -0
- package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
- package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
- package/dist/grid/chrome/useGridKeyboard.d.ts +47 -0
- package/dist/grid/chrome/useGridKeyboard.js +274 -0
- package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
- package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
- package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
- package/dist/grid/chrome/useGridRailReveal.js +67 -0
- package/dist/grid/chrome/useGridRangeActions.d.ts +49 -0
- package/dist/grid/chrome/useGridRangeActions.js +188 -0
- package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
- package/dist/grid/chrome/useGridRangeGestures.js +190 -0
- package/dist/grid/chrome/useGridRowContextMenu.d.ts +35 -0
- package/dist/grid/chrome/useGridRowContextMenu.js +127 -0
- package/dist/grid/chrome/useGridScaleStyles.d.ts +1 -0
- package/dist/grid/chrome/useGridScaleStyles.js +29 -0
- package/dist/grid/chrome/useGridScrollSync.d.ts +38 -0
- package/dist/grid/chrome/useGridScrollSync.js +176 -0
- package/dist/grid/chrome/useGridTableInteractionModel.d.ts +55 -0
- package/dist/grid/chrome/useGridTableInteractionModel.js +197 -0
- package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
- package/dist/grid/chrome/useGridTableSelection.js +55 -0
- package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
- package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
- package/dist/grid/core/clipboard-model.d.ts +81 -0
- package/dist/grid/core/clipboard-model.js +291 -0
- package/dist/grid/core/column-values.d.ts +27 -0
- package/dist/grid/core/column-values.js +76 -0
- package/dist/grid/core/commit-model.d.ts +34 -0
- package/dist/grid/core/commit-model.js +3 -0
- package/dist/grid/core/coordinates.d.ts +48 -0
- package/dist/grid/core/coordinates.js +27 -0
- package/dist/grid/core/edit-values.d.ts +9 -0
- package/dist/grid/core/edit-values.js +1 -0
- package/dist/grid/core/editing-controller.d.ts +59 -0
- package/dist/grid/core/editing-controller.js +240 -0
- package/dist/grid/core/editing-model.d.ts +78 -0
- package/dist/grid/core/editing-model.js +136 -0
- package/dist/grid/core/grid-scale.d.ts +14 -0
- package/dist/grid/core/grid-scale.js +8 -0
- package/dist/grid/core/nav.d.ts +94 -0
- package/dist/grid/core/nav.js +92 -0
- package/dist/grid/core/pending-reconciliation.d.ts +50 -0
- package/dist/grid/core/pending-reconciliation.js +49 -0
- package/dist/grid/core/range-model.d.ts +25 -0
- package/dist/grid/core/range-model.js +59 -0
- package/dist/grid/core/spreadsheet-operations.d.ts +85 -0
- package/dist/grid/core/spreadsheet-operations.js +253 -0
- package/dist/grid/core/useGridEditing.d.ts +43 -0
- package/dist/grid/core/useGridEditing.js +90 -0
- package/dist/grid/core/useGridRange.d.ts +20 -0
- package/dist/grid/core/useGridRange.js +24 -0
- package/dist/grid/core/value-equality.d.ts +32 -0
- package/dist/grid/core/value-equality.js +34 -0
- package/dist/grid/index.d.ts +18 -0
- package/dist/grid/index.js +5 -0
- package/dist/grid/useGridTablePrefs.d.ts +50 -0
- package/dist/grid/useGridTablePrefs.js +101 -0
- package/dist/index.d.ts +0 -1
- package/dist/index.js +0 -1
- package/dist/internal/viewport.d.ts +5 -0
- package/dist/internal/viewport.js +29 -0
- package/dist/model/column-capabilities.d.ts +2 -2
- package/dist/model/column-state.d.ts +1 -1
- package/dist/model/density.js +3 -3
- package/dist/model/filter-capabilities.d.ts +1 -1
- package/dist/model/filter-capabilities.js +1 -1
- package/dist/model/index.d.ts +4 -6
- package/dist/model/index.js +0 -1
- package/dist/model/preferences.d.ts +7 -3
- package/dist/provider/ViewsProvider.d.ts +1 -1
- package/dist/provider/ViewsProvider.js +5 -1
- package/dist/provider/components.d.ts +16 -8
- package/dist/provider/context.d.ts +3 -2
- package/dist/provider/menu-groups.d.ts +8 -0
- package/dist/provider/menu-groups.js +38 -0
- package/dist/provider/ports.d.ts +22 -0
- package/dist/provider/ports.js +1 -0
- package/dist/react.d.ts +1 -1
- package/docs/contract.md +128 -56
- package/docs/getting-started.md +250 -0
- package/docs/guides/atoms.md +245 -0
- package/docs/guides/cells.md +302 -0
- package/docs/guides/columns.md +412 -0
- package/docs/guides/display.md +203 -0
- package/docs/guides/editors.md +404 -0
- package/docs/guides/ports.md +246 -0
- package/docs/guides/selection.md +270 -0
- package/docs/guides/the-grid.md +677 -0
- package/docs/guides/the-provider.md +446 -0
- package/docs/index.md +50 -0
- package/docs/install.md +9 -47
- package/docs/reference/cells.md +28 -0
- package/docs/reference/display.md +42 -0
- package/docs/reference/editors-chips.md +6 -0
- package/docs/reference/editors-date.md +6 -0
- package/docs/reference/editors-location.md +10 -0
- package/docs/reference/editors-name.md +6 -0
- package/docs/reference/editors-number.md +11 -0
- package/docs/reference/editors-open-values.md +9 -0
- package/docs/reference/editors-range.md +6 -0
- package/docs/reference/editors-relation.md +9 -0
- package/docs/reference/editors-select.md +8 -0
- package/docs/reference/editors-session.md +9 -0
- package/docs/reference/editors-value-list.md +6 -0
- package/docs/reference/editors.md +5 -0
- package/docs/reference/grid.md +39 -0
- package/docs/reference/react.md +86 -0
- package/docs/reference/selection.md +33 -0
- package/docs/reference/views.md +601 -0
- package/package.json +7 -3
- package/skills/views/SKILL.md +20 -5
- package/dist/filters/types.d.ts +0 -27
- package/dist/filters/types.js +0 -1
- package/dist/model/filter-pushdown.d.ts +0 -106
- 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
|
+
}
|