@pallasoft/ps-table-components 1.9.0 → 1.10.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.
@@ -1,5 +1,6 @@
1
1
  import { type ReactNode } from 'react';
2
2
  import type { PsTableColumn } from '../interfaces/table-column';
3
+ import type { PsTableGrouping } from '../interfaces/table-grouping';
3
4
  import type { PsTableQuery } from '../interfaces/table-query';
4
5
  import type { PsTableRowAction } from '../interfaces/table-row-action';
5
6
  import type { PsTableSort } from '../interfaces/table-sort';
@@ -15,6 +16,7 @@ export interface PsDataTableProps<RowData> {
15
16
  getRowId: (row: RowData) => string;
16
17
  getRowLabel?: (row: RowData) => string;
17
18
  getSearchText?: (row: RowData) => string;
19
+ grouping?: PsTableGrouping<RowData>;
18
20
  onPageChange?: (page: number) => void;
19
21
  onQueryChange?: (query: PsTableQuery) => void;
20
22
  onRowClick?: (row: RowData) => void;
@@ -28,4 +30,4 @@ export interface PsDataTableProps<RowData> {
28
30
  toolbarActions?: ReactNode;
29
31
  totalRows?: number;
30
32
  }
31
- export declare const PsDataTable: <RowData>({ caption, className, columns, defaultSort, density, expandedRowIds, mobileLayout, getBulkActions, getRowId, getRowLabel, getSearchText, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder, toolbarActions, totalRows, }: PsDataTableProps<RowData>) => import("react").JSX.Element;
33
+ export declare const PsDataTable: <RowData>({ caption, className, columns, defaultSort, density, expandedRowIds, mobileLayout, getBulkActions, getRowId, getRowLabel, getSearchText, grouping, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder, toolbarActions, totalRows, }: PsDataTableProps<RowData>) => import("react").JSX.Element;
@@ -7,10 +7,12 @@ const ps_design_system_1 = require("@pallasoft/ps-design-system");
7
7
  const ps_input_components_1 = require("@pallasoft/ps-input-components");
8
8
  const ps_motion_components_1 = require("@pallasoft/ps-motion-components");
9
9
  const table_config_1 = require("../constants/table-config");
10
+ const ps_table_group_service_1 = require("../services/ps-table-group-service");
10
11
  const ps_table_query_service_1 = require("../services/ps-table-query-service");
11
12
  const ps_table_bulk_bar_1 = require("./ps-table-bulk-bar");
12
13
  const ps_table_card_list_1 = require("./ps-table-card-list");
13
14
  const ps_table_column_picker_1 = require("./ps-table-column-picker");
15
+ const ps_table_group_header_1 = require("./ps-table-group-header");
14
16
  const ps_table_pagination_1 = require("./ps-table-pagination");
15
17
  const ps_table_sort_header_1 = require("./ps-table-sort-header");
16
18
  const ps_table_toolbar_1 = require("./ps-table-toolbar");
@@ -30,11 +32,14 @@ const alignClassNames = {
30
32
  left: 'text-left',
31
33
  right: 'text-right tabular-nums',
32
34
  };
33
- const PsDataTable = ({ caption, className, columns, defaultSort, density = 'normal', expandedRowIds, mobileLayout = 'cards', getBulkActions, getRowId, getRowLabel, getSearchText, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder = table_config_1.PsTableConfig.searchPlaceholder, toolbarActions, totalRows, }) => {
35
+ const PsDataTable = ({ caption, className, columns, defaultSort, density = 'normal', expandedRowIds, mobileLayout = 'cards', getBulkActions, getRowId, getRowLabel, getSearchText, grouping, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder = table_config_1.PsTableConfig.searchPlaceholder, toolbarActions, totalRows, }) => {
34
36
  const containerRef = (0, react_1.useRef)(null);
35
37
  const [uncontrolledPage, setUncontrolledPage] = (0, react_1.useState)(1);
36
38
  const [uncontrolledQuery, setUncontrolledQuery] = (0, react_1.useState)(() => ps_table_query_service_1.PsTableQueryService.empty(defaultSort ? defaultSort : null));
37
39
  const [selectedIds, setSelectedIds] = (0, react_1.useState)([]);
40
+ const [toggledGroupKeys, setToggledGroupKeys] = (0, react_1.useState)([]);
41
+ const [closingGroupKeys, setClosingGroupKeys] = (0, react_1.useState)([]);
42
+ const [openedGroupKeys, setOpenedGroupKeys] = (0, react_1.useState)([]);
38
43
  const currentQuery = query ? query : uncontrolledQuery;
39
44
  const { filters, hiddenColumnIds, search, sort } = currentQuery;
40
45
  const visibleColumns = columns.filter((column) => !hiddenColumnIds.includes(column.id));
@@ -60,11 +65,56 @@ const PsDataTable = ({ caption, className, columns, defaultSort, density = 'norm
60
65
  const safePage = Math.min(Math.max(currentPage, 1), pageCount);
61
66
  const isQueried = search.trim() !== '' ||
62
67
  Object.values(filters).some((value) => ps_table_query_service_1.PsTableQueryService.isActive(value));
68
+ const groups = (0, react_1.useMemo)(() => (grouping ? ps_table_group_service_1.PsTableGroupService.group(queriedRows, grouping.getGroupKey) : []), [grouping, queriedRows]);
69
+ const initialExpandedCount = grouping && grouping.initialExpandedCount !== undefined ? grouping.initialExpandedCount : 1;
70
+ const isGroupExpanded = (groupKey, groupIndex) => isQueried || groupIndex < initialExpandedCount !== toggledGroupKeys.includes(groupKey);
71
+ const flipGroup = (groupKey) => setToggledGroupKeys((current) => current.includes(groupKey)
72
+ ? current.filter((key) => key !== groupKey)
73
+ : [...current, groupKey]);
74
+ const toggleGroup = (groupKey, isExpanded) => {
75
+ if (closingGroupKeys.includes(groupKey))
76
+ return;
77
+ if (!isExpanded) {
78
+ setOpenedGroupKeys((current) => [...current.filter((key) => key !== groupKey), groupKey]);
79
+ flipGroup(groupKey);
80
+ return;
81
+ }
82
+ setClosingGroupKeys((current) => [...current, groupKey]);
83
+ window.setTimeout(() => {
84
+ flipGroup(groupKey);
85
+ setOpenedGroupKeys((current) => current.filter((key) => key !== groupKey));
86
+ setClosingGroupKeys((current) => current.filter((key) => key !== groupKey));
87
+ }, table_config_1.PsTableConfig.groupCloseMs);
88
+ };
89
+ const groupRowMotion = (groupKey, rowIndex) => {
90
+ if (closingGroupKeys.includes(groupKey))
91
+ return { className: 'ps-table-row-exit' };
92
+ if (!openedGroupKeys.includes(groupKey))
93
+ return undefined;
94
+ return {
95
+ className: 'ps-table-row-enter',
96
+ delayMs: Math.min(rowIndex, table_config_1.PsTableConfig.groupStaggerLimit) * table_config_1.PsTableConfig.groupRowStaggerMs,
97
+ };
98
+ };
63
99
  const visibleRows = (0, react_1.useMemo)(() => {
100
+ if (grouping)
101
+ return groups.flatMap((group, groupIndex) => isQueried || groupIndex < initialExpandedCount !== toggledGroupKeys.includes(group.key)
102
+ ? group.rows
103
+ : []);
64
104
  if (!pageSize || isServerPaginated)
65
105
  return queriedRows;
66
106
  return queriedRows.slice((safePage - 1) * pageSize, safePage * pageSize);
67
- }, [isServerPaginated, pageSize, queriedRows, safePage]);
107
+ }, [
108
+ grouping,
109
+ groups,
110
+ initialExpandedCount,
111
+ isQueried,
112
+ isServerPaginated,
113
+ pageSize,
114
+ queriedRows,
115
+ safePage,
116
+ toggledGroupKeys,
117
+ ]);
68
118
  const changePage = (next) => {
69
119
  if (onPageChange) {
70
120
  onPageChange(next);
@@ -96,6 +146,24 @@ const PsDataTable = ({ caption, className, columns, defaultSort, density = 'norm
96
146
  ? current.filter((rowId) => !pageIds.includes(rowId))
97
147
  : [...new Set([...current, ...pageIds])]);
98
148
  const toggleRow = (rowId) => setSelectedIds((current) => current.includes(rowId) ? current.filter((id) => id !== rowId) : [...current, rowId]);
149
+ const renderCardList = (cardRows, emptyContent) => ((0, jsx_runtime_1.jsx)(ps_table_card_list_1.PsTableCardList, { columns: visibleColumns, emptyContent: emptyContent, expandedRowIds: expandedRowIds, footerColumns: hasFooter ? visibleColumns.filter((column) => column.footer !== undefined) : [], getRowId: getRowId, getRowLabel: (row) => (getRowLabel ? getRowLabel(row) : getRowId(row)), isSelectable: isSelectable, onRowClick: onRowClick, onRowHover: onRowHover, onToggleRow: toggleRow, renderExpandedRow: renderExpandedRow, rows: cardRows, selectedIds: selectedIds }));
150
+ const renderRow = (row, motion) => {
151
+ const rowId = getRowId(row);
152
+ const isExpanded = expandedRowIds ? expandedRowIds.includes(rowId) : false;
153
+ const rowLabel = getRowLabel ? getRowLabel(row) : rowId;
154
+ return ((0, jsx_runtime_1.jsxs)(react_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("tr", { "aria-expanded": renderExpandedRow ? isExpanded : undefined, "aria-label": onRowClick ? rowLabel : undefined, className: ps_design_system_1.PallasoftClassNameService.merge('align-middle transition-colors', motion ? motion.className : '', onRowClick ? 'ps-focus-ring cursor-pointer hover:bg-mist/60' : 'hover:bg-mist/40', isExpanded ? 'bg-mist/40' : ''), onClick: onRowClick ? () => onRowClick(row) : undefined, onFocus: onRowHover ? () => onRowHover(row) : undefined, onPointerEnter: onRowHover ? () => onRowHover(row) : undefined, onKeyDown: onRowClick
155
+ ? (event) => {
156
+ if (event.target !== event.currentTarget)
157
+ return;
158
+ if (event.key !== 'Enter' && event.key !== ' ')
159
+ return;
160
+ event.preventDefault();
161
+ onRowClick(row);
162
+ }
163
+ : undefined, style: motion && motion.delayMs !== undefined
164
+ ? { animationDelay: `${motion.delayMs}ms` }
165
+ : undefined, tabIndex: onRowClick ? 0 : undefined, children: [isSelectable ? ((0, jsx_runtime_1.jsx)("td", { className: 'w-10 pl-4 pr-0', onClick: (event) => event.stopPropagation(), onKeyDown: (event) => event.stopPropagation(), children: (0, jsx_runtime_1.jsx)(ps_input_components_1.PsCheckbox, { isSelected: selectedIds.includes(rowId), label: `Select ${rowLabel}`, onChange: () => toggleRow(rowId) }) })) : null, visibleColumns.map((column) => ((0, jsx_runtime_1.jsx)("td", { className: ps_design_system_1.PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined ? column.align : 'left'], column.wrap ? '' : 'whitespace-nowrap', 'text-sm text-ink'), style: columnStyle(column), children: column.render(row) }, column.id)))] }), renderExpandedRow ? ((0, jsx_runtime_1.jsx)("tr", { "aria-hidden": !isExpanded, className: isExpanded ? 'border-t-0' : 'border-0', children: (0, jsx_runtime_1.jsx)("td", { className: 'p-0', colSpan: columnCount, children: (0, jsx_runtime_1.jsx)(ps_motion_components_1.PsCollapse, { isOpen: isExpanded, children: (0, jsx_runtime_1.jsx)("div", { className: 'w-0 min-w-full border-l-2 border-primary bg-mist/40 px-4 py-4', children: renderExpandedRow(row) }) }) }) })) : null] }, rowId));
166
+ };
99
167
  return ((0, jsx_runtime_1.jsxs)("div", { ref: containerRef, className: ps_design_system_1.PallasoftClassNameService.merge('flex min-w-0 flex-col gap-3', className), children: [isSelectable && selectedRows.length > 0 && getBulkActions ? ((0, jsx_runtime_1.jsx)(ps_table_bulk_bar_1.PsTableBulkBar, { actions: getBulkActions(selectedRows), onClear: () => setSelectedIds([]), selectedCount: selectedRows.length })) : hasToolbar || columns.some((column) => column.canHide) ? ((0, jsx_runtime_1.jsx)(ps_table_toolbar_1.PsTableToolbar, { actions: (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [toolbarActions, columns.some((column) => column.canHide) ? ((0, jsx_runtime_1.jsx)(ps_table_column_picker_1.PsTableColumnPicker, { columns: columns
100
168
  .filter((column) => column.canHide)
101
169
  .map((column) => ({ id: column.id, label: column.label })), hiddenColumnIds: hiddenColumnIds, onChange: (nextHidden) => updateQuery({ hiddenColumnIds: nextHidden }) })) : null] }), columns: hasFilters ? columns : [], filters: filters, isSearchable: isSearchable, onClearFilters: clearFilters, onFilterChange: (columnId, value) => {
@@ -104,7 +172,14 @@ const PsDataTable = ({ caption, className, columns, defaultSort, density = 'norm
104
172
  }, onSearchChange: (next) => {
105
173
  updateQuery({ search: next });
106
174
  resetPage();
107
- }, rows: rows, search: search, searchPlaceholder: searchPlaceholder })) : null, (0, jsx_runtime_1.jsxs)("div", { className: 'min-w-0 overflow-hidden rounded-[1.25rem] border border-line bg-surface', children: [mobileLayout === 'cards' ? ((0, jsx_runtime_1.jsx)("div", { className: 'sm:hidden', children: (0, jsx_runtime_1.jsx)(ps_table_card_list_1.PsTableCardList, { columns: visibleColumns, emptyContent: visibleRows.length === 0 && isQueried ? ((0, jsx_runtime_1.jsxs)("div", { className: 'px-4 py-10 text-center', children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-sm font-semibold text-ink', children: table_config_1.PsTableConfig.noMatchesTitle }), (0, jsx_runtime_1.jsx)("button", { className: 'ps-focus-ring mt-2 rounded-full px-3 py-1.5 text-sm font-semibold text-primary', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] })) : null, expandedRowIds: expandedRowIds, footerColumns: hasFooter ? visibleColumns.filter((column) => column.footer !== undefined) : [], getRowId: getRowId, getRowLabel: (row) => (getRowLabel ? getRowLabel(row) : getRowId(row)), isSelectable: isSelectable, onRowClick: onRowClick, onRowHover: onRowHover, onToggleRow: toggleRow, renderExpandedRow: renderExpandedRow, rows: visibleRows, selectedIds: selectedIds }) })) : null, (0, jsx_runtime_1.jsx)("div", { className: ps_design_system_1.PallasoftClassNameService.merge('ps-scrollbar overflow-x-auto', mobileLayout === 'cards' ? 'hidden sm:block' : ''), children: (0, jsx_runtime_1.jsxs)("table", { className: 'w-full border-collapse text-left', children: [caption ? (0, jsx_runtime_1.jsx)("caption", { className: 'sr-only', children: caption }) : null, (0, jsx_runtime_1.jsx)("thead", { className: 'bg-mist/70 text-[0.68rem] font-semibold uppercase tracking-[0.18em] text-ink/45', children: (0, jsx_runtime_1.jsxs)("tr", { children: [isSelectable ? ((0, jsx_runtime_1.jsx)("th", { className: 'w-10 pl-4 pr-0', scope: 'col', children: (0, jsx_runtime_1.jsx)(ps_input_components_1.PsCheckbox, { isIndeterminate: !isPageSelected && pageIds.some((rowId) => selectedIds.includes(rowId)), isSelected: isPageSelected, label: 'Select all rows on this page', onChange: togglePage }) })) : null, visibleColumns.map((column) => {
175
+ }, rows: rows, search: search, searchPlaceholder: searchPlaceholder })) : null, (0, jsx_runtime_1.jsxs)("div", { className: 'min-w-0 overflow-hidden rounded-[1.25rem] border border-line bg-surface', children: [mobileLayout === 'cards' ? ((0, jsx_runtime_1.jsx)("div", { className: 'sm:hidden', children: grouping
176
+ ? groups.map((group, groupIndex) => {
177
+ const isExpanded = isGroupExpanded(group.key, groupIndex);
178
+ return ((0, jsx_runtime_1.jsxs)("div", { className: 'border-b border-line last:border-b-0', children: [(0, jsx_runtime_1.jsx)(ps_table_group_header_1.PsTableGroupHeader, { count: group.rows.length, isExpanded: isExpanded, label: grouping.getGroupLabel(group.key, group.rows), onToggle: () => toggleGroup(group.key, isExpanded), summary: grouping.renderGroupSummary
179
+ ? grouping.renderGroupSummary(group.rows)
180
+ : undefined }), (0, jsx_runtime_1.jsx)(ps_motion_components_1.PsCollapse, { isOpen: isExpanded && !closingGroupKeys.includes(group.key), children: renderCardList(group.rows, null) })] }, `group-${group.key}`));
181
+ })
182
+ : renderCardList(visibleRows, visibleRows.length === 0 && isQueried ? ((0, jsx_runtime_1.jsxs)("div", { className: 'px-4 py-10 text-center', children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-sm font-semibold text-ink', children: table_config_1.PsTableConfig.noMatchesTitle }), (0, jsx_runtime_1.jsx)("button", { className: 'ps-focus-ring mt-2 rounded-full px-3 py-1.5 text-sm font-semibold text-primary', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] })) : null) })) : null, (0, jsx_runtime_1.jsx)("div", { className: ps_design_system_1.PallasoftClassNameService.merge('ps-scrollbar overflow-x-auto', mobileLayout === 'cards' ? 'hidden sm:block' : ''), children: (0, jsx_runtime_1.jsxs)("table", { className: 'w-full border-collapse text-left', children: [caption ? (0, jsx_runtime_1.jsx)("caption", { className: 'sr-only', children: caption }) : null, (0, jsx_runtime_1.jsx)("thead", { className: 'bg-mist/70 text-[0.68rem] font-semibold uppercase tracking-[0.18em] text-ink/45', children: (0, jsx_runtime_1.jsxs)("tr", { children: [isSelectable ? ((0, jsx_runtime_1.jsx)("th", { className: 'w-10 pl-4 pr-0', scope: 'col', children: (0, jsx_runtime_1.jsx)(ps_input_components_1.PsCheckbox, { isIndeterminate: !isPageSelected && pageIds.some((rowId) => selectedIds.includes(rowId)), isSelected: isPageSelected, label: 'Select all rows on this page', onChange: togglePage }) })) : null, visibleColumns.map((column) => {
108
183
  const align = column.align !== null && column.align !== undefined ? column.align : 'left';
109
184
  const isSorted = sort !== null && sort.columnId === column.id;
110
185
  return ((0, jsx_runtime_1.jsx)("th", { "aria-sort": isSorted
@@ -112,26 +187,17 @@ const PsDataTable = ({ caption, className, columns, defaultSort, density = 'norm
112
187
  : column.sortValue && !isServerPaginated
113
188
  ? 'none'
114
189
  : undefined, className: ps_design_system_1.PallasoftClassNameService.merge(densityClassNames[density].head, alignClassNames[align], 'whitespace-nowrap'), scope: 'col', style: columnStyle(column), children: column.sortValue && !isServerPaginated ? ((0, jsx_runtime_1.jsx)(ps_table_sort_header_1.PsTableSortHeader, { align: align, columnId: column.id, label: column.label, onSort: updateSort, sort: sort })) : (column.label) }, column.id));
115
- })] }) }), (0, jsx_runtime_1.jsxs)("tbody", { className: 'divide-y divide-line', children: [visibleRows.length === 0 && isQueried ? ((0, jsx_runtime_1.jsx)("tr", { children: (0, jsx_runtime_1.jsxs)("td", { className: 'px-4 py-12 text-center', colSpan: columnCount, children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-sm font-semibold text-ink', children: table_config_1.PsTableConfig.noMatchesTitle }), (0, jsx_runtime_1.jsx)("p", { className: 'mt-1 text-sm text-ink/55', children: table_config_1.PsTableConfig.noMatchesDescription }), (0, jsx_runtime_1.jsx)("button", { className: 'ps-focus-ring mt-3 rounded-full px-3 py-1.5 text-sm font-semibold text-primary hover:underline', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] }) })) : null, visibleRows.map((row) => {
116
- const rowId = getRowId(row);
117
- const isExpanded = expandedRowIds ? expandedRowIds.includes(rowId) : false;
118
- const rowLabel = getRowLabel ? getRowLabel(row) : rowId;
119
- return ((0, jsx_runtime_1.jsxs)(react_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("tr", { "aria-expanded": renderExpandedRow ? isExpanded : undefined, "aria-label": onRowClick ? rowLabel : undefined, className: ps_design_system_1.PallasoftClassNameService.merge('align-middle transition-colors', onRowClick
120
- ? 'ps-focus-ring cursor-pointer hover:bg-mist/60'
121
- : 'hover:bg-mist/40', isExpanded ? 'bg-mist/40' : ''), onClick: onRowClick ? () => onRowClick(row) : undefined, onFocus: onRowHover ? () => onRowHover(row) : undefined, onPointerEnter: onRowHover ? () => onRowHover(row) : undefined, onKeyDown: onRowClick
122
- ? (event) => {
123
- if (event.target !== event.currentTarget)
124
- return;
125
- if (event.key !== 'Enter' && event.key !== ' ')
126
- return;
127
- event.preventDefault();
128
- onRowClick(row);
129
- }
130
- : undefined, tabIndex: onRowClick ? 0 : undefined, children: [isSelectable ? ((0, jsx_runtime_1.jsx)("td", { className: 'w-10 pl-4 pr-0', onClick: (event) => event.stopPropagation(), onKeyDown: (event) => event.stopPropagation(), children: (0, jsx_runtime_1.jsx)(ps_input_components_1.PsCheckbox, { isSelected: selectedIds.includes(rowId), label: `Select ${rowLabel}`, onChange: () => toggleRow(rowId) }) })) : null, visibleColumns.map((column) => ((0, jsx_runtime_1.jsx)("td", { className: ps_design_system_1.PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
131
- ? column.align
132
- : 'left'], column.wrap ? '' : 'whitespace-nowrap', 'text-sm text-ink'), style: columnStyle(column), children: column.render(row) }, column.id)))] }), renderExpandedRow && isExpanded ? ((0, jsx_runtime_1.jsx)("tr", { className: 'border-t-0', children: (0, jsx_runtime_1.jsx)("td", { className: 'p-0', colSpan: columnCount, children: (0, jsx_runtime_1.jsx)(ps_motion_components_1.PsCollapse, { isOpen: true, children: (0, jsx_runtime_1.jsx)("div", { className: 'w-0 min-w-full border-l-2 border-primary bg-mist/40 px-4 py-4', children: renderExpandedRow(row) }) }) }) })) : null] }, rowId));
133
- })] }), hasFooter ? ((0, jsx_runtime_1.jsx)("tfoot", { className: 'border-t-2 border-line bg-mist/50 text-sm font-semibold text-ink', children: (0, jsx_runtime_1.jsxs)("tr", { children: [isSelectable ? (0, jsx_runtime_1.jsx)("td", {}) : null, visibleColumns.map((column) => ((0, jsx_runtime_1.jsx)("td", { className: ps_design_system_1.PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
190
+ })] }) }), (0, jsx_runtime_1.jsxs)("tbody", { className: 'divide-y divide-line', children: [visibleRows.length === 0 && isQueried ? ((0, jsx_runtime_1.jsx)("tr", { children: (0, jsx_runtime_1.jsxs)("td", { className: 'px-4 py-12 text-center', colSpan: columnCount, children: [(0, jsx_runtime_1.jsx)("p", { className: 'text-sm font-semibold text-ink', children: table_config_1.PsTableConfig.noMatchesTitle }), (0, jsx_runtime_1.jsx)("p", { className: 'mt-1 text-sm text-ink/55', children: table_config_1.PsTableConfig.noMatchesDescription }), (0, jsx_runtime_1.jsx)("button", { className: 'ps-focus-ring mt-3 rounded-full px-3 py-1.5 text-sm font-semibold text-primary hover:underline', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] }) })) : null, grouping
191
+ ? groups.map((group, groupIndex) => {
192
+ const isExpanded = isGroupExpanded(group.key, groupIndex);
193
+ return ((0, jsx_runtime_1.jsxs)(react_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("tr", { children: (0, jsx_runtime_1.jsx)("td", { className: 'p-0', colSpan: columnCount, children: (0, jsx_runtime_1.jsx)(ps_table_group_header_1.PsTableGroupHeader, { count: group.rows.length, isExpanded: isExpanded, label: grouping.getGroupLabel(group.key, group.rows), onToggle: () => toggleGroup(group.key, isExpanded), summary: grouping.renderGroupSummary
194
+ ? grouping.renderGroupSummary(group.rows)
195
+ : undefined }) }) }), isExpanded
196
+ ? group.rows.map((row, rowIndex) => renderRow(row, groupRowMotion(group.key, rowIndex)))
197
+ : null] }, `group-${group.key}`));
198
+ })
199
+ : visibleRows.map((row) => renderRow(row))] }), hasFooter ? ((0, jsx_runtime_1.jsx)("tfoot", { className: 'border-t-2 border-line bg-mist/50 text-sm font-semibold text-ink', children: (0, jsx_runtime_1.jsxs)("tr", { children: [isSelectable ? (0, jsx_runtime_1.jsx)("td", {}) : null, visibleColumns.map((column) => ((0, jsx_runtime_1.jsx)("td", { className: ps_design_system_1.PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
134
200
  ? column.align
135
- : 'left'], 'whitespace-nowrap'), children: column.footer }, column.id)))] }) })) : null] }) }), pageSize ? ((0, jsx_runtime_1.jsx)(ps_table_pagination_1.PsTablePagination, { onPageChange: changePage, page: safePage, pageCount: pageCount, pageSize: pageSize, totalRows: rowCount })) : null] })] }));
201
+ : 'left'], 'whitespace-nowrap'), children: column.footer }, column.id)))] }) })) : null] }) }), pageSize && !grouping ? ((0, jsx_runtime_1.jsx)(ps_table_pagination_1.PsTablePagination, { onPageChange: changePage, page: safePage, pageCount: pageCount, pageSize: pageSize, totalRows: rowCount })) : null] })] }));
136
202
  };
137
203
  exports.PsDataTable = PsDataTable;
@@ -3,5 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.PsTableBulkBar = void 0;
4
4
  const jsx_runtime_1 = require("react/jsx-runtime");
5
5
  const ps_design_system_1 = require("@pallasoft/ps-design-system");
6
- const PsTableBulkBar = ({ actions, onClear, selectedCount }) => ((0, jsx_runtime_1.jsxs)("div", { "aria-live": 'polite', className: 'flex flex-wrap items-center gap-1 rounded-2xl border border-primary/30 bg-primary/10 px-2 py-1.5 sm:gap-2 sm:rounded-full', children: [(0, jsx_runtime_1.jsxs)("span", { className: 'px-2 text-sm font-semibold text-ink', children: [selectedCount, " selected"] }), actions.map((action) => ((0, jsx_runtime_1.jsx)("button", { className: ps_design_system_1.PallasoftClassNameService.merge('ps-focus-ring inline-flex min-h-8 items-center rounded-full px-3 text-sm font-semibold transition-colors disabled:opacity-40', action.isDanger ? 'text-danger hover:bg-danger/10' : 'text-ink hover:bg-ink/5'), disabled: action.isDisabled, onClick: action.onSelect, type: 'button', children: action.label }, action.id))), (0, jsx_runtime_1.jsx)("button", { className: 'ps-focus-ring ml-auto inline-flex min-h-8 items-center rounded-full px-3 text-sm font-semibold text-ink/65 hover:text-ink', onClick: onClear, type: 'button', children: "Clear selection" })] }));
6
+ const ps_icons_1 = require("@pallasoft/ps-icons");
7
+ const PsTableBulkBar = ({ actions, onClear, selectedCount }) => {
8
+ const safeActions = actions.filter((action) => !action.isDanger);
9
+ const dangerActions = actions.filter((action) => action.isDanger);
10
+ const renderAction = (action) => ((0, jsx_runtime_1.jsx)("button", { className: ps_design_system_1.PallasoftClassNameService.merge('ps-focus-ring inline-flex min-h-9 shrink-0 items-center whitespace-nowrap rounded-full px-3 text-sm font-semibold transition-colors disabled:opacity-40', action.isDanger ? 'text-danger hover:bg-danger/10' : 'text-ink hover:bg-ink/5'), disabled: action.isDisabled, onClick: action.onSelect, type: 'button', children: action.label }, action.id));
11
+ return ((0, jsx_runtime_1.jsxs)("div", { "aria-live": 'polite', className: 'flex min-h-12 items-center gap-2 rounded-2xl border border-primary/30 bg-primary/10 py-1.5 pl-2 pr-1.5', children: [(0, jsx_runtime_1.jsxs)("span", { className: 'inline-flex min-h-9 shrink-0 items-center rounded-full bg-primary px-3 text-sm font-semibold tabular-nums text-white', children: [selectedCount, " selected"] }), (0, jsx_runtime_1.jsxs)("div", { className: 'ps-scrollbar-hidden flex min-w-0 flex-1 items-center gap-1 overflow-x-auto', children: [safeActions.map(renderAction), dangerActions.length > 0 && safeActions.length > 0 ? ((0, jsx_runtime_1.jsx)("span", { "aria-hidden": 'true', className: 'mx-1 h-5 w-px shrink-0 bg-line' })) : null, dangerActions.map(renderAction)] }), (0, jsx_runtime_1.jsx)("button", { "aria-label": 'Clear selection', className: 'ps-focus-ring inline-flex h-9 w-9 shrink-0 items-center justify-center rounded-full text-ink/60 transition-colors hover:bg-ink/5 hover:text-ink', onClick: onClear, title: 'Clear selection', type: 'button', children: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'h-4 w-4', iconKey: ps_icons_1.PsIconKey.Close }) })] }));
12
+ };
7
13
  exports.PsTableBulkBar = PsTableBulkBar;
@@ -0,0 +1,9 @@
1
+ import type { ReactNode } from 'react';
2
+ export interface PsTableGroupHeaderProps {
3
+ count: number;
4
+ isExpanded: boolean;
5
+ label: string;
6
+ onToggle: () => void;
7
+ summary?: ReactNode;
8
+ }
9
+ export declare const PsTableGroupHeader: ({ count, isExpanded, label, onToggle, summary, }: PsTableGroupHeaderProps) => import("react").JSX.Element;
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PsTableGroupHeader = void 0;
4
+ const jsx_runtime_1 = require("react/jsx-runtime");
5
+ const ps_design_system_1 = require("@pallasoft/ps-design-system");
6
+ const ps_icons_1 = require("@pallasoft/ps-icons");
7
+ const PsTableGroupHeader = ({ count, isExpanded, label, onToggle, summary, }) => ((0, jsx_runtime_1.jsxs)("button", { "aria-expanded": isExpanded, className: 'ps-focus-ring flex w-full flex-wrap items-center gap-x-3 gap-y-2 bg-mist/60 px-4 py-3 text-left transition-colors hover:bg-mist', onClick: onToggle, type: 'button', children: [(0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: ps_design_system_1.PallasoftClassNameService.merge('h-4 w-4 shrink-0 text-ink/50 transition-transform duration-200', isExpanded ? '' : '-rotate-90'), iconKey: ps_icons_1.PsIconKey.Chevron }), (0, jsx_runtime_1.jsx)("span", { className: 'text-sm font-semibold text-ink', children: label }), (0, jsx_runtime_1.jsx)("span", { className: 'rounded-full bg-surface px-2 py-0.5 text-xs font-semibold tabular-nums text-ink/60', children: count }), summary ? ((0, jsx_runtime_1.jsx)("span", { className: 'ml-auto flex flex-wrap items-center justify-end gap-2', children: summary })) : null] }));
8
+ exports.PsTableGroupHeader = PsTableGroupHeader;
@@ -1,4 +1,7 @@
1
1
  export declare const PsTableConfig: {
2
+ readonly groupCloseMs: 160;
3
+ readonly groupRowStaggerMs: 16;
4
+ readonly groupStaggerLimit: 12;
2
5
  readonly noMatchesDescription: "Try a different search or clear the filters.";
3
6
  readonly noMatchesTitle: "Nothing matches";
4
7
  readonly searchPlaceholder: "Search";
@@ -2,6 +2,9 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.PsTableConfig = void 0;
4
4
  exports.PsTableConfig = {
5
+ groupCloseMs: 160,
6
+ groupRowStaggerMs: 16,
7
+ groupStaggerLimit: 12,
5
8
  noMatchesDescription: 'Try a different search or clear the filters.',
6
9
  noMatchesTitle: 'Nothing matches',
7
10
  searchPlaceholder: 'Search',
@@ -1,13 +1,15 @@
1
- import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
2
  import { Fragment, useMemo, useRef, useState } from 'react';
3
3
  import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
4
4
  import { PsCheckbox } from '@pallasoft/ps-input-components';
5
5
  import { PsCollapse } from '@pallasoft/ps-motion-components';
6
6
  import { PsTableConfig } from '../constants/table-config';
7
+ import { PsTableGroupService } from '../services/ps-table-group-service';
7
8
  import { PsTableQueryService } from '../services/ps-table-query-service';
8
9
  import { PsTableBulkBar } from './ps-table-bulk-bar';
9
10
  import { PsTableCardList } from './ps-table-card-list';
10
11
  import { PsTableColumnPicker } from './ps-table-column-picker';
12
+ import { PsTableGroupHeader } from './ps-table-group-header';
11
13
  import { PsTablePagination } from './ps-table-pagination';
12
14
  import { PsTableSortHeader } from './ps-table-sort-header';
13
15
  import { PsTableToolbar } from './ps-table-toolbar';
@@ -27,11 +29,14 @@ const alignClassNames = {
27
29
  left: 'text-left',
28
30
  right: 'text-right tabular-nums',
29
31
  };
30
- export const PsDataTable = ({ caption, className, columns, defaultSort, density = 'normal', expandedRowIds, mobileLayout = 'cards', getBulkActions, getRowId, getRowLabel, getSearchText, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder = PsTableConfig.searchPlaceholder, toolbarActions, totalRows, }) => {
32
+ export const PsDataTable = ({ caption, className, columns, defaultSort, density = 'normal', expandedRowIds, mobileLayout = 'cards', getBulkActions, getRowId, getRowLabel, getSearchText, grouping, onPageChange, onQueryChange, onRowClick, onRowHover, page, pageSize, query, renderExpandedRow, rows, searchPlaceholder = PsTableConfig.searchPlaceholder, toolbarActions, totalRows, }) => {
31
33
  const containerRef = useRef(null);
32
34
  const [uncontrolledPage, setUncontrolledPage] = useState(1);
33
35
  const [uncontrolledQuery, setUncontrolledQuery] = useState(() => PsTableQueryService.empty(defaultSort ? defaultSort : null));
34
36
  const [selectedIds, setSelectedIds] = useState([]);
37
+ const [toggledGroupKeys, setToggledGroupKeys] = useState([]);
38
+ const [closingGroupKeys, setClosingGroupKeys] = useState([]);
39
+ const [openedGroupKeys, setOpenedGroupKeys] = useState([]);
35
40
  const currentQuery = query ? query : uncontrolledQuery;
36
41
  const { filters, hiddenColumnIds, search, sort } = currentQuery;
37
42
  const visibleColumns = columns.filter((column) => !hiddenColumnIds.includes(column.id));
@@ -57,11 +62,56 @@ export const PsDataTable = ({ caption, className, columns, defaultSort, density
57
62
  const safePage = Math.min(Math.max(currentPage, 1), pageCount);
58
63
  const isQueried = search.trim() !== '' ||
59
64
  Object.values(filters).some((value) => PsTableQueryService.isActive(value));
65
+ const groups = useMemo(() => (grouping ? PsTableGroupService.group(queriedRows, grouping.getGroupKey) : []), [grouping, queriedRows]);
66
+ const initialExpandedCount = grouping && grouping.initialExpandedCount !== undefined ? grouping.initialExpandedCount : 1;
67
+ const isGroupExpanded = (groupKey, groupIndex) => isQueried || groupIndex < initialExpandedCount !== toggledGroupKeys.includes(groupKey);
68
+ const flipGroup = (groupKey) => setToggledGroupKeys((current) => current.includes(groupKey)
69
+ ? current.filter((key) => key !== groupKey)
70
+ : [...current, groupKey]);
71
+ const toggleGroup = (groupKey, isExpanded) => {
72
+ if (closingGroupKeys.includes(groupKey))
73
+ return;
74
+ if (!isExpanded) {
75
+ setOpenedGroupKeys((current) => [...current.filter((key) => key !== groupKey), groupKey]);
76
+ flipGroup(groupKey);
77
+ return;
78
+ }
79
+ setClosingGroupKeys((current) => [...current, groupKey]);
80
+ window.setTimeout(() => {
81
+ flipGroup(groupKey);
82
+ setOpenedGroupKeys((current) => current.filter((key) => key !== groupKey));
83
+ setClosingGroupKeys((current) => current.filter((key) => key !== groupKey));
84
+ }, PsTableConfig.groupCloseMs);
85
+ };
86
+ const groupRowMotion = (groupKey, rowIndex) => {
87
+ if (closingGroupKeys.includes(groupKey))
88
+ return { className: 'ps-table-row-exit' };
89
+ if (!openedGroupKeys.includes(groupKey))
90
+ return undefined;
91
+ return {
92
+ className: 'ps-table-row-enter',
93
+ delayMs: Math.min(rowIndex, PsTableConfig.groupStaggerLimit) * PsTableConfig.groupRowStaggerMs,
94
+ };
95
+ };
60
96
  const visibleRows = useMemo(() => {
97
+ if (grouping)
98
+ return groups.flatMap((group, groupIndex) => isQueried || groupIndex < initialExpandedCount !== toggledGroupKeys.includes(group.key)
99
+ ? group.rows
100
+ : []);
61
101
  if (!pageSize || isServerPaginated)
62
102
  return queriedRows;
63
103
  return queriedRows.slice((safePage - 1) * pageSize, safePage * pageSize);
64
- }, [isServerPaginated, pageSize, queriedRows, safePage]);
104
+ }, [
105
+ grouping,
106
+ groups,
107
+ initialExpandedCount,
108
+ isQueried,
109
+ isServerPaginated,
110
+ pageSize,
111
+ queriedRows,
112
+ safePage,
113
+ toggledGroupKeys,
114
+ ]);
65
115
  const changePage = (next) => {
66
116
  if (onPageChange) {
67
117
  onPageChange(next);
@@ -93,6 +143,24 @@ export const PsDataTable = ({ caption, className, columns, defaultSort, density
93
143
  ? current.filter((rowId) => !pageIds.includes(rowId))
94
144
  : [...new Set([...current, ...pageIds])]);
95
145
  const toggleRow = (rowId) => setSelectedIds((current) => current.includes(rowId) ? current.filter((id) => id !== rowId) : [...current, rowId]);
146
+ const renderCardList = (cardRows, emptyContent) => (_jsx(PsTableCardList, { columns: visibleColumns, emptyContent: emptyContent, expandedRowIds: expandedRowIds, footerColumns: hasFooter ? visibleColumns.filter((column) => column.footer !== undefined) : [], getRowId: getRowId, getRowLabel: (row) => (getRowLabel ? getRowLabel(row) : getRowId(row)), isSelectable: isSelectable, onRowClick: onRowClick, onRowHover: onRowHover, onToggleRow: toggleRow, renderExpandedRow: renderExpandedRow, rows: cardRows, selectedIds: selectedIds }));
147
+ const renderRow = (row, motion) => {
148
+ const rowId = getRowId(row);
149
+ const isExpanded = expandedRowIds ? expandedRowIds.includes(rowId) : false;
150
+ const rowLabel = getRowLabel ? getRowLabel(row) : rowId;
151
+ return (_jsxs(Fragment, { children: [_jsxs("tr", { "aria-expanded": renderExpandedRow ? isExpanded : undefined, "aria-label": onRowClick ? rowLabel : undefined, className: PallasoftClassNameService.merge('align-middle transition-colors', motion ? motion.className : '', onRowClick ? 'ps-focus-ring cursor-pointer hover:bg-mist/60' : 'hover:bg-mist/40', isExpanded ? 'bg-mist/40' : ''), onClick: onRowClick ? () => onRowClick(row) : undefined, onFocus: onRowHover ? () => onRowHover(row) : undefined, onPointerEnter: onRowHover ? () => onRowHover(row) : undefined, onKeyDown: onRowClick
152
+ ? (event) => {
153
+ if (event.target !== event.currentTarget)
154
+ return;
155
+ if (event.key !== 'Enter' && event.key !== ' ')
156
+ return;
157
+ event.preventDefault();
158
+ onRowClick(row);
159
+ }
160
+ : undefined, style: motion && motion.delayMs !== undefined
161
+ ? { animationDelay: `${motion.delayMs}ms` }
162
+ : undefined, tabIndex: onRowClick ? 0 : undefined, children: [isSelectable ? (_jsx("td", { className: 'w-10 pl-4 pr-0', onClick: (event) => event.stopPropagation(), onKeyDown: (event) => event.stopPropagation(), children: _jsx(PsCheckbox, { isSelected: selectedIds.includes(rowId), label: `Select ${rowLabel}`, onChange: () => toggleRow(rowId) }) })) : null, visibleColumns.map((column) => (_jsx("td", { className: PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined ? column.align : 'left'], column.wrap ? '' : 'whitespace-nowrap', 'text-sm text-ink'), style: columnStyle(column), children: column.render(row) }, column.id)))] }), renderExpandedRow ? (_jsx("tr", { "aria-hidden": !isExpanded, className: isExpanded ? 'border-t-0' : 'border-0', children: _jsx("td", { className: 'p-0', colSpan: columnCount, children: _jsx(PsCollapse, { isOpen: isExpanded, children: _jsx("div", { className: 'w-0 min-w-full border-l-2 border-primary bg-mist/40 px-4 py-4', children: renderExpandedRow(row) }) }) }) })) : null] }, rowId));
163
+ };
96
164
  return (_jsxs("div", { ref: containerRef, className: PallasoftClassNameService.merge('flex min-w-0 flex-col gap-3', className), children: [isSelectable && selectedRows.length > 0 && getBulkActions ? (_jsx(PsTableBulkBar, { actions: getBulkActions(selectedRows), onClear: () => setSelectedIds([]), selectedCount: selectedRows.length })) : hasToolbar || columns.some((column) => column.canHide) ? (_jsx(PsTableToolbar, { actions: _jsxs(_Fragment, { children: [toolbarActions, columns.some((column) => column.canHide) ? (_jsx(PsTableColumnPicker, { columns: columns
97
165
  .filter((column) => column.canHide)
98
166
  .map((column) => ({ id: column.id, label: column.label })), hiddenColumnIds: hiddenColumnIds, onChange: (nextHidden) => updateQuery({ hiddenColumnIds: nextHidden }) })) : null] }), columns: hasFilters ? columns : [], filters: filters, isSearchable: isSearchable, onClearFilters: clearFilters, onFilterChange: (columnId, value) => {
@@ -101,7 +169,14 @@ export const PsDataTable = ({ caption, className, columns, defaultSort, density
101
169
  }, onSearchChange: (next) => {
102
170
  updateQuery({ search: next });
103
171
  resetPage();
104
- }, rows: rows, search: search, searchPlaceholder: searchPlaceholder })) : null, _jsxs("div", { className: 'min-w-0 overflow-hidden rounded-[1.25rem] border border-line bg-surface', children: [mobileLayout === 'cards' ? (_jsx("div", { className: 'sm:hidden', children: _jsx(PsTableCardList, { columns: visibleColumns, emptyContent: visibleRows.length === 0 && isQueried ? (_jsxs("div", { className: 'px-4 py-10 text-center', children: [_jsx("p", { className: 'text-sm font-semibold text-ink', children: PsTableConfig.noMatchesTitle }), _jsx("button", { className: 'ps-focus-ring mt-2 rounded-full px-3 py-1.5 text-sm font-semibold text-primary', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] })) : null, expandedRowIds: expandedRowIds, footerColumns: hasFooter ? visibleColumns.filter((column) => column.footer !== undefined) : [], getRowId: getRowId, getRowLabel: (row) => (getRowLabel ? getRowLabel(row) : getRowId(row)), isSelectable: isSelectable, onRowClick: onRowClick, onRowHover: onRowHover, onToggleRow: toggleRow, renderExpandedRow: renderExpandedRow, rows: visibleRows, selectedIds: selectedIds }) })) : null, _jsx("div", { className: PallasoftClassNameService.merge('ps-scrollbar overflow-x-auto', mobileLayout === 'cards' ? 'hidden sm:block' : ''), children: _jsxs("table", { className: 'w-full border-collapse text-left', children: [caption ? _jsx("caption", { className: 'sr-only', children: caption }) : null, _jsx("thead", { className: 'bg-mist/70 text-[0.68rem] font-semibold uppercase tracking-[0.18em] text-ink/45', children: _jsxs("tr", { children: [isSelectable ? (_jsx("th", { className: 'w-10 pl-4 pr-0', scope: 'col', children: _jsx(PsCheckbox, { isIndeterminate: !isPageSelected && pageIds.some((rowId) => selectedIds.includes(rowId)), isSelected: isPageSelected, label: 'Select all rows on this page', onChange: togglePage }) })) : null, visibleColumns.map((column) => {
172
+ }, rows: rows, search: search, searchPlaceholder: searchPlaceholder })) : null, _jsxs("div", { className: 'min-w-0 overflow-hidden rounded-[1.25rem] border border-line bg-surface', children: [mobileLayout === 'cards' ? (_jsx("div", { className: 'sm:hidden', children: grouping
173
+ ? groups.map((group, groupIndex) => {
174
+ const isExpanded = isGroupExpanded(group.key, groupIndex);
175
+ return (_jsxs("div", { className: 'border-b border-line last:border-b-0', children: [_jsx(PsTableGroupHeader, { count: group.rows.length, isExpanded: isExpanded, label: grouping.getGroupLabel(group.key, group.rows), onToggle: () => toggleGroup(group.key, isExpanded), summary: grouping.renderGroupSummary
176
+ ? grouping.renderGroupSummary(group.rows)
177
+ : undefined }), _jsx(PsCollapse, { isOpen: isExpanded && !closingGroupKeys.includes(group.key), children: renderCardList(group.rows, null) })] }, `group-${group.key}`));
178
+ })
179
+ : renderCardList(visibleRows, visibleRows.length === 0 && isQueried ? (_jsxs("div", { className: 'px-4 py-10 text-center', children: [_jsx("p", { className: 'text-sm font-semibold text-ink', children: PsTableConfig.noMatchesTitle }), _jsx("button", { className: 'ps-focus-ring mt-2 rounded-full px-3 py-1.5 text-sm font-semibold text-primary', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] })) : null) })) : null, _jsx("div", { className: PallasoftClassNameService.merge('ps-scrollbar overflow-x-auto', mobileLayout === 'cards' ? 'hidden sm:block' : ''), children: _jsxs("table", { className: 'w-full border-collapse text-left', children: [caption ? _jsx("caption", { className: 'sr-only', children: caption }) : null, _jsx("thead", { className: 'bg-mist/70 text-[0.68rem] font-semibold uppercase tracking-[0.18em] text-ink/45', children: _jsxs("tr", { children: [isSelectable ? (_jsx("th", { className: 'w-10 pl-4 pr-0', scope: 'col', children: _jsx(PsCheckbox, { isIndeterminate: !isPageSelected && pageIds.some((rowId) => selectedIds.includes(rowId)), isSelected: isPageSelected, label: 'Select all rows on this page', onChange: togglePage }) })) : null, visibleColumns.map((column) => {
105
180
  const align = column.align !== null && column.align !== undefined ? column.align : 'left';
106
181
  const isSorted = sort !== null && sort.columnId === column.id;
107
182
  return (_jsx("th", { "aria-sort": isSorted
@@ -109,25 +184,16 @@ export const PsDataTable = ({ caption, className, columns, defaultSort, density
109
184
  : column.sortValue && !isServerPaginated
110
185
  ? 'none'
111
186
  : undefined, className: PallasoftClassNameService.merge(densityClassNames[density].head, alignClassNames[align], 'whitespace-nowrap'), scope: 'col', style: columnStyle(column), children: column.sortValue && !isServerPaginated ? (_jsx(PsTableSortHeader, { align: align, columnId: column.id, label: column.label, onSort: updateSort, sort: sort })) : (column.label) }, column.id));
112
- })] }) }), _jsxs("tbody", { className: 'divide-y divide-line', children: [visibleRows.length === 0 && isQueried ? (_jsx("tr", { children: _jsxs("td", { className: 'px-4 py-12 text-center', colSpan: columnCount, children: [_jsx("p", { className: 'text-sm font-semibold text-ink', children: PsTableConfig.noMatchesTitle }), _jsx("p", { className: 'mt-1 text-sm text-ink/55', children: PsTableConfig.noMatchesDescription }), _jsx("button", { className: 'ps-focus-ring mt-3 rounded-full px-3 py-1.5 text-sm font-semibold text-primary hover:underline', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] }) })) : null, visibleRows.map((row) => {
113
- const rowId = getRowId(row);
114
- const isExpanded = expandedRowIds ? expandedRowIds.includes(rowId) : false;
115
- const rowLabel = getRowLabel ? getRowLabel(row) : rowId;
116
- return (_jsxs(Fragment, { children: [_jsxs("tr", { "aria-expanded": renderExpandedRow ? isExpanded : undefined, "aria-label": onRowClick ? rowLabel : undefined, className: PallasoftClassNameService.merge('align-middle transition-colors', onRowClick
117
- ? 'ps-focus-ring cursor-pointer hover:bg-mist/60'
118
- : 'hover:bg-mist/40', isExpanded ? 'bg-mist/40' : ''), onClick: onRowClick ? () => onRowClick(row) : undefined, onFocus: onRowHover ? () => onRowHover(row) : undefined, onPointerEnter: onRowHover ? () => onRowHover(row) : undefined, onKeyDown: onRowClick
119
- ? (event) => {
120
- if (event.target !== event.currentTarget)
121
- return;
122
- if (event.key !== 'Enter' && event.key !== ' ')
123
- return;
124
- event.preventDefault();
125
- onRowClick(row);
126
- }
127
- : undefined, tabIndex: onRowClick ? 0 : undefined, children: [isSelectable ? (_jsx("td", { className: 'w-10 pl-4 pr-0', onClick: (event) => event.stopPropagation(), onKeyDown: (event) => event.stopPropagation(), children: _jsx(PsCheckbox, { isSelected: selectedIds.includes(rowId), label: `Select ${rowLabel}`, onChange: () => toggleRow(rowId) }) })) : null, visibleColumns.map((column) => (_jsx("td", { className: PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
128
- ? column.align
129
- : 'left'], column.wrap ? '' : 'whitespace-nowrap', 'text-sm text-ink'), style: columnStyle(column), children: column.render(row) }, column.id)))] }), renderExpandedRow && isExpanded ? (_jsx("tr", { className: 'border-t-0', children: _jsx("td", { className: 'p-0', colSpan: columnCount, children: _jsx(PsCollapse, { isOpen: true, children: _jsx("div", { className: 'w-0 min-w-full border-l-2 border-primary bg-mist/40 px-4 py-4', children: renderExpandedRow(row) }) }) }) })) : null] }, rowId));
130
- })] }), hasFooter ? (_jsx("tfoot", { className: 'border-t-2 border-line bg-mist/50 text-sm font-semibold text-ink', children: _jsxs("tr", { children: [isSelectable ? _jsx("td", {}) : null, visibleColumns.map((column) => (_jsx("td", { className: PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
187
+ })] }) }), _jsxs("tbody", { className: 'divide-y divide-line', children: [visibleRows.length === 0 && isQueried ? (_jsx("tr", { children: _jsxs("td", { className: 'px-4 py-12 text-center', colSpan: columnCount, children: [_jsx("p", { className: 'text-sm font-semibold text-ink', children: PsTableConfig.noMatchesTitle }), _jsx("p", { className: 'mt-1 text-sm text-ink/55', children: PsTableConfig.noMatchesDescription }), _jsx("button", { className: 'ps-focus-ring mt-3 rounded-full px-3 py-1.5 text-sm font-semibold text-primary hover:underline', onClick: clearFilters, type: 'button', children: "Clear search and filters" })] }) })) : null, grouping
188
+ ? groups.map((group, groupIndex) => {
189
+ const isExpanded = isGroupExpanded(group.key, groupIndex);
190
+ return (_jsxs(Fragment, { children: [_jsx("tr", { children: _jsx("td", { className: 'p-0', colSpan: columnCount, children: _jsx(PsTableGroupHeader, { count: group.rows.length, isExpanded: isExpanded, label: grouping.getGroupLabel(group.key, group.rows), onToggle: () => toggleGroup(group.key, isExpanded), summary: grouping.renderGroupSummary
191
+ ? grouping.renderGroupSummary(group.rows)
192
+ : undefined }) }) }), isExpanded
193
+ ? group.rows.map((row, rowIndex) => renderRow(row, groupRowMotion(group.key, rowIndex)))
194
+ : null] }, `group-${group.key}`));
195
+ })
196
+ : visibleRows.map((row) => renderRow(row))] }), hasFooter ? (_jsx("tfoot", { className: 'border-t-2 border-line bg-mist/50 text-sm font-semibold text-ink', children: _jsxs("tr", { children: [isSelectable ? _jsx("td", {}) : null, visibleColumns.map((column) => (_jsx("td", { className: PallasoftClassNameService.merge(densityClassNames[density].cell, alignClassNames[column.align !== null && column.align !== undefined
131
197
  ? column.align
132
- : 'left'], 'whitespace-nowrap'), children: column.footer }, column.id)))] }) })) : null] }) }), pageSize ? (_jsx(PsTablePagination, { onPageChange: changePage, page: safePage, pageCount: pageCount, pageSize: pageSize, totalRows: rowCount })) : null] })] }));
198
+ : 'left'], 'whitespace-nowrap'), children: column.footer }, column.id)))] }) })) : null] }) }), pageSize && !grouping ? (_jsx(PsTablePagination, { onPageChange: changePage, page: safePage, pageCount: pageCount, pageSize: pageSize, totalRows: rowCount })) : null] })] }));
133
199
  };
@@ -1,3 +1,9 @@
1
- import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
3
- export const PsTableBulkBar = ({ actions, onClear, selectedCount }) => (_jsxs("div", { "aria-live": 'polite', className: 'flex flex-wrap items-center gap-1 rounded-2xl border border-primary/30 bg-primary/10 px-2 py-1.5 sm:gap-2 sm:rounded-full', children: [_jsxs("span", { className: 'px-2 text-sm font-semibold text-ink', children: [selectedCount, " selected"] }), actions.map((action) => (_jsx("button", { className: PallasoftClassNameService.merge('ps-focus-ring inline-flex min-h-8 items-center rounded-full px-3 text-sm font-semibold transition-colors disabled:opacity-40', action.isDanger ? 'text-danger hover:bg-danger/10' : 'text-ink hover:bg-ink/5'), disabled: action.isDisabled, onClick: action.onSelect, type: 'button', children: action.label }, action.id))), _jsx("button", { className: 'ps-focus-ring ml-auto inline-flex min-h-8 items-center rounded-full px-3 text-sm font-semibold text-ink/65 hover:text-ink', onClick: onClear, type: 'button', children: "Clear selection" })] }));
3
+ import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
4
+ export const PsTableBulkBar = ({ actions, onClear, selectedCount }) => {
5
+ const safeActions = actions.filter((action) => !action.isDanger);
6
+ const dangerActions = actions.filter((action) => action.isDanger);
7
+ const renderAction = (action) => (_jsx("button", { className: PallasoftClassNameService.merge('ps-focus-ring inline-flex min-h-9 shrink-0 items-center whitespace-nowrap rounded-full px-3 text-sm font-semibold transition-colors disabled:opacity-40', action.isDanger ? 'text-danger hover:bg-danger/10' : 'text-ink hover:bg-ink/5'), disabled: action.isDisabled, onClick: action.onSelect, type: 'button', children: action.label }, action.id));
8
+ return (_jsxs("div", { "aria-live": 'polite', className: 'flex min-h-12 items-center gap-2 rounded-2xl border border-primary/30 bg-primary/10 py-1.5 pl-2 pr-1.5', children: [_jsxs("span", { className: 'inline-flex min-h-9 shrink-0 items-center rounded-full bg-primary px-3 text-sm font-semibold tabular-nums text-white', children: [selectedCount, " selected"] }), _jsxs("div", { className: 'ps-scrollbar-hidden flex min-w-0 flex-1 items-center gap-1 overflow-x-auto', children: [safeActions.map(renderAction), dangerActions.length > 0 && safeActions.length > 0 ? (_jsx("span", { "aria-hidden": 'true', className: 'mx-1 h-5 w-px shrink-0 bg-line' })) : null, dangerActions.map(renderAction)] }), _jsx("button", { "aria-label": 'Clear selection', className: 'ps-focus-ring inline-flex h-9 w-9 shrink-0 items-center justify-center rounded-full text-ink/60 transition-colors hover:bg-ink/5 hover:text-ink', onClick: onClear, title: 'Clear selection', type: 'button', children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'h-4 w-4', iconKey: PsIconKey.Close }) })] }));
9
+ };
@@ -0,0 +1,4 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
3
+ import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
4
+ export const PsTableGroupHeader = ({ count, isExpanded, label, onToggle, summary, }) => (_jsxs("button", { "aria-expanded": isExpanded, className: 'ps-focus-ring flex w-full flex-wrap items-center gap-x-3 gap-y-2 bg-mist/60 px-4 py-3 text-left transition-colors hover:bg-mist', onClick: onToggle, type: 'button', children: [_jsx(PsIcon, { "aria-hidden": 'true', className: PallasoftClassNameService.merge('h-4 w-4 shrink-0 text-ink/50 transition-transform duration-200', isExpanded ? '' : '-rotate-90'), iconKey: PsIconKey.Chevron }), _jsx("span", { className: 'text-sm font-semibold text-ink', children: label }), _jsx("span", { className: 'rounded-full bg-surface px-2 py-0.5 text-xs font-semibold tabular-nums text-ink/60', children: count }), summary ? (_jsx("span", { className: 'ml-auto flex flex-wrap items-center justify-end gap-2', children: summary })) : null] }));
@@ -1,4 +1,7 @@
1
1
  export const PsTableConfig = {
2
+ groupCloseMs: 160,
3
+ groupRowStaggerMs: 16,
4
+ groupStaggerLimit: 12,
2
5
  noMatchesDescription: 'Try a different search or clear the filters.',
3
6
  noMatchesTitle: 'Nothing matches',
4
7
  searchPlaceholder: 'Search',
package/dist/esm/index.js CHANGED
@@ -1,4 +1,5 @@
1
1
  export * from './components/ps-data-table';
2
+ export * from './components/ps-table-group-header';
2
3
  export * from './components/ps-table-pagination';
3
4
  export * from './constants/table-card-role';
4
5
  export * from './constants/table-filter-kind';
@@ -6,8 +7,11 @@ export * from './interfaces/table-column';
6
7
  export * from './interfaces/table-column-filter';
7
8
  export * from './interfaces/table-filter-option';
8
9
  export * from './interfaces/table-filter-value';
10
+ export * from './interfaces/table-grouping';
9
11
  export * from './interfaces/table-query';
10
12
  export * from './interfaces/table-row-action';
13
+ export * from './interfaces/table-row-group';
11
14
  export * from './interfaces/table-sort';
15
+ export * from './services/ps-table-group-service';
12
16
  export * from './services/ps-table-query-service';
13
17
  export * from './services/ps-table-search-service';
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,14 @@
1
+ export class PsTableGroupService {
2
+ static group(rows, getGroupKey) {
3
+ const groups = new Map();
4
+ for (const row of rows) {
5
+ const key = getGroupKey(row);
6
+ const existing = groups.get(key);
7
+ if (existing)
8
+ existing.push(row);
9
+ else
10
+ groups.set(key, [row]);
11
+ }
12
+ return [...groups.entries()].map(([key, groupRows]) => ({ key, rows: groupRows }));
13
+ }
14
+ }
package/dist/index.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  export * from './components/ps-data-table';
2
+ export * from './components/ps-table-group-header';
2
3
  export * from './components/ps-table-pagination';
3
4
  export * from './constants/table-card-role';
4
5
  export * from './constants/table-filter-kind';
@@ -6,8 +7,11 @@ export * from './interfaces/table-column';
6
7
  export * from './interfaces/table-column-filter';
7
8
  export * from './interfaces/table-filter-option';
8
9
  export * from './interfaces/table-filter-value';
10
+ export * from './interfaces/table-grouping';
9
11
  export * from './interfaces/table-query';
10
12
  export * from './interfaces/table-row-action';
13
+ export * from './interfaces/table-row-group';
11
14
  export * from './interfaces/table-sort';
15
+ export * from './services/ps-table-group-service';
12
16
  export * from './services/ps-table-query-service';
13
17
  export * from './services/ps-table-search-service';
package/dist/index.js CHANGED
@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./components/ps-data-table"), exports);
18
+ __exportStar(require("./components/ps-table-group-header"), exports);
18
19
  __exportStar(require("./components/ps-table-pagination"), exports);
19
20
  __exportStar(require("./constants/table-card-role"), exports);
20
21
  __exportStar(require("./constants/table-filter-kind"), exports);
@@ -22,8 +23,11 @@ __exportStar(require("./interfaces/table-column"), exports);
22
23
  __exportStar(require("./interfaces/table-column-filter"), exports);
23
24
  __exportStar(require("./interfaces/table-filter-option"), exports);
24
25
  __exportStar(require("./interfaces/table-filter-value"), exports);
26
+ __exportStar(require("./interfaces/table-grouping"), exports);
25
27
  __exportStar(require("./interfaces/table-query"), exports);
26
28
  __exportStar(require("./interfaces/table-row-action"), exports);
29
+ __exportStar(require("./interfaces/table-row-group"), exports);
27
30
  __exportStar(require("./interfaces/table-sort"), exports);
31
+ __exportStar(require("./services/ps-table-group-service"), exports);
28
32
  __exportStar(require("./services/ps-table-query-service"), exports);
29
33
  __exportStar(require("./services/ps-table-search-service"), exports);
@@ -0,0 +1,7 @@
1
+ import type { ReactNode } from 'react';
2
+ export interface PsTableGrouping<RowData> {
3
+ getGroupKey: (row: RowData) => string;
4
+ getGroupLabel: (groupKey: string, rows: RowData[]) => string;
5
+ initialExpandedCount?: number;
6
+ renderGroupSummary?: (rows: RowData[]) => ReactNode;
7
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,4 @@
1
+ export interface PsTableRowGroup<RowData> {
2
+ key: string;
3
+ rows: RowData[];
4
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,4 @@
1
+ export interface PsTableRowMotion {
2
+ className: string;
3
+ delayMs?: number;
4
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,4 @@
1
+ import type { PsTableRowGroup } from '../interfaces/table-row-group';
2
+ export declare class PsTableGroupService {
3
+ static group<RowData>(rows: RowData[], getGroupKey: (row: RowData) => string): PsTableRowGroup<RowData>[];
4
+ }
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PsTableGroupService = void 0;
4
+ class PsTableGroupService {
5
+ static group(rows, getGroupKey) {
6
+ const groups = new Map();
7
+ for (const row of rows) {
8
+ const key = getGroupKey(row);
9
+ const existing = groups.get(key);
10
+ if (existing)
11
+ existing.push(row);
12
+ else
13
+ groups.set(key, [row]);
14
+ }
15
+ return [...groups.entries()].map(([key, groupRows]) => ({ key, rows: groupRows }));
16
+ }
17
+ }
18
+ exports.PsTableGroupService = PsTableGroupService;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pallasoft/ps-table-components",
3
- "version": "1.9.0",
3
+ "version": "1.10.0",
4
4
  "private": false,
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/esm/index.js",