@micheeeeel/yinyangapp 2.0.5 → 2.1.1

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";
 ```
@@ -88,6 +90,19 @@ new mapboxgl.Marker({ element: film }).setLngLat([lng, lat]).addTo(map);
 
 - `highlightActiveSegment: false` : bordure neutre unique (pas de mise en avant du
   segment de la composante courante), film un peu plus léger.
+- `stripSpikes` (défaut `true`) : les pointes (une `<line>` + un dégradé par découpe
+  d'ODD, dans chaque calque) sont retirées — invisibles à la taille d'un marker et
+  lourdes (Yasuní : 492 → 254 Ko, dégradés 484 → 25). Le film ne garde que
+  l'essentiel : lobes yin/yang avec leurs arcs d'ODD, yeux, anneau des facettes.
+  `stripSpikes: false` pour les conserver.
+- `yinYangRotationMs` (défaut : pas de rotation) : rotation des lobes yin/yang cuite
+  en CSS pur — même cinématique que la rotation de la lib (orbite des deux lobes
+  autour du centre, rotation propre de chacun, demi-disque entraîné), continue et
+  uniforme, sans rampe ni retour à la position de base. Durée d'un tour en ms,
+  surchargeable sans recuire par la variable CSS `--yy-yinyang-rotation` sur le
+  `<svg>` (ex. `film.style.setProperty("--yy-yinyang-rotation", "12s")`), comme
+  `--yy-rotation` pour l'étincelle. Coût : un groupe orbital animé + un groupe de
+  rotation propre par lobe et par calque (film Yasuní ≈ +3 %).
 - Cuire **une fois par lieu** (≈ 50 ms à `transitionFrames: 0`, ≈ 150 ms à 4) et
   cloner : `film.cloneNode(true)`.
 - Sur une page qui anime en continu (carte), préférer **`createYinYangFilmSvgAsync`**
@@ -104,6 +119,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