@etic-insa/ui 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +438 -37
- package/dist/components/etic/action.d.ts +16 -7
- package/dist/components/etic/action.js +25 -25
- package/dist/components/etic/action.js.map +1 -1
- package/dist/components/etic/app-shell.d.ts +16 -7
- package/dist/components/etic/app-shell.js +92 -85
- package/dist/components/etic/app-shell.js.map +1 -1
- package/dist/components/etic/auth-image.d.ts +29 -6
- package/dist/components/etic/auth-image.js +41 -18
- package/dist/components/etic/auth-image.js.map +1 -1
- package/dist/components/etic/button-link.d.ts +19 -0
- package/dist/components/etic/button-link.js +19 -0
- package/dist/components/etic/button-link.js.map +1 -0
- package/dist/components/etic/centered-screen.d.ts +13 -0
- package/dist/components/etic/centered-screen.js +13 -0
- package/dist/components/etic/centered-screen.js.map +1 -0
- package/dist/components/etic/confirm-dialog.d.ts +33 -3
- package/dist/components/etic/confirm-dialog.js +92 -67
- package/dist/components/etic/confirm-dialog.js.map +1 -1
- package/dist/components/etic/copy-button.d.ts +3 -2
- package/dist/components/etic/copy-button.js +3 -3
- package/dist/components/etic/copy-button.js.map +1 -1
- package/dist/components/etic/data-table-bulk-actions.d.ts +28 -4
- package/dist/components/etic/data-table-bulk-actions.js +48 -41
- package/dist/components/etic/data-table-bulk-actions.js.map +1 -1
- package/dist/components/etic/data-table-focus.d.ts +17 -0
- package/dist/components/etic/data-table-focus.js +29 -0
- package/dist/components/etic/data-table-focus.js.map +1 -0
- package/dist/components/etic/data-table-format.d.ts +3 -10
- package/dist/components/etic/data-table-format.js +4 -3
- package/dist/components/etic/data-table-format.js.map +1 -1
- package/dist/components/etic/data-table-pagination.d.ts +20 -6
- package/dist/components/etic/data-table-pagination.js +73 -43
- package/dist/components/etic/data-table-pagination.js.map +1 -1
- package/dist/components/etic/data-table-toolbar.d.ts +34 -13
- package/dist/components/etic/data-table-toolbar.js +66 -62
- package/dist/components/etic/data-table-toolbar.js.map +1 -1
- package/dist/components/etic/data-table-view-options.d.ts +44 -4
- package/dist/components/etic/data-table-view-options.js +145 -98
- package/dist/components/etic/data-table-view-options.js.map +1 -1
- package/dist/components/etic/data-table.d.ts +173 -15
- package/dist/components/etic/data-table.js +381 -202
- package/dist/components/etic/data-table.js.map +1 -1
- package/dist/components/etic/date-picker.d.ts +5 -1
- package/dist/components/etic/date-picker.js +97 -84
- package/dist/components/etic/date-picker.js.map +1 -1
- package/dist/components/etic/delete-button.d.ts +12 -4
- package/dist/components/etic/delete-button.js +21 -22
- package/dist/components/etic/delete-button.js.map +1 -1
- package/dist/components/etic/detail-list.d.ts +16 -4
- package/dist/components/etic/detail-list.js +30 -20
- package/dist/components/etic/detail-list.js.map +1 -1
- package/dist/components/etic/disclosure.d.ts +52 -0
- package/dist/components/etic/disclosure.js +70 -0
- package/dist/components/etic/disclosure.js.map +1 -0
- package/dist/components/etic/draft-resume-dialog.d.ts +42 -0
- package/dist/components/etic/draft-resume-dialog.js +60 -0
- package/dist/components/etic/draft-resume-dialog.js.map +1 -0
- package/dist/components/etic/error-banner.js +34 -38
- package/dist/components/etic/error-banner.js.map +1 -1
- package/dist/components/etic/error-boundary.js +4 -3
- package/dist/components/etic/error-boundary.js.map +1 -1
- package/dist/components/etic/explained-badge.d.ts +26 -0
- package/dist/components/etic/explained-badge.js +17 -0
- package/dist/components/etic/explained-badge.js.map +1 -0
- package/dist/components/etic/file-upload.js +66 -71
- package/dist/components/etic/file-upload.js.map +1 -1
- package/dist/components/etic/form-dialog.d.ts +25 -2
- package/dist/components/etic/form-dialog.js +95 -77
- package/dist/components/etic/form-dialog.js.map +1 -1
- package/dist/components/etic/icon-toggle.d.ts +27 -9
- package/dist/components/etic/icon-toggle.js +31 -19
- package/dist/components/etic/icon-toggle.js.map +1 -1
- package/dist/components/etic/lien.d.ts +34 -0
- package/dist/components/etic/lien.js +17 -0
- package/dist/components/etic/lien.js.map +1 -0
- package/dist/components/etic/loading.d.ts +0 -8
- package/dist/components/etic/loading.js +17 -25
- package/dist/components/etic/loading.js.map +1 -1
- package/dist/components/etic/page-container.d.ts +10 -0
- package/dist/components/etic/page-container.js +9 -5
- package/dist/components/etic/page-container.js.map +1 -1
- package/dist/components/etic/page-header.d.ts +10 -4
- package/dist/components/etic/page-header.js +48 -43
- package/dist/components/etic/page-header.js.map +1 -1
- package/dist/components/etic/phone-input.d.ts +16 -0
- package/dist/components/etic/phone-input.js +71 -65
- package/dist/components/etic/phone-input.js.map +1 -1
- package/dist/components/etic/query-boundary.d.ts +25 -2
- package/dist/components/etic/query-boundary.js +24 -12
- package/dist/components/etic/query-boundary.js.map +1 -1
- package/dist/components/etic/removable-badge.d.ts +30 -0
- package/dist/components/etic/removable-badge.js +31 -0
- package/dist/components/etic/removable-badge.js.map +1 -0
- package/dist/components/etic/save-bar.d.ts +31 -0
- package/dist/components/etic/save-bar.js +45 -0
- package/dist/components/etic/save-bar.js.map +1 -0
- package/dist/components/etic/search-select.js +1 -1
- package/dist/components/etic/search-select.js.map +1 -1
- package/dist/components/etic/segmented-control.d.ts +6 -2
- package/dist/components/etic/segmented-control.js +28 -27
- package/dist/components/etic/segmented-control.js.map +1 -1
- package/dist/components/etic/stat-grid.d.ts +15 -0
- package/dist/components/etic/stat-grid.js +17 -0
- package/dist/components/etic/stat-grid.js.map +1 -0
- package/dist/components/etic/stat-tile.d.ts +1 -1
- package/dist/components/etic/stat-tile.js +12 -18
- package/dist/components/etic/stat-tile.js.map +1 -1
- package/dist/components/etic/status-badge.d.ts +2 -4
- package/dist/components/etic/status-badge.js +13 -23
- package/dist/components/etic/status-badge.js.map +1 -1
- package/dist/components/etic/tailles-dialogue.d.ts +8 -0
- package/dist/components/etic/tailles-dialogue.js +10 -0
- package/dist/components/etic/tailles-dialogue.js.map +1 -0
- package/dist/components/etic/theme-menu.d.ts +1 -2
- package/dist/components/etic/theme-menu.js +45 -41
- package/dist/components/etic/theme-menu.js.map +1 -1
- package/dist/components/etic/toggletip.d.ts +36 -0
- package/dist/components/etic/toggletip.js +59 -0
- package/dist/components/etic/toggletip.js.map +1 -0
- package/dist/components/etic/tooltip-button.d.ts +13 -3
- package/dist/components/etic/tooltip-button.js +19 -19
- package/dist/components/etic/tooltip-button.js.map +1 -1
- package/dist/components/etic/unsaved-changes.d.ts +41 -0
- package/dist/components/etic/unsaved-changes.js +17 -0
- package/dist/components/etic/unsaved-changes.js.map +1 -0
- package/dist/components/etic/use-draft-autosave.d.ts +3 -1
- package/dist/components/etic/use-draft-autosave.js +74 -78
- package/dist/components/etic/use-draft-autosave.js.map +1 -1
- package/dist/components/etic/use-unsaved-changes-warning.d.ts +10 -0
- package/dist/components/etic/use-unsaved-changes-warning.js +20 -0
- package/dist/components/etic/use-unsaved-changes-warning.js.map +1 -0
- package/dist/components/ui/alert-dialog.js +2 -2
- package/dist/components/ui/alert-dialog.js.map +1 -1
- package/dist/components/ui/avatar.d.ts +5 -1
- package/dist/components/ui/avatar.js +20 -11
- package/dist/components/ui/avatar.js.map +1 -1
- package/dist/components/ui/badge.d.ts +3 -2
- package/dist/components/ui/badge.js +27 -14
- package/dist/components/ui/badge.js.map +1 -1
- package/dist/components/ui/breadcrumb.js +13 -13
- package/dist/components/ui/button.d.ts +15 -2
- package/dist/components/ui/button.js +27 -15
- package/dist/components/ui/button.js.map +1 -1
- package/dist/components/ui/calendar.js +1 -1
- package/dist/components/ui/calendar.js.map +1 -1
- package/dist/components/ui/checkbox.js +1 -1
- package/dist/components/ui/checkbox.js.map +1 -1
- package/dist/components/ui/combobox.d.ts +2 -2
- package/dist/components/ui/combobox.js +45 -32
- package/dist/components/ui/combobox.js.map +1 -1
- package/dist/components/ui/dialog.d.ts +10 -1
- package/dist/components/ui/dialog.js +12 -5
- package/dist/components/ui/dialog.js.map +1 -1
- package/dist/components/ui/input-group.d.ts +1 -1
- package/dist/components/ui/popover.d.ts +1 -1
- package/dist/components/ui/popover.js +3 -2
- package/dist/components/ui/popover.js.map +1 -1
- package/dist/components/ui/progress.d.ts +16 -2
- package/dist/components/ui/progress.js +34 -26
- package/dist/components/ui/progress.js.map +1 -1
- package/dist/components/ui/radio-group.js +1 -1
- package/dist/components/ui/radio-group.js.map +1 -1
- package/dist/components/ui/select.d.ts +10 -2
- package/dist/components/ui/select.js +70 -50
- package/dist/components/ui/select.js.map +1 -1
- package/dist/components/ui/sidebar.d.ts +6 -1
- package/dist/components/ui/sidebar.js +92 -92
- package/dist/components/ui/sidebar.js.map +1 -1
- package/dist/components/ui/spinner.d.ts +7 -1
- package/dist/components/ui/spinner.js +9 -1
- package/dist/components/ui/spinner.js.map +1 -1
- package/dist/components/ui/switch.js +1 -1
- package/dist/components/ui/switch.js.map +1 -1
- package/dist/components/ui/table.js +1 -1
- package/dist/components/ui/table.js.map +1 -1
- package/dist/components/ui/tabs.js +2 -2
- package/dist/components/ui/tabs.js.map +1 -1
- package/dist/components/ui/tooltip.d.ts +7 -2
- package/dist/components/ui/tooltip.js +27 -19
- package/dist/components/ui/tooltip.js.map +1 -1
- package/dist/hooks/use-column-prefs.d.ts +84 -0
- package/dist/hooks/use-column-prefs.js +71 -0
- package/dist/hooks/use-column-prefs.js.map +1 -0
- package/dist/hooks/use-debounced-value.d.ts +13 -0
- package/dist/hooks/use-debounced-value.js +12 -0
- package/dist/hooks/use-debounced-value.js.map +1 -0
- package/dist/hooks/use-document-title.d.ts +5 -0
- package/dist/hooks/use-document-title.js +13 -0
- package/dist/hooks/use-document-title.js.map +1 -0
- package/dist/hooks/use-persisted-state.d.ts +43 -0
- package/dist/hooks/use-persisted-state.js +40 -0
- package/dist/hooks/use-persisted-state.js.map +1 -0
- package/dist/index.d.ts +40 -16
- package/dist/index.js +99 -76
- package/dist/lib/autofill.d.ts +18 -0
- package/dist/lib/autofill.js +10 -0
- package/dist/lib/autofill.js.map +1 -0
- package/dist/lib/dates.d.ts +20 -0
- package/dist/lib/dates.js +16 -0
- package/dist/lib/dates.js.map +1 -0
- package/dist/lib/focus-rendu.d.ts +24 -0
- package/dist/lib/focus-rendu.js +14 -0
- package/dist/lib/focus-rendu.js.map +1 -0
- package/dist/lib/format.d.ts +54 -0
- package/dist/lib/format.js +80 -0
- package/dist/lib/format.js.map +1 -0
- package/dist/lib/normalize.d.ts +28 -0
- package/dist/lib/normalize.js +21 -0
- package/dist/lib/normalize.js.map +1 -0
- package/dist/lib/ordre-colonnes.d.ts +15 -0
- package/dist/lib/ordre-colonnes.js +14 -0
- package/dist/lib/ordre-colonnes.js.map +1 -0
- package/dist/lib/ton.d.ts +23 -0
- package/dist/lib/ton.js +51 -0
- package/dist/lib/ton.js.map +1 -0
- package/dist/styles.css +110 -63
- package/dist/theme.d.ts +34 -0
- package/dist/theme.js +45 -0
- package/dist/theme.js.map +1 -0
- package/package.json +4 -2
- package/src/theme-boot.js +22 -0
|
@@ -1,6 +1,8 @@
|
|
|
1
|
-
import { ReactNode, RefObject } from 'react';
|
|
2
|
-
import { Column, ColumnDef, ColumnOrderState, ColumnVisibilityState, ExpandedStateList, OnChangeFn, ReactTable, RowData, RowSelectionState, SortingState } from '@tanstack/react-table';
|
|
1
|
+
import { ComponentProps, ReactNode, RefObject } from 'react';
|
|
2
|
+
import { Column, ColumnDef, ColumnFiltersState, ColumnOrderState, ColumnVisibilityState, ExpandedStateList, OnChangeFn, PaginationState, ReactTable, RowData, RowSelectionState, SortingState } from '@tanstack/react-table';
|
|
3
3
|
import { DataTableUnite } from './data-table-format';
|
|
4
|
+
import { LienComposant } from './lien';
|
|
5
|
+
import { QueryBoundaryRequete } from './query-boundary';
|
|
4
6
|
/** Métadonnées qu'une colonne peut porter (`meta` de sa définition). */
|
|
5
7
|
export interface DataTableColumnMeta {
|
|
6
8
|
/** Nom de la colonne (sélecteur de colonnes, annonce du tri), quand son
|
|
@@ -18,6 +20,9 @@ export interface DataTableMeta {
|
|
|
18
20
|
/** Vide la sélection et met fin à « tous sélectionnés », en un seul appel
|
|
19
21
|
* à `onToutSelectionneChange`. */
|
|
20
22
|
toutDeselectionner: () => void;
|
|
23
|
+
/** Retire ces lignes de la sélection (les autres restent cochées) et met
|
|
24
|
+
* fin à « tous sélectionnés ». */
|
|
25
|
+
deselectionner: (ids: readonly string[]) => void;
|
|
21
26
|
/**
|
|
22
27
|
* Cadre du tableau. `DataTable` le pose sur le sien ; un tableau rendu à
|
|
23
28
|
* la main avec les primitives `Table` le pose sur son conteneur
|
|
@@ -27,26 +32,50 @@ export interface DataTableMeta {
|
|
|
27
32
|
racine: RefObject<HTMLDivElement | null>;
|
|
28
33
|
/** Identifiant du détail d'une ligne dépliée (cible d'`aria-controls`). */
|
|
29
34
|
idDetail: (idLigne: string) => string;
|
|
35
|
+
/** Voir `colonnesReglables` de `useDataTable`. */
|
|
36
|
+
colonnesReglables?: readonly string[];
|
|
30
37
|
}
|
|
31
38
|
/**
|
|
32
|
-
* Fonctions de TanStack Table v9 dont se sert `DataTable` : tri
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* `createDataTableColumnHelper<T>()`.
|
|
39
|
+
* Fonctions de TanStack Table v9 dont se sert `DataTable` : tri, filtre et
|
|
40
|
+
* pagination (côté client ; côté serveur avec `triManuel` et sans
|
|
41
|
+
* `paginationClient`), visibilité et ordre des colonnes, sélection et
|
|
42
|
+
* dépliage de lignes. Comme dans le guide Data Table de shadcn, les colonnes
|
|
43
|
+
* se déclarent avec ce registre : `createDataTableColumnHelper<T>()`.
|
|
44
|
+
*
|
|
45
|
+
* Tris nommés (`sortFn`) : ceux de TanStack et `texteFr` (ordre
|
|
46
|
+
* alphabétique français). Filtres nommés (`filterFn`) : ceux de TanStack et
|
|
47
|
+
* `texteFr` (« contient », sans casse ni accents).
|
|
37
48
|
*/
|
|
38
49
|
export declare const dataTableFeatures: {
|
|
50
|
+
columnFilteringFeature: import('@tanstack/table-core').TableFeature;
|
|
39
51
|
columnOrderingFeature: import('@tanstack/table-core').TableFeature;
|
|
40
52
|
columnVisibilityFeature: import('@tanstack/table-core').TableFeature;
|
|
53
|
+
globalFilteringFeature: import('@tanstack/table-core').TableFeature;
|
|
41
54
|
rowExpandingFeature: import('@tanstack/table-core').TableFeature;
|
|
55
|
+
rowPaginationFeature: import('@tanstack/table-core').TableFeature;
|
|
42
56
|
rowSelectionFeature: import('@tanstack/table-core').TableFeature;
|
|
43
57
|
rowSortingFeature: import('@tanstack/table-core').TableFeature;
|
|
58
|
+
filteredRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
59
|
+
paginatedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
44
60
|
sortedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
61
|
+
filterFns: {
|
|
62
|
+
arrIncludes: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
63
|
+
arrIncludesAll: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
64
|
+
arrIncludesSome: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
65
|
+
equals: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
66
|
+
equalsString: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
67
|
+
inDateRange: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
68
|
+
inNumberRange: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
69
|
+
includesString: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
70
|
+
texteFr: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
71
|
+
weakEquals: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
72
|
+
};
|
|
45
73
|
sortFns: {
|
|
46
74
|
alphanumeric: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
47
75
|
basic: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
48
76
|
datetime: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
49
77
|
text: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
78
|
+
texteFr: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
50
79
|
};
|
|
51
80
|
columnMeta: DataTableColumnMeta;
|
|
52
81
|
tableMeta: DataTableMeta;
|
|
@@ -58,17 +87,35 @@ export type DataTableColumnDef<TData extends RowData> = ColumnDef<DataTableFeatu
|
|
|
58
87
|
export type DataTableInstance<TData extends RowData> = ReactTable<DataTableFeatures, TData>;
|
|
59
88
|
/** Assistant de colonnes typé pour `DataTable` : `accessor`, `display`… */
|
|
60
89
|
export declare function createDataTableColumnHelper<TData extends RowData>(): import('@tanstack/table-core').ColumnHelper<{
|
|
90
|
+
columnFilteringFeature: import('@tanstack/table-core').TableFeature;
|
|
61
91
|
columnOrderingFeature: import('@tanstack/table-core').TableFeature;
|
|
62
92
|
columnVisibilityFeature: import('@tanstack/table-core').TableFeature;
|
|
93
|
+
globalFilteringFeature: import('@tanstack/table-core').TableFeature;
|
|
63
94
|
rowExpandingFeature: import('@tanstack/table-core').TableFeature;
|
|
95
|
+
rowPaginationFeature: import('@tanstack/table-core').TableFeature;
|
|
64
96
|
rowSelectionFeature: import('@tanstack/table-core').TableFeature;
|
|
65
97
|
rowSortingFeature: import('@tanstack/table-core').TableFeature;
|
|
98
|
+
filteredRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
99
|
+
paginatedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
66
100
|
sortedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
|
|
101
|
+
filterFns: {
|
|
102
|
+
arrIncludes: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
103
|
+
arrIncludesAll: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
104
|
+
arrIncludesSome: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
105
|
+
equals: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
106
|
+
equalsString: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
107
|
+
inDateRange: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
108
|
+
inNumberRange: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
109
|
+
includesString: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
110
|
+
texteFr: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
111
|
+
weakEquals: import('@tanstack/table-core').CreatedFilterFn<any, any>;
|
|
112
|
+
};
|
|
67
113
|
sortFns: {
|
|
68
114
|
alphanumeric: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
69
115
|
basic: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
70
116
|
datetime: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
71
117
|
text: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
118
|
+
texteFr: import('@tanstack/table-core').CreatedSortFn<any, any>;
|
|
72
119
|
};
|
|
73
120
|
columnMeta: DataTableColumnMeta;
|
|
74
121
|
tableMeta: DataTableMeta;
|
|
@@ -78,11 +125,24 @@ type Colonne<TData extends RowData> = Column<DataTableFeatures, TData, unknown>;
|
|
|
78
125
|
* sinon son identifiant. */
|
|
79
126
|
export declare function libelleColonne<TData extends RowData>(colonne: Colonne<TData>): string;
|
|
80
127
|
/**
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
*
|
|
128
|
+
* L'état partagé d'un tableau de `useDataTable`, toujours posé par lui.
|
|
129
|
+
* Lève pour une instance créée autrement : les composants `DataTable*` en
|
|
130
|
+
* dépendent.
|
|
84
131
|
*/
|
|
85
|
-
export declare function
|
|
132
|
+
export declare function metaDe<TData extends RowData>(table: DataTableInstance<TData>): DataTableMeta;
|
|
133
|
+
/**
|
|
134
|
+
* La pagination d'un tableau, lue au même endroit pour `DataTablePagination`
|
|
135
|
+
* et `DataTableCount` : lignes après filtre (`getRowCount`), page courante.
|
|
136
|
+
* `manuelle` : le tableau ne découpe rien (sans
|
|
137
|
+
* `paginationClient`), ses pages ne se pilotent pas depuis la table.
|
|
138
|
+
*/
|
|
139
|
+
export declare function paginationDuTableau<TData extends RowData>(table: DataTableInstance<TData>): {
|
|
140
|
+
manuelle: boolean;
|
|
141
|
+
total: number;
|
|
142
|
+
decalage: number;
|
|
143
|
+
limite: number;
|
|
144
|
+
nombre: number;
|
|
145
|
+
};
|
|
86
146
|
export interface UseDataTableOptions<TData extends RowData> {
|
|
87
147
|
/** Lignes affichées. Référence stable (état, mémo, résultat de requête) :
|
|
88
148
|
* un nouveau tableau à chaque rendu recalcule tout le tableau. */
|
|
@@ -98,11 +158,41 @@ export interface UseDataTableOptions<TData extends RowData> {
|
|
|
98
158
|
/** Les données arrivent déjà triées (tri côté serveur) : le tableau ne
|
|
99
159
|
* réordonne rien, il signale seulement le tri demandé. */
|
|
100
160
|
triManuel?: boolean;
|
|
161
|
+
/**
|
|
162
|
+
* Pagination côté client : `donnees` contient toute la liste, le tableau
|
|
163
|
+
* n'en affiche qu'une page (25 lignes par défaut), après le filtre et le
|
|
164
|
+
* tri. `DataTablePagination table={table}` la pilote, et `DataTableCount
|
|
165
|
+
* table={table}` la compte. Sans elle, le tableau affiche toutes les
|
|
166
|
+
* lignes reçues (pagination côté serveur, ou pas de pagination).
|
|
167
|
+
*/
|
|
168
|
+
paginationClient?: boolean;
|
|
169
|
+
/** Page et taille contrôlées (`{ pageIndex, pageSize }`), avec
|
|
170
|
+
* `paginationClient`. */
|
|
171
|
+
pagination?: PaginationState;
|
|
172
|
+
onPaginationChange?: OnChangeFn<PaginationState>;
|
|
173
|
+
/**
|
|
174
|
+
* Filtres par colonne, appliqués par le tableau (`{ id, value }` ; la
|
|
175
|
+
* colonne choisit sa fonction : `filterFn: "equals"`, `"texteFr"`…).
|
|
176
|
+
* Contrôlés avec `onFiltresColonnesChange`, internes sinon
|
|
177
|
+
* (`table.getColumn(id)?.setFilterValue(valeur)`). Un changement de filtre
|
|
178
|
+
* ou de tri ramène à la première page.
|
|
179
|
+
*/
|
|
180
|
+
filtresColonnes?: ColumnFiltersState;
|
|
181
|
+
onFiltresColonnesChange?: OnChangeFn<ColumnFiltersState>;
|
|
182
|
+
/** Recherche sur toutes les colonnes à accesseur, sans casse ni accents
|
|
183
|
+
* (`texteFr`). Contrôlée avec `onFiltreGlobalChange`, interne sinon
|
|
184
|
+
* (`table.setGlobalFilter`). */
|
|
185
|
+
filtreGlobal?: string;
|
|
186
|
+
onFiltreGlobalChange?: OnChangeFn<string>;
|
|
101
187
|
visibiliteColonnes?: ColumnVisibilityState;
|
|
102
188
|
onVisibiliteColonnesChange?: OnChangeFn<ColumnVisibilityState>;
|
|
103
189
|
/** Identifiants des colonnes dans l'ordre d'affichage. */
|
|
104
190
|
ordreColonnes?: ColumnOrderState;
|
|
105
191
|
onOrdreColonnesChange?: OnChangeFn<ColumnOrderState>;
|
|
192
|
+
/** Colonnes que « Colonnes » (`DataTableViewOptions`) peut masquer et
|
|
193
|
+
* déplacer ; les autres y restent fixes, à leur place. Toutes les
|
|
194
|
+
* masquables par défaut. Donné par `useColumnPrefs`. */
|
|
195
|
+
colonnesReglables?: readonly string[];
|
|
106
196
|
/** Sélection contrôlée : `{ [idLigne]: true }`. */
|
|
107
197
|
selection?: RowSelectionState;
|
|
108
198
|
onSelectionChange?: OnChangeFn<RowSelectionState>;
|
|
@@ -110,8 +200,8 @@ export interface UseDataTableOptions<TData extends RowData> {
|
|
|
110
200
|
* stable de préférence : elle est relue à chaque changement. */
|
|
111
201
|
ligneSelectionnable?: (ligne: TData) => boolean;
|
|
112
202
|
/**
|
|
113
|
-
* Par défaut, la sélection ne garde que des lignes
|
|
114
|
-
*
|
|
203
|
+
* Par défaut, la sélection ne garde que des lignes affichées : changer de
|
|
204
|
+
* page, de filtre (côté serveur ou côté client) ou supprimer des lignes la
|
|
115
205
|
* réduit à ce qui est à l'écran. `true` la conserve d'une page à l'autre.
|
|
116
206
|
*/
|
|
117
207
|
conserverSelection?: boolean;
|
|
@@ -152,6 +242,10 @@ export interface UseDataTableOptions<TData extends RowData> {
|
|
|
152
242
|
visibiliteColonnes?: ColumnVisibilityState;
|
|
153
243
|
ordreColonnes?: ColumnOrderState;
|
|
154
244
|
lignesDepliees?: ExpandedStateList;
|
|
245
|
+
/** Taille de page (et page) de départ de `paginationClient`. */
|
|
246
|
+
pagination?: Partial<PaginationState>;
|
|
247
|
+
filtresColonnes?: ColumnFiltersState;
|
|
248
|
+
filtreGlobal?: string;
|
|
155
249
|
};
|
|
156
250
|
}
|
|
157
251
|
/**
|
|
@@ -159,11 +253,22 @@ export interface UseDataTableOptions<TData extends RowData> {
|
|
|
159
253
|
* partie de l'état (tri, colonnes, sélection, dépliage) est contrôlée si sa
|
|
160
254
|
* valeur est fournie avec son `on…Change`, interne sinon.
|
|
161
255
|
*/
|
|
162
|
-
export declare function useDataTable<TData extends RowData>({ donnees, colonnes, idLigne, tri, onTriChange, triManuel, visibiliteColonnes, onVisibiliteColonnesChange, ordreColonnes, onOrdreColonnesChange, selection, onSelectionChange, ligneSelectionnable, conserverSelection, total, toutSelectionne, onToutSelectionneChange, lignesDepliees, onLignesDeplieesChange, ligneDepliable, uneSeuleLigneDepliee, etatInitial, }: UseDataTableOptions<TData>): DataTableInstance<TData>;
|
|
256
|
+
export declare function useDataTable<TData extends RowData>({ donnees, colonnes, idLigne, tri, onTriChange, triManuel, paginationClient, pagination, onPaginationChange, filtresColonnes, onFiltresColonnesChange, filtreGlobal, onFiltreGlobalChange, visibiliteColonnes, onVisibiliteColonnesChange, ordreColonnes, onOrdreColonnesChange, colonnesReglables, selection, onSelectionChange, ligneSelectionnable, conserverSelection, total, toutSelectionne, onToutSelectionneChange, lignesDepliees, onLignesDeplieesChange, ligneDepliable, uneSeuleLigneDepliee, etatInitial, }: UseDataTableOptions<TData>): DataTableInstance<TData>;
|
|
257
|
+
/** Ce que `DataTable` lit de la requête de ses lignes : le résultat de
|
|
258
|
+
* `useQuery` de TanStack Query convient tel quel. */
|
|
259
|
+
export type DataTableRequete = Pick<QueryBoundaryRequete<unknown>, "isError" | "error" | "isFetching" | "refetch">;
|
|
163
260
|
export interface DataTableProps<TData extends RowData> {
|
|
164
261
|
table: DataTableInstance<TData>;
|
|
165
262
|
/** Nom du tableau pour les lecteurs d'écran : « Membres ». */
|
|
166
263
|
libelle: string;
|
|
264
|
+
/**
|
|
265
|
+
* La requête des lignes. En échec, un bandeau d'erreur avec « Réessayer »
|
|
266
|
+
* s'affiche au-dessus du tableau (rendu dans le parent, qui règle
|
|
267
|
+
* l'espacement, comme `QueryBoundary`) et l'état vide se tait : il
|
|
268
|
+
* contredirait le bandeau. Sans `enChargement`, `isFetching` en tient
|
|
269
|
+
* lieu.
|
|
270
|
+
*/
|
|
271
|
+
requete?: DataTableRequete;
|
|
167
272
|
/** Données en cours de chargement : lignes fantômes s'il n'y a encore
|
|
168
273
|
* rien, lignes actuelles atténuées sinon. */
|
|
169
274
|
enChargement?: boolean;
|
|
@@ -201,7 +306,7 @@ export interface DataTableProps<TData extends RowData> {
|
|
|
201
306
|
* les colonnes changent : cocher une case ne redessine pas tout le tableau.
|
|
202
307
|
* Une cellule qui affiche un autre état le lit elle-même (hook, contexte).
|
|
203
308
|
*/
|
|
204
|
-
export declare function DataTable<TData extends RowData>({ table, libelle, enChargement, lignesChargement, vide, onActiverLigne, rendreDetail, unite, feminin, className, }: DataTableProps<TData>): import("react").JSX.Element;
|
|
309
|
+
export declare function DataTable<TData extends RowData>({ table, libelle, requete, enChargement, lignesChargement, vide: videDemande, onActiverLigne, rendreDetail, unite, feminin, className, }: DataTableProps<TData>): import("react").JSX.Element;
|
|
205
310
|
export interface DataTableColumnHeaderProps<TData extends RowData, TValue> {
|
|
206
311
|
column: Column<DataTableFeatures, TData, TValue>;
|
|
207
312
|
/** Nom de la colonne, affiché. */
|
|
@@ -234,6 +339,12 @@ export interface DataTableSelectionColumnOptions<TData extends RowData> {
|
|
|
234
339
|
* couvre sa cellule.
|
|
235
340
|
*/
|
|
236
341
|
export declare function dataTableSelectionColumn<TData extends RowData>({ libelleLigne, libelleTout, verrouLigne, }?: DataTableSelectionColumnOptions<TData>): DataTableColumnDef<TData>;
|
|
342
|
+
/**
|
|
343
|
+
* Case verrouillée lisible : ni estompée (à 50 %, son bord tombait sous
|
|
344
|
+
* 3:1), ni confondue avec une case active. Vide, fond gris et bord plein ;
|
|
345
|
+
* cochée, gris foncé (`--muted-foreground`) au lieu de la couleur d'accent.
|
|
346
|
+
*/
|
|
347
|
+
export declare const CASE_VERROUILLEE = "aria-disabled:cursor-not-allowed aria-disabled:opacity-100 aria-disabled:not-data-checked:bg-muted aria-disabled:data-checked:border-muted-foreground aria-disabled:data-checked:bg-muted-foreground aria-disabled:data-checked:text-background";
|
|
237
348
|
export interface DataTableExpandColumnOptions<TData extends RowData> {
|
|
238
349
|
/** Nom du bouton d'une ligne, lu et affiché en infobulle : « Détail de
|
|
239
350
|
* l'erreur du 12 octobre ». « Détail de la ligne » par défaut. Son état
|
|
@@ -260,4 +371,51 @@ export interface DataTableRowActionsProps {
|
|
|
260
371
|
/** Menu d'actions d'une ligne, comme dans le guide de shadcn : bouton « … »
|
|
261
372
|
* fantôme à icône seule, menu aligné à droite. */
|
|
262
373
|
export declare function DataTableRowActions({ children, libelle, }: DataTableRowActionsProps): import("react").JSX.Element;
|
|
374
|
+
export interface DataTableActionsColumnOptions<TData extends RowData> {
|
|
375
|
+
/** Les commandes d'une ligne : `DeleteButton`, `TooltipButton`,
|
|
376
|
+
* `DataTableRowActions`… alignées à droite. */
|
|
377
|
+
actions: (ligne: TData) => ReactNode;
|
|
378
|
+
/** Nom de la colonne, lu par les lecteurs d'écran (l'en-tête reste
|
|
379
|
+
* vide à l'écran) et affiché dans le sélecteur de colonnes. « Actions »
|
|
380
|
+
* par défaut. */
|
|
381
|
+
libelle?: string;
|
|
382
|
+
/** Identifiant de la colonne. « actions » par défaut. */
|
|
383
|
+
id?: string;
|
|
384
|
+
/** Colonne masquable et déplaçable par « Colonnes ». Non par défaut. */
|
|
385
|
+
enableHiding?: boolean;
|
|
386
|
+
/** Classes ajoutées à l'en-tête et aux cellules, après `w-px`. */
|
|
387
|
+
className?: string;
|
|
388
|
+
}
|
|
389
|
+
/**
|
|
390
|
+
* Colonne des commandes d'une ligne (`id: "actions"`, comme dans shadcn) :
|
|
391
|
+
* en-tête lu mais invisible, colonne aussi étroite que son contenu,
|
|
392
|
+
* commandes alignées à droite. Ni triable ni masquable. Comme toute colonne,
|
|
393
|
+
* à créer hors du composant ou mémorisée : un état de la page passe par un
|
|
394
|
+
* contexte ou un hook lu dans la cellule, pas par la fermeture de `actions`.
|
|
395
|
+
*/
|
|
396
|
+
export declare function dataTableActionsColumn<TData extends RowData>({ actions, libelle, id, enableHiding, className, }: DataTableActionsColumnOptions<TData>): DataTableColumnDef<TData>;
|
|
397
|
+
type DataTableCellLinkCommun = {
|
|
398
|
+
children: ReactNode;
|
|
399
|
+
className?: string;
|
|
400
|
+
};
|
|
401
|
+
/** Lien de cellule : une adresse, suivie par le lien du routeur. */
|
|
402
|
+
export type DataTableCellLinkProps = DataTableCellLinkCommun & Omit<ComponentProps<"a">, "children" | "className"> & {
|
|
403
|
+
href: string;
|
|
404
|
+
/** Lien du routeur de l'application ; par défaut, celui du
|
|
405
|
+
* `LienProvider`, sinon un `<a>`. */
|
|
406
|
+
lien?: LienComposant;
|
|
407
|
+
};
|
|
408
|
+
/** Bouton de cellule : une action sur place (ouvrir la modification…). */
|
|
409
|
+
export type DataTableCellButtonProps = DataTableCellLinkCommun & Omit<ComponentProps<"button">, "children" | "className"> & {
|
|
410
|
+
href?: never;
|
|
411
|
+
lien?: never;
|
|
412
|
+
};
|
|
413
|
+
/**
|
|
414
|
+
* Titre d'une ligne qui mène à sa fiche : un vrai lien (`href`, routeur par
|
|
415
|
+
* `lien` ou le `LienProvider`), ou un bouton sans `href` (ouvrir la modification). Le clic de
|
|
416
|
+
* ligne (`onActiverLigne`) n'est qu'un raccourci à la souris : ce lien est
|
|
417
|
+
* le chemin du clavier et des lecteurs d'écran, et garde l'ouverture dans un
|
|
418
|
+
* nouvel onglet.
|
|
419
|
+
*/
|
|
420
|
+
export declare function DataTableCellLink(props: DataTableCellLinkProps | DataTableCellButtonProps): import("react").JSX.Element;
|
|
263
421
|
export {};
|