@rsuci/shared-form-components 1.0.15 → 1.0.17

package/dist/types/form-tree.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Types et interfaces pour le FormTree (arbre virtuel du formulaire)
+ * RSU v2 - Gestion centralisée de l'état de visibilité et des jumps
+ */
+import { VariableFormulaire, GroupeFormulaire, EnqueteReponse, VariableValue } from './enquete';
+/**
+ * État d'un noeud variable dans l'arbre
+ */
+export interface VariableNodeState {
+    /** Référence à la variable du formulaire */
+    variable: VariableFormulaire;
+    /** Résultat final de visibilité (estVisible && conditionMet && !jumpedOver) */
+    isVisible: boolean;
+    /** Masqué par un jump actif */
+    isJumpedOver: boolean;
+    /** Condition d'affichage satisfaite */
+    isConditionMet: boolean;
+    /** Passe la validation */
+    isValid: boolean;
+    /** Message d'erreur si invalide */
+    validationError?: string;
+    /** Ignorer validation (jumped over) */
+    skipValidation: boolean;
+    /** Valeur actuelle de la variable */
+    currentValue: VariableValue;
+    /** Effacer à la sauvegarde (jumped) */
+    shouldClearOnSave: boolean;
+}
+/**
+ * État d'un noeud groupe dans l'arbre
+ */
+export interface GroupNodeState {
+    /** Référence au groupe du formulaire */
+    groupe: GroupeFormulaire;
+    /** États des variables de ce groupe */
+    variables: VariableNodeState[];
+    /** Le groupe est visible */
+    isVisible: boolean;
+    /** Toutes les variables obligatoires sont remplies */
+    isComplete: boolean;
+    /** Erreurs de validation du groupe */
+    validationErrors: string[];
+    /** Map des itérations avec leurs états de variables */
+    iterations: Map<number, VariableNodeState[]>;
+}
+/**
+ * Plage de jump actif
+ * Représente un saut conditionnel entre deux variables
+ */
+export interface JumpRange {
+    /** Code de la variable source du jump */
+    sourceCode: string;
+    /** Ordre de la variable source */
+    sourceOrdre: number;
+    /** Code de la variable cible du jump */
+    targetCode: string;
+    /** Ordre de la variable cible */
+    targetOrdre: number;
+    /** Code du groupe contenant le jump */
+    groupeCode: string;
+    /** Condition d'activation du jump */
+    condition: string;
+    /** Le jump est actuellement actif */
+    isActive: boolean;
+}
+/**
+ * Erreur de jump pour notification
+ */
+export interface JumpError {
+    /** Type d'erreur */
+    type: 'backward_jump' | 'invalid_target' | 'circular_jump' | 'cross_group_jump';
+    /** Code de la variable source */
+    sourceVariable: string;
+    /** Code de la variable cible */
+    targetVariable: string;
+    /** Message d'erreur descriptif */
+    message: string;
+}
+/**
+ * Interface principale du FormTree
+ */
+export interface IFormTree {
+    /**
+     * Construit l'arbre à partir des groupes du formulaire
+     * @param groupes Liste des groupes du formulaire
+     */
+    buildFromFormulaire(groupes: GroupeFormulaire[]): void;
+    /**
+     * Met à jour les réponses et réévalue toutes les conditions
+     * @param responses Dictionnaire des réponses
+     */
+    updateResponses(responses: Record<string, EnqueteReponse>): void;
+    /**
+     * Évalue toutes les conditions de visibilité et jumps
+     */
+    evaluateAll(): void;
+    /**
+     * Retourne les variables visibles d'un groupe
+     * @param groupeCode Code du groupe
+     */
+    getVisibleVariables(groupeCode: string): VariableFormulaire[];
+    /**
+     * Retourne l'état d'un groupe
+     * @param groupeCode Code du groupe
+     */
+    getGroupState(groupeCode: string): GroupNodeState | undefined;
+    /**
+     * Retourne l'état d'une variable
+     * @param variableCode Code de la variable
+     */
+    getVariableState(variableCode: string): VariableNodeState | undefined;
+    /**
+     * Retourne les codes des variables sautées dans un groupe
+     * @param groupeCode Code du groupe
+     */
+    getJumpedVariableCodes(groupeCode: string): Set<string>;
+    /**
+     * Retourne tous les jumps actifs
+     */
+    getActiveJumps(): JumpRange[];
+    /**
+     * Retourne toutes les erreurs de jump détectées
+     */
+    getJumpErrors(): JumpError[];
+    /**
+     * Valide un groupe et retourne les erreurs
+     * @param groupeCode Code du groupe
+     */
+    validateGroup(groupeCode: string): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * Retourne les codes des variables à effacer lors de la sauvegarde
+     */
+    getVariablesToClearOnSave(): string[];
+    /** Callback appelé en cas d'erreur de jump */
+    onJumpError?: (error: JumpError) => void;
+}
+/**
+ * Options pour la création d'un FormTree
+ */
+export interface FormTreeOptions {
+    /** Callback en cas d'erreur de jump */
+    onJumpError?: (error: JumpError) => void;
+    /** Activer le logging de debug */
+    debug?: boolean;
+}
+/**
+ * Résultat de l'évaluation d'une condition de jump
+ */
+export interface JumpEvaluationResult {
+    /** La condition est valide syntaxiquement */
+    isValidSyntax: boolean;
+    /** Le jump peut être exécuté (cible valide, direction correcte) */
+    canExecute: boolean;
+    /** Le jump doit être activé (condition satisfaite) */
+    shouldActivate: boolean;
+    /** Code de la variable cible */
+    targetCode: string | null;
+    /** Erreur éventuelle */
+    error?: JumpError;
+}
+//# sourceMappingURL=form-tree.d.ts.map

package/dist/types/form-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-tree.d.ts","sourceRoot":"","sources":["../../src/types/form-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEhG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,EAAE,kBAAkB,CAAC;IAG7B,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;IAGxB,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;IAGxB,qCAAqC;IACrC,YAAY,EAAE,aAAa,CAAC;IAC5B,uCAAuC;IACvC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,CAAC;IACzB,uCAAuC;IACvC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAG/B,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAG3B,uDAAuD;IACvD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,IAAI,EAAE,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,CAAC;IAChF,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IAExB;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAGvD;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IAGpB;;;OAGG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAE9D;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAE9D;;;OAGG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAGtE;;;OAGG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAExD;;OAEG;IACH,cAAc,IAAI,SAAS,EAAE,CAAC;IAE9B;;OAEG;IACH,aAAa,IAAI,SAAS,EAAE,CAAC;IAG7B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAE1E;;OAEG;IACH,yBAAyB,IAAI,MAAM,EAAE,CAAC;IAGtC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB"}

package/dist/types/form-tree.js

@@ -0,0 +1,5 @@
+/**
+ * Types et interfaces pour le FormTree (arbre virtuel du formulaire)
+ * RSU v2 - Gestion centralisée de l'état de visibilité et des jumps
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsuci/shared-form-components",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Composants partagés de rendu de formulaires RSU v2 - Package local pour frontend Admin et Public",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",