@micheeeeel/yinyangapp 2.6.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
@@ -25,27 +28,3 @@ export declare function getYasuniCause(id?: string): Cause;
  * bornes (`validateContactProfile`).
  */
 export declare function contactProfileToCause(profile: ContactProfileData, id?: string): Cause;
-/**
- * La `Cause` d'un contact EMBARQUÉ dans la lib, fraîchement construite à
- * chaque appel. `id` par défaut : l'id du contact. Lève une erreur si le
- * contact est inconnu (voir `listContacts`).
- *
- * @deprecated Les profils embarqués sont des fixtures gelées de la page
- * standalone ; une app hôte fournit ses profils à `contactProfileToCause`.
- * Retrait prévu en 3.0.0.
- */
-export declare function getContactCause(contactId: string, id?: string): Cause;
-export interface ContactSummary {
-    id: string;
-    name: string;
-    role: string;
-    organisation: string;
-    provisional: boolean;
-}
-/**
- * Les contacts EMBARQUÉS, dans l'ordre de la calibration Notion.
- *
- * @deprecated Fixtures gelées de la page standalone ; la liste des contacts
- * d'une app hôte vient de sa propre source. Retrait prévu en 3.0.0.
- */
-export declare function listContacts(): ContactSummary[];

package/dist/types/api.d.ts

@@ -58,8 +58,7 @@ 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, getContactCause, listContacts, contactProfileToCause, } from "./adapters/yasuniCauseAdapter";
-export type { ContactSummary } from "./adapters/yasuniCauseAdapter";
+export { getYasuniCause, contactProfileToCause } from "./adapters/yasuniCauseAdapter";
 export { validateContactProfile } from "./data/contacts/buildContactSphere";
 export type { ContactProfileData, ContactSatelliteValue, } from "./data/contacts/buildContactSphere";
 export { UNIVERSAL_FACETS, CONTACT_CATEGORIES } from "./data/contacts/universalFacets";

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/data/activeDiagram.d.ts

@@ -26,7 +26,7 @@ export interface DiagramOption {
     label: string;
 }
 export interface DiagramEnvironment {
-    /** `location.search` de la page (ex. "?diagram=etawane"). */
+    /** `location.search` de la page (ex. "?diagram=demo_contact"). */
     search: string | null | undefined;
     /** Page standalone de la lib (seule à honorer le paramètre d'URL). */
     standalone: boolean;
@@ -42,7 +42,8 @@ export declare function detectDiagramEnvironment(): DiagramEnvironment;
 /** Données d'un diagramme : les catalogues Yasuní tels quels, ou une sphère
  *  de contact (pas d'actions, d'événements, de graphe ni de propagation). */
 export declare function buildDiagramData(id: string): DiagramData;
-/** Options du sélecteur de diagramme : le Yasuní puis les contacts. */
+/** Options du sélecteur de diagramme : le Yasuní puis le contact de
+ *  démonstration. */
 export declare function listDiagramOptions(): DiagramOption[];
 /** URL de la page courante pointant sur `diagramId` (les autres paramètres
  *  sont conservés ; le Yasuní, diagramme par défaut, retire le paramètre). */

package/dist/types/data/contacts/buildContactSphere.d.ts

@@ -23,12 +23,6 @@ export interface ContactProfileData {
     /** Une valeur par satellite de la grille universelle, ni plus ni moins. */
     values: Record<SatelliteKey, ContactSatelliteValue>;
 }
-/** Profil EMBARQUÉ (fixtures `profiles/<id>.ts`, page standalone et
- *  `getContactCause` dépréciée) : identité complète de la calibration. */
-export interface ContactProfile extends ContactProfileData {
-    role: string;
-    organisation: string;
-}
 /**
  * Vérifie un profil reçu de l'hôte AVANT de construire sa sphère : une clé
  * de satellite manquante ou inconnue, un score ou un poids non fini ou hors
@@ -42,5 +36,3 @@ export declare function validateContactProfile(profile: ContactProfileData): voi
  */
 export declare function qualityPercentToTension(percent: number): number;
 export declare function buildContactSphere(profile: ContactProfileData): Sphere;
-/** Valeurs identiques pour les 38 satellites — gabarit de profil non calibré. */
-export declare function uniformContactValues(score: number, weight: number): Record<SatelliteKey, ContactSatelliteValue>;

package/dist/types/data/contacts/demoContact.d.ts

@@ -0,0 +1,3 @@
+import type { ContactProfileData } from "./buildContactSphere";
+export declare const DEMO_CONTACT_ID = "demo_contact";
+export declare const demoContactProfile: ContactProfileData;

package/dist/types/data/contacts/index.d.ts

@@ -1,14 +1,5 @@
-import type { Sphere } from "../yasuni_cause";
-import { type ContactProfile, type ContactProfileData } from "./buildContactSphere";
-export declare const contactProfiles: readonly ContactProfile[];
-export declare const CONTACT_IDS: readonly string[];
-export declare function getContactProfile(contactId: string): ContactProfile | undefined;
-/** Le profil embarqué `contactId` au format injectable, présenté comme
- *  avant 2.6.0 (« rôle — organisme ») ; lève une erreur si l'id est inconnu. */
-export declare function getEmbeddedContactProfileData(contactId: string): ContactProfileData;
-/** Sphere fraîchement construite du contact ; lève une erreur si l'id est inconnu. */
-export declare function getContactSphere(contactId: string): Sphere;
 export { buildContactSphere, qualityPercentToTension, validateContactProfile, } from "./buildContactSphere";
-export type { ContactProfile, ContactProfileData, ContactSatelliteValue, } from "./buildContactSphere";
+export type { ContactProfileData, ContactSatelliteValue } from "./buildContactSphere";
+export { DEMO_CONTACT_ID, demoContactProfile } from "./demoContact";
 export { UNIVERSAL_FACETS, CONTACT_CATEGORIES } from "./universalFacets";
 export type { SatelliteKey, ContactFacetId, ContactCategoryId } from "./universalFacets";

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": "2.6.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",

package/dist/types/data/contacts/profiles/andres_cevallos.d.ts

@@ -1,2 +0,0 @@
-import { type ContactProfile } from "../buildContactSphere";
-export declare const andresCevallosProfile: ContactProfile;

package/dist/types/data/contacts/profiles/camila_serrano.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const camilaSerranoProfile: ContactProfile;

package/dist/types/data/contacts/profiles/dika.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const dikaProfile: ContactProfile;

package/dist/types/data/contacts/profiles/elena_viteri.d.ts

@@ -1,2 +0,0 @@
-import { type ContactProfile } from "../buildContactSphere";
-export declare const elenaViteriProfile: ContactProfile;

package/dist/types/data/contacts/profiles/etawane.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const etawaneProfile: ContactProfile;

package/dist/types/data/contacts/profiles/gabriel_mena.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const gabrielMenaProfile: ContactProfile;

package/dist/types/data/contacts/profiles/kuri_tapuy.d.ts

@@ -1,2 +0,0 @@
-import { type ContactProfile } from "../buildContactSphere";
-export declare const kuriTapuyProfile: ContactProfile;

package/dist/types/data/contacts/profiles/lucia_cardenas.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const luciaCardenasProfile: ContactProfile;

package/dist/types/data/contacts/profiles/mariana_paredes.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const marianaParedesProfile: ContactProfile;

package/dist/types/data/contacts/profiles/martin_aguirre.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const martinAguirreProfile: ContactProfile;

package/dist/types/data/contacts/profiles/mateo_salazar.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const mateoSalazarProfile: ContactProfile;

package/dist/types/data/contacts/profiles/sofia_almeida.d.ts

@@ -1,2 +0,0 @@
-import type { ContactProfile } from "../buildContactSphere";
-export declare const sofiaAlmeidaProfile: ContactProfile;

package/dist/types/data/contacts/profiles/tomas_valverde.d.ts

@@ -1,2 +0,0 @@
-import { type ContactProfile } from "../buildContactSphere";
-export declare const tomasValverdeProfile: ContactProfile;