<?php

declare(strict_types=1);

namespace App\Services;

use HTMLPurifier;
use HTMLPurifier_Config;

/**
 * Factory pour créer et configurer une instance HTMLPurifier.
 * Centralise toute la logique de configuration.
 */
final class HtmlPurifierFactory
{
    /**
     * Crée une instance HTMLPurifier préconfigurée.
     *
     * @param string $cacheDir Répertoire de cache pour HTMLPurifier
     * @return HTMLPurifier
     */
    public static function create(string $cacheDir): HTMLPurifier
    {
        // Créer le répertoire de cache s'il n'existe pas
        if (!is_dir($cacheDir)) {
            @mkdir($cacheDir, 0755, true);
        }

        // Créer et configurer HTMLPurifier
        $config = HTMLPurifier_Config::createDefault();

        // Balises HTML autorisées
        $config->set('HTML.Allowed', 'p,br,strong,em,u,h1,h2,h3,h4,h5,h6,ul,ol,li,blockquote,a[href],img[src|alt|width|height]');

        // Attributs autorisés
        $config->set('HTML.AllowedAttributes', 'href,src,alt,width,height,title');

        // Configuration du cache
        $config->set('Cache.DefinitionImpl', 'Serializer');
        $config->set('Cache.SerializerPath', $cacheDir);

        return new HTMLPurifier($config);
    }
}