@averay/codeformat 0.2.7 → 0.2.9

package/vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php

@@ -1,91 +0,0 @@
-<?php declare(strict_types=1);
-
-namespace Composer\Pcre\PHPStan;
-
-use Composer\Pcre\Preg;
-use Composer\Pcre\Regex;
-use PhpParser\Node\Expr\StaticCall;
-use PHPStan\Analyser\Scope;
-use PHPStan\Reflection\MethodReflection;
-use PHPStan\Reflection\Native\NativeParameterReflection;
-use PHPStan\Reflection\ParameterReflection;
-use PHPStan\TrinaryLogic;
-use PHPStan\Type\ClosureType;
-use PHPStan\Type\Constant\ConstantArrayType;
-use PHPStan\Type\Php\RegexArrayShapeMatcher;
-use PHPStan\Type\StaticMethodParameterClosureTypeExtension;
-use PHPStan\Type\StringType;
-use PHPStan\Type\TypeCombinator;
-use PHPStan\Type\Type;
-
-final class PregReplaceCallbackClosureTypeExtension implements StaticMethodParameterClosureTypeExtension
-{
-    /**
-     * @var RegexArrayShapeMatcher
-     */
-    private $regexShapeMatcher;
-
-    public function __construct(RegexArrayShapeMatcher $regexShapeMatcher)
-    {
-        $this->regexShapeMatcher = $regexShapeMatcher;
-    }
-
-    public function isStaticMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter): bool
-    {
-        return in_array($methodReflection->getDeclaringClass()->getName(), [Preg::class, Regex::class], true)
-            && in_array($methodReflection->getName(), ['replaceCallback', 'replaceCallbackStrictGroups'], true)
-            && $parameter->getName() === 'replacement';
-    }
-
-    public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, ParameterReflection $parameter, Scope $scope): ?Type
-    {
-        $args = $methodCall->getArgs();
-        $patternArg = $args[0] ?? null;
-        $flagsArg = $args[5] ?? null;
-
-        if (
-            $patternArg === null
-        ) {
-            return null;
-        }
-
-        $flagsType = PregMatchFlags::getType($flagsArg, $scope);
-
-        $matchesType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createYes(), $scope);
-        if ($matchesType === null) {
-            return null;
-        }
-
-        if ($methodReflection->getName() === 'replaceCallbackStrictGroups' && count($matchesType->getConstantArrays()) === 1) {
-            $matchesType = $matchesType->getConstantArrays()[0];
-            $matchesType = new ConstantArrayType(
-                $matchesType->getKeyTypes(),
-                array_map(static function (Type $valueType): Type {
-                    if (count($valueType->getConstantArrays()) === 1) {
-                        $valueTypeArray = $valueType->getConstantArrays()[0];
-                        return new ConstantArrayType(
-                            $valueTypeArray->getKeyTypes(),
-                            array_map(static function (Type $valueType): Type {
-                                return TypeCombinator::removeNull($valueType);
-                            }, $valueTypeArray->getValueTypes()),
-                            $valueTypeArray->getNextAutoIndexes(),
-                            [],
-                            $valueTypeArray->isList()
-                        );
-                    }
-                    return TypeCombinator::removeNull($valueType);
-                }, $matchesType->getValueTypes()),
-                $matchesType->getNextAutoIndexes(),
-                [],
-                $matchesType->isList()
-            );
-        }
-
-        return new ClosureType(
-            [
-                new NativeParameterReflection($parameter->getName(), $parameter->isOptional(), $matchesType, $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue()),
-            ],
-            new StringType()
-        );
-    }
-}

package/vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php

@@ -1,112 +0,0 @@
-<?php declare(strict_types=1);
-
-namespace Composer\Pcre\PHPStan;
-
-use Composer\Pcre\Preg;
-use Composer\Pcre\Regex;
-use PhpParser\Node;
-use PhpParser\Node\Expr\StaticCall;
-use PhpParser\Node\Name\FullyQualified;
-use PHPStan\Analyser\Scope;
-use PHPStan\Analyser\SpecifiedTypes;
-use PHPStan\Rules\Rule;
-use PHPStan\Rules\RuleErrorBuilder;
-use PHPStan\TrinaryLogic;
-use PHPStan\Type\ObjectType;
-use PHPStan\Type\Type;
-use PHPStan\Type\TypeCombinator;
-use PHPStan\Type\Php\RegexArrayShapeMatcher;
-use function sprintf;
-
-/**
- * @implements Rule<StaticCall>
- */
-final class UnsafeStrictGroupsCallRule implements Rule
-{
-    /**
-     * @var RegexArrayShapeMatcher
-     */
-    private $regexShapeMatcher;
-
-    public function __construct(RegexArrayShapeMatcher $regexShapeMatcher)
-    {
-        $this->regexShapeMatcher = $regexShapeMatcher;
-    }
-
-    public function getNodeType(): string
-    {
-        return StaticCall::class;
-    }
-
-    public function processNode(Node $node, Scope $scope): array
-    {
-        if (!$node->class instanceof FullyQualified) {
-            return [];
-        }
-        $isRegex = $node->class->toString() === Regex::class;
-        $isPreg = $node->class->toString() === Preg::class;
-        if (!$isRegex && !$isPreg) {
-            return [];
-        }
-        if (!$node->name instanceof Node\Identifier || !in_array($node->name->name, ['matchStrictGroups', 'isMatchStrictGroups', 'matchAllStrictGroups', 'isMatchAllStrictGroups'], true)) {
-            return [];
-        }
-
-        $args = $node->getArgs();
-        if (!isset($args[0])) {
-            return [];
-        }
-
-        $patternArg = $args[0] ?? null;
-        if ($isPreg) {
-            if (!isset($args[2])) { // no matches set, skip as the matches won't be used anyway
-                return [];
-            }
-            $flagsArg = $args[3] ?? null;
-        } else {
-            $flagsArg = $args[2] ?? null;
-        }
-
-        if ($patternArg === null) {
-            return [];
-        }
-
-        $flagsType = PregMatchFlags::getType($flagsArg, $scope);
-        if ($flagsType === null) {
-            return [];
-        }
-
-        $matchedType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createYes(), $scope);
-        if ($matchedType === null) {
-            return [
-                RuleErrorBuilder::message(sprintf('The %s call is potentially unsafe as $matches\' type could not be inferred.', $node->name->name))
-                    ->identifier('composerPcre.maybeUnsafeStrictGroups')
-                    ->build(),
-            ];
-        }
-
-        if (count($matchedType->getConstantArrays()) === 1) {
-            $matchedType = $matchedType->getConstantArrays()[0];
-            $nullableGroups = [];
-            foreach ($matchedType->getValueTypes() as $index => $type) {
-                if (TypeCombinator::containsNull($type)) {
-                    $nullableGroups[] = $matchedType->getKeyTypes()[$index]->getValue();
-                }
-            }
-
-            if (\count($nullableGroups) > 0) {
-                return [
-                    RuleErrorBuilder::message(sprintf(
-                        'The %s call is unsafe as match group%s "%s" %s optional and may be null.',
-                        $node->name->name,
-                        \count($nullableGroups) > 1 ? 's' : '',
-                        implode('", "', $nullableGroups),
-                        \count($nullableGroups) > 1 ? 'are' : 'is'
-                    ))->identifier('composerPcre.unsafeStrictGroups')->build(),
-                ];
-            }
-        }
-
-        return [];
-    }
-}

package/vendor/composer/pcre/src/PcreException.php

@@ -1,55 +0,0 @@
-<?php
-
-/*
- * This file is part of composer/pcre.
- *
- * (c) Composer <https://github.com/composer>
- *
- * For the full copyright and license information, please view
- * the LICENSE file that was distributed with this source code.
- */
-
-namespace Composer\Pcre;
-
-class PcreException extends \RuntimeException
-{
-    /**
-     * @param  string $function
-     * @param  string|string[] $pattern
-     * @return self
-     */
-    public static function fromFunction($function, $pattern)
-    {
-        $code = preg_last_error();
-
-        if (is_array($pattern)) {
-            $pattern = implode(', ', $pattern);
-        }
-
-        return new PcreException($function.'(): failed executing "'.$pattern.'": '.self::pcreLastErrorMessage($code), $code);
-    }
-
-    /**
-     * @param  int $code
-     * @return string
-     */
-    private static function pcreLastErrorMessage($code)
-    {
-        if (function_exists('preg_last_error_msg')) {
-            return preg_last_error_msg();
-        }
-
-        $constants = get_defined_constants(true);
-        if (!isset($constants['pcre']) || !is_array($constants['pcre'])) {
-            return 'UNDEFINED_ERROR';
-        }
-
-        foreach ($constants['pcre'] as $const => $val) {
-            if ($val === $code && substr($const, -6) === '_ERROR') {
-                return $const;
-            }
-        }
-
-        return 'UNDEFINED_ERROR';
-    }
-}

package/vendor/composer/pcre/src/Preg.php

@@ -1,430 +0,0 @@
-<?php
-
-/*
- * This file is part of composer/pcre.
- *
- * (c) Composer <https://github.com/composer>
- *
- * For the full copyright and license information, please view
- * the LICENSE file that was distributed with this source code.
- */
-
-namespace Composer\Pcre;
-
-class Preg
-{
-    /** @internal */
-    public const ARRAY_MSG = '$subject as an array is not supported. You can use \'foreach\' instead.';
-    /** @internal */
-    public const INVALID_TYPE_MSG = '$subject must be a string, %s given.';
-
-    /**
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     * @return 0|1
-     *
-     * @param-out array<int|string, string|null> $matches
-     */
-    public static function match(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
-    {
-        self::checkOffsetCapture($flags, 'matchWithOffsets');
-
-        $result = preg_match($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL, $offset);
-        if ($result === false) {
-            throw PcreException::fromFunction('preg_match', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * Variant of `match()` which outputs non-null matches (or throws)
-     *
-     * @param non-empty-string $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     * @return 0|1
-     * @throws UnexpectedNullMatchException
-     *
-     * @param-out array<int|string, string> $matches
-     */
-    public static function matchStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
-    {
-        $result = self::match($pattern, $subject, $matchesInternal, $flags, $offset);
-        $matches = self::enforceNonNullMatches($pattern, $matchesInternal, 'match');
-
-        return $result;
-    }
-
-    /**
-     * Runs preg_match with PREG_OFFSET_CAPTURE
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL|PREG_OFFSET_CAPTURE> $flags PREG_UNMATCHED_AS_NULL and PREG_OFFSET_CAPTURE are always set, no other flags are supported
-     * @return 0|1
-     *
-     * @param-out array<int|string, array{string|null, int<-1, max>}> $matches
-     */
-    public static function matchWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): int
-    {
-        $result = preg_match($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL | PREG_OFFSET_CAPTURE, $offset);
-        if ($result === false) {
-            throw PcreException::fromFunction('preg_match', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     * @return 0|positive-int
-     *
-     * @param-out array<int|string, list<string|null>> $matches
-     */
-    public static function matchAll(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
-    {
-        self::checkOffsetCapture($flags, 'matchAllWithOffsets');
-        self::checkSetOrder($flags);
-
-        $result = preg_match_all($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL, $offset);
-        if (!is_int($result)) { // PHP < 8 may return null, 8+ returns int|false
-            throw PcreException::fromFunction('preg_match_all', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * Variant of `match()` which outputs non-null matches (or throws)
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     * @return 0|positive-int
-     * @throws UnexpectedNullMatchException
-     *
-     * @param-out array<int|string, list<string>> $matches
-     */
-    public static function matchAllStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
-    {
-        $result = self::matchAll($pattern, $subject, $matchesInternal, $flags, $offset);
-        $matches = self::enforceNonNullMatchAll($pattern, $matchesInternal, 'matchAll');
-
-        return $result;
-    }
-
-    /**
-     * Runs preg_match_all with PREG_OFFSET_CAPTURE
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL|PREG_OFFSET_CAPTURE> $flags PREG_UNMATCHED_AS_NULL and PREG_MATCH_OFFSET are always set, no other flags are supported
-     * @return 0|positive-int
-     *
-     * @param-out array<int|string, list<array{string|null, int<-1, max>}>> $matches
-     */
-    public static function matchAllWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): int
-    {
-        self::checkSetOrder($flags);
-
-        $result = preg_match_all($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL | PREG_OFFSET_CAPTURE, $offset);
-        if (!is_int($result)) { // PHP < 8 may return null, 8+ returns int|false
-            throw PcreException::fromFunction('preg_match_all', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @param string|string[] $pattern
-     * @param string|string[] $replacement
-     * @param string $subject
-     * @param int             $count Set by method
-     *
-     * @param-out int<0, max> $count
-     */
-    public static function replace($pattern, $replacement, $subject, int $limit = -1, ?int &$count = null): string
-    {
-        if (!is_scalar($subject)) {
-            if (is_array($subject)) {
-                throw new \InvalidArgumentException(static::ARRAY_MSG);
-            }
-
-            throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
-        }
-
-        $result = preg_replace($pattern, $replacement, $subject, $limit, $count);
-        if ($result === null) {
-            throw PcreException::fromFunction('preg_replace', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @param string|string[] $pattern
-     * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array<int|string, array{string|null, int<-1, max>}>): string) : callable(array<int|string, string|null>): string) $replacement
-     * @param string $subject
-     * @param int             $count Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL|PREG_OFFSET_CAPTURE> $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
-     *
-     * @param-out int<0, max> $count
-     */
-    public static function replaceCallback($pattern, callable $replacement, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
-    {
-        if (!is_scalar($subject)) {
-            if (is_array($subject)) {
-                throw new \InvalidArgumentException(static::ARRAY_MSG);
-            }
-
-            throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
-        }
-
-        $result = preg_replace_callback($pattern, $replacement, $subject, $limit, $count, $flags | PREG_UNMATCHED_AS_NULL);
-        if ($result === null) {
-            throw PcreException::fromFunction('preg_replace_callback', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * Variant of `replaceCallback()` which outputs non-null matches (or throws)
-     *
-     * @param string $pattern
-     * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array<int|string, array{string, int<0, max>}>): string) : callable(array<int|string, string>): string) $replacement
-     * @param string $subject
-     * @param int $count Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL|PREG_OFFSET_CAPTURE> $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
-     *
-     * @param-out int<0, max> $count
-     */
-    public static function replaceCallbackStrictGroups(string $pattern, callable $replacement, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
-    {
-        return self::replaceCallback($pattern, function (array $matches) use ($pattern, $replacement) {
-            return $replacement(self::enforceNonNullMatches($pattern, $matches, 'replaceCallback'));
-        }, $subject, $limit, $count, $flags);
-    }
-
-    /**
-     * @param ($flags is PREG_OFFSET_CAPTURE ? (array<string, callable(array<int|string, array{string|null, int<-1, max>}>): string>) : array<string, callable(array<int|string, string|null>): string>) $pattern
-     * @param string $subject
-     * @param int    $count Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL|PREG_OFFSET_CAPTURE> $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
-     *
-     * @param-out int<0, max> $count
-     */
-    public static function replaceCallbackArray(array $pattern, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
-    {
-        if (!is_scalar($subject)) {
-            if (is_array($subject)) {
-                throw new \InvalidArgumentException(static::ARRAY_MSG);
-            }
-
-            throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
-        }
-
-        $result = preg_replace_callback_array($pattern, $subject, $limit, $count, $flags | PREG_UNMATCHED_AS_NULL);
-        if ($result === null) {
-            $pattern = array_keys($pattern);
-            throw PcreException::fromFunction('preg_replace_callback_array', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @param int-mask<PREG_SPLIT_NO_EMPTY|PREG_SPLIT_DELIM_CAPTURE|PREG_SPLIT_OFFSET_CAPTURE> $flags PREG_SPLIT_NO_EMPTY or PREG_SPLIT_DELIM_CAPTURE
-     * @return list<string>
-     */
-    public static function split(string $pattern, string $subject, int $limit = -1, int $flags = 0): array
-    {
-        if (($flags & PREG_SPLIT_OFFSET_CAPTURE) !== 0) {
-            throw new \InvalidArgumentException('PREG_SPLIT_OFFSET_CAPTURE is not supported as it changes the type of $matches, use splitWithOffsets() instead');
-        }
-
-        $result = preg_split($pattern, $subject, $limit, $flags);
-        if ($result === false) {
-            throw PcreException::fromFunction('preg_split', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @param int-mask<PREG_SPLIT_NO_EMPTY|PREG_SPLIT_DELIM_CAPTURE|PREG_SPLIT_OFFSET_CAPTURE> $flags PREG_SPLIT_NO_EMPTY or PREG_SPLIT_DELIM_CAPTURE, PREG_SPLIT_OFFSET_CAPTURE is always set
-     * @return list<array{string, int}>
-     * @phpstan-return list<array{string, int<0, max>}>
-     */
-    public static function splitWithOffsets(string $pattern, string $subject, int $limit = -1, int $flags = 0): array
-    {
-        $result = preg_split($pattern, $subject, $limit, $flags | PREG_SPLIT_OFFSET_CAPTURE);
-        if ($result === false) {
-            throw PcreException::fromFunction('preg_split', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * @template T of string|\Stringable
-     * @param string   $pattern
-     * @param array<T> $array
-     * @param int-mask<PREG_GREP_INVERT> $flags PREG_GREP_INVERT
-     * @return array<T>
-     */
-    public static function grep(string $pattern, array $array, int $flags = 0): array
-    {
-        $result = preg_grep($pattern, $array, $flags);
-        if ($result === false) {
-            throw PcreException::fromFunction('preg_grep', $pattern);
-        }
-
-        return $result;
-    }
-
-    /**
-     * Variant of match() which returns a bool instead of int
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     *
-     * @param-out array<int|string, string|null> $matches
-     */
-    public static function isMatch(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) static::match($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    /**
-     * Variant of `isMatch()` which outputs non-null matches (or throws)
-     *
-     * @param non-empty-string $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     * @throws UnexpectedNullMatchException
-     *
-     * @param-out array<int|string, string> $matches
-     */
-    public static function isMatchStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) self::matchStrictGroups($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    /**
-     * Variant of matchAll() which returns a bool instead of int
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     *
-     * @param-out array<int|string, list<string|null>> $matches
-     */
-    public static function isMatchAll(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) static::matchAll($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    /**
-     * Variant of `isMatchAll()` which outputs non-null matches (or throws)
-     *
-     * @param non-empty-string $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     *
-     * @param-out array<int|string, list<string>> $matches
-     */
-    public static function isMatchAllStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) self::matchAllStrictGroups($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    /**
-     * Variant of matchWithOffsets() which returns a bool instead of int
-     *
-     * Runs preg_match with PREG_OFFSET_CAPTURE
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     *
-     * @param-out array<int|string, array{string|null, int<-1, max>}> $matches
-     */
-    public static function isMatchWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) static::matchWithOffsets($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    /**
-     * Variant of matchAllWithOffsets() which returns a bool instead of int
-     *
-     * Runs preg_match_all with PREG_OFFSET_CAPTURE
-     *
-     * @param non-empty-string   $pattern
-     * @param array<mixed> $matches Set by method
-     * @param int-mask<PREG_UNMATCHED_AS_NULL> $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
-     *
-     * @param-out array<int|string, list<array{string|null, int<-1, max>}>> $matches
-     */
-    public static function isMatchAllWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): bool
-    {
-        return (bool) static::matchAllWithOffsets($pattern, $subject, $matches, $flags, $offset);
-    }
-
-    private static function checkOffsetCapture(int $flags, string $useFunctionName): void
-    {
-        if (($flags & PREG_OFFSET_CAPTURE) !== 0) {
-            throw new \InvalidArgumentException('PREG_OFFSET_CAPTURE is not supported as it changes the type of $matches, use ' . $useFunctionName . '() instead');
-        }
-    }
-
-    private static function checkSetOrder(int $flags): void
-    {
-        if (($flags & PREG_SET_ORDER) !== 0) {
-            throw new \InvalidArgumentException('PREG_SET_ORDER is not supported as it changes the type of $matches');
-        }
-    }
-
-    /**
-     * @param array<int|string, string|null|array{string|null, int}> $matches
-     * @return array<int|string, string>
-     * @throws UnexpectedNullMatchException
-     */
-    private static function enforceNonNullMatches(string $pattern, array $matches, string $variantMethod)
-    {
-        foreach ($matches as $group => $match) {
-            if (is_string($match) || (is_array($match) && is_string($match[0]))) {
-                continue;
-            }
-
-            throw new UnexpectedNullMatchException('Pattern "'.$pattern.'" had an unexpected unmatched group "'.$group.'", make sure the pattern always matches or use '.$variantMethod.'() instead.');
-        }
-
-        /** @var array<string> */
-        return $matches;
-    }
-
-    /**
-     * @param array<int|string, list<string|null>> $matches
-     * @return array<int|string, list<string>>
-     * @throws UnexpectedNullMatchException
-     */
-    private static function enforceNonNullMatchAll(string $pattern, array $matches, string $variantMethod)
-    {
-        foreach ($matches as $group => $groupMatches) {
-            foreach ($groupMatches as $match) {
-                if (null === $match) {
-                    throw new UnexpectedNullMatchException('Pattern "'.$pattern.'" had an unexpected unmatched group "'.$group.'", make sure the pattern always matches or use '.$variantMethod.'() instead.');
-                }
-            }
-        }
-
-        /** @var array<int|string, list<string>> */
-        return $matches;
-    }
-}