<?php
declare(strict_types=1);

namespace ROITheme\Shared\Domain\Contracts;

use ROITheme\Shared\Domain\Entities\Component;

/**
 * RendererInterface - Contrato para renderizadores de componentes
 *
 * RESPONSABILIDAD: Definir el contrato que deben cumplir todos los renderizadores
 * de componentes para generar HTML a partir de los datos del componente.
 *
 * PRINCIPIOS:
 * - Interface Segregation: Una sola responsabilidad - renderizar HTML
 * - Dependency Inversion: Depender de abstracción, no de implementación
 *
 * USO:
 * ```php
 * final class MyRenderer implements RendererInterface
 * {
 *     public function render(Component $component): string
 *     {
 *         $data = $component->getData();
 *         // Generar HTML
 *         return $html;
 *     }
 *
 *     public function supports(string $componentType): bool
 *     {
 *         return $componentType === 'my-component';
 *     }
 * }
 * ```
 *
 * @package ROITheme\Domain\Component
 */
interface RendererInterface
{
    /**
     * Renderizar un componente a HTML
     *
     * @param Component $component Componente a renderizar
     * @return string HTML generado
     */
    public function render(Component $component): string;

    /**
     * Verificar si este renderizador soporta un tipo de componente
     *
     * @param string $componentType Tipo de componente (ej: 'navbar', 'footer')
     * @return bool True si soporta el tipo, false en caso contrario
     */
    public function supports(string $componentType): bool;
}