================================================================
  SEASON GEAR BROWSER — HOW TO UPDATE FOR A NEW SEASON
================================================================

The ONLY file you ever need to edit is:

    GearingCompanion_SeasonData.lua

Everything else (Core logic, UI, filters) reads from that file
automatically. You never touch the other two .lua files.

----------------------------------------------------------------
STEP 1 — Update the season identity (top of the file)
----------------------------------------------------------------

    GearingCompanionData.SEASON_NAME  = "Midnight Season 2"
    GearingCompanionData.SEASON_PATCH = "12.1.0"

----------------------------------------------------------------
STEP 2 — Replace the dungeons table
----------------------------------------------------------------

Each dungeon entry looks like this:

    { id=1, name="Full Dungeon Name",
             short="Short Name",
             zone="Zone Name",
             type="new" },   -- "new" = this expansion
                              -- "legacy" = older expansion

Rules:
  • id must be a unique number (1, 2, 3 … 8)
  • type="new"    → shown with a green NEW badge in the UI
  • type="legacy" → shown with a grey LEGACY badge in the UI

----------------------------------------------------------------
STEP 3 — Replace the items table
----------------------------------------------------------------

Each item entry:

    { id=1,
      name="Item Name",
      ilvl=639,
      armorType="CLOTH",      -- CLOTH | LEATHER | MAIL | PLATE | ACCESSORY | TRINKET
      slot="HEAD",            -- see SLOT IDs below
      primaryStat="INT",      -- INT | AGI | STR
      sec1="HASTE",           -- top secondary: CRIT | HASTE | MAST | VERS
      sec2="CRIT",            -- second secondary (use "" if trinket/accessory has only one)
      dungeonId=1,            -- must match a dungeon id from the dungeons table
      boss="Boss Name",
      icon="Interface\\Icons\\INV_Helmet_Cloth_RaidPriest_S_01" },

Valid SLOT IDs:
  HEAD · NECK · SHOULDER · BACK · CHEST · WRIST
  HANDS · WAIST · LEGS · FEET · FINGER · TRINKET
  WEAPON · OFFHAND

----------------------------------------------------------------
PRIMARY STAT ↔ ARMOR TYPE compatibility
----------------------------------------------------------------

The UI automatically greys out incompatible armor types when
a primary stat is chosen. The rules are:

  INT  → Cloth, Leather, Mail, Accessories, Trinkets
  AGI  → Leather, Mail, Accessories, Trinkets
  STR  → Mail, Plate, Accessories, Trinkets

This is defined in GearingCompanion_Core.lua (SGB.PRIMARY_STATS
compatible table) and does NOT need updating between seasons.

----------------------------------------------------------------
SLASH COMMANDS
----------------------------------------------------------------

  /sgb           — open / close the browser
  /seasongear    — same

================================================================
