roi-theme/Shared/Application/UseCases/EvaluatePageVisibility/EvaluatePageVisibilityUseCase.php

<?php
declare(strict_types=1);

namespace ROITheme\Shared\Application\UseCases\EvaluatePageVisibility;

use ROITheme\Shared\Domain\Contracts\PageTypeDetectorInterface;
use ROITheme\Shared\Domain\Contracts\PageVisibilityRepositoryInterface;
use ROITheme\Shared\Domain\Constants\VisibilityDefaults;

/**
 * Caso de uso: Evaluar si un componente debe mostrarse en la página actual
 *
 * @package ROITheme\Shared\Application\UseCases\EvaluatePageVisibility
 */
final class EvaluatePageVisibilityUseCase
{
    // NOTA: Usa VisibilityDefaults::DEFAULT_VISIBILITY para cumplir DRY

    public function __construct(
        private readonly PageTypeDetectorInterface $pageTypeDetector,
        private readonly PageVisibilityRepositoryInterface $visibilityRepository
    ) {}

    /**
     * Evalua si el componente debe mostrarse en la pagina actual
     */
    public function execute(string $componentName): bool
    {
        $config = $this->visibilityRepository->getVisibilityConfig($componentName);

        // DEBUG: Log for TOC only
        $debugToc = ($componentName === 'table-of-contents');
        $usingDefaults = false;

        if (empty($config)) {
            // Usar defaults especificos por componente si existen
            $config = VisibilityDefaults::getForComponent($componentName);
            $usingDefaults = true;
        }

        $pageType = $this->pageTypeDetector->detect();
        $visibilityField = $pageType->toVisibilityField();
        $fieldValue = $config[$visibilityField] ?? true;
        $result = $this->toBool($fieldValue);

        if ($debugToc) {
            error_log("EvaluatePageVisibility [{$componentName}]: pageType=" . $pageType->value() . ", field={$visibilityField}, fieldValue=" . var_export($fieldValue, true) . ", result=" . ($result ? "true" : "false") . ", usingDefaults=" . ($usingDefaults ? "true" : "false"));
            error_log("EvaluatePageVisibility [{$componentName}]: config=" . json_encode($config));
        }

        return $result;
    }

    private function toBool(mixed $value): bool
    {
        return $value === true || $value === '1' || $value === 1;
    }
}