Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.5.18 - 2026-03-21

Fixed (2.5.18)

• Fixed remaining missing keybind overlays when exiting DynamicCam mount camera mode directly into combat by retrying button recovery until the buttons become effectively visible again.

Changed (2.5.18)

• Extended delayed combat and bar-state refresh passes to cover longer asynchronous mount-to-combat UI restores.
• Bumped all TOC version metadata to 2.5.18.
• Updated README version highlights for 2.5.18.

2.5.17 - 2026-03-07

Fixed (2.5.17)

• Fixed intermittent missing overlay text after mount/combat transitions (with or without DynamicCam) by hooking action-button OnShow and reapplying overlays when buttons become visible again.

Changed (2.5.17)

• Added per-button visibility recovery logic in modules/Display.lua with queued and delayed update passes after OnShow.
• Bumped all TOC version metadata to 2.5.17.
• Updated README version highlights for 2.5.17.

2.5.16 - 2026-03-07

Fixed (2.5.16)

• Fixed a mount-to-combat refresh gap where overlays could miss some keys after DynamicCam-style UI hiding by triggering bar-state refresh passes on combat and mount display transitions.

Changed (2.5.16)

• Extended modules/Core.lua bar-state event coverage with PLAYER_REGEN_DISABLED, PLAYER_REGEN_ENABLED, and PLAYER_MOUNT_DISPLAY_CHANGED.
• Bumped all TOC version metadata to 2.5.16.
• Updated README version highlights for 2.5.16.

2.5.15 - 2026-03-07

Fixed (2.5.15)

• Fixed overlays not returning automatically after possess/vehicle/override bar transitions by adding robust bar-state refresh handling with delayed passes.

Changed (2.5.15)

• Added a consolidated HandleBarStateChanged refresh path in modules/Core.lua.
• Expanded event coverage for action-bar state swaps (UPDATE_OVERRIDE_ACTIONBAR, UPDATE_VEHICLE_ACTIONBAR, vehicle enter/exit events, and possess-related updates).
• Bumped all TOC version metadata to 2.5.15.
• Updated README version highlights for 2.5.15.

2.5.14 - 2026-03-07

Fixed (2.5.14)

• Reworked overlay frame layering so Dominos/native-style overlays no longer force TOOLTIP strata or extreme frame-level bumps that could cover other addons (e.g., BetterBags).

Changed (2.5.14)

• Added a new Display option: Smart Frame Layering.
• Made Smart Frame Layering opt-in (disabled by default) and treated unset legacy profiles as disabled.
• When Smart Frame Layering is enabled, overlays inherit parent-button strata and use a minimal frame-level offset to stay scoped to action bars.
• Manual strata/frame-level controls are now clearly marked as manual overrides and are disabled while Smart Frame Layering is enabled.
• Bumped all TOC version metadata to 2.5.14.
• Updated README version highlights for 2.5.14.

2.5.13 - 2026-03-07

Added (2.5.13)

• Added provider-registry based integrations for Bartender4 and DiabolicUI, including button discovery and provider-aware diagnostics.
• Added a verify-toc-targets validation step to the GitHub release workflow.

Fixed (2.5.13)

• Fixed a secure/secret string comparison taint error in modules/Display.lua hotkey-region anchor checks by guarding anchor comparisons.
• Fixed provider hotkey-refresh hooks to use each provider's configured update method instead of a Dominos-only path.

Changed (2.5.13)

• Refactored UI detection, button scanning, keybind resolution, and options diagnostics around a shared provider model.
• Updated support messaging and settings visibility rules for provider-specific options.
• Bumped all TOC version metadata to 2.5.13.
• Refreshed README and CurseForge release notes for the provider/taint-fix release.

2.5.12 - 2026-03-02

Fixed (2.5.12)

• Fixed Dominos keybind resolution by preferring the button commandName and explicit Dominos hotkey bindings before generic Blizzard action remaps.
• Hooked Dominos button UpdateHotkeys refreshes so overlays reapply when Dominos rewrites native labels.
• Replaced another taint-prone top-right anchor heuristic in keybind label discovery with a protected-safe point check.

Changed (2.5.12)

• Modernized the in-game options panel with new Status, Compatibility, Support, and Debugging sections and removed stale compatibility claims.
• Narrowed direct support messaging to Blizzard, AzeriteUI, and Dominos, with ElvUI kept as conflict-aware handling only.
• Updated package ignores to exclude development-only templates, tests, and library docs from release archives.
• Updated Retail TOCs to 110107, 110200, 120000, 120001, Mists TOC to 50500, 50501, 50503, and Vanilla TOC to 11508.
• Bumped all TOC version metadata to 2.5.12.
• Refreshed README and CurseForge release notes for the Dominos/options/TOC-target release.

2.5.11 - 2026-03-01

Fixed (2.5.11)

• Added a taint-safe anchor helper in modules/Display.lua hotkey region heuristics.
• Replaced direct GetPoint(1) anchor string comparisons with protected-safe checks to prevent taint compare errors on secure buttons (e.g., ExtraActionButton1).

Changed (2.5.11)

• Bumped all TOC version metadata to 2.5.11.
• Refreshed README and CurseForge release notes for the taint-fix release.

2.5.10 - 2026-02-27

Fixed (2.5.10)

• Corrected the GitHub release workflow PowerShell invocation so tag builds no longer fail on startup.
• Added the missing verify-version.ps1 and verify-changelog.ps1 scripts expected by the release workflow.

Changed (2.5.10)

• Bumped all TOC version metadata to 2.5.10.
• Refreshed README and CurseForge release notes for the packaging hotfix release.

2.5.9 - 2026-02-27

Fixed (2.5.9)

• Restored the Retail and Mainline TOCs to WoW 12 compatibility by setting their interface target to 120000.
• Preserved the explicit CallbackHandler-1.0, LibDataBroker-1.1, and real LibDBIcon-1.0 load order required for packaged builds.

Changed (2.5.9)

• Bumped all TOC version metadata to 2.5.9.
• Refreshed README and CurseForge release notes for the WoW 12 compatibility package.

2.5.8 - 2026-02-27

Fixed (2.5.8)

• Loaded CallbackHandler-1.0 before AceConfig, AceEvent, and LibSharedMedia to stop startup failures in packaged builds.
• Loaded LibDataBroker-1.1 and the real LibDBIcon-1.0 implementation explicitly instead of relying on a later embed entrypoint.
• Restored addon initialization so Config, Options, and Core no longer fault after Ace library startup errors.

Changed (2.5.8)

• Bumped all Retail, Mists, and Vanilla TOC versions to 2.5.8.
• Refreshed release notes in README and CurseForge docs to match the current release contents.

2.5.3 - 2025-09-14

Fixed (2.5.3)

• Locales: Prevent "attempt to index local 'addon' (a nil value)" by decoupling locale files from addon scope and using a shared global table consumed by the addon at init.
• Retail (AzeriteUI): Filter placeholder square/bullet glyphs on unbound buttons; strengthen native hotkey suppression safeguards.

Changed (2.5.3)

• Tooling: Replaced failing lua -p VS Code task with a robust PowerShell-based sweep using luac -p or assert(loadfile(...)) fallback. Set as default build lint task.
• Documentation: README highlights updated for 2.5.3.

2.5.2 - 2025-09-14

Added (2.5.2)

• Options: Font outline styles (NONE/OUTLINE/THICKOUTLINE/MONOCHROME combos) with legacy fallback retained.

Fixed (2.5.2)

• Classic: Avoid registering PLAYER_BINDING_CHANGED; gate the event to Retail only using WOW_PROJECT_ID with build fallback.

Added

• Retail + Classic compatibility in one build; Classic-safe keybinding resolution for ActionButton, BonusActionButton, MultiBars, Stance, Pet, and Possess.
• Hooks to ActionButton_UpdateHotkeys and MultiActionBar_Update to keep native labels hidden while overlays are active.

Changed

• Multiple delayed overlay refreshes after binding changes (Dominos/LibKeyBound) to avoid reload requirements.
• Simplified in-game settings UI by removing unused modules; retained single JUI module.

Fixed

• Dominos keybinding mode no longer causes native hotkey text to reappear until reload on Classic.

2.5.1 - 2025-09-14

Added (2.5.1)

• Deep scan for nested hotkey FontStrings (e.g., AzeriteUI TextOverlayContainer) to ensure reliable detection and suppression.
• New debug commands: /ahos dumphotkey and /ahos dumplayers for targeted troubleshooting.

Changed (2.5.1)

• Overlay frame level bump to render above nested overlay containers and Masque/AzeriteUI skins.
• Refined native hotkey suppression hooks with safer Show/SetText guards.

Fixed (2.5.1)

• Classic: Register PLAYER_BINDING_CHANGED on Retail only to prevent errors on Classic.
• Retail (AzeriteUI): Removed placeholder square/bullet glyphs on unbound buttons by disabling visual fallback on Retail and filtering fallback glyphs in the visual reader.
• Dominos: Improved overlay visibility without requiring reload; ensured native labels stay hidden when Dominos keybinding mode ends.

2.4.2 - 2025-09-03

Fixed (2.4.2)

• Prevent duplicate Blizzard options category registration by stabilizing app name and checking existing entries.
• Avoid hard errors if AceConfigDialog loads late; /ahos always registers.

Added (2.4.2)

• Embedded AceGUI-3.0 and wired AceConfig-3.0 Dialog when embedded libs are present.
• /ahos version command.

Changed (2.4.2)

• Options/About panels now read Version from TOC metadata; removed hardcoded version strings.
• Clarified IconTexture path to media/logo.tga.

2.4.1 - 2025-06-24

Added (2.4.1)

• Debug log window and /ahoslog command for viewing/copying all debug output.
• /ahos inspect <ButtonName> command to print debug info for any action button.
• Advanced profile management: export/import, auto-switch by spec, copy/reset, and print profile tools in the Profiles Management tab.

Changed (2.4.1)

• Updated documentation and versioning for 2.4.1.
• Polished options panel and help sections for new features.

2.4.0 - 2025-06-24

Added (2.4.0)

• In-game changelog and version info tab
• Debug export window and /ahos debugexport command
• LibSerialize/LibDeflate support for profile export
• Help & Debugging tab in options

Changed (2.4.0)

• Updated documentation and versioning for 2.4.0
• Many bugfixes and polish

2.3.0 - 2025-06-23

Modernization & Polish

• Modernized and cleaned up all options panel registration and naming logic
• No more color codes or icons in the options panel or .toc metadata
• Only one options panel is registered, with robust error handling
• Minimap/DataBroker icon and Blizzard options panel now always show the correct, user-friendly name
• ElvUI compatibility and user prompt logic improved
• Legacy and duplicate code removed for reliability
• All overlays and minimap icon logic now robust and error-free

2.2.0 - 2025-06-22

Added (2.2.0)

• Full Ace3 profile management UI (copy, delete, switch, robust handling).
• Overlay settings (font, color, etc.) now update instantly on profile or option changes.
• Lock/unlock feature: /ahos lock greys out all options and prevents changes; attempting to change settings while locked shows a high-strata popup with unlock prompt.
• StaticPopup dialog for unlocking settings, with Yes/No options.
• Debug-only button to delete all profiles except the current one.

Changed (2.2.0)

• Only Ace3 profile management UI is used (custom profile UI removed).
• Improved error handling for profile changes and minimap icon registration.
• Versioning and documentation updated for 2.2.0.

Fixed (2.2.0)

• No more duplicate options panel errors.
• Profile deletion and switching is now robust and bug-free.
• Minimap icon unregister errors resolved.
• Settings lock now actually prevents changes in the options panel.

---

2.1.0 - 2025-06-22

Added (2.1.0)

• Themed enable message with color-coded branding and version.
• Debug messages now only appear when debug mode is enabled.
• Improved overlay removal and Blizzard hotkey text restoration logic.
• Consistent debug/info/error print handling across all modules.

Changed (2.1.0)

• Minimap icon logic and event handling improved for reliability.
• Codebase refactored for maintainability and extensibility.

Fixed (2.1.0)

• Debug messages no longer spam chat in normal mode.
• Overlay and hotkey text restoration now works as expected on disable and minimap toggle.

---

2.0.0-alpha - 2025-06-22

Major Overhaul

• Complete rewrite and modularization of the codebase for maintainability and extensibility.
• Robust event-driven overlay update logic restored and improved.
• ConsolePort-style keybind abbreviation logic: condensed, customizable separator, gamepad/mouse support.
• Overlay frame strata control and improved minimap icon handling.
• Options panel fully revamped: professional About/Credits, version display, and live UI detection.
• All taint, nil, and registration errors eliminated.
• Standardized AceConfig registration and config panel references.
• Added user option for modifier separator in abbreviations.
• Improved debug output and troubleshooting tools.
• Full support for Blizzard, AzeriteUI, and custom action bars.
• Titan Panel integration removed for simplicity; minimap icon is now the sole launcher.

Fixed (2.0.0-alpha)

• Modifier parsing and abbreviation bugs.
• Overlay update and taint issues.
• Nil and registration errors.
• Keybinding detection for all supported UIs.

---

1.0.0 - 2024-06-17

Added (1.0.0)

• Initial release of Advanced Hotkey Overlay System (AHOS).
• Basic overlay system for Blizzard action bars.
• Simple keybind abbreviation logic.
• Minimap icon and options panel access.

---