@etic-insa/ui 0.2.0 → 0.4.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 +490 -52
  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 +20 -8
  6. package/dist/components/etic/app-shell.js +164 -120
  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 +41 -4
  24. package/dist/components/etic/data-table-bulk-actions.js +114 -60
  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 +183 -17
  42. package/dist/components/etic/data-table.js +396 -241
  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 +18 -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 +71 -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 +19 -5
  84. package/dist/components/etic/page-header.js +60 -44
  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 +39 -0
  94. package/dist/components/etic/removable-badge.js.map +1 -0
  95. package/dist/components/etic/save-bar.d.ts +32 -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 +10 -3
  107. package/dist/components/etic/stat-tile.js +32 -24
  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 +29 -2
  116. package/dist/components/etic/theme-menu.js +75 -44
  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 +17 -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 +29 -17
  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 +141 -56
  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
package/README.md CHANGED
@@ -67,6 +67,75 @@ liens survolés) : c'est corrigé dans `src/components/ui/`, et `npm test` écho
67
67
 
68
68
  Le thème sombre s'active par la classe `dark` sur `<html>`.
69
69
 
70
+ Les neutres (fonds, panneaux, bordures, textes) sont ceux de la couleur de base `zinc` de
71
+ shadcn (palette `zinc` de Tailwind 4, gris froid presque neutre), communs à toute la suite : une
72
+ application ne les redéfinit pas. Ce sont exactement les valeurs du preset, contraste faible
73
+ compris (texte secondaire zinc-500 : 4,39:1 sur `--muted` en clair), sauf les écarts décidés
74
+ pour ETIC : `--page`, barre latérale blanche en clair, `--control-border`, couleurs
75
+ sémantiques. `src/theme.test.ts` compare chaque jeton au registre et vérifie les contrastes.
76
+
77
+ Le fond de la page elle-même est un jeton ajouté, `--page` (classe `bg-page`) : zinc-50 en
78
+ clair, si bien que cartes et menus blancs s'en détachent (en sombre, il vaut
79
+ `--background` et les cartes sont déjà plus claires). Le `body` et le contenu d'`AppShell`
80
+ le prennent ; un conteneur pleine page d'une application aussi, plutôt que `bg-background`,
81
+ qui reste la surface blanche de shadcn (onglet actif, bouton `outline`, calendrier…).
82
+ `color-scheme` suit le thème (`light`, `dark`) : barres de défilement et contrôles natifs
83
+ compris.
84
+
85
+ Un tableau se détache de la surface qui le porte : son cadre est en `bg-tableau` (jeton
86
+ ajouté), qui vaut `--card` sur la page et `--tableau-encart` (jeton ajouté, un cran plus
87
+ sombre que la carte) dans une surface surélevée — toute surface de la bibliothèque peinte en `bg-card` ou `bg-popover` : `Card`
88
+ (donc `SectionCard`), `Alert`, dialogue, `AlertDialog`, tiroir (`Sheet`), popover, menu
89
+ déroulant, liste d'un `Select` ou d'un `Combobox`, `SaveBar`, barre d'actions groupées, barre
90
+ latérale, `Disclosure` `variante="carte"`. La liste de ces surfaces est tenue une fois dans
91
+ `styles.css` (règle qui pose `--tableau-fond`, héritée) ; le cadre de `DataTable` la suit sans
92
+ rien à passer. Un cadre de tableau propre à une application prend `bg-tableau` plutôt que
93
+ `bg-card`. Dans une surface, l'écart de fond est le même, discret, dans les deux thèmes (1,05:1,
94
+ le filet `--border` le rend net) : le tableau se détache de sa carte sans s'y creuser. Les lignes gardent le
95
+ survol et la sélection de shadcn (`bg-muted/50`, `bg-muted`).
96
+
97
+ #### Thème clair, sombre ou système
98
+
99
+ `appliquerTheme(theme)` pose la classe `dark` sur `<html>` pour `"dark"`, la retire pour
100
+ `"light"` et, pour `"system"`, suit `prefers-color-scheme`, y compris quand le système change.
101
+ La préférence vient du compte (`theme` de `@etic-insa/auth`) ; `useThemeApplique` la peint,
102
+ la mémorise dans ce navigateur (`localStorage`, clé `"etic-theme"`) et suit un changement
103
+ fait dans un autre onglet. Une valeur `null` ou inconnue vaut `"system"`. Le rappel est
104
+ obligatoire : sans lui, l'état de l'application garderait l'ancien thème et le rechoisir ne
105
+ changerait rien.
106
+
107
+ ```tsx
108
+ import { useThemeApplique } from "@etic-insa/ui"
109
+
110
+ // Une fois, près de la racine : thème du compte, undefined tant qu'il n'est pas chargé.
111
+ useThemeApplique(me?.preferences?.theme, (theme) => {
112
+ /* autre onglet : aligner l'état local sans rappeler le serveur */
113
+ })
114
+ ```
115
+
116
+ Hors de React (atelier, page sans compte), `appliquerTheme` seul : il ne mémorise rien.
117
+
118
+ Pour que la première image soit déjà dans le bon thème, avant le chargement du compte,
119
+ l'application charge le script de démarrage du paquet dans `<head>`, avant le bundle, sans
120
+ `type="module"`, depuis sa propre origine (une CSP `script-src 'self'` l'admet) :
121
+
122
+ ```html
123
+ <script src="/theme-boot.js"></script>
124
+ ```
125
+
126
+ Vite ne regroupe pas un script classique : le copier dans `public/` avant `dev` et `build`
127
+ (copie ignorée dans git) :
128
+
129
+ ```json
130
+ "scripts": {
131
+ "theme-boot": "node -e \"const fs = require('fs'); fs.mkdirSync('public', { recursive: true }); fs.copyFileSync(require.resolve('@etic-insa/ui/theme-boot.js'), 'public/theme-boot.js')\"",
132
+ "predev": "npm run theme-boot",
133
+ "prebuild": "npm run theme-boot"
134
+ }
135
+ ```
136
+
137
+ Il relit le thème mémorisé ; sans thème mémorisé, il suit le système.
138
+
70
139
  ```tsx
71
140
  import { Button } from "@etic-insa/ui"
72
141
 
@@ -134,8 +203,11 @@ export function Groupes() {
134
203
  }
135
204
  ```
136
205
 
137
- `onValeurChange` peut renvoyer une promesse : rejetée, elle affiche « Thème non enregistré »
138
- quelques secondes. La déconnexion (`onSeDeconnecter`) est toujours confirmée ; une entrée du
206
+ Le thème est une entrée du menu du compte (« Thème : Sombre », qui ouvre Clair / Système /
207
+ Sombre), comme dans le `nav-user` de shadcn : le pied de la barre ne porte que le compte, sur
208
+ toute sa largeur. Dans le tiroir mobile, trop étroit pour un sous-menu, les trois choix sont
209
+ dans le menu. Sans `compte`, il garde son propre bouton. `onValeurChange` peut renvoyer une
210
+ promesse : rejetée, elle affiche « Thème non enregistré » quelques secondes. La déconnexion (`onSeDeconnecter`) est toujours confirmée ; une entrée du
139
211
  menu du compte est un lien (`href`) ou une action (`onChoisir`). La coquille fournit l'élément
140
212
  `<main>` : les pages n'en ajoutent pas. Elle ouvre la tabulation par un lien « Aller au
141
213
  contenu », visible au focus, qui met le focus sur ce `<main>`. Sur ordinateur, un bouton de
@@ -144,6 +216,23 @@ gras d'un éditeur). Sur mobile, la page réserve en haut la hauteur de la barre
144
216
  (`scroll-padding-top`) : une ancre ne s'arrête pas dessous. `ThemeMenu` existe aussi seul
145
217
  (page de connexion…) ; son `className` va sur le bouton.
146
218
 
219
+ Le composant de lien du routeur se donne une fois, autour de l'application :
220
+ `<LienProvider lien={LienRouteur}>`, où `LienRouteur` est une référence stable, définie
221
+ au niveau du module (un composant écrit en ligne serait nouveau à chaque rendu, et React
222
+ remonterait tous les liens). `AppShell`, `DetailHeader`, `ButtonLink` et
223
+ `DataTableCellLink` le prennent alors par défaut, sans `lien={…}` à chaque appel ; leur
224
+ prop `lien` reste prioritaire. Téléchargement ou adresse externe : `lien="a"` (un vrai
225
+ `<a>`, rechargement complet). Sans fournisseur ni prop, un `<a>`. `useLien(lien?)` rend le
226
+ même choix aux liens propres de l'application (`const Lien = useLien()`) ; le type
227
+ `LienComposant` le décrit (`AppShellLienComposant`, son ancien nom, est déprécié).
228
+
229
+ `bandeau` (un `ErrorBanner` qui concerne toute l'application…) s'affiche au-dessus du
230
+ contenu avec les marges latérales de `PageContainer` : l'application le passe nu. Un bandeau
231
+ qui ne rend rien (`ErrorBanner` sans erreur) ne laisse pas d'espace vide. Il prend toute la
232
+ largeur du contenu, car la coquille ignore la `largeur` de la page : sur grand écran, il
233
+ déborde d'une page étroite (`largeur="md"`). Il sert donc aux messages de toute
234
+ l'application ; un message propre à une page se place dans son `PageContainer`.
235
+
147
236
  `PageContainer` est le conteneur de chaque page dans `AppShell` : marges (16 px sur
148
237
  téléphone, 24 puis 32 px au-delà), espacement vertical régulier entre les blocs (`gap-6`),
149
238
  et `largeur` maximale centrée (`md`, `lg`, `xl`, ou `full` par défaut). Les pages ne posent
@@ -155,21 +244,32 @@ Compositions des primitives shadcn pour les états d'une page et les actions cou
155
244
  connaissent ni l'API ni le routeur : l'application fournit ses fonctions (envoi, suppression,
156
245
  chargement d'une image) et, au besoin, son composant de lien (`lien`, comme pour `AppShell`).
157
246
 
158
- | Composant | Rôle |
159
- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
160
- | `ConfirmDialog` | Confirmation (`AlertDialog`) : `titre` qui nomme l'action, `description` qui nomme ce qu'elle touche, `saisie` pour exiger de taper une valeur non affichée (action critique). L'erreur de l'action s'affiche dans le dialogue, qui reste ouvert. |
161
- | `FormDialog` | Formulaire dans un `Dialog` : pied « Annuler / Enregistrer », curseur dans le premier champ à remplir, état d'envoi (champs figés), erreur en tête, `taille` `sm` à `xl`, `verrouEnvoi` pour dire pourquoi l'envoi est impossible. Les contraintes des champs (`required`, `type`, `pattern`…) sont vérifiées sans la bulle du navigateur : la liste des champs à corriger s'affiche en français. |
162
- | `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs. |
163
- | `PageHeader`, `DetailHeader` | En-tête de page (`<h1>`, description, actions) ; en-tête de fiche avec fil d'Ariane (`chemin`), badges, méta, actions et menu « Plus d'actions » (`actionsSecondaires` : `onChoisir`, `destructif`, `verrou` affiché sous le libellé), `compact` quand la fiche répète déjà son nom. |
164
- | `SectionCard`, `DetailList`, `DetailItem` | Carte de section titrée (`<h2>`) ; grille `<dl>` de paires libellé / valeur, « — » pour une valeur absente (`null`, `undefined`, `false`, chaîne vide). |
165
- | `ErrorBanner` | `Alert` destructive : message, code, détail technique replié (même circulaire), « Réessayer » (`onReessayer`, occupé pendant `enCours`). Lit toute erreur ayant un `message` (et `code`, `details`). |
166
- | `ErrorBoundary` | Filet sous le rendu : message, détail technique, « Réessayer », « Retour à l'accueil » ; `cleReinitialisation` (la route) l'efface. Le focus perdu avec la partie cassée passe sur le message. |
167
- | `EmptyState`, `Loading`, `SkeletonTable`, `SkeletonCard`, `SkeletonPage` | État vide (`Empty` dans un cadre pointillé, `icone` lucide : `icone={InboxIcon}`) ; attente annoncée (`Spinner`) ; squelettes de tableau, de carte et de fiche, un seul statut « Chargement… » chacun. |
168
- | `QueryBoundary` | Chargement, erreur (avec « Réessayer »), vide et données d'une requête ; accepte tel quel le résultat de `useQuery`. L'échec d'une actualisation garde les données, montées, sous le bandeau d'erreur ; pendant une nouvelle tentative, le bandeau reste, son bouton occupé. Sans enveloppe : rendu dans le parent, qui règle l'espacement. |
169
- | `StatTile`, `StatusBadge` | Chiffre clé d'un résumé ; badge d'état à pastille. `ton` (type `StatusTon`) : `neutral`, `success`, `warning`, `destructive`. |
170
- | `CopyButton`, `DeleteButton`, `IconToggle` | Copie avec retour « Copié ! », ou « Copie impossible » si le navigateur refuse (`onCopie`, `onEchec`) ; corbeille qui ouvre une confirmation ; bouton à icône qui pose ou retire un marqueur (`Toggle`, `aria-pressed`, `onActifChange`, `enCours` occupé sans perdre le focus). Tous ont une infobulle, et `verrou` pour dire pourquoi l'action est impossible. |
171
- | `TooltipButton` | `Button` avec infobulle et état `verrou` (désactivé mais focalisable, la raison en infobulle) : la règle pour tout bouton à icône seule. |
172
- | `AuthAvatar`, `AuthImage`, `useAuthObjectUrl` | Image servie par une adresse authentifiée : l'application passe `charger(src, signal)` (type `AuthImageCharger`) qui renvoie le `Blob` ; l'avatar garde les initiales tant que la photo manque. |
247
+ | Composant | Rôle |
248
+ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
249
+ | `ConfirmDialog` | Confirmation (`AlertDialog`) : `titre` qui nomme l'action, `description` qui nomme ce qu'elle touche, `saisie` pour exiger de taper une valeur non affichée (action critique). L'erreur de l'action s'affiche dans le dialogue, qui reste ouvert. |
250
+ | `FormDialog` | Formulaire dans un `Dialog` : pied « Annuler / Enregistrer », curseur dans le premier champ à remplir, état d'envoi (champs figés), erreur en tête, `taille` `sm` à `xl`, `verrouEnvoi` pour dire pourquoi l'envoi est impossible. Les contraintes des champs (`required`, `type`, `pattern`…) sont vérifiées sans la bulle du navigateur : la liste des champs à corriger s'affiche en français. |
251
+ | `DraftResumeDialog` | Ouverture d'un utilitaire à brouillon (compagnon de `useDraftAutosave`) : « Quitter », `libelleRepartir` (suppression du brouillon, `onRepartir` attendue, bouton occupé, erreur affichée, comme `erreur` venue d'ailleurs) et « Reprendre au même point » si `reprenable`. Sans croix ; Échap quitte, jamais pendant la suppression. |
252
+ | `UnsavedChangesDialog`, `useUnsavedChangesWarning` | Garde « modifications non enregistrées », sans routeur : `useUnsavedChangesWarning(modifie)` (booléen, ou fonction lue au moment de quitter) retient la fermeture de l'onglet ; le dialogue confirme une navigation retenue par l'application (`blocage` : `state`, `proceed`, `reset`, la forme du `useBlocker` de react-router). |
253
+ | `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs. |
254
+ | `PageHeader`, `DetailHeader` | En-tête de page (`<h1>`, description, actions) ; en-tête de fiche avec fil d'Ariane (`chemin`), badges, méta, actions et menu « Plus d'actions » (`actionsSecondaires` : `onChoisir`, `destructif`, `verrou` affiché sous le libellé), `compact` quand la fiche répète déjà son nom. |
255
+ | `SectionCard`, `DetailList`, `DetailItem` | Carte de section titrée (`<h2>`) ; liste `<dl>` de paires libellé / valeur, « — » pour une valeur absente (`null`, `undefined`, `false`, chaîne vide). `disposition` : `grille` (défaut, autant de colonnes de 14rem que la largeur en permet, quatre au plus : une liste courte laisse de l'air à droite sans tenir dans un coin), `pile` (une seule colonne, libellé au-dessus de la valeur : carte étroite, dialogue, valeurs longues), `ligne` (métadonnées secondaires : « libellé : valeur » en petit et en discret, l'une après l'autre). |
256
+ | `ErrorBanner` | `Alert` destructive : message, code, détail technique replié (même circulaire), « Réessayer » (`onReessayer`, occupé pendant `enCours`). Lit toute erreur ayant un `message` (et `code`, `details`). |
257
+ | `ErrorBoundary` | Filet sous le rendu : message, détail technique, « Réessayer », « Retour à l'accueil » ; `cleReinitialisation` (la route) l'efface. Le focus perdu avec la partie cassée passe sur le message. |
258
+ | `EmptyState`, `Loading`, `SkeletonTable`, `SkeletonCard`, `SkeletonPage` | État vide (`Empty` dans un cadre pointillé, `icone` lucide : `icone={InboxIcon}`) ; attente annoncée (`Spinner`) ; squelettes de tableau, de carte et de fiche, un seul statut « Chargement… » chacun. |
259
+ | `QueryBoundary` | Chargement, erreur (avec « Réessayer »), vide et données d'une requête ; accepte tel quel le résultat de `useQuery`. L'échec d'une actualisation garde les données, montées, sous le bandeau d'erreur ; pendant une nouvelle tentative, le bandeau reste, son bouton occupé. Sans enveloppe : rendu dans le parent, qui règle l'espacement. |
260
+ | `QueryBoundary introuvable` | Fiche : `introuvable` (texte ou nœud, avec un lien de retour) remplace le bandeau quand l'erreur porte un `status` 404 (`ErreurApi` de `@etic-insa/auth`, ou même forme), sans « Réessayer ». Les autres échecs gardent le bandeau : une panne n'est jamais annoncée « introuvable ». |
261
+ | `QueryErrorBanner` | Le bandeau d'erreur de `QueryBoundary`, seul (`requete` : `isError`, `error`, `isFetching`, `refetch`), pour une page qui place elle-même ses données ; rien tant que la requête n'a pas échoué. Accepte `titre`, `description`, `className` d'`ErrorBanner`. |
262
+ | `Disclosure`, `DisclosureTrigger` | Section repliable à chevron tournant, fermée par défaut : `titre`, `compteur` en pastille, `variante` `lien` (en ligne), `discret` (fantôme estompé) ou `carte` (bloc encadré), `defautOuvert` ou `ouvert` / `onOuvertChange`. `DisclosureTrigger` seul pour un `Collapsible` composé à la main. |
263
+ | `CenteredScreen` | Écran hors de la coquille (connexion, page introuvable, vérification de session) : le `<main>` de la page, contenu centré sur toute la hauteur, fond estompé. |
264
+ | `StatTile`, `StatGrid`, `StatusBadge` | Chiffre clé d'un résumé (`href` : toute la tuile mène au détail, avec un chevron ; `lien` du routeur, ou celui du `LienProvider`) ; rangée de tuiles (colonnes de `largeurMin` au moins, 190 px par défaut, une seule sur téléphone) ; badge d'état à pastille. `ton` (type `StatusTon`) : `neutral`, `info`, `success`, `warning`, `destructive` ; il colore aussi `Progress` (8 px avec `size="lg"`), le segment choisi d'un `SegmentedControl` et un `IconToggle` actif. |
265
+ | `RemovableBadge`, `ExplainedBadge` | Badge de 28 px (`size="lg"`, aussi pour les badges sans croix de la même liste) terminé par une croix « Retirer » (`onRetirer`, `libelleRetirer`, `enCours`, `verrou`) ; seul le premier élément du libellé se coupe, un marqueur qui le suit (cadenas) reste entier et centré ; badge dont l'`explication` s'ouvre au toucher, au clic, au survol et au focus (un `Toggletip`) et se lit après lui (`render` : un autre porteur, `<time>` par exemple). |
266
+ | `Toggletip` | Explication d'un élément qui n'est pas une action (date, sigle) : bulle sur `Popover`, ouverte au toucher, au clic, au survol et au focus, fermée au toucher ailleurs, à Échap ou quand le focus part ; clic sans effet sur un parent cliquable ; lue après le contenu (`texteLu`) ; dans un badge, la bulle part de son contour. Un bouton qui agit garde son infobulle (`TooltipButton`). |
267
+ | `SaveBar` | Pied d'un formulaire de page : « Enregistrer » (soumet le formulaire, ou `onEnregistrer`), occupé mais focalisable pendant `enCours` ; « Annuler » avec `onAnnuler` ; statut annoncé : « Enregistré » (`enregistre`), « Modifications non enregistrées » (`modifie`). `collante` : pied d'un long formulaire, collé en bas de l'écran sur une carte opaque tant qu'il y a des modifications (`modifie`) ou un envoi en cours, à sa place et sans carte sinon. |
268
+ | `CopyButton`, `DeleteButton`, `IconToggle` | Copie avec retour « Copié ! », ou « Copie impossible » si le navigateur refuse (`onCopie`, `onEchec`) ; corbeille qui ouvre une confirmation ; bouton à icône qui pose ou retire un marqueur (`Toggle`, `aria-pressed`, `onActifChange`, `enCours` occupé sans perdre le focus ; actif, en couleur de son `ton`, `warning` par défaut). Tous ont une infobulle, et `verrou` pour dire pourquoi l'action est impossible. |
269
+ | `TooltipButton` | `Button` avec infobulle et état `verrou` (désactivé mais focalisable, la raison en infobulle) : la règle pour tout bouton à icône seule, que l'infobulle nomme (`aria-label`, sauf nom donné). `destructif` : gris, rouge au survol seulement (corbeille, retrait dans une liste). |
270
+ | `ButtonLink` | Lien à l'allure de bouton (`variant`, `size` de `Button`), annoncé comme un lien ; `lien` : le composant de lien du routeur, par défaut celui du `LienProvider` (`<a>` sans lui ; `lien="a"` force un rechargement complet). |
271
+ | `AuthAvatar`, `AuthImage`, `useAuthObjectUrl` | Image servie par une adresse authentifiée : l'application passe `charger(src, signal)` (type `AuthImageCharger`) qui renvoie le `Blob` ; l'avatar garde les initiales tant que la photo manque. |
272
+ | `useAuthObjectUrlEtat`, `secoursEchec`, `diametre` | État complet d'une image authentifiée (`url`, `enCours`, `echec`, `erreur`) pour dire « indisponible » plutôt que charger sans fin ; `secoursEchec` d'`AuthImage` en cas d'échec ; `diametre` (px) d'`AuthAvatar` et d'`Avatar`, initiales proportionnées (leur graisse suit la racine). |
173
273
 
174
274
  `ConfirmDialog` et `FormDialog` s'ouvrent par un `declencheur`, ou sont contrôlés (`ouvert`,
175
275
  `onOuvertChange`). `DeleteButton` est son propre déclencheur ; `ouvert` et `onOuvertChange`
@@ -180,11 +280,51 @@ effet), se ferme si elle aboutit, affiche l'erreur si elle échoue. Avec TanStac
180
280
  reste ouvert sans erreur : suppression en deux temps, où la page change sa question (la
181
281
  description de `ConfirmDialog` est une région polie : la nouvelle est lue).
182
282
 
283
+ Hors de ces dialogues, un bouton qui lance une action longue passe `enCours` au `Button` (ou au
284
+ `TooltipButton`) : la roue remplace ses icônes, `libelleEnCours` (« Suppression… ») son texte,
285
+ et il reste focalisable (`aria-busy`, clics ignorés, curseur d'attente, pas de survol). Un
286
+ dialogue composé à la main s'ouvre normalement mais refuse de se fermer pendant l'action avec
287
+ `onOpenChange={fermerSaufEnCours(enCours, setOuvert)}`. Un lien dans
288
+ une phrase ou une cellule : `<Button variant="link" size="inline">`. `SpinnerDecoratif` est
289
+ la roue muette, à côté d'un texte qui dit déjà l'attente. Un `CopyButton` placé dans un
290
+ `InputGroupAddon` passe à 24 px, comme le bouton de shadcn dans un groupe (sauf `size` donnée).
291
+
183
292
  Un envoi de `FormDialog` refusé par les contraintes marque chaque champ fautif
184
293
  (`aria-invalid`, retiré dès qu'il est corrigé) et le nomme par son libellé, y compris une
185
294
  liste (`Select`, `SearchSelect`…) dont l'entrée cachée porte la valeur : le libellé de son
186
295
  `FormField`, et le focus va à son contrôle visible.
187
296
 
297
+ Options de `ConfirmDialog` : `verrou` (confirmation impossible, et pourquoi : bouton focalisable,
298
+ raison en infobulle et en description), `libelleAnnuler` (« Revenir au tableau »), `taille`
299
+ (`sm` par défaut, `md` ou `lg` pour un récapitulatif), `elements` et `libelleElements` (liste
300
+ nommée des éléments concernés, qui défile au-delà d'une dizaine de lignes), `onAnnuler`
301
+ (appelé quand la personne renonce : « Annuler » ou Échap ; jamais après une
302
+ réussite, alors que `onOuvertChange(false)` suit les deux). Si `saisie.attendu` change pendant
303
+ l'ouverture (le nombre d'éléments a changé côté serveur), la saisie est vidée, sans remonter le
304
+ dialogue : pas de `key` à forcer. `FormDialog` prend `libelleAnnuler` (« Plus tard ») et
305
+ `actionSecondaire` (`libelle`, `onChoisir`, `destructif`) : une troisième sortie discrète en
306
+ tête du pied (« Se déconnecter »), indisponible pendant l'envoi, qui ne ferme pas le dialogue
307
+ d'elle-même ; si `onChoisir` renvoie une promesse, le dialogue l'attend comme un envoi (ce
308
+ bouton en cours, le reste figé, erreur en tête), et `destructif` la rend grise, rouge au
309
+ survol (comme `TooltipButton`). Les boutons occupés de ces dialogues, de « Réessayer »
310
+ (`ErrorBanner`), de `FileUploadButton` et d'`IconToggle` sont tous le `Button` en cours. Sans champ où l'on tape, il s'ouvre sur le premier contrôle actif et affiché (case,
311
+ liste, choix segmenté… ; un panneau replié est ignoré). Tous les dialogues plafonnent leur
312
+ hauteur à l'écran et gardent le focus : Tab et Maj+Tab en font le tour sans en sortir. Dans
313
+ `FormDialog`, `ConfirmDialog` et `DraftResumeDialog`, seul le corps défile : titre, croix et
314
+ pied restent visibles. Un dialogue composé à la main obtient la même chose en plaçant son
315
+ contenu dans `DialogBody` (aussi dans un `AlertDialogContent`) ; sans lui, tout le contenu
316
+ défile.
317
+
318
+ ```tsx
319
+ // Garde « modifications non enregistrées » avec react-router (routeur « data »).
320
+ useUnsavedChangesWarning(modifie)
321
+ const blocage = useBlocker(
322
+ ({ currentLocation, nextLocation }) =>
323
+ modifie && currentLocation.pathname !== nextLocation.pathname
324
+ )
325
+ <UnsavedChangesDialog blocage={blocage} />
326
+ ```
327
+
188
328
  Une action qui fait disparaître le déclencheur (ligne supprimée) passe `finalFocus` (un ref
189
329
  ou une fonction, comme le `finalFocus` de Base UI) : le focus va à la ligne suivante ou au
190
330
  titre de la liste au lieu de tomber sur la page.
@@ -282,12 +422,24 @@ obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe
282
422
  mois et de l'année (`listesMoisAnnee`, pour une date de naissance), bouton d'effacement.
283
423
  Valeur : `Date`. Une saisie illisible ou hors bornes dit pourquoi sous le champ, bloque
284
424
  l'envoi d'un formulaire natif, et `onValeurChange(undefined, { invalide: true })` prévient
285
- l'application (à bloquer avant l'envoi).
425
+ l'application (à bloquer avant l'envoi). `moisInitial` : mois montré à l'ouverture tant
426
+ qu'aucune date n'est choisie (une date de naissance s'ouvre ainsi vingt ans plus tôt, pas
427
+ sur le mois courant), et où il revient quand la date est effacée. Fermé au clavier ou par
428
+ un jour choisi, le calendrier rend le focus au champ (un Échap de plus ferme le dialogue
429
+ englobant, sans infobulle à fermer d'abord) ; après un clic ailleurs, le focus reste où
430
+ l'on a cliqué.
286
431
  - `PhoneInput` : sélecteur de pays (Combobox : drapeau et indicatif, recherche sur le nom du
287
432
  pays ou l'indicatif) et numéro, lus et validés par
288
433
  libphonenumber-js. `onValeurChange(valeur, { valide, pays })` reçoit l'E.164
289
434
  (`+33612345678`) dès que la longueur est possible ; un numéro tapé avec « + » choisit le
290
- pays.
435
+ pays. En erreur (`aria-invalid` du numéro), le groupe est traité comme un seul champ :
436
+ bordure rouge sur le sélecteur de pays comme sur le numéro, un seul halo autour des deux.
437
+ `formaterTelephone(numero, { paysParDefaut = "FR" })` écrit un numéro pour l'affichage
438
+ hors d'un champ (fiche, liste), sans drapeau : national pour le pays par défaut
439
+ (`06 55 18 92 45`), international pour tout autre, pour que son pays se lise
440
+ (`+44 20 7946 0958`), tel quel s'il est illisible. Le `PhoneInput`, lui, écrit toujours le
441
+ format national, le pays étant montré par son drapeau. Chaque appel relit le numéro :
442
+ dans une longue liste, mémoïser le résultat.
291
443
  - `SearchSelect` : choix dans une longue liste cherchée par l'application.
292
444
  `rechercher(texte, signal)` renvoie une promesse (texte vide : premières suggestions) ;
293
445
  `libelleElement`, `idElement` et `rendreOption` décrivent un élément. Anti-rebond,
@@ -296,7 +448,19 @@ obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe
296
448
  à la console ; au clavier, Entrée dans le champ relance la recherche, même identique),
297
449
  liste vide (`vide`) et effacement sont gérés. Sans élément choisi, le texte tapé reste
298
450
  quand la liste se ferme (Entrée, Tab), et la recherche reprend à la réouverture. `form`
299
- va, comme `name`, à l'entrée cachée qui porte la valeur.
451
+ va, comme `name`, à l'entrée cachée qui porte la valeur. La liste s'aligne sur le cadre du
452
+ champ, loupe comprise (comme toute liste d'un `ComboboxInput`).
453
+ - `Select` (shadcn) : la liste s'ouvre sous le champ, alignée à gauche, sans jamais le
454
+ recouvrir (`alignItemWithTrigger` et `align` restent réglables sur `SelectContent`).
455
+ Elle prend la largeur de ses options, au moins celle du champ et au plus l'espace
456
+ disponible ; une option plus longue encore passe à la ligne au lieu d'être coupée. Dans le
457
+ champ, une valeur trop longue finit par « … ».
458
+ Les options vont dans un `SelectGroup`, comme chez shadcn ; posées directement dans
459
+ `SelectContent`, elles ont la même marge. Sans option (y compris un `SelectGroup` vide),
460
+ la liste dit « Aucune option. » (`vide` de `SelectContent`), dans une zone de statut
461
+ annoncée aux lecteurs d'écran. `SelectItem` prend une `description` sous son libellé,
462
+ reliée à l'option : la raison d'une option figée (`disabled`), qui reste lisible quand le
463
+ libellé s'estompe ; le libellé passe alors à la ligne plutôt que d'être coupé.
300
464
  - `FileUploadButton` et `FileDropZone` : bouton, ou zone de glisser-déposer avec bouton, sur
301
465
  react-dropzone. Types (`accepter={{ "text/csv": [".csv"] }}`) et taille (`tailleMax`, en
302
466
  octets) vérifiés, refus en français : à `onRefuser` pour les deux, et affichés dans la zone
@@ -306,10 +470,11 @@ obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe
306
470
  focalisé, indisponible, et l'envoi est annoncé. `FileUploadButton` relaie les props de
307
471
  `Button` (`id`, `aria-*` : il fonctionne dans un `FormField`).
308
472
  - `SegmentedControl` : choix exclusif en boutons joints (`ToggleGroup`), sans désélection ;
309
- le segment choisi prend, en plus du fond `bg-muted`, un liseré intérieur. L'`infobulle`
473
+ le segment choisi prend, en plus du fond `bg-muted`, un liseré intérieur, ou la couleur
474
+ du `ton` de son option (celle de l'état que produit le choix). L'`infobulle`
310
475
  d'une option nomme un segment à icône seule, sans masquer un libellé texte.
311
476
  - `CheckboxList` : plusieurs valeurs parmi une liste de cases (`CheckboxGroup` de Base UI) ;
312
- la `description` d'une option est reliée à sa case.
477
+ la `description` d'une option est reliée à sa case. Une case figée n'estompe que sa ligne.
313
478
  - `useDraftAutosave({ contenu, enregistrer })` : sauvegarde automatique d'un brouillon là où
314
479
  l'application le range (API ou stockage du navigateur) — anti-rebond, sans doublon, une
315
480
  écriture à la fois, version pour un verrou optimiste, `erreur` et `reessayer()`, alerte à la
@@ -356,18 +521,22 @@ La famille `DataTable` suit le [guide Data Table de shadcn](https://ui.shadcn.co
356
521
  sur [TanStack Table v9](https://tanstack.com/table/latest) : les colonnes se déclarent avec
357
522
  l'assistant typé, `useDataTable` crée l'instance, les composants la reçoivent en `table`.
358
523
 
359
- | Composant | Rôle |
360
- | -------------------------- | -------------------------------------------------------------------------------------------- |
361
- | `useDataTable` | instance TanStack : tri (client, ou serveur avec `triManuel`), colonnes, sélection, dépliage |
362
- | `DataTable` | la Table de shadcn ; état vide, lignes fantômes du chargement, clic de ligne, détail déplié |
363
- | `DataTableColumnHeader` | en-tête triable : un clic trie par ordre croissant, le suivant inverse le sens |
364
- | `dataTableSelectionColumn` | colonne de cases ; Maj+clic sélectionne une plage ; raison d'une case verrouillée |
365
- | `dataTableExpandColumn` | colonne du chevron qui déplie une ligne (`aria-expanded`, `aria-controls`) |
366
- | `DataTableRowActions` | menu « … » d'une ligne |
367
- | `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
368
- | `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
369
- | `DataTablePagination` | pagination par décalage (offset/limit, total connu), nombre de lignes par page |
370
- | `DataTableBulkActions` | barre d'actions groupées, collante en bas, avec la sélection ; Échap désélectionne |
524
+ | Composant | Rôle |
525
+ | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
526
+ | `useDataTable` | instance TanStack : tri, filtre et pagination (côté client, ou serveur avec `triManuel`), colonnes, sélection, dépliage |
527
+ | `DataTable` | la Table de shadcn ; état vide, lignes fantômes du chargement, bandeau d'erreur (`requete`), clic de ligne, détail déplié |
528
+ | `DataTableColumnHeader` | en-tête triable : un clic trie par ordre croissant, le suivant inverse le sens |
529
+ | `dataTableSelectionColumn` | colonne de cases ; Maj+clic sélectionne une plage ; raison d'une case verrouillée |
530
+ | `dataTableExpandColumn` | colonne du chevron qui déplie une ligne (`aria-expanded`, `aria-controls`) |
531
+ | `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite |
532
+ | `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton |
533
+ | `DataTableRowActions` | menu « … » d'une ligne |
534
+ | `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
535
+ | `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
536
+ | `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`) |
537
+ | `DataTableBulkActions` | barre d'actions groupées, collante en bas, avec la sélection ; actions moins fréquentes dans « … » (`actionsSecondaires`) ; croix et Échap désélectionnent |
538
+ | `useColumnPrefs` | colonnes affichées et leur ordre, gardés dans le navigateur par liste et par personne |
539
+ | `usePersistedState` | `useState` gardé dans le navigateur (filtre choisi…), sous la portée `PorteeStockageLocal` |
371
540
 
372
541
  ```tsx
373
542
  import { keepPreviousData, useQuery } from "@tanstack/react-query"
@@ -459,8 +628,9 @@ export function Etudes() {
459
628
  Chaque partie de l'état (`tri`, `visibiliteColonnes`, `ordreColonnes`, `selection`,
460
629
  `lignesDepliees`) est contrôlée si l'application la fournit avec son `on…Change` (pour la
461
630
  garder, en `localStorage` par exemple), interne sinon ; `etatInitial` donne la valeur de départ
462
- d'une partie interne. La sélection se limite par défaut aux lignes présentes dans `donnees`
463
- (changer de page ou de filtre la réduit) ; `conserverSelection` la garde. Sur mobile, le tableau
631
+ d'une partie interne. La sélection se limite par défaut aux lignes affichées (changer de page
632
+ ou de filtre la réduit) ; `conserverSelection` la garde ; `table.options.meta.deselectionner(ids)`
633
+ en retire quelques lignes (refus d'une action groupée pour certaines). Sur mobile, le tableau
464
634
  garde ses colonnes et son cadre défile horizontalement. Une colonne se masque par « Colonnes »,
465
635
  pas depuis son en-tête ; la dernière colonne de données affichée ne se masque pas.
466
636
 
@@ -475,8 +645,20 @@ filtre est annoncé) ; `DataTablePagination` annonce la page atteinte. Quand un
475
645
  sous le focus (« Réinitialiser », la croix de la recherche, le bandeau ou la barre de sélection),
476
646
  le focus passe à un élément stable (champ de recherche, premier filtre, case d'en-tête). Le clic
477
647
  de ligne (`onActiverLigne`) est un raccourci à la souris : une cellule doit aussi offrir un lien
478
- ou un bouton pour le clavier. Un bouton passé dans `vide` (« Réinitialiser les filtres »)
479
- disparaît avec l'état vide : l'application rend d'abord le focus au champ de recherche.
648
+ ou un bouton pour le clavier (`DataTableCellLink`). Un bouton passé dans `vide` (« Réinitialiser
649
+ les filtres ») disparaît avec l'état vide : l'application rend d'abord le focus au champ de
650
+ recherche. Quand une ligne qui avait le focus disparaît (suppression par un `DeleteButton`, un
651
+ menu « … » ou un dialogue de l'application ouvert depuis elle, liste rechargée), `DataTable`
652
+ rend le focus à la même cellule de la ligne suivante (ou précédente), sinon au tableau ; pour un
653
+ tableau rendu à la main, `focaliserTableau(cadre)` donne la même cible. `size` règle la taille
654
+ du `DeleteButton` (`icon-lg` pour la corbeille dans un en-tête de page ; avec `avecTexte`,
655
+ l'en-tête l'agrandit seul). La recherche de `DataTableToolbar` porte `NO_AUTOFILL` ;
656
+ `recherche.attributs` lui ajoute des attributs.
657
+
658
+ L'en-tête du tableau ne se surligne pas au survol (seules les lignes de données le font). Quand
659
+ le tableau se vide (filtre sans résultat, page suivante en chargement), ses colonnes gardent leur
660
+ largeur. La colonne de sélection a la largeur de la zone de ses cases (40 px) ; une case
661
+ verrouillée reste lisible (fond gris, ou gris foncé cochée) au lieu d'être estompée.
480
662
 
481
663
  #### Sélectionner tous les éléments
482
664
 
@@ -507,15 +689,19 @@ const supprimer = () =>
507
689
  : api.supprimer(table.getSelectedRowIds())
508
690
  ```
509
691
 
510
- Quand toute la page est cochée et que `total` compte d'autres éléments, `DataTable` affiche
511
- au-dessus des lignes « Les 25 éléments de la page sont sélectionnés. Sélectionner les 137
512
- éléments », puis « Les 137 éléments sont sélectionnés. Tout désélectionner » (`unite` et
513
- `feminin` accordent le texte, comme pour `DataTableCount` et `DataTableBulkActions`).
514
- `DataTableBulkActions` compte alors le total. L'état repasse à `false` dès qu'une ligne de la
515
- page n'est plus cochée (par le tableau ou par l'application), quand la page change (même avec
516
- `conserverSelection`) et par « Tout désélectionner »
517
- (`table.options.meta.toutDeselectionner()` pour un bouton de l'application) ; l'application le
518
- remet à `false` quand ses filtres ou le tri changent.
692
+ Avec `total`, le compte de `DataTableBulkActions` situe la sélection (« 25 éléments sur 137
693
+ sélectionnés »). Quand toute la page est cochée et que `total` compte d'autres éléments, son menu
694
+ « … » propose « Sélectionner les 137 éléments », au-dessus de ses `actionsSecondaires` : dans la
695
+ barre, qui flotte, rien n'est inséré au-dessus des lignes et le tableau ne bouge pas. Une fois
696
+ accepté, la barre compte le total (« 137 éléments sélectionnés ») ; si « … » n'a plus rien à
697
+ proposer, il disparaît et le focus passe à « Tout désélectionner » ; `DataTable` l'annonce (« Les
698
+ 137 éléments sont sélectionnés », accordé par ses `unite` et `feminin`). **Sans
699
+ `DataTableBulkActions`, rien ne propose de tout sélectionner.**
700
+
701
+ L'état repasse à `false` dès qu'une ligne de la page n'est plus cochée (par le tableau ou par
702
+ l'application), quand la page change (même avec `conserverSelection`) et par « Tout
703
+ désélectionner » (`table.options.meta.toutDeselectionner()` pour un bouton de l'application) ;
704
+ l'application le remet à `false` quand ses filtres ou le tri changent.
519
705
 
520
706
  Une ligne non sélectionnable avec `verrouLigne` garde une case focalisable, en lecture seule, qui
521
707
  dit sa raison (infobulle et description). Échap vide la sélection quand le focus est dans le
@@ -529,8 +715,9 @@ Sur le modèle de TanStack (`rowExpandingFeature`) et des exemples shadcn : `dat
529
715
  ajoute le chevron (bouton à icône seule, infobulle, `aria-expanded`, `aria-controls`), et
530
716
  `rendreDetail` de `DataTable` rend le détail sous la ligne, sur toute la largeur. Sans
531
717
  `onActiverLigne`, un clic sur la ligne la déplie aussi ; la sélection et les commandes de la
532
- ligne restent indépendantes. Sur mobile, le détail suit la largeur visible du cadre : il reste
533
- lisible pendant que les colonnes défilent.
718
+ ligne restent indépendantes. La ligne dépliée et son détail forment un seul bloc : même fond
719
+ (celui de la sélection si la ligne est cochée), sans filet entre eux. Sur mobile, le détail suit
720
+ la largeur visible du cadre : il reste lisible pendant que les colonnes défilent.
534
721
 
535
722
  ```tsx
536
723
  const colonnes = aide.columns([
@@ -567,6 +754,153 @@ page. Avec TanStack Query, `placeholderData: keepPreviousData` garde la page pr
567
754
  total) pendant le chargement de la suivante. « Précédente » et « Suivante » restent focalisables
568
755
  en bout de liste.
569
756
 
757
+ #### Liste chargée d'un bloc : filtre, tri et pagination côté client
758
+
759
+ Comme dans le guide de shadcn (`getPaginationRowModel`, `getFilteredRowModel`), `useDataTable`
760
+ filtre, trie et découpe lui-même une liste reçue en entier. `paginationClient` l'active (25
761
+ lignes par page, `etatInitial.pagination` pour une autre taille) ; `DataTablePagination` et
762
+ `DataTableCount` reçoivent alors `table` au lieu de leurs nombres. `filtreGlobal` cherche dans
763
+ toutes les colonnes à accesseur, sans casse ni accents (« tresorerie » trouve « Trésorerie ») ;
764
+ `filtresColonnes` applique la fonction de chaque colonne (`filterFn`). Le tri nommé
765
+ `texteFr` (`sortFn: "texteFr"`) suit l'ordre alphabétique français de `comparerFr`, accents
766
+ compris, et « Poste 2 » avant « Poste 10 » ; le filtre nommé `texteFr` est celui de la
767
+ recherche (`normaliserRecherche`) ; une recherche vide ne filtre rien. Un changement de filtre
768
+ ou de tri ramène à la première page : le contenu est comparé, un `filtresColonnes` recréé à
769
+ l'identique à chaque rendu ne change pas la page. Supprimer une ligne garde la page courante (la
770
+ dernière page existante si elle disparaît) ; une page de départ (`etatInitial`, ou lue dans
771
+ l'URL) est gardée tant que les données ne sont pas arrivées. Changer le nombre de lignes par
772
+ page revient à la première page en une seule mise à jour (`setPagination`).
773
+ `DataTablePagination table={…}` sans `paginationClient` n'affiche rien et prévient dans la
774
+ console : la table ne découpe pas de pages.
775
+
776
+ ```tsx
777
+ const colonnes = aide.columns([
778
+ aide.accessor("nom", {
779
+ header: ({ column }) => <DataTableColumnHeader column={column} libelle="Poste" />,
780
+ sortFn: "texteFr",
781
+ cell: ({ row }) => (
782
+ <DataTableCellLink href={`/postes/${row.original.id}`} lien={RouterLink}>
783
+ {row.original.nom}
784
+ </DataTableCellLink>
785
+ ),
786
+ }),
787
+ aide.accessor("pole", { header: "Pôle", filterFn: "equalsString" }),
788
+ dataTableActionsColumn<Poste>({
789
+ actions: (p) => <DeleteButton libelle={`le poste ${p.nom}`} … />,
790
+ // enableHiding: true pour une colonne d'actions masquable et déplaçable.
791
+ // Commandes sur la ligne survolée seulement (focus dans la ligne, menu
792
+ // ouvert et écran tactile compris), déjà en couleur (corbeille rouge) ;
793
+ // toujoursVisibles: true sur toutes.
794
+ }),
795
+ ])
796
+
797
+ const [recherche, setRecherche] = useState("")
798
+ const table = useDataTable({
799
+ donnees: data ?? AUCUN,
800
+ colonnes,
801
+ idLigne: (p) => p.id,
802
+ paginationClient: true,
803
+ filtreGlobal: recherche,
804
+ onFiltreGlobalChange: setRecherche,
805
+ filtresColonnes: useMemo(() => (pole ? [{ id: "pole", value: pole }] : []), [pole]),
806
+ })
807
+ <DataTableToolbar
808
+ recherche={{ valeur: recherche, onValeurChange: setRecherche }}
809
+ compteur={{ table, unite: { singulier: "poste", pluriel: "postes" } }}
810
+ />
811
+ <DataTable table={table} libelle="Postes" requete={requetePostes} />
812
+ <DataTablePagination table={table} />
813
+ ```
814
+
815
+ #### Erreur de la requête
816
+
817
+ `requete` (le résultat de `useQuery` convient tel quel) affiche en échec le `QueryErrorBanner`
818
+ (« Réessayer ») au-dessus du tableau, rendu dans le parent comme pour `QueryBoundary` (le parent
819
+ règle l'espacement : `flex flex-col gap-4`). L'état vide se tait alors : « Aucun résultat »
820
+ contredirait le bandeau. Sans `enChargement`, `isFetching` en tient lieu.
821
+
822
+ #### Colonnes gardées dans le navigateur
823
+
824
+ `useColumnPrefs` garde, pour chaque liste et chaque personne, les colonnes affichées et leur
825
+ ordre (`localStorage`, format `{ order, visible }`) ; `optionsTableau` s'étale dans
826
+ `useDataTable`. Une colonne apparue depuis l'enregistrement s'ajoute à la fin, affichée si elle
827
+ l'est par défaut ; une colonne non offerte ici (`disponibles` : droit manquant) garde son état et
828
+ sa place ; `fixesEnTete` reste hors préférences. `optionsTableau.colonnesReglables` (une option
829
+ de `useDataTable` et de `DataTableViewOptions`) limite le panneau « Colonnes » aux colonnes des
830
+ préférences : les fixes et les autres n'y sont ni masquables ni déplaçables. `reinitialiser()`
831
+ revient aux valeurs par
832
+ défaut. `usePersistedState(cle, defaut, { accepter })` garde de même un réglage simple (un filtre
833
+ choisi) ; rien n'est écrit tant que rien n'est choisi, et `accepter` écarte une valeur
834
+ enregistrée devenue invalide. La portée (la personne connectée) se fournit une fois :
835
+ `<PorteeStockageLocal portee={moi?.id}>` ; les clés écrites sont `<portée>:<clé>` (`anon:`
836
+ sans personne), comme celles d'ETIC Members.
837
+
838
+ ```tsx
839
+ const prefs = useColumnPrefs({
840
+ cle: "membres:personnes",
841
+ colonnes: ["email", "statut", "telephone"],
842
+ visiblesParDefaut: ["email", "statut"],
843
+ fixesEnTete: ["select", "nom"],
844
+ })
845
+ const table = useDataTable({
846
+ donnees,
847
+ colonnes,
848
+ idLigne,
849
+ ...prefs.optionsTableau,
850
+ })
851
+ ```
852
+
853
+ #### Tableau rendu à la main
854
+
855
+ Un tableau que `DataTable` ne sait pas rendre (deux rangées d'en-tête, cellules éditables)
856
+ garde le sélecteur de colonnes et la barre d'actions sans instance `useDataTable` :
857
+ `DataTableViewOptions` reçoit `colonnes` (`{ id, libelle, masquable? }`) et les options de
858
+ `useDataTable` qui règlent les colonnes (`visibiliteColonnes`, `onVisibiliteColonnesChange`,
859
+ `ordreColonnes`, `onOrdreColonnesChange` ; sans ce dernier, pas de glisser-déposer), donc
860
+ `prefs.optionsTableau` de `useColumnPrefs` tel quel ; `DataTableBulkActions` reçoit `nombre`,
861
+ `onToutDeselectionner` et `racine` (le cadre du tableau, où Échap vide la sélection et où le
862
+ focus revient).
863
+
864
+ ```tsx
865
+ <DataTableViewOptions colonnes={COLONNES} {...prefs.optionsTableau} />
866
+ <DataTableBulkActions
867
+ nombre={selection.size}
868
+ onToutDeselectionner={() => setSelection(new Set())}
869
+ racine={cadreRef}
870
+ >
871
+ …
872
+ </DataTableBulkActions>
873
+ ```
874
+
875
+ ### Utilitaires et hooks
876
+
877
+ Textes chiffrés en français : une valeur absente rend un repli (« — » par défaut, dernier
878
+ argument ou option `repli`), une date illisible est rendue telle quelle.
879
+
880
+ | Fonction | Rôle |
881
+ | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
882
+ | `compte`, `accorde`, `nombreFr`, `uniteAccordee`, `participe` | « 1 234 lignes », « 0 doublon » (0 et 1 au singulier) ; le mot seul, pluriel irrégulier en option ; nombre au format français ; participe accordé en genre. |
883
+ | `formaterOctets` | « 512 o », « 1,5 Ko », « 120 Mo » (base 1 024, une décimale sous 100). |
884
+ | `formaterDuree`, `formaterDureeArrondie`, `formaterAnciennete` | « 3 j 4 h » ; « 3 j » ; « il y a 3 j 4 h » ou « à l'instant » (`arrondie`, `ilYA: false` pour « 3 j »). |
885
+ | `formaterDate`, `formaterDateHeure`, `formaterHorodatage`, `formaterDateHeureLongue` | « 05 juillet 2026 » (une date sans heure reste ce jour-là dans tous les fuseaux) ; « 05/07/2026 14:30 » ; à la seconde ; « 05 juillet 2026 à 14:30 ». |
886
+ | `lireDateIso`, `ecrireDateIso` | Date sans heure de l'API (`AAAA-MM-JJ`) ↔ `Date` du `DatePicker`, en heure locale ; un 31 février est refusé. |
887
+ | `normaliser`, `correspondance` | Texte sans accents ni casse ; filtre d'une recherche locale (`correspondance(recherche)(...textes)`, recherche vide : tout passe). |
888
+ | `NO_AUTOFILL` | Attributs à étaler sur un champ qui n'est pas un identifiant : les gestionnaires de mots de passe s'en écartent. |
889
+ | `useDebouncedValue`, `useDocumentTitle` | Valeur recopiée après un délai sans changement (300 ms par défaut) ; titre de l'onglet le temps que la page est montée. |
890
+
891
+ ```tsx
892
+ const [recherche, setRecherche] = useState("")
893
+ const rechercheDifferee = useDebouncedValue(recherche)
894
+ const correspond = correspondance(recherche)
895
+ const visibles = postes.filter((p) => correspond(p.nom, p.pole?.nom))
896
+
897
+ <DatePicker
898
+ valeur={lireDateIso(membre.date_naissance)}
899
+ onValeurChange={(date) => setDateNaissance(ecrireDateIso(date))}
900
+ />
901
+ <Input type="search" {...NO_AUTOFILL} />
902
+ ```
903
+
570
904
  ### Développer contre les sources locales
571
905
 
572
906
  Pour voir une modification de la bibliothèque instantanément dans une application, sans publier,
@@ -631,17 +965,39 @@ npm run build # dist/ : un module par composant, types, styles.css
631
965
  react-day-picker (mois, jours et libellés d'accessibilité) et `weekStartsOn={1}` ;
632
966
  - jours du calendrier de 36 px sous le seuil mobile (cible tactile), 28 px au-delà comme
633
967
  dans shadcn : `--cell-size` de `calendar.tsx` ;
634
- - thème (`styles.css`) : `--muted-foreground` plus foncé en clair (≥ 4,5:1 sur `--muted` :
635
- initiales d'`Avatar`, `Kbd`), `--destructive` plus foncé en clair et plus clair en sombre
968
+ - thème (`styles.css`) : `--destructive` plus foncé en clair et plus clair en sombre
636
969
  (≥ 4,5:1 sur sa teinte : bouton et badge `destructive`, y compris dans un pied de
637
970
  dialogue) ; contrastes vérifiés par `src/theme.test.ts` ;
638
971
  - l'accent comme texte en `text-primary-text` au lieu de `text-primary` : variante `link` de
639
972
  `button.tsx` et `badge.tsx`, liens survolés de `empty.tsx`, `field.tsx` et `item.tsx` ;
640
973
  - import inutilisé de React retiré de `scroll-area.tsx` (sans quoi `tsc` échoue) ;
974
+ - `button.tsx` : un bouton `aria-disabled` (désactivé mais focalisable, `focusableWhenDisabled`)
975
+ est estompé comme un bouton `disabled`, curseur interdit (d'attente s'il est `enCours`), sans
976
+ enfoncement au clic ; pas de `pointer-events-none`, qui couperait l'infobulle de sa raison ;
977
+ - `button.tsx` : taille `inline` (`h-auto min-h-6 gap-1 px-0`), pour un lien `variant="link"`
978
+ dans une phrase ou une cellule, cible tactile de 24 px gardée ;
979
+ - `button.tsx` : échelle d'une zone ; les tailles `default` et `icon` lisent leur hauteur
980
+ dans `--bouton-hauteur` et `--bouton-icone` (32 px sans elles, comme `h-8` et `size-8`).
981
+ `PageHeader` et `DetailHeader` les posent sur leurs actions (`tailleActions`, `lg` par
982
+ défaut : 36 px) : tous les boutons d'un en-tête ont la même hauteur sans `size` à chacun,
983
+ `ButtonLink` et tout `buttonVariants` compris. Une hauteur donnée par `className` l'emporte
984
+ (bouton d'un `InputGroup`) ; un dialogue ouvert depuis l'en-tête (rendu dans un portail)
985
+ garde ses tailles ;
986
+ - `button.tsx` : `enCours` (roue muette à la place des icônes, `aria-busy`, `data-en-cours`,
987
+ pas de survol, clics ignorés, focus gardé par `focusableWhenDisabled`) et `libelleEnCours` ;
988
+ un `children` n'est passé que s'il est donné (les enfants d'un `render` restent) ; `spinner.tsx` :
989
+ `SpinnerDecoratif`, roue sans rôle ni nom, cachée aux lecteurs d'écran ;
641
990
  - variantes `success` et `warning` ajoutées à `badge.tsx`, sur le modèle de `destructive`
642
991
  (teinte à 10 %, 20 % en sombre, texte de la couleur) ;
643
992
  - case à cocher partielle (`indeterminate`) : `checkbox.tsx` affiche un trait sur fond plein,
644
993
  comme une case cochée, au lieu de la coche sur fond vide de shadcn (on croyait tout coché) ;
994
+ - bord d'une case à cocher vide en `--control-border` (`styles.css`) au lieu de `--input` :
995
+ `--muted-foreground` à 80 % en clair (≥ 3:1, le bord de Nova se voyait à peine), `--input`
996
+ en sombre ;
997
+ - même règle pour le contour d'une radio non cochée (`radio-group.tsx`, focus dans un
998
+ `field-label` compris) et le rail d'un switch éteint (`switch.tsx`, `--control-border` à la
999
+ place de `bg-input`) : ≥ 3:1 sur la page et sur une carte, en clair comme en sombre (le
1000
+ registre restait à 1,6:1 et 1,3:1 en sombre) ; le pouce reste distinct du rail ;
645
1001
  - variantes `warning`, `info` et `success` ajoutées à `alert.tsx`, sur le modèle de
646
1002
  `destructive` (fond de carte, texte de la couleur, description à 90 %), et couleur `--info`
647
1003
  dans `styles.css` ;
@@ -657,11 +1013,93 @@ npm run build # dist/ : un module par composant, types, styles.css
657
1013
  - déclencheurs de `select.tsx` et `native-select.tsx` en `text-base md:text-sm`, comme
658
1014
  `Input` (en 14 px sur téléphone, iOS zoome à la sélection) ;
659
1015
  - bouton qui ouvre la liste de `combobox.tsx` nommé « Afficher les options » ;
1016
+ - `select.tsx` : liste sous le champ et alignée à gauche par défaut
1017
+ (`alignItemWithTrigger={false}`, `align="start"`) au lieu d'être posée sur le champ et
1018
+ centrée (elle le masquait, et débordait des deux côtés d'un champ étroit) ; options
1019
+ posées sans `SelectGroup` à la même marge que dans un groupe ; `vide` de `SelectContent`
1020
+ (« Aucune option. » en `role="status"` au lieu d'une fenêtre vide) ; `description` de
1021
+ `SelectItem`, sous le libellé, qui reste lisible quand l'option est figée, avec un
1022
+ libellé qui passe à la ligne ;
1023
+ - `checkbox.tsx` : la case s'estompe d'après son propre état (`data-disabled`,
1024
+ `aria-disabled`, `fieldset` désactivé) et non par `group-has-disabled/field`, qui
1025
+ estompait toutes les cases d'un champ dès qu'une seule y était figée ; variantes
1026
+ `disabled:` retirées (la racine est un `<span>`, jamais `:disabled`). Dans un
1027
+ `<fieldset disabled>`, la case est réellement inactive (Base UI la coche par son entrée
1028
+ cachée, que le fieldset désactive) et en a l'air ;
1029
+ - `combobox.tsx` : la liste s'ancre sur le cadre (`InputGroup`) du `ComboboxInput`, et
1030
+ non sur le seul champ que décale un addon de tête. `Combobox` porte une ref vers ce
1031
+ cadre, que `ComboboxInput` remplit et que `ComboboxContent` passe à `anchor` (juste dès
1032
+ l'ouverture, `defaultOpen` compris) ; une `anchor` explicite (puces,
1033
+ `useComboboxAnchor`) l'emporte ; sans `ComboboxInput` hors de la liste, l'ancre reste
1034
+ le déclencheur ; un `ComboboxInput` placé dans la liste (recherche d'un sélecteur
1035
+ ouvert par un bouton) ne s'enregistre pas. Largeur minimale : celle de l'ancre
1036
+ (`min-w-(--anchor-width)`), au lieu de l'ancre + 28 px de shadcn, qui couvraient
1037
+ l'addon d'un champ seul ;
1038
+ - imports par sous-chemin, imposés par la règle ESLint `no-restricted-imports`
1039
+ (`eslint.config.js`) : Base UI (`@base-ui/react/combobox` dans `combobox.tsx`, que
1040
+ shadcn importe par la racine), date-fns, et la seule locale `react-day-picker/locale/fr`
1041
+ dans `calendar.tsx`. Les racines chargent tous les composants, toutes les fonctions ou
1042
+ toutes les locales aux outils sans tree-shaking (vitest des applications) ;
660
1043
  - `alert.tsx` : `role="status"` pour `info` et `success` (messages d'état, annoncés sans
661
- interrompre), `role="alert"` gardé pour les autres variantes.
1044
+ interrompre), `role="alert"` gardé pour les autres variantes ;
1045
+ - onglets `variant="line"` de `tabs.tsx` qui passent à la ligne sous 640 px (`max-sm:` :
1046
+ liste en `h-auto max-w-full flex-wrap justify-start`, déclencheurs en `h-7 flex-none`)
1047
+ au lieu de déborder ; un défilement couperait le trait de l'onglet actif. Au-delà, et pour
1048
+ la variante par défaut en pastille, rien ne change ;
1049
+ - `avatar.tsx` : `diametre` (px) au-delà des tailles `sm`, `default` et `lg` (24 à 40 px),
1050
+ qui pose largeur, hauteur et taille des initiales (36 % du diamètre), reprise par
1051
+ `AvatarFallback` (`group-data-diametre/avatar:text-[length:inherit]`) ;
1052
+ - `SidebarTrigger` de `sidebar.tsx` : `libelle`, le nom lu du bouton (« Afficher ou masquer
1053
+ le menu » par défaut), au lieu d'un `aria-label` qui masquerait ce texte ;
1054
+ - `badge.tsx` : variante `info` (sur le modèle de `success`) et taille `size="lg"` (28 px,
1055
+ la hauteur d'un badge qui porte un bouton « Retirer ») ;
1056
+ - `progress.tsx` : `ton` (piste à 15 % et remplissage de la couleur, `StatusTon`, classes
1057
+ dans `lib/ton.ts`) et `size="lg"` (piste de 8 px au lieu de 4), au lieu de recolorer la
1058
+ piste et le remplissage par sélecteurs `[data-slot=…]` ;
1059
+ - `dialog.tsx` et `alert-dialog.tsx` : hauteur plafonnée à l'écran
1060
+ (`max-h-[calc(100dvh-2rem)]`), sans quoi le bas d'un long dialogue (et ses boutons) sortait
1061
+ de l'écran sur téléphone. Le contenu est une colonne (`flex flex-col` au lieu de `grid`) ;
1062
+ `DialogBody`, ajouté à `dialog.tsx`, est la zone qui défile seule (`min-h-0
1063
+ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le contenu
1064
+ défile (`overflow-y-auto`), jamais à l'horizontale (`overflow-x-hidden`) ;
1065
+ - `alert-dialog.tsx` : à la taille par défaut et sans `AlertDialogMedia`, titre et
1066
+ description alignés à gauche dès le téléphone (shadcn les centre sous `sm`), comme la liste
1067
+ et les champs du corps ; avec un média, la grille de shadcn reste telle quelle ;
1068
+ - `table.tsx` : la ligne d'en-tête ne se surligne pas au survol (`[&_tr:hover]:bg-transparent`
1069
+ sur `TableHeader`) ; les lignes de données gardent le survol de shadcn ;
1070
+ - `tooltip.tsx` : le focus qu'un popup (menu, calendrier, dialogue) rend à son
1071
+ déclencheur en se fermant, par Échap ou par un choix, n'ouvre plus l'infobulle de
1072
+ `TooltipTrigger` : elle absorbait l'Échap suivant, celui qui ferme le dialogue
1073
+ englobant (`ThemeMenu`, « Plus d'actions » de `DetailHeader`, tout `TooltipTrigger` posé
1074
+ sur un `DropdownMenuTrigger`). Reconnu par `lib/focus-rendu.ts` : le déclencheur a perdu
1075
+ le focus son popup ouvert (`aria-expanded`), ou le focus vient d'un popup qui ne le
1076
+ contient pas. Tout autre focus clavier l'ouvre comme avant (focus initial d'un dialogue
1077
+ ouvert par Entrée compris) ; le survol et l'`onFocus` de l'application ne changent pas.
1078
+ `CLASSES_BULLE` et `CLASSES_FLECHE` (internes) portent l'allure de la bulle, partagée
1079
+ avec `Toggletip` ;
1080
+ - `popover.tsx` : `PopoverContent` accepte `anchor` (celui du `Positioner` de Base UI),
1081
+ pour un popover sans `PopoverTrigger` (`Toggletip`, ancré sur l'élément qu'il explique).
662
1082
 
663
1083
  Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
664
1084
 
1085
+ Thème : couleur de base `zinc` de shadcn (registre `colors/zinc.json`, `cssVarsV4`) au lieu
1086
+ de `neutral` ; jeton ajouté `--page` (`bg-page`, zinc-50 en clair, `--background` en
1087
+ sombre), pris par le `body` au lieu de `bg-background`, `--background` restant celui du
1088
+ registre ; `--success` clair un cran plus foncé (≥ 4,5:1 sur sa teinte posée sur la page
1089
+ zinc-50) ; `--muted-foreground` celui du preset (zinc-500, 4,39:1 sur `--muted` en clair :
1090
+ contraste faible accepté) ; `--control-border`
1091
+ (`--muted-foreground` à 80 %) en sombre aussi, au lieu de `--input` (sous 2:1) ; `--sidebar`
1092
+ clair = `--background` (barre latérale blanche, au lieu du zinc-50 du registre) ;
1093
+ `color-scheme` dans `:root` et `.dark`. Les valeurs sont commentées dans `styles.css` ;
1094
+ `theme.test.ts` compare chaque jeton au registre, écarts (`ECARTS`) exceptés, et en vérifie
1095
+ les contrastes. Hors `ui/` : `CenteredScreen` est posé sur `bg-muted/40` au lieu du
1096
+ `bg-muted` des blocs de connexion de shadcn (fond moins appuyé, en sombre surtout) ; le
1097
+ contenu d'`AppShell` (`SidebarInset`) et sa barre mobile sont en `bg-page` ; la
1098
+ `Disclosure` `carte` est en `bg-card`, blanche comme une carte ; le cadre de `DataTable` est
1099
+ en `bg-tableau` (jeton ajouté) : `--card` sur la page, `--page` dans une carte, un dialogue,
1100
+ un tiroir, un popover ou une `Disclosure` `carte` (règle `--tableau-fond` de `styles.css`),
1101
+ pour se détacher toujours de son support.
1102
+
665
1103
  Sans écart de code mais garanti par le même test : `Button` sans `type` rend
666
1104
  `type="button"` (Base UI le fait pour un bouton natif) et ne soumet donc pas son formulaire.
667
1105