Feature: GUI Overhaul - Navigation, Search, Sharing, Rename

[derrickmehaffy]

Scope

Comprehensive overhaul of the HyperHomes GUI to improve navigation, add player search functionality (including offline players), enable direct home sharing from the GUI, and add the ability to rename homes.

Implementation Details

Back Navigation:

• Add back buttons to all sub-pages (HomeDetailPage, ShareManagePage, ShareConfirmPage, etc.)
• Maintain navigation stack so back returns to the correct previous page
• Use consistent back button placement (top-left corner)

Player Search (Including Offline):

• Add a search/filter input to the Homes List page to filter homes by name
• Add player search functionality for sharing — search by username including offline players
• Use server's player data lookup for offline player resolution (UUID lookup by name)
• Show search results with player names and online/offline status indicators

Direct Home Sharing:

• Add a "Share" button on the Home Detail page
• Open a share dialog that allows searching for players and sending share invitations
• Show current share recipients with ability to revoke access
• Integrate with existing PendingShareManager

Home Renaming:

• Add a "Rename" button on the Home Detail page
• Open a text input dialog for the new name
• Validate name against existing naming rules (alphanumeric, 1-32 chars)
• Update storage and refresh GUI after rename

Risks and Alternatives

• Risk: Offline player search may be slow if scanning all player data files. Consider caching known player names.
• Risk: Navigation stack management adds complexity. Keep it simple — only track one level back.
• Alternative: For renaming, could require using the /homes rename command instead of GUI. But in-GUI is more user-friendly.
• Alternative: For sharing, could use a chat-based flow instead of GUI search. But GUI search is more discoverable.

References and Media

• Current GUI pages: HomesListPage, HomeDetailPage, SharedHomesPage, ShareManagePage, ShareConfirmPage
• HyperFactions admin GUI navigation pattern (back buttons between sub-pages)
• CustomUI patterns: Dynamic List Pattern, Search/Filter Pattern, Form Input Patterns

Confirmation

• I have searched existing issues to ensure this is not a duplicate
• I have considered the scope and impact of this feature