@etic-insa/ui 0.3.0 → 0.4.1

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 (53) hide show
  1. package/README.md +128 -78
  2. package/dist/components/etic/app-shell.d.ts +4 -1
  3. package/dist/components/etic/app-shell.js +150 -113
  4. package/dist/components/etic/app-shell.js.map +1 -1
  5. package/dist/components/etic/data-table-bulk-actions.d.ts +14 -2
  6. package/dist/components/etic/data-table-bulk-actions.js +100 -53
  7. package/dist/components/etic/data-table-bulk-actions.js.map +1 -1
  8. package/dist/components/etic/data-table-focus.d.ts +1 -1
  9. package/dist/components/etic/data-table-focus.js.map +1 -1
  10. package/dist/components/etic/data-table.d.ts +12 -4
  11. package/dist/components/etic/data-table.js +199 -223
  12. package/dist/components/etic/data-table.js.map +1 -1
  13. package/dist/components/etic/delete-button.d.ts +2 -2
  14. package/dist/components/etic/delete-button.js.map +1 -1
  15. package/dist/components/etic/detail-list.d.ts +3 -1
  16. package/dist/components/etic/detail-list.js +1 -1
  17. package/dist/components/etic/detail-list.js.map +1 -1
  18. package/dist/components/etic/disclosure.js +1 -0
  19. package/dist/components/etic/disclosure.js.map +1 -1
  20. package/dist/components/etic/icon-toggle.js +1 -1
  21. package/dist/components/etic/icon-toggle.js.map +1 -1
  22. package/dist/components/etic/page-header.d.ts +12 -4
  23. package/dist/components/etic/page-header.js +27 -16
  24. package/dist/components/etic/page-header.js.map +1 -1
  25. package/dist/components/etic/phone-input.js +1 -1
  26. package/dist/components/etic/phone-input.js.map +1 -1
  27. package/dist/components/etic/removable-badge.js +26 -18
  28. package/dist/components/etic/removable-badge.js.map +1 -1
  29. package/dist/components/etic/save-bar.d.ts +4 -3
  30. package/dist/components/etic/save-bar.js +2 -2
  31. package/dist/components/etic/save-bar.js.map +1 -1
  32. package/dist/components/etic/stat-tile.d.ts +9 -2
  33. package/dist/components/etic/stat-tile.js +32 -18
  34. package/dist/components/etic/stat-tile.js.map +1 -1
  35. package/dist/components/etic/theme-menu.d.ts +28 -0
  36. package/dist/components/etic/theme-menu.js +62 -35
  37. package/dist/components/etic/theme-menu.js.map +1 -1
  38. package/dist/components/etic/toggletip.js +3 -3
  39. package/dist/components/etic/toggletip.js.map +1 -1
  40. package/dist/components/etic/tooltip-button.d.ts +7 -3
  41. package/dist/components/etic/tooltip-button.js +2 -2
  42. package/dist/components/etic/tooltip-button.js.map +1 -1
  43. package/dist/components/ui/button.js +2 -2
  44. package/dist/components/ui/button.js.map +1 -1
  45. package/dist/components/ui/calendar.js +119 -81
  46. package/dist/components/ui/calendar.js.map +1 -1
  47. package/dist/components/ui/dropdown-menu.d.ts +2 -2
  48. package/dist/components/ui/dropdown-menu.js +102 -68
  49. package/dist/components/ui/dropdown-menu.js.map +1 -1
  50. package/dist/components/ui/select.js +3 -3
  51. package/dist/components/ui/select.js.map +1 -1
  52. package/dist/styles.css +107 -73
  53. package/package.json +1 -1
package/README.md CHANGED
@@ -67,19 +67,33 @@ 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 `gray` de
71
- shadcn (palette `gray` de Tailwind 4, légèrement bleutée), communs à toute la suite : une
72
- application ne les redéfinit pas. `--muted-foreground` est un peu plus foncé en clair
73
- (≥ 4,5:1 sur `--muted`), écart vérifié avec les contrastes par `src/theme.test.ts`.
74
-
75
- Le fond de la page elle-même est un jeton ajouté, `--page` (classe `bg-page`) : gray-50 en
76
- clair, si bien que cartes, menus et tableaux blancs s'en détachent (en sombre, il vaut
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
77
79
  `--background` et les cartes sont déjà plus claires). Le `body` et le contenu d'`AppShell`
78
80
  le prennent ; un conteneur pleine page d'une application aussi, plutôt que `bg-background`,
79
81
  qui reste la surface blanche de shadcn (onglet actif, bouton `outline`, calendrier…).
80
82
  `color-scheme` suit le thème (`light`, `dark`) : barres de défilement et contrôles natifs
81
83
  compris.
82
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
+
83
97
  #### Thème clair, sombre ou système
84
98
 
85
99
  `appliquerTheme(theme)` pose la classe `dark` sur `<html>` pour `"dark"`, la retire pour
@@ -189,8 +203,11 @@ export function Groupes() {
189
203
  }
190
204
  ```
191
205
 
192
- `onValeurChange` peut renvoyer une promesse : rejetée, elle affiche « Thème non enregistré »
193
- 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
194
211
  menu du compte est un lien (`href`) ou une action (`onChoisir`). La coquille fournit l'élément
195
212
  `<main>` : les pages n'en ajoutent pas. Elle ouvre la tabulation par un lien « Aller au
196
213
  contenu », visible au focus, qui met le focus sur ce `<main>`. Sur ordinateur, un bouton de
@@ -227,32 +244,32 @@ Compositions des primitives shadcn pour les états d'une page et les actions cou
227
244
  connaissent ni l'API ni le routeur : l'application fournit ses fonctions (envoi, suppression,
228
245
  chargement d'une image) et, au besoin, son composant de lien (`lien`, comme pour `AppShell`).
229
246
 
230
- | Composant | Rôle |
231
- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
232
- | `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. |
233
- | `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. |
234
- | `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. |
235
- | `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). |
236
- | `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs. |
237
- | `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é ; `tailleActions="lg"` pour des actions en `size="lg"`), `compact` quand la fiche répète déjà son nom. |
238
- | `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 que la largeur en permet), `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). |
239
- | `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`). |
240
- | `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. |
241
- | `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. |
242
- | `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. |
243
- | `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 ». |
244
- | `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`. |
245
- | `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. |
246
- | `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é. |
247
- | `StatTile`, `StatGrid`, `StatusBadge` | Chiffre clé d'un résumé ; 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. |
248
- | `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`) ; 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). |
249
- | `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`). Un bouton qui agit garde son infobulle (`TooltipButton`). |
250
- | `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` : barre collée en bas d'un long formulaire. |
251
- | `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. |
252
- | `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). |
253
- | `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). |
254
- | `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. |
255
- | `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). |
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). |
256
273
 
257
274
  `ConfirmDialog` et `FormDialog` s'ouvrent par un `declencheur`, ou sont contrôlés (`ouvert`,
258
275
  `onOuvertChange`). `DeleteButton` est son propre déclencheur ; `ouvert` et `onOuvertChange`
@@ -435,6 +452,9 @@ obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe
435
452
  champ, loupe comprise (comme toute liste d'un `ComboboxInput`).
436
453
  - `Select` (shadcn) : la liste s'ouvre sous le champ, alignée à gauche, sans jamais le
437
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 « … ».
438
458
  Les options vont dans un `SelectGroup`, comme chez shadcn ; posées directement dans
439
459
  `SelectContent`, elles ont la même marge. Sans option (y compris un `SelectGroup` vide),
440
460
  la liste dit « Aucune option. » (`vide` de `SelectContent`), dans une zone de statut
@@ -501,22 +521,22 @@ La famille `DataTable` suit le [guide Data Table de shadcn](https://ui.shadcn.co
501
521
  sur [TanStack Table v9](https://tanstack.com/table/latest) : les colonnes se déclarent avec
502
522
  l'assistant typé, `useDataTable` crée l'instance, les composants la reçoivent en `table`.
503
523
 
504
- | Composant | Rôle |
505
- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
506
- | `useDataTable` | instance TanStack : tri, filtre et pagination (côté client, ou serveur avec `triManuel`), colonnes, sélection, dépliage |
507
- | `DataTable` | la Table de shadcn ; état vide, lignes fantômes du chargement, bandeau d'erreur (`requete`), clic de ligne, détail déplié |
508
- | `DataTableColumnHeader` | en-tête triable : un clic trie par ordre croissant, le suivant inverse le sens |
509
- | `dataTableSelectionColumn` | colonne de cases ; Maj+clic sélectionne une plage ; raison d'une case verrouillée |
510
- | `dataTableExpandColumn` | colonne du chevron qui déplie une ligne (`aria-expanded`, `aria-controls`) |
511
- | `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite |
512
- | `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton |
513
- | `DataTableRowActions` | menu « … » d'une ligne |
514
- | `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
515
- | `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
516
- | `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`) |
517
- | `DataTableBulkActions` | barre d'actions groupées, collante en bas, avec la sélection ; Échap désélectionne |
518
- | `useColumnPrefs` | colonnes affichées et leur ordre, gardés dans le navigateur par liste et par personne |
519
- | `usePersistedState` | `useState` gardé dans le navigateur (filtre choisi…), sous la portée `PorteeStockageLocal` |
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` |
520
540
 
521
541
  ```tsx
522
542
  import { keepPreviousData, useQuery } from "@tanstack/react-query"
@@ -631,8 +651,8 @@ recherche. Quand une ligne qui avait le focus disparaît (suppression par un `De
631
651
  menu « … » ou un dialogue de l'application ouvert depuis elle, liste rechargée), `DataTable`
632
652
  rend le focus à la même cellule de la ligne suivante (ou précédente), sinon au tableau ; pour un
633
653
  tableau rendu à la main, `focaliserTableau(cadre)` donne la même cible. `size` règle la taille
634
- du `DeleteButton` (`icon-lg`, ou `lg` avec `avecTexte`, dans un `DetailHeader`
635
- `tailleActions="lg"`). La recherche de `DataTableToolbar` porte `NO_AUTOFILL` ;
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` ;
636
656
  `recherche.attributs` lui ajoute des attributs.
637
657
 
638
658
  L'en-tête du tableau ne se surligne pas au survol (seules les lignes de données le font). Quand
@@ -669,15 +689,19 @@ const supprimer = () =>
669
689
  : api.supprimer(table.getSelectedRowIds())
670
690
  ```
671
691
 
672
- Quand toute la page est cochée et que `total` compte d'autres éléments, `DataTable` affiche
673
- au-dessus des lignes « Les 25 éléments de la page sont sélectionnés. Sélectionner les 137
674
- éléments », puis « Les 137 éléments sont sélectionnés. Tout désélectionner » (`unite` et
675
- `feminin` accordent le texte, comme pour `DataTableCount` et `DataTableBulkActions`).
676
- `DataTableBulkActions` compte alors le total. L'état repasse à `false` dès qu'une ligne de la
677
- page n'est plus cochée (par le tableau ou par l'application), quand la page change (même avec
678
- `conserverSelection`) et par « Tout désélectionner »
679
- (`table.options.meta.toutDeselectionner()` pour un bouton de l'application) ; l'application le
680
- 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.
681
705
 
682
706
  Une ligne non sélectionnable avec `verrouLigne` garde une case focalisable, en lecture seule, qui
683
707
  dit sa raison (infobulle et description). Échap vide la sélection quand le focus est dans le
@@ -691,8 +715,9 @@ Sur le modèle de TanStack (`rowExpandingFeature`) et des exemples shadcn : `dat
691
715
  ajoute le chevron (bouton à icône seule, infobulle, `aria-expanded`, `aria-controls`), et
692
716
  `rendreDetail` de `DataTable` rend le détail sous la ligne, sur toute la largeur. Sans
693
717
  `onActiverLigne`, un clic sur la ligne la déplie aussi ; la sélection et les commandes de la
694
- ligne restent indépendantes. Sur mobile, le détail suit la largeur visible du cadre : il reste
695
- 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.
696
721
 
697
722
  ```tsx
698
723
  const colonnes = aide.columns([
@@ -763,6 +788,9 @@ const colonnes = aide.columns([
763
788
  dataTableActionsColumn<Poste>({
764
789
  actions: (p) => <DeleteButton libelle={`le poste ${p.nom}`} … />,
765
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.
766
794
  }),
767
795
  ])
768
796
 
@@ -937,18 +965,37 @@ npm run build # dist/ : un module par composant, types, styles.css
937
965
  react-day-picker (mois, jours et libellés d'accessibilité) et `weekStartsOn={1}` ;
938
966
  - jours du calendrier de 36 px sous le seuil mobile (cible tactile), 28 px au-delà comme
939
967
  dans shadcn : `--cell-size` de `calendar.tsx` ;
940
- - thème (`styles.css`) : `--muted-foreground` plus foncé en clair (≥ 4,5:1 sur `--muted` :
941
- initiales d'`Avatar`, `Kbd`), `--destructive` plus foncé en clair et plus clair en sombre
968
+ - listes du mois et de l'année du calendrier (`captionLayout="dropdown"`, `listesMoisAnnee` de
969
+ `DatePicker`) : le `Select` de la bibliothèque, à l'allure du libellé, au lieu du `<select>`
970
+ natif transparent de shadcn, dont la liste ouverte était celle du système. Les composants
971
+ passés à react-day-picker sont définis une fois (shadcn les écrit en ligne) : recréés à
972
+ chaque rendu, ils remontaient tout le calendrier quand son parent le redessinait (mois piloté
973
+ par `month`), et le focus d'une liste se perdait ;
974
+ - thème (`styles.css`) : `--destructive` plus foncé en clair et plus clair en sombre
942
975
  (≥ 4,5:1 sur sa teinte : bouton et badge `destructive`, y compris dans un pied de
943
976
  dialogue) ; contrastes vérifiés par `src/theme.test.ts` ;
944
977
  - l'accent comme texte en `text-primary-text` au lieu de `text-primary` : variante `link` de
945
978
  `button.tsx` et `badge.tsx`, liens survolés de `empty.tsx`, `field.tsx` et `item.tsx` ;
946
979
  - import inutilisé de React retiré de `scroll-area.tsx` (sans quoi `tsc` échoue) ;
980
+ - `dropdown-menu.tsx` : `DropdownMenu` suit son déclencheur, et `DropdownMenuContent` (menu
981
+ principal, pas les sous-menus) ne rend pas le focus quand ce déclencheur a été retiré du DOM
982
+ (`finalFocus` par défaut) ; Base UI le renvoyait sinon au dernier menu ou sélecteur ouvert
983
+ ailleurs dans la page. Le focus tombe sur `<body>`, où les rattrapages des composants le
984
+ reprennent. Un focus parti ailleurs (dialogue ouvert par une entrée) y reste. Un
985
+ `finalFocus` donné passe d'abord ; s'il vaut `true`, la garde s'applique. Les autres popups
986
+ (dialogue, sélecteur, popover, combobox) ont le même repli et ne sont pas encore corrigés ;
947
987
  - `button.tsx` : un bouton `aria-disabled` (désactivé mais focalisable, `focusableWhenDisabled`)
948
988
  est estompé comme un bouton `disabled`, curseur interdit (d'attente s'il est `enCours`), sans
949
989
  enfoncement au clic ; pas de `pointer-events-none`, qui couperait l'infobulle de sa raison ;
950
990
  - `button.tsx` : taille `inline` (`h-auto min-h-6 gap-1 px-0`), pour un lien `variant="link"`
951
991
  dans une phrase ou une cellule, cible tactile de 24 px gardée ;
992
+ - `button.tsx` : échelle d'une zone ; les tailles `default` et `icon` lisent leur hauteur
993
+ dans `--bouton-hauteur` et `--bouton-icone` (32 px sans elles, comme `h-8` et `size-8`).
994
+ `PageHeader` et `DetailHeader` les posent sur leurs actions (`tailleActions`, `lg` par
995
+ défaut : 36 px) : tous les boutons d'un en-tête ont la même hauteur sans `size` à chacun,
996
+ `ButtonLink` et tout `buttonVariants` compris. Une hauteur donnée par `className` l'emporte
997
+ (bouton d'un `InputGroup`) ; un dialogue ouvert depuis l'en-tête (rendu dans un portail)
998
+ garde ses tailles ;
952
999
  - `button.tsx` : `enCours` (roue muette à la place des icônes, `aria-busy`, `data-en-cours`,
953
1000
  pas de survol, clics ignorés, focus gardé par `focusableWhenDisabled`) et `libelleEnCours` ;
954
1001
  un `children` n'est passé que s'il est donné (les enfants d'un `render` restent) ; `spinner.tsx` :
@@ -958,12 +1005,12 @@ npm run build # dist/ : un module par composant, types, styles.css
958
1005
  - case à cocher partielle (`indeterminate`) : `checkbox.tsx` affiche un trait sur fond plein,
959
1006
  comme une case cochée, au lieu de la coche sur fond vide de shadcn (on croyait tout coché) ;
960
1007
  - bord d'une case à cocher vide en `--control-border` (`styles.css`) au lieu de `--input` :
961
- `--muted-foreground` à 80 % en clair (≥ 3:1, le bord de Nova se voyait à peine), `--input`
962
- en sombre ;
1008
+ `--muted-foreground` en clair (≥ 3:1, le bord de Nova se voyait à peine), `--input` en
1009
+ sombre, comme shadcn (exception assumée à WCAG 1.4.11 : plus discret) ;
963
1010
  - même règle pour le contour d'une radio non cochée (`radio-group.tsx`, focus dans un
964
1011
  `field-label` compris) et le rail d'un switch éteint (`switch.tsx`, `--control-border` à la
965
- place de `bg-input`) : ≥ 3:1 sur la page et sur une carte, en clair comme en sombre (le
966
- registre restait à 1,6:1 et 1,3:1 en sombre) ; le pouce reste distinct du rail ;
1012
+ place de `bg-input`) : ≥ 3:1 sur la page et sur une carte en clair, `--input` en sombre ;
1013
+ le pouce reste distinct du rail ;
967
1014
  - variantes `warning`, `info` et `success` ajoutées à `alert.tsx`, sur le modèle de
968
1015
  `destructive` (fond de carte, texte de la couleur, description à 90 %), et couleur `--info`
969
1016
  dans `styles.css` ;
@@ -1048,20 +1095,23 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
1048
1095
 
1049
1096
  Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
1050
1097
 
1051
- Thème : couleur de base `gray` de shadcn (registre `colors/gray.json`, `cssVarsV4`) au lieu
1052
- de `neutral` ; jeton ajouté `--page` (`bg-page`, gray-50 en clair, `--background` en
1098
+ Thème : couleur de base `zinc` de shadcn (registre `colors/zinc.json`, `cssVarsV4`) au lieu
1099
+ de `neutral` ; jeton ajouté `--page` (`bg-page`, zinc-50 en clair, `--background` en
1053
1100
  sombre), pris par le `body` au lieu de `bg-background`, `--background` restant celui du
1054
1101
  registre ; `--success` clair un cran plus foncé (≥ 4,5:1 sur sa teinte posée sur la page
1055
- gray-50) ; `--muted-foreground` clair un
1056
- peu plus foncé que gray-500 (≥ 4,5:1 sur `--muted`) ; `--control-border`
1057
- (`--muted-foreground` à 80 %) en sombre aussi, au lieu de `--input` (sous 2:1) ; `--sidebar`
1058
- clair = `--background` (barre latérale blanche, au lieu du gray-50 du registre) ;
1102
+ zinc-50) ; `--muted-foreground` celui du preset (zinc-500, 4,39:1 sur `--muted` en clair :
1103
+ contraste faible accepté) ; `--control-border` en clair seulement (`--input` du registre
1104
+ en sombre, exception assumée à WCAG 1.4.11) ; `--sidebar`
1105
+ clair = `--background` (barre latérale blanche, au lieu du zinc-50 du registre) ;
1059
1106
  `color-scheme` dans `:root` et `.dark`. Les valeurs sont commentées dans `styles.css` ;
1060
1107
  `theme.test.ts` compare chaque jeton au registre, écarts (`ECARTS`) exceptés, et en vérifie
1061
1108
  les contrastes. Hors `ui/` : `CenteredScreen` est posé sur `bg-muted/40` au lieu du
1062
1109
  `bg-muted` des blocs de connexion de shadcn (fond moins appuyé, en sombre surtout) ; le
1063
- contenu d'`AppShell` (`SidebarInset`) et sa barre mobile sont en `bg-page` ; le cadre de
1064
- `DataTable` et la `Disclosure` `carte` sont en `bg-card`, blancs comme une carte.
1110
+ contenu d'`AppShell` (`SidebarInset`) et sa barre mobile sont en `bg-page` ; la
1111
+ `Disclosure` `carte` est en `bg-card`, blanche comme une carte ; le cadre de `DataTable` est
1112
+ en `bg-tableau` (jeton ajouté) : `--card` sur la page, `--page` dans une carte, un dialogue,
1113
+ un tiroir, un popover ou une `Disclosure` `carte` (règle `--tableau-fond` de `styles.css`),
1114
+ pour se détacher toujours de son support.
1065
1115
 
1066
1116
  Sans écart de code mais garanti par le même test : `Button` sans `type` rend
1067
1117
  `type="button"` (Base UI le fait pour un bouton natif) et ne soumet donc pas son formulaire.
@@ -46,13 +46,16 @@ export interface AppShellProps {
46
46
  application: {
47
47
  nom: string;
48
48
  sousTitre?: string;
49
- /** Image ou icône, 28 px de côté environ. */
49
+ /** Image ou icône, carrée : 32 px dans la barre latérale, 24 px dans la
50
+ * barre du haut sur mobile. */
50
51
  logo?: ReactNode;
51
52
  /** Lien de la marque ; « / » par défaut. */
52
53
  href?: string;
53
54
  };
54
55
  sections: AppShellSection[];
55
56
  compte?: AppShellCompte;
57
+ /** Choix du thème : entrée « Thème » du menu du compte, ou son propre
58
+ * bouton dans le pied de la barre sans `compte`. */
56
59
  theme?: Pick<ThemeMenuProps, "valeur" | "onValeurChange">;
57
60
  /** Composant de lien du routeur ; par défaut, celui du `LienProvider`,
58
61
  * sinon un `<a>`. */