@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.
Files changed (144) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/README.md +334 -27
  3. package/dist/cjs/components/ServerTable/ServerTable.js +1 -1
  4. package/dist/cjs/components/Table/Table.d.ts +1 -1
  5. package/dist/cjs/components/Table/Table.js +3 -9
  6. package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +1 -2
  7. package/dist/cjs/components/Table/hooks/useTableInstance.js +1 -2
  8. package/dist/cjs/components/Table/styles.module.css +0 -1
  9. package/dist/cjs/components/types.d.ts +3 -6
  10. package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
  11. package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
  12. package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
  13. package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +1 -2
  14. package/dist/cjs/helperComponents/TableEmptyState/hooks.js +2 -5
  15. package/dist/cjs/helperComponents/TablePagination/TablePagination.js +7 -31
  16. package/dist/cjs/helperComponents/TablePagination/styles.module.css +0 -8
  17. package/dist/cjs/hooks/useCellSizes.js +2 -4
  18. package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
  19. package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
  20. package/dist/cjs/locale/index.d.ts +8 -28
  21. package/dist/cjs/locale/index.js +4 -14
  22. package/dist/cjs/presets/adminTable/AdminTable.d.ts +4 -0
  23. package/dist/cjs/presets/adminTable/AdminTable.js +11 -0
  24. package/dist/cjs/presets/adminTable/index.d.ts +4 -0
  25. package/dist/cjs/presets/adminTable/index.js +9 -0
  26. package/dist/cjs/presets/adminTable/toAdminTableProps.d.ts +31 -0
  27. package/dist/cjs/presets/adminTable/toAdminTableProps.js +57 -0
  28. package/dist/cjs/presets/adminTable/useAdminTableProps.d.ts +5 -0
  29. package/dist/cjs/presets/adminTable/useAdminTableProps.js +25 -0
  30. package/dist/cjs/presets/index.d.ts +3 -0
  31. package/dist/cjs/presets/index.js +3 -0
  32. package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
  33. package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +11 -0
  34. package/dist/cjs/presets/serverAdminTable/index.d.ts +4 -0
  35. package/dist/cjs/presets/serverAdminTable/index.js +9 -0
  36. package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
  37. package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +25 -0
  38. package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
  39. package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +25 -0
  40. package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
  41. package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +11 -0
  42. package/dist/cjs/presets/serverSimpleTable/index.d.ts +4 -0
  43. package/dist/cjs/presets/serverSimpleTable/index.js +9 -0
  44. package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
  45. package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +25 -0
  46. package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
  47. package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +21 -0
  48. package/dist/cjs/presets/simpleTable/SimpleTable.d.ts +1 -1
  49. package/dist/cjs/presets/simpleTable/SimpleTable.js +1 -1
  50. package/dist/cjs/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
  51. package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +6 -6
  52. package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +4 -1
  53. package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +7 -7
  54. package/dist/cjs/presets/treeTable/toTreeTableProps.js +3 -2
  55. package/dist/cjs/style.css +0 -12
  56. package/dist/esm/components/ServerTable/ServerTable.js +1 -1
  57. package/dist/esm/components/Table/Table.d.ts +1 -1
  58. package/dist/esm/components/Table/Table.js +3 -9
  59. package/dist/esm/components/Table/hooks/useTableInstance.d.ts +1 -2
  60. package/dist/esm/components/Table/hooks/useTableInstance.js +1 -2
  61. package/dist/esm/components/Table/styles.module.css +0 -1
  62. package/dist/esm/components/types.d.ts +3 -6
  63. package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
  64. package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
  65. package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
  66. package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +1 -2
  67. package/dist/esm/helperComponents/TableEmptyState/hooks.js +2 -5
  68. package/dist/esm/helperComponents/TablePagination/TablePagination.js +7 -31
  69. package/dist/esm/helperComponents/TablePagination/styles.module.css +0 -8
  70. package/dist/esm/hooks/useCellSizes.js +3 -5
  71. package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
  72. package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
  73. package/dist/esm/locale/index.d.ts +8 -28
  74. package/dist/esm/locale/index.js +4 -14
  75. package/dist/esm/presets/adminTable/AdminTable.d.ts +4 -0
  76. package/dist/esm/presets/adminTable/AdminTable.js +8 -0
  77. package/dist/esm/presets/adminTable/index.d.ts +4 -0
  78. package/dist/esm/presets/adminTable/index.js +3 -0
  79. package/dist/esm/presets/adminTable/toAdminTableProps.d.ts +31 -0
  80. package/dist/esm/presets/adminTable/toAdminTableProps.js +54 -0
  81. package/dist/esm/presets/adminTable/useAdminTableProps.d.ts +5 -0
  82. package/dist/esm/presets/adminTable/useAdminTableProps.js +22 -0
  83. package/dist/esm/presets/index.d.ts +3 -0
  84. package/dist/esm/presets/index.js +3 -0
  85. package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
  86. package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +8 -0
  87. package/dist/esm/presets/serverAdminTable/index.d.ts +4 -0
  88. package/dist/esm/presets/serverAdminTable/index.js +3 -0
  89. package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
  90. package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +22 -0
  91. package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
  92. package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +22 -0
  93. package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
  94. package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +8 -0
  95. package/dist/esm/presets/serverSimpleTable/index.d.ts +4 -0
  96. package/dist/esm/presets/serverSimpleTable/index.js +3 -0
  97. package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
  98. package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +22 -0
  99. package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
  100. package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +18 -0
  101. package/dist/esm/presets/simpleTable/SimpleTable.d.ts +1 -1
  102. package/dist/esm/presets/simpleTable/SimpleTable.js +1 -1
  103. package/dist/esm/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
  104. package/dist/esm/presets/simpleTable/toSimpleTableProps.js +7 -7
  105. package/dist/esm/presets/simpleTable/useSimpleTableProps.js +4 -1
  106. package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +7 -7
  107. package/dist/esm/presets/treeTable/toTreeTableProps.js +4 -3
  108. package/dist/esm/style.css +0 -12
  109. package/dist/tsconfig.cjs.tsbuildinfo +1 -1
  110. package/dist/tsconfig.esm.tsbuildinfo +1 -1
  111. package/package.json +20 -20
  112. package/src/components/ServerTable/ServerTable.tsx +0 -1
  113. package/src/components/Table/STRUCTURE.md +6 -12
  114. package/src/components/Table/Table.tsx +2 -9
  115. package/src/components/Table/hooks/useTableInstance.tsx +0 -3
  116. package/src/components/Table/styles.module.scss +3 -2
  117. package/src/components/types.ts +3 -6
  118. package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +3 -1
  119. package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +0 -2
  120. package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +0 -3
  121. package/src/helperComponents/TableEmptyState/{hooks.tsx → hooks.ts} +1 -7
  122. package/src/helperComponents/TablePagination/TablePagination.tsx +10 -80
  123. package/src/helperComponents/TablePagination/styles.module.scss +0 -9
  124. package/src/hooks/useCellSizes.ts +3 -5
  125. package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +0 -1
  126. package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +0 -2
  127. package/src/locale/index.ts +4 -14
  128. package/src/presets/adminTable/AdminTable.tsx +14 -0
  129. package/src/presets/adminTable/index.ts +4 -0
  130. package/src/presets/adminTable/toAdminTableProps.ts +140 -0
  131. package/src/presets/adminTable/useAdminTableProps.ts +35 -0
  132. package/src/presets/index.ts +3 -0
  133. package/src/presets/serverAdminTable/ServerAdminTable.tsx +14 -0
  134. package/src/presets/serverAdminTable/index.ts +4 -0
  135. package/src/presets/serverAdminTable/toServerAdminTableProps.ts +44 -0
  136. package/src/presets/serverAdminTable/useServerAdminTableProps.ts +35 -0
  137. package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +10 -0
  138. package/src/presets/serverSimpleTable/index.ts +4 -0
  139. package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +56 -0
  140. package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +27 -0
  141. package/src/presets/simpleTable/SimpleTable.tsx +1 -1
  142. package/src/presets/simpleTable/toSimpleTableProps.ts +30 -35
  143. package/src/presets/simpleTable/useSimpleTableProps.ts +5 -1
  144. 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
+ }
@@ -1,4 +1,7 @@
1
+ export * from './adminTable';
1
2
  export * from './entitiesTable';
2
3
  export * from './infiniteTable';
4
+ export * from './serverAdminTable';
5
+ export * from './serverSimpleTable';
3
6
  export * from './simpleTable';
4
7
  export * from './treeTable';
@@ -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,4 @@
1
+ export { ServerAdminTable } from './ServerAdminTable';
2
+ export type { ServerAdminTableInput } from './toServerAdminTableProps';
3
+ export { toServerAdminTableProps } from './toServerAdminTableProps';
4
+ export { useServerAdminTableProps } from './useServerAdminTableProps';
@@ -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 { WithSupportProps } from '@cloud-ru/ds-utils';
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> = WithSupportProps<
9
- {
10
- /** Данные для отрисовки */
11
- data: TData[];
12
- /** Декларативное описание колонок */
13
- columns: SimpleColumnDef<TData>[];
14
- /** Стабильный идентификатор строки */
15
- getRowId?(row: TData): string;
16
- } & Pick<
17
- ClientTableProps<TData>,
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 { data, columns, getRowId, outline, ...rest } = input;
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: 'table',
38
+ ...mapCardViewProps({ headlineKey, defaultView, view, onViewChange, renderCard }),
42
39
  data,
43
40
  columnDefinitions: defineColumns(columns),
44
41
  outline: outline ?? true,
45
- pageSize: Math.max(data.length, 1),
46
- manualPagination: true,
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?(state: RowSelectionState): void;
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): TData[] | undefined;
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?(state: ExpandedState): void;
35
- getRowId(row: TData): string;
34
+ onExpandingChange?: (state: ExpandedState) => void;
35
+ getRowId: (row: TData) => string;
36
36
  } & Omit<
37
- ClientTableProps<TData>,
38
- | 'data'
39
- | 'columnDefinitions'
40
- | 'getRowId'
41
- | 'headlineId'
42
- | 'expanding'
43
- | 'view'
44
- | 'defaultView'
45
- | 'onViewChange'
46
- | 'renderCard'
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: 'table',
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,