@etic-insa/ui 0.4.2 → 0.6.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 (54) hide show
  1. package/README.md +182 -51
  2. package/dist/charts/index.d.ts +1 -0
  3. package/dist/charts/index.js +1 -0
  4. package/dist/components/etic/centered-screen.d.ts +19 -1
  5. package/dist/components/etic/centered-screen.js +35 -3
  6. package/dist/components/etic/centered-screen.js.map +1 -1
  7. package/dist/components/etic/data-table-toolbar.d.ts +6 -4
  8. package/dist/components/etic/data-table-toolbar.js +2 -2
  9. package/dist/components/etic/data-table-toolbar.js.map +1 -1
  10. package/dist/components/etic/data-table.d.ts +3 -1
  11. package/dist/components/etic/data-table.js.map +1 -1
  12. package/dist/components/etic/dropdown-menu-action.d.ts +30 -0
  13. package/dist/components/etic/dropdown-menu-action.js +30 -0
  14. package/dist/components/etic/dropdown-menu-action.js.map +1 -0
  15. package/dist/components/etic/error-banner.d.ts +44 -10
  16. package/dist/components/etic/error-banner.js +47 -28
  17. package/dist/components/etic/error-banner.js.map +1 -1
  18. package/dist/components/etic/form-dialog.d.ts +8 -1
  19. package/dist/components/etic/form-dialog.js +92 -60
  20. package/dist/components/etic/form-dialog.js.map +1 -1
  21. package/dist/components/etic/form-field.d.ts +10 -1
  22. package/dist/components/etic/form-field.js +32 -28
  23. package/dist/components/etic/form-field.js.map +1 -1
  24. package/dist/components/etic/page-header.d.ts +2 -1
  25. package/dist/components/etic/page-header.js +40 -52
  26. package/dist/components/etic/page-header.js.map +1 -1
  27. package/dist/components/etic/progress-ring.d.ts +23 -0
  28. package/dist/components/etic/progress-ring.js +46 -0
  29. package/dist/components/etic/progress-ring.js.map +1 -0
  30. package/dist/components/etic/reset-button.d.ts +37 -0
  31. package/dist/components/etic/reset-button.js +41 -0
  32. package/dist/components/etic/reset-button.js.map +1 -0
  33. package/dist/components/etic/save-bar.d.ts +29 -8
  34. package/dist/components/etic/save-bar.js +40 -25
  35. package/dist/components/etic/save-bar.js.map +1 -1
  36. package/dist/components/etic/verdict-panel.d.ts +25 -0
  37. package/dist/components/etic/verdict-panel.js +42 -0
  38. package/dist/components/etic/verdict-panel.js.map +1 -0
  39. package/dist/components/ui/chart.d.ts +44 -0
  40. package/dist/components/ui/chart.js +131 -0
  41. package/dist/components/ui/chart.js.map +1 -0
  42. package/dist/components/ui/sheet.js +41 -36
  43. package/dist/components/ui/sheet.js.map +1 -1
  44. package/dist/index.d.ts +6 -2
  45. package/dist/index.js +49 -45
  46. package/dist/lib/ton.d.ts +7 -0
  47. package/dist/lib/ton.js +15 -0
  48. package/dist/lib/ton.js.map +1 -1
  49. package/dist/testing/index.d.ts +19 -0
  50. package/dist/testing/index.js +40 -0
  51. package/dist/testing/index.js.map +1 -0
  52. package/package.json +28 -3
  53. package/vite-plugin.d.ts +31 -0
  54. package/vite-plugin.js +162 -0
package/README.md CHANGED
@@ -12,7 +12,8 @@ npm i @etic-insa/ui
12
12
 
13
13
  Prérequis (dépendances pairs) : React 19.2 ou plus récent (`useEffectEvent`), Tailwind CSS 4
14
14
  (`tailwindcss` et `@tailwindcss/vite`) et `lucide-react` (les icônes passées aux composants,
15
- `icone={UsersIcon}`, viennent de l'application).
15
+ `icone={UsersIcon}`, viennent de l'application). `recharts` 3.8 ou plus récent seulement pour les
16
+ graphiques (`@etic-insa/ui/charts`, voir [Graphiques](#graphiques)).
16
17
  `QueryBoundary` accepte tel quel le résultat de `useQuery` (TanStack Query), sans que la
17
18
  bibliothèque dépende de TanStack Query : il ne lit que la forme de la requête.
18
19
 
@@ -244,32 +245,35 @@ Compositions des primitives shadcn pour les états d'une page et les actions cou
244
245
  connaissent ni l'API ni le routeur : l'application fournit ses fonctions (envoi, suppression,
245
246
  chargement d'une image) et, au besoin, son composant de lien (`lien`, comme pour `AppShell`).
246
247
 
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). |
248
+ | Composant | Rôle |
249
+ | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
250
+ | `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. |
251
+ | `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. |
252
+ | `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. |
253
+ | `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). |
254
+ | `PageContainer` | Conteneur de page dans `AppShell` : marges, `largeur` maximale, espacement entre les blocs. |
255
+ | `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é, l'entrée `DropdownMenuAction` des autres menus), `compact` quand la fiche répète déjà son nom. |
256
+ | `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). |
257
+ | `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`) ; voir `ErrorBannerProvider` pour masquer le code. |
258
+ | `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. |
259
+ | `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. |
260
+ | `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. |
261
+ | `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 ». |
262
+ | `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`. |
263
+ | `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. |
264
+ | `CenteredScreen`, `MessageScreen` | É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é ; écran qui ne dit qu'une chose (page introuvable, lien expiré) : `icone` en pastille, `titre` (`<h1>`), `description`, `actions`. |
265
+ | `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"`), `ProgressRing`, `VerdictPanel`, le segment choisi d'un `SegmentedControl` et un `IconToggle` actif. |
266
+ | `VerdictPanel` | Verdict d'une page de supervision, lu avant le détail : `ton` (`success` tout va bien, `warning` à surveiller, `destructive` en panne), `titre` (la phrase qui dit l'état), `detail`, `action` (un bouton, qui passe sous le texte quand la place manque). Carte au liseré du ton ; signe du ton en pastille (coche, triangle, croix, `i`, trait), caché aux lecteurs d'écran, `icone` pour un autre. |
267
+ | `ProgressRing` | Jauge circulaire d'une ressource qui se remplit (mémoire, disque, quota), le pendant rond de `Progress`, en SVG sans bibliothèque de graphiques : `valeur` de 0 à 100 (bornée ; `null`, piste vide), `ton` de l'arc (l'accent par défaut), `libelle` lu par les lecteurs d'écran (« Mémoire : 45 % »), `children` au centre (le pourcentage), caché à ces lecteurs. Taille par `className` (`size-28` par défaut). |
268
+ | `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). |
269
+ | `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`). |
270
+ | `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, sur une carte opaque alignée sur celles de la page, collé en bas de l'écran tant qu'il y a des modifications (`modifie`) ou un envoi en cours, à sa place sinon ; `masqueeAuRepos` ne l'affiche qu'avec quelque chose à dire. Les deux boutons ne se séparent jamais : au téléphone, le statut passe à la ligne ou se replie. Après « Annuler », le focus passe à « Enregistrer ». `retablirDefauts` (`onRetablir`, `masque`) : le ↶ général d'un formulaire à valeurs par défaut, à l'autre bout des boutons. |
271
+ | `ResetButton` | Retour à la valeur par défaut : icône ↶ seule, « Rétablir la valeur par défaut : 6 » en infobulle (`valeur`, telle qu'elle s'affiche), jamais de texte « Rétablir 6 » sous le champ. Dans un `FormField`, passé à son `action` : à droite du contrôle, nommé avec le libellé du champ, focus rendu au contrôle au clic (dans un groupe, à l'option rétablie). Toujours rendu, `masque` (invisible, sa place gardée) quand la valeur est déjà celle par défaut. Hors d'un `FormField` (`FieldSet`) : `libelleId` dit quel libellé citer, `cible` qui reçoit le focus. Sans `valeur` : « Rétablir toutes les valeurs par défaut ». Voir « Valeurs enregistrées et valeurs par défaut » plus bas. |
272
+ | `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. |
273
+ | `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). |
274
+ | `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). |
275
+ | `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. |
276
+ | `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). |
273
277
 
274
278
  `ConfirmDialog` et `FormDialog` s'ouvrent par un `declencheur`, ou sont contrôlés (`ouvert`,
275
279
  `onOuvertChange`). `DeleteButton` est son propre déclencheur ; `ouvert` et `onOuvertChange`
@@ -306,7 +310,11 @@ dialogue : pas de `key` à forcer. `FormDialog` prend `libelleAnnuler` (« Plus
306
310
  tête du pied (« Se déconnecter »), indisponible pendant l'envoi, qui ne ferme pas le dialogue
307
311
  d'elle-même ; si `onChoisir` renvoie une promesse, le dialogue l'attend comme un envoi (ce
308
312
  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 »
313
+ survol (comme `TooltipButton`). `modifie` (la saisie diffère de l'état initial) garde
314
+ `FormDialog` d'une perte : Échap, clic sur le voile, croix ou « Annuler » posent d'abord, en
315
+ tête du formulaire, « Abandonner la saisie ? » (« Continuer la saisie », qui reçoit le focus, ou
316
+ « Abandonner ») au lieu d'ouvrir un second dialogue ; un envoi réussi ferme sans rien demander.
317
+ Les boutons occupés de ces dialogues, de « Réessayer »
310
318
  (`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
319
  liste, choix segmenté… ; un panneau replié est ignoré). Tous les dialogues plafonnent leur
312
320
  hauteur à l'écran et gardent le focus : Tab et Maj+Tab en font le tour sans en sortir. Dans
@@ -362,6 +370,37 @@ const [conflit, setConflit] = useState(false)
362
370
  </QueryBoundary>
363
371
  ```
364
372
 
373
+ #### Affichage des erreurs
374
+
375
+ Une application dont les codes d'erreur ne parlent qu'aux développeurs (`not_found`…) les
376
+ masque une fois, à la racine : tous les bandeaux de la bibliothèque suivent
377
+ `ErrorBannerProvider` (`ErrorBanner`, `QueryErrorBanner`, `QueryBoundary`, le bandeau de
378
+ `DataTable`, l'erreur de `ConfirmDialog`, de `FormDialog` et de `DraftResumeDialog`).
379
+ L'erreur elle-même n'est pas réécrite : un 404 reste « introuvable » pour `QueryBoundary`.
380
+ `decrire` remplace la lecture de l'erreur (`decrireErreur`, exportée : message, code,
381
+ détail) pour une règle propre à l'application ; une fonction définie au niveau du module.
382
+
383
+ ```tsx
384
+ // Un détail à taire pour une famille d'erreurs.
385
+ const decrire = (erreur: unknown) => {
386
+ const lu = decrireErreur(erreur)
387
+ return estPanneExterne(erreur) ? { ...lu, detail: undefined } : lu
388
+ }
389
+
390
+ export function Racine() {
391
+ return (
392
+ <ErrorBannerProvider masquerCode decrire={decrire}>
393
+ <App />
394
+ </ErrorBannerProvider>
395
+ )
396
+ }
397
+ ```
398
+
399
+ `BoutonReessayer` (« Réessayer » des bandeaux, `size` `sm` ou `default`) et `DetailTechnique`
400
+ (détail replié sous « Détails », `libelle` au besoin) servent aussi hors d'un bandeau. La
401
+ colonne du texte d'un bandeau est bornée : une chaîne sans espace (adresse, identifiant) se
402
+ coupe au lieu de passer sous « Réessayer ».
403
+
365
404
  Primitives shadcn ajoutées pour ces usages : `Alert` a, en plus de `destructive`, les variantes
366
405
  `warning`, `info` et `success` (couleur `--info` dans le thème, contrastes vérifiés) ; `info` et
367
406
  `success`, messages d'état, portent `role="status"` (annoncés sans interrompre), les autres
@@ -415,6 +454,50 @@ texte affiché ; `SearchSelect` soumet `idElement(valeur)`.
415
454
  `useFormField()` renvoie `{ id, libelleId, descriptionId, erreurId, describedBy,
416
455
  obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe seul.
417
456
  `FormSection` regroupe des champs sous un titre (`FieldSet` + `FieldLegend`).
457
+ `action` : un bouton à droite du contrôle, sur sa ligne (un `ResetButton`). À passer
458
+ toujours, masqué au besoin : la ligne ajoutée ou retirée pendant la frappe ferait perdre le
459
+ focus au contrôle. Le contrôle prend la place restante, dans la limite de sa largeur
460
+ maximale.
461
+
462
+ #### Valeurs enregistrées et valeurs par défaut
463
+
464
+ Règle commune aux formulaires de page (profil, paramètres) :
465
+
466
+ - **« Enregistrer » est commun à toute la page**, une seule `SaveBar`, avec à ses côtés
467
+ **« Annuler »**, qui remet chaque champ à sa valeur enregistrée (`onAnnuler`, passé tant
468
+ qu'il y a des modifications).
469
+ - **Un champ qui a une valeur par défaut** porte un `ResetButton` (son `action`), visible dès
470
+ que la valeur s'en écarte, enregistrée ou non (en un fondu bref) ; l'infobulle dit la valeur
471
+ rétablie. La page ajoute le bouton général, `retablirDefauts` de la `SaveBar`, visible
472
+ seulement quand une valeur **enregistrée** s'écarte de son défaut (et que la saisie ne les
473
+ vaut pas déjà toutes) : quand seule la saisie s'en écarte, « Annuler » fait la même chose.
474
+ - **Rétablir ne fait que remplir le formulaire** : rien n'est écrit avant « Enregistrer », qui
475
+ confirme ; « Annuler » revient encore à l'enregistré. Pas d'autre confirmation.
476
+ - **Aucun texte « Rétablir 8 Mo » ni « Défaut : 8 Mo »** sous les champs : la valeur par
477
+ défaut n'est dite que par l'infobulle du bouton.
478
+
479
+ ```tsx
480
+ <FormField
481
+ libelle="Copies conservées"
482
+ action={
483
+ <ResetButton
484
+ valeur={String(defauts.copies)}
485
+ masque={saisie.copies === defauts.copies}
486
+ onRetablir={() => modifier("copies", defauts.copies)}
487
+ />
488
+ }
489
+ >
490
+ <Input className="max-w-24" value={saisie.copies} onChange={…} />
491
+ </FormField>
492
+
493
+ <SaveBar
494
+ collante
495
+ modifie={modifie}
496
+ desactive={!modifie}
497
+ onAnnuler={modifie ? annuler : undefined}
498
+ retablirDefauts={{ onRetablir: toutRetablir, masque: toutAuDefaut }}
499
+ />
500
+ ```
418
501
 
419
502
  - `DatePicker` : le Date Picker de shadcn avec saisie au clavier (jj/mm/aaaa, ou les chiffres
420
503
  seuls `05032026` pour le pavé numérique de l'iPhone ; lue en quittant le champ ou sur
@@ -531,6 +614,7 @@ l'assistant typé, `useDataTable` crée l'instance, les composants la reçoivent
531
614
  | `dataTableActionsColumn` | colonne des commandes d'une ligne : en-tête lu mais invisible, commandes à droite |
532
615
  | `DataTableCellLink` | titre d'une ligne : vrai lien (`href`, routeur par `lien`) ou bouton |
533
616
  | `DataTableRowActions` | menu « … » d'une ligne |
617
+ | `DropdownMenuAction` | entrée d'un menu d'actions : `libelle`, `icone`, `destructif`, `description` ; `verrou` grise l'entrée et affiche sa raison sous le libellé |
534
618
  | `DataTableViewOptions` | bouton « Colonnes » : afficher, masquer, réordonner (glisser-déposer, clavier compris) |
535
619
  | `DataTableToolbar` | recherche, filtres (`DataTableSelectFilter`), compteur (`DataTableCount`), commandes |
536
620
  | `DataTablePagination` | pagination par décalage (offset/limit, total connu), ou celle du tableau (`table`) |
@@ -641,7 +725,8 @@ autres) : une cellule qui affiche un autre état le lit elle-même (hook, contex
641
725
 
642
726
  Accessibilité : le tri choisi, le chargement et « tous sélectionnés » sont annoncés par le
643
727
  tableau ; `DataTableCount` est une zone de statut (le nouveau compte après une recherche ou un
644
- filtre est annoncé) ; `DataTablePagination` annonce la page atteinte. Quand un contrôle disparaît
728
+ filtre est annoncé), qui n'ajoute la tranche affichée (« · 26–50 affichées », `feminin`) que si
729
+ la liste tient sur plusieurs pages ; `DataTablePagination` annonce la page atteinte. Quand un contrôle disparaît
645
730
  sous le focus (« Réinitialiser », la croix de la recherche, le bandeau ou la barre de sélection),
646
731
  le focus passe à un élément stable (champ de recherche, premier filtre, case d'en-tête). Le clic
647
732
  de ligne (`onActiverLigne`) est un raccourci à la souris : une cellule doit aussi offrir un lien
@@ -901,34 +986,74 @@ const visibles = postes.filter((p) => correspond(p.nom, p.pole?.nom))
901
986
  <Input type="search" {...NO_AUTOFILL} />
902
987
  ```
903
988
 
989
+ ### Graphiques
990
+
991
+ `@etic-insa/ui/charts` : le [Chart de shadcn](https://ui.shadcn.com/docs/components/base/chart)
992
+ (`ChartContainer`, `ChartTooltip`, `ChartTooltipContent`, `ChartLegend`, `ChartLegendContent`,
993
+ `ChartStyle`, type `ChartConfig`), tel quel, sur [recharts](https://recharts.github.io). Une
994
+ entrée à part, parce que `recharts` (~420 Ko) est une dépendance pair facultative : seule une
995
+ application à graphiques l'installe (`npm i recharts`), et elle peut charger ses graphiques à
996
+ la demande (`React.lazy`). Les composants de recharts (`AreaChart`, `XAxis`…) s'importent de
997
+ `recharts` ; la taille vient de `className` (`aspect-video` par défaut). Une jauge circulaire
998
+ seule n'en a pas besoin : `ProgressRing`, dans l'entrée principale.
999
+
1000
+ ```tsx
1001
+ const config = { charge: { label: "Charge", color: "var(--primary)" } } satisfies ChartConfig
1002
+
1003
+ <ChartContainer config={config} className="h-52 w-full">
1004
+ <AreaChart data={points}>
1005
+ <ChartTooltip content={<ChartTooltipContent />} />
1006
+ <Area dataKey="charge" stroke="var(--color-charge)" fill="var(--color-charge)" />
1007
+ </AreaChart>
1008
+ </ChartContainer>
1009
+ ```
1010
+
1011
+ ### Tests des applications
1012
+
1013
+ `@etic-insa/ui/test` réunit des outils pour les tests (vitest) des applications ; une entrée à
1014
+ part, qui n'entre pas dans leur bundle. `installMatchMedia()` remplace `window.matchMedia` par
1015
+ une doublure pilotable (celui de jsdom n'existe pas, celui de happy-dom suit une fenêtre fixe de
1016
+ 1 024 px, donc mobile pour la bibliothèque) ; `setMobileViewport(true)` passe en affichage
1017
+ mobile, dans un `act()` sur un composant déjà monté. Seule la requête de `useIsMobile` est
1018
+ connue ; toute autre ne correspond pas.
1019
+
1020
+ ```ts
1021
+ // src/test/setup.ts de l'application
1022
+ import { beforeEach } from "vitest"
1023
+ import { installMatchMedia, setMobileViewport } from "@etic-insa/ui/test"
1024
+
1025
+ installMatchMedia()
1026
+ beforeEach(() => setMobileViewport(false))
1027
+ ```
1028
+
904
1029
  ### Développer contre les sources locales
905
1030
 
906
1031
  Pour voir une modification de la bibliothèque instantanément dans une application, sans publier,
907
- avec le dépôt `etic-packages` cloné sur le même poste :
1032
+ avec le dépôt `etic-packages` cloné sur le même poste, le plugin Vite `@etic-insa/ui/vite`
1033
+ sert ses sources à la place des paquets installés, en développement seulement (`vite`, jamais
1034
+ le build ni vitest) :
908
1035
 
909
1036
  ```ts
910
- // vite.config.ts de l'application : en développement seulement
911
- // (chemin vers packages/ui/src, ici pour une application à côté d'etic-packages)
912
- const UI_SRC = path.resolve(__dirname, "../etic-packages/packages/ui/src")
913
-
914
- export default defineConfig(({ command }) => ({
915
- resolve:
916
- command === "serve"
917
- ? {
918
- alias: {
919
- "@etic-insa/ui": UI_SRC,
920
- // les composants s'importent entre eux par « @etic-ui/… »
921
- "@etic-ui": UI_SRC,
922
- },
923
- // une seule copie de React, même si etic-packages a ses propres node_modules
924
- dedupe: ["react", "react-dom"],
925
- }
926
- : {},
927
- }))
1037
+ // vite.config.ts de l'application
1038
+ import { eticPackagesSources } from "@etic-insa/ui/vite"
1039
+
1040
+ export default defineConfig({
1041
+ // Avant tailwindcss() : la feuille qui importe @etic-insa/ui/styles.css reçoit le @source
1042
+ // des sources.
1043
+ plugins: [eticPackagesSources({ auth: true }), tailwindcss(), react()],
1044
+ })
928
1045
  ```
929
1046
 
930
- Côté CSS, ajouter un `@source` vers ce même dossier `src` et importer son `styles.css` au lieu
931
- de celui du paquet.
1047
+ Les sources sont celles de `ETIC_UI_SOURCES` (chemin de `packages/ui/src`), sinon d'un
1048
+ `etic-packages` à côté du dépôt de l'application (depuis un worktree aussi), et seulement si ce
1049
+ checkout a ses `node_modules` (`npm ci` à sa racine) ; `ETIC_UI_SOURCES=npm` force les paquets
1050
+ installés. Le plugin pose les alias (`@etic-insa/ui`, ses `/styles.css`, `/test` et `/charts`,
1051
+ `@etic-ui/…` ; `@etic-insa/auth` avec `auth: true`), une seule copie de React et de recharts
1052
+ (le `ChartContainer` des sources partage ses contextes avec les graphiques de l'application ;
1053
+ `dedupe` en ajoute : `["@tanstack/react-query"]` pour que l'`AuthProvider` des sources voie le
1054
+ `QueryClient` de l'application), l'accès du serveur au checkout, le `@source` de Tailwind, et
1055
+ annonce au démarrage ce qu'il sert (branche, commit, modifications). Il n'emploie que Node et
1056
+ Vite (`vite`, dépendance pair facultative).
932
1057
 
933
1058
  ## Développer la bibliothèque
934
1059
 
@@ -1091,7 +1216,11 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
1091
1216
  `CLASSES_BULLE` et `CLASSES_FLECHE` (internes) portent l'allure de la bulle, partagée
1092
1217
  avec `Toggletip` ;
1093
1218
  - `popover.tsx` : `PopoverContent` accepte `anchor` (celui du `Positioner` de Base UI),
1094
- pour un popover sans `PopoverTrigger` (`Toggletip`, ancré sur l'élément qu'il explique).
1219
+ pour un popover sans `PopoverTrigger` (`Toggletip`, ancré sur l'élément qu'il explique) ;
1220
+ - `sheet.tsx` : `SheetHeader` réserve à droite la place de la croix (`pr-12`) quand
1221
+ `SheetContent` l'affiche (`showCloseButton`, vrai par défaut), au lieu de laisser un long
1222
+ titre passer dessous ; `SheetContent` le lui dit par un contexte. Un `className` de
1223
+ l'application l'emporte.
1095
1224
 
1096
1225
  Le thème ajoute aussi (`styles.css`, hors composants shadcn) la règle de mouvement réduit.
1097
1226
 
@@ -1118,6 +1247,8 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
1118
1247
 
1119
1248
  - `src/components/etic/` : composants ETIC qui importent ceux de `ui/` et ajoutent
1120
1249
  comportement, composition ou variantes.
1250
+ - `src/charts/index.ts` : l'entrée `@etic-insa/ui/charts` (`components/ui/chart.tsx`, sans
1251
+ écart, seul à importer recharts : `charts.test.tsx` le vérifie).
1121
1252
  - `src/index.ts` : tout ce qu'une application peut importer. Un composant non exporté ici
1122
1253
  n'existe pas pour les applications.
1123
1254
  - `src/styles.css` : thème commun (clair et sombre). Au build, `scripts/build-css.mjs` y recopie
@@ -0,0 +1 @@
1
+ export { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, type ChartConfig, } from '../components/ui/chart';
@@ -0,0 +1 @@
1
+ export { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from "../components/ui/chart.js";
@@ -1,4 +1,5 @@
1
- import { ComponentProps } from 'react';
1
+ import { ComponentProps, ReactNode } from 'react';
2
+ import { LucideIcon } from 'lucide-react';
2
3
  export type CenteredScreenProps = ComponentProps<"main">;
3
4
  /**
4
5
  * Écran hors de la coquille (connexion, retour du fournisseur d'identité,
@@ -11,3 +12,20 @@ export type CenteredScreenProps = ComponentProps<"main">;
11
12
  * dessus.
12
13
  */
13
14
  export declare function CenteredScreen({ className, ...props }: CenteredScreenProps): import("react").JSX.Element;
15
+ export interface MessageScreenProps extends Omit<CenteredScreenProps, "children"> {
16
+ /** Titre de la page (`<h1>`) : « Page introuvable ». */
17
+ titre: ReactNode;
18
+ /** Phrase sous le titre : pourquoi, et ce que la personne peut faire. */
19
+ description?: ReactNode;
20
+ /** Icône lucide (le composant : `icone={SearchXIcon}`), dans sa pastille. */
21
+ icone?: LucideIcon;
22
+ /** Le geste suivant : un lien de retour, un bouton. */
23
+ actions?: ReactNode;
24
+ }
25
+ /**
26
+ * Écran entier qui ne dit qu'une chose (page introuvable, lien incomplet ou
27
+ * expiré, accès refusé) : icône, titre, phrase et actions, centrés dans la
28
+ * fenêtre, sur un `CenteredScreen` (dont il relaie les attributs). Un seul
29
+ * gabarit pour que ces écrans se ressemblent d'une application à l'autre.
30
+ */
31
+ export declare function MessageScreen({ titre, description, icone: Icone, actions, ...props }: MessageScreenProps): import("react").JSX.Element;
@@ -1,13 +1,45 @@
1
1
  import { cn as e } from "cn";
2
- import { jsx as t } from "react/jsx-runtime";
2
+ import { jsx as t, jsxs as n } from "react/jsx-runtime";
3
3
  // src/components/etic/centered-screen.tsx
4
- function n({ className: n, ...r }) {
4
+ function r({ className: n, ...r }) {
5
5
  return /* @__PURE__ */ t("main", {
6
6
  "data-slot": "centered-screen",
7
7
  className: e("flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10", n),
8
8
  ...r
9
9
  });
10
10
  }
11
- export { n as CenteredScreen };
11
+ function i({ titre: e, description: i, icone: a, actions: o, ...s }) {
12
+ return /* @__PURE__ */ t(r, {
13
+ ...s,
14
+ children: /* @__PURE__ */ n("div", {
15
+ "data-slot": "message-screen",
16
+ className: "flex max-w-md flex-col items-center gap-4 text-center",
17
+ children: [
18
+ a ? /* @__PURE__ */ t("div", {
19
+ className: "flex size-12 items-center justify-center rounded-full bg-muted text-muted-foreground",
20
+ children: /* @__PURE__ */ t(a, {
21
+ className: "size-6",
22
+ "aria-hidden": "true"
23
+ })
24
+ }) : null,
25
+ /* @__PURE__ */ n("div", {
26
+ className: "flex flex-col gap-2",
27
+ children: [/* @__PURE__ */ t("h1", {
28
+ className: "text-2xl font-semibold tracking-tight",
29
+ children: e
30
+ }), i ? /* @__PURE__ */ t("p", {
31
+ className: "text-sm text-muted-foreground",
32
+ children: i
33
+ }) : null]
34
+ }),
35
+ o ? /* @__PURE__ */ t("div", {
36
+ className: "flex flex-wrap justify-center gap-2",
37
+ children: o
38
+ }) : null
39
+ ]
40
+ })
41
+ });
42
+ }
43
+ export { r as CenteredScreen, i as MessageScreen };
12
44
 
13
45
  //# sourceMappingURL=centered-screen.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"centered-screen.js","names":["CenteredScreen","props","cn","className"],"sources":["../../../src/components/etic/centered-screen.tsx"],"sourcesContent":["import type { ComponentProps } from \"react\"\nimport { cn } from \"cn\"\n\nexport type CenteredScreenProps = ComponentProps<\"main\">\n\n/**\n * Écran hors de la coquille (connexion, retour du fournisseur d'identité,\n * page introuvable, vérification de la session) : le contenu centré dans\n * toute la hauteur, sur le fond estompé, comme les blocs de connexion de\n * shadcn. C'est le `<main>` de la page.\n *\n * Écart avec shadcn : `bg-muted/40` au lieu de `bg-muted`, un fond moins\n * appuyé, surtout en sombre où `--muted` est plus clair que la carte posée\n * dessus.\n */\nexport function CenteredScreen({ className, ...props }: CenteredScreenProps) {\n return (\n <main\n data-slot=\"centered-screen\"\n className={cn(\n \"flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10\",\n className\n )}\n {...props}\n />\n )\n}\n"],"mappings":";;;AAeA,SAAgBA,EAAe,EAAE,cAAW,GAAGC,KAA8B;CAC3E,OACE,kBAAC,QAAD;EACE,aAAU;EACV,WAAWC,EACT,4FACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL"}
1
+ {"version":3,"file":"centered-screen.js","names":["CenteredScreen","props","cn","className","MessageScreen","Icone","titre","description","actions"],"sources":["../../../src/components/etic/centered-screen.tsx"],"sourcesContent":["import type { ComponentProps, ReactNode } from \"react\"\nimport { cn } from \"cn\"\nimport type { LucideIcon } from \"lucide-react\"\n\nexport type CenteredScreenProps = ComponentProps<\"main\">\n\n/**\n * Écran hors de la coquille (connexion, retour du fournisseur d'identité,\n * page introuvable, vérification de la session) : le contenu centré dans\n * toute la hauteur, sur le fond estompé, comme les blocs de connexion de\n * shadcn. C'est le `<main>` de la page.\n *\n * Écart avec shadcn : `bg-muted/40` au lieu de `bg-muted`, un fond moins\n * appuyé, surtout en sombre où `--muted` est plus clair que la carte posée\n * dessus.\n */\nexport function CenteredScreen({ className, ...props }: CenteredScreenProps) {\n return (\n <main\n data-slot=\"centered-screen\"\n className={cn(\n \"flex min-h-svh w-full flex-col items-center justify-center gap-6 bg-muted/40 p-6 md:p-10\",\n className\n )}\n {...props}\n />\n )\n}\n\nexport interface MessageScreenProps extends Omit<\n CenteredScreenProps,\n \"children\"\n> {\n /** Titre de la page (`<h1>`) : « Page introuvable ». */\n titre: ReactNode\n /** Phrase sous le titre : pourquoi, et ce que la personne peut faire. */\n description?: ReactNode\n /** Icône lucide (le composant : `icone={SearchXIcon}`), dans sa pastille. */\n icone?: LucideIcon\n /** Le geste suivant : un lien de retour, un bouton. */\n actions?: ReactNode\n}\n\n/**\n * Écran entier qui ne dit qu'une chose (page introuvable, lien incomplet ou\n * expiré, accès refusé) : icône, titre, phrase et actions, centrés dans la\n * fenêtre, sur un `CenteredScreen` (dont il relaie les attributs). Un seul\n * gabarit pour que ces écrans se ressemblent d'une application à l'autre.\n */\nexport function MessageScreen({\n titre,\n description,\n icone: Icone,\n actions,\n ...props\n}: MessageScreenProps) {\n return (\n <CenteredScreen {...props}>\n <div\n data-slot=\"message-screen\"\n className=\"flex max-w-md flex-col items-center gap-4 text-center\"\n >\n {Icone ? (\n <div className=\"flex size-12 items-center justify-center rounded-full bg-muted text-muted-foreground\">\n <Icone className=\"size-6\" aria-hidden=\"true\" />\n </div>\n ) : null}\n <div className=\"flex flex-col gap-2\">\n <h1 className=\"text-2xl font-semibold tracking-tight\">{titre}</h1>\n {description ? (\n <p className=\"text-sm text-muted-foreground\">{description}</p>\n ) : null}\n </div>\n {actions ? (\n <div className=\"flex flex-wrap justify-center gap-2\">{actions}</div>\n ) : null}\n </div>\n </CenteredScreen>\n )\n}\n"],"mappings":";;;AAgBA,SAAgBA,EAAe,EAAE,cAAW,GAAGC,KAA8B;CAC3E,OACE,kBAAC,QAAD;EACE,aAAU;EACV,WAAWC,EACT,4FACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAsBA,SAAgBG,EAAc,EAC5B,UACA,gBACA,OAAOC,GACP,YACA,GAAGJ,KACkB;CACrB,OACE,kBAACD,GAAD;EAAgB,GAAIC;EAClB,UAAA,kBAAC,OAAD;GACE,aAAU;GACV,WAAU;GAFZ,UAAA;IAIGI,IACC,kBAAC,OAAD;KAAK,WAAU;KACb,UAAA,kBAACA,GAAD;MAAO,WAAU;MAAS,eAAY;KAAQ,CAAA;IAC3C,CAAA,IACH;IACJ,kBAAC,OAAD;KAAK,WAAU;KAAf,UAAA,CACE,kBAAC,MAAD;MAAI,WAAU;MAAyC,UAAAC;KAAU,CAAA,GAChEC,IACC,kBAAC,KAAD;MAAG,WAAU;MAAiC,UAAAA;KAAe,CAAA,IAC3D,IACD;;IACJC,IACC,kBAAC,OAAD;KAAK,WAAU;KAAuC,UAAAA;IAAa,CAAA,IACjE;GACD;;CACS,CAAA;AAEpB"}
@@ -5,7 +5,7 @@ import { DataTableInstance } from './data-table';
5
5
  interface DataTableCountCommun {
6
6
  /** Nom des éléments. « élément », « éléments » par défaut. */
7
7
  unite?: DataTableUnite;
8
- /** Accorde « affichées » au féminin. */
8
+ /** Accorde « affichées » au féminin (« 26–50 affichées »). */
9
9
  feminin?: boolean;
10
10
  className?: string;
11
11
  }
@@ -26,9 +26,11 @@ export interface DataTableCountTableProps<TData extends RowData = RowData> exten
26
26
  }
27
27
  export type DataTableCountProps<TData extends RowData = RowData> = DataTableCountNombresProps | DataTableCountTableProps<TData>;
28
28
  /**
29
- * Compteur d'une liste : « 128 éléments · 26–50 affichés ». C'est une zone
30
- * de statut : après une recherche, un filtre ou un changement de page, le
31
- * nouveau compte est annoncé sans déplacer le focus. Avec `table`, il lit
29
+ * Compteur d'une liste : « 128 éléments · 26–50 affichés ». La tranche
30
+ * affichée n'apparaît que si la liste tient sur plusieurs pages : quand
31
+ * tout est affiché, elle redirait le total (« 7 éléments » seul). C'est une
32
+ * zone de statut : après une recherche, un filtre ou un changement de page,
33
+ * le nouveau compte est annoncé sans déplacer le focus. Avec `table`, il lit
32
34
  * les nombres de la pagination côté client.
33
35
  */
34
36
  export declare function DataTableCount<TData extends RowData>(props: DataTableCountProps<TData>): import("react").JSX.Element;
@@ -14,7 +14,7 @@ import { jsx as E, jsxs as D } from "react/jsx-runtime";
14
14
  import { ListFilterIcon as O, SearchIcon as k, XIcon as A } from "lucide-react";
15
15
  // src/components/etic/data-table-toolbar.tsx
16
16
  function j(e) {
17
- let { unite: i = b, feminin: a = !1, className: o } = e, { total: s, decalage: c = 0, nombre: l } = e.table ? x(e.table) : e, u = c + 1, d = c + l;
17
+ let { unite: i = b, feminin: a = !1, className: o } = e, { total: s, decalage: c = 0, nombre: l } = e.table ? x(e.table) : e, u = c + 1, d = c + l, f = c === 0 && l >= s;
18
18
  return /* @__PURE__ */ D("p", {
19
19
  "data-slot": "data-table-count",
20
20
  role: "status",
@@ -27,7 +27,7 @@ function j(e) {
27
27
  }),
28
28
  " ",
29
29
  r(s, i),
30
- l > 0 ? /* @__PURE__ */ D("span", {
30
+ l > 0 && !f ? /* @__PURE__ */ D("span", {
31
31
  className: "tabular-nums",
32
32
  children: [
33
33
  " ",