@tricoteuses/tisseuse 0.21.2 → 0.22.1

package/README.md

@@ -25,6 +25,24 @@ la liste `referenceParsingModes` sont exportés par le point d’entrée public.
 
 Voir le [contrat et les limites de validation](../../fonctionnalités/references-autonomes-tisseuse-moulineuse.md).
 
+## Avertissements et décisions de résolution
+
+`addLinksToHtml` peut signaler, dans le HTML produit, une référence indécidable
+(ancre sans `href`, `class="reference_article_indecidable"` ou
+`reference_texte_indecidable`) ou une consultation avertie (`data-tisseuse-warning`,
+`data-tisseuse-candidates`). Ces attributs sont déjà présents sans option ; les
+applications doivent les valider avec `@tricoteuses/tisseuse/link-decision-metadata`
+avant de les rendre interactifs.
+
+Pour obtenir les décisions structurées (statut, candidats, motifs, avertissements),
+fournir `linkDecisionDocumentId` ; la sortie expose alors `linkDecisions`. L’option
+`renderLinkDecisions` va plus loin et rend la décision dans chaque lien externe.
+Sans identifiant de document, aucune décision structurée n’est renvoyée.
+
+**Le Markdown ne transporte ni attributs ni avertissements** : `addLinksToMarkdown`
+ne modifie pas son rendu pour signaler une incertitude. Un consommateur qui a besoin
+de ces informations doit utiliser la sortie HTML ou demander les décisions.
+
 ## Installation
 
 ### Create database