/******************************************************************************
 * @file application_message_dialog.h
 * @brief Fenêtre modale affichant un message à l'utilisateur.
 ******************************************************************************/

#ifndef LABFY_INVESTIGATION_APPLICATION_MESSAGE_DIALOG_H
#define LABFY_INVESTIGATION_APPLICATION_MESSAGE_DIALOG_H

#include <gtk/gtk.h>

/**
 * @brief Nature du message affiché.
 */
typedef enum
{
    APPLICATION_MESSAGE_DIALOG_ERROR,
    APPLICATION_MESSAGE_DIALOG_WARNING,
    APPLICATION_MESSAGE_DIALOG_INFORMATION
} ApplicationMessageDialogType;

/**
 * @brief Callback appelé à la fermeture d'un dialogue de confirmation.
 *
 * Le callback est appelé une seule fois après un clic sur l'un des boutons
 * ou après une fermeture manuelle de la fenêtre.
 *
 * @param confirmed TRUE si l'utilisateur confirme, sinon FALSE.
 * @param user_data Données empruntées fournies par l'appelant.
 */
typedef void (*ApplicationMessageDialogConfirmationCallback)(
    gboolean confirmed,
    gpointer user_data
);

/**
 * @brief Affiche une fenêtre modale contenant un message.
 *
 * Les chaînes sont copiées par les widgets GTK.
 *
 * @param parent_window Fenêtre parente, ou NULL.
 * @param message_type Type de message.
 * @param title Titre de la fenêtre, ou NULL.
 * @param message Message principal, ou NULL.
 */
void application_message_dialog_present(
    GtkWindow *parent_window,
    ApplicationMessageDialogType message_type,
    const char *title,
    const char *message
);

/**
 * @brief Affiche un dialogue modal demandant une confirmation.
 *
 * Le bouton d'annulation transmet FALSE. Le bouton de confirmation transmet
 * TRUE. Fermer la fenêtre manuellement équivaut à une annulation.
 *
 * callback et user_data sont empruntés jusqu'à la fermeture du dialogue.
 * confirm_label peut être NULL ou vide pour utiliser « Confirmer ».
 *
 * @param parent_window Fenêtre parente, ou NULL.
 * @param message_type Type de message.
 * @param title Titre de la fenêtre, ou NULL.
 * @param message Message principal, ou NULL.
 * @param confirm_label Libellé du bouton de confirmation, ou NULL.
 * @param callback Callback facultatif recevant la réponse.
 * @param user_data Données empruntées transmises au callback.
 */
void application_message_dialog_present_confirmation(
    GtkWindow *parent_window,
    ApplicationMessageDialogType message_type,
    const char *title,
    const char *message,
    const char *confirm_label,
    ApplicationMessageDialogConfirmationCallback callback,
    gpointer user_data
);

#endif