Fix wrong counting of hook params with nested parenthesis.

Author: kagg-design

WPForms/Sniffs/Comments/ParamTagHooksSniff.php

@@ -129,6 +129,12 @@ private function countArguments( $phpcsFile, $stackPtr ) { // phpcs:ignore Gener
 
 			$quantity ++;
 
+			if ( ! empty( $tokens[ $currentPosition ]['parenthesis_opener'] ) ) {
+				$currentPosition = $tokens[ $currentPosition ]['parenthesis_closer'] + 1;
+
+				continue;
+			}
+
 			if ( ! empty( $tokens[ $currentPosition ]['bracket_closer'] ) ) {
 				$currentPosition = $tokens[ $currentPosition ]['bracket_closer'] + 2;
 

WPForms/Tests/TestFiles/Comments/ParamTagHooks.php

@@ -183,3 +183,15 @@ function () {
 
 // This case generated 'You should have 39 @param tags' (39 as an example).
 do_action( 'hook_without_args' );
+
+// This case generated 'You should have 16 @param tags'.
+$text = (string) apply_filters(
+	'wpforms_frontend_shortcode_amp_text',
+	sprintf( /* translators: %s - URL to a non-amp version of a page with the form. */
+		__( '<a href="%s">Go to the full page</a> to view and submit the form.', 'wpforms-lite' ),
+		esc_url( 'some_url' )
+	),
+	555,
+	'http://site.org/cool-page',
+	[]
+);