@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.
- package/CHANGELOG.md +571 -0
- package/README.md +5 -3
- package/dist/atoms/LoadMore.js +11 -1
- package/dist/atoms/RowMenu.js +5 -2
- package/dist/cells/cell-format.d.ts +3 -3
- package/dist/cells/cell-title.d.ts +1 -2
- package/dist/cells/cell-title.js +2 -2
- package/dist/cells/cell-values.js +6 -3
- package/dist/contract.d.ts +50 -9
- package/dist/contract.js +33 -5
- package/dist/display/converted.d.ts +19 -0
- package/dist/display/converted.js +12 -0
- package/dist/display/index.d.ts +1 -0
- package/dist/display/index.js +1 -0
- package/dist/display/link-click.d.ts +11 -0
- package/dist/display/link-click.js +3 -0
- package/dist/display/link.js +7 -3
- package/dist/display/multi-value.d.ts +1 -1
- package/dist/display/multi-value.js +1 -1
- package/dist/display/options.d.ts +7 -1
- package/dist/display/phone.js +3 -1
- package/dist/editors/ChipsEditor.d.ts +9 -4
- package/dist/editors/ChipsEditor.js +6 -2
- package/dist/editors/DateEditor.d.ts +21 -6
- package/dist/editors/DateEditor.js +118 -30
- package/dist/editors/EditorPanel.d.ts +61 -0
- package/dist/editors/EditorPanel.js +54 -0
- package/dist/editors/LocationEditor.d.ts +3 -0
- package/dist/editors/LocationEditor.js +14 -6
- package/dist/editors/NameEditor.d.ts +3 -0
- package/dist/editors/NameEditor.js +11 -7
- package/dist/editors/NumberEditor.d.ts +3 -0
- package/dist/editors/NumberEditor.js +6 -6
- package/dist/editors/RangeEditor.d.ts +16 -1
- package/dist/editors/RangeEditor.js +21 -5
- package/dist/editors/RelationEditor.d.ts +13 -28
- package/dist/editors/RelationEditor.js +17 -40
- package/dist/editors/RelationSetEditor.d.ts +53 -0
- package/dist/editors/RelationSetEditor.js +112 -0
- package/dist/editors/SelectEditor.d.ts +21 -3
- package/dist/editors/SelectEditor.js +55 -9
- package/dist/editors/TextEditor.d.ts +51 -0
- package/dist/editors/TextEditor.js +81 -0
- package/dist/editors/ValueListEditor.d.ts +3 -0
- package/dist/editors/ValueListEditor.js +4 -2
- package/dist/editors/edit-cores.d.ts +12 -9
- package/dist/editors/edit-cores.js +7 -6
- package/dist/editors/edit-session.d.ts +21 -11
- package/dist/editors/edit-session.js +19 -5
- package/dist/editors/keep-inside.d.ts +12 -0
- package/dist/editors/keep-inside.js +20 -0
- package/dist/editors/open-value.d.ts +21 -0
- package/dist/editors/open-value.js +36 -0
- package/dist/editors/open-values.d.ts +4 -0
- package/dist/editors/open-values.js +7 -0
- package/dist/editors/relation-kinds.d.ts +7 -0
- package/dist/editors/relation-kinds.js +21 -0
- package/dist/editors/relation-panel.d.ts +69 -0
- package/dist/editors/relation-panel.js +40 -0
- package/dist/field-row/FieldNoteLine.d.ts +14 -0
- package/dist/field-row/FieldNoteLine.js +14 -0
- package/dist/field-row/FieldRow.d.ts +73 -0
- package/dist/field-row/FieldRow.js +157 -0
- package/dist/field-row/FieldRowLane.d.ts +19 -0
- package/dist/field-row/FieldRowLane.js +11 -0
- package/dist/field-row/editors/RowChipsEditor.d.ts +11 -0
- package/dist/field-row/editors/RowChipsEditor.js +25 -0
- package/dist/field-row/editors/RowDateEditor.d.ts +16 -0
- package/dist/field-row/editors/RowDateEditor.js +18 -0
- package/dist/field-row/editors/RowEditor.d.ts +39 -0
- package/dist/field-row/editors/RowEditor.js +64 -0
- package/dist/field-row/editors/RowNameEditor.d.ts +4 -0
- package/dist/field-row/editors/RowNameEditor.js +15 -0
- package/dist/field-row/editors/RowNumberEditor.d.ts +12 -0
- package/dist/field-row/editors/RowNumberEditor.js +18 -0
- package/dist/field-row/editors/RowPlaceEditor.d.ts +8 -0
- package/dist/field-row/editors/RowPlaceEditor.js +18 -0
- package/dist/field-row/editors/RowRangeEditor.d.ts +4 -0
- package/dist/field-row/editors/RowRangeEditor.js +15 -0
- package/dist/field-row/editors/RowRelationEditor.d.ts +20 -0
- package/dist/field-row/editors/RowRelationEditor.js +77 -0
- package/dist/field-row/editors/RowSelectEditor.d.ts +13 -0
- package/dist/field-row/editors/RowSelectEditor.js +23 -0
- package/dist/field-row/editors/RowTextEditor.d.ts +15 -0
- package/dist/field-row/editors/RowTextEditor.js +16 -0
- package/dist/field-row/editors/RowValueListEditor.d.ts +4 -0
- package/dist/field-row/editors/RowValueListEditor.js +21 -0
- package/dist/field-row/editors/host.d.ts +59 -0
- package/dist/field-row/editors/host.js +1 -0
- package/dist/field-row/editors/row-session.d.ts +49 -0
- package/dist/field-row/editors/row-session.js +49 -0
- package/dist/field-row/index.d.ts +5 -0
- package/dist/field-row/index.js +5 -0
- package/dist/field-row/row-target.d.ts +20 -0
- package/dist/field-row/row-target.js +3 -0
- package/dist/field-row/useFieldWrite.d.ts +45 -0
- package/dist/field-row/useFieldWrite.js +190 -0
- package/dist/field-row/useRowSettlement.d.ts +33 -0
- package/dist/field-row/useRowSettlement.js +23 -0
- package/dist/fields/binding.d.ts +6 -1
- package/dist/fields/binding.js +13 -6
- package/dist/fields/edit-core-types.d.ts +9 -9
- package/dist/fields/edit-core-types.js +6 -6
- package/dist/fields/money.d.ts +5 -0
- package/dist/fields/money.js +10 -0
- package/dist/fields/number-edit.d.ts +6 -0
- package/dist/fields/number-edit.js +4 -0
- package/dist/fields/prepare-write.js +6 -1
- package/dist/fields/relation-source-types.d.ts +12 -0
- package/dist/fields/write-target.d.ts +50 -0
- package/dist/fields/write-target.js +10 -0
- package/dist/grid/chrome/GridAddColumn.js +1 -1
- package/dist/grid/chrome/GridAggregateMenu.d.ts +1 -1
- package/dist/grid/chrome/GridAggregateMenu.js +8 -6
- package/dist/grid/chrome/GridCellEditors.d.ts +7 -0
- package/dist/grid/chrome/GridCellEditors.js +87 -16
- package/dist/grid/chrome/GridCellOutline.d.ts +22 -43
- package/dist/grid/chrome/GridCellOutline.js +2 -7
- package/dist/grid/chrome/GridChipsEditor.d.ts +16 -6
- package/dist/grid/chrome/GridChipsEditor.js +21 -26
- package/dist/grid/chrome/GridColumnMenu.d.ts +1 -1
- package/dist/grid/chrome/GridColumnMenu.js +7 -3
- package/dist/grid/chrome/GridDateEditor.d.ts +23 -11
- package/dist/grid/chrome/GridDateEditor.js +13 -25
- package/dist/grid/chrome/GridFooter.d.ts +12 -2
- package/dist/grid/chrome/GridFooter.js +10 -6
- package/dist/grid/chrome/GridGroupMenu.js +20 -13
- package/dist/grid/chrome/GridHeader.d.ts +9 -4
- package/dist/grid/chrome/GridHeader.js +15 -10
- package/dist/grid/chrome/GridLongTextEditor.d.ts +28 -9
- package/dist/grid/chrome/GridLongTextEditor.js +16 -74
- package/dist/grid/chrome/GridNameEditor.d.ts +11 -6
- package/dist/grid/chrome/GridNameEditor.js +12 -27
- package/dist/grid/chrome/GridNumberEditor.d.ts +20 -6
- package/dist/grid/chrome/GridNumberEditor.js +46 -20
- package/dist/grid/chrome/GridPlaceEditor.d.ts +26 -0
- package/dist/grid/chrome/GridPlaceEditor.js +22 -0
- package/dist/grid/chrome/GridRangeEditor.d.ts +15 -5
- package/dist/grid/chrome/GridRangeEditor.js +16 -20
- package/dist/grid/chrome/GridRelationEditor.d.ts +38 -14
- package/dist/grid/chrome/GridRelationEditor.js +86 -24
- package/dist/grid/chrome/GridRow.d.ts +7 -1
- package/dist/grid/chrome/GridRow.js +57 -14
- package/dist/grid/chrome/GridRowActions.js +1 -1
- package/dist/grid/chrome/GridRowCells.js +18 -23
- package/dist/grid/chrome/GridSelectEditor.d.ts +19 -4
- package/dist/grid/chrome/GridSelectEditor.js +21 -27
- package/dist/grid/chrome/GridStructure.d.ts +9 -10
- package/dist/grid/chrome/GridStructure.js +10 -14
- package/dist/grid/chrome/GridTable.js +97 -30
- package/dist/grid/chrome/GridTableSurface.d.ts +39 -2
- package/dist/grid/chrome/GridTableSurface.js +12 -3
- package/dist/grid/chrome/GridTextEditor.d.ts +35 -1
- package/dist/grid/chrome/GridTextEditor.js +35 -37
- package/dist/grid/chrome/GridValueListEditor.d.ts +15 -3
- package/dist/grid/chrome/GridValueListEditor.js +10 -27
- package/dist/grid/chrome/cell-cut-off.d.ts +11 -0
- package/dist/grid/chrome/cell-cut-off.js +20 -0
- package/dist/grid/chrome/cells.js +1 -2
- package/dist/grid/chrome/checks.d.ts +2 -5
- package/dist/grid/chrome/checks.js +15 -5
- package/dist/grid/chrome/editors.d.ts +1 -1
- package/dist/grid/chrome/editors.js +1 -1
- package/dist/grid/chrome/grid-cell-classes.d.ts +2 -8
- package/dist/grid/chrome/grid-cell-classes.js +10 -8
- package/dist/grid/chrome/grid-cell-link.d.ts +13 -0
- package/dist/grid/chrome/grid-cell-link.js +9 -0
- package/dist/grid/chrome/grid-edit-session.d.ts +63 -0
- package/dist/grid/chrome/grid-edit-session.js +118 -0
- package/dist/grid/chrome/grid-hover.d.ts +60 -0
- package/dist/grid/chrome/grid-hover.js +81 -0
- package/dist/grid/chrome/grid-menu-focus.d.ts +43 -0
- package/dist/grid/chrome/grid-menu-focus.js +93 -0
- package/dist/grid/chrome/grid-row-menu-key.d.ts +15 -0
- package/dist/grid/chrome/grid-row-menu-key.js +36 -0
- package/dist/grid/chrome/grid-row-props.d.ts +16 -4
- package/dist/grid/chrome/grid-row-window.d.ts +61 -0
- package/dist/grid/chrome/grid-row-window.js +212 -0
- package/dist/grid/chrome/grid-scroll-owner.d.ts +38 -0
- package/dist/grid/chrome/grid-scroll-owner.js +75 -0
- package/dist/grid/chrome/grid-styles.d.ts +4 -1
- package/dist/grid/chrome/grid-styles.js +1 -0
- package/dist/grid/chrome/grid-table-props.d.ts +2 -3
- package/dist/grid/chrome/useGridFocus.d.ts +45 -0
- package/dist/grid/chrome/useGridFocus.js +122 -0
- package/dist/grid/chrome/useGridKeyboard.d.ts +21 -4
- package/dist/grid/chrome/useGridKeyboard.js +214 -38
- package/dist/grid/chrome/useGridRangeActions.d.ts +3 -1
- package/dist/grid/chrome/useGridRangeActions.js +17 -10
- package/dist/grid/chrome/useGridRangeGestures.js +68 -21
- package/dist/grid/chrome/useGridRowContextMenu.d.ts +4 -2
- package/dist/grid/chrome/useGridRowContextMenu.js +28 -2
- package/dist/grid/chrome/useGridScaleStyles.d.ts +3 -1
- package/dist/grid/chrome/useGridScaleStyles.js +6 -7
- package/dist/grid/chrome/useGridScrollArea.d.ts +21 -0
- package/dist/grid/chrome/useGridScrollArea.js +65 -0
- package/dist/grid/chrome/useGridTableInteractionModel.d.ts +28 -5
- package/dist/grid/chrome/useGridTableInteractionModel.js +66 -14
- package/dist/grid/chrome/useHeaderDragReorder.d.ts +2 -2
- package/dist/grid/core/clipboard-model.d.ts +2 -0
- package/dist/grid/core/clipboard-model.js +1 -1
- package/dist/grid/core/commit-model.d.ts +7 -0
- package/dist/grid/core/edge-scroll.d.ts +21 -0
- package/dist/grid/core/edge-scroll.js +23 -0
- package/dist/grid/core/editing-controller.d.ts +2 -1
- package/dist/grid/core/editing-controller.js +35 -9
- package/dist/grid/core/editing-model.d.ts +9 -0
- package/dist/grid/core/editing-model.js +12 -0
- package/dist/grid/core/flat-rows.d.ts +35 -0
- package/dist/grid/core/flat-rows.js +20 -0
- package/dist/grid/core/grid-aria.d.ts +27 -0
- package/dist/grid/core/grid-aria.js +39 -0
- package/dist/grid/core/grid-focus.d.ts +54 -0
- package/dist/grid/core/grid-focus.js +148 -0
- package/dist/grid/core/nav.d.ts +2 -2
- package/dist/grid/core/pending-reconciliation.d.ts +3 -0
- package/dist/grid/core/pending-reconciliation.js +5 -3
- package/dist/grid/core/row-window.d.ts +40 -0
- package/dist/grid/core/row-window.js +43 -0
- package/dist/grid/core/spreadsheet-operations.d.ts +17 -1
- package/dist/grid/core/spreadsheet-operations.js +33 -6
- package/dist/grid/core/useGridEditing.d.ts +3 -0
- package/dist/grid/core/useGridEditing.js +6 -3
- package/dist/grid/core/value-equality.d.ts +23 -1
- package/dist/grid/core/value-equality.js +46 -0
- package/dist/grid/useGridTablePrefs.d.ts +0 -1
- package/dist/grid/useGridTablePrefs.js +1 -3
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/internal/viewport.d.ts +0 -2
- package/dist/internal/viewport.js +0 -14
- package/dist/model/column-capabilities.d.ts +2 -1
- package/dist/model/column-capabilities.js +28 -8
- package/dist/model/column-from.js +3 -0
- package/dist/model/column-inspect.d.ts +10 -2
- package/dist/model/column-inspect.js +9 -0
- package/dist/model/column-schema.d.ts +6 -1
- package/dist/model/column-types.d.ts +3 -1
- package/dist/model/column-types.js +1 -1
- package/dist/model/preferences.d.ts +0 -4
- package/dist/model/preferences.js +0 -1
- package/dist/model/prefs-buckets.d.ts +0 -1
- package/dist/model/prefs-buckets.js +0 -3
- package/dist/model/render-count.d.ts +6 -0
- package/dist/model/render-count.js +11 -0
- package/dist/provider/ViewsProvider.d.ts +5 -1
- package/dist/provider/ViewsProvider.js +9 -3
- package/dist/provider/components.d.ts +19 -1
- package/dist/provider/components.js +4 -2
- package/dist/provider/context.d.ts +5 -2
- package/dist/provider/desktop.d.ts +9 -0
- package/dist/provider/desktop.js +22 -0
- package/dist/provider/plain-input.d.ts +8 -0
- package/dist/provider/plain-input.js +5 -0
- package/dist/react.d.ts +2 -1
- package/dist/react.js +1 -0
- package/dist/selection/SelectCheckbox.d.ts +3 -1
- package/dist/selection/SelectCheckbox.js +2 -2
- package/dist/selection/useCheckDragSelect.js +6 -5
- package/docs/contract.md +93 -35
- package/docs/guides/atoms.md +1 -1
- package/docs/guides/cells.md +2 -2
- package/docs/guides/columns.md +3 -2
- package/docs/guides/display.md +1 -0
- package/docs/guides/editors.md +71 -13
- package/docs/guides/the-grid.md +32 -13
- package/docs/guides/the-provider.md +3 -1
- package/docs/index.md +3 -1
- package/docs/install.md +1 -1
- package/docs/reference/cells.md +1 -1
- package/docs/reference/display.md +3 -1
- package/docs/reference/editors-chips.md +2 -2
- package/docs/reference/editors-date.md +3 -3
- package/docs/reference/editors-location.md +1 -1
- package/docs/reference/editors-number.md +1 -1
- package/docs/reference/editors-open-values.md +1 -0
- package/docs/reference/editors-panel.md +12 -0
- package/docs/reference/editors-range.md +1 -1
- package/docs/reference/editors-relation.md +6 -3
- package/docs/reference/editors-select.md +3 -2
- package/docs/reference/editors-session.md +4 -2
- package/docs/reference/editors-text.md +9 -0
- package/docs/reference/editors-value-list.md +1 -1
- package/docs/reference/editors.md +2 -2
- package/docs/reference/field-row.md +16 -0
- package/docs/reference/grid.md +3 -3
- package/docs/reference/react.md +8 -5
- package/docs/reference/views.md +36 -15
- package/package.json +23 -4
- package/skills/views/SKILL.md +4 -4
- package/dist/grid/chrome/useGridScrollSync.d.ts +0 -38
- package/dist/grid/chrome/useGridScrollSync.js +0 -176
|
@@ -1,21 +1,17 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import { jsx as _jsx,
|
|
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 {
|
|
7
|
+
import { GridWindowRows } from "./grid-row-window.js";
|
|
8
8
|
import { GridGroupMenu } from "./GridGroupMenu.js";
|
|
9
|
-
import {
|
|
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:
|
|
12
|
+
return (_jsx(Collapse, { open: !collapsed, clipClassName: "pt-[2px] mt-[-2px] pb-2 -mb-2", children: children }));
|
|
13
13
|
}
|
|
14
|
-
function
|
|
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-
|
|
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,
|
|
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(
|
|
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: [
|
|
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,
|
|
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 {
|
|
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 {
|
|
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
|
|
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 && !
|
|
49
|
-
const scaleVarsStyle = useGridScaleStyles(scale, grouped,
|
|
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
|
|
54
|
-
for (const row of
|
|
63
|
+
for (const section of flat.sections) {
|
|
64
|
+
for (const row of section.items) {
|
|
55
65
|
const rowId = getRowId(row);
|
|
56
|
-
const key = gridRowKey(
|
|
66
|
+
const key = gridRowKey(section.groupKey, rowId);
|
|
57
67
|
byKey.set(key, { key, rowId, row });
|
|
58
68
|
}
|
|
59
69
|
}
|
|
60
70
|
return byKey;
|
|
61
|
-
}, [
|
|
62
|
-
const visibleRowKeys =
|
|
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
|
|
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
|
|
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,
|
|
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 = (
|
|
111
|
-
const footer = (group) => (_jsx(GridFooter, { group: group,
|
|
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(
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
event
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
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
|
-
|
|
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
|
-
|
|
5
|
-
|
|
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
|
-
|
|
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 {
|
|
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
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.
|
|
6
|
-
*
|
|
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 {
|
|
4
|
+
import { EditorPanel } from "../../editors/EditorPanel.js";
|
|
5
5
|
import { ValueListEditor } from "../../editors/ValueListEditor.js";
|
|
6
|
-
import {
|
|
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
|
|
12
|
-
const { open, close } = useAnchoredEditSession({
|
|
10
|
+
const { session, close } = useGridEditSession({
|
|
13
11
|
editorRef,
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
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
|
-
|
|
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:
|
|
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)
|