<?php

declare(strict_types=1);

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

namespace TYPO3\CMS\ContentBlocks\Definition\Capability;

/**
 * @internal Not part of TYPO3's public API.
 */
final class LabelCapability
{
    /**
     * @var string|string[]
     */
    private string|array $labelField = '';
    private array $fallbackLabelFields = [];

    public static function createFromArray(array $definition): LabelCapability
    {
        $self = new self();
        $labelField = $definition['labelField'] ?? null;
        if (
            isset($labelField)
            && (
                is_array($labelField) || is_string($labelField)
            )
        ) {
            $self->labelField = $labelField;
        }
        $self->fallbackLabelFields = $definition['fallbackLabelFields'] ?? $self->fallbackLabelFields;
        return $self;
    }

    public function hasLabelField(): bool
    {
        if (is_string($this->labelField)) {
            return $this->labelField !== '';
        }
        return array_key_exists(0, $this->labelField);
    }

    public function getPrimaryLabelField(): string
    {
        if (is_array($this->labelField)) {
            return $this->labelField[0];
        }
        return $this->labelField;
    }

    public function getLabelFieldsAsArray(): array
    {
        if (is_array($this->labelField)) {
            return $this->labelField;
        }
        $primaryField = $this->getPrimaryLabelField();
        return [$primaryField];
    }

    public function hasAdditionalLabelFields(): bool
    {
        return is_array($this->labelField) && count($this->labelField) > 1;
    }

    public function getAdditionalLabelFieldsAsString(): string
    {
        if (!$this->hasAdditionalLabelFields()) {
            return '';
        }
        $additionalLabelFields = array_slice($this->labelField, 1);
        $additionalLabelFieldsAsString = implode(',', $additionalLabelFields);
        return $additionalLabelFieldsAsString;
    }

    public function hasFallbackLabelFields(): bool
    {
        if ($this->hasAdditionalLabelFields()) {
            return false;
        }
        return $this->fallbackLabelFields !== [];
    }

    public function getFallbackLabelFieldsAsString(): string
    {
        if (!$this->hasFallbackLabelFields()) {
            return '';
        }
        $fallbackLabelFieldsAsString = implode(',', $this->fallbackLabelFields);
        return $fallbackLabelFieldsAsString;
    }

    public function getFallbackLabelFields(): array
    {
        return $this->fallbackLabelFields;
    }
}