fix: Deprecation notice

Author: seebeen

composer.json

@@ -10,16 +10,15 @@
     }
   ],
   "require": {
-    "php": "^8.1",
-    "automattic/jetpack-constants": "^2.0",
+    "php": ">=8.1",
+    "automattic/jetpack-constants": "^2",
     "x-wp/hook-invoker": "^1"
   },
   "require-dev": {
-    "oblak/wordpress-coding-standard": "^1.1.1"
+    "oblak/wordpress-coding-standard": "^1"
   },
   "suggest": {
-    "automattic/jetpack-autoloader": "Allow for better interoperability with other plugins that use this package.",
-    "oblak/composer-wp-di-finder-plugin": "Automatically find Hookable classes"
+    "automattic/jetpack-autoloader": "Allow for better interoperability with other plugins that use this package."
   },
   "minimum-stability": "beta",
   "prefer-stable": true,
@@ -34,8 +33,7 @@
   },
   "config": {
     "allow-plugins": {
-      "dealerdirect/phpcodesniffer-composer-installer": true,
-      "ergebnis/composer-normalize": true
+      "dealerdirect/phpcodesniffer-composer-installer": true
     }
   }
 }

composer.lock

@@ -16,8 +16,6 @@
 
 /**
  * Annotation parser for legacy code.
- *
- * @deprecated 1.0.0
  */
 final class Annotation_Parser {
     /**

src/Annotation_Parser.php

@@ -24,14 +24,23 @@ class Hookable extends Handler {
      * @param  string   $hook        Hook name.
      * @param  int      $priority    Hook priority.
      * @param  callable $conditional Conditional callback function.
+     * @param  string   $tag         Tag name. Optional, if not provided, hook name will be used.
      * @param  mixed    ...$args     Arguments to pass to the hookable class constructor.
+     *
+     * @throws \InvalidArgumentException If hook or tag is not provided.
      */
     public function __construct(
-        string $hook,
+        ?string $hook = null,
         int $priority = 10,
-        $conditional = '__return_true',
+        $conditional = null,
+        ?string $tag = null,
         mixed ...$args,
     ) {
-        parent::__construct( tag: $hook, priority: $priority, conditional: $conditional );
+        $tgt = $tag ?? $hook ?? false;
+
+        if ( ! $tgt ) {
+            throw new \InvalidArgumentException( 'Hook name or tag must be provided.' );
+        }
+        parent::__construct( tag: $tgt, priority: $priority, conditional: $conditional );
     }
 }