Vince's Guild Bank Sorter

================================================================================
                         VincesGuildBankSorter (VGBS)
================================================================================

An automated, ultra-clean sorting and stacking utility designed specifically for  the World of Warcraft Guild Bank interface. 

VincesGuildBankSorter handles the heavy lifting of inventory management by combining  fragmented item stacks and beautifully arranging your vault tabs into logical, scannable categories. Note: To ensure total  ccuracy and control, the sort is performed dynamically on a single tab per execution.

--------------------------------------------------------------------------------
FEATURES
--------------------------------------------------------------------------------

• Single-Tab Execution: Focuses its engine safely on the single active tab currently open, leaving your other vault tabs completely untouched.
• Dual-Engine Execution: Automatically combines matching partial stacks before running a comprehensive grid layout sort.
• Smart Grouping: Prioritizes item types, ensuring weapons and armor/gear are grouped seamlessly together, followed by cosmetic groupings and item levels.
• Seamless UI Integration: Injects a custom, lightweight "Sort Tab" button directly into the upper title region of the native Blizzard Guild Bank window.
• Anti-Disconnect Throttle: Operates on a safe, built-in engine tick delay to prevent server-side inventory disconnects during massive organization passes.
• UI Blocker Safety: Protects your bank items by pausing manual mouse interaction momentarily while an automated sort pass is actively executing.

--------------------------------------------------------------------------------
HOW TO USE
--------------------------------------------------------------------------------

• AUTOMATIC: Open your Guild Bank frame, select the specific tab you want to organize, and click the green [Sort Tab] button located near the top-left title area.
• MANUAL SLASH COMMANDS:
    /vgsort   - Triggers the full, master unified stack-and-sort engine pass.
    /vgstack  - Runs a standalone pass that only condenses duplicate item stacks.
    /vgreset  - Emergency master system clear (wipes the queue if a tab is shut).

--------------------------------------------------------------------------------
NOTES & SAFETY RULES
--------------------------------------------------------------------------------

• To prevent data corruption, the engine will immediately abort execution if you manually change vault tabs or abruptly close the bank window mid-process.
• If item descriptions haven't fully synced from the server cache yet, the addon will briefly pause to fetch data securely before sorting to guarantee perfect layout accuracy.

================================================================================