@micheeeeel/yinyangapp 2.0.4 → 2.1.0

package/README.md

@@ -35,6 +35,8 @@ import {
   createYinYangSvgs,  // idem, en lot
   mountYinYang,       // diagramme vivant dans un conteneur de l'hôte → { controller, destroy }
   mapCauseToInternalModel,
+  createRandomCause,  // Cause aléatoire (2–7 composantes, ODD distincts) — graine optionnelle
+  getYasuniCause,     // le Yasuní complet (7 composantes, 20 ODD) au format Cause
   type Cause, type YinYangSvgConfig, type YinYangMountConfig,
 } from "@micheeeeel/yinyangapp";
 ```
@@ -104,6 +106,22 @@ const film = await createYinYangFilmSvgAsync({ data, size: 100, transitionFrames
 - Survol / sélection : remplacer le film par `mountYinYang` (diagramme vivant),
   puis revenir au film.
 
+### Données : Yasuní complet ou Cause aléatoire
+
+```ts
+import { createRandomCause, getYasuniCause } from "@micheeeeel/yinyangapp";
+
+const yasuni = getYasuniCause();                       // identique à la page standalone
+const pin = createRandomCause({ seed: mission.id, id: mission.id }); // stable par graine
+```
+
+`createRandomCause` tire 2 à 7 composantes (orientations alternées), 1 à 3 ODD
+par composante — **distincts dans toute la Cause**, donc couleurs officielles
+jamais répétées — et 1 à 4 facettes par ODD (score ∈ [0.15, 0.85], poids 1–3).
+Toutes les plages sont surchargeables (`components`, `oddsPerComponent`,
+`cuttingsPerOdd`, `score`, `weight`). Même `seed` ⇒ même Cause ; sans graine,
+`Math.random`. Ne touche pas au DOM (utilisable en SSR).
+
 Guide d'intégration détaillé (React + Mapbox, cache, survol) : [docs/integration-yvy-frontend.md](docs/integration-yvy-frontend.md).
 
 ## Développement