@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.
Files changed (222) hide show
  1. package/README.md +438 -37
  2. package/dist/components/etic/action.d.ts +16 -7
  3. package/dist/components/etic/action.js +25 -25
  4. package/dist/components/etic/action.js.map +1 -1
  5. package/dist/components/etic/app-shell.d.ts +16 -7
  6. package/dist/components/etic/app-shell.js +92 -85
  7. package/dist/components/etic/app-shell.js.map +1 -1
  8. package/dist/components/etic/auth-image.d.ts +29 -6
  9. package/dist/components/etic/auth-image.js +41 -18
  10. package/dist/components/etic/auth-image.js.map +1 -1
  11. package/dist/components/etic/button-link.d.ts +19 -0
  12. package/dist/components/etic/button-link.js +19 -0
  13. package/dist/components/etic/button-link.js.map +1 -0
  14. package/dist/components/etic/centered-screen.d.ts +13 -0
  15. package/dist/components/etic/centered-screen.js +13 -0
  16. package/dist/components/etic/centered-screen.js.map +1 -0
  17. package/dist/components/etic/confirm-dialog.d.ts +33 -3
  18. package/dist/components/etic/confirm-dialog.js +92 -67
  19. package/dist/components/etic/confirm-dialog.js.map +1 -1
  20. package/dist/components/etic/copy-button.d.ts +3 -2
  21. package/dist/components/etic/copy-button.js +3 -3
  22. package/dist/components/etic/copy-button.js.map +1 -1
  23. package/dist/components/etic/data-table-bulk-actions.d.ts +28 -4
  24. package/dist/components/etic/data-table-bulk-actions.js +48 -41
  25. package/dist/components/etic/data-table-bulk-actions.js.map +1 -1
  26. package/dist/components/etic/data-table-focus.d.ts +17 -0
  27. package/dist/components/etic/data-table-focus.js +29 -0
  28. package/dist/components/etic/data-table-focus.js.map +1 -0
  29. package/dist/components/etic/data-table-format.d.ts +3 -10
  30. package/dist/components/etic/data-table-format.js +4 -3
  31. package/dist/components/etic/data-table-format.js.map +1 -1
  32. package/dist/components/etic/data-table-pagination.d.ts +20 -6
  33. package/dist/components/etic/data-table-pagination.js +73 -43
  34. package/dist/components/etic/data-table-pagination.js.map +1 -1
  35. package/dist/components/etic/data-table-toolbar.d.ts +34 -13
  36. package/dist/components/etic/data-table-toolbar.js +66 -62
  37. package/dist/components/etic/data-table-toolbar.js.map +1 -1
  38. package/dist/components/etic/data-table-view-options.d.ts +44 -4
  39. package/dist/components/etic/data-table-view-options.js +145 -98
  40. package/dist/components/etic/data-table-view-options.js.map +1 -1
  41. package/dist/components/etic/data-table.d.ts +173 -15
  42. package/dist/components/etic/data-table.js +381 -202
  43. package/dist/components/etic/data-table.js.map +1 -1
  44. package/dist/components/etic/date-picker.d.ts +5 -1
  45. package/dist/components/etic/date-picker.js +97 -84
  46. package/dist/components/etic/date-picker.js.map +1 -1
  47. package/dist/components/etic/delete-button.d.ts +12 -4
  48. package/dist/components/etic/delete-button.js +21 -22
  49. package/dist/components/etic/delete-button.js.map +1 -1
  50. package/dist/components/etic/detail-list.d.ts +16 -4
  51. package/dist/components/etic/detail-list.js +30 -20
  52. package/dist/components/etic/detail-list.js.map +1 -1
  53. package/dist/components/etic/disclosure.d.ts +52 -0
  54. package/dist/components/etic/disclosure.js +70 -0
  55. package/dist/components/etic/disclosure.js.map +1 -0
  56. package/dist/components/etic/draft-resume-dialog.d.ts +42 -0
  57. package/dist/components/etic/draft-resume-dialog.js +60 -0
  58. package/dist/components/etic/draft-resume-dialog.js.map +1 -0
  59. package/dist/components/etic/error-banner.js +34 -38
  60. package/dist/components/etic/error-banner.js.map +1 -1
  61. package/dist/components/etic/error-boundary.js +4 -3
  62. package/dist/components/etic/error-boundary.js.map +1 -1
  63. package/dist/components/etic/explained-badge.d.ts +26 -0
  64. package/dist/components/etic/explained-badge.js +17 -0
  65. package/dist/components/etic/explained-badge.js.map +1 -0
  66. package/dist/components/etic/file-upload.js +66 -71
  67. package/dist/components/etic/file-upload.js.map +1 -1
  68. package/dist/components/etic/form-dialog.d.ts +25 -2
  69. package/dist/components/etic/form-dialog.js +95 -77
  70. package/dist/components/etic/form-dialog.js.map +1 -1
  71. package/dist/components/etic/icon-toggle.d.ts +27 -9
  72. package/dist/components/etic/icon-toggle.js +31 -19
  73. package/dist/components/etic/icon-toggle.js.map +1 -1
  74. package/dist/components/etic/lien.d.ts +34 -0
  75. package/dist/components/etic/lien.js +17 -0
  76. package/dist/components/etic/lien.js.map +1 -0
  77. package/dist/components/etic/loading.d.ts +0 -8
  78. package/dist/components/etic/loading.js +17 -25
  79. package/dist/components/etic/loading.js.map +1 -1
  80. package/dist/components/etic/page-container.d.ts +10 -0
  81. package/dist/components/etic/page-container.js +9 -5
  82. package/dist/components/etic/page-container.js.map +1 -1
  83. package/dist/components/etic/page-header.d.ts +10 -4
  84. package/dist/components/etic/page-header.js +48 -43
  85. package/dist/components/etic/page-header.js.map +1 -1
  86. package/dist/components/etic/phone-input.d.ts +16 -0
  87. package/dist/components/etic/phone-input.js +71 -65
  88. package/dist/components/etic/phone-input.js.map +1 -1
  89. package/dist/components/etic/query-boundary.d.ts +25 -2
  90. package/dist/components/etic/query-boundary.js +24 -12
  91. package/dist/components/etic/query-boundary.js.map +1 -1
  92. package/dist/components/etic/removable-badge.d.ts +30 -0
  93. package/dist/components/etic/removable-badge.js +31 -0
  94. package/dist/components/etic/removable-badge.js.map +1 -0
  95. package/dist/components/etic/save-bar.d.ts +31 -0
  96. package/dist/components/etic/save-bar.js +45 -0
  97. package/dist/components/etic/save-bar.js.map +1 -0
  98. package/dist/components/etic/search-select.js +1 -1
  99. package/dist/components/etic/search-select.js.map +1 -1
  100. package/dist/components/etic/segmented-control.d.ts +6 -2
  101. package/dist/components/etic/segmented-control.js +28 -27
  102. package/dist/components/etic/segmented-control.js.map +1 -1
  103. package/dist/components/etic/stat-grid.d.ts +15 -0
  104. package/dist/components/etic/stat-grid.js +17 -0
  105. package/dist/components/etic/stat-grid.js.map +1 -0
  106. package/dist/components/etic/stat-tile.d.ts +1 -1
  107. package/dist/components/etic/stat-tile.js +12 -18
  108. package/dist/components/etic/stat-tile.js.map +1 -1
  109. package/dist/components/etic/status-badge.d.ts +2 -4
  110. package/dist/components/etic/status-badge.js +13 -23
  111. package/dist/components/etic/status-badge.js.map +1 -1
  112. package/dist/components/etic/tailles-dialogue.d.ts +8 -0
  113. package/dist/components/etic/tailles-dialogue.js +10 -0
  114. package/dist/components/etic/tailles-dialogue.js.map +1 -0
  115. package/dist/components/etic/theme-menu.d.ts +1 -2
  116. package/dist/components/etic/theme-menu.js +45 -41
  117. package/dist/components/etic/theme-menu.js.map +1 -1
  118. package/dist/components/etic/toggletip.d.ts +36 -0
  119. package/dist/components/etic/toggletip.js +59 -0
  120. package/dist/components/etic/toggletip.js.map +1 -0
  121. package/dist/components/etic/tooltip-button.d.ts +13 -3
  122. package/dist/components/etic/tooltip-button.js +19 -19
  123. package/dist/components/etic/tooltip-button.js.map +1 -1
  124. package/dist/components/etic/unsaved-changes.d.ts +41 -0
  125. package/dist/components/etic/unsaved-changes.js +17 -0
  126. package/dist/components/etic/unsaved-changes.js.map +1 -0
  127. package/dist/components/etic/use-draft-autosave.d.ts +3 -1
  128. package/dist/components/etic/use-draft-autosave.js +74 -78
  129. package/dist/components/etic/use-draft-autosave.js.map +1 -1
  130. package/dist/components/etic/use-unsaved-changes-warning.d.ts +10 -0
  131. package/dist/components/etic/use-unsaved-changes-warning.js +20 -0
  132. package/dist/components/etic/use-unsaved-changes-warning.js.map +1 -0
  133. package/dist/components/ui/alert-dialog.js +2 -2
  134. package/dist/components/ui/alert-dialog.js.map +1 -1
  135. package/dist/components/ui/avatar.d.ts +5 -1
  136. package/dist/components/ui/avatar.js +20 -11
  137. package/dist/components/ui/avatar.js.map +1 -1
  138. package/dist/components/ui/badge.d.ts +3 -2
  139. package/dist/components/ui/badge.js +27 -14
  140. package/dist/components/ui/badge.js.map +1 -1
  141. package/dist/components/ui/breadcrumb.js +13 -13
  142. package/dist/components/ui/button.d.ts +15 -2
  143. package/dist/components/ui/button.js +27 -15
  144. package/dist/components/ui/button.js.map +1 -1
  145. package/dist/components/ui/calendar.js +1 -1
  146. package/dist/components/ui/calendar.js.map +1 -1
  147. package/dist/components/ui/checkbox.js +1 -1
  148. package/dist/components/ui/checkbox.js.map +1 -1
  149. package/dist/components/ui/combobox.d.ts +2 -2
  150. package/dist/components/ui/combobox.js +45 -32
  151. package/dist/components/ui/combobox.js.map +1 -1
  152. package/dist/components/ui/dialog.d.ts +10 -1
  153. package/dist/components/ui/dialog.js +12 -5
  154. package/dist/components/ui/dialog.js.map +1 -1
  155. package/dist/components/ui/input-group.d.ts +1 -1
  156. package/dist/components/ui/popover.d.ts +1 -1
  157. package/dist/components/ui/popover.js +3 -2
  158. package/dist/components/ui/popover.js.map +1 -1
  159. package/dist/components/ui/progress.d.ts +16 -2
  160. package/dist/components/ui/progress.js +34 -26
  161. package/dist/components/ui/progress.js.map +1 -1
  162. package/dist/components/ui/radio-group.js +1 -1
  163. package/dist/components/ui/radio-group.js.map +1 -1
  164. package/dist/components/ui/select.d.ts +10 -2
  165. package/dist/components/ui/select.js +70 -50
  166. package/dist/components/ui/select.js.map +1 -1
  167. package/dist/components/ui/sidebar.d.ts +6 -1
  168. package/dist/components/ui/sidebar.js +92 -92
  169. package/dist/components/ui/sidebar.js.map +1 -1
  170. package/dist/components/ui/spinner.d.ts +7 -1
  171. package/dist/components/ui/spinner.js +9 -1
  172. package/dist/components/ui/spinner.js.map +1 -1
  173. package/dist/components/ui/switch.js +1 -1
  174. package/dist/components/ui/switch.js.map +1 -1
  175. package/dist/components/ui/table.js +1 -1
  176. package/dist/components/ui/table.js.map +1 -1
  177. package/dist/components/ui/tabs.js +2 -2
  178. package/dist/components/ui/tabs.js.map +1 -1
  179. package/dist/components/ui/tooltip.d.ts +7 -2
  180. package/dist/components/ui/tooltip.js +27 -19
  181. package/dist/components/ui/tooltip.js.map +1 -1
  182. package/dist/hooks/use-column-prefs.d.ts +84 -0
  183. package/dist/hooks/use-column-prefs.js +71 -0
  184. package/dist/hooks/use-column-prefs.js.map +1 -0
  185. package/dist/hooks/use-debounced-value.d.ts +13 -0
  186. package/dist/hooks/use-debounced-value.js +12 -0
  187. package/dist/hooks/use-debounced-value.js.map +1 -0
  188. package/dist/hooks/use-document-title.d.ts +5 -0
  189. package/dist/hooks/use-document-title.js +13 -0
  190. package/dist/hooks/use-document-title.js.map +1 -0
  191. package/dist/hooks/use-persisted-state.d.ts +43 -0
  192. package/dist/hooks/use-persisted-state.js +40 -0
  193. package/dist/hooks/use-persisted-state.js.map +1 -0
  194. package/dist/index.d.ts +40 -16
  195. package/dist/index.js +99 -76
  196. package/dist/lib/autofill.d.ts +18 -0
  197. package/dist/lib/autofill.js +10 -0
  198. package/dist/lib/autofill.js.map +1 -0
  199. package/dist/lib/dates.d.ts +20 -0
  200. package/dist/lib/dates.js +16 -0
  201. package/dist/lib/dates.js.map +1 -0
  202. package/dist/lib/focus-rendu.d.ts +24 -0
  203. package/dist/lib/focus-rendu.js +14 -0
  204. package/dist/lib/focus-rendu.js.map +1 -0
  205. package/dist/lib/format.d.ts +54 -0
  206. package/dist/lib/format.js +80 -0
  207. package/dist/lib/format.js.map +1 -0
  208. package/dist/lib/normalize.d.ts +28 -0
  209. package/dist/lib/normalize.js +21 -0
  210. package/dist/lib/normalize.js.map +1 -0
  211. package/dist/lib/ordre-colonnes.d.ts +15 -0
  212. package/dist/lib/ordre-colonnes.js +14 -0
  213. package/dist/lib/ordre-colonnes.js.map +1 -0
  214. package/dist/lib/ton.d.ts +23 -0
  215. package/dist/lib/ton.js +51 -0
  216. package/dist/lib/ton.js.map +1 -0
  217. package/dist/styles.css +110 -63
  218. package/dist/theme.d.ts +34 -0
  219. package/dist/theme.js +45 -0
  220. package/dist/theme.js.map +1 -0
  221. package/package.json +4 -2
  222. 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 (côté client,
33
- * ou côté serveur avec `triManuel`), visibilité et ordre des colonnes,
34
- * sélection et dépliage de lignes. Comme dans le guide Data Table de shadcn,
35
- * les colonnes se déclarent avec ce registre :
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
- * Rend le focus à un élément stable du tableau avant qu'un contrôle qui l'a
82
- * ne disparaisse (bandeau ou barre de sélection) : la case d'en-tête, sinon
83
- * le cadre lui-même.
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 focaliserTableau(racine: HTMLElement | null): void;
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 présentes dans
114
- * `donnees` : changer de page, de filtre ou supprimer des lignes la
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 {};