@rsuci/shared-form-components 1.0.29 → 1.0.33

package/dist/lib/__tests__/date-functions.test.js

@@ -0,0 +1,184 @@
+/**
+ * Tests unitaires pour les fonctions de date du conditionEngine
+ */
+import { calculateDateDiff, calculateDateAdd, parseDateString, isValidDateUnit } from '../utils/date-functions';
+describe('date-functions', () => {
+    describe('calculateDateDiff', () => {
+        describe('différence en jours', () => {
+            it('devrait calculer la différence en jours entre deux dates', () => {
+                const date1 = new Date('2024-01-01');
+                const date2 = new Date('2024-01-31');
+                expect(calculateDateDiff(date1, date2, 'd')).toBe(30);
+            });
+            it('devrait retourner un nombre négatif si date2 < date1', () => {
+                const date1 = new Date('2024-01-31');
+                const date2 = new Date('2024-01-01');
+                expect(calculateDateDiff(date1, date2, 'd')).toBe(-30);
+            });
+            it('devrait retourner 0 pour la même date', () => {
+                const date = new Date('2024-01-15');
+                expect(calculateDateDiff(date, date, 'd')).toBe(0);
+            });
+            it('devrait calculer 365 jours pour une année non bissextile', () => {
+                const date1 = new Date('2023-01-01');
+                const date2 = new Date('2024-01-01');
+                expect(calculateDateDiff(date1, date2, 'd')).toBe(365);
+            });
+            it('devrait calculer 366 jours pour une année bissextile', () => {
+                const date1 = new Date('2024-01-01');
+                const date2 = new Date('2025-01-01');
+                expect(calculateDateDiff(date1, date2, 'd')).toBe(366);
+            });
+        });
+        describe('différence en mois', () => {
+            it('devrait calculer la différence en mois', () => {
+                const date1 = new Date('2024-01-15');
+                const date2 = new Date('2024-07-15');
+                expect(calculateDateDiff(date1, date2, 'm')).toBe(6);
+            });
+            it('devrait ajuster si le jour du mois n\'est pas atteint', () => {
+                const date1 = new Date('2024-01-31');
+                const date2 = new Date('2024-02-15');
+                expect(calculateDateDiff(date1, date2, 'm')).toBe(0);
+            });
+            it('devrait retourner 12 mois pour une année exacte', () => {
+                const date1 = new Date('2024-01-15');
+                const date2 = new Date('2025-01-15');
+                expect(calculateDateDiff(date1, date2, 'm')).toBe(12);
+            });
+        });
+        describe('différence en années', () => {
+            it('devrait calculer la différence en années avec anniversaire passé', () => {
+                const date1 = new Date('2000-06-15');
+                const date2 = new Date('2024-08-15');
+                expect(calculateDateDiff(date1, date2, 'y')).toBe(24);
+            });
+            it('devrait retourner 23 si l\'anniversaire n\'est pas encore passé', () => {
+                const date1 = new Date('2000-12-31');
+                const date2 = new Date('2024-01-01');
+                expect(calculateDateDiff(date1, date2, 'y')).toBe(23);
+            });
+            it('devrait retourner l\'âge exact le jour de l\'anniversaire', () => {
+                const date1 = new Date('2000-06-15');
+                const date2 = new Date('2024-06-15');
+                expect(calculateDateDiff(date1, date2, 'y')).toBe(24);
+            });
+            it('devrait retourner 0 pour moins d\'un an', () => {
+                const date1 = new Date('2024-01-01');
+                const date2 = new Date('2024-06-01');
+                expect(calculateDateDiff(date1, date2, 'y')).toBe(0);
+            });
+        });
+        describe('gestion des erreurs', () => {
+            it('devrait retourner null pour date1 null', () => {
+                expect(calculateDateDiff(null, new Date(), 'd')).toBe(null);
+            });
+            it('devrait retourner null pour date2 null', () => {
+                expect(calculateDateDiff(new Date(), null, 'd')).toBe(null);
+            });
+            it('devrait retourner null pour date invalide', () => {
+                expect(calculateDateDiff(new Date('invalid'), new Date(), 'd')).toBe(null);
+            });
+            it('devrait retourner null pour unité invalide', () => {
+                expect(calculateDateDiff(new Date(), new Date(), 'x')).toBe(null);
+            });
+        });
+    });
+    describe('calculateDateAdd', () => {
+        describe('ajout de jours', () => {
+            it('devrait ajouter des jours à une date', () => {
+                const date = new Date('2024-01-01');
+                const result = calculateDateAdd(date, 30, 'd');
+                expect(result?.toISOString().slice(0, 10)).toBe('2024-01-31');
+            });
+            it('devrait soustraire des jours avec une valeur négative', () => {
+                const date = new Date('2024-01-15');
+                const result = calculateDateAdd(date, -7, 'd');
+                expect(result?.toISOString().slice(0, 10)).toBe('2024-01-08');
+            });
+            it('devrait gérer le passage de mois', () => {
+                const date = new Date('2024-01-31');
+                const result = calculateDateAdd(date, 1, 'd');
+                expect(result?.toISOString().slice(0, 10)).toBe('2024-02-01');
+            });
+        });
+        describe('ajout de mois', () => {
+            it('devrait ajouter des mois à une date', () => {
+                const date = new Date('2024-01-15');
+                const result = calculateDateAdd(date, 6, 'm');
+                expect(result?.toISOString().slice(0, 10)).toBe('2024-07-15');
+            });
+            it('devrait soustraire des mois avec une valeur négative', () => {
+                const date = new Date('2024-07-15');
+                const result = calculateDateAdd(date, -6, 'm');
+                expect(result?.toISOString().slice(0, 10)).toBe('2024-01-15');
+            });
+            it('devrait gérer le passage d\'année', () => {
+                const date = new Date('2024-11-15');
+                const result = calculateDateAdd(date, 3, 'm');
+                expect(result?.toISOString().slice(0, 10)).toBe('2025-02-15');
+            });
+        });
+        describe('ajout d\'années', () => {
+            it('devrait ajouter des années à une date', () => {
+                const date = new Date('2024-01-01');
+                const result = calculateDateAdd(date, 1, 'y');
+                expect(result?.toISOString().slice(0, 10)).toBe('2025-01-01');
+            });
+            it('devrait soustraire des années avec une valeur négative', () => {
+                const date = new Date('2024-01-01');
+                const result = calculateDateAdd(date, -5, 'y');
+                expect(result?.toISOString().slice(0, 10)).toBe('2019-01-01');
+            });
+        });
+        describe('gestion des erreurs', () => {
+            it('devrait retourner null pour date null', () => {
+                expect(calculateDateAdd(null, 30, 'd')).toBe(null);
+            });
+            it('devrait retourner null pour date invalide', () => {
+                expect(calculateDateAdd(new Date('invalid'), 30, 'd')).toBe(null);
+            });
+            it('devrait retourner null pour valeur NaN', () => {
+                expect(calculateDateAdd(new Date(), NaN, 'd')).toBe(null);
+            });
+            it('devrait retourner null pour unité invalide', () => {
+                expect(calculateDateAdd(new Date(), 30, 'x')).toBe(null);
+            });
+        });
+    });
+    describe('parseDateString', () => {
+        it('devrait parser une date ISO', () => {
+            const result = parseDateString('2024-01-15');
+            expect(result?.toISOString().slice(0, 10)).toBe('2024-01-15');
+        });
+        it('devrait parser une date ISO avec heure', () => {
+            const result = parseDateString('2024-01-15T10:30:00');
+            expect(result).not.toBe(null);
+        });
+        it('devrait parser un timestamp', () => {
+            const timestamp = new Date('2024-01-15').getTime().toString();
+            const result = parseDateString(timestamp);
+            expect(result).not.toBe(null);
+        });
+        it('devrait retourner null pour une chaîne vide', () => {
+            expect(parseDateString('')).toBe(null);
+        });
+        it('devrait retourner null pour une date invalide', () => {
+            expect(parseDateString('invalid')).toBe(null);
+        });
+    });
+    describe('isValidDateUnit', () => {
+        it('devrait retourner true pour "d"', () => {
+            expect(isValidDateUnit('d')).toBe(true);
+        });
+        it('devrait retourner true pour "m"', () => {
+            expect(isValidDateUnit('m')).toBe(true);
+        });
+        it('devrait retourner true pour "y"', () => {
+            expect(isValidDateUnit('y')).toBe(true);
+        });
+        it('devrait retourner false pour une unité invalide', () => {
+            expect(isValidDateUnit('x')).toBe(false);
+        });
+    });
+});

package/dist/lib/utils/groupeInstanceManager.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Gestionnaire des instances multiples pour les groupes d'enquête
+ * RSU v2 - Moteur de Rendu des Formulaires d'Enquête
+ */
+import { GroupeFormulaire, GroupeInstance, EnqueteReponse, ConstraintValidationResult } from '../../types/enquete';
+export declare class GroupeInstanceManager {
+    /**
+     * Récupère le nombre maximum d'instances autorisées depuis la variable de contrôle
+     * RÈGLE DE PROTECTION : Ne jamais permettre de réduire sous le nombre d'instances existantes
+     */
+    static getMaxInstances(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): number;
+    /**
+     * Récupère le nombre minimum d'instances (basé sur les instances existantes)
+     */
+    static getMinInstances(groupe: GroupeFormulaire): number;
+    /**
+     * Compte le nombre d'instances existantes pour un groupe
+     */
+    static getInstancesCount(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): number;
+    /**
+     * Crée une nouvelle instance pour un groupe multiple
+     */
+    static createInstance(groupe: GroupeFormulaire, numeroInstance: number): GroupeInstance;
+    /**
+     * Initialise les instances pour un groupe multiple
+     */
+    static initializeInstances(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): GroupeInstance[];
+    /**
+     * Vérifie si une instance est complètement renseignée
+     */
+    static isInstanceComplete(instance: GroupeInstance, groupe: GroupeFormulaire): boolean;
+    /**
+     * Valide si on peut ajouter une nouvelle instance
+     */
+    static canAddInstance(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): ConstraintValidationResult;
+    /**
+     * Valide si on peut supprimer une instance
+     */
+    static canRemoveInstance(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): ConstraintValidationResult;
+    /**
+     * Valide si on peut modifier la variable de contrôle
+     */
+    static canModifyControlVariable(variableCode: string, newValue: number, groupesMultiples: GroupeFormulaire[], responses: Record<string, EnqueteReponse>): ConstraintValidationResult;
+    /**
+     * Ajoute une nouvelle instance à un groupe
+     */
+    static addInstance(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): {
+        success: boolean;
+        instance?: GroupeInstance;
+        error?: string;
+    };
+    /**
+     * Supprime une instance d'un groupe
+     */
+    static removeInstance(groupe: GroupeFormulaire, instanceNumber: number, responses: Record<string, EnqueteReponse>): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * Met à jour les propriétés calculées d'un groupe multiple
+     */
+    static updateGroupeProperties(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): void;
+    /**
+     * Synchronise les réponses d'une instance avec le store global
+     */
+    static syncInstanceResponses(instance: GroupeInstance, groupe: GroupeFormulaire, globalResponses: Record<string, EnqueteReponse>): void;
+    /**
+     * Valide la navigation vers l'instance suivante
+     */
+    static canNavigateToNextInstance(currentInstance: GroupeInstance, groupe: GroupeFormulaire): ConstraintValidationResult;
+    /**
+     * Trouve la prochaine instance incomplète dans un groupe
+     */
+    static findNextIncompleteInstance(groupe: GroupeFormulaire): GroupeInstance | null;
+    /**
+     * Calcule la progression d'un groupe multiple
+     */
+    static calculateGroupProgress(groupe: GroupeFormulaire): {
+        completedInstances: number;
+        totalInstances: number;
+        progressPercentage: number;
+    };
+    /**
+     * Réorganise les numéros d'instances après suppression
+     */
+    static reorderInstances(groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>): void;
+}
+//# sourceMappingURL=groupeInstanceManager.d.ts.map

package/dist/lib/utils/groupeInstanceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupeInstanceManager.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/groupeInstanceManager.ts"],"names":[],"mappings":"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"}