ArcUI_Changelog.lua

-- ===================================================================
-- ArcUI_Changelog.lua
-- "What's New" window. On the first login after an ArcUI update it pops a
-- styled changelog so players see what changed (the same notes we post on
-- CurseForge). Shown once per version; can be turned off in Settings, or
-- reopened any time via the "View Changelog" button / /arcchangelog.
--
-- TO UPDATE EACH RELEASE: add a new entry at the TOP of ns.Changelog.versions
-- (newest first) mirroring the CurseForge changelog. That's the only edit.
-- ===================================================================

local ADDON, ns = ...
ns = ns or {}
ns.Changelog = ns.Changelog or {}
local CL = ns.Changelog

-- Section colours (header tint).
local C_NEW   = "ff4ade80"  -- green  — New Features
local C_IMP   = "ff60a5fa"  -- blue   — Improvements
local C_FIX   = "fffbbf24"  -- amber  — Bug Fixes
local C_BRAND = "ff00ccff"  -- ArcUI cyan
local C_TITLE = "ffffffff"  -- entry title
local C_DESC  = "ffb0b0b0"  -- entry description

-- ===================================================================
-- CHANGELOG CONTENT  (newest version first)
-- Each version: { version = "x.y.z", sections = { { header, color, items = {
--   { title = "...", desc = "..." }, ... } } } }
-- ===================================================================
CL.versions = {
  {
    version = "3.9.3",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Bar Texture Picker", desc = "Choosing a bar texture opens a window showing every texture on a bar in your bar's colour, grouped by where it comes from, with search, favorites and recently used. Hover a texture to see it on your real bar, then Use texture to keep it. Works for aura, cooldown, resource and castbars." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Patch 12.1.5", desc = "Updated for the current game patch." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Combat Lua Error", desc = "Fixed a Lua error that could repeat many times in combat, most often when opening from Stealth." },
          { title = "Cooldown Bar Opacity", desc = "The opacity you set on cooldown, charge and timer bar colours now applies." },
        },
      },
    },
  },
  {
    version = "3.9.2",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Out of Range Shadow Options", desc = "New Hide Shadow and Shadow Size options in Range Indicator. Hide the dark shadow and keep the red tint, or resize it." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Icons Shuffled After Stealth or Mounting", desc = "Icons no longer mix up between groups after a /reload and your first Stealth or mount." },
          { title = "Tooltips Coming Back", desc = "With Show Tooltips off, tooltips stay off after Stealth or mounting." },
          { title = "Out of Range Shadow Fit", desc = "The out-of-range shadow now fits the icon instead of spilling past it." },
          { title = "Account Sharing on Alts", desc = "Alts pick up the shared layout again after sharing is turned off and back on. Alts that were already stuck need Enable ticked once." },
          { title = "Castbar and Bars Shifting Sideways", desc = "Bars anchored with Match Slots Only stay lined up when the group's first icon is hidden." },
        },
      },
    },
  },
  {
    version = "3.9.1.a",
    sections = {
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Charge Spells on Arc Icons", desc = "Arc spell icons for spells that get an extra charge from a talent, like Stormstrike, show their cooldown swipe and recharge timer again. Before, after a talent or loadout change the icon could show only the charge count, with no swipe or timer, until a reload." },
        },
      },
    },
  },
  {
    version = "3.9.1",
    sections = {
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Sound Pickers", desc = "Sound dropdowns open instantly even with several SharedMedia sound packs installed. Before, opening one could freeze the game for several seconds while it built a row for every sound. ArcUI now uses its own picker for this, so other addons' sound menus are untouched." },
          { title = "Textures on Other Specs", desc = "With the options panel open, textures from your other specs no longer draw on screen while you build a new spec's layout, and the texture list now respects Show Only Current Spec like the bar list does." },
          { title = "Resource Bar Text Strata", desc = "The text Strata and Level settings on resource bars (runes, runic power and every other resource) now take effect, so the number can sit above other bars even with the bar itself hidden. Before, only the bar's own strata did anything." },
          { title = "Stuck Castbar in Mythic+", desc = "The castbar could stay stuck on screen after some casts in a Mythic+ fight, Rebirth for example, until a reload. It now always clears once the cast is over." },
          { title = "Resource Bar Ticks per Power Type", desc = "With Tick Marks Auto Share off, each power type now keeps its own custom tick values, and color ranges follow the Colors box the same way. Before, every power type showed the same ticks whatever the box said. Your current ticks stay as they are until you edit a power type." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "New Textures Load Only On Their Spec", desc = "A newly created texture now loads only on the spec it was created on, like new icons already do. Widen it any time with the spec checkboxes in its row; existing textures are unchanged." },
          { title = "Aura Groups Hold 20 Icons", desc = "A Spell-ID Aura Group now shows up to 20 aura icons, up from 10. Before, icons past the tenth played their sound but never appeared." },
        },
      },
    },
  },
  {
    version = "3.9.0",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Show Below on Cooldown Text", desc = "Keep a cooldown's countdown hidden until it drops under a number of seconds you choose, so the timer only appears when the ability is almost back. Found in the cooldown icon's Duration/Cooldown Text Style under Format. Works in dungeons and raids too." },
          { title = "Cooldown Reminder Load Conditions", desc = "Each reminder can now be limited to chosen specs and talents, the same way Arc icons are. Swap spec or change talents and the reminder switches itself on or off with no reload. Reminders that are off for your current spec stay listed with a small note so you can still edit them." },
          { title = "Blizzard Default Glow Colors", desc = "A new Blizzard Colors checkbox next to every glow color picker (and in CDM Utilities) gives the Button and Blizzard Proc glow styles Blizzard's own colors from before patch 10.1.5. Those two styles tint their artwork with any color you pick, which is why the original look could never be matched from the color wheel. One account-wide switch, so ticking it in any section turns it on everywhere. Off by default." },
          { title = "Loot Planner Slot Filter", desc = "The Drops Overview gained a Slot dropdown next to Difficulty. Pick a slot and every boss opens at once showing only that slot's drops, so all your options for it sit side by side; bosses with nothing in that slot are hidden." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Duration/Cooldown Text Style", desc = "The section is now organized into General, Position, Format and Color boxes instead of one long list, and the Color by Duration and Use % Thresholds labels no longer get cut off." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Error in Raids and Dungeons", desc = "Fixed the \"attempt to compare local 'spellID' (a secret number value)\" error that could fire hundreds of times inside instances. As part of the same fix, icons scanned inside an instance no longer fall back to an Unknown name until you leave." },
          { title = "Hide CDM Icon/Bar Ghosts", desc = "A Blizzard bar or icon hidden by one of your bars could reappear after login or a reload as a leftover copy that only went away once the options panel was opened. Released copies are no longer shown back, and every copy the game holds for that ability is hidden, not just the first one found." },
          { title = "Loot Planner Drop Chances", desc = "Tier tokens now count as a drop in the Adventure Guide percentages, and the odds follow the guide's class and spec filter even when a sim is loaded, so switching to another spec's loot view shows the right chance per item." },
          { title = "Loot Planner Tooltips", desc = "Sim-priced items in the Bonus Roll Overview now highlight your own primary stat. Warriors saw Agility or Intellect in white and Strength greyed out on multi-stat items." },
        },
      },
    },
  },
  {
    version = "3.8.10",
    sections = {
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "New Icons Load Only On Their Spec", desc = "A newly created aura icon or arc icon now loads only on the spec it was created on instead of all specs. Widen it any time with the spec checkboxes in Load Conditions; existing icons are unchanged." },
          { title = "Totem Slot Controls in the Icon Catalog", desc = "Selecting a totem slot icon in the Icon Catalog now shows the totem tracking switches (the master toggle and each per-slot toggle) right there, instead of only in the Add Arc Icon section." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Totem Slot Dragging", desc = "Free-placed totem slot icons could permanently lose their dragging after a spec change or reload while everything else about them looked fine. They now stay movable." },
          { title = "Spec Settings Survive Profile Sync", desc = "With shared same-class profiles, unchecking specs or setting talent conditions on a synced character no longer gets reverted at the next login. Each character now keeps its own load conditions; everything else still syncs from the source as before." },
          { title = "Masque Skins at Login", desc = "Masque skins now apply right at login. Previously they could silently stay off for the whole session until the options panel was opened once." },
          { title = "Tooltips on Reappearing Groups", desc = "Icons in groups shown by visibility conditions (for example combat-only groups) no longer come back with their tooltip behavior flipped against your settings." },
        },
      },
    },
  },
  {
    version = "3.8.9",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Aura Tracking Editor", desc = "Aura icons can now be edited after creation: select one in the Icon Catalog and the new Aura Tracking section changes what it watches - buff or debuff, which units, Own Auras Only, even the spell ID - while the icon keeps its look, position, and group placement. No more delete-and-recreate because one option was missed." },
          { title = "Loot Planner Guide Buttons", desc = "The bar inside the Adventure Guide now carries a Set Up button that opens the Loot Planner options directly, and a small x that can switch the whole module off right from the guide (re-enable any time in Settings > Modules). Gear scanning moved into the Loot Planner options tab." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Masque and Aura Icons", desc = "With Masque enabled, aura icons no longer show broken skin pieces (empty silver border squares, a backdrop covering the live aura), and they keep their own Zoom, Aspect Ratio, and Padding instead of losing them to Masque - the sliders stay editable too. Masque skinning is not yet supported on aura icons (a proper version is planned), so they now stay cleanly under ArcUI's control; every other icon type is unaffected." },
        },
      },
    },
  },
  {
    version = "3.8.8.a",
    sections = {
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Guided Tour", desc = "Fixed the tour highlight getting stuck on screen or showing up in combat. The tour now runs only from the options panel and cleans up completely when you leave it." },
        },
      },
    },
  },
  {
    version = "3.8.8",
    sections = {
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Loot Planner", desc = "Now ships knowing every class and spec's loot for the current raids and Mythic+ season and keeps its lists fresh on its own - every page is full from the first open, the Mythic+ drops page works even without a sim, and old-content coins or slow loading can no longer leave the overview on the wrong raid or half-filled." },
          { title = "Loot Planner", desc = "Item tooltips show the real item at the right item level (sim-priced items at the exact level your sim used), items best used through the Catalyst are tagged with the set piece they become, and tooltips open at your cursor." },
          { title = "Loot Planner", desc = "Smarter sims: healers can import QE Live Upgrade Finder reports, a sim finds its own character and spec on import, a drop and its Catalyst conversion count as one roll instead of two, and owned checks no longer trigger off an alt's lower-difficulty version." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Aura Groups", desc = "Targeting yourself or a friendly player no longer fills tracked-debuff slots with random debuffs; those slots now stay empty until you have a valid target, while utility debuffs that always identify keep working everywhere." },
          { title = "Aura Groups", desc = "Only Mine is respected in the live view: another player's copy of a debuff you track no longer shows in your row." },
          { title = "Aura Groups", desc = "Changing targets updates the row immediately, in combat too." },
        },
      },
    },
  },
  {
    version = "3.8.7",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Loot Planner", desc = "A whole new module: your Raidbots sims in the game. Every raid boss and item shows a real DPS value in the Adventure Guide, bonus rolls get planned instead of guessed, coins are protected from accidental rolls, and your roll history is tracked. Plan reminders pop at the vault and when you earn coins, sims and loot pools are saved per spec, and it all lives under one tab with a single master switch. Goes dormant automatically if you run the standalone Arc Loot Planner addon." },
          { title = "Loot Planner Tour", desc = "The first time you open ArcUI's options on this version, a short guided tour offers to walk you through the new Loot Planner: sims, planning, protection, and the Adventure Guide view." },
          { title = "Module Switches", desc = "Settings now opens with a Modules section: master toggles for Castbar, Kick Assist, Pings, and Loot Planner. Turning one off disables the whole module on the spot and hides its tab until you switch it back on." },
          { title = "Transparent Icons", desc = "Setting Custom Icon to 0 (or Show Icon off) hides the icon art while glows, cooldown swipe, and texts keep working - track procs on an invisible icon again, like the old days." },
          { title = "Kick Assist Window", desc = "The ready-check window is now titled ArcUI Kick Assist and carries its own Enable Kick Assist checkbox, so you can switch the whole helper off right from the popup." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Honest Aura Alphas", desc = "On aura icons, Aura Active alpha 0 now truly hides everything, and setting it to 0 also sets Inactive alpha to 0 (in combat the game hides aura state from addons, so the two cannot be split at zero - the tooltips now explain this)." },
          { title = "Addon Icon", desc = "ArcUI now shows its own icon in the AddOns list, and the minimap button's icon sits centered in its ring." },
          { title = "Future-Proof Item Lookups", desc = "Item icons, keybind detection, and cooldown reminders moved to the current item APIs so deprecated-function errors can't bite." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Tooltips After Hiding the UI", desc = "Disabled icon tooltips no longer come back after hiding and re-showing the interface (Alt+Z or cinematics)." },
          { title = "Arc Icons After Spec Swap", desc = "Icons created mid-session or after a spec change now respect click-through and tooltip settings immediately, without opening the options panel." },
          { title = "Groups Borrowing Other Specs' Positions", desc = "A new group can no longer silently adopt another spec's stored anchoring from a shared layout set; renaming onto a stored record is guarded too." },
          { title = "Group Columns Growing Back", desc = "Auto-reflow groups no longer regrow a deleted column on reload from a stale saved slot." },
          { title = "Aura Group Sizing", desc = "Aura group icons keep their exact size when the options panel closes, and per-icon size overrides now apply in the live view." },
          { title = "Debuffs in Aura Groups", desc = "Debuff icons added to a dynamic aura group now show up in the live view and share the row with buffs, in grid order." },
          { title = "Duplicate Aura Rows", desc = "Fixed whole rows of identical aura copies appearing after vehicles, cinematics, or encounter ends; the group now self-repairs its filters." },
          { title = "Blizzard Proc Glow Color", desc = "Custom colors on the Blizzard Proc glow now render true on aura icons instead of tinted gold." },
          { title = "Black Box on Invisible Icons", desc = "Aura icons no longer show a black square at Active alpha 0, or a dark backing at partial alpha when the Missing look is hidden." },
          { title = "Segmented Bars Losing Customizations", desc = "Segmented stack bars no longer lose textures and colors outside the options panel, including textures from addons that load late." },
          { title = "Segmented Colors on Custom Aura Bars", desc = "Color Ranges and Per Stack Overrides now render on engine-driven custom aura bars: matching shades, tick marks aligned to the fill, and range boundaries landing on the exact stack." },
          { title = "Custom Bar Spell ID", desc = "Typing a new spell ID for a custom bar no longer errors and reverts to the old ID." },
        },
      },
    },
  },
  {
    version = "3.8.6.a",
    sections = {
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Custom Icons Switching in Combat", desc = "A custom icon no longer switches back to the spell's default art during combat when Ignore Aura Override is enabled on the same icon. The custom icon always wins." },
        },
      },
    },
  },
  {
    version = "3.8.6",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Cooldown Sound Alerts", desc = "Icons can now play a sound or speak a line on cooldown events: Ready, On Cooldown (No Charges), On Cooldown (Recharging), and Charge Gained. Each trigger has its own sound and speech toggles, an output channel picker, and works on CDM icons and Arc spell/item icons alike - in dungeons and raids too." },
          { title = "Icon Copies", desc = "Adding a spell or item you already track now creates another copy of it (\"Stormstrike (2)\") instead of doing nothing. Each copy is a full icon with its own settings and placement - up to 5 per spell, great for charge spells and multi-position layouts." },
          { title = "Target Castbar", desc = "A third castbar for your current target, with the full option set the player and focus bars have: interrupt readiness, uninterruptible color, important-cast glow, raid marker, and more." },
          { title = "Castbar Skins for Focus and Target", desc = "The skin system now covers all three castbars, sharing one skin list: save a look once and load it on any bar. Auto-switch rules (per spec, with talent conditions) work on the focus and target bars too." },
          { title = "Castbar Class Color", desc = "New toggle to color the player castbar with your class color." },
          { title = "Focus Hide Conditions", desc = "Bars gained \"No Focus Target\" and \"Has Focus Target\" hide conditions." },
          { title = "Editable Spell ID on Custom Bars", desc = "A custom aura bar's spell ID can now be changed in place - the bar and its catalog entry follow immediately, no delete-and-recreate." },
          { title = "Hide Stack Text at 0", desc = "Cooldown Manager tracked bars that stay visible while their aura is down can now blank the stack number instead of showing 0." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Sound Alerts Panel Rework", desc = "Both alert panels (aura and cooldown) now show each trigger in its own titled box with separate Sound and Speech toggles, so you can enable one, both, or neither per trigger. \"None\" now sits at the top of every sound list." },
          { title = "Stack Numbers From 1", desc = "Stack text on bars now shows from the first stack instead of only at 2 or more." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Removing a Row or Column With Icons", desc = "Shrinking a group no longer makes the icon in the removed space invisible (and no longer grows the column back on reload). Icons move to a free slot when there is room; when the group is full, the removal is refused with a message instead of losing an icon." },
          { title = "Some Alert Sounds Never Played", desc = "Sounds from certain packs (like the Arc Pings set) were silently failing to play in aura alerts. They play now." },
          { title = "Deleted Custom Bars Coming Back", desc = "Deleting a custom aura bar and creating a new one no longer resurrects the deleted bar's tracking." },
          { title = "Ghost Bar After Changing a Bar's Spell", desc = "Reconfiguring a bar to a different aura no longer leaves the old aura still driving the fill and text." },
        },
      },
    },
  },
  {
    version = "3.8.5",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Aura Bar Targets", desc = "When you add your own aura bar, you can now choose what it tracks (buffs, debuffs, or both) and who it watches (you, your target, focus, pet, or party members - any combination). There is also a toggle to only show auras you applied yourself. The add window now looks and works like the one in the icon catalog, and everything can be changed later per bar." },
          { title = "Alert Sound Channel", desc = "Aura icon alert sounds can now play through whichever volume slider you pick (Master, Sound Effects, Music, Ambience, or Dialog)." },
          { title = "New Sounds", desc = "Added \"Ultra Instinct\" and \"Ultra Instinct Theme\" to the sound list, usable anywhere you can pick a sound." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Glow Settings Pass", desc = "All the glow options (position, size, layering) now actually work on every glow type, for both CDM icons and Arc icons - several of them previously did nothing. Glows also no longer sit slightly off-center when padding is set, and the marching-ants glow no longer restarts from the beginning every time you cast while using Masque." },
          { title = "Cooldown Reminder Big Cooldowns", desc = "Reminders now work reliably for spells with long cooldowns (like 3 to 5 minute cooldowns) - previously the reminder could give up before the spell came back." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Icons Showing the Wrong Cooldown After Talent Changes", desc = "After changing talents or Cooldown Manager settings, icons could look ready while the spell was actually on cooldown (or look on cooldown while ready) until you cast something. Icons now always show the right state immediately." },
          { title = "Groups Growing Extra Columns", desc = "Fixed groups growing extra columns or moving icons around on their own after talent changes, especially with shared or imported layouts." },
          { title = "Icons Swapping Places", desc = "Icons in dynamic groups no longer trade spots back and forth for no reason." },
          { title = "Giant Icon on Screen", desc = "Fixed a rare bug where an icon could suddenly appear huge in the middle of the screen." },
          { title = "Masque Background Stuck On", desc = "With Masque on, an icon's skin background no longer stays visible when the icon itself is hidden." },
          { title = "Castbar Stuck After Loading Screens", desc = "Finishing a cast right as a loading screen hits (Hearthstone, dungeon teleports) no longer leaves the castbar frozen on your screen." },
          { title = "Custom Aura Bars Lost on Import", desc = "Sharing your bar setup with someone (or another character) no longer breaks manually added aura bars." },
        },
      },
    },
  },
  {
    version = "3.8.4",
    sections = {
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Hidden icons stay in the Icon Catalog", desc = "An Arc icon unloaded by its spec or talent condition now stays listed with a red \"off\" tag, so you can still select it and change its conditions. The filter also gained an Arc Auras option and moved under the Icon Catalog header." },
          { title = "Groups grow back for returning icons", desc = "If you shrink a group while one of its icons is hidden by a talent condition, the icon's return now restores the group to its saved shape and puts the icon back in its old slot, with a chat message. Before, it could end up stacked on top of another icon." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Groups no longer gain a column at login", desc = "A group could permanently grow one column wider when logging in, getting a little wider over time. Found at the root and fixed." },
          { title = "Ghost borders from condition-hidden icons", desc = "An Arc icon hidden by its spec or talent condition could leave behind a border that even showed a tooltip, while the icon itself was gone." },
          { title = "Talent conditions on custom timers apply immediately", desc = "Setting a spec or talent condition on a custom timer from the icon settings panel now hides or shows it right away, instead of only after a reload." },
        },
      },
    },
  },
  {
    version = "3.8.3",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Keep Texture Still", desc = "New toggle for bars that mirror a Cooldown Manager timer and fill up as time passes: the bar texture stays in place while the fill moves through it, instead of the whole texture stretching with the fill. Find it in the bar's Fill section." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "The bar list now tells you why a bar is not on screen", desc = "A bar that exists but is hidden now says why next to its name: not shown on this spec, opacity set to 0, or hidden because its aura is not active. No more hunting for bars that are working exactly as configured." },
          { title = "Totem slots answer the icon field", desc = "Typing an icon ID for a totem slot now explains that totem slots always show the totem's own icon, instead of silently doing nothing." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Custom icons sometimes did not apply at login", desc = "A custom icon on a Cooldown Manager icon could show the default art until you re-entered the ID in the options panel. It now applies on its own, at login and whenever the game reshuffles icons." },
          { title = "Custom icons fought the icon in combat", desc = "A custom icon could flip back and forth against the original art during fights. One system now owns the icon art, so the flicker is gone." },
          { title = "Custom icons on aura icons only changed the inactive look", desc = "The icon you picked now also shows while the buff or debuff is active, not just on the dimmed inactive state." },
          { title = "Wrong spell tracked while a cooldown is replaced", desc = "When an ability temporarily turns into another one (for example during Ascendance), glows and cooldown state now follow the replacement spell instead of staying on the base spell for the whole window." },
          { title = "Icons stayed grey after portals and zone changes", desc = "An icon set to desaturate only while its aura is missing could arrive in the new zone desaturated and stay that way until the options panel was opened." },
          { title = "Error spam from trinket and potion icons in dungeons", desc = "A repeating error could start mid-dungeon and not stop until a reload." },
          { title = "Bar name text went missing with Hide When Inactive", desc = "Custom aura bars set to hide when inactive showed up without their name text. The name now appears with the bar." },
          { title = "Stray numbers floating on screen", desc = "A stack count could stay behind on screen after its bar hid, with nothing under it, until a reload." },
          { title = "Proc Glow reset button was in the wrong section", desc = "The Reset Section button for Proc Glow sat under Spell Usability; it is back with the Proc Glow options." },
        },
      },
    },
  },
  {
    version = "3.8.2",
    sections = {
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Aura icons and bars fix themselves", desc = "They could start showing a completely different aura after a vehicle, cinematic, faction change or boss kill. They now correct themselves right away." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Aura icon borders stayed visible when the icon was hidden", desc = "With Aura Missing opacity at 0 the border kept showing, usually after a group join or zone change." },
          { title = "Castbar imports landed in the wrong place", desc = "A string from someone on a different interface scale now puts the bar where they had it." },
          { title = "Kick Assist macro errors", desc = "The Macros tab could error, and managed macros could not be created or edited." },
          { title = "Kick Assist edited the wrong macro", desc = "Edits could go to an account macro with the same name instead of yours." },
          { title = "Errors while tracking potions, healthstones and trinkets", desc = "Opening the options panel could throw repeating errors." },
          { title = "Error when adding a custom cooldown in a dungeon or raid", desc = "The duration auto-fill could error instead of leaving the field for you." },
          { title = "Stray icons after logging in", desc = "Untracked icons with borders and tooltips could appear." },
        },
      },
    },
  },
  {
    version = "3.8.1",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Aura icons pick a type and a set of units", desc = "Choose Buff, Debuff or both, then tick who to watch: you, target, focus, pet or party. The icon lights up when any ticked unit has the aura, so one icon can cover several people. Icons you already made keep working exactly as before." },
          { title = "Aura picker", desc = "Add an aura icon by clicking it from a grid of everything the Cooldown Manager knows for your spec, instead of hunting for a spell ID. Auras you already track are dimmed, and ones in the database but missing from your CDM display are marked." },
          { title = "Own auras only", desc = "An aura icon can ignore other players' copies of the same buff or debuff and react only to yours." },
          { title = "More than one icon for the same aura", desc = "You can now create several icons for one spell, to watch it on different units or give each a different look." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Account sharing now has one owner", desc = "Only the character you push from sends its layout out. Everyone else receives it and keeps their own edits local, so an alt can no longer take the profile over just by moving something. Press Push to make the character you are on the source." },
          { title = "More of your setup travels between characters", desc = "Aura icons, custom icons and totem slots now sync with shared profiles. Until now they never left the source character, so alts quietly ended up with a different set." },
          { title = "Trinket auto-tracking starts turned off", desc = "New characters no longer track trinket slots on their own. Characters that already have it on are untouched." },
          { title = "Deleting a trinket icon turns its slot off", desc = "It no longer reappears on your next login." },
          { title = "New Icon routing shows deleted groups", desc = "If a routing option points at a group you have since deleted, the panel says so instead of showing a blank dropdown." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Cooldown bars vanished on charge spells", desc = "The bar disappeared when the first charge came back. It now runs through the whole recharge." },
          { title = "Pulling a shared profile removed your Arc icons", desc = "Aura icons, custom icons and totem icons were destroyed every time a profile was pulled. They now survive it." },
          { title = "Deleted groups came back", desc = "Deleting a group in a shared layout now removes it for every character using that layout. Another character could previously rebuild it on login and hand it back to everyone." },
          { title = "Icons from a deleted group", desc = "They become free icons you can place, instead of quietly recreating the group they pointed at." },
          { title = "Totem icons jumped to the middle of the screen", desc = "They no longer lose their position when you log in." },
          { title = "Icons drifted off the side of the screen", desc = "Icons could be pushed further right each time until they left the screen entirely." },
          { title = "Stray icons appeared after logging in", desc = "Untracked icons with borders and working tooltips no longer show up." },
          { title = "Errors with potions, healthstones and trinkets", desc = "Fixed an error that could repeat in dungeons and raids for anyone tracking them." },
          { title = "Icons stranded when a group was removed", desc = "Icons whose group disappeared during a profile or spec change are no longer left styled but unplaceable." },
        },
      },
    },
  },
  {
    version = "3.8.0.b",
    sections = {
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Display Export", desc = "\"Bars Export\" is now \"Display Export\" and includes your textures and castbar, so one string moves your whole setup." },
          { title = "Textures ask for a tracking type", desc = "New textures now show \"Type Not Set\" until you pick Buff, Debuff, Pet Buff, Totem or Ground, just like bars." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Icons set to show while a buff is missing didn't appear", desc = "They stayed hidden if Cooldown Manager's \"Hide when inactive\" was on. Your Aura Missing opacity controls this again." },
          { title = "Icons flickered when a buff ended", desc = "The brief blink as an aura dropped is gone." },
          { title = "Totem icons stayed bright on cooldown", desc = "Totem spells that show a cooldown, like Surging Totem, now grey out properly." },
          { title = "Pandemic glow stayed on", desc = "It could keep glowing after the aura expired until you switched target." },
          { title = "Cooldown Manager tooltip errors", desc = "Hovering an icon could spam errors. Fixed at the source this time." },
          { title = "Spell usability tinting removed desaturation", desc = "Icons randomly stopped greying out while on cooldown." },
          { title = "Error spam when a spell changed form", desc = "Fixed a burst of errors in dungeons and raids." },
          { title = "Hidden Opacity ignored in combat", desc = "Bars could sit at the wrong opacity once combat began." },
          { title = "Arc icon tooltips", desc = "Hovering showed an internal window instead of the normal spell tooltip." },
          { title = "Timer icons flickered", desc = "Custom timers no longer blink when their group refreshes." },
          { title = "Icons hidden by bars could stay hidden", desc = "They now come back when they should." },
        },
      },
    },
  },
  {
    version = "3.8.0.a",
    sections = {
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Border errors in instances", desc = "The 3.8.0 border alignment fix could throw errors in restricted content (dungeons, raids, restricted world events), where the game hides even rendering properties from addons. The border now remembers what it needs from unrestricted moments and never asks the game for it under lockdown." },
          { title = "Stack text behind the border on aura icons", desc = "On Arc aura icons the stack count and duration text could be covered by the icon border; all icon texts now always draw above it." },
          { title = "Right-click menu on Arc icons removed", desc = "The context menu (configure, always-show, change icon, remove) is gone; everything it offered lives in the Arc Auras panel and the CDM Icons catalog." },
          { title = "Oversized icons in groups", desc = "An icon with Group Scale off and a larger custom size now sits correctly inside its group boundary; before, it escaped out the top-left corner while empty space collected bottom-right." },
          { title = "CDM tooltip errors, round two", desc = "Hovering a CDM icon in restricted content could still produce a stream of tooltip errors every refresh tick; ArcUI-built tooltips no longer let the game's own tooltip refresher engage at all." },
        },
      },
    },
  },
  {
    version = "3.8.0",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Texture Tracking Types", desc = "Textures now use the same tracking dropdown as bars: Buff (you), Debuff (target), Buff (pet), and Totem. Images can react to pet buffs and totem timers, with duration text and Drain As It Expires working on every type." },
          { title = "Timer Mirror fill options", desc = "Bars that mirror a Cooldown Manager timer can now fill up instead of draining, reverse direction, and animate smoothly." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Texture editor sub-tabs", desc = "Each texture's settings are organized into Source, Transform, and Duration sub-tabs instead of one long panel." },
          { title = "Cleaner texture creation", desc = "Creating a texture no longer jumps you to a different tab; the new texture expands in place and asks for its tracking type up front, just like bars." },
          { title = "Options apply on the spot", desc = "Enabling or disabling duration text, drains, and Show Duration on bars and textures now takes effect the moment you click, instead of waiting for a reload or the next time the aura appears." },
          { title = "Description cleanup", desc = "Outdated notes in the texture panels were replaced with what actually applies on 12.1." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Free icons vanishing in combat", desc = "Fixed free-placed icons disappearing at the start of combat until a reload." },
          { title = "Aura state stuck after target swaps", desc = "Target-debuff icons could keep their active look, or stay desaturated or hidden, after switching targets; every target change now re-verifies the real aura state." },
          { title = "Icon borders drawn off the icon", desc = "Borders could render up to a pixel off the icon art at certain screen positions, and moving the group changed which icons were affected. Border and icon now render by the same pixel rules and stay glued at any position." },
          { title = "Arc icon size in groups", desc = "Arc spell and item icons in a group now match their CDM neighbors exactly: identical pixel-perfect frame size after drags and options-panel closes, and identical icon art trim (arc art was cropped slightly less than Blizzard's, making it look a different size)." },
          { title = "Group mouse errors in a party", desc = "Fixed \"attempt to access forbidden object\" errors from group click-through handling while in a group or raid." },
          { title = "Tooltip errors in restricted content", desc = "Hovering CDM icons in instances could start a stream of tooltip errors; ArcUI now builds those tooltips itself from safe data." },
          { title = "Wrong aura on custom debuff icons", desc = "A custom debuff icon could briefly show an unrelated buff after loading screens or spec changes; tracking filters are now always explicit and re-asserted at those moments." },
          { title = "Border errors in instances (3.8.0.a)", desc = "The 3.8.0 border alignment fix could throw errors in restricted content (dungeons, raids, restricted world events), where the game hides even rendering properties from addons. The border now remembers what it needs from unrestricted moments and never asks the game for it under lockdown, same as the potion fix in 3.7.12.b." },
          { title = "Stack text behind the border on aura icons (3.8.0.a)", desc = "On Arc aura icons the stack count and duration text could be covered by the icon border; all icon texts now always draw above it." },
          { title = "Right-click menu on Arc icons removed (3.8.0.a)", desc = "The context menu (configure, always-show, change icon, remove) is gone; everything it offered lives in the Arc Auras panel and the CDM Icons catalog." },
          { title = "Oversized icons in groups (3.8.0.a)", desc = "An icon with Group Scale off and a larger custom size now sits correctly inside its group boundary; before, it escaped out the top-left corner while empty space collected bottom-right, and drag-and-drop targeting in that group was off by the same amount." },
          { title = "CDM tooltip errors, round two (3.8.0.a)", desc = "Hovering a CDM icon in restricted content could still produce a stream of tooltip errors every refresh tick; ArcUI-built tooltips no longer let the game's own tooltip refresher engage at all." },
        },
      },
    },
  },
  {
    version = "3.7.12",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "New Icon Routing", desc = "Choose where newly added Cooldown Manager icons go, per category: send new Essential, Utility, or Buff icons to a specific group, to a free position, or leave the default. Set it account-wide with per-character and per-spec overrides in the Groups panel, and CDM export/import strings can now carry your routing (new \"New Icons\" checkboxes with a preview of where each category goes)." },
          { title = "Show IDs on Hover", desc = "New global toggle that adds an ArcUI ID readout to tooltips: cooldown ID, spell ID, override and linked spells, equip slot, item category, and the icon texture ID the Custom Icon box accepts. Works on CDM icons, Arc icons, action bars, buffs, bags and more." },
          { title = "Out of Stock look for potions and healthstones", desc = "Cooldown Manager potion and healthstone icons get their own Out of Stock section: choose desaturation, opacity, and an optional tint for when your bags run dry, and the icon recovers the moment you restock. Dim When Out of Stock is now available on these icons too." },
          { title = "Pingable toggle (Arc Pings)", desc = "Every icon and group gets a Pingable toggle: turn it off and pings pass straight through that icon to the world instead of announcing the hovered spell. Works on Arc icons and Blizzard's own CDM icons." },
          { title = "New sound: Kaching", desc = "An \"ArcUI: Kaching\" sound is now available in every ArcUI sound dropdown." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Aura icon glows completed", desc = "The Aura Active glow on aura icons now supports Scale, X/Y Offset, Glow Strata, and Glow Frame Level; the style dropdown shows the style actually applied; and the Preview toggle now works on aura icons, showing the glow without the buff up so you can tune it." },
          { title = "Totem, pet, and ground bars", desc = "These bars now honor a custom Max Duration and the bar-color and countdown-text threshold coloring options." },
          { title = "Ping Keys with action bar addons", desc = "Ping Keys now work with Bartender4, ElvUI, and mixed bar setups, and follow rebinds and profile switches without re-adding." },
          { title = "Max Duration honesty on 12.1", desc = "For regular aura bars the Max Duration option is now locked to Auto with an on-panel explanation (12.1 removed the API for a custom maximum); totem-type bars keep their working custom max." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Giant or wrong-sized CDM icons", desc = "Fixed the intermittent bug where icons could suddenly render huge or take another icon's size, most often when opening the options panel, plus new safety guards so a bad size can never be stamped again." },
          { title = "Group renames", desc = "Renaming a group (including Essential/Utility/Buffs) no longer brings back an empty default group every login, and no longer leaves ghost drag overlays or floating slot-number badges behind." },
          { title = "Aura icon states", desc = "Active Alpha now actually dims the icon and swipe, Preserve Duration Text keeps the texts at full strength, and Show Icon off hides the artwork while keeping duration and stack text visible, with the icon still shown for editing while the options panel is open." },
          { title = "Pulse glow was invisible", desc = "The Pulse glow styles on aura icons rendered nothing in real play (they only showed in the preview); they now use the Cooldown Manager's own alert flash art." },
          { title = "Potion and healthstone icons", desc = "Fixed the errors these icons could throw from usability tint, glows, and tooltip hover; potions now stay colored while their buff is running instead of greying out immediately; and Glow When Aura Active now works on item icons." },
          { title = "Cooldown bars across specs", desc = "Bars set to show on multiple specs no longer read \"Tracking Failed\" outside the spec they were created in." },
          { title = "Pet and totem bar countdowns", desc = "Duration text on pet, totem, and ground-effect bars (e.g. Call Dreadstalkers) shows again on 12.1, and aura bars with a manual max no longer sit stuck at full." },
          { title = "Stack bars over 20 stacks", desc = "Ticks, borders, and the At Max color no longer vanish on bars with more than 20 stacks." },
          { title = "Post-dungeon error", desc = "Fixed an \"EnableMouse on bad self\" error that could appear after dungeons on icons carrying the new stack-count displays." },
          { title = "CN client crash shield", desc = "Worked around a Chinese-client bug that could crash the game when aura countdown text refreshes; decimal countdowns on aura icons show whole seconds on the CN client until Blizzard fixes it." },
          { title = "Custom Icons form error", desc = "Adding a Custom Icon timer by spell ID no longer errors on submit." },
          { title = "Debuff bars track only your own debuff again", desc = "Since 12.1, a duration bar, texture, stack count, or duration override for a target debuff (e.g. Colossus Smash) could light up when another player applied the same debuff. They now follow only your own cast, as before." },
          { title = "Potion and healthstone errors in restricted content", desc = "The bag-item features could throw errors during 12.1 restricted open-world events (e.g. Prey Hunts) and in instances, where the game hides item identities from addons. ArcUI now remembers each item's identity from unrestricted moments, so cooldown visuals, out-of-stock detection, and tooltips keep working fully everywhere." },
        },
      },
    },
  },
  {
    version = "3.7.11",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Use Texture Colors", desc = "A new toggle on aura, stack, duration, cooldown, charge, and resource bars plus both castbars: show your fill texture's own colors (gradients, rainbows, artwork) instead of tinting it with the bar color. Color controls that no longer apply gray out and say why." },
          { title = "One voice for the whole addon", desc = "Everything that speaks (Cooldown Reminder, CDM aura alerts, Arc icon alerts) now shares one Voice and Speech Rate setting and respects your Text-to-Speech volume. New speech controls include a Test Voice button, the \"sound between messages\" tick toggle, and a shortcut to WoW's own speech options." },
          { title = "Ignore Spell Overrides for Arc spell icons", desc = "A new per-icon toggle that keeps an Arc spell icon on its base spell's cooldown, artwork, and glows even while the spell is temporarily overridden." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Auto-Track Trinket Slots got their own section", desc = "The trinket auto-track controls moved out of the filter dropdown into a collapsible section right under Global Options, and an auto-tracked icon's Enabled toggle now drives the slot setting itself, so turning one off finally sticks across reloads." },
          { title = "Proper alert sound pickers", desc = "CDM aura alert dropdowns now show sound names with a preview button instead of raw file paths, and sound and speech can be set independently for every alert." },
          { title = "Icons stay honest through spec changes", desc = "An icon could keep an \"aura active\" look or a stuck ready glow after changing specs; ArcUI now re-checks every icon once the Cooldown Manager finishes shuffling and clears anything stale automatically." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "CDM aura alerts fire again", desc = "The alert feature was silently broken, and it now also covers icons the Cooldown Manager creates mid-session in dungeons." },
          { title = "Potions and healthstones get cooldown visuals", desc = "Bag-item icons in the Cooldown Manager never dimmed or dropped their ready glow. Item icons' ready glow also no longer stays on through the whole cooldown, and Ignore Aura Override now works on them." },
          { title = "Custom Icon field works again", desc = "Entering a spell, item, or icon ID in the Custom Icon box threw an error on every keystroke." },
          { title = "Custom icons stop flickering in combat", desc = "A custom icon could snap back to the original artwork and flip between the two mid-fight, especially in dungeons." },
          { title = "Stack bars show their countdown in combat", desc = "A stack bar's duration text went blank the moment combat started." },
          { title = "Settings apply without a reload", desc = "Changing countdown color thresholds, visiting the options panel, or flipping a bar between Stacks and Duration mode could silently kill a bar or texture countdown until a reload, especially after a fight." },
          { title = "Textures added by spell ID count down", desc = "Their duration text and drain never attached at all." },
          { title = "Hiding an icon keeps its texts", desc = "With Show Icon off, the stack count and countdown vanished along with the icon art instead of floating on their own." },
        },
      },
    },
  },
  {
    version = "3.7.10",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Aura Icons: Track Any Buff or Debuff by Spell ID", desc = "Give it a spell ID and you get an icon for that aura, whether or not the Cooldown Manager knows about it. They keep working in raids and Mythic+, where addons are no longer allowed to read your auras: a dimmed ghost while the aura is missing, the real icon while it is on you." },
          { title = "Spell-ID Aura Groups", desc = "Aura icons get their own group type that flows and compacts like any other Arc group, with its own border, title, drag mode, visibility conditions and per-spec profiles." },
          { title = "Aura Alert Sounds", desc = "Play a sound the moment an aura lands, refreshes or drops. The game plays these itself, so they still fire in content where aura tracking is hidden from addons." },
          { title = "Cooldown Manager Aura Alerts", desc = "Sounds and spoken callouts for buffs and debuffs tracked by the Cooldown Manager, with separate triggers for gaining it, losing it, and stacks going up." },
          { title = "Refresh-Window Glows", desc = "Aura icons can glow during the pandemic window, so you know exactly when reapplying is worth it." },
          { title = "Aura Bars and Textures by Spell ID", desc = "The Aura Catalog has a new green Add tile: enter a spell ID and it joins the catalog, so the same buttons build a duration bar, a stack bar or a texture for auras the Cooldown Manager never sees." },
          { title = "Ping Keys and the Ping Feed", desc = "Call your cooldowns out to your group with one key and no macros, and read everyone's pings in a window you can lay out yourself." },
          { title = "New Add Window for Arc Icons", desc = "One place to add items, trinkets, spell cooldowns, aura icons and custom timers, with a drag-and-drop zone." },
          { title = "One Icon Catalog", desc = "The Arc Icons and Custom Icons tabs are gone: every icon, its settings, load conditions, the timer editor, auto-tracking and bulk management now live together in the Icon Catalog." },
          { title = "Guided Tours", desc = "The What's New window can now walk you to exactly where the new features live." },
          { title = "Stack Priority for Free Icons", desc = "Free-positioned icons get a Stack Strata and Stack Level control in Icon Positioning, so you decide exactly which icon draws on top when icons overlap. The whole icon moves together: glows, text and keybinds follow." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Aura Textures Work Again on 12.1", desc = "Progress and Drain textures are driven by the game engine now, so the art still drains during combat and inside instances." },
          { title = "Bulk Management for Arc Icons", desc = "Clear all spells, all aura icons or everything at once, and force a refresh of Arc frames." },
          { title = "Layout Safety Warning", desc = "Loading a profile while layouts are linked can overwrite the shared layout on every character. The first time you do something risky, ArcUI explains it once." },
          { title = "Smoother Resource Bars", desc = "Energy and other fast-regenerating bars moved in visible chunks out of combat. They now update ten times a second while regenerating, and still cost nothing at rest." },
          { title = "One Line at Login", desc = "ArcUI now prints a single load message instead of a stream of module chatter." },
          { title = "Fewer Cooldown Updates per Keypress", desc = "Icons only react to cooldown events that actually concern them, cutting the work done on every cast of any ability." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Replacement Spells Show Their Real Cooldown", desc = "Spells that get swapped out by a talent or a proc (Stormstrike becoming Windstrike under Ascendance, Flame Shock becoming Voltaic Blaze) were read from the original spell, so those icons looked like they were never on cooldown. They now follow whichever form is live, and the icon art follows it too." },
          { title = "High-Haste Cooldown Flicker Fixed", desc = "Cooldown icons no longer blink ready for a split second mid-cooldown when you press other abilities, which got worse the more haste and cooldown reduction you had. Any cooldown read taken while a global cooldown is running now re-checks itself the moment that global ends, on both Arc icons and Cooldown Manager icons." },
          { title = "Cooldown Manager Icons Gray Out on Cooldown Again", desc = "Managed icons could stay full-color while on cooldown even though Arc icons of the same spell grayed out correctly. ArcUI now drives the gray-out itself instead of relying on the game's, which silently stops working on styled icons." },
          { title = "Totem Icons No Longer Stick as Active", desc = "A totem icon could keep showing as active after the totem was gone, most visibly on Earthbind." },
          { title = "Charge Numbers No Longer Vanish on Faded Groups", desc = "A group at partial opacity hid its charge text completely until you opened the CD Manager panel." },
          { title = "On-Use Trinkets No Longer Go Missing at Login", desc = "A trinket whose data had not loaded yet was treated as passive and hidden by the On-Use filter until you toggled auto-track off and on." },
          { title = "Layouts No Longer Look Like They Reset on Every Relog", desc = "A phantom spec entry created early at login made ArcUI read and write the wrong spec's layout depending on timing." },
          { title = "Cooldown Reminder Fires for Buff-Consumption Cooldowns", desc = "Spells whose cooldown only starts when the buff is spent never armed their ready reminder." },
          { title = "Bars and Textures Survive a Combat Reload", desc = "Reloading mid-fight or inside a dungeon could leave a duration bar's fill frozen and an aura texture's art static for the rest of the session, because they only set themselves up if the aura happened to be active at the right moment. They now set up as soon as they know which aura they track." },
          { title = "Aura Texture Art Shows Its Real Colour", desc = "Progress and Drain art could come up with the dimmed \"missing\" colour baked in instead of the active one." },
          { title = "Duration Text Settings Apply on 12.1 Bars", desc = "Decimals, abbreviation and colour-by-time were being ignored on engine-driven bars." },
          { title = "Bar Fill and Tick Marks", desc = "Bar fill no longer bleeds over the border, and tick marks come back on bars that hide when inactive." },
          { title = "Unit Frames Stay Put", desc = "Addons anchored to Arc icon groups no longer drift when the group is rebuilt." },
          { title = "Charge Bars Hide for Spells Your Build Doesn't Know", desc = "A charge bar for an untalented spell (like Healing Stream Totem on Elemental) stayed on screen as an empty black frame instead of hiding." },
          { title = "The Utility Group Keeps Its Column Count", desc = "Column settings could creep back to their default after a reload or relog." },
          { title = "Trinkets Keep Their Slot", desc = "A trinket icon could get bumped out of its saved position by another icon claiming the same cell during login or a spec change." },
          { title = "Cooldown Reminder Panel Grays Out While the Module Is Off", desc = "So it is clear those settings will not do anything until you enable it." },
        },
      },
    },
  },
  {
    version = "3.7.9",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Apply Look: Copy a Bar's Style Onto Other Bars", desc = "Style one bar, then apply its look to all bars of that type, all bars of every type, or a hand-picked list. The Include toggles choose what gets copied, and Text is now split into Stack, Duration, Name and Ready text so you can copy exactly the part you want." },
          { title = "Skins Panel Cleanup + Castbar Skin Picker", desc = "The Load Skin dropdown now lives inside the Skins section for every bar type, and the Castbar finally has its own, so loading a saved skin is where you'd expect it." },
          { title = "Castbar Skins Remember Position", desc = "Per-spec castbar skins now restore where the bar sits on screen, so switching specs puts each castbar back in its own spot. Re-save each skin once to pick this up." },
          { title = "Ignore Hard ICD for Charge Spells", desc = "New per-icon option for charge spells that lock briefly after each use (like Monk's Zenith): the icon no longer looks fully spent while you still hold a charge, and the swipe shows the real recharge instead of the lockout." },
          { title = "Gained-on-Cooldown Spells Just Work", desc = "Arc icons for spells you only have while a cooldown is active (Void Volley, Zenith Stomp) now appear when you gain them and disappear after, instead of being marked \"not part of this spec\" and needing Show Always." },
          { title = "Per-Side Fill Inset for Aura Bars", desc = "Independent Left/Right/Top/Bottom insets so custom bar textures with built-in borders sit perfectly inside the background. Contributed by Linawow." },
          { title = "Addon Integration API", desc = "Other addons can now anchor their frames to ArcUI's icon groups reliably (fixes unit frames shifting on druid form changes with MSUF, and opens the door for more integrations)." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Hide Stacks at Zero on Arc Icons", desc = "The \"Hide at 0\" option now works on Arc cooldown icon stack text, everywhere including dungeons." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Castbar No Longer Disappears Mid-Cast", desc = "Casting an instant spell (like Shimmer) or pressing your next cast early no longer hides the bar or flashes a false \"Cancelled\", and reloading mid-cast brings the bar right back." },
          { title = "Castbar Match Size Sticks After Reload", desc = "Castbars matched to a group's size no longer come back wrong after a reload." },
          { title = "Timer Text No Longer Flickers on Dimmed Icons", desc = "Cooldown text kept visible with Preserve Duration Text no longer flickers or vanishes while Ignore Aura Override is on (was worst on Fire and Storm Elemental)." },
          { title = "Custom Timer Icons No Longer Blink", desc = "Timer icons watching a spell no longer randomly flip between their Active and Not Active looks." },
          { title = "Thin Borders Sit Flush", desc = "1px icon borders no longer drift a pixel off the icon at some UI scales." },
        },
      },
    },
  },
  {
    version = "3.7.8",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Focus Castbar: Hide Non-Important Casts", desc = "Show the focus castbar only for casts Blizzard marks as important (the dangerous ones), so it stays out of the way during trash. Off by default." },
          { title = "Global Font & Texture", desc = "Set your font and bar texture once and apply them everywhere at once (all bars, both castbars, and cooldown text) instead of changing each one by hand." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Match Icon Edges Now Works on Aura Bars", desc = "Lines your aura bars up neatly with your icon group, the same way it already does for the other bar types. If you already had it on, the bar will snap into place." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Stacks and Timers Show Again", desc = "Fixed aura stack numbers and duration timers that had stopped showing for some players." },
          { title = "Midnight (12.1) Fixes", desc = "On the upcoming Midnight patch, duration bars and aura textures now keep working properly in combat." },
        },
      },
    },
  },
  {
    version = "3.7.7",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Patch 12.1 (Midnight) Support", desc = "ArcUI now runs on the 12.1 Midnight PTR. The new patch changes how buffs and debuffs can be read, which used to break large parts of the addon. ArcUI now detects the new restrictions and adapts, so your bars, cooldown icons, and aura tracking keep working. The few options the new rules make impossible are disabled on 12.1 and clearly marked in the panel (they still work normally on live). This is a work in progress and may have rough edges, but the addon is now usable on 12.1 instead of breaking." },
          { title = "Focus Castbar", desc = "A castbar showing what your focus target is casting, with spell name, timer, and icon. Color it differently for spells you can't interrupt or hide those entirely, show a marker the moment your interrupt comes off cooldown, keep the bar on screen briefly after a cast (colored for success, fail, or interrupt), and add a glow for important casts. Off by default, under Castbar > Focus Castbar. Contributed by Seraidi." },
          { title = "Dim or Hide a Cooldown Icon While Its Aura Is Active", desc = "A per-icon option to fade or fully hide a cooldown icon while the buff it tracks is up, so an icon that is already in use gets out of the way. Off by default." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Collapsible Option Sections", desc = "The Cooldown Reminder appearance and audio panel and the Custom Auras and Cooldowns lists now use collapsible headers so long panels are easier to scan." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Cooldown Reminder: No False Alert on Windup Items", desc = "Items with a short effect window before their real cooldown (like the Algari Puzzle Box) no longer announce \"ready\" the instant the effect ends." },
          { title = "Cooldown Reminder: Reminders Work Immediately When Set Mid-Cooldown", desc = "A reminder created or edited while the spell or item is already on cooldown now starts tracking right away." },
          { title = "Instance and Mythic+ Stability", desc = "Totem cooldown bars and secondary-resource bars (such as Soul Fragments and Maelstrom Weapon) no longer risk errors inside dungeons and raids." },
        },
      },
    },
  },
  {
    version = "3.7.6",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Kick Assist Interrupt Alert", desc = "Get a sound or spoken (text-to-speech) alert the moment your focus starts casting and your interrupt is off cooldown, so you know to look and kick. Pick from built-in alert sounds or any shared-media sound, choose the channel, set your own spoken word, and preview it. Off by default." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Single-Charge Spells as Cooldown Bars", desc = "Spells with a single charge, like Evoker's Fire Breath, now show up in the cooldown bar picker and track as a normal cooldown, instead of being mistaken for a charge spell and showing a 0/1 count." },
          { title = "Aura Threshold Glows on Self-Buffs", desc = "Fixed threshold glows on tracked buff and debuff icons that could fail to fire for personal buffs, so they now light up reliably as the aura nears your set threshold." },
        },
      },
    },
  },
  {
    version = "3.7.5.a",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Aura Textures", desc = "A new Buffs/Debuffs display type. Place any image on screen that turns on when a buff or debuff is active and off when it's gone. Pick from a built-in art gallery or your own file, drag and resize it in place, and optionally make it drain like a bar as the aura runs down, pulse, fade as it expires, or show a built-in countdown, with per-spec/talent and Hide When conditions." },
          { title = "Duration Text Threshold Colors", desc = "Aura bars and Aura Textures can recolor their remaining-time countdown through seconds-based thresholds, so the number changes color as the aura nears expiry." },
          { title = "Stack Threshold Colors", desc = "Color a tracked buff's stack number by how many stacks are up, with up to six adjustable count-and-color bands, working even in Mythic+ and instances." },
          { title = "Show Icon Toggle", desc = "A new per-icon switch hides the icon art, swipe and flash while keeping just the stack and duration text, for clean text-only trackers." },
          { title = "Desaturate When Aura Inactive", desc = "A new per-cooldown-icon option grays out the icon whenever its tracked buff drops, for an at-a-glance signal that the buff is down." },
          { title = "Kick Assist Smart Open", desc = "An opt-in mode that, after a ready check, briefly watches party chat and only opens the marker picker if someone else calls out your marker, so you only re-pick when there's an actual clash." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Reorganized Options Menu", desc = "Settings are regrouped for clarity, with a Buffs/Debuffs section gathering the aura Catalog, Textures and Appearance, and a dedicated Cooldowns section gathering Cooldown Bars, Custom Bars and Cooldown Reminder." },
          { title = "Bars Stay Out of the Way", desc = "Cooldown, charge, resource, custom and timer bars are now click-through during normal play and only become draggable while the options panel is open, so they no longer intercept clicks in combat." },
          { title = "Bar Name Text Fine-Tuning", desc = "Buff and debuff bars now expose X and Y offset on their name text, so you can nudge it after choosing a left, center or right position." },
          { title = "Cooldown Display Stability", desc = "Further back-end hardening of the cooldown icon display to reduce the chance of it breaking partway through Mythic+ or other instanced content." },
          { title = "Kick Marker Stays on Your Focus", desc = "Your interrupt marker is always placed on your focus and stays there, so re-pressing your kick key never moves it onto your current target." },
          { title = "Account-Wide Kick Assist Toggle", desc = "Turning Kick Assist on or off now applies to all your characters, with your existing setting carried over automatically." },
          { title = "Clearer Marker Macro Wording", desc = "Macro templates and the editor use a clearer marker placeholder and a renamed Add / Sync Marker Line button; older macros keep working." },
          { title = "Clearer Dynamic Cooldowns Help", desc = "The Dynamic Cooldowns option now explains that an icon only collapses out of the row when its alpha is set to 0, and points you to the exact setting." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Cooldown Icons Vanishing in Mythic+ and Arenas", desc = "Tracked down and fixed a core cause of the cooldown display breaking partway through dungeons, raids and PvP, where icons could disappear until a reload." },
          { title = "Dynamic Cooldowns Groups Loading", desc = "Fixed groups using Dynamic Cooldowns whose icons could stay collapsed or fail to appear until a reload, most noticeably right after importing a profile." },
          { title = "Imported Groups No Longer Scatter", desc = "If an imported profile referenced a group that didn't come through, its icons used to fling across the screen. The missing group is now rebuilt and its icons stay together." },
          { title = "Quick Import Keeps Icons in Their Groups", desc = "Importing a layout from another of your characters on the same spec now keeps each icon in its group, instead of emptying custom groups and dumping their icons into the defaults." },
          { title = "Account-Wide Imports Carry Shared Layouts", desc = "Account-wide (master) imports now bring your shared Group Layouts with them, so a profile linked to a shared layout keeps its groups and their positions." },
          { title = "Totem Tracking Transfers on Import", desc = "The Arc Auras totem-slot toggle now exports and imports, so totems turn on for whoever imports the profile." },
          { title = "Linked Layout Group Positions", desc = "A group's position now loads correctly when re-importing a profile that's linked to a shared Group Layout." },
          { title = "Correct Group Count in Preview", desc = "The import and export preview now shows the real number of groups for a profile linked to a shared layout, instead of undercounting." },
          { title = "Bar Text Alignment", desc = "Left- and right-aligned bar name and duration text now pin their first character to the chosen edge instead of centering on it, so long names read correctly and no longer drift." },
          { title = "Resource Text Color in Instances", desc = "Fixed resource bar value text that could break its threshold coloring inside dungeons, raids and PvP." },
          { title = "Self-Buff Icons Display Correctly", desc = "Cooldown icons, custom labels and glows that track a personal self-buff (like Voidfall) now correctly recognize the buff as active instead of treating it as missing." },
        },
      },
    },
  },
  {
    version = "3.7.4",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Kick Assist", desc = "A built-in interrupt helper in its own tab. Claim your kick raid marker, have it automatically called out to your group on a ready check, and drag ready-made one-press interrupt macros straight onto your bars. Pick which instances it triggers in: Mythic+, Mythic, Heroic, Normal, or Raids. Also available as a separate addon if you want just this without ArcUI." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Smoother Bars", desc = "Bar and resource animations no longer do work every frame. Rune fill updates are throttled and go idle when all runes are ready, lowering background CPU use during play." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Duration Text on Refresh", desc = "Buff and debuff bar countdowns now update correctly when a buff is refreshed, for example Bone Shield, instead of freezing on the old time." },
        },
      },
    },
  },
  {
    version = "3.7.3",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Patch 12.1 Support", desc = "ArcUI is now compatible with patch 12.1. That patch is brand new, so some new errors may show up there that did not happen before; please report anything you run into so it can be fixed quickly." },
          { title = "Share Castbar Across Characters", desc = "Optional setting, off by default, that uses one castbar look on every character, starting from the castbar you already have set up, with each character keeping its own on-screen position unless you also share the position." },
          { title = "Castbar Import and Export", desc = "Share your full castbar setup as a string and load it on another character, or bundle it into your bars export so colors, fonts, per-cast-type profiles, thresholds, and position travel together." },
          { title = "Import a Castbar as a Saved Skin", desc = "When a shared string includes a castbar, the import lets you either replace your live castbar or save the incoming one as a named skin you can apply later." },
          { title = "Hide Blizzard Castbar", desc = "Optional toggle, off by default, that hides the default Blizzard castbar, and turning it back on restores the bar without reloading." },
          { title = "Movable Spell Icon", desc = "Optional setting, off by default, that lets you drag the castbar's spell icon to a custom position while the options panel is open, with a reset button to restore it." },
          { title = "Shorten Long Spell Names", desc = "Optional setting, off by default, that trims spell names longer than a chosen length so they fit on the castbar." },
          { title = "Resource Bar Text Color by Value", desc = "Optional, off by default: resource bar value text can change color based on how full the resource is, with up to four color zones plus a base color and a choice of Fill or Drain direction." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Lighter Casting Updates", desc = "The castbar now listens only for your own casting events, reducing background work during play." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Cooldown Display Stability", desc = "Back-end fixes to make the cooldown display less likely to stop working partway through a dungeon or raid." },
          { title = "Cooldown Group Positioning", desc = "Back-end improvements to cooldown group icon placement, to help reduce icons doubling up, overlapping, or leaving stray empty gaps after talent changes, when opening the options panel, or on login." },
          { title = "Castbar No Longer Lingers After a Failed Cast", desc = "The castbar now correctly clears when a cast is rejected, queued, or fails instead of staying on screen." },
        },
      },
    },
  },
  {
    version = "3.7.2",
    sections = {
      {
        header = "New Features", color = C_NEW, items = {
          { title = "Castbar", desc = "A brand-new player cast bar, with per-cast-type profiles, an optional Auto Share toggle so one cast type's look carries across the others, full support for empowered spells (proper stage segments and timing), and threshold-based color changes. Big thanks to Sadraii, who created the original cast bar module this was expanded from." },
          { title = "Dynamic Cooldowns", desc = "A new per-group option that compacts your cooldown icons the same way Dynamic Auras does: icons drop out and the rest slide together based on whether they're ready or on cooldown. Works hand-in-hand with Dynamic Auras." },
          { title = "Smooth Movement", desc = "When a dynamic group rearranges, icons now glide smoothly into their new spot instead of snapping, with an adjustable speed. Opt-in per group." },
          { title = "Icon Order: First Come, First Served", desc = "Choose how a dynamic group orders its icons: classic Priority order, or First Come First Served, where the icon that became active first keeps its spot and new ones line up after it instead of everything reshuffling." },
          { title = "Custom Icon Stacks: Start Full & Recharge", desc = "Custom timer icons can now show full stacks from the start before the first cast, plus a new \"Timer Complete\" generator with \"Recharge until full\" to build charge-style stack behavior." },
          { title = "What's New Window", desc = "ArcUI now shows a changelog after each update so you always know what changed. Toggle it off in Settings." },
        },
      },
      {
        header = "Improvements", color = C_IMP, items = {
          { title = "Bar Performance", desc = "The buff/debuff/stack bar tracking engine was rebuilt from the ground up for smoother updates and noticeably lower CPU use, especially when tracking lots of auras at once." },
          { title = "Lower CPU Spikes", desc = "Big reductions in the CPU hitch when leaving combat and when players join your party or raid." },
          { title = "Cleaner Custom Icon Options", desc = "The Custom Icons (timer) settings panel now only shows options that actually apply to timers, with the Active / Not Active states behaving correctly and \"Hide at 0\" working properly for stacks." },
          { title = "Totem Dynamic Placement", desc = "Empty totem slots now collapse and compact with Dynamic Auras, keeping your totem icons tidy." },
        },
      },
      {
        header = "Bug Fixes", color = C_FIX, items = {
          { title = "Reverse Swipe While Aura Active", desc = "Fixed the swipe reverting to its normal direction when you left combat while the aura was still active; it now stays reversed for the full duration." },
          { title = "Charge Spell Placement", desc = "Fixed dynamic placement sometimes failing on charge spells, where an icon wouldn't collapse or return as a charge was spent or came back." },
          { title = "Hide CDM Icon Staying Hidden", desc = "Fixed the Blizzard cooldown frame reappearing when a bar had \"Hide CDM Icon\" turned on: after logging in or reloading, on entering or leaving combat, and when opening the options panel. It now stays hidden at all times, including free-floating icons." },
        },
      },
    },
  },
}

-- ===================================================================
-- HELPERS
-- ===================================================================
local function GetCurrentVersion()
  if C_AddOns and C_AddOns.GetAddOnMetadata then
    return C_AddOns.GetAddOnMetadata(ADDON, "Version") or "?"
  elseif GetAddOnMetadata then
    return GetAddOnMetadata(ADDON, "Version") or "?"
  end
  return "?"
end

-- Base version with any minor hotfix suffix stripped: "3.7.2.a" -> "3.7.2".
-- The auto-show tracks the BASE version so a minor hotfix (.a/.b) does NOT re-pop
-- the What's New window for players who already saw the base release. Players who
-- never saw the base release still get it (their lastSeen won't match the base),
-- and a hotfix's notes are merged into the base entry so they see those too.
local function GetBaseVersion()
  return (GetCurrentVersion():gsub("%.%a+$", ""))
end

-- Build the coloured body text for ONE version (its sections + items only). The
-- version number lives on the collapsible header row, not in the body.
local function BuildVersionBody(ver)
  local lines = {}
  for _, section in ipairs(ver.sections or {}) do
    lines[#lines + 1] = string.format("|c%s%s|r", section.color or C_TITLE, section.header or "")
    for _, item in ipairs(section.items or {}) do
      if item.desc and item.desc ~= "" then
        lines[#lines + 1] = string.format("  |c%s>|r |c%s%s|r  |c%s%s|r",
          section.color or C_TITLE, C_TITLE, item.title or "", C_DESC, item.desc)
      else
        lines[#lines + 1] = string.format("  |c%s>|r |c%s%s|r",
          section.color or C_TITLE, C_TITLE, item.title or "")
      end
    end
    lines[#lines + 1] = " "
  end
  return table.concat(lines, "\n")
end

-- ===================================================================
-- WINDOW
-- ===================================================================
local frame

local function BuildFrame()
  if frame then return frame end

  local f = CreateFrame("Frame", "ArcUIChangelogFrame", UIParent, "BackdropTemplate")
  f:SetSize(540, 580)
  f:SetPoint("CENTER")
  -- TOOLTIP, not DIALOG: the options window is FULLSCREEN_DIALOG, so a DIALOG
  -- frame opens BEHIND it when the changelog is launched from the Settings tab
  -- (Raise only reorders within a strata). Same choice the Add popup makes.
  f:SetFrameStrata("TOOLTIP")
  f:SetToplevel(true)
  f:SetClampedToScreen(true)
  f:EnableMouse(true)
  f:SetMovable(true)
  f:RegisterForDrag("LeftButton")
  f:SetScript("OnDragStart", f.StartMoving)
  f:SetScript("OnDragStop", f.StopMovingOrSizing)
  f:SetBackdrop({
    bgFile = "Interface\\Buttons\\WHITE8X8",
    edgeFile = "Interface\\Buttons\\WHITE8X8",
    edgeSize = 1,
  })
  f:SetBackdropColor(0.05, 0.05, 0.07, 0.97)
  f:SetBackdropBorderColor(0, 0.8, 1, 0.55)
  f:Hide()

  -- Accent bar along the top
  local accent = f:CreateTexture(nil, "ARTWORK")
  accent:SetColorTexture(0, 0.8, 1, 0.85)
  accent:SetPoint("TOPLEFT", 1, -1)
  accent:SetPoint("TOPRIGHT", -1, -1)
  accent:SetHeight(3)

  -- Title
  local title = f:CreateFontString(nil, "OVERLAY", "GameFontNormalLarge")
  title:SetPoint("TOPLEFT", 18, -16)
  title:SetText(string.format("|c%sArc UI|r  |cffffffffWhat's New|r", C_BRAND))

  local ver = f:CreateFontString(nil, "OVERLAY", "GameFontNormal")
  ver:SetPoint("TOPRIGHT", -38, -20)
  ver:SetText(string.format("|cff888888v%s|r", GetCurrentVersion()))
  f._versionText = ver

  -- Close (X)
  local x = CreateFrame("Button", nil, f, "UIPanelCloseButton")
  x:SetPoint("TOPRIGHT", 2, 2)
  x:SetScript("OnClick", function() f:Hide() end)

  -- Divider under the title
  local div = f:CreateTexture(nil, "ARTWORK")
  div:SetColorTexture(1, 1, 1, 0.10)
  div:SetPoint("TOPLEFT", 16, -44)
  div:SetPoint("TOPRIGHT", -16, -44)
  div:SetHeight(1)

  -- Scroll body
  local scroll = CreateFrame("ScrollFrame", "ArcUIChangelogScroll", f, "UIPanelScrollFrameTemplate")
  scroll:SetPoint("TOPLEFT", 16, -52)
  scroll:SetPoint("BOTTOMRIGHT", -34, 50)

  local content = CreateFrame("Frame", nil, scroll)
  content:SetSize(470, 10)
  scroll:SetScrollChild(content)
  f._content = content
  f._scroll = scroll

  -- One collapsible block per version: a clickable header row plus the version's
  -- body text. The newest version is expanded by default; older versions start
  -- collapsed and expand when the player clicks their header.
  f._blocks = {}
  for i, verData in ipairs(CL.versions) do
    local block = { ver = verData, expanded = (i == 1) }

    local hdr = CreateFrame("Button", nil, content)
    hdr:SetHeight(22)
    local hbg = hdr:CreateTexture(nil, "BACKGROUND")
    hbg:SetAllPoints()
    hbg:SetColorTexture(1, 1, 1, 0.05)
    hdr._bg = hbg
    local htext = hdr:CreateFontString(nil, "OVERLAY", "GameFontNormal")
    htext:SetPoint("LEFT", 4, 0)
    htext:SetJustifyH("LEFT")
    hdr._text = htext
    hdr:SetScript("OnEnter", function(self) self._bg:SetColorTexture(0, 0.8, 1, 0.13) end)
    hdr:SetScript("OnLeave", function(self) self._bg:SetColorTexture(1, 1, 1, 0.05) end)
    hdr:SetScript("OnClick", function()
      block.expanded = not block.expanded
      if f._Relayout then f._Relayout() end
    end)
    block.header = hdr

    local b = content:CreateFontString(nil, "OVERLAY", "GameFontHighlight")
    b:SetWidth(452)
    b:SetJustifyH("LEFT")
    b:SetJustifyV("TOP")
    b:SetSpacing(4)
    b:SetText(BuildVersionBody(verData))
    block.body = b

    f._blocks[i] = block
  end

  -- Stack the blocks top-to-bottom, showing each body only while its version is
  -- expanded, then size the scroll child to the total height.
  f._Relayout = function()
    local y = 0
    for i, block in ipairs(f._blocks) do
      local arrow = block.expanded and "|cff00ccff-|r" or "|cff888888+|r"
      local tag = (i == 1) and "   |cff4ade80Latest|r" or ""
      block.header._text:SetText(string.format("%s  |cffffd100Version %s|r%s", arrow, block.ver.version, tag))
      block.header:ClearAllPoints()
      block.header:SetPoint("TOPLEFT", content, "TOPLEFT", 0, -y)
      block.header:SetPoint("TOPRIGHT", content, "TOPRIGHT", 0, -y)
      y = y + 24
      if block.expanded then
        block.body:ClearAllPoints()
        block.body:SetPoint("TOPLEFT", content, "TOPLEFT", 10, -y)
        block.body:Show()
        y = y + (block.body:GetStringHeight() or 0) + 10
      else
        block.body:Hide()
      end
    end
    content:SetSize(470, math.max(y, 10))
    if f._scroll then f._scroll:SetVerticalScroll(0) end
  end

  -- Footer divider
  local fdiv = f:CreateTexture(nil, "ARTWORK")
  fdiv:SetColorTexture(1, 1, 1, 0.10)
  fdiv:SetPoint("BOTTOMLEFT", 16, 42)
  fdiv:SetPoint("BOTTOMRIGHT", -16, 42)
  fdiv:SetHeight(1)

  -- "Show on update" checkbox
  local cb = CreateFrame("CheckButton", "ArcUIChangelogCheck", f, "UICheckButtonTemplate")
  cb:SetSize(24, 24)
  cb:SetPoint("BOTTOMLEFT", 14, 12)
  local cbText = _G[cb:GetName() .. "Text"]
  if cbText then cbText:SetText("Show automatically on each update") end
  cb:SetScript("OnClick", function(self)
    local g = ns.API and ns.API.GetGlobalDB and ns.API.GetGlobalDB()
    if g then
      g.changelog = g.changelog or {}
      g.changelog.disabled = not self:GetChecked()
    end
  end)
  f._check = cb

  -- Close button
  local close = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
  close:SetSize(100, 24)
  close:SetPoint("BOTTOMRIGHT", -14, 10)
  close:SetText("Close")
  close:SetScript("OnClick", function() f:Hide() end)

  -- Guided tour launcher: the PRIMARY action on this window, not a footnote
  -- beside Close. The changelog says what changed, the tour shows where, and a
  -- tour nobody notices teaches nobody. Centred, oversized and accented.
  -- Hidden when this version has no tour authored.
  local tour = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
  tour:SetSize(220, 26)
  tour:SetPoint("TOP", f, "TOP", 0, -50)
  tour:SetText("Click for Guided Tour")
  local tfs = tour:GetFontString()
  if tfs then
    tfs:SetTextColor(0.25, 0.79, 0.95)
    local fp, _, fl = tfs:GetFont()
    if fp then tfs:SetFont(fp, 14, fl) end
  end
  tour:SetScript("OnClick", function()
    -- Start carries the walls (no combat, options panel required): only
    -- close this window when the tour actually began, so a refusal (with
    -- its printed reason) leaves the player where they were.
    if ns.Tour and ns.Tour.Start and ns.Tour.Start() then f:Hide() end
  end)
  f._tourBtn = tour

  -- Escape closes it
  if not tContains(UISpecialFrames, "ArcUIChangelogFrame") then
    tinsert(UISpecialFrames, "ArcUIChangelogFrame")
  end

  frame = f
  return f
end

-- Populate + show.
function CL.Show()
  local f = BuildFrame()
  if f._versionText then
    f._versionText:SetText(string.format("|cff888888v%s|r", GetCurrentVersion()))
  end
  -- Open with the newest version expanded and older ones collapsed every time,
  -- so players always land on the latest notes.
  for i, block in ipairs(f._blocks) do block.expanded = (i == 1) end
  f._Relayout()
  -- Reflect the current setting on the checkbox.
  local g = ns.API and ns.API.GetGlobalDB and ns.API.GetGlobalDB()
  local disabled = g and g.changelog and g.changelog.disabled
  if f._check then f._check:SetChecked(not disabled) end
  -- only offer the tour when this version actually has one authored, and give
  -- the button its own band above the notes: the scroll starts lower when it
  -- is there, and reclaims the space when it is not
  if f._tourBtn then
    local has = (ns.Tour and ns.Tour.HasTour and ns.Tour.HasTour()) and true or false
    f._tourBtn:SetShown(has)
    if f._scroll then
      f._scroll:ClearAllPoints()
      f._scroll:SetPoint("TOPLEFT", 16, has and -84 or -52)
      f._scroll:SetPoint("BOTTOMRIGHT", -34, 50)
    end
  end
  f:Show()
  f:Raise()
end

function CL.Hide()
  if frame then frame:Hide() end
end

function CL.Toggle()
  if frame and frame:IsShown() then frame:Hide() else CL.Show() end
end

-- ===================================================================
-- AUTO-SHOW ON UPDATE
-- ===================================================================
local function CheckOnLogin()
  local g = ns.API and ns.API.GetGlobalDB and ns.API.GetGlobalDB()
  if not g then
    -- DB not ready yet (AceDB created at PLAYER_LOGIN) — retry shortly.
    C_Timer.After(2, CheckOnLogin)
    return
  end
  g.changelog = g.changelog or {}
  if g.changelog.disabled then return end

  -- The 3.7.10 notes (and their guided tours) describe 12.1 features. If the
  -- client is still on an older patch, hold the auto-pop and DON'T mark the
  -- version seen — it then pops on the first login after the client is 12.1.
  -- Manual /arccl is unaffected.
  local iface = select(4, GetBuildInfo())
  if type(iface) == "number" and iface < 120100 then return end

  local cur = GetBaseVersion()   -- base version: minor hotfixes (.a/.b) don't re-pop
  if g.changelog.lastSeen ~= cur then
    g.changelog.lastSeen = cur   -- mark seen so it only pops once per base version
    CL.Show()
  end
end

local loginFrame = CreateFrame("Frame")
loginFrame:RegisterEvent("PLAYER_ENTERING_WORLD")
loginFrame:SetScript("OnEvent", function(self)
  -- Fire on the FIRST PLAYER_ENTERING_WORLD (initial login, after the loading
  -- screen has finished) and never again this session — unregister so later
  -- zone/instance loading screens don't re-trigger it.
  self:UnregisterEvent("PLAYER_ENTERING_WORLD")
  -- Small cushion so it lands right after the screen clears, not on its tail.
  C_Timer.After(1, CheckOnLogin)
end)

-- ===================================================================
-- SLASH
-- ===================================================================
SLASH_ARCCHANGELOG1 = "/arcchangelog"
SLASH_ARCCHANGELOG2 = "/arccl"
SlashCmdList["ARCCHANGELOG"] = function(msg)
  msg = (msg or ""):lower():match("^%s*(.-)%s*$")
  if msg == "reset" or msg == "test" then
    -- Forget the "seen" version so the popup auto-shows again on next login/reload.
    local g = ns.API and ns.API.GetGlobalDB and ns.API.GetGlobalDB()
    if g then
      g.changelog = g.changelog or {}
      g.changelog.lastSeen = nil
      g.changelog.disabled = false
    end
    print("|cff00ccffArcUI|r: changelog reset \226\128\148 it'll pop automatically on your next /reload (or run /arccl to open it now).")
  else
    CL.Show()
  end
end