@micheeeeel/yinyangapp 2.4.2 → 2.5.0

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

@@ -10,3 +10,16 @@ export declare function composantesToCause(composantes: Composante[], id?: strin
 /** 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;
+/** La `Cause` d'un contact (sphère individuelle, 8 facettes / 38 satellites),
+ *  fraîchement construite à chaque appel. `id` par défaut : l'id du contact.
+ *  Lève une erreur si le contact est inconnu (voir `listContacts`). */
+export declare function getContactCause(contactId: string, id?: string): Cause;
+export interface ContactSummary {
+    id: string;
+    name: string;
+    role: string;
+    organisation: string;
+    provisional: boolean;
+}
+/** Les contacts disponibles, dans l'ordre de la calibration Notion. */
+export declare function listContacts(): ContactSummary[];

package/dist/types/api.d.ts

@@ -58,6 +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 } from "./adapters/yasuniCauseAdapter";
+export { getYasuniCause, getContactCause, listContacts, } from "./adapters/yasuniCauseAdapter";
+export type { ContactSummary } from "./adapters/yasuniCauseAdapter";
 export { mountYinYangWorkspace } from "./api-workspace";
 export type { YinYangWorkspaceConfig, YinYangWorkspaceHandle, } from "./api-workspace";

package/dist/types/components/controller/YinYangController.d.ts

@@ -758,6 +758,9 @@ export declare class YinYangController implements IYinYangController {
     private _animateComet;
     private getCurrentComponent;
     private getCurrentComponentOrUndefined;
+    /** Nom de l'objet racine : celui de la Cause montée quand elle en porte un
+     *  (sphère de contact), sinon la sphère active de la page. */
+    private rootName;
     private getCurrentComponentTitle;
     /** Second (et, le cas échéant, troisième) niveau du titre : libellé + couleur
      *  ODD du satellite actif sous la facette courante (menu ouvert, ou
@@ -1140,7 +1143,7 @@ export declare class YinYangController implements IYinYangController {
     highlightOddByStackItemId(stackItemId: string | null): void;
     /**
      * Retourne les actions applicables au cutting associé à `childKey`,
-     * en consultant `yasuniCause` via `actionMap` (lookup O(1)).
+     * en consultant `activeComposantes` via `actionMap` (lookup O(1)).
      *
      * Les actions adverses vivent sous le même satellite (l'invariant "une
      * action vit sous un satellite" tient) mais ne sont jamais proposées au

package/dist/types/components/controls/DiagramSwitcherControl.d.ts

@@ -0,0 +1,3 @@
+/** Câble le sélecteur #debug-diagram-switcher et neutralise les contrôles
+ *  Debug qui supposent un catalogue d'actions. */
+export declare function mountDiagramSwitcher(debugTabButton: HTMLButtonElement | null): void;

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

@@ -6,6 +6,7 @@ import { IYinYangView } from "../../interfaces/IYinYangView";
 import { IYinOrYangPattern } from "../../interfaces/IYinOrYangPattern";
 import { IViewData } from "../../interfaces/IViewData";
 import { IYinYangGeometry, YinYangCategoryArcGeometry, YinYangSpikeGeometry } from "../../interfaces/IYinYangGeometry";
+import { YinYangComponentNode } from "../../interfaces/IYinYangInternalModel";
 export declare class ViewInitializer {
     graphicContainer: IGraphicElement;
     graphicStrategy: IGraphicsStrategy;
@@ -188,6 +189,10 @@ export declare class ViewInitializer {
     oddContextLabelsVisible: boolean;
     oddContextLabelsSuppressed: boolean;
     oddLabelsCompact: boolean;
+    /** Reflet de "Afficher libellés" (YinYangControllerState.allLabelsVisible),
+     *  posé par ControllerSettingsApplier : affiche le poids de toutes les
+     *  facettes sur leur arc, pas seulement celui de la facette active. */
+    allLabelsVisible: boolean;
     legendLabelsBgEnabled: boolean;
     labelsFontAutoScale: number;
     labelsFontScale: number;
@@ -309,6 +314,11 @@ export declare class ViewInitializer {
      *  (même règle que le plafond par-ODD affiché sur les arcs, voir
      *  buildOddArcLabelLines dans YinYangDrawer). */
     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";

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

@@ -27,6 +27,8 @@ export declare class YinYangDrawer {
     private categoryArcGhostFrameId;
     private readonly CHILD_SCORE_BAND_FRACTION;
     private readonly CHILD_WEIGHT_LABEL_BAND_FRACTION;
+    private readonly FACETTE_SCORE_BAND_FRACTION;
+    private readonly SCORE_FONT_SCALE;
     private readonly BASE_MAIN_SELECTOR;
     private readonly IDLE_SPHERE_OVERLAY_ROLE;
     private readonly MIN_VISIBLE_ARC_ANGLE_RAD;
@@ -240,7 +242,7 @@ export declare class YinYangDrawer {
      */
     private drawYinOrYangWithGroup;
     /**
-     * Affiche le score d'état ("40/100") dans l'anneau extérieur de la moitié
+     * Affiche le score d'état ("40%") dans l'anneau extérieur de la moitié
      * dominante du satellite — entre le petit cercle "noyau"
      * (smallRadius) et le bord du lobe (radius) — plutôt qu'en son centre
      * exact, pour laisser le noyau visible. La moitié orientée grandit
@@ -266,43 +268,63 @@ export declare class YinYangDrawer {
      * plus grand, et le texte doit suivre dans les deux cas.
      */
     private renderChildStateLabel;
+    /** Score "47%" : valeur pleine, signe % réduit — le score est une part de
+     *  100, le suffixe "/100" n'apprenait rien de plus. */
+    private writeScorePercent;
     /**
-     * Affiche le poids ("6/10") dans le même lobe dominant que le score, mais
+     * Affiche le poids ("6") dans le même lobe dominant que le score, mais
      * sur le rayon OPPOSÉ (score : vers l'extérieur du satellite ; poids :
      * vers son centre) — même mécanique que renderChildStateLabel (taille
-     * proportionnelle au rayon réel) pour la même nature visuelle "posée sur
-     * le disque", avec deux différences volontaires : la couleur de
-     * remplissage (la teinte du poids, reprise du chip des cartes et de l'onde
-     * de prévisualisation) pour rester identifiable comme "poids" au premier
-     * coup d'œil, et un fond en dégradé radial (pas de liseret) qui calme le
-     * lobe sous les chiffres. Même technique que les libellés d'arcs du cercle
-     * central (renderOddArcLabels) : cercle rempli d'un radialGradient
-     * couleur→transparent, dimensionné sur le bbox du texte.
-     *
-     * Teinte comme voile suivent le lobe (weightColorForLobe, labelVeilColor) :
-     * doré sur fond noir, ambre profond sur fond blanc, où le doré ne tient
-     * pas — c'est la même règle que le score, qui lui s'inverse franchement.
+     * proportionnelle au rayon réel). Même pastille sombre que le poids de la
+     * facette (ensureWeightPill/fitWeightPill) : le doré y reste lisible sur
+     * un lobe noir comme blanc, et le poids se reconnaît au même encadré
+     * partout dans le diagramme.
      */
     private renderChildWeightLabel;
     /**
-     * Affiche le score de la facette courante ("40/100") dans le cercle
+     * Pastille du poids — partagée par le poids de la facette (dans son arc)
+     * et celui des satellites (dans leur lobe) : fond sombre arrondi, chiffre
+     * doré. Le fond ne dépend pas de ce qu'il y a dessous (lobe noir ou
+     * blanc, arc de n'importe quelle teinte), le doré y reste toujours lisible.
+     * Crée le groupe (rect + text) s'il n'existe pas encore sous `parent` ;
+     * `key` distingue plusieurs pastilles du même rôle (une par arc de facette).
+     */
+    private ensureWeightPill;
+    /** Ajuste la pastille (ensureWeightPill) au texte qu'elle porte — à
+     *  rappeler après chaque changement de texte ou de police. */
+    private fitWeightPill;
+    /**
+     * Affiche le score de la facette courante ("40%") dans le cercle
      * principal — même règle que renderChildStateLabel au niveau d'un
      * satellite (bande [smallRadius, radius] du lobe dominant, même
      * contraste), maintenant que les arcs ODD n'affichent plus systématiquement
      * cette information (voir buildOddArcLabelLines, réservé à l'ODD
-     * sélectionné). Contrairement au satellite, le suffixe "/100" est affiché
-     * (même convention que les libellés d'arcs) : au niveau facette il n'y a
-     * pas de fratrie pour donner le contexte d'échelle par comparaison.
+     * sélectionné). Seul occupant du lobe depuis que le poids a rejoint l'arc
+     * de facette (renderFacetteWeightLabel), il est centré dans l'anneau.
      */
     private renderFacetteStateLabel;
     /**
-     * Affiche le poids de la facette courante ("18/40") dans le cercle
-     * principal, sur le rayon opposé au score — même règle que
-     * renderChildWeightLabel au niveau d'un satellite (fond en dégradé
-     * radial, teinte du poids). Le poids et son plafond sont la somme des
-     * poids de tous les ODD de la facette (voir
-     * ViewInitializer.getFacetteWeight/getFacetteWeightMax), la même formule
-     * que celle qui dimensionne chaque arc.
+     * Affiche le poids d'une facette ("18/40") 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).
+     *
+     * Par défaut seule la facette active porte son poids (et seulement quand
+     * ses libellés sont visibles, voir shouldShowFacetteLabels) ; avec
+     * "Afficher libellés" (ViewInitializer.allLabelsVisible), chaque arc porte
+     * le sien, facette ouverte ou non.
+     *
+     * Police calée sur l'épaisseur de l'anneau, texte couché le long de l'arc
+     * (tangent à son milieu, retourné sur la moitié basse pour rester à
+     * l'endroit) : il épouse la courbe du cercle, et tient dans la bande à
+     * n'importe quel angle. Posé sur une pastille sombre (ensureWeightPill) :
+     * l'arc peut porter n'importe quelle teinte, y compris le doré du poids.
+     *
+     * Calque propre, enfant direct de globalGroup et non du lobe : yinYangGroup
+     * tourne pendant les animations alors que les arcs de bordure restent
+     * fixes — les libellés doivent rester collés à leur arc, pas au spin.
+     * Réinséré en dernier pour passer au-dessus des arcs comme du yin-yang.
      */
     private renderFacetteWeightLabel;
     private drawGhostCircle;
@@ -485,6 +507,15 @@ export declare class YinYangDrawer {
      */
     setHoverOddId(oddId: string | null): void;
     private refreshHoverArcStyles;
+    /**
+     * Allume les zones de clic des arcs ODD d'une couche : un arc SURVOLÉ ou
+     * ACTIF reçoit la couleur de son ODD et son halo, les autres redeviennent
+     * transparents. L'arc actif était auparavant allumé par accident — le
+     * style de survol, posé juste avant le clic, n'était jamais retiré tant
+     * que l'arc restait actif ; activé sans survol (par l'hôte :
+     * searchHighlightOdd, searchActivateOdd), il n'avait que son liseré.
+     */
+    private refreshOddHitZones;
     /**
      * Re-applies the highlight / dim styles on all existing interactive arc hit-zones
      * based on the current `activeOddId`, without recreating the DOM elements.