@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,25 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { useRef } from "react";
|
|
4
|
+
import { RangeEditor } from "../../editors/RangeEditor.js";
|
|
5
|
+
export function GridRangeEditor({ initial, seed, decimals = 0, allowEmpty = false, suffix, onCommit, onCancel, onTab, onEnter, }) {
|
|
6
|
+
const editorRef = useRef(null);
|
|
7
|
+
const closedRef = useRef(false);
|
|
8
|
+
const close = (reason) => {
|
|
9
|
+
if (closedRef.current)
|
|
10
|
+
return;
|
|
11
|
+
closedRef.current = true;
|
|
12
|
+
const resolution = editorRef.current?.resolveClose(reason) ?? { kind: "noop" };
|
|
13
|
+
if (resolution.kind === "commit")
|
|
14
|
+
onCommit(resolution.payload);
|
|
15
|
+
else
|
|
16
|
+
onCancel();
|
|
17
|
+
if (reason === "enter")
|
|
18
|
+
onEnter?.();
|
|
19
|
+
if (reason === "tab")
|
|
20
|
+
onTab?.(false);
|
|
21
|
+
if (reason === "shift-tab")
|
|
22
|
+
onTab?.(true);
|
|
23
|
+
};
|
|
24
|
+
return (_jsx("span", { "data-slot": "vk-grid-editor", className: "flex h-full w-full min-w-0", children: _jsx(RangeEditor, { ref: editorRef, initial: initial, seed: seed, decimals: decimals, allowEmpty: allowEmpty, suffix: suffix, onRequestClose: close }) }));
|
|
25
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { RelationSource } from "../../fields/relation-source-types.js";
|
|
2
|
+
/**
|
|
3
|
+
* The GRID's host around the shared `RelationEditor` (`@viewkitjs/views/editors/relation`)
|
|
4
|
+
* — the search-and-pick panel is one component across every surface; this host
|
|
5
|
+
* owns only the grid's mechanics: anchor to the cell rect, open on mount, WHICH
|
|
6
|
+
* close happened, the exit animation gap, and the write.
|
|
7
|
+
*
|
|
8
|
+
* The candidate list is the column's, not the table's: every subscription you
|
|
9
|
+
* could link to, including ones no row currently points at — which is the whole
|
|
10
|
+
* difference from the Filter panel's list, and the reason a table of ten rows
|
|
11
|
+
* can still move a transaction onto any of seventy subscriptions.
|
|
12
|
+
*/
|
|
13
|
+
export declare function GridRelationEditor({ candidates, current, clearable, onCommit, onCancel, }: {
|
|
14
|
+
candidates: RelationSource;
|
|
15
|
+
/** The linked id, or null when the cell is empty. */
|
|
16
|
+
current: string | null;
|
|
17
|
+
/** Offer "None" — only when the column says the link is optional. */
|
|
18
|
+
clearable: boolean;
|
|
19
|
+
onCommit: (id: string | null) => void;
|
|
20
|
+
onCancel: () => void;
|
|
21
|
+
}): import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { useRef, useState } from "react";
|
|
4
|
+
import { useViews } from "../../provider/context.js";
|
|
5
|
+
import { RelationEditor } from "../../editors/RelationEditor.js";
|
|
6
|
+
export function GridRelationEditor({ candidates, current, clearable, onCommit, onCancel, }) {
|
|
7
|
+
const { Popover } = useViews().components;
|
|
8
|
+
const [open, setOpen] = useState(true);
|
|
9
|
+
const editorRef = useRef(null);
|
|
10
|
+
const anchorRef = useRef(null);
|
|
11
|
+
const closedRef = useRef(false);
|
|
12
|
+
const EXIT_MS = 160;
|
|
13
|
+
const close = (reason) => {
|
|
14
|
+
if (closedRef.current)
|
|
15
|
+
return;
|
|
16
|
+
closedRef.current = true;
|
|
17
|
+
const resolution = editorRef.current?.resolveClose(reason) ?? { kind: "noop" };
|
|
18
|
+
setOpen(false);
|
|
19
|
+
window.setTimeout(() => {
|
|
20
|
+
if (resolution.kind === "commit")
|
|
21
|
+
onCommit(resolution.payload);
|
|
22
|
+
else
|
|
23
|
+
onCancel();
|
|
24
|
+
}, EXIT_MS);
|
|
25
|
+
};
|
|
26
|
+
return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(Popover, { open: open, onOpenChange: (next) => {
|
|
27
|
+
if (!next)
|
|
28
|
+
close("outside");
|
|
29
|
+
}, anchor: anchorRef, align: "start", sideOffset: 4, onEscape: () => close("escape"), onOutsidePress: () => close("outside"), onPanelClick: (e) => e.stopPropagation(), panelData: { "data-slot": "vk-grid-editor" }, chrome: "menu", className: "w-64 z-90", children: _jsx(RelationEditor, { ref: editorRef, candidates: candidates, initial: current, clearable: clearable, onRequestClose: close }) })] }));
|
|
30
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The column-resize grab zone on a header cell's right edge. The header cell is
|
|
3
|
+
* (usually) a Radix PopoverTrigger — every pointer/click event here stops
|
|
4
|
+
* propagation so a resize drag (or its post-drag compatibility click) never
|
|
5
|
+
* opens the header menu, and a plain click on the edge does nothing.
|
|
6
|
+
*
|
|
7
|
+
* The drag itself lives in GridTable (pointer capture on this element retargets
|
|
8
|
+
* move/up here, so the passed handlers see the whole gesture without any
|
|
9
|
+
* document listeners). Double-click clears the column's width override — but
|
|
10
|
+
* only for true double-clicks; GridTable ignores it after a real drag.
|
|
11
|
+
*/
|
|
12
|
+
export declare function GridResizeHandle({ active, onResizeStart, onResizeMove, onResizeEnd, onReset, }: {
|
|
13
|
+
/** True while THIS column is being dragged — pins the hairline visible. */
|
|
14
|
+
active: boolean;
|
|
15
|
+
onResizeStart: (e: React.PointerEvent<HTMLElement>) => void;
|
|
16
|
+
onResizeMove: (e: React.PointerEvent<HTMLElement>) => void;
|
|
17
|
+
onResizeEnd: (e: React.PointerEvent<HTMLElement>) => void;
|
|
18
|
+
onReset: () => void;
|
|
19
|
+
}): import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { cx } from "../../internal/cx.js";
|
|
4
|
+
export function GridResizeHandle({ active, onResizeStart, onResizeMove, onResizeEnd, onReset, }) {
|
|
5
|
+
return (_jsx("div", { "data-slot": "vk-grid-resize-handle", "data-no-nav": true, className: "group/gridresize absolute inset-y-0 right-0 z-10 w-[7px] cursor-col-resize touch-none", onPointerDown: (e) => {
|
|
6
|
+
if (e.button !== 0)
|
|
7
|
+
return;
|
|
8
|
+
e.stopPropagation();
|
|
9
|
+
e.preventDefault();
|
|
10
|
+
e.currentTarget.setPointerCapture(e.pointerId);
|
|
11
|
+
onResizeStart(e);
|
|
12
|
+
}, onPointerMove: onResizeMove, onPointerUp: (e) => {
|
|
13
|
+
e.stopPropagation();
|
|
14
|
+
onResizeEnd(e);
|
|
15
|
+
}, onPointerCancel: onResizeEnd, onClick: (e) => e.stopPropagation(), onDoubleClick: (e) => {
|
|
16
|
+
e.stopPropagation();
|
|
17
|
+
onReset();
|
|
18
|
+
}, children: _jsx("div", { className: cx("absolute inset-y-0 right-0 w-[3px] rounded-full bg-(color:--vk-brand)", active ? "opacity-100" : "opacity-0 group-hover/gridresize:opacity-100") }) }));
|
|
19
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { GridRowProps } from "./grid-row-props.js";
|
|
2
|
+
/**
|
|
3
|
+
* Whether a pointerdown is about to open the row — the same test the click
|
|
4
|
+
* handler applies, one event earlier, so the drawer's data is on its way
|
|
5
|
+
* before the click lands. Only the `[data-cell-open]` hotspot (the title text)
|
|
6
|
+
* opens the row, so the columns play no part in the answer.
|
|
7
|
+
*/
|
|
8
|
+
export declare function shouldPrefetchGridRow(target: HTMLElement): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* One spreadsheet row: a strip of bordered cells on the shared template
|
|
11
|
+
* (gutter track first). No kebab — actions live on right-click
|
|
12
|
+
* (the row's menu, `RowMenu`) and in the entity drawer.
|
|
13
|
+
*
|
|
14
|
+
* Click contract (Sheets model, Tier 3):
|
|
15
|
+
* real controls win → cmd/shift row-select → selection-mode toggle →
|
|
16
|
+
* title-TEXT click opens the drawer (`[data-cell-open]` hotspot — the text
|
|
17
|
+
* only, never the cell's padding) →
|
|
18
|
+
* otherwise the click SELECTS the cell, the title cell included; a second
|
|
19
|
+
* click on the selected cell (or dblclick / Enter) starts editing when the
|
|
20
|
+
* column has an editor.
|
|
21
|
+
* Middle-click still opens `rowHref` in a new tab.
|
|
22
|
+
*/
|
|
23
|
+
declare function GridRowInner<Row>(props: GridRowProps<Row>): import("react/jsx-runtime").JSX.Element;
|
|
24
|
+
export declare const GridRow: typeof GridRowInner;
|
|
25
|
+
export {};
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { memo } from "react";
|
|
4
|
+
import { cx } from "../../internal/cx.js";
|
|
5
|
+
import { GridRowCheck, GridRailSpacer } from "./checks.js";
|
|
6
|
+
import { GRID_TAIL_BUTTON_BASE } from "./grid-styles.js";
|
|
7
|
+
import { gridRowClassName } from "./grid-cell-classes.js";
|
|
8
|
+
import { preventShiftTextSelect, ROW_INTERACTIVE_SELECTOR } from "../../selection/row-click.js";
|
|
9
|
+
import { useRestIntent } from "../../selection/useRestIntent.js";
|
|
10
|
+
import { gridColumnHasEditor } from "./editors.js";
|
|
11
|
+
import { gridColumnInspectable } from "../../model/column-inspect.js";
|
|
12
|
+
import { countRowRender } from "../../model/render-count.js";
|
|
13
|
+
import { useGridRowContextMenu } from "./useGridRowContextMenu.js";
|
|
14
|
+
import { GridRowCells } from "./GridRowCells.js";
|
|
15
|
+
import { useViews } from "../../provider/context.js";
|
|
16
|
+
export function shouldPrefetchGridRow(target) {
|
|
17
|
+
if (target.closest(ROW_INTERACTIVE_SELECTOR))
|
|
18
|
+
return false;
|
|
19
|
+
return target.closest("[data-cell-open]") != null;
|
|
20
|
+
}
|
|
21
|
+
function GridRowInner(props) {
|
|
22
|
+
countRowRender();
|
|
23
|
+
const { icons, messages, atoms } = useViews();
|
|
24
|
+
const More = icons.more;
|
|
25
|
+
const RowMenu = atoms.RowMenu;
|
|
26
|
+
const { row, id, gridTemplate, columns, selectable, selected, selectedAbove, selecting, toggle, toggleRange, contextMenu, rowClassName, rowHref, onOpenRow, onPrefetchRow, onRowDelete, deleteLabel, editingEnabled, focusedColId, editingColId, pendingByCol, selectValues, rowRange, onFocusCell, rowKey, onStartEdit, onRefuseEdit, onExtendCell, onAddCell, onCommitCell, inActiveRange, rangeCanClear, onRangeCopy, onRangeCut, onRangePaste, onRangeClear, onPasteAtCell, } = props;
|
|
27
|
+
const href = rowHref?.(row);
|
|
28
|
+
const canEdit = (col) => editingEnabled && gridColumnHasEditor(col);
|
|
29
|
+
const opensPanel = (col) => canEdit(col) || gridColumnInspectable(col);
|
|
30
|
+
const { contextItems, handleContextMenu } = useGridRowContextMenu({
|
|
31
|
+
row,
|
|
32
|
+
id,
|
|
33
|
+
columns,
|
|
34
|
+
selecting,
|
|
35
|
+
selectable,
|
|
36
|
+
selected,
|
|
37
|
+
toggle,
|
|
38
|
+
editingEnabled,
|
|
39
|
+
pendingByCol,
|
|
40
|
+
selectValues,
|
|
41
|
+
rowRange,
|
|
42
|
+
contextMenu,
|
|
43
|
+
inActiveRange,
|
|
44
|
+
rangeCanClear,
|
|
45
|
+
onRangeCopy,
|
|
46
|
+
onRangeCut,
|
|
47
|
+
onRangePaste,
|
|
48
|
+
onRangeClear,
|
|
49
|
+
onPasteAtCell,
|
|
50
|
+
onCommitCell,
|
|
51
|
+
onFocusCell,
|
|
52
|
+
rowKey,
|
|
53
|
+
});
|
|
54
|
+
const findCol = (target) => {
|
|
55
|
+
const colId = target.closest("[data-col-id]")?.getAttribute("data-col-id");
|
|
56
|
+
return colId ? columns.find((c) => c.id === colId) : undefined;
|
|
57
|
+
};
|
|
58
|
+
const handleClick = (e) => {
|
|
59
|
+
const target = e.target;
|
|
60
|
+
if (target.closest(ROW_INTERACTIVE_SELECTOR))
|
|
61
|
+
return;
|
|
62
|
+
if (selecting) {
|
|
63
|
+
toggle(id);
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
if (e.shiftKey || e.metaKey || e.ctrlKey) {
|
|
67
|
+
const col = findCol(target);
|
|
68
|
+
if (col)
|
|
69
|
+
(e.shiftKey ? onExtendCell : onAddCell)(rowKey, col.id);
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
const col = findCol(target);
|
|
73
|
+
if (target.closest("[data-cell-open]")) {
|
|
74
|
+
onOpenRow(row);
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
if (!col)
|
|
78
|
+
return;
|
|
79
|
+
if (focusedColId === col.id) {
|
|
80
|
+
if (!opensPanel(col))
|
|
81
|
+
onRefuseEdit?.(col.id);
|
|
82
|
+
else if (editingColId !== col.id)
|
|
83
|
+
onStartEdit(rowKey, col.id);
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
onFocusCell(rowKey, col.id);
|
|
87
|
+
};
|
|
88
|
+
const handleDoubleClick = (e) => {
|
|
89
|
+
const target = e.target;
|
|
90
|
+
if (target.closest(ROW_INTERACTIVE_SELECTOR))
|
|
91
|
+
return;
|
|
92
|
+
if (selecting || target.closest("[data-cell-open]"))
|
|
93
|
+
return;
|
|
94
|
+
const col = findCol(target);
|
|
95
|
+
if (!col)
|
|
96
|
+
return;
|
|
97
|
+
if (!opensPanel(col))
|
|
98
|
+
onRefuseEdit?.(col.id);
|
|
99
|
+
else if (editingColId !== col.id)
|
|
100
|
+
onStartEdit(rowKey, col.id);
|
|
101
|
+
};
|
|
102
|
+
const handlePointerDown = (e) => {
|
|
103
|
+
if (e.button !== 0)
|
|
104
|
+
return;
|
|
105
|
+
const target = e.target;
|
|
106
|
+
if (shouldPrefetchGridRow(target))
|
|
107
|
+
onPrefetchRow?.(row);
|
|
108
|
+
};
|
|
109
|
+
const rest = useRestIntent(onPrefetchRow ? () => onPrefetchRow(row) : undefined, (target) => shouldPrefetchGridRow(target));
|
|
110
|
+
const handleMouseDown = (e) => {
|
|
111
|
+
if (e.button === 1) {
|
|
112
|
+
const target = e.target;
|
|
113
|
+
if (href && !target.closest(ROW_INTERACTIVE_SELECTOR)) {
|
|
114
|
+
e.preventDefault();
|
|
115
|
+
window.open(href, "_blank", "noopener,noreferrer");
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
if (selectable)
|
|
120
|
+
preventShiftTextSelect(e);
|
|
121
|
+
};
|
|
122
|
+
const body = (_jsxs("div", { "data-slot": "vk-grid-row", "data-row-id": rowKey, onPointerDown: handlePointerDown, onPointerOver: rest.onPointerOver, onPointerLeave: rest.onPointerLeave, onMouseDown: handleMouseDown, onClick: handleClick, onDoubleClick: handleDoubleClick, onContextMenu: handleContextMenu, className: gridRowClassName({ selected, selectable, wrapCells: !!props.wrapCells, hostClass: rowClassName?.(row) }), style: { gridTemplateColumns: gridTemplate }, children: [selected && !selectedAbove && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-x-0 top-0 z-11 h-px bg-(color:--vk-brand)" })), selected && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-x-0 bottom-0 z-11 h-px bg-(color:--vk-brand)" })), selectable ? (_jsx(GridRowCheck, { selecting: selecting, checked: selected, revealed: selected, onChange: (next, shift) => (shift ? toggleRange(id) : toggle(id, next)), "aria-label": messages({ key: "views.grid.select-row" }) })) : (_jsx(GridRailSpacer, { selecting: false, bordered: true })), _jsx(GridRowCells, { props: props }), _jsx("div", { "data-slot": "vk-grid-tail", className: cx("flex border-b border-(color:--vk-border-subtle) pl-(--vk-tail-pl,var(--vk-px))", props.wrapCells
|
|
123
|
+
? "min-h-(--vk-row-h) items-start py-(--vk-tail-py)"
|
|
124
|
+
: "h-(--vk-row-h) items-center"), children: _jsx("button", { type: "button", tabIndex: -1, "data-slot": "vk-grid-row-more", "aria-label": messages({ key: "views.grid.row-menu" }), title: messages({ key: "views.grid.row-menu" }), onClick: (e) => {
|
|
125
|
+
e.stopPropagation();
|
|
126
|
+
const rect = e.currentTarget.getBoundingClientRect();
|
|
127
|
+
e.currentTarget.dispatchEvent(new MouseEvent("contextmenu", {
|
|
128
|
+
bubbles: true,
|
|
129
|
+
cancelable: true,
|
|
130
|
+
clientX: rect.left,
|
|
131
|
+
clientY: rect.bottom + 6,
|
|
132
|
+
}));
|
|
133
|
+
}, className: cx(GRID_TAIL_BUTTON_BASE, "md:opacity-0 md:group-hover/gridrow:opacity-100", selected ? "hover:bg-(color:--vk-brand-subtlest)" : "hover:bg-(color:--vk-hovered)"), children: _jsx(More, { className: "h-4 w-4" }) }) })] }));
|
|
134
|
+
return (_jsx(RowMenu, { rowId: id, items: contextItems, openHref: href, onDelete: onRowDelete, deleteLabel: deleteLabel, onToggleSelect: selectable ? () => toggle(id, !selected) : undefined, children: body }));
|
|
135
|
+
}
|
|
136
|
+
export const GridRow = memo(GridRowInner);
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { MouseEvent as ReactMouseEvent, ReactNode } from "react";
|
|
2
|
+
import type { ListCellAction } from "../../model/column-schema.js";
|
|
3
|
+
/**
|
|
4
|
+
* Small icon-button affordances inside a grid row, and the lane that hosts them.
|
|
5
|
+
*
|
|
6
|
+
* Two surfaces, one button primitive:
|
|
7
|
+
* - `bare` — an action COLUMN's cell. The icon owns its own cell, so it
|
|
8
|
+
* needs no box of its own.
|
|
9
|
+
* - `outlined` — the title cell's trailing lane. Several buttons sit
|
|
10
|
+
* shoulder-to-shoulder ON TOP of row content, so each needs a
|
|
11
|
+
* filled, bordered box to read as a discrete target.
|
|
12
|
+
*
|
|
13
|
+
* Adding an action is declaring one `ListCellAction` — the same shape action
|
|
14
|
+
* columns already use. No new component per action, no bespoke button markup.
|
|
15
|
+
*/
|
|
16
|
+
type GridActionVariant = "bare" | "outlined";
|
|
17
|
+
export declare function GridActionButton({ variant, label, onClick, tabIndex, className, children, }: {
|
|
18
|
+
variant?: GridActionVariant;
|
|
19
|
+
label?: string;
|
|
20
|
+
onClick?: (e: ReactMouseEvent<HTMLButtonElement>) => void;
|
|
21
|
+
/** -1 for hover-revealed lanes — tabbing to an invisible button is a trap. */
|
|
22
|
+
tabIndex?: number;
|
|
23
|
+
className?: string;
|
|
24
|
+
children: ReactNode;
|
|
25
|
+
}): import("react/jsx-runtime").JSX.Element;
|
|
26
|
+
export declare function GridRowActions<Row>({ row, actions, selected, }: {
|
|
27
|
+
row: Row;
|
|
28
|
+
actions: ListCellAction<Row>[];
|
|
29
|
+
/** This row is selected — the backing carries its tint. */
|
|
30
|
+
selected?: boolean;
|
|
31
|
+
}): import("react/jsx-runtime").JSX.Element | null;
|
|
32
|
+
export {};
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { cx } from "../../internal/cx.js";
|
|
4
|
+
import { gridFrozenBg } from "./GridCellOutline.js";
|
|
5
|
+
const VARIANT = {
|
|
6
|
+
bare: "h-6 w-6 rounded-md hover:bg-(color:--vk-hovered)",
|
|
7
|
+
outlined: "h-6 w-6 rounded-md [corner-shape:squircle] border border-(color:--vk-border) bg-(color:--vk-ground) shadow-xs hover:bg-(color:--vk-hovered)",
|
|
8
|
+
};
|
|
9
|
+
export function GridActionButton({ variant = "bare", label, onClick, tabIndex, className, children, }) {
|
|
10
|
+
return (_jsx("button", { type: "button", tabIndex: tabIndex, "aria-label": label, title: label, onClick: (e) => {
|
|
11
|
+
e.stopPropagation();
|
|
12
|
+
onClick?.(e);
|
|
13
|
+
}, className: cx("flex shrink-0 items-center justify-center text-(color:--vk-fg-subtle) hover:text-(color:--vk-fg)", VARIANT[variant], className), children: children }));
|
|
14
|
+
}
|
|
15
|
+
const LANE_RAMP = "linear-gradient(to right, transparent 0, rgb(0 0 0) 2rem)";
|
|
16
|
+
export function GridRowActions({ row, actions, selected = false, }) {
|
|
17
|
+
if (actions.length === 0)
|
|
18
|
+
return null;
|
|
19
|
+
return (_jsxs("span", { className: "pointer-events-none absolute right-0 top-0 hidden md:flex h-(--vk-chrome-h,100%) items-center gap-1 pl-8 pr-(--vk-px) opacity-0 group-hover/gridrow:opacity-100", children: [_jsx("span", { "aria-hidden": true, className: cx("absolute inset-0", gridFrozenBg(selected)), style: { maskImage: LANE_RAMP, WebkitMaskImage: LANE_RAMP } }), actions.map((a) => {
|
|
20
|
+
const glyph = a.icon(row);
|
|
21
|
+
if (!glyph)
|
|
22
|
+
return null;
|
|
23
|
+
return (_jsx(GridActionButton, { variant: "outlined", tabIndex: -1, className: "pointer-events-auto relative", label: a.label?.(row), onClick: a.onClick ? (e) => a.onClick?.(row, e) : undefined, children: glyph }, a.id));
|
|
24
|
+
})] }));
|
|
25
|
+
}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { cx } from "../../internal/cx.js";
|
|
4
|
+
import { useViews } from "../../provider/context.js";
|
|
5
|
+
import { shownCodeOf } from "../../fields/money.js";
|
|
6
|
+
import { cellEditBaseline } from "./cell-clipboard.js";
|
|
7
|
+
import { renderActionCell, renderTypedCell } from "./cells.js";
|
|
8
|
+
import { gridColumnHasEditor, gridEditorKind } from "./editors.js";
|
|
9
|
+
import { GridCellAnchoredEditor, GridCellInlineEditor, } from "./GridCellEditors.js";
|
|
10
|
+
import { GridCellOutline } from "./GridCellOutline.js";
|
|
11
|
+
import { GRID_RANGE_TINT_CLASS, gridCellClassName } from "./grid-cell-classes.js";
|
|
12
|
+
import { gridBooleanMode, columnEffectiveWritable } from "../../model/column-capabilities.js";
|
|
13
|
+
import { gridColumnInspectable, isLongTextColumn } from "../../model/column-inspect.js";
|
|
14
|
+
import { fieldKeyOf } from "../../model/view-rules.js";
|
|
15
|
+
import { GridRowActions } from "./GridRowActions.js";
|
|
16
|
+
import { GridRowGlyph } from "./GridRowGlyph.js";
|
|
17
|
+
import { requestedSettlementTitle } from "@viewkitjs/fields";
|
|
18
|
+
function FillDot({ enabled }) {
|
|
19
|
+
return (_jsx("span", { "data-fill-dot": enabled ? "" : undefined, className: cx("absolute bottom-[-7px] right-[-7px] z-10 hidden h-3 w-3 rounded-full border-2 border-(color:--vk-ground) bg-(color:--vk-brand)", "[@media(hover:hover)_and_(pointer:fine)]:block", enabled ? "cursor-crosshair" : "pointer-events-none") }));
|
|
20
|
+
}
|
|
21
|
+
export function GridRowCells({ props }) {
|
|
22
|
+
const { conventions, icons, messages } = useViews();
|
|
23
|
+
const { row, id, rowKey, columns, selected, rowActions, rowIcon, verticalBorders = true, wrapCells = false, optionColors, dateStyles, durationStyles, numberFormats, showTimeOverrides, percentDisplays, editingEnabled, focusedColId, editingColId, pendingByCol, settlementByCol, selectValues, rowRange, frozenCount = 0, frozenLeft, listConfig, onStartEdit, onEditorTab, onEditorEnter, editSeed, onCommitCell, onCancelEdit, onOpenRelation: onOpenRelationValue, entityIcon, commands, } = props;
|
|
24
|
+
const canEdit = (column) => editingEnabled && gridColumnHasEditor(column) && columnEffectiveWritable(column, listConfig);
|
|
25
|
+
const editBaseline = (column) => cellEditBaseline(column, row, pendingByCol);
|
|
26
|
+
return columns.map((col, i) => {
|
|
27
|
+
const editing = editingColId === col.id;
|
|
28
|
+
const focused = focusedColId === col.id;
|
|
29
|
+
const span = rowRange?.find((s) => i >= s.startCol && i <= s.endCol);
|
|
30
|
+
const spanLeft = !!span && i === span.startCol;
|
|
31
|
+
const spanRight = !!span && i === span.endCol;
|
|
32
|
+
const writable = canEdit(col);
|
|
33
|
+
const editorKind = writable
|
|
34
|
+
? gridEditorKind(col)
|
|
35
|
+
: gridColumnInspectable(col)
|
|
36
|
+
? "text"
|
|
37
|
+
: null;
|
|
38
|
+
const fieldKey = fieldKeyOf(col);
|
|
39
|
+
const numberFormat = numberFormats?.[fieldKey];
|
|
40
|
+
const showTime = showTimeOverrides?.[fieldKey] ?? col.format?.withTime ?? false;
|
|
41
|
+
const onResolve = editingEnabled &&
|
|
42
|
+
columnEffectiveWritable(col, listConfig) &&
|
|
43
|
+
gridBooleanMode(col) === "marker"
|
|
44
|
+
? () => onCommitCell(row, id, col.id, true, false)
|
|
45
|
+
: undefined;
|
|
46
|
+
const onToggle = editingEnabled &&
|
|
47
|
+
columnEffectiveWritable(col, listConfig) &&
|
|
48
|
+
gridBooleanMode(col) === "toggle"
|
|
49
|
+
? (next) => onCommitCell(row, id, col.id, editBaseline(col) === true, next)
|
|
50
|
+
: undefined;
|
|
51
|
+
const onOpenRelation = onOpenRelationValue && (col.type === "relation" || col.type === "user")
|
|
52
|
+
?
|
|
53
|
+
(value) => onOpenRelationValue(value, col.id, row)
|
|
54
|
+
: undefined;
|
|
55
|
+
const commandItems = col.command ? commands?.[fieldKeyOf(col)]?.(row) : undefined;
|
|
56
|
+
const typedCell = () => renderTypedCell(col, row, {
|
|
57
|
+
optionColors: optionColors?.[fieldKey],
|
|
58
|
+
dateStyle: dateStyles?.[fieldKey],
|
|
59
|
+
durationStyle: durationStyles?.[fieldKey],
|
|
60
|
+
decimals: numberFormat?.decimals,
|
|
61
|
+
withTime: showTime,
|
|
62
|
+
percentDisplay: percentDisplays?.[fieldKey],
|
|
63
|
+
wrap: wrapCells,
|
|
64
|
+
valueOverride: pendingByCol?.[col.id],
|
|
65
|
+
markerReason: col.marker?.reason?.(row),
|
|
66
|
+
onResolve,
|
|
67
|
+
onToggle,
|
|
68
|
+
onOpenRelation,
|
|
69
|
+
entityIcon,
|
|
70
|
+
commandItems,
|
|
71
|
+
});
|
|
72
|
+
const tabTo = (backwards) => onEditorTab(rowKey, col.id, backwards);
|
|
73
|
+
const enterAdvance = () => onEditorEnter(rowKey, col.id);
|
|
74
|
+
const frozen = i < frozenCount;
|
|
75
|
+
const settlement = settlementByCol?.[col.id];
|
|
76
|
+
const editorCtx = {
|
|
77
|
+
row,
|
|
78
|
+
rowId: id,
|
|
79
|
+
col,
|
|
80
|
+
editorKind,
|
|
81
|
+
readOnly: !writable,
|
|
82
|
+
baseline: editBaseline(col),
|
|
83
|
+
editSeed,
|
|
84
|
+
decimals: numberFormat?.decimals,
|
|
85
|
+
selectValues: selectValues?.[col.id],
|
|
86
|
+
optionColors: optionColors?.[fieldKey],
|
|
87
|
+
entityIcon,
|
|
88
|
+
onCommitCell,
|
|
89
|
+
onCancel: () => onCancelEdit(rowKey, col.id),
|
|
90
|
+
onTab: tabTo,
|
|
91
|
+
onEnter: enterAdvance,
|
|
92
|
+
};
|
|
93
|
+
return (_jsxs("div", { "data-slot": "vk-grid-cell", "data-col-id": col.id, "data-settlement": settlement, title: settlement ? requestedSettlementTitle(col.field?.provenance, conventions) : undefined, style: frozen && frozenLeft ? { left: frozenLeft(i) } : undefined, className: gridCellClassName({
|
|
94
|
+
align: col.align,
|
|
95
|
+
isTitle: col.type === "title",
|
|
96
|
+
frozen,
|
|
97
|
+
focused,
|
|
98
|
+
editing,
|
|
99
|
+
inRange: !!span,
|
|
100
|
+
selected,
|
|
101
|
+
lastColumn: i === columns.length - 1,
|
|
102
|
+
verticalBorders,
|
|
103
|
+
wrap: wrapCells,
|
|
104
|
+
settlement,
|
|
105
|
+
}), children: [span && (_jsx("span", { "aria-hidden": true, className: GRID_RANGE_TINT_CLASS })), span?.top && (_jsx("span", { "aria-hidden": true, "data-slot": "vk-grid-outline", className: "pointer-events-none absolute z-6 bg-(color:--vk-brand)", style: { top: -2, height: 1, left: spanLeft ? -2 : 0, right: -2 } })), span?.bottom && (_jsx("span", { "aria-hidden": true, "data-slot": "vk-grid-outline", className: "pointer-events-none absolute z-6 bg-(color:--vk-brand)", style: { bottom: -2, height: 1, left: spanLeft ? -2 : 0, right: -2 } })), spanLeft && span && (_jsx("span", { "aria-hidden": true, "data-slot": "vk-grid-outline", className: "pointer-events-none absolute z-6 bg-(color:--vk-brand)", style: { left: -2, width: 1, top: span.top ? -2 : 0, bottom: -2 } })), spanRight && span && (_jsx("span", { "aria-hidden": true, "data-slot": "vk-grid-outline", className: "pointer-events-none absolute z-6 bg-(color:--vk-brand)", style: { right: -2, width: 1, top: span.top ? -2 : 0, bottom: -2 } })), span && span.dotCol === i && !editing && (_jsx(FillDot, { enabled: editingEnabled })), (focused || editing) && (_jsx(GridCellOutline, { tone: "focus", editing: editing })), !focused && !editing && !span && col.type !== "title" && (_jsx(GridCellOutline, { tone: "hover" })), focused && !editing && !span && (_jsx(FillDot, { enabled: editingEnabled })), col.type === "title" && rowIcon && !editing && (_jsx("span", { className: "mr-2.5 flex shrink-0 items-center", children: _jsx(GridRowGlyph, { row: row, rowIcon: rowIcon }) })), editing ? _jsx(GridCellInlineEditor, { ctx: editorCtx }) : null, editing &&
|
|
106
|
+
(editorKind === "number" || editorKind === "range" || (editorKind === "text" && !isLongTextColumn(col)))
|
|
107
|
+
? null
|
|
108
|
+
: col.actions
|
|
109
|
+
? renderActionCell(col, row)
|
|
110
|
+
: col.render
|
|
111
|
+
? col.render(row, { value: col.accessor?.(row), code: shownCodeOf(col, row) })
|
|
112
|
+
: typedCell(), editing ? _jsx(GridCellAnchoredEditor, { ctx: editorCtx }) : null, col.type === "title" && !editing && (_jsx(GridRowActions, { row: row, selected: selected, actions: [
|
|
113
|
+
...(rowActions ?? []),
|
|
114
|
+
...(canEdit(col)
|
|
115
|
+
? [
|
|
116
|
+
{
|
|
117
|
+
id: "edit",
|
|
118
|
+
icon: () => _jsx(icons.edit, { className: "h-3.5 w-3.5" }),
|
|
119
|
+
label: () => messages({ key: "views.menus.edit" }),
|
|
120
|
+
onClick: () => onStartEdit(rowKey, col.id),
|
|
121
|
+
},
|
|
122
|
+
]
|
|
123
|
+
: []),
|
|
124
|
+
] })), (editorKind === "select" || editorKind === "relation" || editorKind === "chips") && (_jsx("button", { type: "button", tabIndex: -1, "aria-label": messages({ key: "views.grid.change-value" }), onClick: (e) => {
|
|
125
|
+
e.stopPropagation();
|
|
126
|
+
if (!editing)
|
|
127
|
+
onStartEdit(rowKey, col.id);
|
|
128
|
+
}, className: cx("absolute right-1 top-[calc(var(--vk-chrome-h,100%)/2)] flex h-5 w-5 -translate-y-1/2 items-center justify-center hover:text-(color:--vk-fg)", editing
|
|
129
|
+
? "text-(color:--vk-fg) opacity-100"
|
|
130
|
+
:
|
|
131
|
+
"text-(color:--vk-fg-subtlest) md:opacity-0 md:group-hover/gridcell:opacity-100"), children: _jsx(icons.caretDown, { className: cx("h-3 w-3 transition-transform duration-100", editing && "rotate-180") }) }))] }, col.id));
|
|
132
|
+
});
|
|
133
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { type ListRowIconAccessor } from "../../model/row-icon.js";
|
|
2
|
+
/**
|
|
3
|
+
* The one place a grid row's leading glyph gets its LOOK — size from the row's
|
|
4
|
+
* own scale variable, color neutral unless the list named a semantic tone.
|
|
5
|
+
*
|
|
6
|
+
* Both facts live here rather than at each call site so a list can only choose
|
|
7
|
+
* WHICH icon and (rarely) what state it means, never how big or how loud.
|
|
8
|
+
*/
|
|
9
|
+
export declare function GridRowGlyph<Row>({ row, rowIcon, }: {
|
|
10
|
+
row: Row;
|
|
11
|
+
rowIcon: ListRowIconAccessor<Row>;
|
|
12
|
+
}): import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { STATUS_SLOT_CLASSES } from "@viewkitjs/fields/design/status-slots";
|
|
4
|
+
import { cx } from "../../internal/cx.js";
|
|
5
|
+
import { normalizeRowIcon } from "../../model/row-icon.js";
|
|
6
|
+
import { useViews } from "../../provider/context.js";
|
|
7
|
+
export function GridRowGlyph({ row, rowIcon, }) {
|
|
8
|
+
const { AppIcon } = useViews().components;
|
|
9
|
+
const resolved = normalizeRowIcon(rowIcon(row));
|
|
10
|
+
if (!resolved)
|
|
11
|
+
return null;
|
|
12
|
+
return (_jsx(AppIcon, { name: resolved.icon, className: cx("h-(--vk-glyph,0.875rem) w-(--vk-glyph,0.875rem)", resolved.tone ? STATUS_SLOT_CLASSES[resolved.tone].glyph : "text-(color:--vk-fg-subtle)") }));
|
|
13
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ListColumn, ListSelectColor } from "../../model/column-schema.js";
|
|
2
|
+
/**
|
|
3
|
+
* The GRID's host around the shared `SelectEditor` (`@viewkitjs/views/editors/select`) —
|
|
4
|
+
* the option panel is one component across every surface; this host owns only
|
|
5
|
+
* the grid's mechanics: anchor to the cell rect, open on mount, WHICH close
|
|
6
|
+
* happened, the exit animation gap, and the write.
|
|
7
|
+
*/
|
|
8
|
+
export declare function GridSelectEditor<Row>({ column, values, current, optionColors, onCommit, onCancel, }: {
|
|
9
|
+
column: ListColumn<Row>;
|
|
10
|
+
/** Option values in display order (declared first, then data-discovered). */
|
|
11
|
+
values: string[];
|
|
12
|
+
/** The cell's current value ("" when unset). */
|
|
13
|
+
current: string;
|
|
14
|
+
/** This column's per-user color overrides (select columns). */
|
|
15
|
+
optionColors?: Record<string, ListSelectColor>;
|
|
16
|
+
onCommit: (value: string) => void;
|
|
17
|
+
onCancel: () => void;
|
|
18
|
+
}): import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { useRef, useState } from "react";
|
|
4
|
+
import { useViews } from "../../provider/context.js";
|
|
5
|
+
import { SelectEditor, pickerOptionsFromField, } from "../../editors/SelectEditor.js";
|
|
6
|
+
import { resolveCategoryColor } from "@viewkitjs/fields/design/category-colors";
|
|
7
|
+
import { isOpenVocabulary } from "@viewkitjs/fields";
|
|
8
|
+
import { prettifyOptionValue } from "../../model/column-state.js";
|
|
9
|
+
import { offeredValues, useOpenValues } from "../../editors/open-values.js";
|
|
10
|
+
export function GridSelectEditor({ column, values, current, optionColors, onCommit, onCancel, }) {
|
|
11
|
+
const { Popover } = useViews().components;
|
|
12
|
+
const [open, setOpen] = useState(true);
|
|
13
|
+
const editorRef = useRef(null);
|
|
14
|
+
const anchorRef = useRef(null);
|
|
15
|
+
const closedRef = useRef(false);
|
|
16
|
+
const EXIT_MS = 160;
|
|
17
|
+
const close = (reason) => {
|
|
18
|
+
if (closedRef.current)
|
|
19
|
+
return;
|
|
20
|
+
closedRef.current = true;
|
|
21
|
+
const resolution = editorRef.current?.resolveClose(reason) ?? { kind: "noop" };
|
|
22
|
+
setOpen(false);
|
|
23
|
+
window.setTimeout(() => {
|
|
24
|
+
if (resolution.kind === "commit")
|
|
25
|
+
onCommit(resolution.payload);
|
|
26
|
+
else
|
|
27
|
+
onCancel();
|
|
28
|
+
}, EXIT_MS);
|
|
29
|
+
};
|
|
30
|
+
const known = useOpenValues(column.field);
|
|
31
|
+
const optionLabel = (value) => column.options?.find((o) => o.value === value)?.label ?? prettifyOptionValue(value);
|
|
32
|
+
const pickerOptions = column.field && (column.field.type === "select" || column.field.type === "status")
|
|
33
|
+
? pickerOptionsFromField(column.field, { optionColors, extraValues: offeredValues(column.field, known, values) })
|
|
34
|
+
: values.map((value) => column.type === "status"
|
|
35
|
+
? {
|
|
36
|
+
value,
|
|
37
|
+
label: optionLabel(value),
|
|
38
|
+
slot: column.options?.find((o) => o.value === value)?.slot ?? "muted",
|
|
39
|
+
}
|
|
40
|
+
: {
|
|
41
|
+
value,
|
|
42
|
+
label: optionLabel(value),
|
|
43
|
+
color: resolveCategoryColor(value, column.options, optionColors),
|
|
44
|
+
});
|
|
45
|
+
return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchorRef, "aria-hidden": true, className: "pointer-events-none absolute inset-0" }), _jsx(Popover, { open: open, onOpenChange: (next) => {
|
|
46
|
+
if (!next)
|
|
47
|
+
close("outside");
|
|
48
|
+
}, anchor: anchorRef, align: "start", sideOffset: 4, onEscape: () => close("escape"), onOutsidePress: () => close("outside"), initialFocus: false, panelData: { "data-slot": "vk-grid-editor" }, onPanelClick: (e) => e.stopPropagation(), chrome: "menu", className: "w-48 z-90", children: _jsx(SelectEditor, { ref: editorRef, options: pickerOptions, initial: current, creatable: !!column.field && isOpenVocabulary(column.field), onRequestClose: close }) })] }));
|
|
49
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { ListGroup } from "../../grouping/types.js";
|
|
3
|
+
import type { ListGroupSummaryPart } from "../../model/preferences.js";
|
|
4
|
+
import { type GridGroupSortOption } from "./GridGroupMenu.js";
|
|
5
|
+
import type { GridSortState } from "./GridColumnMenu.js";
|
|
6
|
+
import type { GridScrollSurface, useGridScrollSync } from "./useGridScrollSync.js";
|
|
7
|
+
import type { GridGroupFigure, GroupCountNoun } from "./grid-table-props.js";
|
|
8
|
+
type ScrollSync = ReturnType<typeof useGridScrollSync>;
|
|
9
|
+
export declare function GridBody<Row>({ empty, emptyState, grouped, groups, rows, isMobile, selectable, selecting, allSelected, someSelected, selectAll, clearSelection, isCollapsed, countOf, sort, sortOptions, groupSummary, onToggleGroup, onGroupSummaryChange, renderGroupLabel, onHideGroup, figures, countNoun, renderHeader, renderGroupCheckbox, renderRow, renderFooter, minWidth, surface, headerWheelRef, headerPanHandlers, }: {
|
|
10
|
+
empty: boolean;
|
|
11
|
+
emptyState?: ReactNode;
|
|
12
|
+
grouped: boolean;
|
|
13
|
+
groups: ListGroup<Row>[];
|
|
14
|
+
rows: Row[];
|
|
15
|
+
isMobile: boolean;
|
|
16
|
+
selectable: boolean;
|
|
17
|
+
selecting: boolean;
|
|
18
|
+
allSelected: boolean;
|
|
19
|
+
someSelected: boolean;
|
|
20
|
+
selectAll: () => void;
|
|
21
|
+
clearSelection: () => void;
|
|
22
|
+
isCollapsed?: (key: string) => boolean;
|
|
23
|
+
countOf?: (group: ListGroup<Row>) => number;
|
|
24
|
+
sort?: GridSortState;
|
|
25
|
+
sortOptions?: GridGroupSortOption[];
|
|
26
|
+
groupSummary?: ListGroupSummaryPart[];
|
|
27
|
+
onToggleGroup?: (key: string) => void;
|
|
28
|
+
onGroupSummaryChange?: (part: ListGroupSummaryPart, next: boolean) => void;
|
|
29
|
+
renderGroupLabel?: (group: ListGroup<Row>) => ReactNode;
|
|
30
|
+
onHideGroup?: (key: string) => void;
|
|
31
|
+
/** The figures the header can show, in the list's order. */
|
|
32
|
+
figures?: GridGroupFigure<Row>[];
|
|
33
|
+
/** The count's noun: "2 companies". None: a bare count. */
|
|
34
|
+
countNoun?: GroupCountNoun;
|
|
35
|
+
renderHeader: (inline: boolean, checkbox?: ReactNode) => ReactNode;
|
|
36
|
+
renderGroupCheckbox: (items: Row[]) => ReactNode;
|
|
37
|
+
/** Receives map's full triple: the row needs its INDEX and the sibling
|
|
38
|
+
* list to know whether the row above it is selected (see `selectedAbove`). */
|
|
39
|
+
/** The group key rides along: a row drawn under two groups is two rows on
|
|
40
|
+
* screen, and each needs its own identity. See `gridRowKey`. */
|
|
41
|
+
renderRow: (row: Row, index: number, items: Row[], groupKey: string) => ReactNode;
|
|
42
|
+
renderFooter: (group: ListGroup<Row>) => ReactNode;
|
|
43
|
+
minWidth: string;
|
|
44
|
+
surface: GridScrollSurface;
|
|
45
|
+
headerWheelRef: ScrollSync["headerWheelRef"];
|
|
46
|
+
headerPanHandlers: ScrollSync["headerPanHandlers"];
|
|
47
|
+
}): import("react/jsx-runtime").JSX.Element | import("react/jsx-runtime").JSX.Element[];
|
|
48
|
+
export {};
|