We also need an UnknownTrigger type

Author: sebastianbergmann

src/Event/Value/Test/Issue/DirectTrigger.php

@@ -7,7 +7,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-namespace PHPUnit\Event\Code\DeprecationTrigger;
+namespace PHPUnit\Event\Code\IssueTrigger;
 
 /**
  * @psalm-immutable
@@ -25,4 +25,9 @@ public function isDirect(): true
     {
         return true;
     }
+
+    public function asString(): string
+    {
+        return 'first-party code triggered issue in third-party code';
+    }
 }

src/Event/Value/Test/Issue/IndirectTrigger.php

@@ -7,7 +7,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-namespace PHPUnit\Event\Code\DeprecationTrigger;
+namespace PHPUnit\Event\Code\IssueTrigger;
 
 /**
  * @psalm-immutable
@@ -25,4 +25,9 @@ public function isIndirect(): true
     {
         return true;
     }
+
+    public function asString(): string
+    {
+        return 'third-party code triggered issue in third-party code';
+    }
 }

src/Event/Value/Test/Issue/IssueTrigger.php

@@ -7,7 +7,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-namespace PHPUnit\Event\Code\DeprecationTrigger;
+namespace PHPUnit\Event\Code\IssueTrigger;
 
 /**
  * @psalm-immutable
@@ -31,6 +31,11 @@ public static function indirect(): IndirectTrigger
         return new IndirectTrigger;
     }
 
+    public static function unknown(): UnknownTrigger
+    {
+        return new UnknownTrigger;
+    }
+
     final private function __construct()
     {
     }
@@ -64,4 +69,14 @@ public function isIndirect(): bool
     {
         return false;
     }
+
+    /**
+     * @psalm-assert-if-true UnknownTrigger $this
+     */
+    public function isUnknown(): bool
+    {
+        return false;
+    }
+
+    abstract public function asString(): string;
 }

src/Event/Value/Test/Issue/SelfTrigger.php

@@ -7,7 +7,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-namespace PHPUnit\Event\Code\DeprecationTrigger;
+namespace PHPUnit\Event\Code\IssueTrigger;
 
 /**
  * @psalm-immutable
@@ -25,4 +25,9 @@ public function isSelf(): true
     {
         return true;
     }
+
+    public function asString(): string
+    {
+        return 'first-party code triggered issue in first-party code';
+    }
 }

src/Event/Value/Test/Issue/UnknownTrigger.php

@@ -0,0 +1,31 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\Event\Code\IssueTrigger;
+
+/**
+ * @psalm-immutable
+ *
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+ */
+final class UnknownTrigger extends IssueTrigger
+{
+    /**
+     * @psalm-assert-if-true UnknownTrigger $this
+     */
+    public function isUnknown(): true
+    {
+        return true;
+    }
+
+    public function asString(): string
+    {
+        return 'unknown whether this issue was triggered in first-party or third-party code';
+    }
+}

tests/unit/Event/Value/Test/IssueTriggerTest.php

@@ -7,7 +7,7 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-namespace PHPUnit\Event\Code\DeprecationTrigger;
+namespace PHPUnit\Event\Code\IssueTrigger;
 
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Small;
@@ -26,6 +26,8 @@ public function testCanBeSelf(): void
         $this->assertTrue($trigger->isSelf());
         $this->assertFalse($trigger->isDirect());
         $this->assertFalse($trigger->isIndirect());
+        $this->assertFalse($trigger->isUnknown());
+        $this->assertSame('first-party code triggered issue in first-party code', $trigger->asString());
     }
 
     public function testCanBeDirect(): void
@@ -35,6 +37,8 @@ public function testCanBeDirect(): void
         $this->assertTrue($trigger->isDirect());
         $this->assertFalse($trigger->isSelf());
         $this->assertFalse($trigger->isIndirect());
+        $this->assertFalse($trigger->isUnknown());
+        $this->assertSame('first-party code triggered issue in third-party code', $trigger->asString());
     }
 
     public function testCanBeIndirect(): void
@@ -44,5 +48,18 @@ public function testCanBeIndirect(): void
         $this->assertTrue($trigger->isIndirect());
         $this->assertFalse($trigger->isSelf());
         $this->assertFalse($trigger->isDirect());
+        $this->assertFalse($trigger->isUnknown());
+        $this->assertSame('third-party code triggered issue in third-party code', $trigger->asString());
+    }
+
+    public function testCanBeUnknown(): void
+    {
+        $trigger = IssueTrigger::unknown();
+
+        $this->assertFalse($trigger->isSelf());
+        $this->assertFalse($trigger->isDirect());
+        $this->assertFalse($trigger->isIndirect());
+        $this->assertTrue($trigger->isUnknown());
+        $this->assertSame('unknown whether this issue was triggered in first-party or third-party code', $trigger->asString());
     }
 }