Add psalm typehint for trigger mask

src/Parser/Parser.php

@@ -41,6 +41,9 @@
 use ReflectionProperty;
 use ReflectionReference;
 
+/**
+ * @psalm-type ParserTrigger int-mask-of<Parser::TRIGGER_*>
+ */
 class Parser
 {
     /**
@@ -54,7 +57,8 @@ class Parser
      * DEPTH_LIMIT: After parsing cancelled by depth limit
      * COMPLETE: SUCCESS | RECURSION | DEPTH_LIMIT
      *
-     * While a plugin's getTriggers may return any of these
+     * While a plugin's getTriggers may return any of these only one should
+     * be given to the plugin when PluginInterface::parse is called
      */
     public const TRIGGER_NONE = 0;
     public const TRIGGER_BEGIN = 1;

src/Parser/PluginInterface.php

@@ -29,16 +29,23 @@
 
 use Kint\Zval\Value;
 
+/**
+ * @psalm-import-type ParserTrigger from Parser
+ */
 interface PluginInterface
 {
     public function setParser(Parser $p): void;
 
     public function getTypes(): array;
 
+    /**
+     * @psalm-return ParserTrigger
+     */
     public function getTriggers(): int;
 
     /**
      * @psalm-param mixed &$var
+     * @psalm-param ParserTrigger $trigger
      */
     public function parse(&$var, Value &$o, int $trigger): void;
 }

src/Parser/ProxyPlugin.php

@@ -29,15 +29,22 @@
 
 use Kint\Zval\Value;
 
+/**
+ * @psalm-import-type ParserTrigger from Parser
+ */
 class ProxyPlugin implements PluginInterface
 {
     protected array $types;
+    /** @psalm-var ParserTrigger */
     protected int $triggers;
     /** @psalm-var callable */
     protected $callback;
     private ?Parser $parser = null;
 
-    /** @psalm-param callable $callback */
+    /**
+     * @psalm-param ParserTrigger $triggers
+     * @psalm-param callable $callback
+     */
     public function __construct(array $types, int $triggers, $callback)
     {
         $this->types = $types;