@nomosui/react 0.4.1 → 0.5.0

package/README.md

@@ -58,7 +58,8 @@ npm run smoke:consumer    # installs the tarball in a fresh project and exercise
 
 The structural decisions live in `docs/adr/`. Start with 0002 (app-agnostic core), 0003 (the
 theme interface), 0004 (`tokens.json` as the single source), 0005 (the catalogue manifest),
-0017 (the name), 0024 (the public surface) and 0026 (Nomos goes public).
+0017 (the name), 0024 (the public surface), 0026 (Nomos goes public) and 0027 (overlay:
+layer, scrim and motion as tokens).
 
 ## License
 

package/SKILL.md

@@ -28,6 +28,11 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
   `onValueChange`, sinon un affichage.
 - **Lister des événements datés** → `Timeline` (frise, présentation seule ; le format de
   la date vient de l'app).
+- **Nommer un contrôle iconique, glisser une aide courte** → `Tooltip` en famille (un
+  `TooltipProvider` autour de plusieurs, `Tooltip`, `TooltipTrigger`, `TooltipContent`).
+  Jamais pour une information essentielle : elle n'est ni au clavier seul ni au tactile.
+- **Représenter une personne par son image** → `Avatar` (le texte alternatif et le repli
+  viennent de l'app ; natif `<img>` + `onError`, sans dépendance).
 
 ### Agir, saisir
 
@@ -40,6 +45,9 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
   **choisir une seule option parmi quelques-unes** → `RadioGroup` ; **une bascule
   ponctuelle** (mode, filtre) → `Toggle`, **un segment** → `ToggleGroup`. Tous sont
   contrôlés par props : l'état reste dans l'app.
+- **Choisir une valeur unique parmi une liste d'options** → `Select` en parts
+  (`SelectTrigger`, `SelectValue`, `SelectContent`, `SelectItem` ; les libellés et les
+  valeurs viennent de l'app). Pour des actions, c'est un `DropdownMenu`.
 
 ### Structurer
 
@@ -50,8 +58,30 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
   du cœur ; `onClose` va avec `closeLabel`).
 - **Séparer deux contenus** → `Separator` ; **tenir la place d'un contenu qui charge** →
   `Skeleton`.
+- **Un contenu riche ou interactif dans une surface flottante au clic** → `Popover`
+  (`PopoverTrigger`, `PopoverContent`, `PopoverAnchor` pour s'ancrer ailleurs). Pour un
+  texte court au survol, c'est une `Tooltip`.
+- **Révéler un détail à la demande** → `Collapsible` (`CollapsibleTrigger`,
+  `CollapsibleContent`) ; **des sections repliables, une à la fois** → `Accordion`
+  (`AccordionItem`, `AccordionTrigger`, `AccordionContent`, `type` single/multiple).
+- **Basculer entre des vues sœurs** → `Tabs` (`TabsList`, `TabsTrigger`, `TabsContent`) ;
+  **borner une sous-vue dense dans une hauteur fixe** → `ScrollArea` (purement cosmétique,
+  le défilement reste natif).
 - **Prévenir sans bloquer** → `Toast` via `useToast().show({ message })` (la file et
   l'auto-dismiss vivent dans `ToastProvider`).
+- **Regrouper des actions derrière un déclencheur compact** → `DropdownMenu` en parts
+  (`DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem`, à cocher, radio,
+  sous-menu ; les libellés et les actions viennent de l'app). Pour choisir une valeur de
+  formulaire, c'est un `Select`.
+- **Demander une décision dans une modale centrée** → `Dialog` (déclencheur, titre,
+  description, corps, pied ; le libellé de fermeture vient de l'app). L'empilement, le
+  voile et le mouvement viennent des tokens, jamais d'une valeur en dur.
+- **Confirmer une action destructive** → `AlertDialog` (`AlertDialogTrigger`,
+  `AlertDialogContent`, `AlertDialogAction`, `AlertDialogCancel` ; deux issues
+  explicites). Il ne se ferme pas au clic hors surface.
+- **Montrer un contenu ancré à un bord** → `Sheet` en parts (`SheetTrigger`, `SheetContent`
+  avec `side`, `SheetHeader`, `SheetFooter`) ; `side="bottom"` est le **drawer** — le même
+  panneau, un côté différent, pas un atome à part.
 - **Parcourir une hiérarchie** → `Tree` (navigation, un nœud actif) ou `SelectionTree`
   (sélection multiple) ; ouverture et sélection sont contrôlées par props, le focus
   clavier (rôle `tree`, flèches) est interne.
@@ -93,15 +123,21 @@ brique ajoutée au catalogue sans être ici fait rougir, et une ligne qui n'exis
 aussi.
 
 <!-- inventaire : début — tenu par src/mcp/skill.test.ts -->
+accordion
 alert
+alert-dialog
+avatar
 badge
 button
 card
 checkbox
 chip
+collapsible
 counter
 data-table-pagination
 data-table-toolbar
+dialog
+dropdown-menu
 empty-state
 facet-filter
 field
@@ -112,19 +148,25 @@ input
 label
 meter
 number-field
+popover
 progress-bar
 radio
 rating
+scroll-area
 search-field
+select
 separator
+sheet
 skeleton
 switch
 table
+tabs
 textarea
 timeline
 toast
 toggle
 toggle-group
+tooltip
 tree
 <!-- inventaire : fin -->