Add Hall of Legends feature and update to v0.3.2

Introduce Hall of Legends leaderboard for legendary scores (46+), accessible from the footer. Remove Hall of Fantastics. Refactor leaderboard logic to use is_legendary_score utility. Update UI, navigation, documentation, and version numbers to v0.3.2. Includes minor bug fixes and display improvements.

CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE
 
-Wrdler v0.3.1
+Wrdler v0.3.2
 
 # Wrdler - Project Context
 
@@ -12,20 +12,24 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 - **2 free letter guesses at game start** (all instances revealed)
 - **Word composition:** 2 four-letter, 2 five-letter, 2 six-letter words per puzzle
 
-**Current Version:** 0.3.1
-**Last Updated:** 2026-03-10
+**Current Version:** 0.3.2
+**Last Updated:** 2026-04-15
 **Repository:** https://github.com/Oncorporation/Wrdler.git
 **Branch:** main
 
-## Recent Changes (v0.3.1)
+## Recent Changes (v0.3.2)
+- Added Hall of Legends for legendary scores
+
+## v0.3.1
 - Fixed "Your Guess" targeting bug
 - Fixed mobile "incorrect guesses" link
-## Recent Changes (v0.3.0)
+
+## v0.3.0
 - Minor UI and documentation updates
 - Small fixes to footer navigation and game-over dialog layout
 - Synchronized documentation headers and version strings to 0.3.0
 
-## Recent Changes (v0.2.16)
+## v0.2.16
 - Version bump to 0.2.16
 - Documentation and version updates
 - Update documentation versions from .md to .mdx

GAMEPLAY_GUIDE.mdx

@@ -1,8 +1,8 @@
 # Wrdler Gameplay Guide
 
-Version 0.3.1
+Version 0.3.2
 
-**Last Updated:** 2026-03-10
+**Last Updated:** 2026-04-15
 
 ## Welcome to Wrdler!
 
@@ -11,8 +11,8 @@ Wrdler is a simplified vocabulary puzzle game where you discover 6 hidden words
 ---
 
 
-## Recent Changes (v0.3.0)
-See `README.md` for the canonical release notes: [Recent Changes (v0.3.0)](README.md#recent-changes-v030)
+## Recent Changes (v0.3.2)
+See `README.md` for the canonical release notes: [Recent Changes (v0.3.2)](README.md#recent-changes-v032)
 
 ---
 

README.md

@@ -21,7 +21,7 @@ thumbnail: >-
 
 # Wrdler
 
-Version 0.3.1
+Version 0.3.2
 
 Wrdler is a vocabulary puzzle game with daily and weekly leaderboards, 8x6 grid, and two free letter guesses at the start. See CHANGELOG or specs for details on the latest updates.
 
@@ -29,16 +29,16 @@ Wrdler is a vocabulary puzzle game with daily and weekly leaderboards, 8x6 grid,
 
 Wrdler is a vocabulary learning game with a simplified grid and strategic letter guessing. The objective is to discover hidden words on a grid by making smart guesses before all letters are revealed.
 
-**Current Version:** v0.3.1
-**Last Updated:** 2026-03-10
+**Current Version:** v0.3.2
+**Last Updated:** 2026-04-15
 
-## Recent Changes (v0.3.1)
-- Fixed "Your Guess" targeting bug
-- Fixed mobile "incorrect guesses" link
-## Recent Changes (v0.3.0)
-- Comment out graphics modules to improve speed
-- Small fixes to footer navigation and game-over dialog layout
-- Synchronized documentation and spec headers to v0.3.0 (Last Updated 2026-03-04)
+## Recent Changes (v0.3.2)
+A new Hall of Legends feature was added in v0.3.2 to celebrate and preserve outstanding player performances.
+
+- Permanent "Hall of Legends" leaderboard that highlights all-time top scorers across challenges and daily/weekly boards
+- Hall entries include player name, score, date, and settings snapshot; accessible from the footer navigation
+- UI updates to leaderboard pages (icons/badges and compact entry layout) and integration with existing leaderboard submission flow
+- Minor bug fixes and display improvements related to leaderboard sorting and tie-breaker presentation
 
 ## Key Differences from BattleWords
 
@@ -268,7 +268,19 @@ All test files must be placed in the `/tests` folder. This ensures a clean proje
 
 ## Changelog
 
-### v0.2.17 (Current) ✅
+## v0.3.2 (Current) ✅
+- Added Hall of Legends for legendary scores
+- 
+## v0.3.1
+- Fixed "Your Guess" targeting bug
+- Fixed mobile "incorrect guesses" link
+
+## v0.3.0
+- Comment out graphics modules to improve speed
+- Small fixes to footer navigation and game-over dialog layout
+- Synchronized documentation and spec headers to v0.3.0 (Last Updated 2026-03-04)
+
+### v0.2.17 ✅
 - Enhance UI/UX and update documentation
 - Updated README.md and documentation to reflect version bump to 0.2.17 and grid simplification
 - Refactored JavaScript in `ui.py` for improved input focus management with exponential backoff

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wrdler"
-version = "0.3.1"
+version = "0.3.2"
 description = "Wrdler vocabulary puzzle game - simplified version based on BattleWords with 8x6 grid, horizontal words only, no scope, 2 free letter guesses, and a settings-based daily/weekly leaderboard system. Features leaderboard UI, challenge sharing, and AI word lists."
 readme = "README.md"
 requires-python = ">=3.12,<3.13"

specs/leaderboard_spec.mdx

@@ -2,12 +2,12 @@
 
 **Document Version:** 1.4.7
 **Author:** GitHub Copilot
-**Project Version:** 0.3.1
-**Last Updated:** 2026-03-10
+**Project Version:** 0.3.2
+**Last Updated:** 2026-04-15
 **Status:** ✅ Implemented and Documented
 
-## Recent Changes (v0.3.0)
-See `README.md` for the canonical release notes: [Recent Changes (v0.3.0)](../README.md#recent-changes-v030)
+## Recent Changes (v0.3.2)
+See `README.md` for the canonical release notes: [Recent Changes (v0.3.2)](../README.md#recent-changes-v032)
 
 ---
 

specs/requirements.mdx

@@ -1,11 +1,11 @@
 # Wrdler Requirements
 
 **Status:** Production Ready - Leaderboards Implemented
-**Version:** 0.3.1
-**Last Updated:** 2026-03-10
+**Version:** 0.3.2
+**Last Updated:** 2026-04-15
 
-## Recent Changes (v0.2.18)
-See `README.md` for the canonical release notes: [Recent Changes (v0.2.18)](../README.md#recent-changes-v0218)
+## Recent Changes (v0.3.2)
+See `README.md` for the canonical release notes: [Recent Changes (v0.3.2)](../README.md#recent-changes-v032)
 
 This document breaks down the implementation tasks for Wrdler using the game rules described in `specs.md`. Wrdler is a Python/Streamlit project based on BattleWords but with a simplified 8x6 grid, horizontal-only words, and free letter guesses at the start.
 

specs/specs.mdx

@@ -1,12 +1,12 @@
 # Wrdler Specifications
 
-**Version:** 0.3.1
-**Last Updated:** 2026-03-10
+**Version:** 0.3.2
+**Last Updated:** 2026-04-15
 
 **Status:** Production Ready - Leaderboards & Enhanced Settings Page Implemented
 
-## Recent Changes (v0.2.18)
-See `README.md` for the canonical release notes: [Recent Changes (v0.2.18)](../README.md#recent-changes-v0218)
+## Recent Changes (v0.3.2)
+See `README.md` for the canonical release notes: [Recent Changes (v0.3.2)](../README.md#recent-changes-v032)
 
 ## Overview
 Wrdler is a Python/Streamlit vocabulary puzzle game based on BattleWords, but with key differences. The objective is to discover hidden words on a grid by making strategic guesses and using free letter reveals at the game start.

wrdler/__init__.py

@@ -8,8 +8,8 @@ Key differences from BattleWords:
 - 2 free letter guesses at game start
 - Daily and weekly leaderboards
 
-    v0.3.1: Fixed Your Guess targeting bug; fixed mobile "incorrect guesses" link.
+    v0.3.2: Added Hall of Legends for legendary scores.
 """
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 __all__ = ["models", "generator", "logic", "ui", "word_loader", "leaderboard", "leaderboard_page"]

wrdler/game_storage.py

@@ -581,7 +581,7 @@ if __name__ == "__main__":
             score=42,
             time_seconds=180.01,
             game_mode="classic",
-            grid_size=8,  # Wrdler default
+            grid_size=6,  # Wrdler default
             wordlist_source="classic.txt"
         )
         print(f"Challenge ID: {challenge_id}")

wrdler/hall_of_legends.py

@@ -7,29 +7,12 @@ import streamlit as st
 
 from .modules.constants import HF_REPO_ID, HALL_OF_LEGENDS_FILE, APP_SETTINGS, MAX_DISPLAY_ENTRIES
 from .modules.storage import _get_json_from_repo, _upload_json_to_repo
-from .ui_helpers import game_page_url, hall_page_url, fantastic_page_url
+from .ui_helpers import  hall_page_url, is_legendary_score
 
 
 CURRENT_SETTINGS_VERSION = 0
 
 
-def _get_weekly_fantastic_metadata(game_mode: str | None = None) -> tuple[str, str, str, int, str]:
-    current_time = datetime.now(timezone.utc)
-    iso_year, iso_week, _ = current_time.isocalendar()
-    week_id = f"{iso_year}-W{iso_week:02d}"
-    mode = game_mode or st.session_state.get("game_mode", "classic")
-    wordlist_source = st.session_state.get("selected_wordlist", "classic.txt")
-    wordlist_stem = os.path.splitext(os.path.basename(wordlist_source))[0] or "classic"
-    settings_version = CURRENT_SETTINGS_VERSION
-    slug = f"{wordlist_stem}-{mode}-{settings_version}-fantastic"
-    return week_id, mode, wordlist_source, settings_version, slug
-
-
-def _weekly_fantastic_settings_path(game_mode: str | None = None) -> str:
-    week_id, _, _, _, slug = _get_weekly_fantastic_metadata(game_mode)
-    return f"games/leaderboards/weekly/{week_id}/{slug}/settings.json"
-
-
 def _default_hall_document() -> dict[str, Any]:
     game_mode = st.session_state.get("game_mode", "classic")
     wordlist_source = st.session_state.get("selected_wordlist", "classic.txt")
@@ -40,7 +23,9 @@ def _default_hall_document() -> dict[str, Any]:
         "challenge_id": f"hall-of-legends/{game_mode}-{wordlist_stem}-{spacer}",
         "entry_type": "hall",
         "game_mode": game_mode,
-        "grid_size": 12,
+        # Store rectangular grid dimensions explicitly for Wrdler (rows × cols)
+        "grid_rows": int(st.session_state.get("grid_rows", 6)),
+        "grid_cols": int(st.session_state.get("grid_cols", 8)),
         "puzzle_options": {
             "spacer": spacer,
             "may_overlap": False,
@@ -51,7 +36,7 @@ def _default_hall_document() -> dict[str, Any]:
         "show_incorrect_guesses": bool(st.session_state.get("show_incorrect_guesses", True)),
         "enable_free_letters": bool(st.session_state.get("enable_free_letters", False)),
         "wordlist_source": wordlist_source,
-        "game_title": APP_SETTINGS.get("game_title", "Wrdler"),
+        "game_title": "Wrdler",
         "max_display_entries": int(APP_SETTINGS.get("max_display_entries", MAX_DISPLAY_ENTRIES)),
     }
 
@@ -74,57 +59,12 @@ def load_hall_document() -> dict[str, Any]:
     return default_doc
 
 
-def _default_fantastic_document(game_mode: str | None = None) -> dict[str, Any]:
-    week_id, mode, wordlist_source, settings_version, slug = _get_weekly_fantastic_metadata(game_mode)
-    spacer = int(st.session_state.get("spacer", 1))
-
-    return {
-        "challenge_id": f"{week_id}/{slug}",
-        "entry_type": "fantastic",
-        "game_mode": mode,
-        "grid_size": 12,
-        "puzzle_options": {
-            "spacer": spacer,
-            "may_overlap": False,
-        },
-        "users": [],
-        "created_at": datetime.now().astimezone().isoformat(),
-        "version": st.session_state.get("app_version", ""),
-        "show_incorrect_guesses": bool(st.session_state.get("show_incorrect_guesses", True)),
-        "enable_free_letters": bool(st.session_state.get("enable_free_letters", False)),
-        "wordlist_source": wordlist_source,
-        "game_title": APP_SETTINGS.get("game_title", "Battlewords"),
-        "max_display_entries": int(APP_SETTINGS.get("max_display_entries", MAX_DISPLAY_ENTRIES)),
-        "settings_version": settings_version,
-        "leaderboard_scope": "weekly",
-        "week_id": week_id,
-    }
-
-
-def load_fantastic_document(game_mode: str | None = None) -> dict[str, Any]:
-    default_doc = _default_fantastic_document(game_mode)
-    if not HF_REPO_ID:
-        return default_doc
-
-    data = _get_json_from_repo(HF_REPO_ID, _weekly_fantastic_settings_path(game_mode), "dataset")
-
-    if isinstance(data, dict):
-        merged = {**default_doc, **data}
-        if not isinstance(merged.get("users"), list):
-            merged["users"] = []
-        return merged
-
-    if isinstance(data, list):
-        default_doc["users"] = data
-    return default_doc
-
-
 def save_hall_entry(user_entry: dict[str, Any], state: Any) -> tuple[bool, str]:
     if not HF_REPO_ID:
         return False, "HF_REPO_ID is not configured."
 
     score = int(user_entry.get("score", 0))
-    if score < 46:
+    if not is_legendary_score(score):
         return False, "Only Legendary runs (46+) can be saved."
 
     hall_doc = load_hall_document()
@@ -144,7 +84,9 @@ def save_hall_entry(user_entry: dict[str, Any], state: Any) -> tuple[bool, str]:
     hall_doc["challenge_id"] = f"hall-of-legends/{state.game_mode}-{wordlist_stem}-{spacer}"
     hall_doc["entry_type"] = "hall"
     hall_doc["game_mode"] = state.game_mode
-    hall_doc["grid_size"] = int(getattr(state, "grid_rows", getattr(state, "grid_size", 6)) or 6)
+    # Ensure we persist rectangular grid metadata (rows and cols)
+    hall_doc["grid_rows"] = int(getattr(state, "grid_rows", 6) or 6)
+    hall_doc["grid_cols"] = int(getattr(state, "grid_cols", 8) or 8)
     hall_doc["puzzle_options"] = {
         "spacer": spacer,
         "may_overlap": False,
@@ -163,52 +105,6 @@ def save_hall_entry(user_entry: dict[str, Any], state: Any) -> tuple[bool, str]:
     return False, "Unable to save to Hall of Legends."
 
 
-def save_fantastic_entry(user_entry: dict[str, Any], state: Any) -> tuple[bool, str]:
-    if not HF_REPO_ID:
-        return False, "HF_REPO_ID is not configured."
-
-    score = int(user_entry.get("score", 0))
-    if score < 42 or score > 45:
-        return False, "Only Fantastic runs (42-45) can be saved."
-
-    fantastic_doc = load_fantastic_document(state.game_mode)
-    users = fantastic_doc.setdefault("users", [])
-    uid = str(user_entry.get("uid", "")).strip()
-
-    if uid and any(str(u.get("uid", "")) == uid for u in users):
-        return True, "Already saved to Hall of Fantastics."
-
-    users.append(user_entry)
-    users.sort(key=lambda x: (-int(x.get("score", 0)), float(x.get("time", 999999.0))))
-
-    week_id, _, wordlist_source, settings_version, slug = _get_weekly_fantastic_metadata(state.game_mode)
-    spacer = int(st.session_state.get("spacer", 1))
-
-    fantastic_doc["challenge_id"] = f"{week_id}/{slug}"
-    fantastic_doc["entry_type"] = "fantastic"
-    fantastic_doc["game_mode"] = state.game_mode
-    fantastic_doc["grid_size"] = state.grid_size
-    fantastic_doc["puzzle_options"] = {
-        "spacer": spacer,
-        "may_overlap": False,
-    }
-    fantastic_doc["created_at"] = datetime.now().astimezone().isoformat()
-    fantastic_doc["version"] = st.session_state.get("app_version", "")
-    fantastic_doc["show_incorrect_guesses"] = bool(st.session_state.get("show_incorrect_guesses", True))
-    fantastic_doc["enable_free_letters"] = bool(st.session_state.get("enable_free_letters", False))
-    fantastic_doc["wordlist_source"] = wordlist_source
-    fantastic_doc["game_title"] = APP_SETTINGS.get("game_title", "Battlewords")
-    fantastic_doc["max_display_entries"] = int(APP_SETTINGS.get("max_display_entries", MAX_DISPLAY_ENTRIES))
-    fantastic_doc["settings_version"] = settings_version
-    fantastic_doc["leaderboard_scope"] = "weekly"
-    fantastic_doc["week_id"] = week_id
-
-    ok = _upload_json_to_repo(fantastic_doc, HF_REPO_ID, _weekly_fantastic_settings_path(state.game_mode), "dataset")
-    if ok:
-        return True, "Saved to Hall of Fantastics."
-    return False, "Unable to save to Hall of Fantastics."
-
-
 def render_hall_page() -> None:
     # Epic hero header
     st.markdown(
@@ -243,7 +139,7 @@ def render_hall_page() -> None:
         """,
         unsafe_allow_html=True,
     )
-    st.markdown(f"<div style='text-align:center; margin-top:0.75rem;'><a href=\"{fantastic_page_url()}\" target=\"_self\">View Hall of Fantastics</a></div>", unsafe_allow_html=True)
+   
 
     hall_doc = load_hall_document()
     users = hall_doc.get("users", []) if isinstance(hall_doc, dict) else []
@@ -255,7 +151,7 @@ def render_hall_page() -> None:
     total = len(unique_names)
     if total == 0:
         st.info("No Hall of Legends entries yet. Be the first to etch your name into legend!")
-        st.markdown(f"<a href=\"{game_page_url()}\" target=\"_self\">Return to game</a>", unsafe_allow_html=True)
+        st.markdown("<a href='/' target='_self'>Return to game</a>", unsafe_allow_html=True)
         return
 
     # Summary/top-stats
@@ -321,100 +217,5 @@ def render_hall_page() -> None:
     """
 
     st.markdown(table_html, unsafe_allow_html=True)
-    st.markdown(f"<a class=\"bw-return\" href=\"{game_page_url()}\" target=\"_self\">⟵ Return to game</a>", unsafe_allow_html=True)
-
-
-def render_fantastic_page() -> None:
-    week_id, _, _, _, _ = _get_weekly_fantastic_metadata()
-    st.markdown(
-        f"""
-        <style>
-        .bw-hall-hero {{
-            background: linear-gradient(90deg,#5b21b6 0%, #7c3aed 50%, #2563eb 100%);
-            color: #fff;
-            padding: 1.25rem;
-            border-radius: 1rem;
-            box-shadow: 0 12px 40px rgba(37,99,235,0.4);
-            text-align: center;
-            margin-bottom: 1rem;
-        }}
-        .bw-hall-hero h1 {{ margin: 0; font-size: 2.1rem; letter-spacing: 1px; }}
-        .bw-hall-hero p {{ margin: 0.25rem 0 0; opacity: 0.92; }}
-        .bw-top-cards {{ display:flex; gap:12px; margin-top:1rem; justify-content:center; flex-wrap:wrap; }}
-        .bw-card {{ background: rgba(255,255,255,0.05); padding: 0.75rem 1rem; border-radius: 0.75rem; min-width: 180px; text-align:center; box-shadow: 0 6px 18px rgba(37,99,235,0.28); }}
-        .bw-card h3 {{ margin:0; font-size:1.1rem; }}
-        .bw-card p {{ margin:0.25rem 0 0; font-size:0.95rem; color:#e9ddff; }}
-        .bw-table {{ width:100%; border-collapse:collapse; margin-top:1rem; }}
-        .bw-table th, .bw-table td {{ padding:8px 10px; border-bottom:1px solid rgba(255,255,255,0.08); }}
-        .bw-table th {{ text-align:left; background: rgba(255,255,255,0.03); }}
-        .bw-top-row {{ background: linear-gradient(90deg,#facc1540,#60a5fa40); }}
-        .bw-return {{ display:block; text-align:center; margin-top:1rem; }}
-        </style>
-        <div class="bw-hall-hero">
-          <div style="font-size:2.4rem;">✨ HALL OF FANTASTICS</div>
-          <h1>Fantastic Players • Weekly Honors</h1>
-          <p>Runs scoring 42-45 are celebrated here for the current week: <strong>{week_id}</strong>.</p>
-        </div>
-        """,
-        unsafe_allow_html=True,
-    )
-
-    fantastic_doc = load_fantastic_document()
-    users = fantastic_doc.get("users", []) if isinstance(fantastic_doc, dict) else []
-    entries = [u for u in users if 42 <= int(u.get("score", 0)) <= 45]
-    entries.sort(key=lambda x: (-int(x.get("score", 0)), float(x.get("time", 999999.0))))
-
-    unique_names = {(str(u.get("username", "Anonymous") or "Anonymous").strip().lower()) for u in entries}
-    total = len(unique_names)
-    if total == 0:
-        st.info("No Hall of Fantastics entries yet for this week. Claim the first Fantastic finish!")
-        st.markdown(f"<div style='text-align:center; margin-top:0.75rem;'><a href=\"{hall_page_url()}\" target=\"_self\">View Hall of Legends</a></div>", unsafe_allow_html=True)
-        st.markdown(f"<a href=\"{game_page_url()}\" target=\"_self\">Return to game</a>", unsafe_allow_html=True)
-        return
-
-    best = entries[0]
-    best_score = int(best.get("score", 0))
-    best_player = best.get("username", "Anonymous")
-    best_time = float(best.get("time", 0.0))
-    wordlist_name = fantastic_doc.get("wordlist_source", "")
+    st.markdown("<a class='bw-return' href='/' target='_self'>⟵ Return to game</a>", unsafe_allow_html=True)
 
-    st.markdown(
-        f"""
-        <div class="bw-top-cards">
-          <div class="bw-card"><h3>🌟 Top Fantastic</h3><p><strong>{best_score}</strong> pts by <strong>{best_player}</strong></p></div>
-          <div class="bw-card"><h3>⚡ Fastest Fantastic</h3><p><strong>{best_time:.3f}s</strong></p></div>
-          <div class="bw-card"><h3>🗓️ Current Week</h3><p><strong>{week_id}</strong></p></div>
-          <div class="bw-card"><h3>🎯 Wordlist</h3><p><strong>{wordlist_name}</strong></p></div>
-          <div class="bw-card"><h3>🙌 Total Fantastics</h3><p><strong>{total}</strong> saved runs</p></div>
-        </div>
-        """,
-        unsafe_allow_html=True,
-    )
-    st.markdown(f"<div style='text-align:center; margin-top:0.75rem;'><a href=\"{hall_page_url()}\" target=\"_self\">View Hall of Legends</a></div>", unsafe_allow_html=True)
-
-    display_limit = min(int(fantastic_doc.get("max_display_entries", APP_SETTINGS.get("max_display_entries", MAX_DISPLAY_ENTRIES))), MAX_DISPLAY_ENTRIES)
-    rows_html = []
-    for idx, entry in enumerate(entries[:display_limit], 1):
-        score = int(entry.get("score", 0))
-        player = entry.get("username", "Anonymous")
-        tier = entry.get("tier", "Fantastic")
-        saved = entry.get("timestamp", "")
-        tr_class = "bw-top-row" if idx <= 3 else ""
-        medal = "🥇" if idx == 1 else ("🥈" if idx == 2 else ("🥉" if idx == 3 else "✨"))
-        rows_html.append(f"<tr class=\"{tr_class}\"><td style='width:64px'>{medal} {idx}</td><td><strong>{player}</strong></td><td>{score}</td><td>{tier}</td><td>{wordlist_name}</td><td style='white-space:nowrap'>{saved}</td></tr>")
-
-    table_html = f"""
-    <div style="overflow:auto; max-height:520px;">
-    <table class="bw-table shiny-border">
-      <thead>
-        <tr><th>Rank</th><th>Player</th><th>Score</th><th>Tier</th><th>Wordlist</th><th>Saved</th></tr>
-      </thead>
-      <tbody>
-        {''.join(rows_html)}
-      </tbody>
-    </table>
-    </div>
-    """
-
-    st.markdown(table_html, unsafe_allow_html=True)
-    st.markdown(f"<a class=\"bw-return\" href=\"{game_page_url()}\" target=\"_self\">⟵ Return to game</a>", unsafe_allow_html=True)

wrdler/ui.py

@@ -44,6 +44,7 @@ from .ui_helpers import (
     show_spinner,
     get_effective_game_title,
     custom_rising_text,
+    is_legendary_score,
 )
 
 # --- Spinner context manager for custom spinner ---
@@ -1245,7 +1246,7 @@ def _game_over_content(state: GameState) -> None:
     else:
         _mount_background_audio(False, None, 0.0)
 
-    if state.score >= 46:
+    if is_legendary_score(state.score):
         custom_rising_text(["LEGENDARY!", "🏛️ HALL OF LEGENDS"], font_size=[34, 28], upward_speed=[4, 5], animation_length=4, color=["#ffd54d", "#ffffff"])
 
     # Set end_time if not already set
@@ -1500,7 +1501,7 @@ def _game_over_content(state: GameState) -> None:
             return results
 
         def _save_legendary_hall_entry(username: str, score: int, time_secs: float, word_list: list, leaderboard_results: dict, challenge_id: str = None) -> None:
-            if score < 46 or st.session_state.get("hall_of_legends_saved", False):
+            if not is_legendary_score(score) or st.session_state.get("hall_of_legends_saved", False):
                 return
 
             daily_info = (leaderboard_results or {}).get("daily", {})
@@ -1720,15 +1721,23 @@ def _game_over_content(state: GameState) -> None:
 
                 if daily_info.get("qualified"):
                     daily_rankings_text = f"<a href='{daily_leaderboard_url}' target='_self' style='color: #20d46c; text-decoration: underline; font-size: 1.2rem; filter: drop-shadow(1px 1px 1px #003);'>{daily_rankings_text}</a>"
-                                
+
                 if weekly_info.get("qualified"):
                     weekly_ranking_text = f"<a href='{weekly_leaderboard_url}' target='_self' style='color: #20d46c; text-decoration: underline; font-size: 1.2rem; filter: drop-shadow(1px 1px 1px #003);'>{weekly_ranking_text}</a>"
+
+                # If weekly qualified AND this run is Legendary, offer quick link to Hall of Legends
+                hall_link_html = ""
+                try:
+                    if weekly_info.get("qualified") and is_legendary_score(state.score):
+                        hall_link_html = f"<div style='margin-top:0.5rem;'><a href='/?page=hall' target='_self' style='color: #ffd54d; text-decoration: underline; font-size: 1.1rem;'>🏛️ Hall of Legends</a></div>"
+                except Exception:
+                    hall_link_html = ""
                 
                 st.markdown(
                     f"""
                     <div style="margin-top: 1rem; padding: 1rem; background: rgba(32, 212, 108, 0.1); text-align:center; border-radius: 0.5rem; border: 1px solid rgba(32, 212, 108, 0.3);">
                         <strong style="color: #20d46c; filter: drop-shadow(1px 1px 1px #003);">🏆 Leaderboard Rankings:</strong><br/>
-                        {daily_rankings_text} {weekly_ranking_text}                        
+                        {daily_rankings_text} {weekly_ranking_text} {hall_link_html}                        
                     </div>
                     """,
                     unsafe_allow_html=True

wrdler/ui_helpers.py

@@ -80,6 +80,14 @@ def custom_rising_text(
     )
     st.html(html, unsafe_allow_javascript=True)
 
+
+def is_legendary_score(score: int | float | str) -> bool:
+    """Return True when a score qualifies for Hall of Legends."""
+    try:
+        return int(score) >= 46
+    except Exception:
+        return False
+
 # --- Utility: Convert Matplotlib Figure to PIL RGBA Image ---
 def fig_to_pil_rgba(fig):
     """
@@ -118,6 +126,12 @@ def get_effective_game_title() -> str:
     # Fall back to APP_SETTINGS
     return APP_SETTINGS.get("game_title", "Wrdler")
 
+def hall_page_url() -> str:
+    return "?page=hall"
+
+
+def game_page_url() -> str:
+    return "?page=play&overlay=0"
 
 # --- PWA Service Worker JS (for Streamlit head injection) ---
 pwa_service_worker = """
@@ -630,6 +644,7 @@ def _render_footer(current_page: str = "play"):
     # Determine which link should be highlighted as active
     play_active = "active" if current_page == "play" else ""
     leaderboard_active = "active" if current_page in {"today", "daily", "weekly", "history"} else ""
+    hall_active = "active" if current_page == "hall" else ""
     settings_active = "active" if current_page == "settings" else ""
     game_title = get_effective_game_title()
     game_version = f"{game_title.lower()}-v{version.replace('.', '-')}"
@@ -651,11 +666,13 @@ def _render_footer(current_page: str = "play"):
     if game_id:
         today_url = f"?page=today&game_id={game_id}#wrdler-leaderboards"
         leaderboard_url = f"?page=today&game_id={game_id}#wrdler-leaderboards"
+        hall_url = "?page=hall"
         play_url = f"?game_id={game_id}#{game_version}"
         settings_url = f"?page=settings&game_id={game_id}#settings"
     else:
         today_url = "?page=today#wrdler-leaderboards"
         leaderboard_url = "?page=today#wrdler-leaderboards"
+        hall_url = "?page=hall"
         play_url = f"/#{game_version}"
         settings_url = "?page=settings#settings"
     
@@ -717,6 +734,7 @@ def _render_footer(current_page: str = "play"):
     <div class="bw-footer">
         <nav class="bw-footer-nav">
             <a href="{leaderboard_url if not leaderboard_active else '#wrdler-leaderboards'}" title="View Leaderboards" target="_self" class="{leaderboard_active}">🏆 Leaderboard</a>
+            <a href="{hall_url if not hall_active else '#wrdler-hall'}" title="View Hall of Legends" target="_self" class="{hall_active}">🏛️ Hall</a>
             <a href="{play_url if not play_active else f'#{game_version}'}" title="Play Wrdler" target="_self" class="{play_active}">🎮 Play</a>
             <a href="{settings_url if not settings_active else '#settings'}" title="Settings" target="_self" class="{settings_active}">⚙️ Settings</a>
         </nav>