@etic-insa/ui 0.5.0 → 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.
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é, l'entrée `DropdownMenuAction` des autres menus), `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`) ; voir `ErrorBannerProvider` pour masquer le code. |
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`, `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`. |
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, 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. |
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`
@@ -450,6 +454,50 @@ texte affiché ; `SearchSelect` soumet `idElement(valeur)`.
450
454
  `useFormField()` renvoie `{ id, libelleId, descriptionId, erreurId, describedBy,
451
455
  obligatoire, invalide }`, ou `null` hors d'un `FormField`. `RequiredMark` existe seul.
452
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
+ ```
453
501
 
454
502
  - `DatePicker` : le Date Picker de shadcn avec saisie au clavier (jj/mm/aaaa, ou les chiffres
455
503
  seuls `05032026` pour le pavé numérique de l'iPhone ; lue en quittant le champ ou sur
@@ -938,6 +986,28 @@ const visibles = postes.filter((p) => correspond(p.nom, p.pole?.nom))
938
986
  <Input type="search" {...NO_AUTOFILL} />
939
987
  ```
940
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
+
941
1011
  ### Tests des applications
942
1012
 
943
1013
  `@etic-insa/ui/test` réunit des outils pour les tests (vitest) des applications ; une entrée à
@@ -977,9 +1047,10 @@ export default defineConfig({
977
1047
  Les sources sont celles de `ETIC_UI_SOURCES` (chemin de `packages/ui/src`), sinon d'un
978
1048
  `etic-packages` à côté du dépôt de l'application (depuis un worktree aussi), et seulement si ce
979
1049
  checkout a ses `node_modules` (`npm ci` à sa racine) ; `ETIC_UI_SOURCES=npm` force les paquets
980
- installés. Le plugin pose les alias (`@etic-insa/ui`, ses `/styles.css` et `/test`,
981
- `@etic-ui/…` ; `@etic-insa/auth` avec `auth: true`), une seule copie de React (`dedupe` en
982
- ajoute : `["@tanstack/react-query"]` pour que l'`AuthProvider` des sources voie le
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
983
1054
  `QueryClient` de l'application), l'accès du serveur au checkout, le `@source` de Tailwind, et
984
1055
  annonce au démarrage ce qu'il sert (branche, commit, modifications). Il n'emploie que Node et
985
1056
  Vite (`vite`, dépendance pair facultative).
@@ -1176,6 +1247,8 @@ overflow-y-auto`), en-tête, croix et pied restant visibles ; sans elle, tout le
1176
1247
 
1177
1248
  - `src/components/etic/` : composants ETIC qui importent ceux de `ui/` et ajoutent
1178
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).
1179
1252
  - `src/index.ts` : tout ce qu'une application peut importer. Un composant non exporté ici
1180
1253
  n'existe pas pour les applications.
1181
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";
@@ -81,7 +81,7 @@ function w({ erreur: i, titre: a, description: o, detail: s, onReessayer: l, enC
81
81
  let x = y(i), w = _ ? void 0 : x.code, T = s === void 0 ? x.detail : s;
82
82
  return /* @__PURE__ */ m(e, {
83
83
  variant: "destructive",
84
- className: c("has-[>svg]:grid-cols-[auto_minmax(0,1fr)] *:data-[slot=alert-description]:wrap-break-word *:data-[slot=alert-title]:wrap-break-word", l && "has-data-[slot=alert-action]:pr-32", g),
84
+ className: c("has-[>svg]:grid-cols-[auto_minmax(0,1fr)] *:data-[slot=alert-description]:wrap-break-word *:data-[slot=alert-title]:wrap-break-word", l && "has-data-[slot=alert-action]:py-2.5 has-data-[slot=alert-action]:pr-32", g),
85
85
  children: [
86
86
  /* @__PURE__ */ p(h, {}),
87
87
  /* @__PURE__ */ p(r, { children: a ?? /* @__PURE__ */ m(f, { children: [w ? /* @__PURE__ */ m("span", {
@@ -89,10 +89,13 @@ function w({ erreur: i, titre: a, description: o, detail: s, onReessayer: l, enC
89
89
  children: [w, "\xA0: "]
90
90
  }) : null, x.message] }) }),
91
91
  o || !b(T) ? /* @__PURE__ */ m(n, { children: [o, b(T) ? null : /* @__PURE__ */ p(S, { detail: T })] }) : null,
92
- l ? /* @__PURE__ */ p(t, { children: /* @__PURE__ */ p(C, {
93
- onClick: l,
94
- enCours: d
95
- }) }) : null
92
+ l ? /* @__PURE__ */ p(t, {
93
+ className: "top-1.5",
94
+ children: /* @__PURE__ */ p(C, {
95
+ onClick: l,
96
+ enCours: d
97
+ })
98
+ }) : null
96
99
  ]
97
100
  });
98
101
  }
@@ -1 +1 @@
1
- {"version":3,"file":"error-banner.js","names":["_Fragment","Fragment$1","decrireErreur","erreur","message","code","details","ContexteAffichageErreurs","createContext","ErrorBannerProvider","valeur","useMemo","masquerCode","decrire","estVide","detail","texteDuDetail","vus","DetailTechnique","Collapsible","DisclosureTrigger","libelle","CollapsibleContent","BoutonReessayer","Button","RotateCwIcon","ErrorBanner","useContext","lu","detailAffiche","Alert","cn","onReessayer","className","CircleAlertIcon","AlertTitle","titre","description","AlertDescription","AlertAction"],"sources":["../../../src/components/etic/error-banner.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\"\nimport { cn } from \"cn\"\nimport { CircleAlertIcon, RotateCwIcon } from \"lucide-react\"\n\nimport {\n Alert,\n AlertAction,\n AlertDescription,\n AlertTitle,\n} from \"@etic-ui/components/ui/alert\"\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n Collapsible,\n CollapsibleContent,\n} from \"@etic-ui/components/ui/collapsible\"\nimport { DisclosureTrigger } from \"@etic-ui/components/etic/disclosure\"\n\nexport interface ErrorBannerProps {\n /**\n * L'erreur à afficher ; rien n'est rendu si elle est absente (`null`,\n * `undefined`, `false`). Lue sans rien connaître de l'application : son\n * `message` (une `Error`, ou tout objet qui en a un, ou une chaîne), son\n * `code` s'il est textuel, et son `details` s'il n'est pas vide.\n */\n erreur: unknown\n /** Remplace le message lu dans l'erreur. */\n titre?: ReactNode\n /** Phrase sous le message : ce que la personne peut faire. */\n description?: ReactNode\n /** Détail technique, replié sous « Détails ». Remplace `details` de l'erreur. */\n detail?: unknown\n /** Affiche « Réessayer », qui appelle cette fonction. */\n onReessayer?: () => void\n /** Nouvelle tentative en cours : « Réessayer » est occupé (roue,\n * `aria-busy`) et ignore les clics, sans perdre le focus. */\n enCours?: boolean\n className?: string\n}\n\n/** Ce qu'un bandeau affiche d'une erreur : son message, son code, son détail\n * technique (replié). */\nexport interface ErreurDecrite {\n message: string\n code?: string\n detail?: unknown\n}\n\n/** Message, code et détail d'une erreur de forme inconnue : son `message`\n * (un repli qui dit quoi faire s'il manque), son `code` s'il est textuel,\n * son `details`. */\nexport function decrireErreur(erreur: unknown): ErreurDecrite {\n if (typeof erreur === \"string\") return { message: erreur }\n if (typeof erreur === \"object\" && erreur !== null) {\n const { message, code, details } = erreur as Record<string, unknown>\n return {\n message:\n typeof message === \"string\" && message\n ? message\n : \"Une erreur s'est produite. Réessayez ; si elle persiste, prévenez l'équipe technique.\",\n code: typeof code === \"string\" && code ? code : undefined,\n detail: details,\n }\n }\n return { message: String(erreur) }\n}\n\ninterface AffichageErreurs {\n masquerCode: boolean\n decrire: (erreur: unknown) => ErreurDecrite\n}\n\nconst ContexteAffichageErreurs = createContext<AffichageErreurs>({\n masquerCode: false,\n decrire: decrireErreur,\n})\n\nexport interface ErrorBannerProviderProps {\n /** N'affiche jamais le code de l'erreur devant son message : le code\n * machine (`not_found`…) ne parle qu'aux développeurs. Faux par défaut. */\n masquerCode?: boolean\n /**\n * Lecture d'une erreur, à la place de `decrireErreur` : règle propre à\n * l'application (un détail à taire pour certaines erreurs…). Repartir de\n * `decrireErreur(erreur)` et n'en changer que ce qu'il faut. Une\n * référence stable, définie au niveau du module. `masquerCode`\n * s'applique au résultat.\n */\n decrire?: (erreur: unknown) => ErreurDecrite\n children: ReactNode\n}\n\n/**\n * Règle l'affichage des erreurs, une fois, autour de l'application : tous\n * les bandeaux de la bibliothèque la suivent (`ErrorBanner`,\n * `QueryErrorBanner`, `QueryBoundary`, le bandeau de `DataTable`, l'erreur\n * de `ConfirmDialog`, de `FormDialog` et de `DraftResumeDialog`). Sans lui,\n * le code s'affiche devant le message.\n */\nexport function ErrorBannerProvider({\n masquerCode = false,\n decrire = decrireErreur,\n children,\n}: ErrorBannerProviderProps) {\n const valeur = useMemo(\n () => ({ masquerCode, decrire }),\n [masquerCode, decrire]\n )\n return (\n <ContexteAffichageErreurs.Provider value={valeur}>\n {children}\n </ContexteAffichageErreurs.Provider>\n )\n}\n\nfunction estVide(detail: unknown) {\n if (detail === null || detail === undefined || detail === \"\") return true\n if (typeof detail === \"object\") return Object.keys(detail).length === 0\n return false\n}\n\n/**\n * Texte d'un détail technique. Ne lève jamais : un objet circulaire ou un\n * `BigInt` ferait planter `JSON.stringify`, et le bandeau d'erreur avec lui.\n */\nexport function texteDuDetail(detail: unknown): string {\n if (typeof detail === \"string\") return detail\n const vus = new WeakSet<object>()\n try {\n return JSON.stringify(\n detail,\n (_cle, valeur: unknown) => {\n if (typeof valeur === \"bigint\") return `${valeur}n`\n if (typeof valeur === \"object\" && valeur !== null) {\n if (vus.has(valeur)) return \"[référence circulaire]\"\n vus.add(valeur)\n }\n return valeur\n },\n 2\n )\n } catch {\n return String(detail)\n }\n}\n\n/** Bloc repliable d'un détail technique, fermé par défaut. */\nexport function DetailTechnique({\n libelle = \"Détails\",\n detail,\n}: {\n libelle?: string\n detail: unknown\n}) {\n return (\n <Collapsible className=\"mt-1\">\n <DisclosureTrigger variante=\"lien\" taille=\"xs\" className=\"text-current\">\n {libelle}\n </DisclosureTrigger>\n <CollapsibleContent>\n <pre className=\"mt-1 max-h-64 overflow-auto rounded-md bg-muted p-2 font-mono text-xs whitespace-pre-wrap text-foreground\">\n {texteDuDetail(detail)}\n </pre>\n </CollapsibleContent>\n </Collapsible>\n )\n}\n\nexport interface BoutonReessayerProps {\n onClick: () => void\n /** Nouvelle tentative en cours : occupé, mais focalisable. */\n enCours?: boolean\n /** `sm` par défaut, comme dans un bandeau ; `default` dans l'en-tête\n * d'une section, à côté de boutons ordinaires. */\n size?: \"sm\" | \"default\"\n}\n\n/** « Réessayer » d'un bandeau ou d'un repli d'erreur, et hors bandeau (une\n * ligne d'état, une phrase) : même allure partout, occupé mais focalisable\n * pendant la nouvelle tentative. */\nexport function BoutonReessayer({\n onClick,\n enCours = false,\n size = \"sm\",\n}: BoutonReessayerProps) {\n return (\n <Button variant=\"outline\" size={size} enCours={enCours} onClick={onClick}>\n <RotateCwIcon data-icon=\"inline-start\" />\n Réessayer\n </Button>\n )\n}\n\n/**\n * Bandeau d'erreur : le message en évidence, le code s'il y en a un (sauf\n * sous un `ErrorBannerProvider` qui le masque), le détail technique replié\n * sous « Détails », et « Réessayer » si l'action peut être relancée. Sur le\n * modèle de l'`Alert` destructive de shadcn.\n */\nexport function ErrorBanner({\n erreur,\n titre,\n description,\n detail,\n onReessayer,\n enCours = false,\n className,\n}: ErrorBannerProps) {\n const { masquerCode, decrire } = useContext(ContexteAffichageErreurs)\n if (erreur === null || erreur === undefined || erreur === false) return null\n const lu = decrire(erreur)\n const code = masquerCode ? undefined : lu.code\n const detailAffiche = detail === undefined ? lu.detail : detail\n\n return (\n <Alert\n variant=\"destructive\"\n className={cn(\n // Colonne du texte bornée (`minmax(0,1fr)` et non `1fr`, dont le\n // minimum est le mot le plus long) : une chaîne sans espace (adresse,\n // identifiant) se coupe au lieu d'élargir la colonne et de passer\n // sous « Réessayer ».\n \"has-[>svg]:grid-cols-[auto_minmax(0,1fr)] *:data-[slot=alert-description]:wrap-break-word *:data-[slot=alert-title]:wrap-break-word\",\n onReessayer && \"has-data-[slot=alert-action]:pr-32\",\n className\n )}\n >\n <CircleAlertIcon />\n <AlertTitle>\n {titre ?? (\n <>\n {code ? <span className=\"font-mono\">{code}&nbsp;: </span> : null}\n {lu.message}\n </>\n )}\n </AlertTitle>\n {description || !estVide(detailAffiche) ? (\n <AlertDescription>\n {description}\n {!estVide(detailAffiche) ? (\n <DetailTechnique detail={detailAffiche} />\n ) : null}\n </AlertDescription>\n ) : null}\n {onReessayer ? (\n <AlertAction>\n <BoutonReessayer onClick={onReessayer} enCours={enCours} />\n </AlertAction>\n ) : null}\n </Alert>\n )\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"error-banner.js","names":["_Fragment","Fragment$1","decrireErreur","erreur","message","code","details","ContexteAffichageErreurs","createContext","ErrorBannerProvider","valeur","useMemo","masquerCode","decrire","estVide","detail","texteDuDetail","vus","DetailTechnique","Collapsible","DisclosureTrigger","libelle","CollapsibleContent","BoutonReessayer","Button","RotateCwIcon","ErrorBanner","useContext","lu","detailAffiche","Alert","cn","onReessayer","className","CircleAlertIcon","AlertTitle","titre","description","AlertDescription","AlertAction"],"sources":["../../../src/components/etic/error-banner.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\"\nimport { cn } from \"cn\"\nimport { CircleAlertIcon, RotateCwIcon } from \"lucide-react\"\n\nimport {\n Alert,\n AlertAction,\n AlertDescription,\n AlertTitle,\n} from \"@etic-ui/components/ui/alert\"\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n Collapsible,\n CollapsibleContent,\n} from \"@etic-ui/components/ui/collapsible\"\nimport { DisclosureTrigger } from \"@etic-ui/components/etic/disclosure\"\n\nexport interface ErrorBannerProps {\n /**\n * L'erreur à afficher ; rien n'est rendu si elle est absente (`null`,\n * `undefined`, `false`). Lue sans rien connaître de l'application : son\n * `message` (une `Error`, ou tout objet qui en a un, ou une chaîne), son\n * `code` s'il est textuel, et son `details` s'il n'est pas vide.\n */\n erreur: unknown\n /** Remplace le message lu dans l'erreur. */\n titre?: ReactNode\n /** Phrase sous le message : ce que la personne peut faire. */\n description?: ReactNode\n /** Détail technique, replié sous « Détails ». Remplace `details` de l'erreur. */\n detail?: unknown\n /** Affiche « Réessayer », qui appelle cette fonction. */\n onReessayer?: () => void\n /** Nouvelle tentative en cours : « Réessayer » est occupé (roue,\n * `aria-busy`) et ignore les clics, sans perdre le focus. */\n enCours?: boolean\n className?: string\n}\n\n/** Ce qu'un bandeau affiche d'une erreur : son message, son code, son détail\n * technique (replié). */\nexport interface ErreurDecrite {\n message: string\n code?: string\n detail?: unknown\n}\n\n/** Message, code et détail d'une erreur de forme inconnue : son `message`\n * (un repli qui dit quoi faire s'il manque), son `code` s'il est textuel,\n * son `details`. */\nexport function decrireErreur(erreur: unknown): ErreurDecrite {\n if (typeof erreur === \"string\") return { message: erreur }\n if (typeof erreur === \"object\" && erreur !== null) {\n const { message, code, details } = erreur as Record<string, unknown>\n return {\n message:\n typeof message === \"string\" && message\n ? message\n : \"Une erreur s'est produite. Réessayez ; si elle persiste, prévenez l'équipe technique.\",\n code: typeof code === \"string\" && code ? code : undefined,\n detail: details,\n }\n }\n return { message: String(erreur) }\n}\n\ninterface AffichageErreurs {\n masquerCode: boolean\n decrire: (erreur: unknown) => ErreurDecrite\n}\n\nconst ContexteAffichageErreurs = createContext<AffichageErreurs>({\n masquerCode: false,\n decrire: decrireErreur,\n})\n\nexport interface ErrorBannerProviderProps {\n /** N'affiche jamais le code de l'erreur devant son message : le code\n * machine (`not_found`…) ne parle qu'aux développeurs. Faux par défaut. */\n masquerCode?: boolean\n /**\n * Lecture d'une erreur, à la place de `decrireErreur` : règle propre à\n * l'application (un détail à taire pour certaines erreurs…). Repartir de\n * `decrireErreur(erreur)` et n'en changer que ce qu'il faut. Une\n * référence stable, définie au niveau du module. `masquerCode`\n * s'applique au résultat.\n */\n decrire?: (erreur: unknown) => ErreurDecrite\n children: ReactNode\n}\n\n/**\n * Règle l'affichage des erreurs, une fois, autour de l'application : tous\n * les bandeaux de la bibliothèque la suivent (`ErrorBanner`,\n * `QueryErrorBanner`, `QueryBoundary`, le bandeau de `DataTable`, l'erreur\n * de `ConfirmDialog`, de `FormDialog` et de `DraftResumeDialog`). Sans lui,\n * le code s'affiche devant le message.\n */\nexport function ErrorBannerProvider({\n masquerCode = false,\n decrire = decrireErreur,\n children,\n}: ErrorBannerProviderProps) {\n const valeur = useMemo(\n () => ({ masquerCode, decrire }),\n [masquerCode, decrire]\n )\n return (\n <ContexteAffichageErreurs.Provider value={valeur}>\n {children}\n </ContexteAffichageErreurs.Provider>\n )\n}\n\nfunction estVide(detail: unknown) {\n if (detail === null || detail === undefined || detail === \"\") return true\n if (typeof detail === \"object\") return Object.keys(detail).length === 0\n return false\n}\n\n/**\n * Texte d'un détail technique. Ne lève jamais : un objet circulaire ou un\n * `BigInt` ferait planter `JSON.stringify`, et le bandeau d'erreur avec lui.\n */\nexport function texteDuDetail(detail: unknown): string {\n if (typeof detail === \"string\") return detail\n const vus = new WeakSet<object>()\n try {\n return JSON.stringify(\n detail,\n (_cle, valeur: unknown) => {\n if (typeof valeur === \"bigint\") return `${valeur}n`\n if (typeof valeur === \"object\" && valeur !== null) {\n if (vus.has(valeur)) return \"[référence circulaire]\"\n vus.add(valeur)\n }\n return valeur\n },\n 2\n )\n } catch {\n return String(detail)\n }\n}\n\n/** Bloc repliable d'un détail technique, fermé par défaut. */\nexport function DetailTechnique({\n libelle = \"Détails\",\n detail,\n}: {\n libelle?: string\n detail: unknown\n}) {\n return (\n <Collapsible className=\"mt-1\">\n <DisclosureTrigger variante=\"lien\" taille=\"xs\" className=\"text-current\">\n {libelle}\n </DisclosureTrigger>\n <CollapsibleContent>\n <pre className=\"mt-1 max-h-64 overflow-auto rounded-md bg-muted p-2 font-mono text-xs whitespace-pre-wrap text-foreground\">\n {texteDuDetail(detail)}\n </pre>\n </CollapsibleContent>\n </Collapsible>\n )\n}\n\nexport interface BoutonReessayerProps {\n onClick: () => void\n /** Nouvelle tentative en cours : occupé, mais focalisable. */\n enCours?: boolean\n /** `sm` par défaut, comme dans un bandeau ; `default` dans l'en-tête\n * d'une section, à côté de boutons ordinaires. */\n size?: \"sm\" | \"default\"\n}\n\n/** « Réessayer » d'un bandeau ou d'un repli d'erreur, et hors bandeau (une\n * ligne d'état, une phrase) : même allure partout, occupé mais focalisable\n * pendant la nouvelle tentative. */\nexport function BoutonReessayer({\n onClick,\n enCours = false,\n size = \"sm\",\n}: BoutonReessayerProps) {\n return (\n <Button variant=\"outline\" size={size} enCours={enCours} onClick={onClick}>\n <RotateCwIcon data-icon=\"inline-start\" />\n Réessayer\n </Button>\n )\n}\n\n/**\n * Bandeau d'erreur : le message en évidence, le code s'il y en a un (sauf\n * sous un `ErrorBannerProvider` qui le masque), le détail technique replié\n * sous « Détails », et « Réessayer » si l'action peut être relancée. Sur le\n * modèle de l'`Alert` destructive de shadcn.\n */\nexport function ErrorBanner({\n erreur,\n titre,\n description,\n detail,\n onReessayer,\n enCours = false,\n className,\n}: ErrorBannerProps) {\n const { masquerCode, decrire } = useContext(ContexteAffichageErreurs)\n if (erreur === null || erreur === undefined || erreur === false) return null\n const lu = decrire(erreur)\n const code = masquerCode ? undefined : lu.code\n const detailAffiche = detail === undefined ? lu.detail : detail\n\n return (\n <Alert\n variant=\"destructive\"\n className={cn(\n // Colonne du texte bornée (`minmax(0,1fr)` et non `1fr`, dont le\n // minimum est le mot le plus long) : une chaîne sans espace (adresse,\n // identifiant) se coupe au lieu d'élargir la colonne et de passer\n // sous « Réessayer ».\n \"has-[>svg]:grid-cols-[auto_minmax(0,1fr)] *:data-[slot=alert-description]:wrap-break-word *:data-[slot=alert-title]:wrap-break-word\",\n // « Réessayer » (bouton `sm`, 28 px) centré sur la première ligne du\n // titre, 6 px au-dessus et au-dessous : sans quoi, sous un titre d'une\n // ligne, il touche le bas du bandeau.\n onReessayer &&\n \"has-data-[slot=alert-action]:py-2.5 has-data-[slot=alert-action]:pr-32\",\n className\n )}\n >\n <CircleAlertIcon />\n <AlertTitle>\n {titre ?? (\n <>\n {code ? <span className=\"font-mono\">{code}&nbsp;: </span> : null}\n {lu.message}\n </>\n )}\n </AlertTitle>\n {description || !estVide(detailAffiche) ? (\n <AlertDescription>\n {description}\n {!estVide(detailAffiche) ? (\n <DetailTechnique detail={detailAffiche} />\n ) : null}\n </AlertDescription>\n ) : null}\n {onReessayer ? (\n <AlertAction className=\"top-1.5\">\n <BoutonReessayer onClick={onReessayer} enCours={enCours} />\n </AlertAction>\n ) : null}\n </Alert>\n )\n}\n"],"mappings":"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"}
@@ -22,6 +22,15 @@ export interface FormFieldProps extends Omit<ComponentProps<typeof Field>, "chil
22
22
  erreur?: ReactNode | string[];
23
23
  /** Identifiant du contrôle ; généré s'il manque. */
24
24
  id?: string;
25
+ /**
26
+ * Bouton à droite du contrôle, sur sa ligne : d'ordinaire un
27
+ * `ResetButton`, qui lit le champ (nom accessible, focus au clic). Le
28
+ * contrôle prend la place restante de la ligne, dans la limite de sa
29
+ * largeur maximale (`max-w-24`…). À passer toujours, même quand il n'y a rien à rétablir (`masque`) : la
30
+ * ligne qui l'accueille, ajoutée ou retirée pendant la frappe, ferait
31
+ * perdre le focus au contrôle.
32
+ */
33
+ action?: ReactNode;
25
34
  /** Le contrôle (Input, Select…, ou tout composant qui transmet `id` et les
26
35
  * attributs `aria-*` à son élément de saisie). */
27
36
  children: ReactElement<FormFieldControleProps>;
@@ -40,7 +49,7 @@ export interface FormFieldProps extends Omit<ComponentProps<typeof Field>, "chil
40
49
  * (CheckboxList, SegmentedControl) l'ignore aussi et se dit « obligatoire »
41
50
  * dans son nom. Autour d'un `InputGroup`, les attributs vont à son champ.
42
51
  */
43
- export declare function FormField({ libelle, obligatoire, description, erreur, id, children, ...props }: FormFieldProps): import("react").JSX.Element;
52
+ export declare function FormField({ libelle, obligatoire, description, erreur, id, action, children, ...props }: FormFieldProps): import("react").JSX.Element;
44
53
  export interface FormSectionProps extends Omit<ComponentProps<typeof FieldSet>, "title"> {
45
54
  titre?: ReactNode;
46
55
  description?: ReactNode;
@@ -42,48 +42,52 @@ function T(e, t, n) {
42
42
  let r = !1, { children: i } = e.props;
43
43
  return g(e, {}, h.map(i, (e) => r || !_(e) || !C.has(e.type) ? e : (r = !0, g(e, n))));
44
44
  }
45
- function E({ libelle: r, obligatoire: a = !1, description: o, erreur: s, id: l, children: u, ...d }) {
46
- let f = v(), m = u.type === c ? w(u) : void 0, h = m ?? u, g = l ?? h.props.id ?? f, _ = `${g}-libelle`, C = `${g}-description`, E = `${g}-erreur`, D = Array.isArray(s) ? s.filter(Boolean).map((e) => ({ message: e })) : void 0, O = D ? D.length > 0 : !!s, k = [
47
- h.props["aria-describedby"],
48
- o ? C : null,
49
- O ? E : null
50
- ].filter(Boolean).join(" ") || void 0, A = {
51
- id: g,
52
- libelleId: _,
53
- descriptionId: o ? C : void 0,
54
- erreurId: O ? E : void 0,
55
- describedBy: k,
45
+ function E({ libelle: r, obligatoire: a = !1, description: o, erreur: s, id: l, action: u, children: d, ...f }) {
46
+ let m = v(), h = d.type === c ? w(d) : void 0, g = h ?? d, _ = l ?? g.props.id ?? m, C = `${_}-libelle`, E = `${_}-description`, D = `${_}-erreur`, O = Array.isArray(s) ? s.filter(Boolean).map((e) => ({ message: e })) : void 0, k = O ? O.length > 0 : !!s, A = [
47
+ g.props["aria-describedby"],
48
+ o ? E : null,
49
+ k ? D : null
50
+ ].filter(Boolean).join(" ") || void 0, j = {
51
+ id: _,
52
+ libelleId: C,
53
+ descriptionId: o ? E : void 0,
54
+ erreurId: k ? D : void 0,
55
+ describedBy: A,
56
56
  obligatoire: a,
57
- invalide: O
58
- };
57
+ invalide: k
58
+ }, M = T(d, !!h, {
59
+ id: _,
60
+ "aria-describedby": A,
61
+ "aria-invalid": k || g.props["aria-invalid"] || void 0,
62
+ ...a ? S.has(g.type) ? { required: !0 } : { "aria-required": !0 } : {}
63
+ });
59
64
  return /* @__PURE__ */ b(e, {
60
- "data-invalid": O || void 0,
61
- ...d,
65
+ "data-invalid": k || void 0,
66
+ ...f,
62
67
  children: [
63
68
  /* @__PURE__ */ b(i, {
64
- id: _,
65
- htmlFor: g,
69
+ id: C,
70
+ htmlFor: _,
66
71
  children: [r, a ? /* @__PURE__ */ y(x, {}) : null]
67
72
  }),
68
73
  /* @__PURE__ */ y(p.Provider, {
69
- value: A,
70
- children: T(u, !!m, {
71
- id: g,
72
- "aria-describedby": k,
73
- "aria-invalid": O || h.props["aria-invalid"] || void 0,
74
- ...a ? S.has(h.type) ? { required: !0 } : { "aria-required": !0 } : {}
74
+ value: j,
75
+ children: u === void 0 ? M : /* @__PURE__ */ b("div", {
76
+ "data-slot": "form-field-ligne",
77
+ className: "flex min-w-0 items-center gap-1 [&>:first-child]:min-w-0 [&>:first-child]:flex-1",
78
+ children: [M, u]
75
79
  })
76
80
  }),
77
81
  o ? /* @__PURE__ */ y(t, {
78
- id: C,
82
+ id: E,
79
83
  children: o
80
84
  }) : null,
81
- O ? D ? /* @__PURE__ */ y(n, {
82
- id: E,
85
+ k ? O ? /* @__PURE__ */ y(n, {
86
+ id: D,
83
87
  role: void 0,
84
- errors: D
88
+ errors: O
85
89
  }) : /* @__PURE__ */ y(n, {
86
- id: E,
90
+ id: D,
87
91
  role: void 0,
88
92
  children: s
89
93
  }) : null
@@ -1 +1 @@
1
- {"version":3,"file":"form-field.js","names":["RequiredMark","props","cn","className","CHAMPS_NATIFS","Input","Textarea","NativeSelect","InputGroupInput","InputGroupTextarea","CHAMPS_DE_GROUPE","champDuGroupe","groupe","Children","children","isValidElement","enfant","relier","dansGroupe","cloneElement","controle","attributs","fait","FormField","genere","useId","champGroupe","InputGroup","cible","idControle","id","idLibelle","idDescription","idErreur","erreurs","erreur","invalide","decrit","description","contexte","Field","FieldLabel","libelle","obligatoire","FormFieldContext","FieldDescription","FieldError","FormSection","FieldSet","titre","FieldLegend","FieldGroup"],"sources":["../../../src/components/etic/form-field.tsx"],"sourcesContent":["import {\n Children,\n cloneElement,\n isValidElement,\n useId,\n type ComponentProps,\n type ReactElement,\n type ReactNode,\n} from \"react\"\nimport { cn } from \"cn\"\n\nimport {\n Field,\n FieldDescription,\n FieldError,\n FieldGroup,\n FieldLabel,\n FieldLegend,\n FieldSet,\n} from \"@etic-ui/components/ui/field\"\nimport { Input } from \"@etic-ui/components/ui/input\"\nimport {\n InputGroup,\n InputGroupInput,\n InputGroupTextarea,\n} from \"@etic-ui/components/ui/input-group\"\nimport { NativeSelect } from \"@etic-ui/components/ui/native-select\"\nimport { Textarea } from \"@etic-ui/components/ui/textarea\"\nimport {\n FormFieldContext,\n type FormFieldContexte,\n} from \"@etic-ui/components/etic/form-field-context\"\n\n/** Astérisque d'un champ obligatoire, masqué aux lecteurs d'écran : ils\n * annoncent le `required` (ou `aria-required`) du contrôle, que `FormField`\n * pose quand il est `obligatoire`. */\nexport function RequiredMark({ className, ...props }: ComponentProps<\"span\">) {\n return (\n <span\n data-slot=\"required-mark\"\n aria-hidden=\"true\"\n title=\"Champ obligatoire\"\n className={cn(\"text-destructive\", className)}\n {...props}\n >\n *\n </span>\n )\n}\n\n/** Attributs posés sur l'enfant direct par `FormField`. */\nexport interface FormFieldControleProps {\n id?: string\n \"aria-describedby\"?: string\n \"aria-invalid\"?: boolean\n required?: boolean\n \"aria-required\"?: boolean\n}\n\n/** Champs de saisie natifs, ou primitives shadcn qui en rendent un : seuls à\n * recevoir un vrai `required` de `FormField`. */\nconst CHAMPS_NATIFS = new Set<unknown>([\n \"input\",\n \"textarea\",\n \"select\",\n Input,\n Textarea,\n NativeSelect,\n InputGroupInput,\n InputGroupTextarea,\n])\n\n/** Champ de saisie d'un `InputGroup` (suffixe, bouton…) : c'est lui, et non\n * l'enveloppe, que vise le libellé. */\nconst CHAMPS_DE_GROUPE = new Set<unknown>([\n \"input\",\n \"textarea\",\n InputGroupInput,\n InputGroupTextarea,\n])\n\ntype Controle = ReactElement<FormFieldControleProps>\n\nfunction champDuGroupe(groupe: ReactElement): Controle | undefined {\n const { children } = groupe.props as { children?: ReactNode }\n return Children.toArray(children).find(\n (enfant): enfant is Controle =>\n isValidElement(enfant) && CHAMPS_DE_GROUPE.has(enfant.type)\n )\n}\n\n/** Pose `attributs` sur le contrôle ; dans un `InputGroup`, sur son champ. */\nfunction relier(\n controle: Controle,\n dansGroupe: boolean,\n attributs: FormFieldControleProps\n) {\n if (!dansGroupe) return cloneElement(controle, attributs)\n let fait = false\n const { children } = controle.props as { children?: ReactNode }\n return cloneElement(\n controle as ReactElement<{ children?: ReactNode }>,\n {},\n Children.map(children, (enfant) => {\n if (fait || !isValidElement(enfant) || !CHAMPS_DE_GROUPE.has(enfant.type))\n return enfant\n fait = true\n return cloneElement(enfant as Controle, attributs)\n })\n )\n}\n\nexport interface FormFieldProps extends Omit<\n ComponentProps<typeof Field>,\n \"children\"\n> {\n libelle: ReactNode\n /** Affiche l'astérisque et rend le contrôle requis (voir `FormField`). */\n obligatoire?: boolean\n /** Ligne d'aide sous le contrôle. */\n description?: ReactNode\n /** Message d'erreur, ou plusieurs (un par ligne). Rend le champ invalide. */\n erreur?: ReactNode | string[]\n /** Identifiant du contrôle ; généré s'il manque. */\n id?: string\n /** Le contrôle (Input, Select…, ou tout composant qui transmet `id` et les\n * attributs `aria-*` à son élément de saisie). */\n children: ReactElement<FormFieldControleProps>\n}\n\n/**\n * Un champ de formulaire complet : le `Field` de shadcn, avec libellé (et\n * astérisque si obligatoire), contrôle, aide et erreur, reliés par `htmlFor`,\n * `aria-describedby` et `aria-invalid` posés sur le contrôle.\n *\n * Un champ obligatoire rend le contrôle requis. Règle : un champ natif ou une\n * primitive shadcn de saisie (Input, Textarea, NativeSelect, champ\n * d'InputGroup) reçoit `required` ; tout autre enfant reçoit `aria-required`.\n * Un composite (DatePicker, PhoneInput, SearchSelect, ou un composant de\n * l'application) lit `useFormField()` et pose lui-même un vrai `required` sur\n * son élément de saisie, en ignorant ce `aria-required` ; un groupe\n * (CheckboxList, SegmentedControl) l'ignore aussi et se dit « obligatoire »\n * dans son nom. Autour d'un `InputGroup`, les attributs vont à son champ.\n */\nexport function FormField({\n libelle,\n obligatoire = false,\n description,\n erreur,\n id,\n children,\n ...props\n}: FormFieldProps) {\n const genere = useId()\n // Autour d'un InputGroup, le libellé vise son champ de saisie.\n const champGroupe =\n children.type === InputGroup ? champDuGroupe(children) : undefined\n const cible = champGroupe ?? children\n const idControle = id ?? cible.props.id ?? genere\n const idLibelle = `${idControle}-libelle`\n const idDescription = `${idControle}-description`\n const idErreur = `${idControle}-erreur`\n const erreurs = Array.isArray(erreur)\n ? erreur.filter(Boolean).map((message) => ({ message }))\n : undefined\n const invalide = erreurs ? erreurs.length > 0 : Boolean(erreur)\n\n const decrit =\n [\n cible.props[\"aria-describedby\"],\n description ? idDescription : null,\n invalide ? idErreur : null,\n ]\n .filter(Boolean)\n .join(\" \") || undefined\n\n const contexte: FormFieldContexte = {\n id: idControle,\n libelleId: idLibelle,\n descriptionId: description ? idDescription : undefined,\n erreurId: invalide ? idErreur : undefined,\n describedBy: decrit,\n obligatoire,\n invalide,\n }\n\n return (\n <Field data-invalid={invalide || undefined} {...props}>\n <FieldLabel id={idLibelle} htmlFor={idControle}>\n {libelle}\n {obligatoire ? <RequiredMark /> : null}\n </FieldLabel>\n <FormFieldContext.Provider value={contexte}>\n {relier(children, Boolean(champGroupe), {\n id: idControle,\n \"aria-describedby\": decrit,\n \"aria-invalid\": invalide || cible.props[\"aria-invalid\"] || undefined,\n ...(obligatoire\n ? CHAMPS_NATIFS.has(cible.type)\n ? { required: true }\n : { \"aria-required\": true }\n : {}),\n })}\n </FormFieldContext.Provider>\n {description ? (\n <FieldDescription id={idDescription}>{description}</FieldDescription>\n ) : null}\n {/* Pas de `role=\"alert\"` (shadcn) : cinq champs fautifs feraient cinq\n alertes, et une erreur affichée pendant la frappe la couperait.\n L'erreur est dans la description du contrôle. */}\n {invalide ? (\n erreurs ? (\n <FieldError id={idErreur} role={undefined} errors={erreurs} />\n ) : (\n <FieldError id={idErreur} role={undefined}>\n {erreur as ReactNode}\n </FieldError>\n )\n ) : null}\n </Field>\n )\n}\n\nexport interface FormSectionProps extends Omit<\n ComponentProps<typeof FieldSet>,\n \"title\"\n> {\n titre?: ReactNode\n description?: ReactNode\n}\n\n/**\n * Regroupe des champs sous un titre : `FieldSet` et `FieldLegend` de shadcn\n * (un `<fieldset>`, que les lecteurs d'écran annoncent avec son titre), les\n * champs espacés par `FieldGroup`.\n */\nexport function FormSection({\n titre,\n description,\n children,\n ...props\n}: FormSectionProps) {\n return (\n <FieldSet {...props}>\n {titre ? <FieldLegend>{titre}</FieldLegend> : null}\n {description ? <FieldDescription>{description}</FieldDescription> : null}\n <FieldGroup>{children}</FieldGroup>\n </FieldSet>\n )\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"form-field.js","names":["RequiredMark","props","cn","className","CHAMPS_NATIFS","Input","Textarea","NativeSelect","InputGroupInput","InputGroupTextarea","CHAMPS_DE_GROUPE","champDuGroupe","groupe","Children","children","isValidElement","enfant","relier","dansGroupe","cloneElement","controle","attributs","fait","FormField","genere","useId","champGroupe","InputGroup","cible","idControle","id","idLibelle","idDescription","idErreur","erreurs","erreur","invalide","decrit","description","contexte","obligatoire","Field","FieldLabel","libelle","FormFieldContext","action","FieldDescription","FieldError","FormSection","FieldSet","titre","FieldLegend","FieldGroup"],"sources":["../../../src/components/etic/form-field.tsx"],"sourcesContent":["import {\n Children,\n cloneElement,\n isValidElement,\n useId,\n type ComponentProps,\n type ReactElement,\n type ReactNode,\n} from \"react\"\nimport { cn } from \"cn\"\n\nimport {\n Field,\n FieldDescription,\n FieldError,\n FieldGroup,\n FieldLabel,\n FieldLegend,\n FieldSet,\n} from \"@etic-ui/components/ui/field\"\nimport { Input } from \"@etic-ui/components/ui/input\"\nimport {\n InputGroup,\n InputGroupInput,\n InputGroupTextarea,\n} from \"@etic-ui/components/ui/input-group\"\nimport { NativeSelect } from \"@etic-ui/components/ui/native-select\"\nimport { Textarea } from \"@etic-ui/components/ui/textarea\"\nimport {\n FormFieldContext,\n type FormFieldContexte,\n} from \"@etic-ui/components/etic/form-field-context\"\n\n/** Astérisque d'un champ obligatoire, masqué aux lecteurs d'écran : ils\n * annoncent le `required` (ou `aria-required`) du contrôle, que `FormField`\n * pose quand il est `obligatoire`. */\nexport function RequiredMark({ className, ...props }: ComponentProps<\"span\">) {\n return (\n <span\n data-slot=\"required-mark\"\n aria-hidden=\"true\"\n title=\"Champ obligatoire\"\n className={cn(\"text-destructive\", className)}\n {...props}\n >\n *\n </span>\n )\n}\n\n/** Attributs posés sur l'enfant direct par `FormField`. */\nexport interface FormFieldControleProps {\n id?: string\n \"aria-describedby\"?: string\n \"aria-invalid\"?: boolean\n required?: boolean\n \"aria-required\"?: boolean\n}\n\n/** Champs de saisie natifs, ou primitives shadcn qui en rendent un : seuls à\n * recevoir un vrai `required` de `FormField`. */\nconst CHAMPS_NATIFS = new Set<unknown>([\n \"input\",\n \"textarea\",\n \"select\",\n Input,\n Textarea,\n NativeSelect,\n InputGroupInput,\n InputGroupTextarea,\n])\n\n/** Champ de saisie d'un `InputGroup` (suffixe, bouton…) : c'est lui, et non\n * l'enveloppe, que vise le libellé. */\nconst CHAMPS_DE_GROUPE = new Set<unknown>([\n \"input\",\n \"textarea\",\n InputGroupInput,\n InputGroupTextarea,\n])\n\ntype Controle = ReactElement<FormFieldControleProps>\n\nfunction champDuGroupe(groupe: ReactElement): Controle | undefined {\n const { children } = groupe.props as { children?: ReactNode }\n return Children.toArray(children).find(\n (enfant): enfant is Controle =>\n isValidElement(enfant) && CHAMPS_DE_GROUPE.has(enfant.type)\n )\n}\n\n/** Pose `attributs` sur le contrôle ; dans un `InputGroup`, sur son champ. */\nfunction relier(\n controle: Controle,\n dansGroupe: boolean,\n attributs: FormFieldControleProps\n) {\n if (!dansGroupe) return cloneElement(controle, attributs)\n let fait = false\n const { children } = controle.props as { children?: ReactNode }\n return cloneElement(\n controle as ReactElement<{ children?: ReactNode }>,\n {},\n Children.map(children, (enfant) => {\n if (fait || !isValidElement(enfant) || !CHAMPS_DE_GROUPE.has(enfant.type))\n return enfant\n fait = true\n return cloneElement(enfant as Controle, attributs)\n })\n )\n}\n\nexport interface FormFieldProps extends Omit<\n ComponentProps<typeof Field>,\n \"children\"\n> {\n libelle: ReactNode\n /** Affiche l'astérisque et rend le contrôle requis (voir `FormField`). */\n obligatoire?: boolean\n /** Ligne d'aide sous le contrôle. */\n description?: ReactNode\n /** Message d'erreur, ou plusieurs (un par ligne). Rend le champ invalide. */\n erreur?: ReactNode | string[]\n /** Identifiant du contrôle ; généré s'il manque. */\n id?: string\n /**\n * Bouton à droite du contrôle, sur sa ligne : d'ordinaire un\n * `ResetButton`, qui lit le champ (nom accessible, focus au clic). Le\n * contrôle prend la place restante de la ligne, dans la limite de sa\n * largeur maximale (`max-w-24`…). À passer toujours, même quand il n'y a rien à rétablir (`masque`) : la\n * ligne qui l'accueille, ajoutée ou retirée pendant la frappe, ferait\n * perdre le focus au contrôle.\n */\n action?: ReactNode\n /** Le contrôle (Input, Select…, ou tout composant qui transmet `id` et les\n * attributs `aria-*` à son élément de saisie). */\n children: ReactElement<FormFieldControleProps>\n}\n\n/**\n * Un champ de formulaire complet : le `Field` de shadcn, avec libellé (et\n * astérisque si obligatoire), contrôle, aide et erreur, reliés par `htmlFor`,\n * `aria-describedby` et `aria-invalid` posés sur le contrôle.\n *\n * Un champ obligatoire rend le contrôle requis. Règle : un champ natif ou une\n * primitive shadcn de saisie (Input, Textarea, NativeSelect, champ\n * d'InputGroup) reçoit `required` ; tout autre enfant reçoit `aria-required`.\n * Un composite (DatePicker, PhoneInput, SearchSelect, ou un composant de\n * l'application) lit `useFormField()` et pose lui-même un vrai `required` sur\n * son élément de saisie, en ignorant ce `aria-required` ; un groupe\n * (CheckboxList, SegmentedControl) l'ignore aussi et se dit « obligatoire »\n * dans son nom. Autour d'un `InputGroup`, les attributs vont à son champ.\n */\nexport function FormField({\n libelle,\n obligatoire = false,\n description,\n erreur,\n id,\n action,\n children,\n ...props\n}: FormFieldProps) {\n const genere = useId()\n // Autour d'un InputGroup, le libellé vise son champ de saisie.\n const champGroupe =\n children.type === InputGroup ? champDuGroupe(children) : undefined\n const cible = champGroupe ?? children\n const idControle = id ?? cible.props.id ?? genere\n const idLibelle = `${idControle}-libelle`\n const idDescription = `${idControle}-description`\n const idErreur = `${idControle}-erreur`\n const erreurs = Array.isArray(erreur)\n ? erreur.filter(Boolean).map((message) => ({ message }))\n : undefined\n const invalide = erreurs ? erreurs.length > 0 : Boolean(erreur)\n\n const decrit =\n [\n cible.props[\"aria-describedby\"],\n description ? idDescription : null,\n invalide ? idErreur : null,\n ]\n .filter(Boolean)\n .join(\" \") || undefined\n\n const contexte: FormFieldContexte = {\n id: idControle,\n libelleId: idLibelle,\n descriptionId: description ? idDescription : undefined,\n erreurId: invalide ? idErreur : undefined,\n describedBy: decrit,\n obligatoire,\n invalide,\n }\n\n const controle = relier(children, Boolean(champGroupe), {\n id: idControle,\n \"aria-describedby\": decrit,\n \"aria-invalid\": invalide || cible.props[\"aria-invalid\"] || undefined,\n ...(obligatoire\n ? CHAMPS_NATIFS.has(cible.type)\n ? { required: true }\n : { \"aria-required\": true }\n : {}),\n })\n\n return (\n <Field data-invalid={invalide || undefined} {...props}>\n <FieldLabel id={idLibelle} htmlFor={idControle}>\n {libelle}\n {obligatoire ? <RequiredMark /> : null}\n </FieldLabel>\n <FormFieldContext.Provider value={contexte}>\n {action === undefined ? (\n controle\n ) : (\n <div\n data-slot=\"form-field-ligne\"\n // Le contrôle s'étire comme sans action (`*:w-full` du champ).\n className=\"flex min-w-0 items-center gap-1 [&>:first-child]:min-w-0 [&>:first-child]:flex-1\"\n >\n {controle}\n {action}\n </div>\n )}\n </FormFieldContext.Provider>\n {description ? (\n <FieldDescription id={idDescription}>{description}</FieldDescription>\n ) : null}\n {/* Pas de `role=\"alert\"` (shadcn) : cinq champs fautifs feraient cinq\n alertes, et une erreur affichée pendant la frappe la couperait.\n L'erreur est dans la description du contrôle. */}\n {invalide ? (\n erreurs ? (\n <FieldError id={idErreur} role={undefined} errors={erreurs} />\n ) : (\n <FieldError id={idErreur} role={undefined}>\n {erreur as ReactNode}\n </FieldError>\n )\n ) : null}\n </Field>\n )\n}\n\nexport interface FormSectionProps extends Omit<\n ComponentProps<typeof FieldSet>,\n \"title\"\n> {\n titre?: ReactNode\n description?: ReactNode\n}\n\n/**\n * Regroupe des champs sous un titre : `FieldSet` et `FieldLegend` de shadcn\n * (un `<fieldset>`, que les lecteurs d'écran annoncent avec son titre), les\n * champs espacés par `FieldGroup`.\n */\nexport function FormSection({\n titre,\n description,\n children,\n ...props\n}: FormSectionProps) {\n return (\n <FieldSet {...props}>\n {titre ? <FieldLegend>{titre}</FieldLegend> : null}\n {description ? <FieldDescription>{description}</FieldDescription> : null}\n <FieldGroup>{children}</FieldGroup>\n </FieldSet>\n )\n}\n"],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import { ComponentProps, ReactNode } from 'react';
2
+ import { StatusTon } from '../../lib/ton';
3
+ export interface ProgressRingProps extends Omit<ComponentProps<"div">, "children" | "role" | "aria-label"> {
4
+ /** Part remplie, de 0 à 100 (bornée) ; `null` : inconnue, anneau vide. */
5
+ valeur: number | null;
6
+ /** Couleur de l'arc : « warning » au-delà d'un seuil d'alerte,
7
+ * « destructive » quand c'est plein. « neutral » (par défaut) : l'accent. */
8
+ ton?: StatusTon;
9
+ /** Ce que lit un lecteur d'écran, valeur comprise : « Mémoire : 45 % ». */
10
+ libelle: string;
11
+ /** Au centre de l'anneau, le pourcentage en général ; caché aux lecteurs
12
+ * d'écran, que `libelle` renseigne déjà. */
13
+ children?: ReactNode;
14
+ }
15
+ /**
16
+ * Jauge circulaire d'une ressource qui se remplit (mémoire, disque, quota) :
17
+ * un anneau sur piste grise, rempli dans le sens des aiguilles d'une montre
18
+ * depuis midi, et une valeur au centre. Le pendant rond de `Progress`, pour
19
+ * une jauge qui se lit seule ; SVG pur, sans bibliothèque de graphiques.
20
+ * La taille vient de `className` (`size-28` par défaut) ; le texte du centre
21
+ * se règle avec ses propres classes (`text-2xl`, couleur du ton…).
22
+ */
23
+ export declare function ProgressRing({ valeur, ton, libelle, children, className, ...props }: ProgressRingProps): import("react").JSX.Element;