@micheeeeel/yinyangapp 2.5.1 → 2.6.0

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

@@ -1,8 +1,9 @@
 import type { Composante } from "../data/yasuni_cause";
 import type { Cause } from "../interfaces/ICauseModel";
+import { type ContactProfileData } from "../data/contacts";
 /**
  * Adapte le catalogue Composante[] (format yasuni_cause.ts) vers le format
- * Cause attendu par validateCauseGraph et mapCauseToInternalModel.
+ * 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.
  */
@@ -10,9 +11,29 @@ 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`). */
+/**
+ * La `Cause` d'un contact (sphère individuelle, 8 facettes / 38 satellites)
+ * construite à partir du profil FOURNI PAR L'HÔTE — pour YvY, celui de
+ * `GET /api/contacts` (yvy-backend, seule source des profils). La lib n'y
+ * ajoute que la grille universelle ; elle ne fait aucun appel réseau.
+ *
+ * `id` par défaut : l'id du profil. `description` (titre au repos, panneau
+ * de détails) : celle du profil, chaîne vide à défaut — le diagramme montre
+ * alors le nom du contact, jamais la sphère active de la page.
+ * Fraîchement construite à chaque appel (aucun état partagé entre deux
+ * contacts). Lève une erreur explicite pour un profil incomplet ou hors
+ * 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;
@@ -21,5 +42,10 @@ export interface ContactSummary {
     organisation: string;
     provisional: boolean;
 }
-/** Les contacts disponibles, dans l'ordre de la calibration Notion. */
+/**
+ * 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,7 +58,11 @@ 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, } from "./adapters/yasuniCauseAdapter";
+export { getYasuniCause, getContactCause, listContacts, contactProfileToCause, } from "./adapters/yasuniCauseAdapter";
 export type { ContactSummary } 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";
+export type { SatelliteKey, ContactFacetId, ContactCategoryId, UniversalFacet, UniversalSatellite, ContactCategory, } from "./data/contacts/universalFacets";
 export { mountYinYangWorkspace } from "./api-workspace";
 export type { YinYangWorkspaceConfig, YinYangWorkspaceHandle, } from "./api-workspace";