@micheeeeel/yinyangapp 2.0.5 → 2.1.0

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-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.0",
   "description": "A program to visualize human activity balance to reach Sustainable Development Objectives",
   "main": "dist/bundle.js",
   "types": "dist/types/main.d.ts",