Leaderboard Part 3

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wrdler"
-version = "0.2.0"
+version = "0.2.1"
 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"

wrdler/__init__.py

@@ -9,5 +9,5 @@ Key differences from BattleWords:
 - Daily and weekly leaderboards
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 __all__ = ["models", "generator", "logic", "ui", "word_loader", "leaderboard", "leaderboard_page"]

wrdler/leaderboard.py

@@ -678,13 +678,57 @@ def check_qualification(
     return entry_diff > lowest_diff
 
 
+def get_leaderboard_url(entry_type: EntryType, period_id: str, file_id: str, base_url: str = None) -> str:
+    """
+    Generate a URL to view a specific leaderboard on the leaderboard page.
+    
+    Args:
+        entry_type: "daily" or "weekly"
+        period_id: Date or week identifier
+        file_id: File identifier (e.g., "classic-classic-0")
+        base_url: Optional base URL override
+    
+    Returns:
+        URL to the leaderboard page with appropriate query parameters
+    """
+    from urllib.parse import urlencode
+    
+    # Determine base URL (use current host or default to production)
+    if base_url is None:
+        # Try to get from environment or default to production space
+        import os
+        from wrdler.modules.constants import SPACE_NAME
+        
+        # Check if running locally
+        if os.environ.get("IS_LOCAL", "true").lower() == "true":
+            port = os.environ.get("PORT") or os.environ.get("STREAMLIT_SERVER_PORT") or "8501"
+            host = os.environ.get("HOST") or os.environ.get("STREAMLIT_SERVER_ADDRESS") or "localhost"
+            base_url = f"http://{host}:{port}"
+        else:
+            # Production HuggingFace Space URL
+            space = (SPACE_NAME or "surn/wrdler").lower().replace("/", "-")
+            base_url = f"https://{space}.hf.space"
+    
+    # Build query parameters based on entry type
+    if entry_type == "daily":
+        params = {"page": "daily", "gidd": file_id}
+    elif entry_type == "weekly":
+        params = {"page": "weekly", "gidw": file_id}
+    else:
+        # Fallback to generic page view
+        params = {"page": entry_type}
+    
+    query_string = urlencode(params)
+    return f"{base_url}/?{query_string}"
+
+
 def submit_to_leaderboard(
     entry_type: EntryType,
     period_id: str,
     user_entry: UserEntry,
     settings: GameSettings,
     repo_id: Optional[str] = None
-) -> Tuple[bool, Optional[int]]:
+) -> Tuple[bool, Optional[int], Optional[str]]:
     """
     Submit a user entry to a leaderboard if it qualifies.
 
@@ -696,7 +740,10 @@ def submit_to_leaderboard(
         repo_id: Repository ID
 
     Returns:
-        Tuple of (success, rank) where rank is 1-indexed position or None if didn't qualify
+        Tuple of (success, rank, file_id) where:
+            - success: True if qualified and saved
+            - rank: 1-indexed position or None if didn't qualify
+            - file_id: File identifier for this leaderboard or None if didn't qualify
     """
     if repo_id is None:
         repo_id = HF_REPO_ID
@@ -714,7 +761,7 @@ def submit_to_leaderboard(
 
     if not qualifies:
         logger.info(f"? Score {user_entry.score} did not qualify for top {MAX_DISPLAY_ENTRIES} in {period_id}")
-        return False, None
+        return False, None, None
 
     # Add entry and sort
     leaderboard.users.append(user_entry)
@@ -732,15 +779,15 @@ def submit_to_leaderboard(
         logger.info(f"? Score {user_entry.score} was sorted out of top {MAX_DISPLAY_ENTRIES}")
         # Still save the entry (stored but not displayed)
         save_leaderboard(leaderboard, file_id, repo_id)
-        return False, None
+        return False, None, None
 
     # Save leaderboard
     if save_leaderboard(leaderboard, file_id, repo_id):
-        logger.info(f"? Added to {entry_type} leaderboard at rank {rank}")
-        return True, rank
+        logger.info(f"? Added to {entry_type} leaderboard at rank {rank}, file_id: {file_id}")
+        return True, rank, file_id
     else:
         logger.error(f"? Failed to save leaderboard {period_id}")
-        return False, None
+        return False, None, None
 
 
 def submit_score_to_all_leaderboards(
@@ -771,8 +818,19 @@ def submit_score_to_all_leaderboards(
     Returns:
         Dict with results:
         {
-            "daily": {"qualified": bool, "rank": int|None, "id": str},
-            "weekly": {"qualified": bool, "rank": int|None, "id": str},
+            "daily": {
+                "qualified": bool, 
+                "rank": int|None, 
+                "id": str,
+                "file_id": str|None
+            },
+            "weekly": {
+                "qualified": bool, 
+                "rank": int|None, 
+                "id": str,
+                "file_id": str|None
+            },
+            "leaderboard_url": str|None,  # Combined URL with both gidd and gidw
             "entry_uid": str,
             "settings": {...}
         }
@@ -794,7 +852,7 @@ def submit_score_to_all_leaderboards(
     )
 
     # Submit to daily
-    daily_qualified, daily_rank = submit_to_leaderboard(
+    daily_qualified, daily_rank, daily_file_id = submit_to_leaderboard(
         "daily", daily_id, daily_entry, settings, repo_id
     )
 
@@ -809,13 +867,50 @@ def submit_score_to_all_leaderboards(
     )
 
     # Submit to weekly
-    weekly_qualified, weekly_rank = submit_to_leaderboard(
+    weekly_qualified, weekly_rank, weekly_file_id = submit_to_leaderboard(
         "weekly", weekly_id, weekly_entry, settings, repo_id
     )
 
+    # Build combined leaderboard URL with both gidd and gidw if either qualified
+    leaderboard_url = None
+    if daily_file_id or weekly_file_id:
+        from urllib.parse import urlencode
+        import os
+        from wrdler.modules.constants import SPACE_NAME
+        
+        # Determine base URL
+        if os.environ.get("IS_LOCAL", "true").lower() == "true":
+            port = os.environ.get("PORT") or os.environ.get("STREAMLIT_SERVER_PORT") or "8501"
+            host = os.environ.get("HOST") or os.environ.get("STREAMLIT_SERVER_ADDRESS") or "localhost"
+            base_url = f"http://{host}:{port}"
+        else:
+            space = (SPACE_NAME or "surn/wrdler").lower().replace("/", "-")
+            base_url = f"https://{space}.hf.space"
+        
+        # Build query parameters with both file_ids (when available)
+        params = {}
+        if daily_file_id:
+            params["gidd"] = daily_file_id
+        if weekly_file_id:
+            params["gidw"] = weekly_file_id
+        
+        query_string = urlencode(params)
+        leaderboard_url = f"{base_url}/?{query_string}"
+
     results = {
-        "daily": {"qualified": daily_qualified, "rank": daily_rank, "id": daily_id},
-        "weekly": {"qualified": weekly_qualified, "rank": weekly_rank, "id": weekly_id},
+        "daily": {
+            "qualified": daily_qualified, 
+            "rank": daily_rank, 
+            "id": daily_id,
+            "file_id": daily_file_id
+        },
+        "weekly": {
+            "qualified": weekly_qualified, 
+            "rank": weekly_rank, 
+            "id": weekly_id,
+            "file_id": weekly_file_id
+        },
+        "leaderboard_url": leaderboard_url,
         "entry_uid": daily_entry.uid,
         "settings": settings.to_dict()
     }

wrdler/leaderboard_page.py

@@ -124,41 +124,90 @@ def render_leaderboard_page(default_tab: str = "daily"):
     """Render the full leaderboard page.
     
     Args:
-        default_tab: Which tab to show by default ("daily" or "weekly")
+        default_tab: Which tab to show by default ("today", "daily", "weekly", or "history")
     """
     game_title = APP_SETTINGS.get("game_title", "Wrdler")
     st.title(f"🏆 {game_title} Leaderboards")
 
-    # Inject CSS to style the active tab
+    # Inject CSS for navigation links
     st.markdown(
         """
         <style>
-          /* Target Streamlit tabs: pick the selected tab button/link */
-          div[role="tablist"] p {padding: 0.5em 1em !important;}
-          div[role="tablist"] [aria-selected="true"] {
-            color: #ffffff !important;
-            border: 1px solid #4CAF50 !important;            
+          /* Tab navigation links */
+          .bw-tab-nav {
+            display: flex;
+            gap: 0.5rem;
+            margin-bottom: 1rem;
+            flex-wrap: wrap;
+          }
+          .bw-tab-nav a {
+            padding: 0.5rem 1rem;
+            border-radius: 0.5rem;
+            text-decoration: none;
+            background: rgba(29, 100, 200, 0.3);
+            color: #d7faff;
+            border: 1px solid rgba(215, 250, 255, 0.3);
+            transition: all 0.2s ease;
+          }
+          .bw-tab-nav a:hover {
+            background: rgba(29, 100, 200, 0.6);
+            border-color: rgba(215, 250, 255, 0.6);
+          }
+          .bw-tab-nav a.active {
+            background: rgba(32, 212, 108, 0.3);
+            border-color: rgba(32, 212, 108, 0.5);
+            color: #ffffff;
+            font-weight: bold;
           }
-          div[role="tablist"] [aria-selected="true"] p {font-weight: bold !important;}
         </style>
         """,
         unsafe_allow_html=True
     )
 
-    # Tab selection - set default based on parameter
-    tab_names = ["📅 Daily", "📆 Weekly", "📚 History"]
+    # Check for query parameters to determine which tab content to show
+    try:
+        params = st.query_params if hasattr(st, "query_params") else {}
+    except Exception:
+        params = {}
     
-    # Create tabs
-    tab1, tab2, tab3 = st.tabs(tab_names)
+    page_param = params.get("page", "")
+    gidd = params.get("gidd", None)
+    gidw = params.get("gidw", None)
+    
+    # Determine active tab based on query params
+    # Priority: gidd/gidw -> page param -> default_tab
+    if gidd or gidw:
+        active_tab = "today"
+    elif page_param in ["today", "daily", "weekly", "history"]:
+        active_tab = page_param
+    else:
+        active_tab = default_tab if default_tab in ["today", "daily", "weekly", "history"] else "daily"
 
-    with tab1:
-        _render_daily_tab()
+    # Render custom navigation links (these work as page navigation)
+    st.markdown(
+        f"""
+        <div class="bw-tab-nav">
+            <a href="?page=today" target="_self" class="{'active' if active_tab == 'today' else ''}">🌟 Today</a>
+            <a href="?page=daily" target="_self" class="{'active' if active_tab == 'daily' else ''}">📅 Daily</a>
+            <a href="?page=weekly" target="_self" class="{'active' if active_tab == 'weekly' else ''}">📆 Weekly</a>
+            <a href="?page=history" target="_self" class="{'active' if active_tab == 'history' else ''}">📚 History</a>
+        </div>
+        """,
+        unsafe_allow_html=True
+    )
 
-    with tab2:
+    # Render content based on active tab
+    if active_tab == "today":
+        _render_today_tab()
+    elif active_tab == "daily":
+        _render_daily_tab()
+    elif active_tab == "weekly":
         _render_weekly_tab()
-
-    with tab3:
+    elif active_tab == "history":
         _render_history_tab()
+    else:
+        # Fallback to daily
+        _render_daily_tab()
 
 
 def _render_daily_tab():
@@ -181,7 +230,7 @@ def _render_daily_tab():
         except ValueError:
             date_title = date_id
 
-        # List all settings folders (file_ids) for this period
+        # List all settings folders (file_id) for this period
         settings_list = list_settings_for_period("daily", date_id)
         if not settings_list:
             with st.expander(date_title, expanded=False):
@@ -305,11 +354,129 @@ def _render_history_tab():
             st.info("No weekly leaderboards found.")
 
 
-# Entry point for standalone testing
-if __name__ == "__main__":
-    st.set_page_config(
-        page_title="Wrdler Leaderboards",
-        page_icon="🏆",
-        layout="wide"
-    )
-    render_leaderboard_page()
+def _render_today_tab():
+    """Render today's leaderboards tab - shows current daily and weekly leaderboards.
+    
+    If query string parameters are present:
+    - gidd: Show only the specified daily leaderboard (file_id)
+    - gidw: Show only the specified weekly leaderboard (file_id)
+    
+    Otherwise, show all current daily and weekly leaderboards in two columns.
+    """
+    # Get query parameters
+    try:
+        params = st.query_params if hasattr(st, "query_params") else {}
+    except Exception:
+        params = {}
+    
+    gidd = params.get("gidd", None)
+    gidw = params.get("gidw", None)
+    
+    # If both query params are present, show filtered view
+    if gidd or gidw:
+        st.header("🎯 Today's Leaderboards (Filtered)")
+        
+        # Use two columns for filtered view as well
+        col1, col2 = st.columns(2)
+        
+        # Show daily leaderboard if gidd is specified
+        with col1:
+            if gidd:
+                st.subheader("📅 Daily")
+                daily_id = get_current_daily_id()
+                lb = load_leaderboard("daily", daily_id, gidd)
+                
+                if lb:
+                    try:
+                        date_obj = datetime.strptime(daily_id, "%Y-%m-%d")
+                        date_title = "🌟 Today " + date_obj.strftime("%A, %B %d, %Y")
+                    except ValueError:
+                        date_title = daily_id
+                    
+                    header_suffix = _settings_badge(lb)
+                    with st.expander(f"{date_title} {header_suffix}", expanded=True):
+                        st.caption(f"Settings: mode={lb.game_mode}, source={lb.wordlist_source}, show_incorrect={lb.show_incorrect_guesses}, free_letters={lb.enable_free_letters}, spacer={lb.puzzle_options.get('spacer', 0)}, overlap={lb.puzzle_options.get('may_overlap', False)}")
+                        _render_leaderboard_table(lb, "")
+                else:
+                    st.warning(f"Daily leaderboard not found: {gidd}")
+        
+        # Show weekly leaderboard if gidw is specified
+        with col2:
+            if gidw:
+                st.subheader("📆 Weekly")
+                weekly_id = get_current_weekly_id()
+                lb = load_leaderboard("weekly", weekly_id, gidw)
+                
+                if lb:
+                    try:
+                        year, week = weekly_id.split("-W")
+                        week_title = f"Week {int(week)}, {year}"
+                    except ValueError:
+                        week_title = weekly_id
+                    
+                    header_suffix = _settings_badge(lb)
+                    with st.expander(f"{week_title} {header_suffix}", expanded=True):
+                        st.caption(f"Settings: mode={lb.game_mode}, source={lb.wordlist_source}, show_incorrect={lb.show_incorrect_guesses}, free_letters={lb.enable_free_letters}, spacer={lb.puzzle_options.get('spacer', 0)}, overlap={lb.puzzle_options.get('may_overlap', False)}")
+                        _render_leaderboard_table(lb, "")
+                else:
+                    st.warning(f"Weekly leaderboard not found: {gidw}")
+    else:
+        # Show all current leaderboards (default view) in two columns
+        st.header("🌟 Today's Leaderboards")
+        st.write("Current daily and weekly leaderboards. Resets: Daily at UTC midnight, Weekly on Monday.")
+        
+        col1, col2 = st.columns(2)
+        
+        # Left column: Current Daily Leaderboards
+        with col1:
+            st.subheader("📅 Daily")
+            daily_id = get_current_daily_id()
+            
+            try:
+                date_obj = datetime.strptime(daily_id, "%Y-%m-%d")
+                date_title = "Today " + date_obj.strftime("%A, %B %d, %Y")
+            except ValueError:
+                date_title = daily_id
+            
+            settings_list = list_settings_for_period("daily", daily_id)
+            if not settings_list:
+                st.info("No daily leaderboards found for today.")
+            else:
+                for settings_info in settings_list:
+                    file_id = settings_info["file_id"]
+                    lb = load_leaderboard("daily", daily_id, file_id)
+                    header_suffix = ""
+                    if lb is not None:
+                        header_suffix = _settings_badge(lb)
+                    expander_title = f"{date_title} {header_suffix}" if header_suffix else date_title
+                    with st.expander(expander_title, expanded=True):
+                        if lb is not None:
+                            st.caption(f"Settings: mode={lb.game_mode}, source={lb.wordlist_source}, show_incorrect={lb.show_incorrect_guesses}, free_letters={lb.enable_free_letters}, spacer={lb.puzzle_options.get('spacer', 0)}, overlap={lb.puzzle_options.get('may_overlap', False)}")
+                        _render_leaderboard_table(lb, "")
+        
+        # Right column: Current Weekly Leaderboards
+        with col2:
+            st.subheader("📆 Weekly")
+            weekly_id = get_current_weekly_id()
+            
+            try:
+                year, week = weekly_id.split("-W")
+                week_title = f"Week {int(week)}, {year}"
+            except ValueError:
+                week_title = weekly_id
+            
+            settings_list = list_settings_for_period("weekly", weekly_id)
+            if not settings_list:
+                st.info("No weekly leaderboards found for this week.")
+            else:
+                for settings_info in settings_list:
+                    file_id = settings_info["file_id"]
+                    lb = load_leaderboard("weekly", weekly_id, file_id)
+                    header_suffix = ""
+                    if lb is not None:
+                        header_suffix = _settings_badge(lb)
+                    expander_title = f"{week_title} {header_suffix}" if header_suffix else week_title
+                    with st.expander(expander_title, expanded=True):
+                        if lb is not None:
+                            st.caption(f"Settings: mode={lb.game_mode}, source={lb.wordlist_source}, show_incorrect={lb.show_incorrect_guesses}, free_letters={lb.enable_free_letters}, spacer={lb.puzzle_options.get('spacer', 0)}, overlap={lb.puzzle_options.get('may_overlap', False)}")
+                        _render_leaderboard_table(lb, "")

wrdler/logic.py

@@ -140,6 +140,12 @@ def guess_word(state: GameState, guess_text: str) -> Tuple[bool, int]:
         state.last_action = "You must reveal a cell before guessing."
         return False, 0
     guess = (guess_text or "").strip().upper()
+    
+    # Prevent blank or too-short guesses from being processed
+    # Return silently without setting last_action or affecting can_guess
+    if len(guess) < 4:
+        return False, 0
+    
     if not (len(guess) in (4, 5, 6) and guess.isalpha()):
         state.last_action = "Guess must be A–Z and length 4, 5, or 6."
         state.can_guess = False

wrdler/ui.py

@@ -17,7 +17,7 @@ from datetime import datetime
 from .generator import generate_puzzle, sort_word_file
 from .logic import build_letter_map, reveal_cell, reveal_free_letter, guess_word, is_game_over, compute_tier, auto_mark_completed_words, hidden_word_display
 from .models import Coord, GameState, Puzzle
-from .word_loader import get_wordlist_files, load_word_list, load_word_list_or_ai, compute_word_difficulties
+from .word_loader import get_wordlist_files, load_word_list, load_word_list_or_ai, compute_word_difficulties, get_wordlist_info
 from .version_info import versions_html  # version info footer
 from .audio import (
     _get_music_dir,
@@ -539,6 +539,7 @@ border-radius: 50% !important;
           .st-emotion-cache-1n6tfoc { background: linear-gradient(-45deg, #a1a1a1, #ffffff, #a1a1a1, #666666); gap: 0.1rem !important; color: white; border-radius:15px; padding: 10px 10px 10px 10px; }
           .st-emotion-cache-1n6tfoc::before { content: ''; position: absolute; top: 0; left: 0; right: 0; bottom: 0; border-radius: 10px; margin: 5px;}
           .st-key-guess_input, .st-key-guess_submit { flex-direction: row; display: flex; flex-wrap: wrap; justify-content: flex-start; align-items: flex-end; }
+          .st-key-guess_input [id^="text_input"] {max-width: 80px;}
           .st-emotion-cache-18kf3ut [class^="st-key-free_letter_"] [data-testid="stButton"] > button, button.st-emotion-cache-1ojn1jd {
             aspect-ratio: auto !important;
             position:relative;
@@ -715,7 +716,7 @@ def _init_session() -> None:
     st.session_state.points_by_word = {}
     st.session_state.letter_map = build_letter_map(puzzle)
     st.session_state.initialized = True
-    st.session_state.start_time = datetime.now()  # Set timer on first game
+    st.session_state.start_time = None  # Timer starts on first action (grid click or free letter)
     st.session_state.end_time = None
     # Ensure game_mode is set
     if "game_mode" not in st.session_state:
@@ -737,6 +738,10 @@ def _init_session() -> None:
     if "free_letters_used" not in st.session_state:
         st.session_state.free_letters_used = 0
 
+    # --- Add enable sound effects ---
+    if "enable_sound_effects" not in st.session_state:
+        st.session_state.enable_sound_effects = False
+
 def _new_game() -> None:
     """
     Create a fresh puzzle using CURRENT settings.
@@ -787,7 +792,7 @@ def _new_game() -> None:
     st.session_state.can_guess = False
     st.session_state.points_by_word = {}
     st.session_state.letter_map = build_letter_map(puzzle)
-    st.session_state.start_time = datetime.now()
+    st.session_state.start_time = None  # Timer starts on first action
     st.session_state.end_time = None
     st.session_state.incorrect_guesses = []
     st.session_state.free_letters = set()
@@ -1044,17 +1049,63 @@ def _render_sidebar():
             # Show topic input if AI mode selected
             if selected == "AI Generated":
                 st.session_state.use_ai_wordlist = True
-                st.text_input(
-                    "Topic",
-                    value=st.session_state.ai_topic,
-                    key="ai_topic",
-                    placeholder="e.g., Ocean Life, Space, History",
-                    help="Enter a topic for AI-generated words",
-                    on_change=_on_game_option_change,
+                
+                # Topic input and Generate button in columns
+                topic_col, gen_col = st.columns([3, 1], gap="small")
+                
+                with topic_col:
+                    st.text_input(
+                        "Topic",
+                        value=st.session_state.ai_topic,
+                        key="ai_topic",
+                        placeholder="e.g., Ocean Life, Space, History",
+                        help="Enter a topic for AI-generated words",
+                        # Remove on_change to prevent automatic generation
+                    )
+                
+                with gen_col:
+                    # Add custom CSS for the generate button
+                    st.markdown(
+                        """
+                        <style>
+                        .st-key-ai_generate_btn {
+                            margin-top: 1.85rem;  /* Align with text input */
+                        }
+                        .st-key-ai_generate_btn button {
+                            aspect-ratio: auto !important;
+                            height: auto !important;
+                            padding: 0.5rem 0.75rem !important;
+                        }
+                        </style>
+                        """,
+                        unsafe_allow_html=True,
+                    )
+                    st.button(
+                        "🎲",
+                        key="ai_generate_btn",
+                        help="Generate wordlist from topic",
+                        on_click=_on_ai_generate,
+                        use_container_width=True,
+                    )
+                
+                # Display wordlist info below topic input
+                info_text = get_wordlist_info(
+                    use_ai=True,
+                    ai_topic=st.session_state.ai_topic
                 )
+                if info_text:
+                    st.caption(info_text)
             else:
                 st.session_state.use_ai_wordlist = False
                 st.session_state.selected_wordlist = selected
+                
+                # Display wordlist info below selection
+                info_text = get_wordlist_info(
+                    use_ai=False,
+                    selected_file=selected
+                )
+                if info_text:
+                    st.caption(info_text)
 
             # Only show Sort button for file-based wordlists
             if not st.session_state.use_ai_wordlist:
@@ -1064,14 +1115,52 @@ def _render_sidebar():
             st.info("No word lists found in words/ directory. Using AI or built-in fallback.")
             # Force AI mode if no files available
             st.session_state.use_ai_wordlist = True
-            st.text_input(
-                "Topic",
-                value=st.session_state.ai_topic,
-                key="ai_topic",
-                placeholder="e.g., Ocean Life, Space, History",
-                help="Enter a topic for AI-generated words",
-                on_change=_on_game_option_change,
+            
+            # Topic input and Generate button in columns
+            topic_col, gen_col = st.columns([3, 1], gap="small")
+            
+            with topic_col:
+                st.text_input(
+                    "Topic",
+                    value=st.session_state.ai_topic,
+                    key="ai_topic",
+                    placeholder="e.g., Ocean Life, Space, History",
+                    help="Enter a topic for AI-generated words",
+                    # Remove on_change to prevent automatic generation
+                )
+            
+            with gen_col:
+                # Add custom CSS for the generate button
+                st.markdown(
+                    """
+                    <style>
+                    .st-key-ai_generate_btn {
+                        margin-top: 1.85rem;  /* Align with text input */
+                    }
+                    .st-key-ai_generate_btn button {
+                        aspect-ratio: auto !important;
+                        height: auto !important;
+                        padding: 0.5rem 0.75rem !important;
+                    }
+                    </style>
+                    """,
+                    unsafe_allow_html=True,
+                )
+                st.button(
+                    "🎲",
+                    key="ai_generate_btn",
+                    help="Generate wordlist from topic",
+                    on_click=_on_ai_generate,
+                    use_container_width=True,
+                )
+            
+            # Display wordlist info below topic input
+            info_text = get_wordlist_info(
+                use_ai=True,
+                ai_topic=st.session_state.ai_topic
             )
+            if info_text:
+                st.caption(info_text)
         
         # Add Show Grid ticks option
         if "show_grid_ticks" not in st.session_state:
@@ -1117,9 +1206,9 @@ def _render_sidebar():
         # --- Add sound effects volume ---
         if "effects_volume" not in st.session_state:
             st.session_state.effects_volume = 25
-        # --- Add enable sound effects ---
+        # --- Add enable sound effects (default OFF) ---
         if "enable_sound_effects" not in st.session_state:
-            st.session_state.enable_sound_effects = True
+            st.session_state.enable_sound_effects = False
         st.checkbox("Enable Sound Effects", value=st.session_state.enable_sound_effects, key="enable_sound_effects")
 
         enabled = st.checkbox("Enable music", value=st.session_state.music_enabled, key="music_enabled")
@@ -1185,6 +1274,11 @@ def _render_sidebar():
 
 def _on_free_letter_click(letter: str, state: GameState) -> None:
     """Callback for free letter button clicks."""
+    # Start timer on first action if not already started
+    if st.session_state.get("start_time") is None:
+        st.session_state.start_time = datetime.now()
+        state.start_time = st.session_state.start_time
+    
     # Reveal this free letter
     count = reveal_free_letter(state, st.session_state.letter_map, letter)
     _sync_back(state)
@@ -1366,6 +1460,11 @@ def _render_grid(state: GameState, letter_map, show_grid_ticks: bool = True):
                             clicked = coord
         
     if clicked is not None:
+        # Start timer on first action if not already started
+        if st.session_state.get("start_time") is None:
+            st.session_state.start_time = datetime.now()
+            state.start_time = st.session_state.start_time
+        
         reveal_cell(state, letter_map, clicked)
         # Auto-mark and award base points for any fully revealed words
         if auto_mark_completed_words(state):
@@ -1494,6 +1593,10 @@ def _render_guess_form(state: GameState):
             width: auto !important;
         }
         /* Ensure tooltip content wraps and preserves newlines for vertical stacking */
+        div[data-testid="stTooltipContent"], div[role="tooltip"] {
+            width: auto !important;
+        }
+        /* Ensure tooltip content wraps and preserves newlines for vertical stacking */
         div[data-testid="stTooltipContent"], div[role="tooltip"] {
             white-space: pre-wrap !important;
             text-align: left !important;
@@ -1524,6 +1627,10 @@ def _render_guess_form(state: GameState):
             font-size: 0.8rem;
             cursor: help;
         }
+        .st-key-guess_input .stTooltipIcon .stTooltipHoverTarget:hover::after {
+            font-size: 0.8rem;
+            cursor: help;
+        }
         .st-key-guess_input .stTooltipIcon .stTooltipHoverTarget:hover::after {
             color: #ff9999;
         }
@@ -1562,16 +1669,19 @@ def _render_guess_form(state: GameState):
         #    )
         
         if submitted:
-            correct, _ = guess_word(state, guess_text)
-            _sync_back(state)
-            if correct:
-                play_sound_effect("correct_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
-            else:
-                # Update incorrect guesses list - keep only last 10
-                st.session_state.incorrect_guesses.append(guess_text)
-                st.session_state.incorrect_guesses = st.session_state.incorrect_guesses[-10:]
-                play_sound_effect("incorrect_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
-            st.rerun()
+            # Only process guesses with at least 4 characters (prevent blank/short submissions)
+            if len(guess_text.strip()) >= 4:
+                correct, _ = guess_word(state, guess_text)
+                _sync_back(state)
+                if correct:
+                    play_sound_effect("correct_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
+                else:
+                    # Update incorrect guesses list - keep only last 10
+                    st.session_state.incorrect_guesses.append(guess_text)
+                    st.session_state.incorrect_guesses = st.session_state.incorrect_guesses[-10:]
+                    play_sound_effect("incorrect_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
+                st.rerun()
+            # If guess is too short, silently ignore (no action, no sound, no rerun)
 
 
 # -------------------- Score Panel --------------------
@@ -1615,13 +1725,22 @@ def _render_score_panel(state: GameState):
             )
             rows_html.append(row_html)
 
-    # Initial time shown from server; JS will tick client-side
+    # Timer display logic
     now = datetime.now()
-    start = state.start_time or now
-    end = state.end_time or (now if is_game_over(state) else None)
-    elapsed = (end or now) - start
-    mins, secs = divmod(int(elapsed.total_seconds()), 60)
-    timer_str = f"{mins:02d}:{secs:02d}"
+    
+    # If timer hasn't started yet, show 00:00
+    if state.start_time is None:
+        timer_str = "00:00"
+        start_ms = "null"
+        end_ms = "null"
+    else:
+        start = state.start_time
+        end = state.end_time or (now if is_game_over(state) else None)
+        elapsed = (end or now) - start
+        mins, secs = divmod(int(elapsed.total_seconds()), 60)
+        timer_str = f"{mins:02d}:{secs:02d}"
+        start_ms = int(start.timestamp() * 1000)
+        end_ms = int(end.timestamp() * 1000) if end else "null"
 
     span_id = f"bw-timer-{getattr(state.puzzle, 'uid', 'default')}"
     timer_span_html = f"<span id=\"{span_id}\" style='font-size:1rem; color:#ffffff;'>&nbsp;⏱ {timer_str}</span>"
@@ -1633,10 +1752,6 @@ def _render_score_panel(state: GameState):
     )
     rows_html.append(total_row_html)
 
-    # Build a self-contained HTML document so JS runs inside the component iframe
-    start_ms = int(start.timestamp() * 1000)
-    end_ms = int(end.timestamp() * 1000) if end else None
-
     table_inner = "".join(rows_html)
     html_doc = f"""
     <div class='bw-score-panel-container'>
@@ -1661,7 +1776,13 @@ def _render_score_panel(state: GameState):
             var span = document.getElementById("{span_id}");
             if (!span) return;
             var startMs = {start_ms};
-            var endMs = {"null" if end_ms is None else end_ms};
+            var endMs = {end_ms};
+
+            // If timer hasn't started, keep at 00:00
+            if (startMs === null) {{
+              span.textContent = "⏱ 00:00";
+              return;
+            }}
 
             function fmt(ms) {{
               var total = Math.max(0, Math.floor(ms / 1000));
@@ -1726,7 +1847,7 @@ def _game_over_content(state: GameState) -> None:
     end = state.end_time or datetime.now()
     elapsed = end - start
     elapsed_seconds = int(elapsed.total_seconds())
-    mins, secs = divmod(elapsed_seconds, 60)
+    mins, secs = divmod(int(elapsed.total_seconds()), 60)
     timer_str = f"{mins:02d}:{secs:02d}"
 
     # Compute optional word list difficulty for current run
@@ -1793,7 +1914,7 @@ def _game_over_content(state: GameState) -> None:
            }
            .m-2 {display: flex;flex-direction: row;justify-content: space-evenly;flex-wrap: wrap;font-size: 1.25rem; font-weight: bold;}
            .st-key-new_game_btn_dialog button, .st-key-close_game_over button {
-            height: 50px !important;
+               height: 50px !important;
            }
            .st-key-new_game_btn button {
                transition: none !important;
@@ -1944,23 +2065,24 @@ def _game_over_content(state: GameState) -> None:
                 # If the unified submit fails, try a best-effort weekly submit below
                 results = {"daily": {"qualified": False, "rank": None, "id": None}, "weekly": {"qualified": False, "rank": None, "id": None}}
 
-            # Check weekly result and attempt a fallback single-weekly submission if missing
-            weekly_info = results.get("weekly") or {}
-            if weekly_info.get("id") is None or (weekly_info.get("qualified") is False and weekly_info.get("rank") is None):
-                try:
-                    weekly_id = get_current_weekly_id()
-                    # Build a lightweight UserEntry via submit_to_leaderboard (it returns (success, rank))
-                    submit_to_leaderboard(
-                        "weekly",
-                        weekly_id,
-                        None,  # user_entry will be constructed inside submit_to_leaderboard if used directly; instead construct minimal entry below
-                        settings,
-                    )
-                except Exception:
-                    # swallow fallback errors - main attempt already logged by leaderboard module
-                    pass
+                # Check weekly result and attempt a fallback single-weekly submission if missing
+                weekly_info = results.get("weekly") or {}
+                if weekly_info.get("id") is None or (weekly_info.get("qualified") is False and weekly_info.get("rank") is None):
+                    try:
+                        weekly_id = get_current_weekly_id()
+                        # Build a lightweight UserEntry via submit_to_leaderboard (it returns (success, rank))
+                        submit_to_leaderboard(
+                            "weekly",
+                            weekly_id,
+                            None,  # user_entry will be constructed inside submit_to_leaderboard if used directly; instead construct minimal entry below
+                            settings,
+                        )
+                    except Exception:
+                        # swallow fallback errors - main attempt already logged by leaderboard module
+                        pass        
 
             return results
+            
 
         # Check if share URL already generated
         if "share_url" not in st.session_state or st.session_state.get("share_url") is None:
@@ -2117,17 +2239,42 @@ def _game_over_content(state: GameState) -> None:
             lb_results = st.session_state.get("leaderboard_results", {})
             daily_info = lb_results.get("daily", {})
             weekly_info = lb_results.get("weekly", {})
+            leaderboard_url = lb_results.get("leaderboard_url")
             
+            # Build status message with single combined link
             status_parts = []
             if daily_info.get("qualified"):
-                status_parts.append(f"Daily #{daily_info['rank']}")
+                status_parts.append(f"📅 Daily #{daily_info['rank']}")
             if weekly_info.get("qualified"):
-                status_parts.append(f"Weekly #{weekly_info['rank']}")
+                status_parts.append(f"📆 Weekly #{weekly_info['rank']}")
             
-            if status_parts:
-                st.info(f"🏆 Leaderboard: {', '.join(status_parts)}")
+            if status_parts and leaderboard_url:
+                rankings_text = " • ".join(status_parts)
+                # Ensure the leaderboard URL includes page=today for proper tab navigation
+                # The URL already has gidd/gidw params, just ensure page=today is added
+                if "?" in leaderboard_url:
+                    # Add page=today if not already present
+                    if "page=" not in leaderboard_url:
+                        leaderboard_url += "&page=today"
+                else:
+                    # Should have query params from gidd/gidw, but add page=today as fallback
+                    leaderboard_url += "?page=today"
+                
+                st.markdown(
+                    f"""
+                    <div style="margin-top: 1rem; padding: 1rem; background: rgba(32, 212, 108, 0.1); border-radius: 0.5rem; border: 1px solid rgba(32, 212, 108, 0.3);">
+                        <strong style="color: #20d46c;">🏆 Leaderboard Rankings:</strong><br/>
+                        <a href="{leaderboard_url}" target="_self" style="color: #20d46c; text-decoration: underline; font-size: 1.1rem;">{rankings_text}</a>
+                    </div>
+                    """,
+                    unsafe_allow_html=True
+                )
+            elif status_parts:
+                # Qualified but no URL (shouldn't happen, but handle gracefully)
+                rankings_text = " • ".join(status_parts)
+                st.success(f"🏆 {rankings_text}")
             else:
-                st.info("🏆 Submitted to leaderboards")
+                st.info("🏆 Submitted to leaderboards (not in top 20)")
 
     st.markdown("---")
 
@@ -2236,21 +2383,32 @@ def _on_wordlist_change() -> None:
         # Preserve current AI topic or use default
         if "ai_topic" not in st.session_state:
             st.session_state.ai_topic = "English"
+        # Don't trigger new game automatically for AI mode
+        # User must click Generate button explicitly
     else:
         st.session_state.use_ai_wordlist = False
         st.session_state.selected_wordlist = selected
-    
-    # Trigger new game with updated wordlist
+        # Trigger new game immediately for file-based wordlists
+        _on_game_option_change()
+
+
+def _on_ai_generate() -> None:
+    """
+    Callback when Generate button is clicked for AI wordlist.
+    Triggers new game generation with AI words.
+    """
+    # Start a fresh game with AI-generated words
     _on_game_option_change()
 
 def _render_footer(current_page: str = "play"):
     """Render footer with navigation links to leaderboards and main game.
     
     Args:
-        current_page: Which page is currently active ("play", "daily", "weekly")
+        current_page: Which page is currently active ("play", "today", "daily", "weekly", "history")
     """
     # Determine which link should be highlighted as active
     play_active = "active" if current_page == "play" else ""
+    today_active = "active" if current_page == "today" else ""
     daily_active = "active" if current_page == "daily" else ""
     weekly_active = "active" if current_page == "weekly" else ""
     
@@ -2269,10 +2427,12 @@ def _render_footer(current_page: str = "play"):
     
     # Build URLs with game_id if in challenge mode
     if game_id:
+        today_url = f"?page=today&game_id={game_id}"
         daily_url = f"?page=daily&game_id={game_id}"
         weekly_url = f"?page=weekly&game_id={game_id}"
         play_url = f"?game_id={game_id}"
     else:
+        today_url = "?page=today"
         daily_url = "?page=daily"
         weekly_url = "?page=weekly"
         play_url = "/"
@@ -2294,15 +2454,15 @@ def _render_footer(current_page: str = "play"):
             display: flex;
             justify-content: center;
             align-items: center;
-            gap: 2rem;
+            gap: 1rem;
             flex-wrap: wrap;
         }}
         .bw-footer-nav a {{
             color: #d7faff;
             text-decoration: none;
             font-weight: 600;
-            font-size: 0.9rem;
-            padding: 0.5rem 1rem;
+            font-size: 0.85rem;
+            padding: 0.4rem 0.8rem;
             border-radius: 0.5rem;
             background: rgba(29, 100, 200, 0.3);
             border: 1px solid rgba(215, 250, 255, 0.3);
@@ -2324,18 +2484,19 @@ def _render_footer(current_page: str = "play"):
         }}
         @media (max-width: 640px) {{
             .bw-footer-nav {{
-                gap: 0.75rem;
+                gap: 0.5rem;
             }}
             .bw-footer-nav a {{
-                font-size: 0.8rem;
-                padding: 0.4rem 0.75rem;
+                font-size: 0.75rem;
+                padding: 0.35rem 0.6rem;
             }}
         }}
         </style>
         <div class="bw-footer">
             <nav class="bw-footer-nav">
-                <a href="{daily_url}" title="View Daily Leaderboards" target="_self" class="{daily_active}">📅 Daily Leaderboards</a>
-                <a href="{weekly_url}" title="View Weekly Leaderboards" target="_self" class="{weekly_active}">📆 Weekly Leaderboards</a>
+                <a href="{today_url}" title="View Today's Leaderboards" target="_self" class="{today_active}">🌟 Today</a>
+                <a href="{daily_url}" title="View Daily Leaderboards" target="_self" class="{daily_active}">📅 Daily</a>
+                <a href="{weekly_url}" title="View Weekly Leaderboards" target="_self" class="{weekly_active}">📆 Weekly</a>
                 <a href="{play_url}" title="Play Wrdler" target="_self" class="{play_active}">🎮 Play</a>
             </nav>
         </div>
@@ -2441,4 +2602,4 @@ def run_app():
     state = _to_state()
     if is_game_over(state) and not st.session_state.get("hide_gameover_overlay", False):
         _render_game_over(state)
-    _render_footer(current_page="play")
+    _render_footer(current_page="play")

wrdler/word_loader.py

@@ -447,4 +447,65 @@ def load_word_list_or_ai(
             return load_word_list(selected_file=selected_file)
     else:
         # Standard file-based loading
-        return load_word_list(selected_file=selected_file)
+        return load_word_list(selected_file=selected_file)
+
+def get_wordlist_info(use_ai: bool, ai_topic: str = None, selected_file: str = None) -> str:
+    """
+    Get wordlist information for display in sidebar.
+    
+    Args:
+        use_ai: Whether AI mode is active
+        ai_topic: AI topic (only used if use_ai=True)
+        selected_file: Selected wordlist file (only used if use_ai=False)
+    
+    Returns:
+        Information string about the wordlist (word count and status)
+    """
+    if use_ai and ai_topic:
+        # Check if AI topic file exists
+        safe_topic = re.sub(r'[^\w\s-]', '', ai_topic.lower()).strip()
+        safe_topic = re.sub(r'[-\s]+', '_', safe_topic)
+        filename = f"{safe_topic}.txt"
+        
+        words_dir = os.path.join(os.path.dirname(__file__), "words")
+        filepath = os.path.join(words_dir, filename)
+        
+        if os.path.isfile(filepath):
+            # Count words in the file
+            try:
+                with open(filepath, "r", encoding="utf-8") as f:
+                    count = 0
+                    for line in f:
+                        line = line.strip()
+                        if line and not line.startswith("#"):
+                            # Only count valid A-Z words
+                            if re.fullmatch(r"[A-Z]+", line.upper()):
+                                count += 1
+                return f"📁 Topic file exists: {filename} ({count} words)"
+            except Exception:
+                return f"📁 Topic file exists: {filename}"
+        else:
+            return f"📁 Topic file does not exist yet (will be created on first generation)"
+    
+    elif selected_file:
+        # Count words in selected file
+        words_dir = os.path.join(os.path.dirname(__file__), "words")
+        filepath = os.path.join(words_dir, selected_file)
+        
+        if os.path.isfile(filepath):
+            try:
+                with open(filepath, "r", encoding="utf-8") as f:
+                    count = 0
+                    for line in f:
+                        line = line.strip()
+                        if line and not line.startswith("#"):
+                            # Only count valid A-Z words
+                            if re.fullmatch(r"[A-Z]+", line.upper()):
+                                count += 1
+                return f"📊 {count} words in {selected_file}"
+            except Exception:
+                return f"📊 Wordlist: {selected_file}"
+        else:
+            return f"⚠️ File not found: {selected_file}"
+    
+    return ""

wrdler/word_loader_ai.py

@@ -74,7 +74,7 @@ BASE_PROMPT_TEMPLATE = (
     "- Output ONLY a single comma-separated list (no numbering, no extra text)\n"
     "- Include at least: {WORDS_PER_LENGTH} words of length 4 letters, {WORDS_PER_LENGTH} words of length 5 letters, {WORDS_PER_LENGTH} words of length 6 letters\n"
     "- Use ONLY uppercase A-Z letters (no diacritics, hyphens, or spaces)\n"
-    "- No duplicates. No explanations.\n"
+    "- No duplicates. No explanations. No pluralization or plural form nouns, No third person singular verbs, No past tense verbs \n"
     "List:"
 )