<?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:----bwuYd0UuFhWcuHtAlUHm/B6h8KRffhhJKP+9eToRRkINHF5+xqkFPMhUWWpMi4nTTojYhg22s8s3uReRkD4MAwguv0UHbddatHtunOSdMTSWkr83LWRpjCqRF/fGo2tjXgAdpB9Sj6DgcH02AVLeIFZjLoZZKVpZ1NI2kssLbtspNMacA6tkTQGgyrPQL56A5l0zRzimI6U8WYDCHMHl/XgQU0xt2TWZY1dsfFfWKAOHZavIwA0EepVFGxlFrifx5XFD2hrihtejbwVMSxhrUzelWiLrfBbz4mmBhXe6z7Nj/ur+Vg9yPNXRrkMEg9Xq9mmZnwNtmfl65ey969NYhbFvJYJB+//GLtIGk+LtDq5Q+xGB5Wxr2Tn/Vo1BNH6gOvOit4b0ljHM7esBVzi63CQZ+RlJSw1uDpsEkx+R/2nOTRHQQt/0QamOv9kAgg+cPl+4WumDJMee7xVi0GXyFECuDd5ju+aRmB42Gx1Msnzm6IPGJfuXvXjPqmL+gVPPgD/1HXUfFOEAGCoe7FDR17Zmy5pofr74nks/qIAIPIEqcI0TD1m363bV6Yq+PAWUNTCJ/N+KeufsD8JydhYFOVXaebuQzAndtxQQoOG3sOcWaxxm5dxl0CA578hsicwkjs8oRJr0SmoEvx/ZLSLRh8CKBgXYtjNQaFJu9xs6hho=----ATTACHMENT:----MTIxNjA1MjY4MDI3OTEwMSA4NjU3MDg5OTE1ODAyMzE2IDcxNzQxOTI4MjI1OTY0MA==