@micheeeeel/yinyangapp 2.0.5 → 2.1.1

package/dist/types/adapters/yasuniCauseAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { Composante } from "../data/yasuni_cause";
+import type { Cause } from "../interfaces/ICauseModel";
+/**
+ * Adapte le catalogue Composante[] (format yasuni_cause.ts) vers le format
+ * Cause attendu par validateCauseGraph et mapCauseToInternalModel.
+ * Les scores initiaux sont neutres (0.5 = 50 % de tension), les poids valent 1
+ * par satellite tant qu'aucune valeur n'est renseignée dans les données.
+ */
+export declare function composantesToCause(composantes: Composante[], id?: string, name?: string): Cause;
+/** La `Cause` du Yasuní, fraîchement construite à chaque appel (l'hôte peut
+ *  la muter sans effet de bord). `id` par défaut : "yasuni". */
+export declare function getYasuniCause(id?: string): Cause;

package/dist/types/api-film.d.ts

@@ -17,6 +17,18 @@ export interface YinYangFilmConfig {
     };
     /** Retire les <text> (titres) — inutiles à petite taille. Défaut : true. */
     stripText?: boolean;
+    /** Retire les pointes (spikes : une <line> + un dégradé par découpe d'ODD,
+     *  dans chaque calque) — invisibles à la taille d'un marker et coûteuses
+     *  (Yasuní : ≈ 40 % du poids du film). Ne reste que l'essentiel : lobes
+     *  yin/yang avec leurs arcs d'ODD, et anneau des facettes. Défaut : true. */
+    stripSpikes?: boolean;
+    /** Rotation des lobes yin/yang (même cinématique que la rotation de la lib :
+     *  orbite des deux lobes autour du centre, chacun tournant sur lui-même),
+     *  cuite en CSS pur. Durée d'un tour en ms ; absent ou 0 = pas de rotation
+     *  (défaut). Surchargeable sans recuire via la variable CSS
+     *  `--yy-yinyang-rotation` sur le <svg> (ex. "12s"). Pas de rampe, pas de
+     *  retour à la position de base : rotation continue, uniforme. */
+    yinYangRotationMs?: number;
     /** Met en avant le segment de bordure de la composante courante (comme un
      *  clic sur la facette). Défaut : true. `false` = bordure neutre unique,
      *  sans calque de bordure par composante (film plus léger). */

package/dist/types/api-random.d.ts

@@ -0,0 +1,32 @@
+import type { Cause } from "./interfaces/ICauseModel";
+/** Intervalle inclusif [min, max]. */
+export type RandomRange = [min: number, max: number];
+export interface RandomCauseOptions {
+    /** Identifiant de la Cause produite (ex. id de la mission). Défaut : dérivé
+     *  de la graine, sinon "random-<n>". */
+    id?: string;
+    name?: string;
+    /** Graine : même graine ⇒ même Cause. Sans graine, tirage Math.random. */
+    seed?: string | number;
+    /** Nombre de composantes (arcs de facette). Défaut : [2, 7]. */
+    components?: RandomRange;
+    /** ODD par composante, tirés sans remise parmi les 17 (jamais deux fois le
+     *  même ODD dans une Cause, donc jamais deux fois la même couleur).
+     *  Défaut : [1, 3] — plafonné par les ODD restants. */
+    oddsPerComponent?: RandomRange;
+    /** Facettes (satellites) par ODD. Défaut : [1, 4]. */
+    cuttingsPerOdd?: RandomRange;
+    /** Score de chaque facette. Défaut : [0.15, 0.85]. */
+    score?: RandomRange;
+    /** Poids entier de chaque facette. Défaut : [1, 3]. */
+    weight?: RandomRange;
+}
+/**
+ * Construit une `Cause` aléatoire : 2 à 7 composantes (orientations yin/yang
+ * alternées), chacune avec des ODD distincts tirés parmi les 17 — la couleur
+ * de chaque arc est donc celle de l'ODD officiel — et un nombre aléatoire de
+ * facettes par ODD (scores et poids aléatoires).
+ *
+ * À passer telle quelle à `createYinYangFilmSvg`, `mountYinYang`, etc.
+ */
+export declare function createRandomCause(options?: RandomCauseOptions): Cause;

package/dist/types/api-random.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/api.d.ts

@@ -46,3 +46,6 @@ export declare function createYinYangSvg(config: YinYangSvgConfig): SVGSVGElemen
 export declare function createYinYangSvgs(configs: YinYangSvgConfig[]): (SVGSVGElement | null)[];
 export { createYinYangFilmSvg, createYinYangFilmSvgAsync } from "./api-film";
 export type { YinYangFilmConfig, YinYangFilmAsyncOptions } from "./api-film";
+export { createRandomCause } from "./api-random";
+export type { RandomCauseOptions, RandomRange } from "./api-random";
+export { getYasuniCause } from "./adapters/yasuniCauseAdapter";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micheeeeel/yinyangapp",
-  "version": "2.0.5",
+  "version": "2.1.1",
   "description": "A program to visualize human activity balance to reach Sustainable Development Objectives",
   "main": "dist/bundle.js",
   "types": "dist/types/main.d.ts",