Add comprehensive TriggerManager getter methods

- Add getTriggers() method to get all registered triggers
- Add getGlobalTriggers() and getPerPlayerTriggers() methods
- Add hasTrigger() method to check if trigger is registered
- Add countTriggers(), countGlobalTriggers(), countPerPlayerTriggers() methods
- Add getTriggerByName() and hasTriggerByName() methods
- Add getTriggersByType() method to filter by trigger type
- Add removeTriggerByName() method
- Add getTriggerNames() and getTriggerStats() methods

Author: ImperaZim

src/imperazim/components/trigger/TriggerManager.php

@@ -100,4 +100,148 @@ public static function removeTrigger(Trigger $trigger): bool {
   public static function clearTriggers(): void {
     self::$triggers = [];
   }
+
+  /**
+  * Gets all registered triggers.
+  * @return Trigger[] Array of all registered triggers.
+  */
+  public static function getTriggers(): array {
+    return self::$triggers;
+  }
+
+  /**
+  * Gets all global triggers.
+  * @return Trigger[] Array of global triggers.
+  */
+  public static function getGlobalTriggers(): array {
+    $globalTriggers = [];
+    foreach (self::$triggers as $trigger) {
+      if ($trigger->getTriggerType() === TriggerTypes::GLOBAL) {
+        $globalTriggers[] = $trigger;
+      }
+    }
+    return $globalTriggers;
+  }
+
+  /**
+  * Gets all per-player triggers.
+  * @return Trigger[] Array of per-player triggers.
+  */
+  public static function getPerPlayerTriggers(): array {
+    $perPlayerTriggers = [];
+    foreach (self::$triggers as $trigger) {
+      if ($trigger->getTriggerType() === TriggerTypes::PER_PLAYER) {
+        $perPlayerTriggers[] = $trigger;
+      }
+    }
+    return $perPlayerTriggers;
+  }
+
+  /**
+  * Checks if a specific trigger is registered.
+  * @param Trigger $trigger The trigger to check.
+  * @return bool True if the trigger is registered, false otherwise.
+  */
+  public static function hasTrigger(Trigger $trigger): bool {
+    return in_array($trigger, self::$triggers, true);
+  }
+
+  /**
+  * Gets the total number of registered triggers.
+  * @return int The number of registered triggers.
+  */
+  public static function countTriggers(): int {
+    return count(self::$triggers);
+  }
+
+  /**
+  * Gets the number of global triggers.
+  * @return int The number of global triggers.
+  */
+  public static function countGlobalTriggers(): int {
+    return count(self::getGlobalTriggers());
+  }
+
+  /**
+  * Gets the number of per-player triggers.
+  * @return int The number of per-player triggers.
+  */
+  public static function countPerPlayerTriggers(): int {
+    return count(self::getPerPlayerTriggers());
+  }
+
+  /**
+  * Finds a trigger by its name.
+  * @param string $name The name of the trigger.
+  * @return Trigger|null The trigger if found, null otherwise.
+  */
+  public static function getTriggerByName(string $name): ?Trigger {
+    foreach (self::$triggers as $trigger) {
+      if ($trigger->getName() === $name) {
+        return $trigger;
+      }
+    }
+    return null;
+  }
+
+  /**
+  * Finds triggers by their type.
+  * @param string $type The trigger type (use TriggerTypes constants).
+  * @return Trigger[] Array of triggers of the specified type.
+  */
+  public static function getTriggersByType(string $type): array {
+    $filteredTriggers = [];
+    foreach (self::$triggers as $trigger) {
+      if ($trigger->getTriggerType() === $type) {
+        $filteredTriggers[] = $trigger;
+      }
+    }
+    return $filteredTriggers;
+  }
+
+  /**
+  * Checks if a trigger with the given name exists.
+  * @param string $name The name of the trigger.
+  * @return bool True if a trigger with the name exists, false otherwise.
+  */
+  public static function hasTriggerByName(string $name): bool {
+    return self::getTriggerByName($name) !== null;
+  }
+
+  /**
+  * Removes a trigger by its name.
+  * @param string $name The name of the trigger to remove.
+  * @return bool True if the trigger was found and removed, false otherwise.
+  */
+  public static function removeTriggerByName(string $name): bool {
+    $trigger = self::getTriggerByName($name);
+    if ($trigger !== null) {
+      return self::removeTrigger($trigger);
+    }
+    return false;
+  }
+
+  /**
+  * Gets trigger names as an array.
+  * @return string[] Array of trigger names.
+  */
+  public static function getTriggerNames(): array {
+    $names = [];
+    foreach (self::$triggers as $trigger) {
+      $names[] = $trigger->getName();
+    }
+    return $names;
+  }
+
+  /**
+  * Gets trigger statistics.
+  * @return array Statistics about triggers [total, global, perPlayer].
+  */
+  public static function getTriggerStats(): array {
+    return [
+      'total' => self::countTriggers(),
+      'global' => self::countGlobalTriggers(),
+      'perPlayer' => self::countPerPlayerTriggers()
+    ];
+  }
 }