Murloc Minder

# Murloc Minder Changelog

## 0.2.0 - 2026-03-09

### Highlights
- Introduced a full in-addon `Achievements` experience as the core `0.2.0` feature set.
- Added unlockable murloc `Titles` tied to end-tier achievements and integrated title usage across the full addon UI/activity text.
- Refactored major UI initialization/layout paths to support the expanded achievements/title systems while keeping behavior stable.

### Achievements
- Added a complete Murloc Minder achievement catalog (imported from `Documentation/MurlocMinder_Achievement_Catalog_Feasible_v0.1.10_REFRESHD_20260309-133339.ods` feasible entries) with persistent per-achievement progress and unlock state.
- Added a Blizzard-style achievements tab using official kit assets (`Interface\\AchievementFrame\\...`) while remaining fully self-contained (no WoW achievement API integration).
- Added category and subcategory structure with collapsible/expandable navigation behavior aligned to the official achievements panel style.
- Added `Summary` behavior with:
  - newest-unlocked ordering
  - `Almost Completed` subsection sorted by nearest-to-complete achievements
- Added clamped progress rendering so completed achievements do not overrun visual targets (for example `33/25` now displays as complete state).
- Added per-tier achievement points and persistent total points.
- Added achievement unlock toasts with queue/stack behavior and improved readability/styling.
- Added toast interaction to open Murloc Minder and focus the related achievement entry.
- Added achievement-earned activity log entries using the achievement accent color for consistency.

### Titles
- Added 16 achievement reward titles (end-tier unlocks).
- Added title selection UI to `Customization`:
  - 4x4 title grid
  - locked/unlocked visual state
  - hover tooltip showing source achievement
- Added active-title formatting across addon surfaces:
  - main pet identity display
  - tracker name display
  - activity text name insertion paths
- Preserved no-title behavior (name only) when no title is active.

### UI / UX
- Reworked achievements panel layout/alignment to match Blizzard achievement readability conventions:
  - improved title/icon placement
  - left-nav styling/justification
  - updated scroll behavior/visuals
  - corrected background slicing/alignment issues
- Updated top-tab ordering and spacing to:
  - `Habitat | Store | Achievements | Customization | Information | Dev`
- Updated shell presentation to icon-first display with tooltip summary details and consolidated shell visibility behavior in panel header flows.
- Updated tracker header handling for long titled names:
  - whitespace-safe line wrap behavior
  - dynamic header spacing compensation
  - rarity-color name display parity with main panel
- Enforced new pet-name input cap at 20 characters (including spaces) across naming flows.

### Store / Trinkets
- Added `Abyssal Transmutation Orb` (trinket, `100000` shells):
  - consumes on use
  - rerolls murloc form from the model pool constrained to `Rare+` (`Rare`, `Epic`, `Legendary`, `Rarest`)
  - preserves murloc name and owned inventory/customization progress
- Updated reroll model refresh handling so transmutation applies the newly rolled display model immediately (not rarity text only).

### Audio / Sound Pass
- Added a broad UI sound pass to improve tactile feedback across primary interactions.
- Added distinct sound intents for UI interaction types (`tab`, `toggle`, `apply`, `thud`, `purchase`, `popup_open`, `popup_close`, `error`) and routed handlers accordingly.
- Changed customization background `Apply` to use a non-purchase apply cue (no coin sound), while keeping coin feedback for actual purchases.
- Added/standardized sound hooks for:
  - main frame close button
  - tracker collapse/expand/mode controls
  - top navigation tab changes
  - challenge reroll/reload actions (main panel and tracker)
  - scavenging send/recall action button
  - large Shop button
  - popup open/close/confirm flows

### Refactor / Stability
- Refactored `InitializeUI` and related UI wiring to reduce complexity/local-variable pressure and keep the expanded panel feature set maintainable under Lua 5.1 limits.
- Consolidated achievement rendering/evaluation paths and tied evaluation into tick/activity/economy/challenge/stat update flows.
- Hardened achievement and title persistence logic to survive resets/deletions where intended.

### Data Persistence / Reset Rules
- Updated murloc deletion behavior to:
  - keep shells
  - keep owned customizations/habitats/titles/achievement state
  - reset food/store progression as intended for a fresh pet lifecycle
- Ensured customization application paths continue to work during egg stage when ownership conditions are met.

### Versioning
- Updated addon version metadata/display/telemetry fallback to `0.2.0` (`v0.2.0` in the main panel title).