@averay/codeformat 0.2.1 → 0.2.2

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/Phpdoc/PhpdocNoAliasTagFixer.php

@@ -0,0 +1,137 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of PHP CS Fixer.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace PhpCsFixer\Fixer\Phpdoc;
+
+use PhpCsFixer\AbstractProxyFixer;
+use PhpCsFixer\ConfigurationException\InvalidConfigurationException;
+use PhpCsFixer\ConfigurationException\InvalidFixerConfigurationException;
+use PhpCsFixer\Fixer\ConfigurableFixerInterface;
+use PhpCsFixer\Fixer\ConfigurableFixerTrait;
+use PhpCsFixer\FixerConfiguration\FixerConfigurationResolver;
+use PhpCsFixer\FixerConfiguration\FixerConfigurationResolverInterface;
+use PhpCsFixer\FixerConfiguration\FixerOptionBuilder;
+use PhpCsFixer\FixerDefinition\CodeSample;
+use PhpCsFixer\FixerDefinition\FixerDefinition;
+use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
+use PhpCsFixer\Preg;
+
+/**
+ * Case-sensitive tag replace fixer (does not process inline tags like {@inheritdoc}).
+ *
+ * @author Graham Campbell <hello@gjcampbell.co.uk>
+ * @author Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * @implements ConfigurableFixerInterface<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration>
+ *
+ * @phpstan-type _AutogeneratedInputConfiguration array{
+ *  replacements?: array<string, string>,
+ * }
+ * @phpstan-type _AutogeneratedComputedConfiguration array{
+ *  replacements: array<string, string>,
+ * }
+ */
+final class PhpdocNoAliasTagFixer extends AbstractProxyFixer implements ConfigurableFixerInterface
+{
+    /** @use ConfigurableFixerTrait<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration> */
+    use ConfigurableFixerTrait;
+
+    public function getDefinition(): FixerDefinitionInterface
+    {
+        return new FixerDefinition(
+            'No alias PHPDoc tags should be used.',
+            [
+                new CodeSample(
+                    '<?php
+/**
+ * @property string $foo
+ * @property-read string $bar
+ *
+ * @link baz
+ */
+final class Example
+{
+}
+'
+                ),
+                new CodeSample(
+                    '<?php
+/**
+ * @property string $foo
+ * @property-read string $bar
+ *
+ * @link baz
+ */
+final class Example
+{
+}
+',
+                    ['replacements' => ['link' => 'website']]
+                ),
+            ]
+        );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Must run before PhpdocAddMissingParamAnnotationFixer, PhpdocAlignFixer, PhpdocSingleLineVarSpacingFixer.
+     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer.
+     */
+    public function getPriority(): int
+    {
+        return parent::getPriority();
+    }
+
+    protected function configurePostNormalisation(): void
+    {
+        /** @var GeneralPhpdocTagRenameFixer $generalPhpdocTagRenameFixer */
+        $generalPhpdocTagRenameFixer = $this->proxyFixers['general_phpdoc_tag_rename'];
+
+        try {
+            $generalPhpdocTagRenameFixer->configure([
+                'fix_annotation' => true,
+                'fix_inline' => false,
+                'replacements' => $this->configuration['replacements'],
+                'case_sensitive' => true,
+            ]);
+        } catch (InvalidConfigurationException $exception) {
+            throw new InvalidFixerConfigurationException(
+                $this->getName(),
+                Preg::replace('/^\[.+?\] /', '', $exception->getMessage()),
+                $exception
+            );
+        }
+    }
+
+    protected function createConfigurationDefinition(): FixerConfigurationResolverInterface
+    {
+        return new FixerConfigurationResolver([
+            (new FixerOptionBuilder('replacements', 'Mapping between replaced annotations with new ones.'))
+                ->setAllowedTypes(['array<string, string>'])
+                ->setDefault([
+                    'property-read' => 'property',
+                    'property-write' => 'property',
+                    'type' => 'var',
+                    'link' => 'see',
+                ])
+                ->getOption(),
+        ]);
+    }
+
+    protected function createProxyFixers(): array
+    {
+        return [new GeneralPhpdocTagRenameFixer()];
+    }
+}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/Phpdoc/PhpdocNoEmptyReturnFixer.php

@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of PHP CS Fixer.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace PhpCsFixer\Fixer\Phpdoc;
+
+use PhpCsFixer\AbstractFixer;
+use PhpCsFixer\DocBlock\Annotation;
+use PhpCsFixer\DocBlock\DocBlock;
+use PhpCsFixer\FixerDefinition\CodeSample;
+use PhpCsFixer\FixerDefinition\FixerDefinition;
+use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
+use PhpCsFixer\Tokenizer\Token;
+use PhpCsFixer\Tokenizer\Tokens;
+
+/**
+ * @author Graham Campbell <hello@gjcampbell.co.uk>
+ */
+final class PhpdocNoEmptyReturnFixer extends AbstractFixer
+{
+    public function isCandidate(Tokens $tokens): bool
+    {
+        return $tokens->isTokenKindFound(T_DOC_COMMENT);
+    }
+
+    public function getDefinition(): FixerDefinitionInterface
+    {
+        return new FixerDefinition(
+            '`@return void` and `@return null` annotations must be removed from PHPDoc.',
+            [
+                new CodeSample(
+                    '<?php
+/**
+ * @return null
+*/
+function foo() {}
+'
+                ),
+                new CodeSample(
+                    '<?php
+/**
+ * @return void
+*/
+function foo() {}
+'
+                ),
+            ]
+        );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Must run before NoEmptyPhpdocFixer, PhpdocAlignFixer, PhpdocOrderFixer, PhpdocSeparationFixer, PhpdocTrimFixer.
+     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer, VoidReturnFixer.
+     */
+    public function getPriority(): int
+    {
+        return 4;
+    }
+
+    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
+    {
+        foreach ($tokens as $index => $token) {
+            if (!$token->isGivenKind(T_DOC_COMMENT)) {
+                continue;
+            }
+
+            $doc = new DocBlock($token->getContent());
+            $annotations = $doc->getAnnotationsOfType('return');
+
+            if (0 === \count($annotations)) {
+                continue;
+            }
+
+            foreach ($annotations as $annotation) {
+                $this->fixAnnotation($annotation);
+            }
+
+            $newContent = $doc->getContent();
+
+            if ($newContent === $token->getContent()) {
+                continue;
+            }
+
+            if ('' === $newContent) {
+                $tokens->clearTokenAndMergeSurroundingWhitespace($index);
+
+                continue;
+            }
+
+            $tokens[$index] = new Token([T_DOC_COMMENT, $doc->getContent()]);
+        }
+    }
+
+    /**
+     * Remove `return void` or `return null` annotations.
+     */
+    private function fixAnnotation(Annotation $annotation): void
+    {
+        $types = $annotation->getNormalizedTypes();
+
+        if (1 === \count($types) && ('null' === $types[0] || 'void' === $types[0])) {
+            $annotation->remove();
+        }
+    }
+}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/Phpdoc/PhpdocNoPackageFixer.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of PHP CS Fixer.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace PhpCsFixer\Fixer\Phpdoc;
+
+use PhpCsFixer\AbstractProxyFixer;
+use PhpCsFixer\FixerDefinition\CodeSample;
+use PhpCsFixer\FixerDefinition\FixerDefinition;
+use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
+
+/**
+ * @author Graham Campbell <hello@gjcampbell.co.uk>
+ * @author Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ */
+final class PhpdocNoPackageFixer extends AbstractProxyFixer
+{
+    public function getDefinition(): FixerDefinitionInterface
+    {
+        return new FixerDefinition(
+            '`@package` and `@subpackage` annotations must be removed from PHPDoc.',
+            [
+                new CodeSample(
+                    '<?php
+/**
+ * @internal
+ * @package Foo
+ * subpackage Bar
+ */
+class Baz
+{
+}
+'
+                ),
+            ]
+        );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Must run before NoEmptyPhpdocFixer, PhpdocAlignFixer, PhpdocSeparationFixer, PhpdocTrimFixer.
+     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer.
+     */
+    public function getPriority(): int
+    {
+        return parent::getPriority();
+    }
+
+    protected function createProxyFixers(): array
+    {
+        $fixer = new GeneralPhpdocAnnotationRemoveFixer();
+        $fixer->configure([
+            'annotations' => ['package', 'subpackage'],
+            'case_sensitive' => true,
+        ]);
+
+        return [$fixer];
+    }
+}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/Phpdoc/PhpdocNoUselessInheritdocFixer.php

@@ -0,0 +1,151 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of PHP CS Fixer.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace PhpCsFixer\Fixer\Phpdoc;
+
+use PhpCsFixer\AbstractFixer;
+use PhpCsFixer\FixerDefinition\CodeSample;
+use PhpCsFixer\FixerDefinition\FixerDefinition;
+use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
+use PhpCsFixer\Preg;
+use PhpCsFixer\Tokenizer\CT;
+use PhpCsFixer\Tokenizer\Token;
+use PhpCsFixer\Tokenizer\Tokens;
+
+/**
+ * Remove inheritdoc tags from classy that does not inherit.
+ */
+final class PhpdocNoUselessInheritdocFixer extends AbstractFixer
+{
+    public function getDefinition(): FixerDefinitionInterface
+    {
+        return new FixerDefinition(
+            'Classy that does not inherit must not have `@inheritdoc` tags.',
+            [
+                new CodeSample("<?php\n/** {@inheritdoc} */\nclass Sample\n{\n}\n"),
+                new CodeSample("<?php\nclass Sample\n{\n    /**\n     * @inheritdoc\n     */\n    public function Test()\n    {\n    }\n}\n"),
+            ]
+        );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Must run before NoEmptyPhpdocFixer, NoTrailingWhitespaceInCommentFixer, PhpdocAlignFixer.
+     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer.
+     */
+    public function getPriority(): int
+    {
+        return 6;
+    }
+
+    public function isCandidate(Tokens $tokens): bool
+    {
+        return $tokens->isTokenKindFound(T_DOC_COMMENT) && $tokens->isAnyTokenKindsFound([T_CLASS, T_INTERFACE]);
+    }
+
+    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
+    {
+        // min. offset 4 as minimal candidate is @: <?php\n/** @inheritdoc */class min{}
+        for ($index = 1, $count = \count($tokens) - 4; $index < $count; ++$index) {
+            if ($tokens[$index]->isGivenKind([T_CLASS, T_INTERFACE])) {
+                $index = $this->fixClassy($tokens, $index);
+            }
+        }
+    }
+
+    private function fixClassy(Tokens $tokens, int $index): int
+    {
+        // figure out where the classy starts
+        $classOpenIndex = $tokens->getNextTokenOfKind($index, ['{']);
+
+        // figure out where the classy ends
+        $classEndIndex = $tokens->findBlockEnd(Tokens::BLOCK_TYPE_CURLY_BRACE, $classOpenIndex);
+
+        // is classy extending or implementing some interface
+        $extendingOrImplementing = $this->isExtendingOrImplementing($tokens, $index, $classOpenIndex);
+
+        if (!$extendingOrImplementing) {
+            // PHPDoc of classy should not have inherit tag even when using traits as Traits cannot provide this information
+            $this->fixClassyOutside($tokens, $index);
+        }
+
+        // figure out if the classy uses a trait
+        if (!$extendingOrImplementing && $this->isUsingTrait($tokens, $index, $classOpenIndex, $classEndIndex)) {
+            $extendingOrImplementing = true;
+        }
+
+        $this->fixClassyInside($tokens, $classOpenIndex, $classEndIndex, !$extendingOrImplementing);
+
+        return $classEndIndex;
+    }
+
+    private function fixClassyInside(Tokens $tokens, int $classOpenIndex, int $classEndIndex, bool $fixThisLevel): void
+    {
+        for ($i = $classOpenIndex; $i < $classEndIndex; ++$i) {
+            if ($tokens[$i]->isGivenKind(T_CLASS)) {
+                $i = $this->fixClassy($tokens, $i);
+            } elseif ($fixThisLevel && $tokens[$i]->isGivenKind(T_DOC_COMMENT)) {
+                $this->fixToken($tokens, $i);
+            }
+        }
+    }
+
+    private function fixClassyOutside(Tokens $tokens, int $classIndex): void
+    {
+        $previousIndex = $tokens->getPrevNonWhitespace($classIndex);
+        if ($tokens[$previousIndex]->isGivenKind(T_DOC_COMMENT)) {
+            $this->fixToken($tokens, $previousIndex);
+        }
+    }
+
+    private function fixToken(Tokens $tokens, int $tokenIndex): void
+    {
+        $count = 0;
+        $content = Preg::replaceCallback(
+            '#(\h*(?:@{*|{*\h*@)\h*inheritdoc\h*)([^}]*)((?:}*)\h*)#i',
+            static fn (array $matches): string => ' '.$matches[2],
+            $tokens[$tokenIndex]->getContent(),
+            -1,
+            $count
+        );
+
+        if ($count > 0) {
+            $tokens[$tokenIndex] = new Token([T_DOC_COMMENT, $content]);
+        }
+    }
+
+    private function isExtendingOrImplementing(Tokens $tokens, int $classIndex, int $classOpenIndex): bool
+    {
+        for ($index = $classIndex; $index < $classOpenIndex; ++$index) {
+            if ($tokens[$index]->isGivenKind([T_EXTENDS, T_IMPLEMENTS])) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    private function isUsingTrait(Tokens $tokens, int $classIndex, int $classOpenIndex, int $classCloseIndex): bool
+    {
+        if ($tokens[$classIndex]->isGivenKind(T_INTERFACE)) {
+            // cannot use Trait inside an interface
+            return false;
+        }
+
+        $useIndex = $tokens->getNextTokenOfKind($classOpenIndex, [[CT::T_USE_TRAIT]]);
+
+        return null !== $useIndex && $useIndex < $classCloseIndex;
+    }
+}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/Phpdoc/PhpdocOrderByValueFixer.php

@@ -0,0 +1,225 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of PHP CS Fixer.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace PhpCsFixer\Fixer\Phpdoc;
+
+use PhpCsFixer\AbstractFixer;
+use PhpCsFixer\DocBlock\DocBlock;
+use PhpCsFixer\Fixer\ConfigurableFixerInterface;
+use PhpCsFixer\Fixer\ConfigurableFixerTrait;
+use PhpCsFixer\FixerConfiguration\AllowedValueSubset;
+use PhpCsFixer\FixerConfiguration\FixerConfigurationResolver;
+use PhpCsFixer\FixerConfiguration\FixerConfigurationResolverInterface;
+use PhpCsFixer\FixerConfiguration\FixerOptionBuilder;
+use PhpCsFixer\FixerDefinition\CodeSample;
+use PhpCsFixer\FixerDefinition\FixerDefinition;
+use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
+use PhpCsFixer\Preg;
+use PhpCsFixer\Tokenizer\Token;
+use PhpCsFixer\Tokenizer\Tokens;
+use Symfony\Component\OptionsResolver\Options;
+
+/**
+ * @author Filippo Tessarotto <zoeslam@gmail.com>
+ * @author Andreas Möller <am@localheinz.com>
+ *
+ * @implements ConfigurableFixerInterface<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration>
+ *
+ * @phpstan-type _AutogeneratedInputConfiguration array{
+ *  annotations?: list<'author'|'covers'|'coversNothing'|'dataProvider'|'depends'|'group'|'internal'|'method'|'mixin'|'property'|'property-read'|'property-write'|'requires'|'throws'|'uses'>,
+ * }
+ * @phpstan-type _AutogeneratedComputedConfiguration array{
+ *  annotations: array{'author'?: 'author', 'covers'?: 'covers', 'coversNothing'?: 'coversnothing', 'dataProvider'?: 'dataprovider', 'depends'?: 'depends', 'group'?: 'group', 'internal'?: 'internal', 'method'?: 'method', 'mixin'?: 'mixin', 'property'?: 'property', 'property-read'?: 'property-read', 'property-write'?: 'property-write', 'requires'?: 'requires', 'throws'?: 'throws', 'uses'?: 'uses'},
+ * }
+ */
+final class PhpdocOrderByValueFixer extends AbstractFixer implements ConfigurableFixerInterface
+{
+    /** @use ConfigurableFixerTrait<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration> */
+    use ConfigurableFixerTrait;
+
+    public function getDefinition(): FixerDefinitionInterface
+    {
+        return new FixerDefinition(
+            'Order PHPDoc tags by value.',
+            [
+                new CodeSample(
+                    '<?php
+/**
+ * @covers Foo
+ * @covers Bar
+ */
+final class MyTest extends \PHPUnit_Framework_TestCase
+{}
+'
+                ),
+                new CodeSample(
+                    '<?php
+/**
+ * @author Bob
+ * @author Alice
+ */
+final class MyTest extends \PHPUnit_Framework_TestCase
+{}
+',
+                    [
+                        'annotations' => [
+                            'author',
+                        ],
+                    ]
+                ),
+            ]
+        );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * Must run before PhpdocAlignFixer.
+     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpUnitFqcnAnnotationFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer.
+     */
+    public function getPriority(): int
+    {
+        return -10;
+    }
+
+    public function isCandidate(Tokens $tokens): bool
+    {
+        return $tokens->isAllTokenKindsFound([T_CLASS, T_DOC_COMMENT]);
+    }
+
+    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
+    {
+        if ([] === $this->configuration['annotations']) {
+            return;
+        }
+
+        for ($index = $tokens->count() - 1; $index > 0; --$index) {
+            foreach ($this->configuration['annotations'] as $type => $typeLowerCase) {
+                $findPattern = \sprintf(
+                    '/@%s\s.+@%s\s/s',
+                    $type,
+                    $type
+                );
+
+                if (
+                    !$tokens[$index]->isGivenKind(T_DOC_COMMENT)
+                    || !Preg::match($findPattern, $tokens[$index]->getContent())
+                ) {
+                    continue;
+                }
+
+                $docBlock = new DocBlock($tokens[$index]->getContent());
+
+                $annotations = $docBlock->getAnnotationsOfType($type);
+                $annotationMap = [];
+
+                if (\in_array($type, ['property', 'property-read', 'property-write'], true)) {
+                    $replacePattern = \sprintf(
+                        '/(?s)\*\s*@%s\s+(?P<optionalTypes>.+\s+)?\$(?P<comparableContent>\S+).*/',
+                        $type
+                    );
+
+                    $replacement = '\2';
+                } elseif ('method' === $type) {
+                    $replacePattern = '/(?s)\*\s*@method\s+(?P<optionalReturnTypes>.+\s+)?(?P<comparableContent>.+)\(.*/';
+                    $replacement = '\2';
+                } else {
+                    $replacePattern = \sprintf(
+                        '/\*\s*@%s\s+(?P<comparableContent>.+)/',
+                        $typeLowerCase
+                    );
+
+                    $replacement = '\1';
+                }
+
+                foreach ($annotations as $annotation) {
+                    $rawContent = $annotation->getContent();
+
+                    $comparableContent = Preg::replace(
+                        $replacePattern,
+                        $replacement,
+                        strtolower(trim($rawContent))
+                    );
+
+                    $annotationMap[$comparableContent] = $rawContent;
+                }
+
+                $orderedAnnotationMap = $annotationMap;
+
+                ksort($orderedAnnotationMap, SORT_STRING);
+
+                if ($orderedAnnotationMap === $annotationMap) {
+                    continue;
+                }
+
+                $lines = $docBlock->getLines();
+
+                foreach (array_reverse($annotations) as $annotation) {
+                    array_splice(
+                        $lines,
+                        $annotation->getStart(),
+                        $annotation->getEnd() - $annotation->getStart() + 1,
+                        array_pop($orderedAnnotationMap)
+                    );
+                }
+
+                $tokens[$index] = new Token([T_DOC_COMMENT, implode('', $lines)]);
+            }
+        }
+    }
+
+    protected function createConfigurationDefinition(): FixerConfigurationResolverInterface
+    {
+        $allowedValues = [
+            'author',
+            'covers',
+            'coversNothing',
+            'dataProvider',
+            'depends',
+            'group',
+            'internal',
+            'method',
+            'mixin',
+            'property',
+            'property-read',
+            'property-write',
+            'requires',
+            'throws',
+            'uses',
+        ];
+
+        return new FixerConfigurationResolver([
+            (new FixerOptionBuilder('annotations', 'List of annotations to order, e.g. `["covers"]`.'))
+                ->setAllowedTypes(['string[]'])
+                ->setAllowedValues([
+                    new AllowedValueSubset($allowedValues),
+                ])
+                ->setNormalizer(static function (Options $options, array $value): array {
+                    $normalized = [];
+
+                    foreach ($value as $annotation) {
+                        // since we will be using "strtolower" on the input annotations when building the sorting
+                        // map we must match the type in lower case as well
+                        $normalized[$annotation] = strtolower($annotation);
+                    }
+
+                    return $normalized;
+                })
+                ->setDefault([
+                    'covers',
+                ])
+                ->getOption(),
+        ]);
+    }
+}