TenantAtlas/app/Support/Ui/ActionSurface/ActionSurfaceDeclaration.php

<?php

declare(strict_types=1);

namespace App\Support\Ui\ActionSurface;

use App\Support\Ui\ActionSurface\Enums\ActionSurfaceComponentType;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceProfile;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;

final class ActionSurfaceDeclaration
{
    private const string LIST_ROW_PRIMARY_ACTION_LIMIT = 'list_row_primary_action_limit';

    /**
     * @var array<string, ActionSurfaceSlotRequirement>
     */
    private array $slots = [];

    /**
     * @var array<string, ActionSurfaceExemption>
     */
    private array $exemptions = [];

    /**
     * @var array<string, mixed>
     */
    private array $metadata = [];

    public ActionSurfaceDefaults $defaults;

    public function __construct(
        public readonly int $version,
        public readonly ActionSurfaceComponentType $componentType,
        public readonly ActionSurfaceProfile $profile,
        ?ActionSurfaceDefaults $defaults = null,
    ) {
        $this->defaults = $defaults ?? new ActionSurfaceDefaults;
    }

    public static function make(
        ActionSurfaceComponentType $componentType,
        ActionSurfaceProfile $profile,
        int $version = 1,
    ): self {
        return new self(
            version: $version,
            componentType: $componentType,
            profile: $profile,
        );
    }

    public static function forResource(ActionSurfaceProfile $profile, int $version = 1): self
    {
        return self::make(ActionSurfaceComponentType::Resource, $profile, $version);
    }

    public static function forPage(ActionSurfaceProfile $profile, int $version = 1): self
    {
        return self::make(ActionSurfaceComponentType::Page, $profile, $version);
    }

    public static function forRelationManager(ActionSurfaceProfile $profile, int $version = 1): self
    {
        return self::make(ActionSurfaceComponentType::RelationManager, $profile, $version);
    }

    public function withDefaults(ActionSurfaceDefaults $defaults): self
    {
        $this->defaults = $defaults;

        return $this;
    }

    public function setSlot(ActionSurfaceSlot $slot, ActionSurfaceSlotRequirement $requirement): self
    {
        $this->slots[$slot->value] = $requirement;

        return $this;
    }

    public function satisfy(
        ActionSurfaceSlot $slot,
        ?string $details = null,
        bool $requiresTypedConfirmation = false,
    ): self {
        return $this->setSlot($slot, ActionSurfaceSlotRequirement::satisfied($details, $requiresTypedConfirmation));
    }

    public function exempt(
        ActionSurfaceSlot $slot,
        string $reason,
        ?string $trackingRef = null,
        ?string $details = null,
    ): self {
        $this->setSlot($slot, ActionSurfaceSlotRequirement::exempt($details));
        $this->exemptions[$slot->value] = new ActionSurfaceExemption($slot, $reason, $trackingRef);

        return $this;
    }

    public function slot(ActionSurfaceSlot $slot): ?ActionSurfaceSlotRequirement
    {
        return $this->slots[$slot->value] ?? null;
    }

    public function exemption(ActionSurfaceSlot $slot): ?ActionSurfaceExemption
    {
        return $this->exemptions[$slot->value] ?? null;
    }

    public function setMetadata(string $key, mixed $value): self
    {
        $this->metadata[$key] = $value;

        return $this;
    }

    public function metadata(string $key, mixed $default = null): mixed
    {
        return $this->metadata[$key] ?? $default;
    }

    public function withListRowPrimaryActionLimit(int $limit): self
    {
        return $this->setMetadata(self::LIST_ROW_PRIMARY_ACTION_LIMIT, $limit);
    }

    public function listRowPrimaryActionLimit(): ?int
    {
        $limit = $this->metadata(self::LIST_ROW_PRIMARY_ACTION_LIMIT);

        return is_int($limit) ? $limit : null;
    }

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

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

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