feat(pipeline): add WTRG (Wowee Area Trigger) format

Novel open replacement for Blizzard's AreaTrigger.dbc +
AreaTriggerTeleport.dbc + the AzerothCore-style
areatrigger_template / areatrigger_teleport SQL tables.
The 29th open format added to the editor.

Defines proximity-based event zones — when a player enters
a defined region (box or sphere), the runtime fires the
trigger's action: teleport to another map, award
exploration XP for a quest, run a server script, gate an
instance entrance behind a key item, mark a PvP boundary,
or simply display a "Discovered: {area name}" banner.

Cross-references with previously-added formats — every
trigger field has a real format target:
  WTRG.entry.mapId / areaId  -> WMS.map.mapId / WMS.area.areaId
  WTRG.actionTarget (Teleport)        -> WMS.mapId
  WTRG.actionTarget (QuestExploration) -> WQT.questId
  WTRG.requiredQuestId       -> WQT.entry.questId
  WTRG.requiredItemId        -> WIT.entry.itemId (key)

Format:
  • magic "WTRG", version 1, little-endian
  • per trigger: triggerId / mapId / areaId / name /
    center vec3 / shape / kind / boxDims vec3 / radius /
    actionTarget / dest vec3 / destOrientation /
    requiredQuestId / requiredItemId / minLevel

Enums:
  • Shape (2): Box / Sphere
  • Kind (7): Teleport / QuestExploration / Script /
              InstanceEntrance / AreaName / CombatStartZone /
              Waypoint

API: WoweeTriggerLoader::save / load / exists / findById.

Three preset emitters showcase common trigger shapes:
  • makeStarter    — area-name + quest-exploration with
                      cross-ref to WQT 100 ("Investigate the
                      Camp")
  • makeDungeon    — outdoor area-name + portal-style
                      InstanceEntrance with Deadmines key
                      gate (WIT itemId 5200, matches
                      WLCK.makeDungeon's Boss Vault Seal) +
                      interior exit teleport back outdoors
  • makeFlightPath — 2 sphere waypoints near flight masters
                      so the runtime can auto-open the
                      flight UI on proximity (matches WTAX
                      starter node positions)

CLI added (5 flags, 601 documented total now):
  --gen-triggers / --gen-triggers-dungeon / --gen-triggers-flightpath
  --info-wtrg / --validate-wtrg

Validator catches: triggerId=0 + duplicates, unknown shape /
kind, non-finite center, sphere with radius<=0, box with
all-zero half-extents, teleport / instance with dest=(0,0,0)
(silently does nothing — usually a typo), QuestExploration
without an actionTarget questId.

include/pipeline/wowee_triggers.hpp

@@ -0,0 +1,121 @@
+#pragma once
+
+#include <glm/glm.hpp>
+#include <cstdint>
+#include <string>
+#include <vector>
+
+namespace wowee {
+namespace pipeline {
+
+// Wowee Open Area Trigger catalog (.wtrg) — novel
+// replacement for Blizzard's AreaTrigger.dbc +
+// AreaTriggerTeleport.dbc + the AzerothCore-style
+// areatrigger_template / areatrigger_teleport SQL tables.
+// The 29th open format added to the editor.
+//
+// Defines proximity-based event zones — when a player
+// enters a defined region (box or sphere), the runtime
+// fires the trigger's action: teleport to another map,
+// award exploration XP for a quest, run a server script,
+// gate an instance entrance behind a key item, etc.
+//
+// Cross-references with previously-added formats:
+//   WTRG.entry.mapId / areaId  → WMS.map.mapId / WMS.area.areaId
+//   WTRG.entry.actionTarget (kind=Teleport)        → WMS.mapId
+//   WTRG.entry.actionTarget (kind=QuestExploration) → WQT.questId
+//   WTRG.entry.requiredQuestId → WQT.entry.questId
+//   WTRG.entry.requiredItemId  → WIT.entry.itemId (key)
+//
+// Binary layout (little-endian):
+//   magic[4]            = "WTRG"
+//   version (uint32)    = current 1
+//   nameLen + name (catalog label)
+//   entryCount (uint32)
+//   entries (each):
+//     triggerId (uint32)
+//     mapId (uint32)
+//     areaId (uint32)
+//     nameLen + name
+//     center (3 × float)
+//     shape (uint8) + kind (uint8) + pad[2]
+//     boxDims (3 × float)
+//     radius (float)
+//     actionTarget (uint32)
+//     dest (3 × float)
+//     destOrientation (float)
+//     requiredQuestId (uint32)
+//     requiredItemId (uint32)
+//     minLevel (uint16) + pad[2]
+struct WoweeTrigger {
+    enum Shape : uint8_t {
+        ShapeBox    = 0,
+        ShapeSphere = 1,
+    };
+
+    enum Kind : uint8_t {
+        KindTeleport         = 0,    // moves player to dest
+        KindQuestExploration = 1,    // awards XP toward a quest
+        KindScript           = 2,    // runs a server script
+        KindInstanceEntrance = 3,    // dungeon / raid portal
+        KindAreaName         = 4,    // shows "Discovered: ..." text
+        KindCombatStartZone  = 5,    // marks PvP-flag boundary
+        KindWaypoint         = 6,    // waypoint marker (NPCs / quests)
+    };
+
+    struct Entry {
+        uint32_t triggerId = 0;
+        uint32_t mapId = 0;
+        uint32_t areaId = 0;          // 0 = anywhere on the map
+        std::string name;
+        glm::vec3 center{0};
+        uint8_t shape = ShapeBox;
+        uint8_t kind = KindAreaName;
+        glm::vec3 boxDims{0};         // half-extents; ignored if sphere
+        float radius = 0.0f;          // ignored if box
+        uint32_t actionTarget = 0;
+        glm::vec3 dest{0};            // teleport destination
+        float destOrientation = 0.0f; // teleport facing (radians)
+        uint32_t requiredQuestId = 0; // 0 = no quest gate
+        uint32_t requiredItemId = 0;  // 0 = no key item required
+        uint16_t minLevel = 0;
+    };
+
+    std::string name;
+    std::vector<Entry> entries;
+
+    bool isValid() const { return !entries.empty(); }
+
+    const Entry* findById(uint32_t triggerId) const;
+
+    static const char* shapeName(uint8_t s);
+    static const char* kindName(uint8_t k);
+};
+
+class WoweeTriggerLoader {
+public:
+    static bool save(const WoweeTrigger& cat,
+                     const std::string& basePath);
+    static WoweeTrigger load(const std::string& basePath);
+    static bool exists(const std::string& basePath);
+
+    // Preset emitters used by --gen-triggers* variants.
+    //
+    //   makeStarter — 2 triggers: 1 area-name (player enters
+    //                  Goldshire) + 1 quest exploration
+    //                  (matches WQT 100 "Investigate the Camp").
+    //   makeDungeon — 3 triggers around an instance: outdoor
+    //                  approach area-name + portal-style
+    //                  teleport into the instance + instance
+    //                  exit teleport back outdoors.
+    //   makeFlightPath — 2 triggers marking flight-master
+    //                     proximity (Stormwind / Goldshire) so
+    //                     the runtime knows when to open the
+    //                     flight UI without explicit interact.
+    static WoweeTrigger makeStarter(const std::string& catalogName);
+    static WoweeTrigger makeDungeon(const std::string& catalogName);
+    static WoweeTrigger makeFlightPath(const std::string& catalogName);
+};
+
+} // namespace pipeline
+} // namespace wowee