sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/CodeAnalysis/NoEchoSprintfSniff.php

@@ -1,131 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2023 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\CodeAnalysis;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-
-/**
- * Detects use of `echo [v]sprintf();.
- *
- * @link https://www.php.net/manual/en/function.printf.php
- * @link https://www.php.net/manual/en/function.sprintf.php
- * @link https://www.php.net/manual/en/function.vprintf.php
- * @link https://www.php.net/manual/en/function.vsprintf.php
- *
- * @since 1.1.0
- */
-final class NoEchoSprintfSniff implements Sniff
-{
-
-    /**
-     * Functions to look for with their replacements.
-     *
-     * @since 1.1.0
-     *
-     * @var array<string, string>
-     */
-    private $targetFunctions = [
-        'sprintf'  => 'printf',
-        'vsprintf' => 'vprintf',
-    ];
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.1.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_ECHO];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.1.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        $skip   = Tokens::$emptyTokens;
-        $skip[] = \T_NS_SEPARATOR;
-
-        $next = $phpcsFile->findNext($skip, ($stackPtr + 1), null, true);
-        if ($next === false
-            || $tokens[$next]['code'] !== \T_STRING
-            || isset($this->targetFunctions[\strtolower($tokens[$next]['content'])]) === false
-        ) {
-            // Not our target.
-            return;
-        }
-
-        $detectedFunction = \strtolower($tokens[$next]['content']);
-
-        $openParens = $phpcsFile->findNext(Tokens::$emptyTokens, ($next + 1), null, true);
-        if ($openParens === false
-            || $tokens[$openParens]['code'] !== \T_OPEN_PARENTHESIS
-            || isset($tokens[$openParens]['parenthesis_closer']) === false
-        ) {
-            // Live coding/parse error.
-            return;
-        }
-
-        $closeParens       = $tokens[$openParens]['parenthesis_closer'];
-        $afterFunctionCall = $phpcsFile->findNext(Tokens::$emptyTokens, ($closeParens + 1), null, true);
-        if ($afterFunctionCall === false
-            || ($tokens[$afterFunctionCall]['code'] !== \T_SEMICOLON
-            && $tokens[$afterFunctionCall]['code'] !== \T_CLOSE_TAG)
-        ) {
-            // Live coding/parse error or compound echo statement.
-            return;
-        }
-
-        $fix = $phpcsFile->addFixableError(
-            'Unnecessary "echo %s(...)" found. Use "%s(...)" instead.',
-            $next,
-            'Found',
-            [
-                $tokens[$next]['content'],
-                $this->targetFunctions[$detectedFunction],
-            ]
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-
-            // Remove echo and whitespace.
-            $phpcsFile->fixer->replaceToken($stackPtr, '');
-
-            for ($i = ($stackPtr + 1); $i < $next; $i++) {
-                if ($tokens[$i]['code'] !== \T_WHITESPACE) {
-                    break;
-                }
-
-                $phpcsFile->fixer->replaceToken($i, '');
-            }
-
-            $phpcsFile->fixer->replaceToken($next, $this->targetFunctions[$detectedFunction]);
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/CodeAnalysis/StaticInFinalClassSniff.php

@@ -1,216 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2020 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\CodeAnalysis;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\Conditions;
-use PHPCSUtils\Utils\FunctionDeclarations;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\ObjectDeclarations;
-use PHPCSUtils\Utils\Scopes;
-
-/**
- * Forbid the use of the `static` keyword for late static binding in OO constructs which are final.
- *
- * @since 1.0.0
- */
-final class StaticInFinalClassSniff implements Sniff
-{
-
-    /**
-     * OO Scopes in which late static binding is useless.
-     *
-     * @var array<int|string>
-     */
-    private $validOOScopes = [
-        \T_CLASS,      // Only if final.
-        \T_ANON_CLASS, // Final by nature.
-        \T_ENUM,       // Final by design.
-    ];
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [
-            // These tokens are used to retrieve return types reliably.
-            \T_FUNCTION,
-            \T_FN,
-            // While this is our "real" target.
-            \T_STATIC,
-            // But we also need this as after "instanceof", `static` is tokenized as `T_STRING in PHPCS < 4.0.0.
-            // See: https://github.com/squizlabs/PHP_CodeSniffer/pull/3121
-            \T_STRING,
-        ];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return int|void Integer stack pointer to skip forward or void to continue
-     *                  normal file processing.
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        if ($tokens[$stackPtr]['code'] === \T_STRING
-            && \strtolower($tokens[$stackPtr]['content']) !== 'static'
-        ) {
-            return;
-        }
-
-        if ($tokens[$stackPtr]['code'] === \T_FUNCTION
-            || $tokens[$stackPtr]['code'] === \T_FN
-        ) {
-            /*
-             * Check return types for methods in final classes, anon classes and enums.
-             *
-             * Will return the scope opener of the function to prevent potential duplicate notifications.
-             */
-            $scopeOpener = $stackPtr;
-            if (isset($tokens[$stackPtr]['scope_opener']) === true) {
-                $scopeOpener = $tokens[$stackPtr]['scope_opener'];
-            }
-
-            if ($tokens[$stackPtr]['code'] === \T_FUNCTION) {
-                $ooPtr = Scopes::validDirectScope($phpcsFile, $stackPtr, $this->validOOScopes);
-                if ($ooPtr === false) {
-                    // Method in a trait (not known where it is used), interface (never final) or not in an OO scope.
-                    return $scopeOpener;
-                }
-            } else {
-                $ooPtr = Conditions::getLastCondition($phpcsFile, $stackPtr, $this->validOOScopes);
-                if ($ooPtr === false) {
-                    // Arrow function outside of OO.
-                    return $scopeOpener;
-                }
-            }
-
-            if ($tokens[$ooPtr]['code'] === \T_CLASS) {
-                $classProps = ObjectDeclarations::getClassProperties($phpcsFile, $ooPtr);
-                if ($classProps['is_final'] === false) {
-                    // Method in a non-final class.
-                    return $scopeOpener;
-                }
-            }
-
-            $functionProps = FunctionDeclarations::getProperties($phpcsFile, $stackPtr);
-            if ($functionProps['return_type'] === '') {
-                return $scopeOpener;
-            }
-
-            $staticPtr = $phpcsFile->findNext(
-                \T_STATIC,
-                $functionProps['return_type_token'],
-                ($functionProps['return_type_end_token'] + 1)
-            );
-
-            if ($staticPtr === false) {
-                return $scopeOpener;
-            }
-
-            // Found a return type containing the `static` type.
-            $this->handleError($phpcsFile, $staticPtr, 'ReturnType', '"static" return type');
-
-            return $scopeOpener;
-        }
-
-        /*
-         * Check other uses of static.
-         */
-        $functionPtr = Conditions::getLastCondition($phpcsFile, $stackPtr, [\T_FUNCTION, \T_CLOSURE]);
-        if ($functionPtr === false || $tokens[$functionPtr]['code'] === \T_CLOSURE) {
-            /*
-             * When `false`, this code is absolutely invalid, but not something to be addressed via this sniff.
-             * When a closure, we're not interested in it. The closure class is final, but closures
-             * can be bound to other classes. This needs further research and should maybe get its own sniff.
-             */
-            return;
-        }
-
-        $ooPtr = Scopes::validDirectScope($phpcsFile, $functionPtr, $this->validOOScopes);
-        if ($ooPtr === false) {
-            // Not in an OO context.
-            return;
-        }
-
-        if ($tokens[$ooPtr]['code'] === \T_CLASS) {
-            $classProps = ObjectDeclarations::getClassProperties($phpcsFile, $ooPtr);
-            if ($classProps['is_final'] === false) {
-                // Token in a non-final class.
-                return;
-            }
-        }
-
-        $prevNonEmpty = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-        if ($prevNonEmpty !== false) {
-            if ($tokens[$prevNonEmpty]['code'] === \T_INSTANCEOF) {
-                $prevPrevNonEmpty = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($prevNonEmpty - 1), null, true);
-                $extraMsg         = GetTokensAsString::compact($phpcsFile, $prevPrevNonEmpty, $stackPtr, true);
-                $this->handleError($phpcsFile, $stackPtr, 'InstanceOf', '"' . $extraMsg . '"');
-                return;
-            }
-
-            if ($tokens[$prevNonEmpty]['code'] === \T_NEW) {
-                $this->handleError($phpcsFile, $stackPtr, 'NewInstance', '"new static"');
-                return;
-            }
-        }
-
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextNonEmpty !== false && $tokens[$nextNonEmpty]['code'] === \T_DOUBLE_COLON) {
-            $nextNextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($nextNonEmpty + 1), null, true);
-            $extraMsg         = GetTokensAsString::compact($phpcsFile, $stackPtr, $nextNextNonEmpty, true);
-            $this->handleError($phpcsFile, $stackPtr, 'ScopeResolution', '"' . $extraMsg . '"');
-            return;
-        }
-    }
-
-    /**
-     * Throw and potentially fix the error.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of erroneous `T_STATIC` token.
-     * @param string                      $errorCode The error code for the message.
-     * @param string                      $extraMsg  Addition to the error message.
-     *
-     * @return void
-     */
-    private function handleError($phpcsFile, $stackPtr, $errorCode, $extraMsg)
-    {
-        $fix = $phpcsFile->addFixableError(
-            'Use "self" instead of "static" when using late static binding in a final OO construct. Found: %s',
-            $stackPtr,
-            $errorCode,
-            [$extraMsg]
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->replaceToken($stackPtr, 'self');
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Constants/LowercaseClassResolutionKeywordSniff.php

@@ -1,106 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2020 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\Constants;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-
-/**
- * Verifies that the "::class" keyword when used for class name resolution is in lowercase.
- *
- * @link https://www.php.net/manual/en/language.constants.predefined.php
- * @link https://www.php.net/manual/en/language.oop5.basic.php#language.oop5.basic.class.class
- *
- * @since 1.0.0
- */
-final class LowercaseClassResolutionKeywordSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Magic ::class constant case';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_STRING];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens    = $phpcsFile->getTokens();
-        $content   = $tokens[$stackPtr]['content'];
-        $contentLC = \strtolower($content);
-
-        if ($contentLC !== 'class') {
-            return;
-        }
-
-        $nextToken = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextToken !== false && $tokens[$nextToken]['code'] === \T_OPEN_PARENTHESIS) {
-            // Function call or declaration for a function called "class".
-            return;
-        }
-
-        $prevToken = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-        if ($prevToken === false || $tokens[$prevToken]['code'] !== \T_DOUBLE_COLON) {
-            return;
-        }
-
-        if ($contentLC === $content) {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'lowercase');
-            return;
-        }
-
-        $error = "The ::class keyword for class name resolution must be in lowercase. Expected: '::%s'; found: '::%s'";
-        $data  = [
-            $contentLC,
-            $content,
-        ];
-
-        $errorCode = '';
-        if (\strtoupper($content) === $content) {
-            $errorCode = 'Uppercase';
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'uppercase');
-        } else {
-            $errorCode = 'Mixedcase';
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'mixed case');
-        }
-
-        $fix = $phpcsFile->addFixableError($error, $stackPtr, $errorCode, $data);
-        if ($fix === true) {
-            $phpcsFile->fixer->replaceToken($stackPtr, $contentLC);
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Constants/ModifierKeywordOrderSniff.php

@@ -1,199 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2022 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\Constants;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\Scopes;
-
-/**
- * Standardize the modifier keyword order for OO constant declarations.
- *
- * @since 1.0.0
- */
-final class ModifierKeywordOrderSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'OO constant modifier keyword order';
-
-    /**
-     * Order preference: final visibility.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const FINAL_VISIBILITY = 'final visibility';
-
-    /**
-     * Order preference: visibility final.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const VISIBILITY_FINAL = 'visibility final';
-
-    /**
-     * Preferred order for the modifier keywords.
-     *
-     * Accepted values:
-     * - "final visibility".
-     * - or "visibility final".
-     *
-     * Defaults to "final visibility".
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    public $order = self::FINAL_VISIBILITY;
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_CONST];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        if (Scopes::isOOConstant($phpcsFile, $stackPtr) === false) {
-            return;
-        }
-
-        $tokens = $phpcsFile->getTokens();
-        $valid  = Collections::constantModifierKeywords() + Tokens::$emptyTokens;
-
-        $finalPtr      = false;
-        $visibilityPtr = false;
-
-        for ($i = ($stackPtr - 1); $i > 0; $i--) {
-            if (isset($valid[$tokens[$i]['code']]) === false) {
-                break;
-            }
-
-            if (isset(Tokens::$emptyTokens[$tokens[$i]['code']]) === true) {
-                continue;
-            }
-
-            if ($tokens[$i]['code'] === \T_FINAL) {
-                $finalPtr = $i;
-            } else {
-                $visibilityPtr = $i;
-            }
-        }
-
-        if ($finalPtr === false || $visibilityPtr === false) {
-            /*
-             * Either no modifier keywords found at all; or only one type of modifier
-             * keyword (final or visibility) declared, but not both. No ordering needed.
-             */
-            return;
-        }
-
-        if ($visibilityPtr < $finalPtr) {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, self::VISIBILITY_FINAL);
-        } else {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, self::FINAL_VISIBILITY);
-        }
-
-        $message = 'OO constant modifier keywords are not in the correct order. Expected: "%s", found: "%s"';
-
-        switch ($this->order) {
-            case self::VISIBILITY_FINAL:
-                if ($visibilityPtr < $finalPtr) {
-                    // Order is correct. Nothing to do.
-                    return;
-                }
-
-                $this->handleError($phpcsFile, $finalPtr, $visibilityPtr);
-                break;
-
-            case self::FINAL_VISIBILITY:
-            default:
-                if ($finalPtr < $visibilityPtr) {
-                    // Order is correct. Nothing to do.
-                    return;
-                }
-
-                $this->handleError($phpcsFile, $visibilityPtr, $finalPtr);
-                break;
-        }
-    }
-
-    /**
-     * Throw the error and potentially fix it.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile     The file being scanned.
-     * @param int                         $firstKeyword  The position of the first keyword found.
-     * @param int                         $secondKeyword The position of the second keyword token.
-     *
-     * @return void
-     */
-    private function handleError(File $phpcsFile, $firstKeyword, $secondKeyword)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        $message = 'Constant modifier keywords are not in the correct order. Expected: "%s", found: "%s"';
-        $data    = [
-            $tokens[$secondKeyword]['content'] . ' ' . $tokens[$firstKeyword]['content'],
-            $tokens[$firstKeyword]['content'] . ' ' . $tokens[$secondKeyword]['content'],
-        ];
-
-        $fix = $phpcsFile->addFixableError($message, $firstKeyword, 'Incorrect', $data);
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-
-            $phpcsFile->fixer->replaceToken($secondKeyword, '');
-
-            // Prevent leaving behind trailing whitespace.
-            $i = ($secondKeyword + 1);
-            while ($tokens[$i]['code'] === \T_WHITESPACE) {
-                $phpcsFile->fixer->replaceToken($i, '');
-                ++$i;
-            }
-
-            // Use the original token content as the case used for keywords is not the concern of this sniff.
-            $phpcsFile->fixer->addContentBefore($firstKeyword, $tokens[$secondKeyword]['content'] . ' ');
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}