@etic-insa/ui 0.3.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 (46) hide show
  1. package/README.md +110 -73
  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 +15 -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/removable-badge.js +26 -18
  26. package/dist/components/etic/removable-badge.js.map +1 -1
  27. package/dist/components/etic/save-bar.d.ts +4 -3
  28. package/dist/components/etic/save-bar.js +2 -2
  29. package/dist/components/etic/save-bar.js.map +1 -1
  30. package/dist/components/etic/stat-tile.d.ts +9 -2
  31. package/dist/components/etic/stat-tile.js +32 -18
  32. package/dist/components/etic/stat-tile.js.map +1 -1
  33. package/dist/components/etic/theme-menu.d.ts +28 -0
  34. package/dist/components/etic/theme-menu.js +62 -35
  35. package/dist/components/etic/theme-menu.js.map +1 -1
  36. package/dist/components/etic/toggletip.js +3 -3
  37. package/dist/components/etic/toggletip.js.map +1 -1
  38. package/dist/components/etic/tooltip-button.d.ts +7 -3
  39. package/dist/components/etic/tooltip-button.js +2 -2
  40. package/dist/components/etic/tooltip-button.js.map +1 -1
  41. package/dist/components/ui/button.js +2 -2
  42. package/dist/components/ui/button.js.map +1 -1
  43. package/dist/components/ui/select.js +3 -3
  44. package/dist/components/ui/select.js.map +1 -1
  45. package/dist/styles.css +107 -69
  46. 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,8 +965,7 @@ 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
+ - thème (`styles.css`) : `--destructive` plus foncé en clair et plus clair en sombre
942
969
  (≥ 4,5:1 sur sa teinte : bouton et badge `destructive`, y compris dans un pied de
943
970
  dialogue) ; contrastes vérifiés par `src/theme.test.ts` ;
944
971
  - l'accent comme texte en `text-primary-text` au lieu de `text-primary` : variante `link` de
@@ -949,6 +976,13 @@ npm run build # dist/ : un module par composant, types, styles.css
949
976
  enfoncement au clic ; pas de `pointer-events-none`, qui couperait l'infobulle de sa raison ;
950
977
  - `button.tsx` : taille `inline` (`h-auto min-h-6 gap-1 px-0`), pour un lien `variant="link"`
951
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 ;
952
986
  - `button.tsx` : `enCours` (roue muette à la place des icônes, `aria-busy`, `data-en-cours`,
953
987
  pas de survol, clics ignorés, focus gardé par `focusableWhenDisabled`) et `libelleEnCours` ;
954
988
  un `children` n'est passé que s'il est donné (les enfants d'un `render` restent) ; `spinner.tsx` :
@@ -1048,20 +1082,23 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
1048
1082
 
1049
1083
  Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
1050
1084
 
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
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
1053
1087
  sombre), pris par le `body` au lieu de `bg-background`, `--background` restant celui du
1054
1088
  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`
1089
+ zinc-50) ; `--muted-foreground` celui du preset (zinc-500, 4,39:1 sur `--muted` en clair :
1090
+ contraste faible accepté) ; `--control-border`
1057
1091
  (`--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) ;
1092
+ clair = `--background` (barre latérale blanche, au lieu du zinc-50 du registre) ;
1059
1093
  `color-scheme` dans `:root` et `.dark`. Les valeurs sont commentées dans `styles.css` ;
1060
1094
  `theme.test.ts` compare chaque jeton au registre, écarts (`ECARTS`) exceptés, et en vérifie
1061
1095
  les contrastes. Hors `ui/` : `CenteredScreen` est posé sur `bg-muted/40` au lieu du
1062
1096
  `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.
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.
1065
1102
 
1066
1103
  Sans écart de code mais garanti par le même test : `Button` sans `type` rend
1067
1104
  `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>`. */