Lifebloom Cue - World of Warcraft Retail 12.0.5
Version 1.4.2

What it does
------------
This addon watches your own Lifebloom on friendly visible units and alerts you when the remaining duration reaches your chosen threshold.

Key terms
---------
Threshold:
The number of seconds left on Lifebloom before the addon warns you.
Example: threshold 4.0 means the alert fires when Lifebloom has 4 seconds or less remaining.

Display time:
How long the visual alert stays on screen before fading away.
Example: display time 2.0 means the text/flash lasts about 2 seconds.

Features
--------
- Sound alert when Lifebloom is close to expiring
- Selectable sounds:
  - Raid Warning
  - Simple Ding
  - Soft Ding
  - Soft Chime
  - Bright Ping
  - Double Ping
  - Clear Ding
  - Gentle Bell
  - Warm Chime
  - Clean Ping
  - Soft Bell
  - Triple Chime
  - Game-Style Ping
  - Map Ping
  - High Ping
  - Low Ping
  - Crystal Ping
  - Bell Ping
  - Two-Tone Ping
  - Clean Chime
  - Mellow Ping
  - Bright Ding
- Optional full-screen flash
- Optional movable alert text, default: "Refresh Lifebloom"
- Text scale slider
- Text X/Y position sliders with 1-pixel steps
- Move Text button to drag the alert text anywhere on screen
- Configurable remaining-duration threshold
- Configurable visual alert duration, default: 2 seconds
- Minimap button using the Lifebloom icon
  - Left-click: enable/disable addon
  - Right-click: open settings
  - Drag: move button around minimap
- Addon compartment support

Fixes in 1.4.0
--------------
- Kept all existing v1.3.0 sounds and added more ping/ding/chime options.
- Added a stricter per-Lifebloom alert latch so the same expiring Lifebloom should not alert again at 2 or 1 seconds after already alerting at your threshold.
- Added a tiny global guard between alert fires to protect against UNIT_AURA and OnUpdate triggering at the same instant.
- The alert now re-arms only when Lifebloom is actually refreshed back above the threshold window, or when the aura disappears and comes back.

Slash commands
--------------
/lbc or /lifebloomcue: open settings
/lbc on
/lbc off
/lbc toggle
/lbc test
/lbc move
/lbc threshold 4
/lbc display 2
/lbc scale 1.2
/lbc sound next
/lbc sound prev
/lbc sound list
/lbc sound simple_ding
/lbc sound clear_ding
/lbc sound gentle_bell
/lbc sound warm_chime
/lbc sound clean_ping
/lbc sound soft_bell
/lbc sound triple_chime
/lbc sound game_ping
/lbc sound map_ping
/lbc sound crystal_ping
/lbc sound two_tone_ping
/lbc sound bright_ding

Install
-------
1. Delete or replace the old LifebloomCue folder.
2. Extract the new LifebloomCue folder into:
   World of Warcraft\_retail_\Interface\AddOns\
3. Restart the game or run /reload.
4. Enable "Lifebloom Cue" from the in-game AddOns list.

Notes
-----
The addon uses C_UnitAuras.GetAuraDataBySpellName when available and only reads friendly unit aura data. It does not use secure buttons, protected actions, spell casting, targeting, rotation logic, or any forbidden automation.

WoW does not provide a clean per-addon volume slider for PlaySoundFile. For this version, the addon-local OGG files were made louder at the file level instead.


Version 1.4.1
- Fixed a Mythic+ combat Lua error caused by using protected/secret UnitGUID values as runtime table keys.
- Unit scanning now deduplicates units through UnitIsUnit and stores alert state only with static unit tokens.
- No sound/settings behavior changed from v1.4.0.


Version 1.4.2
-------------
- Improved duplicate-alert protection.
- Keeps per-unit alert state briefly when an aura scan temporarily misses Lifebloom in combat.
- Adds a global expiration latch so the same Lifebloom expiration cannot play a second sound at 2-1 seconds.
