@micheeeeel/yinyangapp 3.0.0 → 3.0.1

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

@@ -6,6 +6,9 @@ import { type ContactProfileData } from "../data/contacts";
  * Cause attendu par 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.
+ * Poids d'une facette (taille de son arc) : C_f, moyenne des poids de TOUS
+ * ses satellites, catégories confondues, zéros inclus (`meanWeight`) — même
+ * règle pour une cause et pour un contact (POC-05A4).
  */
 export declare function composantesToCause(composantes: Composante[], id?: string, name?: string): Cause;
 /** La `Cause` du Yasuní, fraîchement construite à chaque appel (l'hôte peut

package/dist/types/components/controller/actions/ActionProjectionService.d.ts

@@ -98,5 +98,9 @@ export declare function projectGhostStateForComponent(params: {
     sourceCuttingIndex: number;
     actionDelta: number;
 }): GhostProjectionResult | null;
+/** Tension projetée de la facette : même règle que sa tension courante
+ *  (`facetTensionFromOdds`, moyenne pondérée sur tous ses satellites), sur
+ *  les tensions projetées de chaque satellite. */
+export declare function projectedComponentTension(component: YinYangInternalModel["components"][number], projectedCuttingStatesByOddId: ReadonlyMap<string, readonly ProjectedCuttingState[]>): number;
 export declare function getOriginalComponentTension(component: YinYangInternalModel["components"][number] | undefined): number | null;
 export declare function getOriginalOddTension(component: YinYangInternalModel["components"][number] | undefined, oddId: string): number | null;

package/dist/types/components/view/ViewInitializer.d.ts

@@ -305,20 +305,16 @@ export declare class ViewInitializer {
      */
     getAverageTension(): number;
     getAverageState(): number;
-    /** Poids agrégé de la facette courante : somme des poids de tous ses ODD
-     *  (même formule que getOddWeight, celle qui fixe la taille de chaque
-     *  arc — le chiffre affiché au centre du cercle explique donc la somme
-     *  des arcs qui l'entourent). */
+    /** Poids C_f de la facette courante : moyenne des poids de tous ses
+     *  satellites (`meanWeight`, même règle que `perimeterWeight`, qui fixe la
+     *  taille de son arc de bordure). */
     getFacetteWeight(): number;
-    /** Plafond du poids agrégé : WEIGHT_MAX par satellite, tous ODD confondus
-     *  (même règle que le plafond par-ODD affiché sur les arcs, voir
-     *  buildOddArcLabelLines dans YinYangDrawer). */
+    /** Plafond du poids C_f : WEIGHT_MAX, quel que soit le nombre de
+     *  satellites. */
     getFacetteWeightMax(): number;
     /** getFacetteWeight pour une facette quelconque (poids de chaque arc de
      *  bordure quand "Afficher libellés" est actif). */
     getComponentWeight(component: YinYangComponentNode | null | undefined): number;
-    /** getFacetteWeightMax pour une facette quelconque. */
-    getComponentWeightMax(component: YinYangComponentNode | null | undefined): number;
     getCurrentComponentIndex(): number;
     getCurrentComponentName(): string;
     getCurrentComponentOrientation(): "yin" | "yang";
@@ -414,6 +410,10 @@ export declare class ViewInitializer {
     private getAnimationCurrentState;
     private getComponentAnimationState;
     private buildOddCategories;
+    /** Part d'une catégorie DANS sa facette (angle de son arc au cercle
+     *  central) : somme des poids de ses satellites — chaque satellite compte
+     *  une fois, comme dans Q_f. Sa pastille, elle, affiche la moyenne
+     *  (`facetWeightLabel`). */
     private getOddWeight;
     private buildCategoriesFromComponent;
     /**
@@ -483,6 +483,8 @@ export declare class ViewInitializer {
     private buildOddSpikes;
     private buildComponentSpikes;
     private buildSpike;
+    /** Tension de la facette : moyenne pondérée sur tous ses satellites,
+     *  repli sur leur moyenne simple (`facetTensionFromOdds`, POC-05A4). */
     private calculateAverageTension;
     private getCurrentComponent;
     handleSparkAngleUpdate(currentAngle: number, previousAngle: number | null): void;

package/dist/types/components/view/YinYangDrawer.d.ts

@@ -304,11 +304,11 @@ export declare class YinYangDrawer {
      */
     private renderFacetteStateLabel;
     /**
-     * Affiche le poids d'une facette ("18/40") DANS son arc de bordure
+     * Affiche le poids d'une facette (« 6,8 ») DANS son arc de bordure
      * (segment de BorderDrawer), et non dans un lobe : ce poids est celui qui
-     * dimensionne l'arc, il se lit donc sur lui. Le poids et son plafond sont
-     * la somme des poids de tous les ODD de la facette (voir
-     * ViewInitializer.getComponentWeight/getComponentWeightMax).
+     * dimensionne l'arc, il se lit donc sur lui. C'est C_f, la moyenne des
+     * poids de tous ses satellites (`facetWeightLabel`), sur 10 avec le
+     * suffixe.
      *
      * Par défaut seule la facette active porte son poids (et seulement quand
      * ses libellés sont visibles, voir shouldShowFacetteLabels) ; avec
@@ -475,12 +475,9 @@ export declare class YinYangDrawer {
      * (renderChildStateLabel/renderChildWeightLabel), donc le cercle central
      * et son cortège se lisent enfin de la même façon.
      *
-     * Le maximum du poids n'est PAS WEIGHT_MAX : un ODD pèse la somme des
-     * poids de ses satellites (même formule que ViewInitializer.getOddWeight,
-     * celle qui fixe l'angle de l'arc — le chiffre affiché explique donc la
-     * taille de l'arc sous lui), et son plafond est WEIGHT_MAX × nombre de
-     * satellites. Il est affiché tel quel plutôt que ramené à une échelle /10
-     * qui n'existe qu'au niveau satellite.
+     * Le poids d'un ODD est la moyenne des poids de ses seuls satellites
+     * (`facetWeightLabel`, « 6,8 »), sur WEIGHT_MAX avec le suffixe — même
+     * lecture que la pastille de sa facette (POC-05A4).
      *
      * En mode non compact, le nom court de l'ODD reste affiché au-dessus des
      * deux métriques : c'est une information que le numéro ne portait pas.

package/dist/types/interfaces/ICauseModel.d.ts

@@ -23,7 +23,9 @@ export interface CauseComponent {
     description?: string;
     orientation: YinYangOrientation;
     odds: CauseOdd[];
-    /** Somme brute des poids de tous les satellites de la facette. */
+    /** Poids de la facette (taille relative de son arc) : C_f, moyenne des
+     *  poids de TOUS ses satellites, zéros inclus, de 0 à 10 — même règle pour
+     *  une cause et pour un contact (`meanWeight`, POC-05A4). */
     perimeterWeight: number;
 }
 export interface Cause {

package/dist/types/utils/causeMetrics.d.ts

@@ -5,9 +5,40 @@ export declare function clampScore(value: number): number;
  * Canonical domain metric in [0, 1]. Weighted by each satellite's `weight`
  * when provided, so a heavier satellite pulls the tension further toward
  * its own score; falls back to a simple average otherwise.
+ *
+ * ⚠️ FACETTES D'UN CONTACT : cette règle est reproduite à l'identique par
+ * yvy-backend (`src/contacts/contact-facets.ts`), qui fait autorité pour le
+ * jeu. Deux implémentations à maintenir identiques : toute évolution met à
+ * jour les deux, ainsi que le fichier de cas commun
+ * `src/data/contacts/contact-facets.reference.json` (POC-05A2).
  */
 export declare function tensionFromCuttings(cuttingScores: number[], cuttingWeights?: number[]): number;
 export declare const oddTensionFromCuttings: typeof tensionFromCuttings;
+/** Satellites d'une catégorie (ODD) d'une facette : tensions et poids. */
+interface FacetOddCuttings {
+    cuttingScores: readonly number[];
+    cuttingWeights: readonly number[];
+}
+/**
+ * Tension d'une FACETTE (cause ou contact, POC-05A4) : `tensionFromCuttings`
+ * sur TOUS ses satellites, catégories confondues — moyenne pondérée par les
+ * poids, ou moyenne simple de la facette si tous ses poids sont nuls (pas de
+ * repli par catégorie). Q_f = (1 − T) × 100. `cuttingTensions` remplace les
+ * tensions de la catégorie d'indice donné (projection d'une action) ; une catégorie dont
+ * les poids ne sont pas alignés sur les scores compte ses satellites à 1.
+ * Facette sans satellite : 0,5.
+ */
+export declare function facetTensionFromOdds(odds: readonly FacetOddCuttings[], cuttingTensions?: (oddIndex: number) => readonly number[] | undefined): number;
+/**
+ * POIDS C_f d'une facette — ou d'une catégorie, pour sa pastille — (causes
+ * et contacts, POC-05A4) : moyenne arithmétique des poids (bornés à 0) de
+ * TOUS ses satellites, zéros inclus, de 0 à 10, indépendante de leur nombre.
+ * Fixe la taille des arcs de facette et la valeur des pastilles. Facettes
+ * d'un contact : reproduite à l'identique par yvy-backend
+ * (`contactFacetWeights`), cas communs dans
+ * `src/data/contacts/contact-facets.reference.json`.
+ */
+export declare function meanWeight(weights: readonly number[]): number;
 export declare function stateFromTension(tension: number): number;
 /** Bornes du poids d'un satellite (importance dans sa facette). Un satellite
  *  vaut 1 par défaut ; les actions le font varier par pas entiers, mais ne
@@ -24,3 +55,4 @@ export declare function clampWeight(value: number): number;
  * signe — ex: +1 sur un satellite déjà à WEIGHT_MAX ne change rien.
  */
 export declare function effectiveWeightDelta(currentWeight: number, delta: number): number;
+export {};

package/dist/types/utils/facetWeightLabel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Libellé de la pastille de poids d'une facette ou d'une catégorie (ODD),
+ * pour une cause comme pour un contact (POC-05A4) : C_f, moyenne des poids
+ * de tous ses satellites (`meanWeight`), arrondie à un chiffre après la
+ * virgule, avec une virgule décimale — « 7,2 ». `max` (WEIGHT_MAX, 10) ne
+ * s'affiche qu'avec le suffixe (`facetteLabelSuffixVisible`).
+ */
+export declare function facetWeightLabel(weights: readonly number[]): {
+    value: string;
+    max: number;
+};

package/package.json

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