sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Arrays/DuplicateArrayKeySniff.php

@@ -1,297 +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\Arrays;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\AbstractSniffs\AbstractArrayDeclarationSniff;
-use PHPCSUtils\BackCompat\Helper;
-
-/**
- * Detect duplicate array keys in array declarations.
- *
- * This sniff will detect duplicate keys with high precision, though any array key
- * set via a variable/constant/function call is excluded from the examination.
- *
- * The sniff will handle the change in how numeric array keys are set
- * since PHP 8.0 and will flag keys which would be duplicates cross-version.
- * {@link https://wiki.php.net/rfc/negative_array_index}
- *
- * @since 1.0.0
- */
-final class DuplicateArrayKeySniff extends AbstractArrayDeclarationSniff
-{
-
-    /**
-     * Keep track of which array keys have been seen already on PHP < 8.0.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int, array<string, int>>
-     */
-    private $keysSeenLt8 = [];
-
-    /**
-     * Keep track of which array keys have been seen already on PHP >= 8.0.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int, array<string, int>>
-     */
-    private $keysSeenGt8 = [];
-
-    /**
-     * Keep track of the maximum seen integer key to know what the next value will be for
-     * array items without a key on PHP < 8.0.
-     *
-     * @since 1.0.0
-     *
-     * @var int
-     */
-    private $currentMaxIntKeyLt8;
-
-    /**
-     * Keep track of the maximum seen integer key to know what the next value will be for
-     * array items without a key on PHP >= 8.0.
-     *
-     * @since 1.0.0
-     *
-     * @var int
-     */
-    private $currentMaxIntKeyGt8;
-
-    /**
-     * PHP version as configured or -1 if unknown.
-     *
-     * @since 1.0.0
-     *
-     * @var int
-     */
-    private $phpVersion;
-
-    /**
-     * Process every part of the array declaration.
-     *
-     * This contains the default logic for the sniff, but can be overloaded in a concrete child class
-     * if needed.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     *
-     * @return void
-     */
-    public function processArray(File $phpcsFile)
-    {
-        // Reset properties before processing this array.
-        $this->keysSeenLt8 = [];
-        $this->keysSeenGt8 = [];
-
-        if (isset($this->phpVersion) === false) {
-            // Set default value to prevent this code from running every time the sniff is triggered.
-            $this->phpVersion = -1;
-
-            $phpVersion = Helper::getConfigData('php_version');
-            if ($phpVersion !== null) {
-                $this->phpVersion = (int) $phpVersion;
-            }
-        }
-
-        unset($this->currentMaxIntKeyLt8, $this->currentMaxIntKeyGt8);
-
-        parent::processArray($phpcsFile);
-    }
-
-    /**
-     * Process the tokens in an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the "key" part of
-     *                                               an array item.
-     * @param int                         $endPtr    The stack pointer to the last token in the "key" part of
-     *                                               an array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return void
-     */
-    public function processKey(File $phpcsFile, $startPtr, $endPtr, $itemNr)
-    {
-        $key = $this->getActualArrayKey($phpcsFile, $startPtr, $endPtr);
-
-        if (isset($key) === false) {
-            // Key could not be determined.
-            return;
-        }
-
-        $integerKey = \is_int($key);
-
-        $errorMsg  = 'Duplicate array key found. The value will be overwritten%s.'
-            . ' The %s array key "%s" was first seen on line %d';
-        $errorCode = 'Found';
-        $errors    = [];
-        $baseData  = [
-            ($integerKey === true) ? 'integer' : 'string',
-            $key,
-        ];
-
-        /*
-         * Check if we've seen the key before.
-         */
-        if (($this->phpVersion === -1 || $this->phpVersion < 80000)
-            && isset($this->keysSeenLt8[$key]) === true
-        ) {
-            $errors['phplt8'] = [
-                'data_subset'  => $baseData,
-                'error_suffix' => '',
-                'code_suffix'  => '',
-            ];
-
-            if ($integerKey === true) {
-                $errors['phplt8']['error_suffix'] = ' when using PHP < 8.0';
-                $errors['phplt8']['code_suffix']  = 'ForPHPlt80';
-            }
-
-            $firstSeen              = $this->keysSeenLt8[$key];
-            $firstNonEmptyFirstSeen = $phpcsFile->findNext(Tokens::$emptyTokens, $firstSeen['ptr'], null, true);
-
-            $errors['phplt8']['data_subset'][] = $this->tokens[$firstNonEmptyFirstSeen]['line'];
-        }
-
-        if (($this->phpVersion === -1 || $this->phpVersion >= 80000)
-            && isset($this->keysSeenGt8[$key]) === true
-        ) {
-            $errors['phpgt8'] = [
-                'data_subset'  => $baseData,
-                'error_suffix' => '',
-                'code_suffix'  => '',
-            ];
-
-            if ($integerKey === true) {
-                $errors['phpgt8']['error_suffix'] = ' when using PHP >= 8.0';
-                $errors['phpgt8']['code_suffix']  = 'ForPHPgte80';
-            }
-
-            $firstSeen              = $this->keysSeenGt8[$key];
-            $firstNonEmptyFirstSeen = $phpcsFile->findNext(Tokens::$emptyTokens, $firstSeen['ptr'], null, true);
-
-            $errors['phpgt8']['data_subset'][] = $this->tokens[$firstNonEmptyFirstSeen]['line'];
-        }
-
-        /*
-         * Throw the error(s).
-         *
-         * If no PHP version was passed, throw errors both for PHP < 8.0 and PHP >= 8.0.
-         * If a PHP version was set, only throw the error appropriate for the selected PHP version.
-         * If both errors would effectively be the same, only throw one.
-         */
-        if ($errors !== []) {
-            $firstNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, $startPtr, null, true);
-
-            if (isset($errors['phplt8'], $errors['phpgt8'])
-                && $errors['phplt8']['data_subset'] === $errors['phpgt8']['data_subset']
-            ) {
-                // Only throw the error once if it would be the same for PHP < 8.0 and PHP >= 8.0.
-                $data = $errors['phplt8']['data_subset'];
-                \array_unshift($data, '');
-
-                $phpcsFile->addError($errorMsg, $firstNonEmpty, $errorCode, $data);
-                return;
-            }
-
-            if (isset($errors['phplt8'])) {
-                $code = $errorCode . $errors['phplt8']['code_suffix'];
-                $data = $errors['phplt8']['data_subset'];
-                \array_unshift($data, $errors['phplt8']['error_suffix']);
-
-                $phpcsFile->addError($errorMsg, $firstNonEmpty, $code, $data);
-            }
-
-            if (isset($errors['phpgt8'])) {
-                $code = $errorCode . $errors['phpgt8']['code_suffix'];
-                $data = $errors['phpgt8']['data_subset'];
-                \array_unshift($data, $errors['phpgt8']['error_suffix']);
-
-                $phpcsFile->addError($errorMsg, $firstNonEmpty, $code, $data);
-            }
-
-            return;
-        }
-
-        /*
-         * Key not seen before. Add to arrays.
-         */
-        $this->keysSeenLt8[$key] = [
-            'item' => $itemNr,
-            'ptr'  => $startPtr,
-        ];
-        $this->keysSeenGt8[$key] = [
-            'item' => $itemNr,
-            'ptr'  => $startPtr,
-        ];
-
-        if ($integerKey === true) {
-            if ((isset($this->currentMaxIntKeyLt8) === false && $key > -1)
-                || (isset($this->currentMaxIntKeyLt8) === true && $key > $this->currentMaxIntKeyLt8)
-            ) {
-                $this->currentMaxIntKeyLt8 = $key;
-            }
-
-            if (isset($this->currentMaxIntKeyGt8) === false
-                || $key > $this->currentMaxIntKeyGt8
-            ) {
-                $this->currentMaxIntKeyGt8 = $key;
-            }
-        }
-    }
-
-    /**
-     * Process an array item without an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the array item,
-     *                                               which in this case will be the first token of the array
-     *                                               value part of the array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return void
-     */
-    public function processNoKey(File $phpcsFile, $startPtr, $itemNr)
-    {
-        // Track the key for PHP < 8.0.
-        if (isset($this->currentMaxIntKeyLt8) === false) {
-            $this->currentMaxIntKeyLt8 = -1;
-        }
-
-        ++$this->currentMaxIntKeyLt8;
-        $this->keysSeenLt8[$this->currentMaxIntKeyLt8] = [
-            'item' => $itemNr,
-            'ptr'  => $startPtr,
-        ];
-
-        // Track the key for PHP 8.0+.
-        if (isset($this->currentMaxIntKeyGt8) === false) {
-            $this->currentMaxIntKeyGt8 = -1;
-        }
-
-        ++$this->currentMaxIntKeyGt8;
-        $this->keysSeenGt8[$this->currentMaxIntKeyGt8] = [
-            'item' => $itemNr,
-            'ptr'  => $startPtr,
-        ];
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Arrays/MixedArrayKeyTypesSniff.php

@@ -1,174 +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\Arrays;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\AbstractSniffs\AbstractArrayDeclarationSniff;
-
-/**
- * Forbid arrays which contain both array items with numeric keys as well as array items with string keys.
- *
- * @since 1.0.0
- */
-final class MixedArrayKeyTypesSniff extends AbstractArrayDeclarationSniff
-{
-
-    /**
-     * Whether a string key was encountered.
-     *
-     * @var bool
-     */
-    private $seenStringKey = false;
-
-    /**
-     * Whether a numeric key was encountered.
-     *
-     * @var bool
-     */
-    private $seenNumericKey = false;
-
-    /**
-     * Process the array declaration.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     *
-     * @return void
-     */
-    public function processArray(File $phpcsFile)
-    {
-        // Reset properties before processing this array.
-        $this->seenStringKey  = false;
-        $this->seenNumericKey = false;
-
-        parent::processArray($phpcsFile);
-    }
-
-    /**
-     * Process the tokens in an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the "key" part of
-     *                                               an array item.
-     * @param int                         $endPtr    The stack pointer to the last token in the "key" part of
-     *                                               an array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return true|void Returning `TRUE` will short-circuit the array item loop and stop processing.
-     *                   In effect, this means that the sniff will not examine the double arrow, the array
-     *                   value or comma for this array item and will not process any array items after this one.
-     */
-    public function processKey(File $phpcsFile, $startPtr, $endPtr, $itemNr)
-    {
-        $key = $this->getActualArrayKey($phpcsFile, $startPtr, $endPtr);
-        if (isset($key) === false) {
-            // Key could not be determined.
-            return;
-        }
-
-        $integerKey = \is_int($key);
-
-        // Handle integer key.
-        if ($integerKey === true) {
-            if ($this->seenStringKey === false) {
-                if ($this->seenNumericKey !== false) {
-                    // Already seen a numeric key before.
-                    return;
-                }
-
-                $this->seenNumericKey = true;
-                return;
-            }
-
-            // Ok, so we've seen a string key before and now see an explicit numeric key.
-            $firstNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, $startPtr, null, true);
-            $phpcsFile->addError(
-                'Arrays should have either numeric keys or string keys. Explicit numeric key detected,'
-                    . ' while all previous keys in this array were string keys.',
-                $firstNonEmpty,
-                'ExplicitNumericKey'
-            );
-
-            // Stop the loop.
-            return true;
-        }
-
-        // Handle string key.
-        if ($this->seenNumericKey === false) {
-            if ($this->seenStringKey !== false) {
-                // Already seen a string key before.
-                return;
-            }
-
-            $this->seenStringKey = true;
-            return;
-        }
-
-        // Ok, so we've seen a numeric key before and now see a string key.
-        $firstNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, $startPtr, null, true);
-        $phpcsFile->addError(
-            'Arrays should have either numeric keys or string keys. String key detected,'
-                . ' while all previous keys in this array were integer based keys.',
-            $firstNonEmpty,
-            'StringKey'
-        );
-
-        // Stop the loop.
-        return true;
-    }
-
-    /**
-     * Process an array item without an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the array item,
-     *                                               which in this case will be the first token of the array
-     *                                               value part of the array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return true|void Returning `TRUE` will short-circuit the array item loop and stop processing.
-     *                   In effect, this means that the sniff will not examine the array value or
-     *                   comma for this array item and will not process any array items after this one.
-     */
-    public function processNoKey(File $phpcsFile, $startPtr, $itemNr)
-    {
-        if ($this->seenStringKey === false) {
-            if ($this->seenNumericKey !== false) {
-                // Already seen a numeric key before.
-                return;
-            }
-
-            $this->seenNumericKey = true;
-            return;
-        }
-
-        // Ok, so we've seen a string key before and now see an implicit numeric key.
-        $firstNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, $startPtr, null, true);
-        $phpcsFile->addError(
-            'Arrays should have either numeric keys or string keys. Implicit numeric key detected,'
-                . ' while all previous keys in this array were string keys.',
-            $firstNonEmpty,
-            'ImplicitNumericKey'
-        );
-
-        // Stop the loop.
-        return true;
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Arrays/MixedKeyedUnkeyedArraySniff.php

@@ -1,134 +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\Arrays;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\AbstractSniffs\AbstractArrayDeclarationSniff;
-
-/**
- * Forbid arrays which contain both array items with an explicit key and array items without a key set.
- *
- * @since 1.0.0
- */
-final class MixedKeyedUnkeyedArraySniff extends AbstractArrayDeclarationSniff
-{
-
-    /**
-     * Whether or not any array items with a key were encountered in the array.
-     *
-     * @since 1.0.0
-     *
-     * @var bool
-     */
-    private $hasKeys = false;
-
-    /**
-     * Cache of any array items encountered without keys up to the time an array item _with_ a key is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int, int> Key is the item number; value the stack point to the first non empty token in the item.
-     */
-    private $itemsWithoutKey = [];
-
-    /**
-     * Process the array declaration.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     *
-     * @return void
-     */
-    public function processArray(File $phpcsFile)
-    {
-        // Reset properties before processing this array.
-        $this->hasKeys         = false;
-        $this->itemsWithoutKey = [];
-
-        parent::processArray($phpcsFile);
-    }
-
-    /**
-     * Process the tokens in an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the "key" part of
-     *                                               an array item.
-     * @param int                         $endPtr    The stack pointer to the last token in the "key" part of
-     *                                               an array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return void
-     */
-    public function processKey(File $phpcsFile, $startPtr, $endPtr, $itemNr)
-    {
-        $this->hasKeys = true;
-
-        // Process any previously encountered items without keys.
-        if (empty($this->itemsWithoutKey) === false) {
-            foreach ($this->itemsWithoutKey as $itemNr => $stackPtr) {
-                $phpcsFile->addError(
-                    'Inconsistent array detected. A mix of keyed and unkeyed array items is not allowed.'
-                        . ' The array item in position %d does not have an array key.',
-                    $stackPtr,
-                    'Found',
-                    [$itemNr]
-                );
-            }
-
-            // No need to do this again.
-            $this->itemsWithoutKey = [];
-        }
-    }
-
-    /**
-     * Process an array item without an array key.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
-     *                                               token was found.
-     * @param int                         $startPtr  The stack pointer to the first token in the array item,
-     *                                               which in this case will be the first token of the array
-     *                                               value part of the array item.
-     * @param int                         $itemNr    Which item in the array is being handled.
-     *
-     * @return void
-     */
-    public function processNoKey(File $phpcsFile, $startPtr, $itemNr)
-    {
-        $firstNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, $startPtr, null, true);
-        if ($firstNonEmpty === false || $this->tokens[$firstNonEmpty]['code'] === \T_COMMA) {
-            // Shouldn't really be possible, but this must be a parse error (empty array item).
-            return;
-        }
-
-        // If we already know there are keys in the array, throw an error message straight away.
-        if ($this->hasKeys === true) {
-            $phpcsFile->addError(
-                'Inconsistent array detected. A mix of keyed and unkeyed array items is not allowed.'
-                    . ' The array item in position %d does not have an array key.',
-                $firstNonEmpty,
-                'Found',
-                [$itemNr]
-            );
-        } else {
-            // Save the array item info for later in case we do encounter an array key later on in the array.
-            $this->itemsWithoutKey[$itemNr] = $firstNonEmpty;
-        }
-    }
-}