sdc-build-wp 4.1.0 → 4.1.2

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/WP/DiscouragedFunctionsSniff.php

@@ -1,54 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\WP;
-
-use WordPressCS\WordPress\AbstractFunctionRestrictionsSniff;
-
-/**
- * Discourages the use of various WordPress functions and suggests alternatives.
- *
- * @since 0.11.0
- * @since 0.13.0 Class name changed: this class is now namespaced.
- */
-final class DiscouragedFunctionsSniff extends AbstractFunctionRestrictionsSniff {
-
-	/**
-	 * Groups of functions to restrict.
-	 *
-	 * Example: groups => array(
-	 *  'lambda' => array(
-	 *      'type'      => 'error' | 'warning',
-	 *      'message'   => 'Use anonymous functions instead please!',
-	 *      'functions' => array( 'file_get_contents', 'create_function' ),
-	 *  )
-	 * )
-	 *
-	 * @return array
-	 */
-	public function getGroups() {
-		return array(
-			'query_posts' => array(
-				'type'      => 'warning',
-				'message'   => '%s() is discouraged. Use WP_Query instead.',
-				'functions' => array(
-					'query_posts',
-				),
-			),
-
-			'wp_reset_query' => array(
-				'type'      => 'warning',
-				'message'   => '%s() is discouraged. Use wp_reset_postdata() instead.',
-				'functions' => array(
-					'wp_reset_query',
-				),
-			),
-		);
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/WP/EnqueuedResourceParametersSniff.php

@@ -1,241 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\WP;
-
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\Numbers;
-use PHPCSUtils\Utils\PassedParameters;
-use WordPressCS\WordPress\AbstractFunctionParameterSniff;
-
-/**
- * This checks the enqueued 4th and 5th parameters to make sure the version and in_footer are set.
- *
- * If a source ($src) value is passed, then version ($ver) needs to have non-falsy value.
- * If a source ($src) value is passed a check for in footer ($in_footer), warn the user if the value is falsy.
- *
- * @link https://developer.wordpress.org/reference/functions/wp_register_script/
- * @link https://developer.wordpress.org/reference/functions/wp_enqueue_script/
- * @link https://developer.wordpress.org/reference/functions/wp_register_style/
- * @link https://developer.wordpress.org/reference/functions/wp_enqueue_style/
- *
- * @since 1.0.0
- */
-final class EnqueuedResourceParametersSniff extends AbstractFunctionParameterSniff {
-
-	/**
-	 * The group name for this group of functions.
-	 *
-	 * @since 1.0.0
-	 *
-	 * @var string
-	 */
-	protected $group_name = 'Enqueued';
-
-	/**
-	 * List of enqueued functions that need to be checked for use of the in_footer and version arguments.
-	 *
-	 * @since 1.0.0
-	 *
-	 * @var array<string, true> Key is function name, value irrelevant.
-	 */
-	protected $target_functions = array(
-		'wp_register_script' => true,
-		'wp_enqueue_script'  => true,
-		'wp_register_style'  => true,
-		'wp_enqueue_style'   => true,
-	);
-
-	/**
-	 * False + the empty tokens array.
-	 *
-	 * This array is enriched with the $emptyTokens array in the register() method.
-	 *
-	 * @var array<int|string, int|string>
-	 */
-	private $false_tokens = array(
-		\T_FALSE => \T_FALSE,
-	);
-
-	/**
-	 * Token codes which are "safe" to accept to determine whether a version would evaluate to `false`.
-	 *
-	 * This array is enriched with the several of the PHPCS token arrays in the register() method.
-	 *
-	 * @var array<int|string, int|string>
-	 */
-	private $safe_tokens = array(
-		\T_NULL                     => \T_NULL,
-		\T_FALSE                    => \T_FALSE,
-		\T_TRUE                     => \T_TRUE,
-		\T_LNUMBER                  => \T_LNUMBER,
-		\T_DNUMBER                  => \T_DNUMBER,
-		\T_CONSTANT_ENCAPSED_STRING => \T_CONSTANT_ENCAPSED_STRING,
-		\T_START_NOWDOC             => \T_START_NOWDOC,
-		\T_NOWDOC                   => \T_NOWDOC,
-		\T_END_NOWDOC               => \T_END_NOWDOC,
-		\T_OPEN_PARENTHESIS         => \T_OPEN_PARENTHESIS,
-		\T_CLOSE_PARENTHESIS        => \T_CLOSE_PARENTHESIS,
-		\T_STRING_CONCAT            => \T_STRING_CONCAT,
-	);
-
-	/**
-	 * Returns an array of tokens this test wants to listen for.
-	 *
-	 * Overloads and calls the parent method to allow for adding additional tokens to the $safe_tokens property.
-	 *
-	 * @return array
-	 */
-	public function register() {
-		$this->false_tokens += Tokens::$emptyTokens;
-
-		$this->safe_tokens += Tokens::$emptyTokens;
-		$this->safe_tokens += Tokens::$assignmentTokens;
-		$this->safe_tokens += Tokens::$comparisonTokens;
-		$this->safe_tokens += Tokens::$operators;
-		$this->safe_tokens += Tokens::$booleanOperators;
-		$this->safe_tokens += Tokens::$castTokens;
-
-		return parent::register();
-	}
-
-	/**
-	 * Process the parameters of a matched function.
-	 *
-	 * @since 1.0.0
-	 *
-	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param string $group_name      The name of the group which was matched.
-	 * @param string $matched_content The token content (function name) which was matched
-	 *                                in lowercase.
-	 * @param array  $parameters      Array with information about the parameters.
-	 *
-	 * @return void
-	 */
-	public function process_parameters( $stackPtr, $group_name, $matched_content, $parameters ) {
-		// Check to see if a source ($src) is specified.
-		$src_param = PassedParameters::getParameterFromStack( $parameters, 2, 'src' );
-		if ( false === $src_param ) {
-			return;
-		}
-
-		/*
-		 * Version Check: Check to make sure the version is set explicitly.
-		 */
-
-		$version_param = PassedParameters::getParameterFromStack( $parameters, 4, 'ver' );
-
-		$error_ptr = $stackPtr;
-		if ( false !== $version_param ) {
-			$error_ptr = $this->phpcsFile->findNext( Tokens::$emptyTokens, $version_param['start'], ( $version_param['end'] + 1 ), true );
-			if ( false === $error_ptr ) {
-				$error_ptr = $version_param['start'];
-			}
-		}
-
-		if ( false === $version_param || 'null' === $version_param['clean'] ) {
-			$type = 'script';
-			if ( strpos( $matched_content, '_style' ) !== false ) {
-				$type = 'style';
-			}
-
-			$this->phpcsFile->addWarning(
-				'Resource version not set in call to %s(). This means new versions of the %s may not always be loaded due to browser caching.',
-				$error_ptr,
-				'MissingVersion',
-				array( $matched_content, $type )
-			);
-			// The version argument should have a non-false value.
-		} elseif ( $this->is_falsy( $version_param['start'], $version_param['end'] ) ) {
-			$this->phpcsFile->addError(
-				'Version parameter is not explicitly set or has been set to an equivalent of "false" for %s; ' .
-				'This means that the WordPress core version will be used which is not recommended for plugin or theme development.',
-				$error_ptr,
-				'NoExplicitVersion',
-				array( $matched_content )
-			);
-		}
-
-		/*
-		 * In footer Check
-		 *
-		 * Check to make sure that $in_footer is set to true.
-		 * It will warn the user to make sure it is intended.
-		 *
-		 * Only wp_register_script and wp_enqueue_script need this check,
-		 * as this parameter is not available to wp_register_style and wp_enqueue_style.
-		 */
-		if ( 'wp_register_script' !== $matched_content && 'wp_enqueue_script' !== $matched_content ) {
-			return;
-		}
-
-		$infooter_param = PassedParameters::getParameterFromStack( $parameters, 5, 'in_footer' );
-		if ( false === $infooter_param ) {
-			// If in footer is not set, throw a warning about the default.
-			$this->phpcsFile->addWarning(
-				'In footer ($in_footer) is not set explicitly %s; ' .
-				'It is recommended to load scripts in the footer. Please set this value to `true` to load it in the footer, or explicitly `false` if it should be loaded in the header.',
-				$stackPtr,
-				'NotInFooter',
-				array( $matched_content )
-			);
-		}
-	}
-
-	/**
-	 * Determine if a range has a falsy value.
-	 *
-	 * @param int $start The position to start looking from.
-	 * @param int $end   The position to stop looking (inclusive).
-	 *
-	 * @return bool True if the parameter is falsy.
-	 *              False if the parameter is not falsy or when it
-	 *              couldn't be reliably determined.
-	 */
-	protected function is_falsy( $start, $end ) {
-
-		// Find anything excluding the false tokens.
-		$has_non_false = $this->phpcsFile->findNext( $this->false_tokens, $start, ( $end + 1 ), true );
-		// If no non-false tokens are found, we are good.
-		if ( false === $has_non_false ) {
-			return true;
-		}
-
-		$code_string = '';
-		for ( $i = $start; $i <= $end; $i++ ) {
-			if ( isset( $this->safe_tokens[ $this->tokens[ $i ]['code'] ] ) === false ) {
-				// Function call/variable or other token which makes it neigh impossible
-				// to determine whether the actual value would evaluate to false.
-				return false;
-			}
-
-			if ( isset( Tokens::$emptyTokens[ $this->tokens[ $i ]['code'] ] ) === true ) {
-				continue;
-			}
-
-			// Make sure that PHP 7.4 numeric literals and PHP 8.1 explicit octals don't cause problems.
-			if ( \T_LNUMBER === $this->tokens[ $i ]['code'] || \T_DNUMBER === $this->tokens[ $i ]['code'] ) {
-				$number_info  = Numbers::getCompleteNumber( $this->phpcsFile, $i );
-				$code_string .= $number_info['decimal'];
-				$i            = $number_info['last_token'];
-				continue;
-			}
-
-			$code_string .= $this->tokens[ $i ]['content'];
-		}
-
-		if ( '' === $code_string ) {
-			return false;
-		}
-
-		// Evaluate the argument to figure out the outcome is false or not.
-		// phpcs:ignore Squiz.PHP.Eval -- No harm here.
-		return ( false === eval( "return (bool) $code_string;" ) );
-	}
-}

package/vendor/wp-coding-standards/wpcs/WordPress/Sniffs/WP/EnqueuedResourcesSniff.php

@@ -1,108 +0,0 @@
-<?php
-/**
- * WordPress Coding Standard.
- *
- * @package WPCS\WordPressCodingStandards
- * @link    https://github.com/WordPress/WordPress-Coding-Standards
- * @license https://opensource.org/licenses/MIT MIT
- */
-
-namespace WordPressCS\WordPress\Sniffs\WP;
-
-use PHP_CodeSniffer\Exceptions\RuntimeException;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\TextStrings;
-use WordPressCS\WordPress\Sniff;
-
-/**
- * Makes sure scripts and styles are enqueued and not explicitly echo'd.
- *
- * @link https://vip.wordpress.com/documentation/vip-go/code-review-blockers-warnings-notices/#inline-resources
- *
- * @since 0.3.0
- * @since 0.12.0 This class now extends the WordPressCS native `Sniff` class.
- * @since 0.13.0 Class name changed: this class is now namespaced.
- */
-final class EnqueuedResourcesSniff extends Sniff {
-
-	/**
-	 * Returns an array of tokens this test wants to listen for.
-	 *
-	 * @return array
-	 */
-	public function register() {
-		$targets   = Collections::textStringStartTokens();
-		$targets[] = \T_INLINE_HTML;
-
-		return $targets;
-	}
-
-	/**
-	 * Processes this test, when one of its tokens is encountered.
-	 *
-	 * @param int $stackPtr The position of the current token in the stack.
-	 *
-	 * @return int|void Integer stack pointer to skip forward or void to continue
-	 *                  normal file processing.
-	 */
-	public function process_token( $stackPtr ) {
-
-		$end_ptr = $stackPtr;
-		$content = $this->tokens[ $stackPtr ]['content'];
-		if ( \T_INLINE_HTML !== $this->tokens[ $stackPtr ]['code'] ) {
-			try {
-				$end_ptr = TextStrings::getEndOfCompleteTextString( $this->phpcsFile, $stackPtr );
-				$content = TextStrings::getCompleteTextString( $this->phpcsFile, $stackPtr );
-			} catch ( RuntimeException $e ) {
-				// Parse error/live coding.
-				return;
-			}
-		}
-
-		if ( preg_match_all( '# rel=\\\\?[\'"]?stylesheet\\\\?[\'"]?#', $content, $matches, \PREG_OFFSET_CAPTURE ) > 0 ) {
-			foreach ( $matches[0] as $match ) {
-				$this->phpcsFile->addError(
-					'Stylesheets must be registered/enqueued via wp_enqueue_style()',
-					$this->find_token_in_multiline_string( $stackPtr, $content, $match[1] ),
-					'NonEnqueuedStylesheet'
-				);
-			}
-		}
-
-		if ( preg_match_all( '#<script[^>]*(?<=src=)#', $content, $matches, \PREG_OFFSET_CAPTURE ) > 0 ) {
-			foreach ( $matches[0] as $match ) {
-				$this->phpcsFile->addError(
-					'Scripts must be registered/enqueued via wp_enqueue_script()',
-					$this->find_token_in_multiline_string( $stackPtr, $content, $match[1] ),
-					'NonEnqueuedScript'
-				);
-			}
-		}
-
-		return ( $end_ptr + 1 );
-	}
-
-	/**
-	 * Find the exact token on which the error should be reported for multi-line strings.
-	 *
-	 * @param int    $stackPtr     The position of the current token in the stack.
-	 * @param string $content      The complete, potentially multi-line, text string.
-	 * @param int    $match_offset The offset within the content at which the match was found.
-	 *
-	 * @return int The stack pointer to the token containing the start of the match.
-	 */
-	private function find_token_in_multiline_string( $stackPtr, $content, $match_offset ) {
-		$newline_count = 0;
-		if ( $match_offset > 0 ) {
-			$newline_count = substr_count( $content, "\n", 0, $match_offset );
-		}
-
-		// Account for heredoc/nowdoc text starting at the token *after* the opener.
-		if ( isset( Tokens::$heredocTokens[ $this->tokens[ $stackPtr ]['code'] ] ) === true ) {
-			++$newline_count;
-		}
-
-		return ( $stackPtr + $newline_count );
-	}
-}