@rsuci/shared-form-components 1.0.28 → 1.0.32

package/dist/hooks/useFormNavigation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Hook de navigation pour les formulaires d'enquête
+ * Gère la navigation entre groupes et instances
+ * RSU v2 - Package Partagé
+ */
+import { GroupeFormulaire, NavigationState } from '../types/enquete';
+export interface UseFormNavigationOptions {
+    /** Index initial du groupe */
+    initialGroupIndex?: number;
+    /** Index initial de l'instance */
+    initialInstanceIndex?: number;
+    /** Callback appelé lors d'un changement de groupe */
+    onGroupChange?: (groupIndex: number, groupCode: string) => void;
+    /** Callback appelé lors d'un changement d'instance */
+    onInstanceChange?: (instanceIndex: number) => void;
+    /** Validation avant navigation (doit retourner true pour permettre la navigation) */
+    validateBeforeNavigation?: () => boolean;
+}
+export interface UseFormNavigationResult {
+    /** État de navigation actuel */
+    navigationState: NavigationState;
+    /** Groupe actuellement affiché */
+    currentGroup: GroupeFormulaire | undefined;
+    /** Instance actuellement affichée (pour groupes multiples) */
+    currentInstance: any | undefined;
+    /** Est-ce le premier groupe? */
+    isFirstGroup: boolean;
+    /** Est-ce le dernier groupe? */
+    isLastGroup: boolean;
+    /** Peut-on aller au groupe suivant? */
+    canGoNext: boolean;
+    /** Peut-on aller au groupe précédent? */
+    canGoPrevious: boolean;
+    /** Aller au groupe suivant */
+    goToNextGroup: () => void;
+    /** Aller au groupe précédent */
+    goToPreviousGroup: () => void;
+    /** Aller à un groupe spécifique */
+    goToGroup: (groupIndex: number) => void;
+    /** Changer d'instance (pour groupes multiples) */
+    changeInstance: (instanceIndex: number) => void;
+    /** Mettre à jour le nombre total d'instances */
+    updateTotalInstances: (count: number) => void;
+    /** Réinitialiser la navigation */
+    resetNavigation: () => void;
+    /** Pourcentage de progression */
+    progressPercent: number;
+}
+/**
+ * Hook pour gérer la navigation dans un formulaire d'enquête
+ *
+ * @param groupes - Liste des groupes du formulaire
+ * @param options - Options de configuration
+ * @returns Objet contenant l'état et les fonctions de navigation
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   navigationState,
+ *   currentGroup,
+ *   isLastGroup,
+ *   goToNextGroup,
+ *   goToPreviousGroup
+ * } = useFormNavigation(formulaire.groupes, {
+ *   onGroupChange: (index, code) => console.log(`Navigated to ${code}`),
+ *   validateBeforeNavigation: () => validateCurrentGroup()
+ * });
+ * ```
+ */
+export declare function useFormNavigation(groupes: GroupeFormulaire[], options?: UseFormNavigationOptions): UseFormNavigationResult;
+export default useFormNavigation;
+//# sourceMappingURL=useFormNavigation.d.ts.map

package/dist/hooks/useFormNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormNavigation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,qFAAqF;IACrF,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,kCAAkC;IAClC,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC3C,8DAA8D;IAC9D,eAAe,EAAE,GAAG,GAAG,SAAS,CAAC;IACjC,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,mCAAmC;IACnC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,kDAAkD;IAClD,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,gDAAgD;IAChD,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,kCAAkC;IAClC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAqJzB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/hooks/useFormNavigation.js

@@ -0,0 +1,147 @@
+/**
+ * Hook de navigation pour les formulaires d'enquête
+ * Gère la navigation entre groupes et instances
+ * RSU v2 - Package Partagé
+ */
+import { useState, useCallback, useMemo } from 'react';
+/**
+ * Hook pour gérer la navigation dans un formulaire d'enquête
+ *
+ * @param groupes - Liste des groupes du formulaire
+ * @param options - Options de configuration
+ * @returns Objet contenant l'état et les fonctions de navigation
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   navigationState,
+ *   currentGroup,
+ *   isLastGroup,
+ *   goToNextGroup,
+ *   goToPreviousGroup
+ * } = useFormNavigation(formulaire.groupes, {
+ *   onGroupChange: (index, code) => console.log(`Navigated to ${code}`),
+ *   validateBeforeNavigation: () => validateCurrentGroup()
+ * });
+ * ```
+ */
+export function useFormNavigation(groupes, options = {}) {
+    const { initialGroupIndex = 0, initialInstanceIndex = 0, onGroupChange, onInstanceChange, validateBeforeNavigation } = options;
+    // État de navigation
+    const [navigationState, setNavigationState] = useState({
+        groupeIndex: initialGroupIndex,
+        instanceIndex: initialInstanceIndex,
+        totalGroupes: groupes?.length || 0,
+        totalInstances: groupes?.[initialGroupIndex]?.instances?.length || 1
+    });
+    // Groupe et instance actuels
+    const currentGroup = useMemo(() => groupes?.[navigationState.groupeIndex], [groupes, navigationState.groupeIndex]);
+    const currentInstance = useMemo(() => currentGroup?.instances?.[navigationState.instanceIndex], [currentGroup, navigationState.instanceIndex]);
+    // Calculs de position
+    const isFirstGroup = navigationState.groupeIndex === 0;
+    const isLastGroup = navigationState.groupeIndex === (groupes?.length || 0) - 1;
+    const canGoNext = !isLastGroup;
+    const canGoPrevious = !isFirstGroup;
+    // Pourcentage de progression
+    const progressPercent = useMemo(() => {
+        if (!groupes?.length)
+            return 0;
+        return Math.round(((navigationState.groupeIndex + 1) / groupes.length) * 100);
+    }, [groupes?.length, navigationState.groupeIndex]);
+    // Aller au groupe suivant
+    const goToNextGroup = useCallback(() => {
+        if (isLastGroup)
+            return;
+        // Validation optionnelle avant navigation
+        if (validateBeforeNavigation && !validateBeforeNavigation()) {
+            return;
+        }
+        const nextGroupIndex = navigationState.groupeIndex + 1;
+        const nextGroup = groupes?.[nextGroupIndex];
+        setNavigationState(prev => ({
+            ...prev,
+            groupeIndex: nextGroupIndex,
+            instanceIndex: 0,
+            totalInstances: nextGroup?.instances?.length || 1
+        }));
+        if (onGroupChange && nextGroup) {
+            onGroupChange(nextGroupIndex, nextGroup.code);
+        }
+    }, [isLastGroup, navigationState.groupeIndex, groupes, validateBeforeNavigation, onGroupChange]);
+    // Aller au groupe précédent
+    const goToPreviousGroup = useCallback(() => {
+        if (isFirstGroup)
+            return;
+        const prevGroupIndex = navigationState.groupeIndex - 1;
+        const prevGroup = groupes?.[prevGroupIndex];
+        setNavigationState(prev => ({
+            ...prev,
+            groupeIndex: prevGroupIndex,
+            instanceIndex: 0,
+            totalInstances: prevGroup?.instances?.length || 1
+        }));
+        if (onGroupChange && prevGroup) {
+            onGroupChange(prevGroupIndex, prevGroup.code);
+        }
+    }, [isFirstGroup, navigationState.groupeIndex, groupes, onGroupChange]);
+    // Aller à un groupe spécifique
+    const goToGroup = useCallback((groupIndex) => {
+        if (groupIndex < 0 || groupIndex >= (groupes?.length || 0))
+            return;
+        const targetGroup = groupes?.[groupIndex];
+        setNavigationState(prev => ({
+            ...prev,
+            groupeIndex: groupIndex,
+            instanceIndex: 0,
+            totalInstances: targetGroup?.instances?.length || 1
+        }));
+        if (onGroupChange && targetGroup) {
+            onGroupChange(groupIndex, targetGroup.code);
+        }
+    }, [groupes, onGroupChange]);
+    // Changer d'instance
+    const changeInstance = useCallback((instanceIndex) => {
+        if (instanceIndex < 0)
+            return;
+        setNavigationState(prev => ({
+            ...prev,
+            instanceIndex
+        }));
+        if (onInstanceChange) {
+            onInstanceChange(instanceIndex);
+        }
+    }, [onInstanceChange]);
+    // Mettre à jour le nombre total d'instances
+    const updateTotalInstances = useCallback((count) => {
+        setNavigationState(prev => ({
+            ...prev,
+            totalInstances: count
+        }));
+    }, []);
+    // Réinitialiser la navigation
+    const resetNavigation = useCallback(() => {
+        setNavigationState({
+            groupeIndex: initialGroupIndex,
+            instanceIndex: initialInstanceIndex,
+            totalGroupes: groupes?.length || 0,
+            totalInstances: groupes?.[initialGroupIndex]?.instances?.length || 1
+        });
+    }, [initialGroupIndex, initialInstanceIndex, groupes]);
+    return {
+        navigationState,
+        currentGroup,
+        currentInstance,
+        isFirstGroup,
+        isLastGroup,
+        canGoNext,
+        canGoPrevious,
+        goToNextGroup,
+        goToPreviousGroup,
+        goToGroup,
+        changeInstance,
+        updateTotalInstances,
+        resetNavigation,
+        progressPercent
+    };
+}
+export default useFormNavigation;

package/dist/hooks/useFormRenderer.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Hook principal pour le rendu des formulaires d'enquête
+ * Combine navigation, validation et gestion des instances
+ * RSU v2 - Package Partagé
+ */
+import { FormulaireComplet, EnqueteInstance, EnqueteReponse, GroupeFormulaire, GroupeInstance, VariableFormulaire, VariableValue } from '../types/enquete';
+import { FormRendererConfig, FormRendererMode, FormRendererFeatures } from '../types/form-renderer';
+import { UseFormNavigationResult } from './useFormNavigation';
+import { UseFormValidationResult } from './useFormValidation';
+import { UseFormInstancesResult } from './useFormInstances';
+export interface UseFormRendererOptions {
+    /** Configuration du FormRenderer */
+    config: FormRendererConfig;
+    /** Réponses initiales */
+    initialResponses?: Record<string, EnqueteReponse>;
+    /** Callback lors de changement de réponses */
+    onResponsesChange?: (responses: Record<string, EnqueteReponse>) => void;
+    /** Callback lors de changement de groupe */
+    onGroupChange?: (groupIndex: number, groupCode: string) => void;
+    /** Fonction pour vérifier si une variable est visible */
+    isVariableVisible?: (variable: VariableFormulaire) => boolean;
+    /** Mode debug */
+    debug?: boolean;
+}
+export interface UseFormRendererResult {
+    navigation: UseFormNavigationResult;
+    validation: UseFormValidationResult;
+    instances: UseFormInstancesResult;
+    /** Toutes les réponses */
+    responses: Record<string, EnqueteReponse>;
+    /** Mettre à jour une réponse */
+    updateResponse: (variableCode: string, value: VariableValue, variable: VariableFormulaire, numeroMembre?: number) => void;
+    /** Mettre à jour toutes les réponses */
+    setResponses: React.Dispatch<React.SetStateAction<Record<string, EnqueteReponse>>>;
+    /** Y a-t-il des changements non sauvegardés? */
+    hasUnsavedChanges: boolean;
+    /** Marquer comme ayant des changements */
+    setHasUnsavedChanges: React.Dispatch<React.SetStateAction<boolean>>;
+    /** Est en train de soumettre? */
+    isSubmitting: boolean;
+    /** Définir l'état de soumission */
+    setIsSubmitting: React.Dispatch<React.SetStateAction<boolean>>;
+    /** Mode lecture seule effectif */
+    effectiveDisabled: boolean;
+    /** Est en mode consultation? */
+    isConsultationMode: boolean;
+    /** Est en lecture seule? */
+    isReadOnly: boolean;
+    /** Mode actuel (admin/public) */
+    mode: FormRendererMode;
+    /** Fonctionnalités activées */
+    features: FormRendererFeatures;
+    /** Groupe actuellement affiché */
+    currentGroup: GroupeFormulaire | undefined;
+    /** Instance actuellement affichée */
+    currentInstance: GroupeInstance | undefined;
+    /** Groupes avec instances initialisées */
+    groupesWithInstances: GroupeFormulaire[];
+    /** Vérifier si une variable est de contrôle */
+    isControlVariable: (variable: VariableFormulaire) => boolean;
+    /** Obtenir la clé de réponse pour une variable */
+    getResponseKey: (variableCode: string, numeroMembre?: number) => string;
+    /** Obtenir la valeur d'une réponse */
+    getResponseValue: (variableCode: string, numeroMembre?: number) => VariableValue;
+}
+/**
+ * Hook principal pour gérer un formulaire d'enquête
+ *
+ * @param formulaire - Le formulaire complet
+ * @param enquete - L'instance d'enquête (optionnel pour nouvelle enquête)
+ * @param options - Options de configuration
+ * @returns Objet contenant tout l'état et les fonctions nécessaires
+ *
+ * @example
+ * ```tsx
+ * const formRenderer = useFormRenderer(formulaire, enquete, {
+ *   config: { mode: 'admin', features: { saveDraft: true } },
+ *   onResponsesChange: (responses) => console.log('Changed:', responses)
+ * });
+ *
+ * // Utilisation
+ * const { navigation, validation, responses, updateResponse } = formRenderer;
+ * ```
+ */
+export declare function useFormRenderer(formulaire: FormulaireComplet, enquete?: EnqueteInstance, options?: UseFormRendererOptions): UseFormRendererResult;
+export default useFormRenderer;
+//# sourceMappingURL=useFormRenderer.d.ts.map

package/dist/hooks/useFormRenderer.d.ts.map

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

package/dist/hooks/useFormRenderer.js

@@ -0,0 +1,177 @@
+/**
+ * Hook principal pour le rendu des formulaires d'enquête
+ * Combine navigation, validation et gestion des instances
+ * RSU v2 - Package Partagé
+ */
+import { useState, useCallback, useEffect, useMemo } from 'react';
+import { useFormNavigation } from './useFormNavigation';
+import { useFormValidation } from './useFormValidation';
+import { useFormInstances } from './useFormInstances';
+/**
+ * Hook principal pour gérer un formulaire d'enquête
+ *
+ * @param formulaire - Le formulaire complet
+ * @param enquete - L'instance d'enquête (optionnel pour nouvelle enquête)
+ * @param options - Options de configuration
+ * @returns Objet contenant tout l'état et les fonctions nécessaires
+ *
+ * @example
+ * ```tsx
+ * const formRenderer = useFormRenderer(formulaire, enquete, {
+ *   config: { mode: 'admin', features: { saveDraft: true } },
+ *   onResponsesChange: (responses) => console.log('Changed:', responses)
+ * });
+ *
+ * // Utilisation
+ * const { navigation, validation, responses, updateResponse } = formRenderer;
+ * ```
+ */
+export function useFormRenderer(formulaire, enquete, options = { config: { mode: 'public' } }) {
+    const { config, initialResponses, onResponsesChange, onGroupChange, isVariableVisible: externalIsVariableVisible, debug = false } = options;
+    const mode = config.mode;
+    const features = config.features || {};
+    // === État de base ===
+    const [responses, setResponses] = useState(initialResponses || enquete?.reponses || {});
+    const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    // === Calcul du mode lecture seule ===
+    const isReadOnly = useMemo(() => {
+        if (!enquete)
+            return false;
+        // En mode admin, certains statuts empêchent la modification
+        if (mode === 'admin') {
+            return ['VALIDE_ENQUETEUR', 'VALIDE_DR', 'FINALISE'].includes(enquete.statut);
+        }
+        // En mode public, on utilise le flag isReadOnly de l'enquête
+        return enquete.isReadOnly || false;
+    }, [enquete, mode]);
+    const isConsultationMode = enquete?.isReadOnly || false;
+    const effectiveDisabled = isReadOnly || isConsultationMode;
+    // === Utilitaires ===
+    const isControlVariable = useCallback((variable) => {
+        return formulaire?.groupes?.some(groupe => groupe.estMultiple && groupe.codeVariable === variable.code) || false;
+    }, [formulaire?.groupes]);
+    const getResponseKey = useCallback((variableCode, numeroMembre) => {
+        return numeroMembre ? `${variableCode}_${numeroMembre}` : variableCode;
+    }, []);
+    const getResponseValue = useCallback((variableCode, numeroMembre) => {
+        const key = getResponseKey(variableCode, numeroMembre);
+        return responses[key]?.valeur ?? null;
+    }, [responses, getResponseKey]);
+    // === Hook de gestion des instances ===
+    const instances = useFormInstances(formulaire?.groupes || [], responses, {
+        debug,
+        onGroupesUpdated: (groupes) => {
+            if (debug) {
+                console.log('[FormRenderer] Groupes mis à jour:', groupes.length);
+            }
+        }
+    });
+    // === Hook de validation ===
+    const validation = useFormValidation({
+        isVariableVisible: externalIsVariableVisible || (() => true),
+        isControlVariable,
+        debug
+    });
+    // === Hook de navigation ===
+    const navigation = useFormNavigation(instances.groupesWithInstances.length > 0
+        ? instances.groupesWithInstances
+        : formulaire?.groupes || [], {
+        onGroupChange,
+        validateBeforeNavigation: () => {
+            // Valider le groupe actuel avant de naviguer
+            return validation.validateCurrentGroupRequiredFields(navigation.currentGroup, responses);
+        }
+    });
+    // === Groupe et instance actuels ===
+    const currentGroup = useMemo(() => {
+        return instances.groupesWithInstances[navigation.navigationState.groupeIndex]
+            || formulaire?.groupes?.[navigation.navigationState.groupeIndex];
+    }, [instances.groupesWithInstances, formulaire?.groupes, navigation.navigationState.groupeIndex]);
+    const currentInstance = useMemo(() => {
+        return currentGroup?.instances?.[navigation.navigationState.instanceIndex];
+    }, [currentGroup, navigation.navigationState.instanceIndex]);
+    // === Mise à jour des réponses ===
+    const updateResponse = useCallback((variableCode, value, variable, numeroMembre) => {
+        const responseKey = getResponseKey(variableCode, numeroMembre);
+        const newResponse = {
+            variableId: variable.id,
+            variableCode: variableCode,
+            valeur: value,
+            numeroMembre,
+            dateModification: new Date()
+        };
+        setResponses(prev => {
+            const updated = {
+                ...prev,
+                [responseKey]: newResponse
+            };
+            if (onResponsesChange) {
+                onResponsesChange(updated);
+            }
+            return updated;
+        });
+        // Mettre à jour l'instance si c'est un groupe multiple
+        if (currentGroup?.estMultiple && currentInstance) {
+            currentInstance.reponses[variableCode] = newResponse;
+            currentInstance.estComplete = instances.isInstanceComplete(currentInstance, currentGroup);
+        }
+        // Mettre à jour les propriétés des groupes affectés
+        const affectedGroups = instances.groupesWithInstances.filter(g => g.codeVariable === variableCode);
+        if (affectedGroups.length > 0) {
+            affectedGroups.forEach(groupe => {
+                instances.updateGroupeProperties(groupe, {
+                    ...responses,
+                    [responseKey]: newResponse
+                });
+            });
+        }
+        setHasUnsavedChanges(true);
+    }, [
+        getResponseKey,
+        currentGroup,
+        currentInstance,
+        instances,
+        responses,
+        onResponsesChange
+    ]);
+    // === Synchronisation initiale ===
+    useEffect(() => {
+        if (formulaire?.groupes?.length && Object.keys(responses).length > 0) {
+            const initialized = instances.initializeGroupesWithInstances(formulaire.groupes, responses);
+            instances.setGroupesWithInstances(initialized);
+        }
+    }, [formulaire?.groupes]);
+    return {
+        // Navigation
+        navigation,
+        // Validation
+        validation,
+        // Instances
+        instances,
+        // Réponses
+        responses,
+        updateResponse,
+        setResponses,
+        // État
+        hasUnsavedChanges,
+        setHasUnsavedChanges,
+        isSubmitting,
+        setIsSubmitting,
+        effectiveDisabled,
+        isConsultationMode,
+        isReadOnly,
+        // Configuration
+        mode,
+        features,
+        // Groupes
+        currentGroup,
+        currentInstance,
+        groupesWithInstances: instances.groupesWithInstances,
+        // Utilitaires
+        isControlVariable,
+        getResponseKey,
+        getResponseValue
+    };
+}
+export default useFormRenderer;

package/dist/hooks/useFormValidation.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Hook de validation pour les formulaires d'enquête
+ * Gère la validation des variables, groupes et instances
+ * RSU v2 - Package Partagé
+ */
+import { GroupeFormulaire, VariableFormulaire, EnqueteReponse, ValidationError, ValidationResult } from '../types/enquete';
+export interface UseFormValidationOptions {
+    /** Fonction pour vérifier si une variable est visible */
+    isVariableVisible?: (variable: VariableFormulaire) => boolean;
+    /** Fonction pour vérifier si une variable est de contrôle */
+    isControlVariable?: (variable: VariableFormulaire) => boolean;
+    /** Mode debug (affiche les logs de validation) */
+    debug?: boolean;
+}
+export interface UseFormValidationResult {
+    /** Valide une variable individuelle */
+    validateVariable: (variable: VariableFormulaire, allResponses: Record<string, EnqueteReponse>) => boolean;
+    /** Valide un groupe complet */
+    validateGroup: (groupe: GroupeFormulaire, allResponses: Record<string, EnqueteReponse>) => ValidationResult;
+    /** Valide les champs obligatoires du groupe actuel */
+    validateCurrentGroupRequiredFields: (currentGroup: GroupeFormulaire | undefined, responses: Record<string, EnqueteReponse>) => boolean;
+    /** Valide que toutes les instances d'un groupe multiple sont complètes */
+    validateAllInstancesComplete: (groupe: GroupeFormulaire) => boolean;
+    /** Valide tous les groupes du formulaire */
+    validateAllGroups: (groupes: GroupeFormulaire[], responses: Record<string, EnqueteReponse>) => ValidationResult;
+    /** Récupère les erreurs de validation pour un groupe */
+    getGroupValidationErrors: (groupe: GroupeFormulaire, responses: Record<string, EnqueteReponse>) => ValidationError[];
+}
+/**
+ * Hook pour gérer la validation dans un formulaire d'enquête
+ *
+ * @param options - Options de configuration
+ * @returns Objet contenant les fonctions de validation
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   validateVariable,
+ *   validateCurrentGroupRequiredFields,
+ *   validateAllGroups
+ * } = useFormValidation({
+ *   isVariableVisible: (v) => formTree.isVariableVisible(v.code),
+ *   isControlVariable: (v) => groupes.some(g => g.codeVariable === v.code),
+ *   debug: true
+ * });
+ * ```
+ */
+export declare function useFormValidation(options?: UseFormValidationOptions): UseFormValidationResult;
+export default useFormValidation;
+//# sourceMappingURL=useFormValidation.d.ts.map

package/dist/hooks/useFormValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormValidation.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormValidation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC9D,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC9D,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,OAAO,CAAC;IAC1G,+BAA+B;IAC/B,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,gBAAgB,CAAC;IAC5G,sDAAsD;IACtD,kCAAkC,EAAE,CAClC,YAAY,EAAE,gBAAgB,GAAG,SAAS,EAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KACtC,OAAO,CAAC;IACb,0EAA0E;IAC1E,4BAA4B,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;IACpE,4CAA4C;IAC5C,iBAAiB,EAAE,CACjB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KACtC,gBAAgB,CAAC;IACtB,wDAAwD;IACxD,wBAAwB,EAAE,CACxB,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KACtC,eAAe,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAyLzB;AAED,eAAe,iBAAiB,CAAC"}