<?php

declare(strict_types=1);

namespace Evomedien\EvoMegamenuJson\Event;

/**
 * Dispatched for every entry with the panel layout `catalog`.
 *
 * The extension stays project-neutral: it knows that a catalog panel exists,
 * not where its data comes from. A site package listens to this event and
 * supplies the data (categories, their groups and items, a search endpoint,
 * ...) as a plain array; it is emitted verbatim as `catalog` on the entry.
 * Without a listener the entry carries `catalog: null`.
 */
final class BuildCatalogEvent
{
    /** @var array<string,mixed>|null */
    private ?array $catalog = 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 getCatalog(): ?array
    {
        return $this->catalog;
    }

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