@micheeeeel/yinyangapp 2.3.0 → 2.4.1

package/dist/types/api.d.ts

@@ -26,6 +26,9 @@ export interface YinYangMountConfig {
     minEdge?: number;
     borderAnimationDuration?: number;
     includeChildren?: boolean;
+    /** Mode PRÉSENTATION : le diagramme se lit, il ne se manœuvre pas — voir
+     *  `IViewData.presentation`. Défaut : false (l'atelier complet). */
+    presentation?: boolean;
 }
 export interface YinYangMountHandle {
     controller: IYinYangController;

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

@@ -243,6 +243,10 @@ export declare class YinYangController implements IYinYangController {
      *  switches facette. */
     private cachedGlobalFitShrinkRatio?;
     private computeGlobalFitShrinkRatio;
+    /** Mode PRÉSENTATION (voir `IViewData.presentation`) : le diagramme se lit,
+     *  il ne se manœuvre pas. Lu sur la vue, donc hérité par les satellites —
+     *  chacun porte la même `viewData.presentation`. */
+    private get isPresentation();
     applyChildrenFitScale(): void;
     /** Creates the facette image ring, sized from the room actually left between
      *  the border and the container edge. Call after applyChildrenFitScale() so
@@ -642,12 +646,13 @@ export declare class YinYangController implements IYinYangController {
     /**
      * A satellite drill-down and facette-level ODD browsing are mutually
      * exclusive: deselect any active satellite before an ODD arc interaction
-     * proceeds, so the panel falls back to a view that actually contains the
-     * clicked ODD's legend chip (renderCuttingInfo/an active action only show
-     * a single ODD, or none — toggleOddLegendChipById would otherwise silently
-     * no-op). Mirrors the toggle-close branch of openActionMenuFromChild, plus
-     * an explicit renderComposanteInfo (clearProjectedActionState alone falls
-     * back to the Sphère card, not the Facette one).
+     * proceeds. The panel then falls back to the Facette card, which is the one
+     * that carries every ODD's legend chip (renderCuttingInfo/an active action
+     * only show a single ODD, or none) — so the chip reflecting the newly
+     * activated arc is actually there to be seen. Mirrors the toggle-close
+     * branch of openActionMenuFromChild, plus an explicit renderComposanteInfo
+     * (clearProjectedActionState alone falls back to the Sphère card, not the
+     * Facette one).
      */
     private deselectActiveChildForOddInteraction;
     /**

package/dist/types/components/controller/force-field/ForceFieldDetailsPanel.d.ts

@@ -529,11 +529,11 @@ export declare class ForceFieldDetailsPanel {
     private getTargetName;
     private getGhostDetailsContainer;
     private getForceFieldDetailsContainer;
-    /** Ouvre/ferme la description de cet ODD sous le descriptif actuellement
-     *  affiché (sphère/facette/satellite), comme un clic direct sur son chip
-     *  de légende. Retourne `null` si aucun chip pour cet ODD n'est visible
-     *  dans le contexte courant (no-op), sinon le nouvel état (ouvert/fermé). */
-    toggleOddLegendChipById(oddId: string): boolean | null;
+    /** Reflète sur la pastille de légende l'état de l'ODD tel que le DIAGRAMME
+     *  l'a décidé (clic sur l'arc). Le panneau suit : il n'est plus le
+     *  déclencheur — un panneau absent, gelé ou affichant une autre carte ne
+     *  doit pas empêcher l'arc de s'activer. */
+    setOddLegendChipOpenById(oddId: string, isOpen: boolean): void;
     clearGhostDetails(): void;
     /** Freeze the panel during a component switch so clearForceFieldDetails is a no-op. */
     freezeForSwitch(html: string): void;

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

@@ -146,9 +146,8 @@ export declare class BorderDrawer {
     /** Lifts the "voile terne" on one facette's image, veiling every other one
      *  — only one can be unveiled at a time. Driven by the outer spark
      *  sweeping across border arcs. Veils *all* others rather than just the
-     *  previously-tracked index, so this also correctly restores the
-     *  single-spotlight invariant the first time it's called after Idle
-     *  (where every image starts unveiled, not just one). */
+     *  previously-tracked index, so the single-spotlight invariant holds
+     *  whatever state the ring was left in. */
     revealFacetteImage(segmentIndex: number): void;
     /** Center + radius (pre-scale coordinate space) of a facette's image
      *  thumbnail, so labels can be anchored onto the image instead of
@@ -172,13 +171,13 @@ export declare class BorderDrawer {
      *  timers D3. */
     activateSegment(segmentIndex: number, immediate?: boolean): void;
     /** Resets all arc segments to inactive style (e.g. when satellites are
-     *  folded) and returns to Idle: every facette image goes back to full
-     *  color, exactly like a fresh load. */
+     *  folded) and returns to Idle: every facette image goes back to black and
+     *  white, exactly like a fresh load. */
     deactivateSegment(): void;
-    /** Restores every facette image to full color — the Idle visual, reached
-     *  both at true init and whenever no facette is currently active (e.g.
-     *  after deselecting one via deactivateSegment). */
-    revealAllFacetteImages(): void;
+    /** Veils every facette image — the Idle visual, reached both at true init
+     *  and whenever no facette is currently active (e.g. after deselecting one
+     *  via deactivateSegment): no arc is active, so no image is in color. */
+    veilAllFacetteImages(): void;
     /**
      * Highlights the source component border arc with a temporary beacon.
      * Used during a component switch when the active action has no visible force field.

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

@@ -176,7 +176,7 @@ export declare class ViewInitializer {
     /** Exponent (0-1) applied to each facette's weight ratio (its weight over
      *  the heaviest facette's weight) before it scales the thumbnail radius:
      *  radius = baseRadius * weightRatio^curve. 1 = linear (proportional to
-     *  weight, the default, and the strongest shrinkage). Below 1 attenuates
+     *  weight, and the strongest shrinkage). Below 1 attenuates
      *  the falloff — lighter facettes stay closer to full size — down to 0,
      *  where every facette renders at the same full size regardless of weight. */
     facetteImageWeightCurve: number;

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

@@ -2,6 +2,15 @@ export interface IViewData {
     minEdge: number;
     containerId: string;
     borderAnimationDuration: number;
+    /** Mode PRÉSENTATION : le diagramme se lit, il ne se manœuvre pas. Les
+     *  satellites et les arcs restent sélectionnables (et le diagramme reste
+     *  vivant), mais l'OUTILLAGE du mode Stratégie ne se déploie pas —
+     *  boutons d'action autour d'un satellite, menu radial des Événements
+     *  Clés, champs de force, ghosts d'aperçu. Destiné aux hôtes qui montrent
+     *  un diagramme dans un récit plutôt que dans l'atelier (voir
+     *  `docs/integration-yvy-frontend.md`). Hérité par les satellites, qui
+     *  sont eux-mêmes des contrôleurs complets. Défaut : false. */
+    presentation?: boolean;
     /** Poids de ce satellite relatif à la moyenne de sa fratrie (1 = moyenne),
      *  déjà utilisé pour dériver minEdge dans YinYangController.createYinYangChildren.
      *  Reporté ici tel quel pour que le satellite compense sa propre taille de

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

@@ -16,6 +16,10 @@ export declare function buildOddLegendHtmlForOdd(odd: ODD, composanteId: string)
  *  Retourne le nouvel état (`true` = ouvert, `false` = refermé) pour que
  *  l'appelant puisse répercuter ce même état ailleurs (ex : l'arc du
  *  diagramme correspondant à cet ODD). */
+/** Met la pastille DANS un état donné, au lieu de la basculer : le panneau
+ *  REFLÈTE alors un état décidé ailleurs (l'arc du diagramme), il ne le
+ *  décide pas. No-op si la pastille y est déjà. */
+export declare function setOddLegendChipOpen(chip: HTMLElement, isOpen: boolean): void;
 export declare function toggleOddLegendChip(chip: HTMLElement): boolean;
 /** Attache le survol des chips `[data-odd-legend-chip]` d'un container à un
  *  callback (id ODD survolé, ou `null` en sortie — accompagné de la composante

package/package.json

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