@nomosui/react 0.6.0 → 0.8.0

package/SKILL.md

@@ -27,7 +27,8 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
 - **Recueillir ou montrer une note** → `Rating` : interactif seulement si l'app fournit
   `onValueChange`, sinon un affichage.
 - **Lister des événements datés** → `Timeline` (frise, présentation seule ; le format de
-  la date vient de l'app).
+  la date vient de l'app). Un point porte un état — `done` (défaut) ou `past` (grisé) —
+  et un `past` exige un `stateLabel` fourni par l'app : la couleur seule ne suffit pas.
 - **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.
@@ -116,7 +117,9 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
 - **Un emplacement de champ** (libellé, contrôle, aide ou erreur) → `Field` ; **nommer un
   contrôle seul** → `Label` (`htmlFor`) ; **regrouper des champs apparentés** →
   `Fieldset` (`legend` fourni par l'app). Le message d'erreur est injecté, jamais calculé
-  par le cœur.
+  par le cœur. Le `Field` associe lui-même le contrôle à son message (`aria-invalid`,
+  `aria-describedby`) pour les contrôles du cœur : `Input`, `Textarea`, `NumberField`,
+  `SearchField` et le déclencheur de `Select`.
 
 ### Tables
 
@@ -129,6 +132,23 @@ pour expliquer une brique, elle appartient à l'app, pas au cœur.
   feature `FacetedDataTable` : elle possède le comportement et le **placement** du détail
   (surcouche `overlay` ou dépli `inline`), l'app fournit le contenu et les `labels`.
 
+### Conversation
+
+- **Brancher une conversation** → la feature `useChatThread({ transport, initialMessages })` :
+  elle possède la **machine à états** — ajout optimiste du tour, assemblage des deltas,
+  `send`, `stop`, `retry`/`regenerate`, `replace`, erreur — et **rien du transport**
+  (ADR 0032). L'app injecte un `ChatTransport` (une fonction `send`) : le cœur n'appelle
+  aucun modèle, ne connaît aucun endpoint, n'affiche aucune erreur réseau (ADR 0018). Un
+  message porte un rôle et des **parts** (`text`, `reasoning`, `tool`, `data`) : un signal
+  structuré est une part de premier ordre, jamais un sentinelle pêché dans la prose.
+- **La fenêtre du fil** → `Conversation` : une région `log` vivante ancrée en bas, le
+  défilement tenu par le cœur, la hauteur par l'app. **Un message** → `Message` : le
+  placement et le ton du rôle, le contenu en `parts`, et `renderPart` pour que l'app
+  garde markdown, coloration et artefact métier. **La saisie** → `Composer` : contrôlé par
+  props (`value` + `onChange`), `Entrée` envoie, `Maj+Entrée` coupe la ligne, garde IME ;
+  `busy` + `onStop` pour interrompre. **Attendre la réponse** → `TypingIndicator` (libellé
+  injecté, région `status`).
+
 ### Tons et tokens
 
 - **Un ton de statut** → `toneClasses` (`neutral`, `info`, `progress`, `attention`,
@@ -158,6 +178,8 @@ chip
 code
 code-block
 collapsible
+composer
+conversation
 copy-button
 counter
 data-table-pagination
@@ -177,6 +199,7 @@ kicker
 label
 link
 meter
+message
 navbar
 number-field
 popover
@@ -200,6 +223,7 @@ toggle
 toggle-group
 tooltip
 tree
+typing-indicator
 <!-- inventaire : fin -->
 
 ## Interroger le catalogue
@@ -225,7 +249,10 @@ aplati par mode) et `nomos://component/<nom>` (le manifeste).
 Au-delà du manifeste, chaque brique a une **vue** servie en `ui://nomos/<nom>` — un
 document auto-suffisant (`text/html;profile=mcp-app`) que l'hôte rend dans un iframe
 sandboxé. Une **scène composite** (`ui://nomos/composite/<nom>`) assemble plusieurs
-briques en un écran qui a du sens (un formulaire, une carte de statut).
+briques en un écran qui a du sens (un formulaire, une carte de statut). Les scènes
+sont aussi exportées sur la surface publique JS (`composites`, `compositeNames`,
+`findComposite`, ADR 0031) : le serveur MCP et le site rendent la **même** source,
+et leur copie par défaut est neutre — elle s'injecte par props.
 
 La vue **émet des intentions** (`ready`, `select`, `change`, `error`) et ne mute jamais
 l'état : l'hôte décide. Il lui pousse l'apparence (`set-view` : thème, densité) et les