TenantAtlas/app/Support/Ui/EnterpriseDetail/EnterpriseDetailBuilder.php

<?php

declare(strict_types=1);

namespace App\Support\Ui\EnterpriseDetail;

use LogicException;

final class EnterpriseDetailBuilder
{
    private ?SummaryHeaderData $header = null;

    /**
     * @var list<DetailSectionData>
     */
    private array $mainSections = [];

    /**
     * @var list<SupportingCardData>
     */
    private array $supportingCards = [];

    /**
     * @var list<TechnicalDetailData>
     */
    private array $technicalSections = [];

    /**
     * @var list<array{title: string, description?: ?string, icon?: ?string}>
     */
    private array $emptyStateNotes = [];

    public function __construct(
        private readonly string $resourceType,
        private readonly string $scope,
    ) {}

    public static function make(string $resourceType, string $scope): self
    {
        return new self($resourceType, $scope);
    }

    public function header(SummaryHeaderData $header): self
    {
        $this->header = $header;

        return $this;
    }

    public function addSection(DetailSectionData ...$sections): self
    {
        foreach ($sections as $section) {
            $this->mainSections[] = $section;
        }

        return $this;
    }

    public function addSupportingCard(SupportingCardData ...$cards): self
    {
        foreach ($cards as $card) {
            $this->supportingCards[] = $card;
        }

        return $this;
    }

    public function addTechnicalSection(TechnicalDetailData ...$sections): self
    {
        foreach ($sections as $section) {
            $this->technicalSections[] = $section;
        }

        return $this;
    }

    /**
     * @param  list<array{title: string, description?: ?string, icon?: ?string}>  $notes
     */
    public function emptyStateNotes(array $notes): self
    {
        $this->emptyStateNotes = $notes;

        return $this;
    }

    public function build(): EnterpriseDetailPageData
    {
        if (! $this->header instanceof SummaryHeaderData) {
            throw new LogicException('Enterprise detail pages require a summary header.');
        }

        return new EnterpriseDetailPageData(
            resourceType: $this->resourceType,
            scope: $this->scope,
            header: $this->header,
            mainSections: array_values(array_filter(
                $this->mainSections,
                static fn (DetailSectionData $section): bool => $section->shouldRender(),
            )),
            supportingCards: array_values(array_filter(
                $this->supportingCards,
                static fn (SupportingCardData $card): bool => $card->shouldRender(),
            )),
            technicalSections: array_values(array_filter(
                $this->technicalSections,
                static fn (TechnicalDetailData $section): bool => $section->shouldRender(),
            )),
            emptyStateNotes: $this->emptyStateNotes,
        );
    }
}