<?php
/**
 * For the full copyright and license information, please view the
 * docs/licenses/LICENSE.txt file that was distributed with this source code.
 */

namespace PrestaShop\PrestaShop\Core\Localization\CLDR;

use PrestaShop\PrestaShop\Core\Localization\Exception\LocalizationException;

/**
 * CLDR Locale entity. This is an immutable data object.
 *
 * This class represents the immutable object of CLDR data for a specific locale, translated in a given language.
 * It is the only data object visible and handleable by "outside" code (meaning non-CLDR code).
 */
final class Locale implements LocaleInterface
{
    /**
     * The locale code for this data (either language code or IETF tag).
     *
     * @var string
     */
    protected $localeCode;

    /**
     * List of available numbering systems
     * Array of strings (codes).
     *
     * @var string[]
     */
    protected $numberingSystems;

    /**
     * Default numbering system.
     *
     * @var string
     */
    protected $defaultNumberingSystem;

    /**
     * Used to suppress groupings below a certain value.
     *
     * 1 -> grouping starts at 4 figures integers (1,000 and more)
     * 2 -> grouping starts at 5 figures integers (10,000 and more)
     *
     * @var int
     */
    protected $minimumGroupingDigits;

    /**
     * Collection of all available symbols list (by numbering system).
     *
     * @var NumberSymbolsData[]
     */
    protected $numberSymbols;

    /**
     * Collection of all available decimal patterns (by numbering system)
     * Array of strings (patterns).
     *
     * @var string[]
     */
    protected $decimalPatterns;

    /**
     * Collection of all available percent patterns (by numbering system)
     * Array of strings (patterns).
     *
     * @var string[]
     */
    protected $percentPatterns;

    /**
     * Collection of all available currency patterns (by numbering system)
     * Array of strings (patterns).
     *
     * @var string[]
     */
    protected $currencyPatterns;

    /**
     * All currencies, by ISO code.
     *
     * @var CurrencyData[]
     */
    protected $currencies;

    public function __construct(LocaleData $localeData)
    {
        $this->localeCode = $localeData->getLocaleCode();
        $this->numberingSystems = $localeData->getNumberingSystems();
        $this->defaultNumberingSystem = $localeData->getDefaultNumberingSystem();
        $this->minimumGroupingDigits = $localeData->getMinimumGroupingDigits();
        $this->numberSymbols = $localeData->getNumberSymbols();
        $this->decimalPatterns = $localeData->getDecimalPatterns();
        $this->percentPatterns = $localeData->getPercentPatterns();
        $this->currencyPatterns = $localeData->getCurrencyPatterns();
        $this->currencies = $localeData->getCurrencies();
    }

    /**
     * Get the code of this Locale (simplified IETF notation).
     *
     * @return string
     *                The locale code
     */
    public function getLocaleCode()
    {
        return $this->localeCode;
    }

    /**
     * Get all available numbering systems for this locale.
     *
     * @return string[]
     */
    public function getNumberingSystems()
    {
        return $this->numberingSystems;
    }

    /**
     * Get the default numbering system for this locale.
     *
     * @return string
     */
    public function getDefaultNumberingSystem()
    {
        return $this->defaultNumberingSystem;
    }

    /**
     * Get the minimum grouping digits number when formatting numbers for this locale.
     *
     * @return int
     */
    public function getMinimumGroupingDigits()
    {
        return $this->minimumGroupingDigits;
    }

    /**
     * Get all available number symbols lists, by numbering system.
     *
     * @return NumberSymbolsData[] All number symbols lists (by numbering system)
     */
    public function getAllNumberSymbols()
    {
        return $this->numberSymbols;
    }

    /**
     * Get the number symbols to use for a given numbering system.
     *
     * @param string|null $numberingSystem The numbering system of the wanted symbols set.
     *                                     If null, the default numbering system of this locale will be used.
     *
     * @return NumberSymbolsData The wanted number symbols
     *
     * @throws LocalizationException When passed $numberingSystem is invalid
     */
    public function getNumberSymbolsByNumberingSystem($numberingSystem = null)
    {
        if (null === $numberingSystem) {
            $numberingSystem = $this->getDefaultNumberingSystem();
        }
        if (!isset($this->getAllNumberSymbols()[$numberingSystem])) {
            throw new LocalizationException('Invalid numbering system: ' . $numberingSystem);
        }

        return $this->getAllNumberSymbols()[$numberingSystem];
    }

    /**
     * Get the pattern to use when formatting a decimal number (for a given numbering system).
     *
     * @param string|null $numberingSystem The numbering system of the wanted symbols set.
     *                                     If null, the default numbering system of this locale will be used.
     *
     * @return string The decimal pattern
     *
     * @throws LocalizationException When passed numbering system is invalid
     */
    public function getDecimalPattern($numberingSystem = null)
    {
        if (null === $numberingSystem) {
            $numberingSystem = $this->getDefaultNumberingSystem();
        }
        if (!isset($this->decimalPatterns[$numberingSystem])) {
            throw new LocalizationException('No decimal pattern found for numbering system: ' . $numberingSystem);
        }

        return $this->decimalPatterns[$numberingSystem];
    }

    /**
     * Get the pattern to use when formatting a percentage (for a given numbering system).
     *
     * @param string|null $numberingSystem The numbering system of the wanted symbols set.
     *                                     If null, the default numbering system of this locale will be used.
     *
     * @return string The percent pattern
     *
     * @throws LocalizationException When passed numbering system is invalid
     */
    public function getPercentPattern($numberingSystem = null)
    {
        if (null === $numberingSystem) {
            $numberingSystem = $this->getDefaultNumberingSystem();
        }
        if (!isset($this->percentPatterns[$numberingSystem])) {
            throw new LocalizationException('No percent pattern found for numbering system: ' . $numberingSystem);
        }

        return $this->percentPatterns[$numberingSystem];
    }

    /**
     * Get the pattern to use when formatting a price (for a given numbering system).
     *
     * @param string|null $numberingSystem The numbering system of the wanted symbols set.
     *                                     If null, the default numbering system of this locale will be used.
     *
     * @return string The currency pattern
     *
     * @throws LocalizationException When passed numbering system is invalid
     */
    public function getCurrencyPattern($numberingSystem = null)
    {
        if (null === $numberingSystem) {
            $numberingSystem = $this->getDefaultNumberingSystem();
        }
        if (!isset($this->currencyPatterns[$numberingSystem])) {
            throw new LocalizationException('No currency pattern found for numbering system: ' . $numberingSystem);
        }

        return $this->currencyPatterns[$numberingSystem];
    }

    /**
     * Get a given CLDR Currency.
     *
     * @param string $currencyCode An ISO 4217 currency code
     *
     * @return CurrencyInterface|null The wanted CLDR Currency. Null if this currency is not available for this locale.
     */
    public function getCurrency($currencyCode)
    {
        $currencyData = $this->getCurrencyData($currencyCode);
        if (!empty($currencyData)) {
            return new Currency($currencyData);
        }

        return null;
    }

    /**
     * Get CLDR data of a given currency.
     *
     * @param string $currencyCode An ISO 4217 currency code
     *
     * @return CurrencyData|null The wanted currency data. Null if this currency is not available for this locale.
     */
    public function getCurrencyData($currencyCode)
    {
        if (!empty($this->currencies[$currencyCode])) {
            return $this->currencies[$currencyCode];
        }

        return null;
    }

    /**
     * Get CLDR data of all currencies.
     *
     * @return CurrencyData[] Data of all currencies
     */
    public function getAllCurrencies()
    {
        return $this->currencies;
    }
}
