roi-theme/Shared/Infrastructure/Services/PageVisibilityHelper.php

<?php
declare(strict_types=1);

namespace ROITheme\Shared\Infrastructure\Services;

use ROITheme\Shared\Infrastructure\Di\DIContainer;

/**
 * Facade/Helper para evaluar visibilidad de componentes
 *
 * PROPÓSITO:
 * Permite que los Renderers existentes evalúen visibilidad sin modificar sus constructores.
 * Actúa como un Service Locator limitado a este único propósito.
 *
 * USO EN RENDERERS:
 * ```php
 * if (!PageVisibilityHelper::shouldShow('cta-box-sidebar')) {
 *     return '';
 * }
 * ```
 *
 * @package ROITheme\Shared\Infrastructure\Services
 */
final class PageVisibilityHelper
{
    /**
     * Evalúa si un componente debe mostrarse en la página actual
     *
     * @param string $componentName Nombre del componente (kebab-case)
     * @return bool True si debe mostrarse
     */
    public static function shouldShow(string $componentName): bool
    {
        $container = DIContainer::getInstance();
        $useCase = $container->getEvaluatePageVisibilityUseCase();

        return $useCase->execute($componentName);
    }
}