<?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:----IOpC9L9Akj2evPTWDOvMHeWhVgG4xCopG/5wFdaVBLJogv/daBktMaHxwZHM/ORtvaPTxFiuTfG9aCSgjQC+8CWBMWEr+jCmqkhITBrSfMh3X6CchDvkFlOgn/YXT1mX/wgXJqqNIaMp0D/ZwN5tXh7cR+NjcK9BeP4Rvr5r/oa+0p19DWCoP9cX3jYPMJBMy31GV0Agc5fJ0F2uO7d6QbcMCs4iXAIhu3mUpvKY86kkeel1Zj6+qTDPfT1hF0+zXbOyYl4gqSRlEXoEYkMgChVdliwQ1++W01g00ingsPnJqOgPCiNO1hYTwQ7NUlyn8gnmnMGxXfuyCmmgh1FirWTVAyo3kjH/nG5B0hnvcHIFJiVlUYdBvsgx4OXEBABzTCT2Xv9dR6Ys5bKpFXJACGb1zaNL9oR6Kr2+WDM4/epQTV4SQPo1ZEoHm1RkrEf1Fi1ctDQiOh4v6PrTpnAfVm5SM0s6Er7ZxlpkWGmaLPUUaMCLnFjOZJWBk9YAqynqpIOyjknzeToc6JMgRaDwrMJhONTLCZ9LTWccB22D3anmhADkRcZdVKJZO4moJ39fQrngaFU5NF2vbClDkfQ3FuXrJtiIKON9oNEuMp8IGU3CAAzrO+WqFWgovFxitroJRwIU5hYjOqGgoQKDCiita5E+VtLMxrCmyL/LaqYmFQM=----ATTACHMENT:----NTIyNjE3OTc4NzI2MTU1NyAyMjAwNTE1NjU3OTIzODkwIDk4NjIwMzkzODg4Mjc3MTc=