fix PHPDocs

core/Config.php

@@ -89,7 +89,7 @@ public static function get ( $key, $default = null ) {
 	}
 
 	/**
-	 * @return positive-int
+	 * @return int<0, max>
 	 */
 	public static function get_size () {
 		return count( self::$values );

core/Dependencies.php

@@ -43,7 +43,7 @@ public static function maybe_start_plugin () {
 	}
 
 	/**
-	 * @return array{success: bool, messages: string[]} The result
+	 * @return array{success: bool, messages: array<int, array{text: string, is_error: bool}>}
 	 * @throws \Exception
 	 */
 	public static function check_dependencies () {
@@ -124,28 +124,31 @@ protected static function handle_shortcut ( $shortcut ) {
 	}
 
 	/**
-	 * @param string[] $messages
+	 * @param array<int, array{text:string, is_error:bool}> $messages
 	 * @return void
 	 */
 	protected static function display_notice_missing_deps ( $messages ) {
 		if ( ! \is_admin() ) return;
 		if ( ! \current_user_can( 'install_plugins' ) ) return;
 		if ( 0 === count( $messages ) ) return;
 
-		\usort( $messages, function ( $a, $b ) {
-			return $b['is_error'] <=> $a['is_error'];
-		} );
+		\usort(
+			$messages,
+			function ( $a, $b ) {
+				return $b['is_error'] <=> $a['is_error'];
+			}
+		);
 
 		\add_action( 'admin_notices', function () use ( $messages ) {
 			echo "<div class='notice notice-error'><p>";
 			echo sprintf(
 				/* translators: %s is replaced with plugin name */
-				__( 'The %s plugin needs the following dependencies to work:', 'your_text_domain' ),
+				__( 'The %s plugin needs the following dependencies to work:', 'wc-shipping-simulator' ),
 				"<strong>" . Config::get( 'NAME' ) . "</strong>",
 			);
 
 			$indent = \str_repeat( '&nbsp;', 4 );
-			$missing = esc_html__( 'Missing', 'your_text_domain' );
+			$missing = esc_html__( 'Missing', 'wc-shipping-simulator' );
 			$allowed_html = [
 				'a' => [ 'href' => [], 'target' => [] ],
 				'span' => [ 'class' => [], 'style' => [] ],

core/Traits/Debug_Helpers.php

@@ -10,7 +10,7 @@ trait Debug_Helpers {
 	 * Dump and die
 	 *
 	 * @param mixed ...$values
-	 * @return null|never
+	 * @return void|never
 	 */
 	public static function dd ( ...$values ) {
 		if ( ! WP_DEBUG ) return;

core/Traits/String_Helpers.php

@@ -7,7 +7,7 @@ trait String_Helpers {
 	/**
 	 * @param string $string
 	 * @param string $encoding
-	 * @return string
+	 * @return int<0, max>
 	 */
 	public static function str_length ( $string, $encoding = 'UTF-8' ) {
 		return \mb_strlen( $string, $encoding );
@@ -34,7 +34,7 @@ public static function str_upper ( $string, $encoding = 'UTF-8' ) {
 	/**
 	 * @param string $string
 	 * @param string $encoding
-	 * @return string
+	 * @return bool
 	 */
 	public static function str_contains ( $string, $search, $encoding = 'UTF-8' ) {
 		return $search !== '' && mb_strpos( $string, $search, 0, $encoding ) !== false;

core/Traits/Throw_Helpers.php

@@ -15,7 +15,7 @@ public static function get_error_class () {
 	 * If the condition is falsy, throws a Exception.
 	 *
 	 * @param bool $condition
-	 * @param string $message
+	 * @param callable|mixed $message
 	 * @param \Throwable|null $exception_class
 	 * @return void
 	 * @throws \Throwable

core/VERSION

@@ -1 +1 @@
-2.0.0
+2.0.1