Ghost_Warbank_Manager

### Changes Since v1.5.8 (v1.5.9 - v2.1.2)

#### New Features

* **Zero-Click Bank Auto-Stash (v2.0.0)**
  * Automatically executes a material and gold sweep when interacting with a Banker or summoning the Warband Bank Convergence.
  * Includes a 0.5-second settle timer and 2.0-second debounce window to prevent duplicated or interrupted execution.
  * Disabled by default; toggleable via the settings panel or slash command (`/gwbm autostash`).

* **BankFrame Quick-Sweep Button (v1.9.0 & v2.0.0)**
  * Added an action button embedded on Blizzard's native BankFrame next to the Close button.
  * Left-Click: Run smart quick sweep.
  * Shift + Left-Click: Deposit all eligible items into the Warbank.
  * Alt + Left-Click: Toggle zero-click auto-stash mode.
  * Right-Click: Open the GWBM settings window.
  * Tooltip: Displays active filters, destination tabs, and gold sweep configuration.

* **Reagent Bag Filtering and Tab Routing (v1.8.0)**
  * Automatic classification for 8 material categories: Herbs, Ore & Stone, Leather & Scales, Cloth, Enchanting, Jewelcrafting & Gems, Cooking & Fish, and Other Reagents.
  * Option to restrict sweeps exclusively to the dedicated Reagent Bag (Bag 5).
  * Category routing matrix allowing specific material types to be routed to designated Warband Bank tabs (Tabs 1-5).

* **Differential Bank Cache Engine (v1.7.0)**
  * Replaced synchronous full-bank scans with an in-memory differential slot matrix.
  * Listens to BAG_UPDATE, BAG_UPDATE_DELAYED, and ITEM_LOCK_CHANGED to eliminate frame hitching across 490-slot Warband Banks.
  * Automatically purges cached bank tab data on bank close to keep the memory footprint below 50 KB.

* **Visual Transfer Progress Bar (v1.6.0)**
  * Embedded status bar displayed in the main window during multi-item transfers.
  * Displays current item name, item count (X / Y), transfer percentage, and a completion banner.

#### Fixes & Improvements

* **Uncached Item Lua Error Fix (v2.1.2)**
  * Resolved "attempt to call a nil value" error in GWBM.lua:635 when transferring items not yet present in the client cache (such as newly introduced expansion items).
  * Replaced calls to deprecated global GetItemInfo with nil-safe C_Item APIs and asynchronous cache pre-fetching.

* **Window Layering & Strata Fix (v2.1.1)**
  * Registered main addon frames with SetToplevel(true) and hooked Raise() calls to eliminate child control bleed-through and layering conflicts with other open windows.

* **Savings Account (WBSA) Floor Calculation (v1.5.9)**
  * Corrected headroom logic in bulk gold deposit sweeps to ensure all valid increments are deposited while strictly preserving the character's configured withdrawal threshold.

#### Slash Commands
* /gwbm sweep (or /gwbm stash) - Run quick sweep manually
* /gwbm autostash [on|off] - Toggle zero-click auto-stash
* /gwbm quickbutton [on|off] - Toggle the BankFrame action button
* /gwbm route - Open the Warband Bank Tab Material Category Routing dialog
* /gwbm resetpos - Reset or center addon windows