<?php

declare(strict_types=1);

namespace Evomedien\EvoMegamenuJson\Event;

/**
 * Dispatched for every entry with the panel layout `spotlight`.
 *
 * Same contract idea as BuildCatalogEvent: the extension knows that a
 * spotlight panel exists (left-rail nav from the linked page's children,
 * visual card area on the right), not where the cards come from. A site
 * package listens and supplies the card sections (latest news, upcoming
 * events, ...) as a plain array; it is emitted verbatim as `spotlight` on
 * the entry. Without a listener the entry carries `spotlight: null` and the
 * front end falls back to the nav items' own images.
 */
final class BuildSpotlightEvent
{
    /** @var array<string,mixed>|null */
    private ?array $spotlight = null;

    /**
     * @param array<string,mixed> $entry the raw tx_evomegamenujson_entry row
     */
    public function __construct(
        private readonly array $entry,
        private readonly int $stage,
    ) {}

    /** @return array<string,mixed> */
    public function getEntry(): array
    {
        return $this->entry;
    }

    /** Content stage of the menu (1 structure, 2 + images/teasers, 3 + featured). */
    public function getStage(): int
    {
        return $this->stage;
    }

    /** @return array<string,mixed>|null */
    public function getSpotlight(): ?array
    {
        return $this->spotlight;
    }

    /** @param array<string,mixed> $spotlight */
    public function setSpotlight(array $spotlight): void
    {
        $this->spotlight = $spotlight;
    }
}