@cloud-ru/ds-table 2.2.12-preview-f18129b6.0 → 2.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -0
- package/README.md +334 -27
- package/dist/cjs/components/ServerTable/ServerTable.js +1 -1
- package/dist/cjs/components/Table/Table.d.ts +1 -1
- package/dist/cjs/components/Table/Table.js +3 -9
- package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +1 -2
- package/dist/cjs/components/Table/hooks/useTableInstance.js +1 -2
- package/dist/cjs/components/Table/styles.module.css +0 -1
- package/dist/cjs/components/types.d.ts +3 -6
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
- package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
- package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +1 -2
- package/dist/cjs/helperComponents/TableEmptyState/hooks.js +2 -5
- package/dist/cjs/helperComponents/TablePagination/TablePagination.js +7 -31
- package/dist/cjs/helperComponents/TablePagination/styles.module.css +0 -8
- package/dist/cjs/hooks/useCellSizes.js +2 -4
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/cjs/locale/index.d.ts +8 -28
- package/dist/cjs/locale/index.js +4 -14
- package/dist/cjs/presets/adminTable/AdminTable.d.ts +4 -0
- package/dist/cjs/presets/adminTable/AdminTable.js +11 -0
- package/dist/cjs/presets/adminTable/index.d.ts +4 -0
- package/dist/cjs/presets/adminTable/index.js +9 -0
- package/dist/cjs/presets/adminTable/toAdminTableProps.d.ts +31 -0
- package/dist/cjs/presets/adminTable/toAdminTableProps.js +57 -0
- package/dist/cjs/presets/adminTable/useAdminTableProps.d.ts +5 -0
- package/dist/cjs/presets/adminTable/useAdminTableProps.js +25 -0
- package/dist/cjs/presets/index.d.ts +3 -0
- package/dist/cjs/presets/index.js +3 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +11 -0
- package/dist/cjs/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/index.js +9 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +11 -0
- package/dist/cjs/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/index.js +9 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +21 -0
- package/dist/cjs/presets/simpleTable/SimpleTable.d.ts +1 -1
- package/dist/cjs/presets/simpleTable/SimpleTable.js +1 -1
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +6 -6
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/cjs/presets/treeTable/toTreeTableProps.js +3 -2
- package/dist/cjs/style.css +0 -12
- package/dist/esm/components/ServerTable/ServerTable.js +1 -1
- package/dist/esm/components/Table/Table.d.ts +1 -1
- package/dist/esm/components/Table/Table.js +3 -9
- package/dist/esm/components/Table/hooks/useTableInstance.d.ts +1 -2
- package/dist/esm/components/Table/hooks/useTableInstance.js +1 -2
- package/dist/esm/components/Table/styles.module.css +0 -1
- package/dist/esm/components/types.d.ts +3 -6
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
- package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
- package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +1 -2
- package/dist/esm/helperComponents/TableEmptyState/hooks.js +2 -5
- package/dist/esm/helperComponents/TablePagination/TablePagination.js +7 -31
- package/dist/esm/helperComponents/TablePagination/styles.module.css +0 -8
- package/dist/esm/hooks/useCellSizes.js +3 -5
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/esm/locale/index.d.ts +8 -28
- package/dist/esm/locale/index.js +4 -14
- package/dist/esm/presets/adminTable/AdminTable.d.ts +4 -0
- package/dist/esm/presets/adminTable/AdminTable.js +8 -0
- package/dist/esm/presets/adminTable/index.d.ts +4 -0
- package/dist/esm/presets/adminTable/index.js +3 -0
- package/dist/esm/presets/adminTable/toAdminTableProps.d.ts +31 -0
- package/dist/esm/presets/adminTable/toAdminTableProps.js +54 -0
- package/dist/esm/presets/adminTable/useAdminTableProps.d.ts +5 -0
- package/dist/esm/presets/adminTable/useAdminTableProps.js +22 -0
- package/dist/esm/presets/index.d.ts +3 -0
- package/dist/esm/presets/index.js +3 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +8 -0
- package/dist/esm/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/index.js +3 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +8 -0
- package/dist/esm/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/index.js +3 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +18 -0
- package/dist/esm/presets/simpleTable/SimpleTable.d.ts +1 -1
- package/dist/esm/presets/simpleTable/SimpleTable.js +1 -1
- package/dist/esm/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
- package/dist/esm/presets/simpleTable/toSimpleTableProps.js +7 -7
- package/dist/esm/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/esm/presets/treeTable/toTreeTableProps.js +4 -3
- package/dist/esm/style.css +0 -12
- package/dist/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +20 -20
- package/src/components/ServerTable/ServerTable.tsx +0 -1
- package/src/components/Table/STRUCTURE.md +6 -12
- package/src/components/Table/Table.tsx +2 -9
- package/src/components/Table/hooks/useTableInstance.tsx +0 -3
- package/src/components/Table/styles.module.scss +3 -2
- package/src/components/types.ts +3 -6
- package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +3 -1
- package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +0 -2
- package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +0 -3
- package/src/helperComponents/TableEmptyState/{hooks.tsx → hooks.ts} +1 -7
- package/src/helperComponents/TablePagination/TablePagination.tsx +10 -80
- package/src/helperComponents/TablePagination/styles.module.scss +0 -9
- package/src/hooks/useCellSizes.ts +3 -5
- package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +0 -1
- package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +0 -2
- package/src/locale/index.ts +4 -14
- package/src/presets/adminTable/AdminTable.tsx +14 -0
- package/src/presets/adminTable/index.ts +4 -0
- package/src/presets/adminTable/toAdminTableProps.ts +140 -0
- package/src/presets/adminTable/useAdminTableProps.ts +35 -0
- package/src/presets/index.ts +3 -0
- package/src/presets/serverAdminTable/ServerAdminTable.tsx +14 -0
- package/src/presets/serverAdminTable/index.ts +4 -0
- package/src/presets/serverAdminTable/toServerAdminTableProps.ts +44 -0
- package/src/presets/serverAdminTable/useServerAdminTableProps.ts +35 -0
- package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +10 -0
- package/src/presets/serverSimpleTable/index.ts +4 -0
- package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +56 -0
- package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +27 -0
- package/src/presets/simpleTable/SimpleTable.tsx +1 -1
- package/src/presets/simpleTable/toSimpleTableProps.ts +30 -35
- package/src/presets/simpleTable/useSimpleTableProps.ts +5 -1
- package/src/presets/treeTable/toTreeTableProps.ts +23 -24
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2
|
+
import { FilterRow } from '@cloud-ru/ds-toolbar';
|
|
3
|
+
import { RowSelectionState } from '@tanstack/react-table';
|
|
4
|
+
|
|
5
|
+
import {
|
|
6
|
+
actionsColumn,
|
|
7
|
+
CardViewInput,
|
|
8
|
+
defineColumns,
|
|
9
|
+
mapCardViewProps,
|
|
10
|
+
RowActionsConfig,
|
|
11
|
+
SimpleColumnDef,
|
|
12
|
+
statusColumn,
|
|
13
|
+
StatusColumnConfig,
|
|
14
|
+
} from '../../columnUtils';
|
|
15
|
+
import { ClientTableProps } from '../../components/types';
|
|
16
|
+
import { DEFAULT_PRESET_PAGE_SIZE, DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
17
|
+
import { wrapGetRowId } from '../wrapGetRowId';
|
|
18
|
+
|
|
19
|
+
type AdminTableSearchConfig = {
|
|
20
|
+
placeholder?: string;
|
|
21
|
+
onChange?: (value: string) => void;
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
type AdminTableSelectionConfig = {
|
|
25
|
+
multiRow?: boolean;
|
|
26
|
+
bulkActions?: ClientTableProps<object>['bulkActions'];
|
|
27
|
+
onChange?: (state: RowSelectionState) => void;
|
|
28
|
+
state?: RowSelectionState;
|
|
29
|
+
initialState?: RowSelectionState;
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
/** Входные пропсы `AdminTable` / `useAdminTableProps` */
|
|
33
|
+
export type AdminTableInput<
|
|
34
|
+
TData extends object,
|
|
35
|
+
TFilters extends FiltersState = Record<string, unknown>,
|
|
36
|
+
> = CardViewInput<TData> & {
|
|
37
|
+
data: TData[];
|
|
38
|
+
columns: SimpleColumnDef<TData>[];
|
|
39
|
+
statusColumn?: StatusColumnConfig<TData>;
|
|
40
|
+
rowActions?: RowActionsConfig<TData>;
|
|
41
|
+
filters?: FilterRow<TFilters>;
|
|
42
|
+
selection?: AdminTableSelectionConfig;
|
|
43
|
+
search?: boolean | AdminTableSearchConfig;
|
|
44
|
+
pageSize?: number;
|
|
45
|
+
getRowId: (row: TData) => string;
|
|
46
|
+
} & Omit<
|
|
47
|
+
ClientTableProps<TData, TFilters>,
|
|
48
|
+
| 'data'
|
|
49
|
+
| 'columnDefinitions'
|
|
50
|
+
| 'getRowId'
|
|
51
|
+
| 'headlineId'
|
|
52
|
+
| 'search'
|
|
53
|
+
| 'suppressSearch'
|
|
54
|
+
| 'columnFilters'
|
|
55
|
+
| 'rowSelection'
|
|
56
|
+
| 'bulkActions'
|
|
57
|
+
>;
|
|
58
|
+
|
|
59
|
+
function mapSearchProps(search?: boolean | AdminTableSearchConfig) {
|
|
60
|
+
if (search === false) {
|
|
61
|
+
return { suppressSearch: true as const };
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
if (search === true || search === undefined) {
|
|
65
|
+
return {};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
return {
|
|
69
|
+
search: {
|
|
70
|
+
placeholder: search.placeholder,
|
|
71
|
+
onChange: search.onChange,
|
|
72
|
+
},
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function buildColumnDefinitions<TData extends object>({
|
|
77
|
+
statusColumn: statusColumnConfig,
|
|
78
|
+
columns,
|
|
79
|
+
rowActions,
|
|
80
|
+
}: Pick<AdminTableInput<TData>, 'statusColumn' | 'columns' | 'rowActions'>) {
|
|
81
|
+
return [
|
|
82
|
+
...(statusColumnConfig ? [statusColumn(statusColumnConfig)] : []),
|
|
83
|
+
...defineColumns(columns),
|
|
84
|
+
...(rowActions ? [actionsColumn(rowActions)] : []),
|
|
85
|
+
];
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** Маппинг упрощённых пропсов в `ClientTableProps` для `Table` */
|
|
89
|
+
export function toAdminTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>>(
|
|
90
|
+
input: AdminTableInput<TData, TFilters>,
|
|
91
|
+
): ClientTableProps<TData, TFilters> {
|
|
92
|
+
const {
|
|
93
|
+
data,
|
|
94
|
+
columns,
|
|
95
|
+
statusColumn: statusColumnConfig,
|
|
96
|
+
rowActions,
|
|
97
|
+
filters,
|
|
98
|
+
selection,
|
|
99
|
+
search,
|
|
100
|
+
pageSize = DEFAULT_PRESET_PAGE_SIZE,
|
|
101
|
+
getRowId,
|
|
102
|
+
headlineKey,
|
|
103
|
+
defaultView,
|
|
104
|
+
view,
|
|
105
|
+
onViewChange,
|
|
106
|
+
renderCard,
|
|
107
|
+
outline,
|
|
108
|
+
pagination,
|
|
109
|
+
columnsSettings,
|
|
110
|
+
onRefresh,
|
|
111
|
+
...rest
|
|
112
|
+
} = input;
|
|
113
|
+
|
|
114
|
+
return {
|
|
115
|
+
...rest,
|
|
116
|
+
...mapCardViewProps({ headlineKey, defaultView, view, onViewChange, renderCard }),
|
|
117
|
+
...mapSearchProps(search),
|
|
118
|
+
data,
|
|
119
|
+
columnDefinitions: buildColumnDefinitions({ statusColumn: statusColumnConfig, columns, rowActions }),
|
|
120
|
+
outline: outline ?? true,
|
|
121
|
+
pageSize,
|
|
122
|
+
pagination: pagination ?? { options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] },
|
|
123
|
+
getRowId: wrapGetRowId(getRowId),
|
|
124
|
+
onRefresh,
|
|
125
|
+
columnsSettings: columnsSettings ?? { enableSettingsMenu: true },
|
|
126
|
+
...(filters ? { columnFilters: filters } : {}),
|
|
127
|
+
...(selection
|
|
128
|
+
? {
|
|
129
|
+
rowSelection: {
|
|
130
|
+
enable: true,
|
|
131
|
+
multiRow: selection.multiRow ?? true,
|
|
132
|
+
onChange: selection.onChange,
|
|
133
|
+
state: selection.state,
|
|
134
|
+
initialState: selection.initialState,
|
|
135
|
+
},
|
|
136
|
+
bulkActions: selection.bulkActions,
|
|
137
|
+
}
|
|
138
|
+
: {}),
|
|
139
|
+
};
|
|
140
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2
|
+
import { useMemo } from 'react';
|
|
3
|
+
|
|
4
|
+
import { actionsColumn, defineColumns, statusColumn } from '../../columnUtils';
|
|
5
|
+
import { ClientTableProps } from '../../components/types';
|
|
6
|
+
import { DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
7
|
+
import { wrapGetRowId } from '../wrapGetRowId';
|
|
8
|
+
import { AdminTableInput, toAdminTableProps } from './toAdminTableProps';
|
|
9
|
+
|
|
10
|
+
/** Возвращает готовые пропсы для `Table` из упрощённого API `AdminTable` */
|
|
11
|
+
export function useAdminTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>>(
|
|
12
|
+
input: AdminTableInput<TData, TFilters>,
|
|
13
|
+
): ClientTableProps<TData, TFilters> {
|
|
14
|
+
const { columns, statusColumn: statusColumnConfig, rowActions, getRowId, pagination } = input;
|
|
15
|
+
|
|
16
|
+
const columnDefinitions = useMemo(
|
|
17
|
+
() => [
|
|
18
|
+
...(statusColumnConfig ? [statusColumn(statusColumnConfig)] : []),
|
|
19
|
+
...defineColumns(columns),
|
|
20
|
+
...(rowActions ? [actionsColumn(rowActions)] : []),
|
|
21
|
+
],
|
|
22
|
+
[statusColumnConfig, columns, rowActions],
|
|
23
|
+
);
|
|
24
|
+
|
|
25
|
+
const wrappedGetRowId = useMemo(() => wrapGetRowId(getRowId), [getRowId]);
|
|
26
|
+
|
|
27
|
+
const defaultPagination = useMemo(() => ({ options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] }), []);
|
|
28
|
+
|
|
29
|
+
return {
|
|
30
|
+
...toAdminTableProps(input),
|
|
31
|
+
columnDefinitions,
|
|
32
|
+
getRowId: wrappedGetRowId,
|
|
33
|
+
pagination: pagination ?? defaultPagination,
|
|
34
|
+
};
|
|
35
|
+
}
|
package/src/presets/index.ts
CHANGED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2
|
+
|
|
3
|
+
import { ServerTable } from '../../components/ServerTable';
|
|
4
|
+
import { ServerAdminTableInput } from './toServerAdminTableProps';
|
|
5
|
+
import { useServerAdminTableProps } from './useServerAdminTableProps';
|
|
6
|
+
|
|
7
|
+
/** Серверная админ-таблица: поиск, фильтры, выбор строк, статус и действия */
|
|
8
|
+
export function ServerAdminTable<TData extends object, TFilters extends FiltersState = Record<string, unknown>>(
|
|
9
|
+
props: ServerAdminTableInput<TData, TFilters>,
|
|
10
|
+
) {
|
|
11
|
+
const tableProps = useServerAdminTableProps(props);
|
|
12
|
+
|
|
13
|
+
return <ServerTable {...tableProps} />;
|
|
14
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2
|
+
|
|
3
|
+
import { ServerTableProps } from '../../components/types';
|
|
4
|
+
import { AdminTableInput, toAdminTableProps } from '../adminTable/toAdminTableProps';
|
|
5
|
+
import { DEFAULT_PRESET_PAGE_SIZE, DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
6
|
+
|
|
7
|
+
/** Входные пропсы `ServerAdminTable` / `useServerAdminTableProps` */
|
|
8
|
+
export type ServerAdminTableInput<TData extends object, TFilters extends FiltersState = Record<string, unknown>> = Omit<
|
|
9
|
+
AdminTableInput<TData, TFilters>,
|
|
10
|
+
'data' | 'search'
|
|
11
|
+
> & {
|
|
12
|
+
items?: TData[];
|
|
13
|
+
pageSize?: number;
|
|
14
|
+
limit?: number;
|
|
15
|
+
onChangePage(offset: number, limit: number): void;
|
|
16
|
+
search: NonNullable<ServerTableProps<TData, TFilters>['search']>;
|
|
17
|
+
} & Omit<
|
|
18
|
+
ServerTableProps<TData, TFilters>,
|
|
19
|
+
'items' | 'columnDefinitions' | 'getRowId' | 'headlineId' | 'search' | 'onChangePage' | 'limit'
|
|
20
|
+
>;
|
|
21
|
+
|
|
22
|
+
/** Маппинг упрощённых пропсов в `ServerTableProps` */
|
|
23
|
+
export function toServerAdminTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>>(
|
|
24
|
+
input: ServerAdminTableInput<TData, TFilters>,
|
|
25
|
+
): ServerTableProps<TData, TFilters> {
|
|
26
|
+
const { items, onChangePage, search, pageSize, limit, ...adminInput } = input;
|
|
27
|
+
const pageLimit = limit ?? pageSize ?? DEFAULT_PRESET_PAGE_SIZE;
|
|
28
|
+
const clientProps = toAdminTableProps({ ...adminInput, data: items ?? [], pageSize: pageLimit, search: false });
|
|
29
|
+
// eslint-disable-next-line @typescript-eslint/no-unused-vars -- strip client-only fields
|
|
30
|
+
const { data, search: clientSearch, suppressSearch, pagination, ...rest } = clientProps;
|
|
31
|
+
|
|
32
|
+
return {
|
|
33
|
+
...rest,
|
|
34
|
+
items,
|
|
35
|
+
onChangePage,
|
|
36
|
+
search,
|
|
37
|
+
limit: pageLimit,
|
|
38
|
+
pagination: pagination ?? { options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] },
|
|
39
|
+
manualSorting: true,
|
|
40
|
+
manualPagination: true,
|
|
41
|
+
manualFiltering: true,
|
|
42
|
+
...(suppressSearch ? { suppressSearch } : {}),
|
|
43
|
+
};
|
|
44
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2
|
+
import { useMemo } from 'react';
|
|
3
|
+
|
|
4
|
+
import { actionsColumn, defineColumns, statusColumn } from '../../columnUtils';
|
|
5
|
+
import { ServerTableProps } from '../../components/types';
|
|
6
|
+
import { DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
7
|
+
import { wrapGetRowId } from '../wrapGetRowId';
|
|
8
|
+
import { ServerAdminTableInput, toServerAdminTableProps } from './toServerAdminTableProps';
|
|
9
|
+
|
|
10
|
+
/** Возвращает готовые пропсы для `ServerTable` из упрощённого API `ServerAdminTable` */
|
|
11
|
+
export function useServerAdminTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>>(
|
|
12
|
+
input: ServerAdminTableInput<TData, TFilters>,
|
|
13
|
+
): ServerTableProps<TData, TFilters> {
|
|
14
|
+
const { columns, statusColumn: statusColumnConfig, rowActions, getRowId, pagination } = input;
|
|
15
|
+
|
|
16
|
+
const columnDefinitions = useMemo(
|
|
17
|
+
() => [
|
|
18
|
+
...(statusColumnConfig ? [statusColumn(statusColumnConfig)] : []),
|
|
19
|
+
...defineColumns(columns),
|
|
20
|
+
...(rowActions ? [actionsColumn(rowActions)] : []),
|
|
21
|
+
],
|
|
22
|
+
[statusColumnConfig, columns, rowActions],
|
|
23
|
+
);
|
|
24
|
+
|
|
25
|
+
const wrappedGetRowId = useMemo(() => wrapGetRowId(getRowId), [getRowId]);
|
|
26
|
+
|
|
27
|
+
const defaultPagination = useMemo(() => ({ options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] }), []);
|
|
28
|
+
|
|
29
|
+
return {
|
|
30
|
+
...toServerAdminTableProps(input),
|
|
31
|
+
columnDefinitions,
|
|
32
|
+
getRowId: wrappedGetRowId,
|
|
33
|
+
pagination: pagination ?? defaultPagination,
|
|
34
|
+
};
|
|
35
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { ServerTable } from '../../components/ServerTable';
|
|
2
|
+
import { ServerSimpleTableInput } from './toServerSimpleTableProps';
|
|
3
|
+
import { useServerSimpleTableProps } from './useServerSimpleTableProps';
|
|
4
|
+
|
|
5
|
+
/** Минимальная серверная таблица: items, колонки, пагинация с бэкенда */
|
|
6
|
+
export function ServerSimpleTable<TData extends object>(props: ServerSimpleTableInput<TData>) {
|
|
7
|
+
const tableProps = useServerSimpleTableProps(props);
|
|
8
|
+
|
|
9
|
+
return <ServerTable {...tableProps} />;
|
|
10
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { ServerSimpleTable } from './ServerSimpleTable';
|
|
2
|
+
export type { ServerSimpleTableInput } from './toServerSimpleTableProps';
|
|
3
|
+
export { toServerSimpleTableProps } from './toServerSimpleTableProps';
|
|
4
|
+
export { useServerSimpleTableProps } from './useServerSimpleTableProps';
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { CardViewInput, defineColumns, mapCardViewProps, SimpleColumnDef } from '../../columnUtils';
|
|
2
|
+
import { ServerTableProps } from '../../components/types';
|
|
3
|
+
import { DEFAULT_PRESET_PAGE_SIZE, DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
4
|
+
import { wrapGetRowId } from '../wrapGetRowId';
|
|
5
|
+
|
|
6
|
+
/** Входные пропсы `ServerSimpleTable` / `useServerSimpleTableProps` */
|
|
7
|
+
export type ServerSimpleTableInput<TData extends object> = CardViewInput<TData> & {
|
|
8
|
+
items?: TData[];
|
|
9
|
+
columns: SimpleColumnDef<TData>[];
|
|
10
|
+
pageSize?: number;
|
|
11
|
+
limit?: number;
|
|
12
|
+
getRowId?: (row: TData) => string;
|
|
13
|
+
onChangePage(offset: number, limit: number): void;
|
|
14
|
+
} & Omit<ServerTableProps<TData>, 'items' | 'columnDefinitions' | 'getRowId' | 'headlineId' | 'limit'>;
|
|
15
|
+
|
|
16
|
+
/** Маппинг упрощённых пропсов в `ServerTableProps` */
|
|
17
|
+
export function toServerSimpleTableProps<TData extends object>(
|
|
18
|
+
input: ServerSimpleTableInput<TData>,
|
|
19
|
+
): ServerTableProps<TData> {
|
|
20
|
+
const {
|
|
21
|
+
items,
|
|
22
|
+
columns,
|
|
23
|
+
pageSize,
|
|
24
|
+
getRowId,
|
|
25
|
+
headlineKey,
|
|
26
|
+
defaultView,
|
|
27
|
+
view,
|
|
28
|
+
onViewChange,
|
|
29
|
+
renderCard,
|
|
30
|
+
onChangePage,
|
|
31
|
+
outline,
|
|
32
|
+
pagination,
|
|
33
|
+
limit,
|
|
34
|
+
manualSorting,
|
|
35
|
+
manualPagination,
|
|
36
|
+
manualFiltering,
|
|
37
|
+
...rest
|
|
38
|
+
} = input;
|
|
39
|
+
|
|
40
|
+
const pageLimit = pageSize ?? limit ?? DEFAULT_PRESET_PAGE_SIZE;
|
|
41
|
+
|
|
42
|
+
return {
|
|
43
|
+
...rest,
|
|
44
|
+
...mapCardViewProps({ headlineKey, defaultView, view, onViewChange, renderCard }),
|
|
45
|
+
items,
|
|
46
|
+
columnDefinitions: defineColumns(columns),
|
|
47
|
+
outline: outline ?? true,
|
|
48
|
+
limit: pageLimit,
|
|
49
|
+
pagination: pagination ?? { options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] },
|
|
50
|
+
getRowId: wrapGetRowId(getRowId),
|
|
51
|
+
onChangePage,
|
|
52
|
+
manualSorting: manualSorting ?? true,
|
|
53
|
+
manualPagination: manualPagination ?? true,
|
|
54
|
+
manualFiltering: manualFiltering ?? true,
|
|
55
|
+
};
|
|
56
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { useMemo } from 'react';
|
|
2
|
+
|
|
3
|
+
import { defineColumns } from '../../columnUtils';
|
|
4
|
+
import { ServerTableProps } from '../../components/types';
|
|
5
|
+
import { DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
6
|
+
import { wrapGetRowId } from '../wrapGetRowId';
|
|
7
|
+
import { ServerSimpleTableInput, toServerSimpleTableProps } from './toServerSimpleTableProps';
|
|
8
|
+
|
|
9
|
+
/** Возвращает готовые пропсы для `ServerTable` из упрощённого API */
|
|
10
|
+
export function useServerSimpleTableProps<TData extends object>(
|
|
11
|
+
input: ServerSimpleTableInput<TData>,
|
|
12
|
+
): ServerTableProps<TData> {
|
|
13
|
+
const { columns, getRowId, pagination } = input;
|
|
14
|
+
|
|
15
|
+
const columnDefinitions = useMemo(() => defineColumns(columns), [columns]);
|
|
16
|
+
|
|
17
|
+
const wrappedGetRowId = useMemo(() => wrapGetRowId(getRowId), [getRowId]);
|
|
18
|
+
|
|
19
|
+
const defaultPagination = useMemo(() => ({ options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] }), []);
|
|
20
|
+
|
|
21
|
+
return {
|
|
22
|
+
...toServerSimpleTableProps(input),
|
|
23
|
+
columnDefinitions,
|
|
24
|
+
getRowId: wrappedGetRowId,
|
|
25
|
+
pagination: pagination ?? defaultPagination,
|
|
26
|
+
};
|
|
27
|
+
}
|
|
@@ -2,7 +2,7 @@ import { Table } from '../../components/Table';
|
|
|
2
2
|
import { SimpleTableInput } from './toSimpleTableProps';
|
|
3
3
|
import { useSimpleTableProps } from './useSimpleTableProps';
|
|
4
4
|
|
|
5
|
-
/**
|
|
5
|
+
/** Минимальная клиентская таблица: данные, колонки, пагинация */
|
|
6
6
|
export function SimpleTable<TData extends object>(props: SimpleTableInput<TData>) {
|
|
7
7
|
const tableProps = useSimpleTableProps(props);
|
|
8
8
|
|
|
@@ -1,51 +1,46 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
import { defineColumns, SimpleColumnDef } from '../../columnUtils';
|
|
1
|
+
import { CardViewInput, defineColumns, mapCardViewProps, SimpleColumnDef } from '../../columnUtils';
|
|
4
2
|
import { ClientTableProps } from '../../components/types';
|
|
3
|
+
import { DEFAULT_PAGE_SIZE } from '../../constants';
|
|
4
|
+
import { DEFAULT_PRESET_PAGE_SIZE, DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
5
5
|
import { wrapGetRowId } from '../wrapGetRowId';
|
|
6
6
|
|
|
7
7
|
/** Входные пропсы `SimpleTable` / `useSimpleTableProps` */
|
|
8
|
-
export type SimpleTableInput<TData extends object> =
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
| 'className'
|
|
19
|
-
| 'outline'
|
|
20
|
-
| 'fullWidth'
|
|
21
|
-
| 'loading'
|
|
22
|
-
| 'dataError'
|
|
23
|
-
| 'noDataState'
|
|
24
|
-
| 'errorDataState'
|
|
25
|
-
| 'onRowClick'
|
|
26
|
-
| 'rowAutoHeight'
|
|
27
|
-
| 'suppressHeader'
|
|
28
|
-
| 'dataFiltered'
|
|
29
|
-
| 'noResultsState'
|
|
30
|
-
| 'onRefresh'
|
|
31
|
-
| 'rowPinning'
|
|
32
|
-
>
|
|
33
|
-
>;
|
|
8
|
+
export type SimpleTableInput<TData extends object> = CardViewInput<TData> & {
|
|
9
|
+
/** Данные для отрисовки */
|
|
10
|
+
data: TData[];
|
|
11
|
+
/** Декларативное описание колонок */
|
|
12
|
+
columns: SimpleColumnDef<TData>[];
|
|
13
|
+
/** Количество строк на страницу @default 10 */
|
|
14
|
+
pageSize?: number;
|
|
15
|
+
/** Стабильный идентификатор строки */
|
|
16
|
+
getRowId?: (row: TData) => string;
|
|
17
|
+
} & Omit<ClientTableProps<TData>, 'data' | 'columnDefinitions' | 'getRowId' | 'headlineId'>;
|
|
34
18
|
|
|
35
19
|
/** Маппинг упрощённых пропсов в `ClientTableProps` для `Table` */
|
|
36
20
|
export function toSimpleTableProps<TData extends object>(input: SimpleTableInput<TData>): ClientTableProps<TData> {
|
|
37
|
-
const {
|
|
21
|
+
const {
|
|
22
|
+
data,
|
|
23
|
+
columns,
|
|
24
|
+
pageSize = DEFAULT_PRESET_PAGE_SIZE,
|
|
25
|
+
getRowId,
|
|
26
|
+
headlineKey,
|
|
27
|
+
defaultView,
|
|
28
|
+
view,
|
|
29
|
+
onViewChange,
|
|
30
|
+
renderCard,
|
|
31
|
+
outline,
|
|
32
|
+
pagination,
|
|
33
|
+
...rest
|
|
34
|
+
} = input;
|
|
38
35
|
|
|
39
36
|
return {
|
|
40
37
|
...rest,
|
|
41
|
-
view
|
|
38
|
+
...mapCardViewProps({ headlineKey, defaultView, view, onViewChange, renderCard }),
|
|
42
39
|
data,
|
|
43
40
|
columnDefinitions: defineColumns(columns),
|
|
44
41
|
outline: outline ?? true,
|
|
45
|
-
pageSize:
|
|
46
|
-
|
|
47
|
-
suppressToolbar: true,
|
|
48
|
-
suppressPagination: true,
|
|
42
|
+
pageSize: pageSize ?? DEFAULT_PAGE_SIZE,
|
|
43
|
+
pagination: pagination ?? { options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] },
|
|
49
44
|
getRowId: wrapGetRowId(getRowId),
|
|
50
45
|
};
|
|
51
46
|
}
|
|
@@ -2,20 +2,24 @@ import { useMemo } from 'react';
|
|
|
2
2
|
|
|
3
3
|
import { defineColumns } from '../../columnUtils';
|
|
4
4
|
import { ClientTableProps } from '../../components/types';
|
|
5
|
+
import { DEFAULT_PRESET_PAGINATION_OPTIONS } from '../constants';
|
|
5
6
|
import { wrapGetRowId } from '../wrapGetRowId';
|
|
6
7
|
import { SimpleTableInput, toSimpleTableProps } from './toSimpleTableProps';
|
|
7
8
|
|
|
8
9
|
/** Возвращает готовые пропсы для `Table` из упрощённого API `SimpleTable` */
|
|
9
10
|
export function useSimpleTableProps<TData extends object>(input: SimpleTableInput<TData>): ClientTableProps<TData> {
|
|
10
|
-
const { columns, getRowId } = input;
|
|
11
|
+
const { columns, getRowId, pagination } = input;
|
|
11
12
|
|
|
12
13
|
const columnDefinitions = useMemo(() => defineColumns(columns), [columns]);
|
|
13
14
|
|
|
14
15
|
const wrappedGetRowId = useMemo(() => wrapGetRowId(getRowId), [getRowId]);
|
|
15
16
|
|
|
17
|
+
const defaultPagination = useMemo(() => ({ options: [...DEFAULT_PRESET_PAGINATION_OPTIONS] }), []);
|
|
18
|
+
|
|
16
19
|
return {
|
|
17
20
|
...toSimpleTableProps(input),
|
|
18
21
|
columnDefinitions,
|
|
19
22
|
getRowId: wrappedGetRowId,
|
|
23
|
+
pagination: pagination ?? defaultPagination,
|
|
20
24
|
};
|
|
21
25
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Row, RowSelectionState } from '@tanstack/react-table';
|
|
2
2
|
|
|
3
|
-
import { defineColumns, SimpleColumnDef } from '../../columnUtils';
|
|
3
|
+
import { CardViewInput, defineColumns, mapCardViewProps, SimpleColumnDef } from '../../columnUtils';
|
|
4
4
|
import { ClientTableProps } from '../../components/types';
|
|
5
5
|
import { ExpandedState } from '../../types';
|
|
6
6
|
import { wrapGetRowId } from '../wrapGetRowId';
|
|
@@ -17,39 +17,33 @@ type TreeTablePrimaryColumn<TData extends object> = {
|
|
|
17
17
|
type TreeTableSelectionConfig<TData extends object> = {
|
|
18
18
|
multiRow?: boolean;
|
|
19
19
|
enable?: boolean | ((row: TData) => boolean);
|
|
20
|
-
onChange
|
|
20
|
+
onChange?: (state: RowSelectionState) => void;
|
|
21
21
|
state?: RowSelectionState;
|
|
22
22
|
initialState?: RowSelectionState;
|
|
23
23
|
};
|
|
24
24
|
|
|
25
25
|
/** Входные пропсы `TreeTable` / `useTreeTableProps` */
|
|
26
|
-
export type TreeTableInput<TData extends object> = {
|
|
26
|
+
export type TreeTableInput<TData extends object> = CardViewInput<TData> & {
|
|
27
27
|
data: TData[];
|
|
28
|
-
getChildren(row: TData)
|
|
28
|
+
getChildren: (row: TData) => TData[] | undefined;
|
|
29
29
|
primaryColumn: TreeTablePrimaryColumn<TData>;
|
|
30
30
|
secondaryColumns?: SimpleColumnDef<TData>[];
|
|
31
31
|
selection?: TreeTableSelectionConfig<TData>;
|
|
32
32
|
expandingInitialState?: ExpandedState;
|
|
33
33
|
expandingState?: ExpandedState;
|
|
34
|
-
onExpandingChange
|
|
35
|
-
getRowId(row: TData)
|
|
34
|
+
onExpandingChange?: (state: ExpandedState) => void;
|
|
35
|
+
getRowId: (row: TData) => string;
|
|
36
36
|
} & Omit<
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| 'cardColumns'
|
|
48
|
-
| 'cardMinWidth'
|
|
49
|
-
| 'showDataView'
|
|
50
|
-
| 'rowSelection'
|
|
51
|
-
| 'rowPinning'
|
|
52
|
-
>;
|
|
37
|
+
ClientTableProps<TData>,
|
|
38
|
+
| 'data'
|
|
39
|
+
| 'columnDefinitions'
|
|
40
|
+
| 'getRowId'
|
|
41
|
+
| 'headlineId'
|
|
42
|
+
| 'expanding'
|
|
43
|
+
| 'suppressPagination'
|
|
44
|
+
| 'rowSelection'
|
|
45
|
+
| 'rowPinning'
|
|
46
|
+
>;
|
|
53
47
|
|
|
54
48
|
function getExpandingShowToggle(showToggle: boolean | undefined, hasSelection: boolean) {
|
|
55
49
|
if (showToggle !== undefined) {
|
|
@@ -85,17 +79,22 @@ export function toTreeTableProps<TData extends object>(input: TreeTableInput<TDa
|
|
|
85
79
|
expandingState,
|
|
86
80
|
onExpandingChange,
|
|
87
81
|
getRowId,
|
|
82
|
+
headlineKey,
|
|
83
|
+
defaultView,
|
|
84
|
+
view,
|
|
85
|
+
onViewChange,
|
|
86
|
+
renderCard,
|
|
88
87
|
outline,
|
|
89
88
|
...rest
|
|
90
89
|
} = input;
|
|
91
90
|
|
|
92
91
|
return {
|
|
93
92
|
...rest,
|
|
94
|
-
view
|
|
93
|
+
...mapCardViewProps({ headlineKey, defaultView, view, onViewChange, renderCard }),
|
|
95
94
|
data,
|
|
96
95
|
columnDefinitions: defineColumns(secondaryColumns),
|
|
97
96
|
getRowId: wrapGetRowId(getRowId),
|
|
98
|
-
|
|
97
|
+
suppressPagination: true,
|
|
99
98
|
outline: outline ?? true,
|
|
100
99
|
expanding: {
|
|
101
100
|
getSubRows: getChildren,
|