sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/Tokens/TokenHelper.php

@@ -1,55 +0,0 @@
-<?php
-/**
- * PHPCSUtils, utility functions and classes for PHP_CodeSniffer sniff developers.
- *
- * @package   PHPCSUtils
- * @copyright 2019-2020 PHPCSUtils Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSUtils
- */
-
-namespace PHPCSUtils\Tokens;
-
-/**
- * Helpers for working with tokens.
- *
- * @since 1.0.0
- */
-final class TokenHelper
-{
-
-    /**
-     * Check whether a PHP native token exists (for real).
-     *
-     * Under normal circumstances, checking whether a token exists (either defined by PHP or by PHPCS)
-     * is as straight-forward as running `defined('T_TOKEN_NAME')`.
-     *
-     * Unfortunately, this doesn't work in all circumstances, most notably, if an external standard
-     * also uses PHP-Parser or when code coverage is run on a standard using PHPUnit >= 9.3 (which uses PHP-Parser),
-     * this logic breaks because PHP-Parser also polyfills tokens.
-     * This method takes potentially polyfilled tokens from PHP-Parser into account and will regard the token
-     * as undefined if it was declared by PHP-Parser.
-     *
-     * Note: this method only _needs_ to be used for PHP native tokens, not for PHPCS specific tokens.
-     * Also, realistically, it only needs to be used for tokens introduced in PHP in recent versions (PHP 7.4 and up).
-     * Having said that, the method _will_ also work correctly when a name of a PHPCS native token is passed or
-     * of an older PHP native token.
-     *
-     * {@internal PHP native tokens have a positive integer value. PHPCS polyfilled tokens are strings.
-     * PHP-Parser polyfilled tokens will always have a negative integer value < 0, which is how
-     * these are filtered out.}
-     *
-     * @link https://github.com/sebastianbergmann/php-code-coverage/issues/798       PHP-Code-Coverage#798
-     * @link https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Lexer.php PHP-Parser Lexer code
-     *
-     * @since 1.0.0
-     *
-     * @param string $name The token name.
-     *
-     * @return bool
-     */
-    public static function tokenExists($name)
-    {
-        return (\defined($name) && (\is_int(\constant($name)) === false || \constant($name) > 0));
-    }
-}

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/Utils/Arrays.php

@@ -1,227 +0,0 @@
-<?php
-/**
- * PHPCSUtils, utility functions and classes for PHP_CodeSniffer sniff developers.
- *
- * @package   PHPCSUtils
- * @copyright 2019-2020 PHPCSUtils Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSUtils
- */
-
-namespace PHPCSUtils\Utils;
-
-use PHP_CodeSniffer\Exceptions\RuntimeException;
-use PHP_CodeSniffer\Files\File;
-use PHPCSUtils\Internal\Cache;
-use PHPCSUtils\Internal\IsShortArrayOrListWithCache;
-use PHPCSUtils\Tokens\Collections;
-
-/**
- * Utility functions for use when examining arrays.
- *
- * @since 1.0.0
- */
-final class Arrays
-{
-
-    /**
-     * The tokens to target to find the double arrow in an array item.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int|string, int|string>
-     */
-    private static $doubleArrowTargets = [
-        \T_DOUBLE_ARROW     => \T_DOUBLE_ARROW,
-
-        // Nested arrays.
-        \T_ARRAY            => \T_ARRAY,
-        \T_OPEN_SHORT_ARRAY => \T_OPEN_SHORT_ARRAY,
-
-        // Inline function, control structures and other things to skip over.
-        \T_LIST             => \T_LIST,
-        \T_FN               => \T_FN,
-        \T_MATCH            => \T_MATCH,
-        \T_ATTRIBUTE        => \T_ATTRIBUTE,
-    ];
-
-    /**
-     * Determine whether a T_OPEN/CLOSE_SHORT_ARRAY token is a short array construct
-     * and not a short list.
-     *
-     * This method also accepts `T_OPEN/CLOSE_SQUARE_BRACKET` tokens to allow it to be
-     * PHPCS cross-version compatible as the short array tokenizing has been plagued by
-     * a number of bugs over time.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the short array bracket token.
-     *
-     * @return bool `TRUE` if the token passed is the open/close bracket of a short array.
-     *              `FALSE` if the token is a short list bracket, a plain square bracket
-     *              or not one of the accepted tokens.
-     */
-    public static function isShortArray(File $phpcsFile, $stackPtr)
-    {
-        return IsShortArrayOrListWithCache::isShortArray($phpcsFile, $stackPtr);
-    }
-
-    /**
-     * Find the array opener and closer based on a T_ARRAY or T_OPEN_SHORT_ARRAY token.
-     *
-     * This method also accepts `T_OPEN_SQUARE_BRACKET` tokens to allow it to be
-     * PHPCS cross-version compatible as the short array tokenizing has been plagued by
-     * a number of bugs over time, which affects the short array determination.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile    The file being scanned.
-     * @param int                         $stackPtr     The position of the `T_ARRAY` or `T_OPEN_SHORT_ARRAY`
-     *                                                  token in the stack.
-     * @param true|null                   $isShortArray Short-circuit the short array check for `T_OPEN_SHORT_ARRAY`
-     *                                                  tokens if it isn't necessary.
-     *                                                  Efficiency tweak for when this has already been established,
-     *                                                  i.e. when encountering a nested array while walking the
-     *                                                  tokens in an array.
-     *                                                  Use with care.
-     *
-     * @return array<string, int>|false An array with the token pointers; or `FALSE` if this is not a
-     *                                  (short) array token or if the opener/closer could not be determined.
-     *                                  The format of the array return value is:
-     *                                  ```php
-     *                                  array(
-     *                                    'opener' => integer, // Stack pointer to the array open bracket.
-     *                                    'closer' => integer, // Stack pointer to the array close bracket.
-     *                                  )
-     *                                  ```
-     */
-    public static function getOpenClose(File $phpcsFile, $stackPtr, $isShortArray = null)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Is this one of the tokens this function handles ?
-        if (isset($tokens[$stackPtr]) === false
-            || isset(Collections::arrayOpenTokensBC()[$tokens[$stackPtr]['code']]) === false
-        ) {
-            return false;
-        }
-
-        switch ($tokens[$stackPtr]['code']) {
-            case \T_ARRAY:
-                if (isset($tokens[$stackPtr]['parenthesis_opener'])) {
-                    $opener = $tokens[$stackPtr]['parenthesis_opener'];
-
-                    if (isset($tokens[$opener]['parenthesis_closer'])) {
-                        $closer = $tokens[$opener]['parenthesis_closer'];
-                    }
-                }
-                break;
-
-            case \T_OPEN_SHORT_ARRAY:
-            case \T_OPEN_SQUARE_BRACKET:
-                if ($isShortArray === true || self::isShortArray($phpcsFile, $stackPtr) === true) {
-                    $opener = $stackPtr;
-                    $closer = $tokens[$stackPtr]['bracket_closer'];
-                }
-                break;
-        }
-
-        if (isset($opener, $closer)) {
-            return [
-                'opener' => $opener,
-                'closer' => $closer,
-            ];
-        }
-
-        return false;
-    }
-
-    /**
-     * Get the stack pointer position of the double arrow within an array item.
-     *
-     * Expects to be passed the array item start and end tokens as retrieved via
-     * {@see \PHPCSUtils\Utils\PassedParameters::getParameters()}.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being examined.
-     * @param int                         $start     Stack pointer to the start of the array item.
-     * @param int                         $end       Stack pointer to the last token in the array item.
-     *
-     * @return int|false Stack pointer to the double arrow if this array item has a key; or `FALSE` otherwise.
-     *
-     * @throws \PHP_CodeSniffer\Exceptions\RuntimeException If the start or end positions are invalid.
-     */
-    public static function getDoubleArrowPtr(File $phpcsFile, $start, $end)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        if (isset($tokens[$start], $tokens[$end]) === false || $start > $end) {
-            throw new RuntimeException(
-                'Invalid start and/or end position passed to getDoubleArrowPtr().'
-                . ' Received: $start ' . $start . ', $end ' . $end
-            );
-        }
-
-        $cacheId = "$start-$end";
-        if (Cache::isCached($phpcsFile, __METHOD__, $cacheId) === true) {
-            return Cache::get($phpcsFile, __METHOD__, $cacheId);
-        }
-
-        $targets  = self::$doubleArrowTargets;
-        $targets += Collections::closedScopes();
-
-        $doubleArrow = ($start - 1);
-        $returnValue = false;
-        ++$end;
-        do {
-            $doubleArrow = $phpcsFile->findNext(
-                $targets,
-                ($doubleArrow + 1),
-                $end
-            );
-
-            if ($doubleArrow === false) {
-                break;
-            }
-
-            if ($tokens[$doubleArrow]['code'] === \T_DOUBLE_ARROW) {
-                $returnValue = $doubleArrow;
-                break;
-            }
-
-            // Skip over closed scopes which may contain foreach structures or generators.
-            if ((isset(Collections::closedScopes()[$tokens[$doubleArrow]['code']]) === true
-                || $tokens[$doubleArrow]['code'] === \T_FN
-                || $tokens[$doubleArrow]['code'] === \T_MATCH)
-                && isset($tokens[$doubleArrow]['scope_closer']) === true
-            ) {
-                $doubleArrow = $tokens[$doubleArrow]['scope_closer'];
-                continue;
-            }
-
-            // Skip over attributes which may contain arrays as a passed parameters.
-            if ($tokens[$doubleArrow]['code'] === \T_ATTRIBUTE
-                && isset($tokens[$doubleArrow]['attribute_closer'])
-            ) {
-                $doubleArrow = $tokens[$doubleArrow]['attribute_closer'];
-                continue;
-            }
-
-            // Skip over potentially keyed long lists.
-            if ($tokens[$doubleArrow]['code'] === \T_LIST
-                && isset($tokens[$doubleArrow]['parenthesis_closer'])
-            ) {
-                $doubleArrow = $tokens[$doubleArrow]['parenthesis_closer'];
-                continue;
-            }
-
-            // Start of nested long/short array.
-            break;
-        } while ($doubleArrow < $end);
-
-        Cache::set($phpcsFile, __METHOD__, $cacheId, $returnValue);
-        return $returnValue;
-    }
-}

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/Utils/Conditions.php

@@ -1,156 +0,0 @@
-<?php
-/**
- * PHPCSUtils, utility functions and classes for PHP_CodeSniffer sniff developers.
- *
- * @package   PHPCSUtils
- * @copyright 2019-2020 PHPCSUtils Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSUtils
- */
-
-namespace PHPCSUtils\Utils;
-
-use PHP_CodeSniffer\Files\File;
-
-/**
- * Utility functions for use when examining token conditions.
- *
- * @since 1.0.0 The `Conditions::getCondition()` and `Conditions::hasCondition()`
- *              methods are based on and inspired by the methods of the same name in the
- *              PHPCS native `PHP_CodeSniffer\Files\File` class.
- *              Also see {@see \PHPCSUtils\BackCompat\BCFile}.
- */
-final class Conditions
-{
-
-    /**
-     * Retrieve the position of a condition for the passed token.
-     *
-     * If no types are specified, the first condition for the token - or if `$first=false`,
-     * the last condition - will be returned.
-     *
-     * Main differences with the PHPCS version:
-     * - The singular `$type` parameter has become the more flexible `$types` parameter allowing to
-     *   search for several types of conditions in one go.
-     * - The `$types` parameter is now optional.
-     *
-     * @see \PHP_CodeSniffer\Files\File::getCondition()   Original source.
-     * @see \PHPCSUtils\BackCompat\BCFile::getCondition() Cross-version compatible version of the original.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File  $phpcsFile The file being scanned.
-     * @param int                          $stackPtr  The position of the token we are checking.
-     * @param int|string|array<int|string> $types     Optional. The type(s) of tokens to search for.
-     * @param bool                         $first     Optional. Whether to search for the first (outermost)
-     *                                                (`true`) or the last (innermost) condition (`false`) of
-     *                                                the specified type(s).
-     *
-     * @return int|false Integer stack pointer to the condition; or `FALSE` if the token
-     *                   does not have the condition or has no conditions at all.
-     */
-    public static function getCondition(File $phpcsFile, $stackPtr, $types = [], $first = true)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Check for the existence of the token.
-        if (isset($tokens[$stackPtr]) === false) {
-            return false;
-        }
-
-        // Make sure the token has conditions.
-        if (empty($tokens[$stackPtr]['conditions'])) {
-            return false;
-        }
-
-        $types      = (array) $types;
-        $conditions = $tokens[$stackPtr]['conditions'];
-
-        if (empty($types) === true) {
-            // No types specified, just return the first/last condition pointer.
-            if ($first === false) {
-                \end($conditions);
-            } else {
-                \reset($conditions);
-            }
-
-            return \key($conditions);
-        }
-
-        if ($first === false) {
-            $conditions = \array_reverse($conditions, true);
-        }
-
-        foreach ($conditions as $ptr => $type) {
-            if (isset($tokens[$ptr]) === true
-                && \in_array($type, $types, true) === true
-            ) {
-                // We found a token with the required type.
-                return $ptr;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Determine if the passed token has a condition of one of the passed types.
-     *
-     * This method is not significantly different from the PHPCS native version.
-     *
-     * @see \PHP_CodeSniffer\Files\File::hasCondition()   Original source.
-     * @see \PHPCSUtils\BackCompat\BCFile::hasCondition() Cross-version compatible version of the original.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File  $phpcsFile The file being scanned.
-     * @param int                          $stackPtr  The position of the token we are checking.
-     * @param int|string|array<int|string> $types     The type(s) of tokens to search for.
-     *
-     * @return bool
-     */
-    public static function hasCondition(File $phpcsFile, $stackPtr, $types)
-    {
-        return (self::getCondition($phpcsFile, $stackPtr, $types) !== false);
-    }
-
-    /**
-     * Return the position of the first (outermost) condition of a certain type for the passed token.
-     *
-     * If no types are specified, the first condition for the token, independently of type,
-     * will be returned.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File  $phpcsFile The file where this token was found.
-     * @param int                          $stackPtr  The position of the token we are checking.
-     * @param int|string|array<int|string> $types     Optional. The type(s) of tokens to search for.
-     *
-     * @return int|false Integer stack pointer to the condition; or `FALSE` if the token
-     *                   does not have the condition or has no conditions at all.
-     */
-    public static function getFirstCondition(File $phpcsFile, $stackPtr, $types = [])
-    {
-        return self::getCondition($phpcsFile, $stackPtr, $types, true);
-    }
-
-    /**
-     * Return the position of the last (innermost) condition of a certain type for the passed token.
-     *
-     * If no types are specified, the last condition for the token, independently of type,
-     * will be returned.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File  $phpcsFile The file where this token was found.
-     * @param int                          $stackPtr  The position of the token we are checking.
-     * @param int|string|array<int|string> $types     Optional. The type(s) of tokens to search for.
-     *
-     * @return int|false Integer stack pointer to the condition; or `FALSE` if the token
-     *                   does not have the condition or has no conditions at all.
-     */
-    public static function getLastCondition(File $phpcsFile, $stackPtr, $types = [])
-    {
-        return self::getCondition($phpcsFile, $stackPtr, $types, false);
-    }
-}

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/Utils/Context.php

@@ -1,232 +0,0 @@
-<?php
-/**
- * PHPCSUtils, utility functions and classes for PHP_CodeSniffer sniff developers.
- *
- * @package   PHPCSUtils
- * @copyright 2019-2020 PHPCSUtils Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSUtils
- */
-
-namespace PHPCSUtils\Utils;
-
-use PHP_CodeSniffer\Files\File;
-use PHPCSUtils\Utils\Parentheses;
-
-/**
- * Utility functions for examining in which context a certain token is used.
- *
- * Example use-cases:
- * - A sniff looking for the use of certain variables may want to disregard the "use"
- *   of these variables within a call to `isset()` or `empty()`.
- * - A sniff looking for incrementor/decrementors may want to disregard these when used
- *   as the third expression in a `for()` condition.
- *
- * @since 1.0.0
- */
-final class Context
-{
-
-    /**
-     * Check whether an arbitrary token is within a call to empty().
-     *
-     * _This method is a thin, descriptive wrapper around the {@see Parentheses::getLastOwner()} method.
-     * For more complex/combined queries, it is recommended to call the {@see Parentheses::getLastOwner()}
-     * method directly._
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return bool
-     */
-    public static function inEmpty(File $phpcsFile, $stackPtr)
-    {
-        return (Parentheses::getLastOwner($phpcsFile, $stackPtr, \T_EMPTY) !== false);
-    }
-
-    /**
-     * Check whether an arbitrary token is within a call to isset().
-     *
-     * _This method is a thin, descriptive wrapper around the {@see Parentheses::getLastOwner()} method.
-     * For more complex/combined queries, it is recommended to call the {@see Parentheses::getLastOwner()}
-     * method directly._
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return bool
-     */
-    public static function inIsset(File $phpcsFile, $stackPtr)
-    {
-        return (Parentheses::getLastOwner($phpcsFile, $stackPtr, \T_ISSET) !== false);
-    }
-
-    /**
-     * Check whether an arbitrary token is within a call to unset().
-     *
-     * _This method is a thin, descriptive wrapper around the {@see Parentheses::getLastOwner()} method.
-     * For more complex/combined queries, it is recommended to call the {@see Parentheses::getLastOwner()}
-     * method directly._
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return bool
-     */
-    public static function inUnset(File $phpcsFile, $stackPtr)
-    {
-        return (Parentheses::getLastOwner($phpcsFile, $stackPtr, \T_UNSET) !== false);
-    }
-
-    /**
-     * Check whether an arbitrary token is within an attribute.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return bool
-     */
-    public static function inAttribute(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Check for the existence of the token.
-        if (isset($tokens[$stackPtr]) === false) {
-            return false;
-        }
-
-        if (isset($tokens[$stackPtr]['attribute_opener'], $tokens[$stackPtr]['attribute_closer']) === false) {
-            return false;
-        }
-
-        return ($stackPtr !== $tokens[$stackPtr]['attribute_opener']
-            && $stackPtr !== $tokens[$stackPtr]['attribute_closer']);
-    }
-
-    /**
-     * Check whether an arbitrary token is in a foreach condition and if so, in which part:
-     * before or after the "as".
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return string|false String `'beforeAs'`, `'as'` or `'afterAs'` when the token is within
-     *                      a `foreach` condition.
-     *                      `FALSE` in all other cases, including for parse errors.
-     */
-    public static function inForeachCondition(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Check for the existence of the token.
-        if (isset($tokens[$stackPtr]) === false) {
-            return false;
-        }
-
-        $foreach = Parentheses::getLastOwner($phpcsFile, $stackPtr, \T_FOREACH);
-        if ($foreach === false) {
-            return false;
-        }
-
-        if ($tokens[$stackPtr]['code'] === \T_AS) {
-            return 'as';
-        }
-
-        $asPtr = $phpcsFile->findNext(
-            \T_AS,
-            ($tokens[$foreach]['parenthesis_opener'] + 1),
-            $tokens[$foreach]['parenthesis_closer']
-        );
-
-        if ($asPtr === false) {
-            // Parse error or live coding.
-            return false;
-        }
-
-        if ($stackPtr < $asPtr) {
-            return 'beforeAs';
-        }
-
-        return 'afterAs';
-    }
-
-    /**
-     * Check whether an arbitrary token is in a for condition and if so, in which part:
-     * the first, second or third expression.
-     *
-     * Note: the semicolons separating the conditions are regarded as belonging with the
-     * expression before it.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the token we are checking.
-     *
-     * @return string|false String `'expr1'`, `'expr2'` or `'expr3'` when the token is within
-     *                      a `for` condition.
-     *                      `FALSE` in all other cases, including for parse errors.
-     */
-    public static function inForCondition(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        // Check for the existence of the token.
-        if (isset($tokens[$stackPtr]) === false) {
-            return false;
-        }
-
-        $for = Parentheses::getLastOwner($phpcsFile, $stackPtr, \T_FOR);
-        if ($for === false) {
-            return false;
-        }
-
-        $semicolons = [];
-        $count      = 0;
-        $opener     = $tokens[$for]['parenthesis_opener'];
-        $closer     = $tokens[$for]['parenthesis_closer'];
-        $level      = $tokens[$for]['level'];
-        $parens     = 1;
-
-        if (isset($tokens[$for]['nested_parenthesis'])) {
-            $parens = (\count($tokens[$for]['nested_parenthesis']) + 1);
-        }
-
-        for ($i = ($opener + 1); $i < $closer; $i++) {
-            if ($tokens[$i]['code'] !== \T_SEMICOLON) {
-                continue;
-            }
-
-            if ($tokens[$i]['level'] !== $level
-                || \count($tokens[$i]['nested_parenthesis']) !== $parens
-            ) {
-                // Disregard semicolons at lower nesting/condition levels.
-                continue;
-            }
-
-            ++$count;
-            $semicolons[$count] = $i;
-        }
-
-        if ($count !== 2) {
-            return false;
-        }
-
-        foreach ($semicolons as $key => $ptr) {
-            if ($stackPtr <= $ptr) {
-                return 'expr' .  $key;
-            }
-        }
-
-        return 'expr3';
-    }
-}