@underpin/ui 2.0.0 → 2.1.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/components/bulk-action-bar.d.ts +21 -0
- package/components/bulk-action-bar.js +38 -0
- package/components/bulk-action-bar.js.map +1 -0
- package/components/button-group.d.ts +11 -7
- package/components/button-group.js +13 -8
- package/components/button-group.js.map +1 -1
- package/components/button.d.ts +1 -1
- package/components/button.js +29 -12
- package/components/button.js.map +1 -1
- package/components/data-table.d.ts +120 -0
- package/components/data-table.js +336 -0
- package/components/data-table.js.map +1 -0
- package/components/pagination.d.ts +65 -7
- package/components/pagination.js +186 -37
- package/components/pagination.js.map +1 -1
- package/components/table-toolbar.d.ts +55 -0
- package/components/table-toolbar.js +119 -0
- package/components/table-toolbar.js.map +1 -0
- package/components/table.d.ts +276 -0
- package/components/table.js +572 -0
- package/components/table.js.map +1 -0
- package/components/tabs.d.ts +21 -3
- package/components/tabs.js +63 -8
- package/components/tabs.js.map +1 -1
- package/lib/data-table-state.d.ts +87 -0
- package/lib/data-table-state.js +92 -0
- package/lib/data-table-state.js.map +1 -0
- package/lib/icons.d.ts +6 -0
- package/lib/icons.js +8 -2
- package/lib/icons.js.map +1 -1
- package/lib/load-more.d.ts +14 -0
- package/lib/load-more.js +27 -0
- package/lib/load-more.js.map +1 -0
- package/package.json +13 -1
- package/styles.css +11 -0
|
@@ -0,0 +1,336 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { DATA_TABLE_FEATURES, changeDataTableState, clampPage, formatRowSetKey, getPageCount, readColumnVisibility, writeColumnVisibility } from "../lib/data-table-state.js";
|
|
3
|
+
import { ChevronDownIcon } from "../lib/icons.js";
|
|
4
|
+
import { cn } from "../lib/variants.js";
|
|
5
|
+
import { BulkActionBar } from "./bulk-action-bar.js";
|
|
6
|
+
import { Button } from "./button.js";
|
|
7
|
+
import { Menu, MenuCheckboxItem, MenuContent, MenuTrigger } from "./menu.js";
|
|
8
|
+
import { Pagination, PaginationInfinite } from "./pagination.js";
|
|
9
|
+
import { Table, TableBody, TableCheckboxCell, TableColumnScope, TableHead, TableHeader, TableRow, TableRowLink, TableSkeletonRow } from "./table.js";
|
|
10
|
+
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
11
|
+
import { createContext, use, useEffect, useMemo, useRef, useState } from "react";
|
|
12
|
+
import { FlexRender, functionalUpdate, useTable } from "@tanstack/react-table";
|
|
13
|
+
// src/components/data-table.tsx
|
|
14
|
+
/** The id of the checkbox column a table with selection opens with. */
|
|
15
|
+
const SELECT_COLUMN_ID = "select";
|
|
16
|
+
/** Skeleton rows on a first load, and at the end of the list while the next batch loads. */
|
|
17
|
+
const FIRST_LOAD_ROWS = 5;
|
|
18
|
+
const MORE_ROWS = 3;
|
|
19
|
+
const DATA_TABLE_LABELS = {
|
|
20
|
+
selectAll: "Select all",
|
|
21
|
+
selectRow: (name) => `Select ${name}`,
|
|
22
|
+
columns: "Columns",
|
|
23
|
+
rowCount: (count) => `${count} rows`,
|
|
24
|
+
selected: (count) => `${count} selected`,
|
|
25
|
+
selection: "Selection",
|
|
26
|
+
clearSelection: "Clear selection",
|
|
27
|
+
loadingMore: "Loading more…",
|
|
28
|
+
endOfList: "End of list"
|
|
29
|
+
};
|
|
30
|
+
const SelectionContext = createContext({
|
|
31
|
+
labels: DATA_TABLE_LABELS,
|
|
32
|
+
setRange: () => {},
|
|
33
|
+
isRange: () => false
|
|
34
|
+
});
|
|
35
|
+
const RowLinkContext = createContext({});
|
|
36
|
+
/**
|
|
37
|
+
* The record's name, inside a `DataTable` column's cell: a link over the whole row when the
|
|
38
|
+
* table has `getRowHref`, plain text when it has none or the row returns none.
|
|
39
|
+
*/
|
|
40
|
+
function DataTableRowLink({ className, children }) {
|
|
41
|
+
const { href, render } = use(RowLinkContext);
|
|
42
|
+
if (!href) return /* @__PURE__ */ jsx("span", {
|
|
43
|
+
className: cn("truncate", className),
|
|
44
|
+
children
|
|
45
|
+
});
|
|
46
|
+
return /* @__PURE__ */ jsx(TableRowLink, {
|
|
47
|
+
href,
|
|
48
|
+
render,
|
|
49
|
+
className,
|
|
50
|
+
children
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
function getMeta(column) {
|
|
54
|
+
return column.columnDef.meta ?? {};
|
|
55
|
+
}
|
|
56
|
+
/** The order a sortable column's head announces. */
|
|
57
|
+
function getSortOrder(sorted) {
|
|
58
|
+
if (!sorted) return "none";
|
|
59
|
+
return sorted === "asc" ? "ascending" : "descending";
|
|
60
|
+
}
|
|
61
|
+
/** The column's name in the picker: its `label`, or its header when that is a string. */
|
|
62
|
+
function formatColumnLabel(column) {
|
|
63
|
+
const { header } = column.columnDef;
|
|
64
|
+
return getMeta(column).label ?? (typeof header === "string" ? header : column.id);
|
|
65
|
+
}
|
|
66
|
+
function DataTableHead({ header }) {
|
|
67
|
+
const { column } = header;
|
|
68
|
+
const { align, priority, sortable } = getMeta(column);
|
|
69
|
+
const sorted = column.getIsSorted();
|
|
70
|
+
function onSort() {
|
|
71
|
+
column.toggleSorting(sorted ? sorted === "asc" : sortable === "descending");
|
|
72
|
+
}
|
|
73
|
+
if (column.id === SELECT_COLUMN_ID) return /* @__PURE__ */ jsx(FlexRender, { header });
|
|
74
|
+
return /* @__PURE__ */ jsx(TableHead, {
|
|
75
|
+
align,
|
|
76
|
+
priority,
|
|
77
|
+
sort: sortable ? getSortOrder(sorted) : void 0,
|
|
78
|
+
onSort: sortable ? onSort : void 0,
|
|
79
|
+
children: /* @__PURE__ */ jsx(FlexRender, { header })
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
function SelectHead({ table }) {
|
|
83
|
+
const { labels } = use(SelectionContext);
|
|
84
|
+
return /* @__PURE__ */ jsx(TableCheckboxCell, {
|
|
85
|
+
header: true,
|
|
86
|
+
label: labels.selectAll,
|
|
87
|
+
checked: table.getIsAllPageRowsSelected(),
|
|
88
|
+
indeterminate: table.getIsSomePageRowsSelected(),
|
|
89
|
+
onCheckedChange: (checked) => table.toggleAllPageRowsSelected(checked)
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
function SelectCell({ row }) {
|
|
93
|
+
const { labels, getRowLabel, setRange, isRange } = use(SelectionContext);
|
|
94
|
+
return /* @__PURE__ */ jsx(TableCheckboxCell, {
|
|
95
|
+
label: labels.selectRow(getRowLabel?.(row.original) ?? row.id),
|
|
96
|
+
checked: row.getIsSelected(),
|
|
97
|
+
disabled: !row.getCanSelect(),
|
|
98
|
+
onClickCapture: (event) => setRange(event.shiftKey),
|
|
99
|
+
onKeyDownCapture: (event) => setRange(event.shiftKey),
|
|
100
|
+
onCheckedChange: (checked) => row.getToggleSelectedHandler()({
|
|
101
|
+
target: { checked },
|
|
102
|
+
shiftKey: isRange()
|
|
103
|
+
})
|
|
104
|
+
});
|
|
105
|
+
}
|
|
106
|
+
function DataTableCell({ cell }) {
|
|
107
|
+
const { align, priority } = getMeta(cell.column);
|
|
108
|
+
return /* @__PURE__ */ jsx(TableColumnScope, {
|
|
109
|
+
align,
|
|
110
|
+
priority,
|
|
111
|
+
children: /* @__PURE__ */ jsx(FlexRender, { cell })
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
function DataTableRow({ row, size, inactive, href, render }) {
|
|
115
|
+
const link = useMemo(() => ({
|
|
116
|
+
href,
|
|
117
|
+
render
|
|
118
|
+
}), [href, render]);
|
|
119
|
+
return /* @__PURE__ */ jsx(RowLinkContext, {
|
|
120
|
+
value: link,
|
|
121
|
+
children: /* @__PURE__ */ jsx(TableRow, {
|
|
122
|
+
size,
|
|
123
|
+
selected: row.getIsSelected(),
|
|
124
|
+
inactive,
|
|
125
|
+
children: row.getVisibleCells().map((cell) => /* @__PURE__ */ jsx(DataTableCell, { cell }, cell.id))
|
|
126
|
+
})
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* A table drawn from react-table column definitions: the app writes columns, the wrapper draws
|
|
131
|
+
* the head, the rows, the footer band, the checkbox column and the bulk action bar. Its state
|
|
132
|
+
* (page, page size, sort, search, filters) is controlled and never read from the URL, so each
|
|
133
|
+
* app keeps it in its own router. The server sorts, filters and pages: `data` is the rows to
|
|
134
|
+
* show, in order. Paging follows one set of rules: the page is 1-based, a page past the end
|
|
135
|
+
* shows the last one, a change of sort, search, filter or page size goes back to page 1, and
|
|
136
|
+
* the old rows stay dimmed while the next ones load.
|
|
137
|
+
*/
|
|
138
|
+
function DataTable({ columns, data, getRowId, getRowLabel, "aria-label": ariaLabel, state, onStateChange, pagination, loading = false, message, getRowHref, renderRowLink, isRowInactive, enableRowSelection, bulkActions, storageKey, toolbar, size = "default", format = String, labels: labelsProp, variant, layout, className, containerClassName }) {
|
|
139
|
+
const labels = {
|
|
140
|
+
...DATA_TABLE_LABELS,
|
|
141
|
+
...labelsProp
|
|
142
|
+
};
|
|
143
|
+
const tableRef = useRef(null);
|
|
144
|
+
const rangeRef = useRef(false);
|
|
145
|
+
const [rowSelection, setRowSelection] = useState({});
|
|
146
|
+
const [columnVisibility, setColumnVisibility] = useState({});
|
|
147
|
+
const rowSetKey = formatRowSetKey(state);
|
|
148
|
+
const [selectionKey, setSelectionKey] = useState(rowSetKey);
|
|
149
|
+
const selectable = Boolean(enableRowSelection);
|
|
150
|
+
useEffect(() => {
|
|
151
|
+
if (storageKey) setColumnVisibility(readColumnVisibility(storageKey));
|
|
152
|
+
}, [storageKey]);
|
|
153
|
+
const sorting = state.sort ? [state.sort] : [];
|
|
154
|
+
function setState(change) {
|
|
155
|
+
onStateChange(changeDataTableState(state, change), { replace: false });
|
|
156
|
+
}
|
|
157
|
+
function onSortingChange(updater) {
|
|
158
|
+
const [sort] = functionalUpdate(updater, sorting);
|
|
159
|
+
setState({ sort });
|
|
160
|
+
}
|
|
161
|
+
function onColumnVisibilityChange(updater) {
|
|
162
|
+
const next = functionalUpdate(updater, columnVisibility);
|
|
163
|
+
setColumnVisibility(next);
|
|
164
|
+
if (storageKey) writeColumnVisibility(storageKey, next);
|
|
165
|
+
}
|
|
166
|
+
const allColumns = useMemo(() => {
|
|
167
|
+
if (!selectable) return columns;
|
|
168
|
+
return [{
|
|
169
|
+
id: SELECT_COLUMN_ID,
|
|
170
|
+
enableHiding: false,
|
|
171
|
+
enableSorting: false,
|
|
172
|
+
meta: {
|
|
173
|
+
width: "2.25rem",
|
|
174
|
+
skeleton: false
|
|
175
|
+
},
|
|
176
|
+
header: ({ table }) => /* @__PURE__ */ jsx(SelectHead, { table }),
|
|
177
|
+
cell: ({ row }) => /* @__PURE__ */ jsx(SelectCell, { row })
|
|
178
|
+
}, ...columns];
|
|
179
|
+
}, [columns, selectable]);
|
|
180
|
+
const table = useTable({
|
|
181
|
+
features: DATA_TABLE_FEATURES,
|
|
182
|
+
columns: allColumns,
|
|
183
|
+
data,
|
|
184
|
+
getRowId,
|
|
185
|
+
state: {
|
|
186
|
+
sorting,
|
|
187
|
+
rowSelection,
|
|
188
|
+
columnVisibility
|
|
189
|
+
},
|
|
190
|
+
onSortingChange,
|
|
191
|
+
onRowSelectionChange: setRowSelection,
|
|
192
|
+
onColumnVisibilityChange,
|
|
193
|
+
manualSorting: true,
|
|
194
|
+
enableSortingRemoval: false,
|
|
195
|
+
enableMultiSort: false,
|
|
196
|
+
enableRowSelection: typeof enableRowSelection === "function" ? (row) => enableRowSelection(row.original) : selectable
|
|
197
|
+
});
|
|
198
|
+
if (selectionKey !== rowSetKey) {
|
|
199
|
+
setSelectionKey(rowSetKey);
|
|
200
|
+
table.resetRowSelection(true);
|
|
201
|
+
}
|
|
202
|
+
function clearSelection() {
|
|
203
|
+
table.resetRowSelection(true);
|
|
204
|
+
}
|
|
205
|
+
const selection = {
|
|
206
|
+
labels,
|
|
207
|
+
getRowLabel,
|
|
208
|
+
setRange: (range) => {
|
|
209
|
+
rangeRef.current = range;
|
|
210
|
+
},
|
|
211
|
+
isRange: () => rangeRef.current
|
|
212
|
+
};
|
|
213
|
+
const tableColumns = table.getVisibleLeafColumns().map((column) => {
|
|
214
|
+
const meta = getMeta(column);
|
|
215
|
+
return {
|
|
216
|
+
width: meta.width ?? "minmax(0,1fr)",
|
|
217
|
+
priority: meta.priority,
|
|
218
|
+
align: meta.align,
|
|
219
|
+
skeleton: meta.skeleton
|
|
220
|
+
};
|
|
221
|
+
});
|
|
222
|
+
const headers = table.getHeaderGroups().at(-1)?.headers ?? [];
|
|
223
|
+
const { rows } = table.getRowModel();
|
|
224
|
+
const selectedRows = table.getSelectedRowModel().rows.map((row) => row.original);
|
|
225
|
+
const paged = pagination?.type === "pages" ? pagination : void 0;
|
|
226
|
+
const infinite = pagination?.type === "infinite" ? pagination : void 0;
|
|
227
|
+
const perPage = state.perPage ?? 25;
|
|
228
|
+
const pageCount = paged ? getPageCount(paged.total, perPage) : 1;
|
|
229
|
+
const page = clampPage(state.page ?? 1, pageCount);
|
|
230
|
+
const pastEnd = paged !== void 0 && !loading && (state.page ?? 1) !== page;
|
|
231
|
+
useEffect(() => {
|
|
232
|
+
if (pastEnd) onStateChange({
|
|
233
|
+
...state,
|
|
234
|
+
page
|
|
235
|
+
}, { replace: true });
|
|
236
|
+
}, [pastEnd, page]);
|
|
237
|
+
function onPageChange(next) {
|
|
238
|
+
setState({ page: next });
|
|
239
|
+
const element = tableRef.current;
|
|
240
|
+
if (element && element.getBoundingClientRect().top < 0) element.scrollIntoView({ block: "start" });
|
|
241
|
+
}
|
|
242
|
+
const hideable = table.getAllLeafColumns().filter((column) => column.getCanHide());
|
|
243
|
+
const columnPicker = hideable.length > 0 && /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
|
|
244
|
+
render: /* @__PURE__ */ jsx(Button, {
|
|
245
|
+
variant: "secondary",
|
|
246
|
+
suffix: /* @__PURE__ */ jsx(ChevronDownIcon, {})
|
|
247
|
+
}),
|
|
248
|
+
children: labels.columns
|
|
249
|
+
}), /* @__PURE__ */ jsx(MenuContent, {
|
|
250
|
+
label: labels.columns,
|
|
251
|
+
align: "end",
|
|
252
|
+
children: hideable.map((column) => /* @__PURE__ */ jsx(MenuCheckboxItem, {
|
|
253
|
+
checked: column.getIsVisible(),
|
|
254
|
+
closeOnClick: false,
|
|
255
|
+
onCheckedChange: (checked) => column.toggleVisibility(checked),
|
|
256
|
+
children: formatColumnLabel(column)
|
|
257
|
+
}, column.id))
|
|
258
|
+
})] });
|
|
259
|
+
const firstLoad = loading && rows.length === 0;
|
|
260
|
+
const dimmed = loading && rows.length > 0;
|
|
261
|
+
const loadingMore = infinite?.isLoadingMore === true && rows.length > 0;
|
|
262
|
+
const footer = paged ? /* @__PURE__ */ jsx(Pagination, {
|
|
263
|
+
page,
|
|
264
|
+
pageCount,
|
|
265
|
+
total: paged.total,
|
|
266
|
+
perPage,
|
|
267
|
+
perPageOptions: paged.perPageOptions,
|
|
268
|
+
loading,
|
|
269
|
+
format,
|
|
270
|
+
labels: labels.pagination,
|
|
271
|
+
onPageChange,
|
|
272
|
+
onPerPageChange: (next) => setState({ perPage: next })
|
|
273
|
+
}) : infinite && rows.length > 0 ? /* @__PURE__ */ jsx(PaginationInfinite, {
|
|
274
|
+
count: infinite.count ?? labels.rowCount(format(rows.length)),
|
|
275
|
+
hasMore: infinite.hasMore,
|
|
276
|
+
loading: infinite.isLoadingMore,
|
|
277
|
+
enabled: infinite.enabled,
|
|
278
|
+
loadingLabel: labels.loadingMore,
|
|
279
|
+
endLabel: labels.endOfList,
|
|
280
|
+
onLoadMore: infinite.onLoadMore
|
|
281
|
+
}) : void 0;
|
|
282
|
+
const tableElement = /* @__PURE__ */ jsx(SelectionContext, {
|
|
283
|
+
value: selection,
|
|
284
|
+
children: /* @__PURE__ */ jsxs(Table, {
|
|
285
|
+
ref: tableRef,
|
|
286
|
+
"aria-label": ariaLabel,
|
|
287
|
+
"aria-busy": loading || loadingMore || void 0,
|
|
288
|
+
columns: tableColumns,
|
|
289
|
+
variant,
|
|
290
|
+
layout,
|
|
291
|
+
footer,
|
|
292
|
+
className,
|
|
293
|
+
containerClassName,
|
|
294
|
+
children: [/* @__PURE__ */ jsx(TableHeader, { children: headers.map((header) => /* @__PURE__ */ jsx(DataTableHead, { header }, header.id)) }), /* @__PURE__ */ jsxs(TableBody, {
|
|
295
|
+
className: cn("transition-opacity", dimmed && "opacity-50"),
|
|
296
|
+
children: [firstLoad ? Array.from({ length: FIRST_LOAD_ROWS }, (_, index) => /* @__PURE__ */ jsx(TableSkeletonRow, {
|
|
297
|
+
size,
|
|
298
|
+
index
|
|
299
|
+
}, index)) : rows.length === 0 ? message : rows.map((row) => /* @__PURE__ */ jsx(DataTableRow, {
|
|
300
|
+
row,
|
|
301
|
+
size,
|
|
302
|
+
inactive: isRowInactive?.(row.original),
|
|
303
|
+
href: getRowHref?.(row.original),
|
|
304
|
+
render: renderRowLink
|
|
305
|
+
}, row.id)), loadingMore && Array.from({ length: MORE_ROWS }, (_, index) => /* @__PURE__ */ jsx(TableSkeletonRow, {
|
|
306
|
+
size,
|
|
307
|
+
index: rows.length + index
|
|
308
|
+
}, index))]
|
|
309
|
+
})]
|
|
310
|
+
})
|
|
311
|
+
});
|
|
312
|
+
const bar = bulkActions && /* @__PURE__ */ jsx(BulkActionBar, {
|
|
313
|
+
count: selectedRows.length,
|
|
314
|
+
label: labels.selected(format(selectedRows.length)),
|
|
315
|
+
"aria-label": labels.selection,
|
|
316
|
+
clearLabel: labels.clearSelection,
|
|
317
|
+
onClear: clearSelection,
|
|
318
|
+
children: bulkActions(selectedRows, clearSelection)
|
|
319
|
+
});
|
|
320
|
+
if (!toolbar) return /* @__PURE__ */ jsxs(Fragment, { children: [tableElement, bar] });
|
|
321
|
+
return /* @__PURE__ */ jsxs("div", {
|
|
322
|
+
className: "flex flex-col gap-3",
|
|
323
|
+
children: [
|
|
324
|
+
toolbar({
|
|
325
|
+
state,
|
|
326
|
+
setState,
|
|
327
|
+
columnPicker
|
|
328
|
+
}),
|
|
329
|
+
tableElement,
|
|
330
|
+
bar
|
|
331
|
+
]
|
|
332
|
+
});
|
|
333
|
+
}
|
|
334
|
+
export { DataTable, DataTableRowLink };
|
|
335
|
+
|
|
336
|
+
//# sourceMappingURL=data-table.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"data-table.js","names":[],"sources":["../../src/components/data-table.tsx"],"sourcesContent":["\"use client\"\n\nimport type { useRender } from \"@base-ui/react/use-render\"\nimport {\n type Cell,\n type Column,\n type ColumnDef,\n type ColumnVisibilityState,\n FlexRender,\n functionalUpdate,\n type Header,\n type Row,\n type RowData,\n type RowSelectionState,\n type SortingState,\n type Table as ReactTable,\n type TableOptions,\n type Updater,\n useTable,\n} from \"@tanstack/react-table\"\nimport {\n createContext,\n type ReactNode,\n type MouseEvent as ReactMouseEvent,\n type KeyboardEvent as ReactKeyboardEvent,\n use,\n useEffect,\n useMemo,\n useRef,\n useState,\n} from \"react\"\nimport {\n changeDataTableState,\n clampPage,\n DATA_TABLE_FEATURES,\n type DataTableFeatures,\n type DataTableState,\n DEFAULT_PER_PAGE,\n formatRowSetKey,\n getPageCount,\n readColumnVisibility,\n writeColumnVisibility,\n} from \"../lib/data-table-state\"\nimport { ChevronDownIcon } from \"../lib/icons\"\nimport { cn } from \"../lib/variants\"\nimport { BulkActionBar } from \"./bulk-action-bar\"\nimport { Button } from \"./button\"\nimport { Menu, MenuCheckboxItem, MenuContent, MenuTrigger } from \"./menu\"\nimport { Pagination, PaginationInfinite, type PaginationLabels } from \"./pagination\"\nimport {\n Table,\n TableBody,\n TableCheckboxCell,\n type TableColumn,\n TableColumnScope,\n TableHead,\n TableHeader,\n type TableProps,\n TableRow,\n type TableRowProps,\n TableRowLink,\n TableSkeletonRow,\n} from \"./table\"\n\n/** The id of the checkbox column a table with selection opens with. */\nconst SELECT_COLUMN_ID = \"select\"\n\n/** Skeleton rows on a first load, and at the end of the list while the next batch loads. */\nconst FIRST_LOAD_ROWS = 5\nconst MORE_ROWS = 3\n\n/** The words of a `DataTable`, each a prop with an English default. */\nexport interface DataTableLabels {\n selectAll: string\n /** The checkbox of one row, named by `getRowLabel`. */\n selectRow: (name: string) => string\n /** The column picker's button. */\n columns: string\n /** The count of an infinite table's band, from the formatted number of loaded rows. */\n rowCount: (count: string) => ReactNode\n /** The bulk action bar's count, from the formatted number of selected rows. */\n selected: (count: string) => ReactNode\n /** Names the bulk action bar for a screen reader. */\n selection: string\n clearSelection: string\n loadingMore: ReactNode\n endOfList: ReactNode\n /** The paged band's words. */\n pagination?: Partial<PaginationLabels>\n}\n\nconst DATA_TABLE_LABELS: DataTableLabels = {\n selectAll: \"Select all\",\n selectRow: name => `Select ${name}`,\n columns: \"Columns\",\n rowCount: count => `${count} rows`,\n selected: count => `${count} selected`,\n selection: \"Selection\",\n clearSelection: \"Clear selection\",\n loadingMore: \"Loading more…\",\n endOfList: \"End of list\",\n}\n\n/** The footer of a table whose rows come a page at a time. Page and page size live in `state`. */\ninterface DataTablePages {\n type: \"pages\"\n /** Every row the query matches, across all pages. */\n total: number\n /** The page sizes the reader picks from. Left out, the band has no per-page select. */\n perPageOptions?: number[]\n}\n\n/** The footer of a table that loads the next batch as its end scrolls into view. */\ninterface DataTableInfinite {\n type: \"infinite\"\n hasMore: boolean\n isLoadingMore: boolean\n /** Asks for the next batch. Pass a stable callback. */\n onLoadMore: () => void\n /** False after a failed batch, so the band does not ask for it again at once. */\n enabled?: boolean\n /** The count at the start of the band. Left out, it is the number of loaded rows. */\n count?: ReactNode\n}\n\nexport type DataTablePagination = DataTablePages | DataTableInfinite\n\nexport interface DataTableChangeOptions {\n /**\n * True when the table corrects the state itself (a page past the end), so a router adapter\n * replaces the history entry rather than adding one the reader would land back on.\n */\n replace: boolean\n}\n\n/** What the toolbar render prop receives. */\nexport interface DataTableToolbarContext {\n state: DataTableState\n /** Changes part of the state under the paging rules: a new search or filter goes to page 1. */\n setState: (change: Partial<DataTableState>) => void\n /** A menu that shows and hides the columns that allow it, for the toolbar's `end`. */\n columnPicker: ReactNode\n}\n\nexport interface DataTableProps<TData extends RowData> extends Pick<\n TableProps,\n \"variant\" | \"layout\" | \"className\" | \"containerClassName\"\n> {\n /** Built with `createDataTableColumnHelper`. Keep the array stable between renders. */\n columns: TableOptions<DataTableFeatures, TData>[\"columns\"]\n /** The rows to show: this page's, or every batch loaded so far. Keep it stable too. */\n data: TData[]\n /** A stable id per row, which a selection is kept by. */\n getRowId: (row: TData) => string\n /** Names a row for a screen reader: its checkbox reads \"Select <name>\". Defaults to its id. */\n getRowLabel?: (row: TData) => string\n \"aria-label\": string\n state: DataTableState\n onStateChange: (state: DataTableState, options: DataTableChangeOptions) => void\n pagination?: DataTablePagination\n /**\n * A request is in flight. With no rows yet the table shows skeleton rows; with rows, it keeps\n * them and dims them until the new ones land.\n */\n loading?: boolean\n /** Stands in for the rows when there are none: a `TableMessage` (empty, filtered, error). */\n message?: ReactNode\n /** The row's link. A row with one opens from anywhere on it, through `DataTableRowLink`. */\n getRowHref?: (row: TData) => string | undefined\n /** Renders the row link through a router's link component; it receives the `href`. */\n renderRowLink?: useRender.ComponentProps<\"a\">[\"render\"]\n /** Fades a row whose record is archived or blocked, all but its menu and checkbox. */\n isRowInactive?: (row: TData) => boolean\n /** Adds a checkbox column. A function disables the box of each row it returns false for. */\n enableRowSelection?: boolean | ((row: TData) => boolean)\n /** The bulk action bar's buttons for the selected rows, shown while any are selected. */\n bulkActions?: (rows: TData[], clear: () => void) => ReactNode\n /** Saves the columns the reader hides, per table, in `localStorage`. */\n storageKey?: string\n /** The row above the table: a `TableToolbar`. */\n toolbar?: (context: DataTableToolbarContext) => ReactNode\n size?: TableRowProps[\"size\"]\n /** Formats each figure in the reader's locale. */\n format?: (value: number) => string\n labels?: Partial<DataTableLabels>\n}\n\ninterface SelectionValue {\n labels: Pick<DataTableLabels, \"selectAll\" | \"selectRow\">\n /** The table's `getRowLabel`, which a checkbox calls with its own row's record. */\n getRowLabel?: (row: unknown) => string\n /** Notes whether Shift was held on a checkbox press, which turns the click into a range. */\n setRange: (range: boolean) => void\n isRange: () => boolean\n}\n\nconst SelectionContext = createContext<SelectionValue>({\n labels: DATA_TABLE_LABELS,\n setRange: () => {},\n isRange: () => false,\n})\n\ninterface RowLinkValue {\n href?: string\n render?: useRender.ComponentProps<\"a\">[\"render\"]\n}\n\nconst RowLinkContext = createContext<RowLinkValue>({})\n\ninterface DataTableRowLinkProps {\n className?: string\n children: ReactNode\n}\n\n/**\n * The record's name, inside a `DataTable` column's cell: a link over the whole row when the\n * table has `getRowHref`, plain text when it has none or the row returns none.\n */\nexport function DataTableRowLink({ className, children }: DataTableRowLinkProps) {\n const { href, render } = use(RowLinkContext)\n\n if (!href) return <span className={cn(\"truncate\", className)}>{children}</span>\n\n return (\n <TableRowLink href={href} render={render} className={className}>\n {children}\n </TableRowLink>\n )\n}\n\nfunction getMeta<TData extends RowData>(column: {\n columnDef: ColumnDef<DataTableFeatures, TData, unknown>\n}) {\n return column.columnDef.meta ?? {}\n}\n\n/** The order a sortable column's head announces. */\nfunction getSortOrder(sorted: false | \"asc\" | \"desc\") {\n if (!sorted) return \"none\"\n return sorted === \"asc\" ? \"ascending\" : \"descending\"\n}\n\n/** The column's name in the picker: its `label`, or its header when that is a string. */\nfunction formatColumnLabel<TData extends RowData>(\n column: Column<DataTableFeatures, TData, unknown>,\n) {\n const { header } = column.columnDef\n return getMeta(column).label ?? (typeof header === \"string\" ? header : column.id)\n}\n\ninterface HeadProps<TData extends RowData> {\n header: Header<DataTableFeatures, TData, unknown>\n}\n\nfunction DataTableHead<TData extends RowData>({ header }: HeadProps<TData>) {\n const { column } = header\n const { align, priority, sortable } = getMeta(column)\n const sorted = column.getIsSorted()\n\n // A second click flips the order; the first takes the column's own first direction.\n function onSort() {\n column.toggleSorting(sorted ? sorted === \"asc\" : sortable === \"descending\")\n }\n\n // The checkbox column draws its own head, the select-all box.\n if (column.id === SELECT_COLUMN_ID) return <FlexRender header={header} />\n\n return (\n <TableHead\n align={align}\n priority={priority}\n sort={sortable ? getSortOrder(sorted) : undefined}\n onSort={sortable ? onSort : undefined}\n >\n <FlexRender header={header} />\n </TableHead>\n )\n}\n\ninterface SelectHeadProps<TData extends RowData> {\n table: ReactTable<DataTableFeatures, TData>\n}\n\nfunction SelectHead<TData extends RowData>({ table }: SelectHeadProps<TData>) {\n const { labels } = use(SelectionContext)\n\n return (\n <TableCheckboxCell\n header\n label={labels.selectAll}\n checked={table.getIsAllPageRowsSelected()}\n indeterminate={table.getIsSomePageRowsSelected()}\n onCheckedChange={checked => table.toggleAllPageRowsSelected(checked)}\n />\n )\n}\n\ninterface SelectCellProps<TData extends RowData> {\n row: Row<DataTableFeatures, TData>\n}\n\nfunction SelectCell<TData extends RowData>({ row }: SelectCellProps<TData>) {\n const { labels, getRowLabel, setRange, isRange } = use(SelectionContext)\n\n return (\n <TableCheckboxCell\n label={labels.selectRow(getRowLabel?.(row.original) ?? row.id)}\n checked={row.getIsSelected()}\n disabled={!row.getCanSelect()}\n onClickCapture={(event: ReactMouseEvent) => setRange(event.shiftKey)}\n onKeyDownCapture={(event: ReactKeyboardEvent) => setRange(event.shiftKey)}\n onCheckedChange={checked =>\n row.getToggleSelectedHandler()({ target: { checked }, shiftKey: isRange() })\n }\n />\n )\n}\n\ninterface CellProps<TData extends RowData> {\n cell: Cell<DataTableFeatures, TData, unknown>\n}\n\nfunction DataTableCell<TData extends RowData>({ cell }: CellProps<TData>) {\n const { align, priority } = getMeta(cell.column)\n\n return (\n <TableColumnScope align={align} priority={priority}>\n <FlexRender cell={cell} />\n </TableColumnScope>\n )\n}\n\ninterface DataTableRowProps<TData extends RowData> {\n row: Row<DataTableFeatures, TData>\n size: TableRowProps[\"size\"]\n inactive?: boolean\n href?: string\n render?: useRender.ComponentProps<\"a\">[\"render\"]\n}\n\nfunction DataTableRow<TData extends RowData>({\n row,\n size,\n inactive,\n href,\n render,\n}: DataTableRowProps<TData>) {\n const link = useMemo(() => ({ href, render }), [href, render])\n\n return (\n <RowLinkContext value={link}>\n <TableRow size={size} selected={row.getIsSelected()} inactive={inactive}>\n {row.getVisibleCells().map(cell => (\n <DataTableCell key={cell.id} cell={cell} />\n ))}\n </TableRow>\n </RowLinkContext>\n )\n}\n\n/**\n * A table drawn from react-table column definitions: the app writes columns, the wrapper draws\n * the head, the rows, the footer band, the checkbox column and the bulk action bar. Its state\n * (page, page size, sort, search, filters) is controlled and never read from the URL, so each\n * app keeps it in its own router. The server sorts, filters and pages: `data` is the rows to\n * show, in order. Paging follows one set of rules: the page is 1-based, a page past the end\n * shows the last one, a change of sort, search, filter or page size goes back to page 1, and\n * the old rows stay dimmed while the next ones load.\n */\nexport function DataTable<TData extends RowData>({\n columns,\n data,\n getRowId,\n getRowLabel,\n \"aria-label\": ariaLabel,\n state,\n onStateChange,\n pagination,\n loading = false,\n message,\n getRowHref,\n renderRowLink,\n isRowInactive,\n enableRowSelection,\n bulkActions,\n storageKey,\n toolbar,\n size = \"default\",\n format = String,\n labels: labelsProp,\n variant,\n layout,\n className,\n containerClassName,\n}: DataTableProps<TData>) {\n const labels = { ...DATA_TABLE_LABELS, ...labelsProp }\n const tableRef = useRef<HTMLTableElement>(null)\n const rangeRef = useRef(false)\n\n const [rowSelection, setRowSelection] = useState<RowSelectionState>({})\n const [columnVisibility, setColumnVisibility] = useState<ColumnVisibilityState>({})\n\n const rowSetKey = formatRowSetKey(state)\n const [selectionKey, setSelectionKey] = useState(rowSetKey)\n const selectable = Boolean(enableRowSelection)\n\n // Read after mounting, so a server render and the first client render agree: storage is\n // outside React, and a server has none.\n useEffect(() => {\n // oxlint-disable-next-line react/set-state-in-effect\n if (storageKey) setColumnVisibility(readColumnVisibility(storageKey))\n }, [storageKey])\n\n const sorting: SortingState = state.sort ? [state.sort] : []\n\n function setState(change: Partial<DataTableState>) {\n onStateChange(changeDataTableState(state, change), { replace: false })\n }\n\n function onSortingChange(updater: Updater<SortingState>) {\n const [sort] = functionalUpdate(updater, sorting)\n setState({ sort })\n }\n\n function onColumnVisibilityChange(updater: Updater<ColumnVisibilityState>) {\n const next = functionalUpdate(updater, columnVisibility)\n setColumnVisibility(next)\n if (storageKey) writeColumnVisibility(storageKey, next)\n }\n\n // Keyed on whether rows select, not on the callback, which a caller often writes inline.\n const allColumns = useMemo(() => {\n if (!selectable) return columns\n\n const select: ColumnDef<DataTableFeatures, TData, unknown> = {\n id: SELECT_COLUMN_ID,\n enableHiding: false,\n enableSorting: false,\n meta: { width: \"2.25rem\", skeleton: false },\n header: ({ table }) => <SelectHead table={table} />,\n cell: ({ row }) => <SelectCell row={row} />,\n }\n return [select, ...columns]\n }, [columns, selectable])\n\n const table = useTable({\n features: DATA_TABLE_FEATURES,\n columns: allColumns,\n data,\n getRowId,\n state: { sorting, rowSelection, columnVisibility },\n onSortingChange,\n onRowSelectionChange: setRowSelection,\n onColumnVisibilityChange,\n manualSorting: true,\n enableSortingRemoval: false,\n enableMultiSort: false,\n enableRowSelection:\n typeof enableRowSelection === \"function\"\n ? row => enableRowSelection(row.original)\n : selectable,\n })\n\n // A selection covers the rows on screen: a new page, sort, search or filter clears it, and\n // the Shift range starts over with it.\n if (selectionKey !== rowSetKey) {\n setSelectionKey(rowSetKey)\n table.resetRowSelection(true)\n }\n\n function clearSelection() {\n table.resetRowSelection(true)\n }\n\n const selection: SelectionValue = {\n labels,\n // Every row the context reaches is a `TData`, which is what `getRowLabel` takes.\n getRowLabel: getRowLabel as SelectionValue[\"getRowLabel\"],\n setRange: range => {\n rangeRef.current = range\n },\n isRange: () => rangeRef.current,\n }\n\n const tableColumns: TableColumn[] = table.getVisibleLeafColumns().map(column => {\n const meta = getMeta(column)\n return {\n width: meta.width ?? \"minmax(0,1fr)\",\n priority: meta.priority,\n align: meta.align,\n skeleton: meta.skeleton,\n }\n })\n const headers = table.getHeaderGroups().at(-1)?.headers ?? []\n const { rows } = table.getRowModel()\n const selectedRows = table.getSelectedRowModel().rows.map(row => row.original)\n\n const paged = pagination?.type === \"pages\" ? pagination : undefined\n const infinite = pagination?.type === \"infinite\" ? pagination : undefined\n const perPage = state.perPage ?? DEFAULT_PER_PAGE\n const pageCount = paged ? getPageCount(paged.total, perPage) : 1\n const page = clampPage(state.page ?? 1, pageCount)\n\n // A page past the end (a stale link, rows deleted since) moves the state to the last page, so\n // the app asks for rows that exist.\n const pastEnd = paged !== undefined && !loading && (state.page ?? 1) !== page\n useEffect(() => {\n if (pastEnd) onStateChange({ ...state, page }, { replace: true })\n // Only a new clamp asks again: the app's state catching up ends it.\n // oxlint-disable-next-line react-hooks/exhaustive-deps\n }, [pastEnd, page])\n\n function onPageChange(next: number) {\n setState({ page: next })\n // The rows change under the reader: bring the table's top back when it has scrolled away.\n const element = tableRef.current\n if (element && element.getBoundingClientRect().top < 0) {\n element.scrollIntoView({ block: \"start\" })\n }\n }\n\n const hideable = table.getAllLeafColumns().filter(column => column.getCanHide())\n const columnPicker = hideable.length > 0 && (\n <Menu>\n <MenuTrigger render={<Button variant=\"secondary\" suffix={<ChevronDownIcon />} />}>\n {labels.columns}\n </MenuTrigger>\n <MenuContent label={labels.columns} align=\"end\">\n {hideable.map(column => (\n <MenuCheckboxItem\n key={column.id}\n checked={column.getIsVisible()}\n closeOnClick={false}\n onCheckedChange={checked => column.toggleVisibility(checked)}\n >\n {formatColumnLabel(column)}\n </MenuCheckboxItem>\n ))}\n </MenuContent>\n </Menu>\n )\n\n const firstLoad = loading && rows.length === 0\n const dimmed = loading && rows.length > 0\n const loadingMore = infinite?.isLoadingMore === true && rows.length > 0\n\n const footer = paged ? (\n <Pagination\n page={page}\n pageCount={pageCount}\n total={paged.total}\n perPage={perPage}\n perPageOptions={paged.perPageOptions}\n loading={loading}\n format={format}\n labels={labels.pagination}\n onPageChange={onPageChange}\n onPerPageChange={next => setState({ perPage: next })}\n />\n ) : infinite && rows.length > 0 ? (\n <PaginationInfinite\n count={infinite.count ?? labels.rowCount(format(rows.length))}\n hasMore={infinite.hasMore}\n loading={infinite.isLoadingMore}\n enabled={infinite.enabled}\n loadingLabel={labels.loadingMore}\n endLabel={labels.endOfList}\n onLoadMore={infinite.onLoadMore}\n />\n ) : undefined\n\n const tableElement = (\n <SelectionContext value={selection}>\n <Table\n ref={tableRef}\n aria-label={ariaLabel}\n aria-busy={loading || loadingMore || undefined}\n columns={tableColumns}\n variant={variant}\n layout={layout}\n footer={footer}\n className={className}\n containerClassName={containerClassName}\n >\n <TableHeader>\n {headers.map(header => (\n <DataTableHead key={header.id} header={header} />\n ))}\n </TableHeader>\n <TableBody className={cn(\"transition-opacity\", dimmed && \"opacity-50\")}>\n {firstLoad\n ? Array.from({ length: FIRST_LOAD_ROWS }, (_, index) => (\n <TableSkeletonRow key={index} size={size} index={index} />\n ))\n : rows.length === 0\n ? message\n : rows.map(row => (\n <DataTableRow\n key={row.id}\n row={row}\n size={size}\n inactive={isRowInactive?.(row.original)}\n href={getRowHref?.(row.original)}\n render={renderRowLink}\n />\n ))}\n {loadingMore &&\n Array.from({ length: MORE_ROWS }, (_, index) => (\n <TableSkeletonRow key={index} size={size} index={rows.length + index} />\n ))}\n </TableBody>\n </Table>\n </SelectionContext>\n )\n\n const bar = bulkActions && (\n <BulkActionBar\n count={selectedRows.length}\n label={labels.selected(format(selectedRows.length))}\n aria-label={labels.selection}\n clearLabel={labels.clearSelection}\n onClear={clearSelection}\n >\n {bulkActions(selectedRows, clearSelection)}\n </BulkActionBar>\n )\n\n if (!toolbar) {\n return (\n <>\n {tableElement}\n {bar}\n </>\n )\n }\n\n return (\n <div className=\"flex flex-col gap-3\">\n {toolbar({ state, setState, columnPicker })}\n {tableElement}\n {bar}\n </div>\n )\n}\n"],"mappings":"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"}
|
|
@@ -1,15 +1,73 @@
|
|
|
1
|
-
import { ComponentProps } from "react";
|
|
2
|
-
|
|
1
|
+
import { ComponentProps, ReactNode } from "react";
|
|
2
|
+
/** The figures a count label places, each formatted and styled already. */
|
|
3
|
+
export interface PaginationRange {
|
|
4
|
+
from: ReactNode;
|
|
5
|
+
to: ReactNode;
|
|
6
|
+
total: ReactNode;
|
|
7
|
+
}
|
|
8
|
+
/** The figures of the page label. */
|
|
9
|
+
export interface PaginationPage {
|
|
10
|
+
page: ReactNode;
|
|
11
|
+
pageCount: ReactNode;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* The words of the paged band, each a prop so a product can translate them. A label that holds
|
|
15
|
+
* figures is a function of them, so a language can put them in its own order.
|
|
16
|
+
*/
|
|
17
|
+
export interface PaginationLabels {
|
|
18
|
+
/** The count: "Showing 26–50 of 1,204". */
|
|
19
|
+
range: (range: PaginationRange) => ReactNode;
|
|
20
|
+
/** The count on a phone: "26–50 of 1,204". */
|
|
21
|
+
rangeShort: (range: PaginationRange) => ReactNode;
|
|
22
|
+
/** "Page 2 of 49". */
|
|
23
|
+
pageOf: (page: PaginationPage) => ReactNode;
|
|
24
|
+
perPage: string;
|
|
25
|
+
firstPage: string;
|
|
26
|
+
previousPage: string;
|
|
27
|
+
nextPage: string;
|
|
28
|
+
lastPage: string;
|
|
29
|
+
}
|
|
30
|
+
interface PaginationProps extends Omit<ComponentProps<"div">, "children"> {
|
|
3
31
|
page: number;
|
|
4
32
|
pageCount: number;
|
|
5
33
|
total: number;
|
|
6
34
|
perPage: number;
|
|
7
35
|
onPageChange: (page: number) => void;
|
|
8
|
-
|
|
36
|
+
/** The page sizes the reader picks from. Left out, the band has no per-page select. */
|
|
37
|
+
perPageOptions?: number[];
|
|
38
|
+
onPerPageChange?: (perPage: number) => void;
|
|
39
|
+
/** While a page loads: every control is disabled, and the caller dims the old rows. */
|
|
40
|
+
loading?: boolean;
|
|
41
|
+
/** Formats each figure in the reader's locale. */
|
|
42
|
+
format?: (value: number) => string;
|
|
43
|
+
/** The band's words, English by default. */
|
|
44
|
+
labels?: Partial<PaginationLabels>;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* The footer band of a paged table: "Showing 26–50 of 1,204", an optional per-page select,
|
|
48
|
+
* "Page 2 of 49" and the joined first, previous, next and last buttons. A single page keeps the
|
|
49
|
+
* count and drops the controls; an empty table has no band. On a phone the count drops
|
|
50
|
+
* "Showing", and the per-page select and the first and last buttons go. Presentational and
|
|
51
|
+
* router-agnostic: the caller wires `onPageChange` to its search params.
|
|
52
|
+
*/
|
|
53
|
+
export declare function Pagination({ page, pageCount, total, perPage, onPageChange, perPageOptions, onPerPageChange, loading, format, labels: labelsProp, className, ...props }: PaginationProps): import("react").JSX.Element | null;
|
|
54
|
+
interface PaginationInfiniteProps extends Omit<ComponentProps<"div">, "children"> {
|
|
55
|
+
/** The count at the start, formatted by the caller: "120 of 4,300 events". */
|
|
56
|
+
count: ReactNode;
|
|
57
|
+
hasMore: boolean;
|
|
58
|
+
loading: boolean;
|
|
59
|
+
onLoadMore: () => void;
|
|
60
|
+
/** False after a failed page: a sentinel still on screen would ask for it again at once. */
|
|
61
|
+
enabled?: boolean;
|
|
62
|
+
/** How far below the viewport the next page starts loading, in pixels. */
|
|
63
|
+
ahead?: number;
|
|
64
|
+
loadingLabel?: ReactNode;
|
|
65
|
+
endLabel?: ReactNode;
|
|
66
|
+
}
|
|
9
67
|
/**
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
68
|
+
* The footer band of a table that loads as it scrolls: the count, then "Loading more…" while the
|
|
69
|
+
* next batch loads and "End of list" once there is none. The band itself is the trigger: the
|
|
70
|
+
* next page loads as it nears the viewport. Pass `onLoadMore` a stable callback.
|
|
13
71
|
*/
|
|
14
|
-
export declare function
|
|
72
|
+
export declare function PaginationInfinite({ count, hasMore, loading, onLoadMore, enabled, ahead, loadingLabel, endLabel, className, ...props }: PaginationInfiniteProps): import("react").JSX.Element;
|
|
15
73
|
export {};
|