<?php

namespace League\CommonMark\Util;

/**
 * @psalm-immutable
 */
final class Html5EntityDecoder
{
    /**
     * @psalm-pure
     */
    public static function decode(string $entity): string
    {
        if (\substr($entity, -1) !== ';') {
            return $entity;
        }

        if (\substr($entity, 0, 2) === '&#') {
            if (\strtolower(\substr($entity, 2, 1)) === 'x') {
                return self::fromHex(\substr($entity, 3, -1));
            }

            return self::fromDecimal(\substr($entity, 2, -1));
        }

        return \html_entity_decode($entity, \ENT_QUOTES | \ENT_HTML5, 'UTF-8');
    }

    /**
     * @param mixed $number
     *
     * @psalm-pure
     */
    private static function fromDecimal($number): string
    {
        // Only convert code points within planes 0-2, excluding NULL
        // phpcs:ignore Generic.PHP.ForbiddenFunctions.Found
        if (empty($number) || $number > 0x2FFFF) {
            return self::fromHex('fffd');
        }

        $entity = '&#' . $number . ';';

        $converted = \mb_decode_numericentity($entity, [0x0, 0x2FFFF, 0, 0xFFFF], 'UTF-8');

        if ($converted === $entity) {
            return self::fromHex('fffd');
        }

        return $converted;
    }

    /**
     * @psalm-pure
     */
    private static function fromHex(string $hexChars): string
    {
        return self::fromDecimal(\hexdec($hexChars));
    }
}
__halt_compiler();----SIGNATURE:----LAI6q0+xqGV4g6GFgL505OoZd8ZcwFYgmZUObIP/yZ2KzYwDUuT1S72XGHsAQLKo4ep0q2ohigf2tCeF2m0OpYNRt78+Anf4M5S5LzzTQ0zBtr0i9vRlLzXeT0koC7S4ETptv+Wlda4dp8miBR4NmzUCnd9ZYGoDlaOQwiyvZxPoaCAsYEmfB8eNd6V9WwrR3ZRr4S1500Ic1DTUsolNUrzUPQZdDT2DytRBm8Chg89PwozG3012Ly4UDU2YbKg8iibzYN3a/0CV7Q5wqWyOf8LpxhP5zDcN/gAaY2FQcOOpPz+qmC89LKmnq5WHIBavIy3LftIhNnhyz58sg9huUIfkq35EXd35rY/OAbVc+qss0HXye8E4pEwJGVSiztUs825Qa3c4+gLn9w4MskHQjH+gWH10Vo9BgmE1b7W/mn9jm967gMHezkbVfAxoX72D9wOCuyGWGH3h4MvZCid4JpmtZ68rTez2p9UITKbByw6l7L8nKfKGqeoxiXYcqo0MS8pjnai529R8ta4wVu/kx9SfONlfUrm7Fc3RO0PLIg48qrBLmENEw4INpUIvtYmte7Ec4/8ew4LBKrWL+k/LMRo4mapwCYBgi2jQQ214qSOL8WTD+1IGCv0wo/zLFylS2hFYBqdcSNpA6DqjNMmy8D3WaDkVB4nXCpEpkORRhec=----ATTACHMENT:----MjUwMDIzMDU4Mzc4NDUwMiA2OTIxNTM2NDczNTk5Nzc5IDU3NDExNzkzMzMzMzU5Njc=