Aller au contenu principal

Imbrication et pipeline

Imbrication et sécurité​

Les composants peuvent utiliser use d'autres composants. Le compositeur se résout récursivement jusqu'à 8 niveaux de profondeur, intégrant les données délimitées à chaque niveau.

  • Isolation des locataires — un use ne se résout que dans le même locataire.
  • Détection de cycles — le compositeur suit les poignées visitées et rejette les cycles (A → B → A).
  • Vérification des collisions — les noms metadata.name dupliqués dans la bibliothèque de composants échouent au chargement, jamais silencieusement au rendu.

Pipeline de composition​

1. Le document est chargé
2. Chaque use est résolu (récursivement, limité en profondeur) — la configuration
   fusionne, les données par utilisation sont intégrées, les styles de section
   sont estampillés, le contenu s'assemble
3. Les jetons $data / $item restants sont résolus avec les données de l'appelant
4. Les variables globales ($global.PAGE, …) sont résolues et le PDF / DOCX final est produit

La composition s'exécute avant la passe de données globales, les composants peuvent donc porter des références $data qui se résolvent avec les données de l'appelant.