Update doc version

Author: ernilambar

includes/Checker/Checks/Plugin_Repo/Prefixing_Check.php

@@ -17,7 +17,7 @@
 /**
  * Check for prefixing.
  *
- * @since 1.6.0
+ * @since 1.7.0
  */
 class Prefixing_Check extends Abstract_PHP_CodeSniffer_Check {
 
@@ -30,7 +30,7 @@ class Prefixing_Check extends Abstract_PHP_CodeSniffer_Check {
 	 *
 	 * Every check must have at least one category.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @return array The categories for the check.
 	 */
@@ -41,7 +41,7 @@ public function get_categories() {
 	/**
 	 * Returns an associative array of arguments to pass to PHPCS.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param Check_Result $result The check result to amend, including the plugin context to check.
 	 * @return array An associative array of PHPCS CLI arguments.
@@ -69,7 +69,7 @@ protected function get_args( Check_Result $result ) {
 	 *
 	 * Every check must have a short description explaining what the check does.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @return string Description.
 	 */
@@ -82,7 +82,7 @@ public function get_description(): string {
 	 *
 	 * Every check must have a URL with further information about the check.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @return string The documentation URL.
 	 */

includes/Scanner/Log.php

@@ -10,46 +10,46 @@
 /**
  * Log class.
  *
- * @since 1.6.0
+ * @since 1.7.0
  */
 class Log {
 
 	/**
 	 * An array of logs.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var array
 	 */
 	private array $log = array();
 
 	/**
 	 * An array of logs with longer location.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var array
 	 */
 	private array $log_longer_location = array();
 
 	/**
 	 * An instance of the PHP_Parser class.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var PHP_Parser
 	 */
 	public PHP_Parser $parser_object;
 
 	/**
 	 * An array of strings to be removed from the log.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var string[]
 	 */
 	private array $remove_strings_from_log = array();
 
 	/**
 	 * Constructor.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param PHP_Parser $parser An instance of the PHP_Parser class.
 	 */
@@ -60,7 +60,7 @@ public function __construct( $parser ) {
 	/**
 	 * Adds a log entry with the specified details to the log storage.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param int    $line_number The line number where the log entry originates from.
 	 * @param string $text        The text content of the log entry.
@@ -105,7 +105,7 @@ public function add( $line_number, $text, $logid = 'default', $unique = false )
 	/**
 	 * Generates a unique identifier for a specific line in a file.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param int $line_number The line number for which the identifier is generated.
 	 * @return string The MD5 hash representing the unique identifier for the line.
@@ -128,7 +128,7 @@ public function get( $logid = 'default' ) {
 	/**
 	 * Merges the provided log data with the existing log data for the specified identifier.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param array  $log   The log data to merge.
 	 * @param string $logid The identifier of the log to merge into. Defaults to 'default'.
@@ -145,7 +145,7 @@ public function merge( $log, $logid = 'default' ) {
 	/**
 	 * Adds a namespace to the log for a given identifier.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param object $namespace_obj The namespace object to add, which should include a name property.
 	 * @param string $logid         The identifier of the log where the namespace information should be added.
@@ -169,7 +169,7 @@ public function add_namespace( $namespace_obj, $logid, $unique = false ) {
 	/**
 	 * Adds a function call expression to the log and assigns metadata for processing.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param object $func_call   The function call expression object to be logged.
 	 * @param int    $argposition The position of the argument in the function call to extract metadata from.
@@ -201,7 +201,7 @@ public function add_call_expr( $func_call, $argposition, $logid, $unique = false
 	/**
 	 * Adds a variable expression to the log and records its metadata.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param object $var_call The variable expression object to be logged. It is expected to be an instance of specific PhpParser classes.
 	 * @param string $logid    The identifier of the log where the variable expression should be added.
@@ -237,7 +237,7 @@ public function add_var_expr( $var_call, $logid, $unique = false, $accurate = tr
 	/**
 	 * Adds abstraction declarations like classes, functions, interfaces, or traits to the log with specific context and type.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param array  $abstractions An array of abstraction objects to process and add to the log. Each object must have a type and name.
 	 * @param string $logid The identifier for the log to which the abstraction declarations will be added.
@@ -291,7 +291,7 @@ public function add_abstraction_declarations( $abstractions, $logid, $unique = f
 	/**
 	 * Checks whether log data exists for the specified log identifier.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param string $logid The identifier of the log to check for existence. Defaults to 'default'.
 	 * @return bool True if log data exists for the provided identifier, otherwise false.
@@ -303,7 +303,7 @@ public function exists( $logid = 'default' ) {
 	/**
 	 * Constructs a location string consisting of the relative file path and line number.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param int    $line_number   The line number in the file.
 	 * @param string $file_relative The file path relative to the root directory.

includes/Scanner/PHP_Parser.php

@@ -23,7 +23,7 @@
 /**
  * Abstract class responsible for parsing files, logging, and processing Abstract Syntax Tree (AST) data.
  *
- * @since 1.6.0
+ * @since 1.7.0
  *
  * @SuppressWarnings(PHPMD.CyclomaticComplexity)
  * @SuppressWarnings(PHPMD.ExcessiveClassLength)
@@ -34,135 +34,135 @@ abstract class PHP_Parser {
 	/**
 	 * A collection of all file paths to be processed.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string[]
 	 */
 	public array $files = array();
 
 	/**
 	 * A collection of PHP file paths to be processed.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string[]
 	 */
 	public array $files_php = array();
 
 	/**
 	 * The full path of the file currently being processed.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string
 	 */
 	public string $file = '';
 
 	/**
 	 * The relative path of the file currently being processed.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string
 	 */
 	public string $file_relative = '';
 
 	/**
 	 * Flag to indicate if parent nodes need to be fetched during AST traversal.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   bool
 	 */
 	public bool $needs_get_parents = false;
 
 	/**
 	 * Flag to indicate if sibling nodes need to be fetched during AST traversal.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   bool
 	 */
 	public bool $needs_get_siblings = false;
 
 	/**
 	 * Flag to indicate if the service is initialized and ready.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   bool
 	 */
 	private bool $ready = false;
 
 	/**
 	 * The PHP-Parser NodeFinder instance.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   \PhpParser\NodeFinder
 	 */
 	public $node_finder;
 
 	/**
 	 * The Abstract Syntax Tree (AST) of the current file.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var \PhpParser\Node[]|null
 	 */
 	public $stmts;
 
 	/**
 	 * The logging object instance.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   Log
 	 */
 	private Log $log_object;
 
 	/**
 	 * The PHP-Parser PrettyPrinter instance.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   \PhpParser\PrettyPrinter\Standard
 	 */
 	public $pretty_printer;
 
 	/**
 	 * List of known sanitization functions.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string[]
 	 */
 	public array $sanitize_functions;
 
 	/**
 	 * List of known escaping functions.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   string[]
 	 */
 	public array $escaping_functions;
 
 	/**
 	 * Cache for `define()` statement objects found during parsing.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   array
 	 */
 	private array $defines_objects = array();
 
 	/**
 	 * Flag to indicate if the `define()` statement objects have been loaded.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   bool
 	 */
 	private bool $defines_objects_loaded = false;
 
 	/**
 	 * Cache for variable assignment expressions to avoid re-parsing.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 * @var   array
 	 */
 	private array $cache_assignments_expressions_for_variable = array();
 
 	/**
 	 * Constructor.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 */
 	public function __construct() {
 		$this->log_object         = new Log( $this );
@@ -173,7 +173,7 @@ public function __construct() {
 	/**
 	 * Loads files.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param array $files Array of files.
 	 * @return void
@@ -192,7 +192,7 @@ function ( $file ) {
 	/**
 	 * Returns relative path.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param string $file File path.
 	 * @return string Relative path.
@@ -366,7 +366,7 @@ public function is_ready() {
 	/**
 	 * Checks if the given object is of one of the specified classes.
 	 *
-	 * @since 1.6.0
+	 * @since 1.7.0
 	 *
 	 * @param object $object_name The object to check.
 	 * @param array  $classes An array of class names to check against.