Delete ui/old--renderers.py

ui/old--renderers.py

@@ -1,686 +0,0 @@
-"""Markdown renderers for the Myco Gradio interface."""
-
-from html import escape
-from game.progression import (
-    AREA_UNLOCKS, current_area, next_area, next_mystery,
-    revealed_mysteries, unlocked_areas,
-)
-from game.state import CollectionState, EMPTY_DEX, MushroomState
-from models.mushroom import Mushroom
-
-import json
-import ast
-
-POISONOUS_MUSHROOM_NAMES = {
-    "Ghost Gill", "Pepper Pixie", "Ruby Knuckle", "Clockwork Chanterelle",
-}
-
-SCENE_STYLES = """
-<style>
-.forest-scene {
-    position: relative; isolation: isolate;
-    overflow: hidden; min-height: 20rem;
-    padding: 0.75rem; border-radius: 28px;
-    background:
-        radial-gradient(circle at 50% 72%, rgba(255,239,173,.26), transparent 8rem),
-        radial-gradient(circle at 18% 24%, rgba(134,225,153,.22), transparent 10rem),
-        linear-gradient(180deg,#123626 0%,#245c3c 54%,#523b20 100%);
-    border: 1px solid rgba(225,255,209,.25);
-    box-shadow: 0 18px 48px rgba(8,30,20,.26);
-    color: #f9ffe9;
-}
-.scene-hud {
-    position: relative; z-index: 3;
-    display: flex; flex-wrap: wrap; gap: .4rem;
-    padding: .5rem .75rem; border-radius: 999px;
-    background: rgba(13,38,28,.72); backdrop-filter: blur(6px);
-    font-size: .8rem; font-weight: 800;
-}
-.scene-stage {
-    position: relative; height: 13rem;
-    margin: .6rem 0;
-    background:
-        linear-gradient(transparent 62%, rgba(106,79,33,.55) 63%),
-        radial-gradient(ellipse at bottom, rgba(190,255,180,.2), transparent 60%);
-    border-radius: 22px; overflow: hidden;
-}
-.scene-stage span { position: absolute; line-height:1; }
-.tree-left  { left:6%;  bottom:18%; font-size:5rem;   filter:drop-shadow(0 8px 12px rgba(0,0,0,.28)); }
-.tree-right { right:7%; bottom:20%; font-size:4.75rem; filter:drop-shadow(0 8px 12px rgba(0,0,0,.28)); }
-.grass-one  { left:26%; bottom:14%; font-size:2.4rem; }
-.grass-two  { right:28%;bottom:16%; font-size:2.2rem; }
-.sparkle-one { left:34%;  top:18%; font-size:1.8rem; animation:twinkle 1.8s ease-in-out infinite; }
-.sparkle-two { right:33%; top:24%; font-size:1.6rem; animation:twinkle 2.2s ease-in-out infinite reverse; }
-@keyframes twinkle {
-    0%,100%{opacity:.3;transform:scale(.85);}
-    50%{opacity:1;transform:scale(1.18);}
-}
-.myco-player {
-    font-size:4rem; z-index:2;
-    transition: left .32s cubic-bezier(.34,1.56,.64,1), bottom .32s cubic-bezier(.34,1.56,.64,1);
-    animation: myco-bob 2.4s ease-in-out infinite;
-    filter:drop-shadow(0 6px 14px rgba(255,92,92,.28));
-}
-@keyframes myco-bob {
-    0%,100%{transform:translateY(0);}
-    50%{transform:translateY(-.45rem);}
-}
-.pos-0-0 .myco-player{left:14%;bottom:62%;}
-.pos-1-0 .myco-player{left:41%;bottom:62%;}
-.pos-2-0 .myco-player{left:67%;bottom:62%;}
-.pos-0-1 .myco-player{left:14%;bottom:36%;}
-.pos-1-1 .myco-player{left:41%;bottom:36%;}
-.pos-2-1 .myco-player{left:67%;bottom:36%;}
-.pos-0-2 .myco-player{left:14%;bottom:13%;}
-.pos-1-2 .myco-player{left:41%;bottom:13%;}
-.pos-2-2 .myco-player{left:67%;bottom:13%;}
-.mushroom-sprite {
-    right:33%; bottom:22%; font-size:3.6rem; z-index:2;
-    filter:drop-shadow(0 6px 14px rgba(0,0,0,.3));
-}
-.state-waiting .mushroom-sprite { opacity:0; }
-.state-discovered .mushroom-sprite {
-    animation: shroom-popup 0.7s cubic-bezier(.34,1.56,.64,1) both;
-}
-.state-discovered .myco-player {
-    animation: myco-bob 2.4s ease-in-out infinite,
-               myco-run-in 0.6s cubic-bezier(.34,1.56,.64,1) both;
-}
-@keyframes shroom-popup {
-    0%   { opacity:0; transform:translateY(3rem) scale(.2); }
-    60%  { opacity:1; transform:translateY(-.4rem) scale(1.18); }
-    100% { opacity:1; transform:translateY(0) scale(1); }
-}
-@keyframes myco-run-in {
-    0%   { transform:translateX(-3rem) scaleX(-1); }
-    100% { transform:translateX(0) scaleX(1); }
-}
-.state-picked .mushroom-sprite {
-    animation: shroom-catch 0.55s cubic-bezier(.34,1.56,.64,1) both;
-}
-.state-picked .myco-player {
-    animation: myco-bob 2.4s ease-in-out infinite, myco-catch-jump 0.55s ease both;
-}
-@keyframes shroom-catch {
-    0%   { opacity:1; transform:translateY(0) scale(1); }
-    40%  { opacity:1; transform:translateY(-2.5rem) scale(1.3) rotate(15deg); }
-    100% { opacity:0; transform:translateY(-5rem) scale(.2) rotate(40deg); }
-}
-@keyframes myco-catch-jump {
-    0%,100%{ transform:translateY(0); }
-    40%    { transform:translateY(-1.4rem) scale(1.1); }
-}
-.state-danger .mushroom-sprite {
-    animation: shroom-popup 0.7s cubic-bezier(.34,1.56,.64,1) both,
-               poison-pulse 1.2s ease-in-out infinite 0.7s;
-    filter: drop-shadow(0 0 18px rgba(255,62,91,.9));
-}
-.state-danger .myco-player {
-    animation: myco-bob 2.4s ease-in-out infinite, myco-recoil 0.5s ease both;
-}
-@keyframes poison-pulse {
-    0%,100%{ filter:drop-shadow(0 0 10px rgba(255,62,91,.6)); }
-    50%    { filter:drop-shadow(0 0 28px rgba(255,62,91,1)); }
-}
-@keyframes myco-recoil {
-    0%  { transform:translateX(0); }
-    30% { transform:translateX(-1.2rem); }
-    60% { transform:translateX(.4rem); }
-    100%{ transform:translateX(0); }
-}
-.state-game-over .forest-scene,
-.state-game-over {
-    animation: screen-shake .45s ease both;
-    background:
-        radial-gradient(circle at 50% 72%, rgba(255,62,91,.35), transparent 8rem),
-        linear-gradient(180deg,#3b0a0a 0%,#6b1a1a 54%,#2a0a0a 100%) !important;
-}
-.state-game-over .mushroom-sprite {
-    animation: shroom-explode .6s ease both;
-    filter: drop-shadow(0 0 24px rgba(255,62,91,1));
-}
-.state-game-over .myco-player { animation: myco-fall .6s ease both; }
-@keyframes screen-shake {
-    0%,100%{ transform:translateX(0); }
-    20%    { transform:translateX(-8px); }
-    40%    { transform:translateX(8px); }
-    60%    { transform:translateX(-5px); }
-    80%    { transform:translateX(5px); }
-}
-@keyframes shroom-explode {
-    0%  { transform:scale(1) rotate(0); opacity:1; }
-    50% { transform:scale(1.8) rotate(20deg); opacity:.8; }
-    100%{ transform:scale(0) rotate(90deg); opacity:0; }
-}
-@keyframes myco-fall {
-    0%  { transform:rotate(0) translateY(0); opacity:1; }
-    100%{ transform:rotate(-90deg) translateY(2rem); opacity:.4; }
-}
-.rarity-rare .mushroom-sprite      { filter:drop-shadow(0 0 18px rgba(138,220,255,.9)); }
-.rarity-legendary .mushroom-sprite { filter:drop-shadow(0 0 28px rgba(255,215,0,1)); animation:legendary-pulse 1s ease-in-out infinite 0.7s; }
-@keyframes legendary-pulse {
-    0%,100%{ filter:drop-shadow(0 0 18px rgba(255,215,0,.7)); transform:scale(1); }
-    50%    { filter:drop-shadow(0 0 36px rgba(255,215,0,1)); transform:scale(1.1); }
-}
-.forest-map {
-    display:grid; grid-template-columns:repeat(3,1fr);
-    gap:.3rem; margin:.4rem auto .6rem;
-    max-width:9rem; padding:.4rem;
-    border:1px solid rgba(255,255,255,.18); border-radius:14px;
-    background:rgba(13,38,28,.58);
-}
-.map-tile {
-    display:grid; min-height:1.7rem; place-items:center;
-    border-radius:8px; background:rgba(255,255,255,.1); font-weight:900;
-}
-.map-tile.active { background:rgba(255,224,138,.92); color:#3d2c00!important; }
-.scene-caption {
-    display:flex; justify-content:space-between; gap:.6rem;
-    padding:.55rem .8rem; border-radius:14px;
-    background:rgba(13,38,28,.68); backdrop-filter:blur(6px);
-    align-items:center;
-}
-.scene-caption span { color:#d9f4d4; }
-.score-burst {
-    margin:.65rem auto 0; max-width:520px;
-    padding:.5rem .85rem; border-radius:999px;
-    background:rgba(255,224,112,.18); border:1px solid rgba(255,244,190,.36);
-    color:#fff7d6; font-weight:900; text-align:center;
-    animation:score-pop .56s ease both;
-}
-@keyframes score-pop {
-    0%{transform:scale(.92);opacity:0;}
-    45%{transform:scale(1.06);opacity:1;}
-    100%{transform:scale(1);opacity:1;}
-}
-.state-game-over .score-burst {
-    background:rgba(130,0,30,.45); border-color:rgba(255,120,140,.55);
-}
-.story-moment {
-    margin:.75rem auto 0; max-width:760px;
-    padding:.8rem 1rem; border:1px solid rgba(255,234,166,.3);
-    border-radius:18px; background:rgba(25,18,45,.72);
-    color:#fff7d6; box-shadow:0 0 24px rgba(165,111,255,.22);
-}
-.story-moment strong,.story-moment span { display:block; }
-.story-moment span { margin-top:.2rem; color:#f6e7b2; }
-.generating .forest-scene, .pending .forest-scene { opacity:.88!important; }
-.progress-level,.progress-level-inner { display:none!important; }
-div.gradio-html { background:transparent!important; }
-.wrap.default.pending,.wrap.default.generating { background:transparent!important; }
-
-/* AI activity indicator */
-.ai-tick-badge {
-    display:inline-block; padding:.15rem .55rem; border-radius:999px;
-    background:rgba(80,220,120,.22); border:1px solid rgba(80,220,120,.4);
-    color:#90ffb8; font-size:.72rem; font-weight:800;
-    animation: ai-pulse 2s ease-in-out infinite;
-}
-@keyframes ai-pulse {
-    0%,100%{ opacity:.6; } 50%{ opacity:1; }
-}
-</style>
-"""
-
-
-# ---------------------------------------------------------------------------
-# Static UI fragments
-# ---------------------------------------------------------------------------
-
-def hero_markdown() -> str:
-    return """
-<div class="myco-hero">
-  <div class="myco-mascot">🍄</div>
-  <div>
-    <p class="eyebrow">Tiny AI forest game</p>
-    <h1>Myco</h1>
-    <p>Follow an AI mushroom companion through a glowing forest. Every discovery starts with Myco's intuition.</p>
-  </div>
-</div>
-"""
-
-def home_forest_markdown() -> str:
-    return """
-<div class="home-forest-postcard" aria-label="Animated Myco forest postcard">
-  <style>
-    .home-myco-wrapper, .home-brown-wrapper { position:relative; display:inline-block; }
-    .home-spore {
-      position:absolute; left:50%; top:20%; width:4px; height:4px;
-      background:#a8ffb2; border-radius:50%; filter:blur(0.5px);
-      box-shadow:0 0 6px #52ff6b,0 0 10px #fff;
-      opacity:0; pointer-events:none;
-      animation:floatHomeSpore var(--duration) ease-out infinite;
-      animation-delay:var(--delay);
-    }
-    @keyframes floatHomeSpore {
-      0%   { transform:translate(0,0) scale(1); opacity:0; }
-      15%  { opacity:1; }
-      80%  { opacity:0.7; }
-      100% { transform:translate(var(--x),var(--y)) scale(0.2); opacity:0; }
-    }
-  </style>
-  <div class="home-sky">
-    <span class="home-milky-way">🌌</span>
-    <span class="home-star star-one">✨</span>
-    <span class="home-star star-two">✦</span>
-    <span class="home-star star-three">✧</span>
-  </div>
-  <div class="home-forest-floor">
-    <span class="home-tree left">🌲</span>
-    <span class="home-grass grass-left">🌿</span>
-    <span class="home-myco-wrapper">
-      <span class="home-myco">🍄</span>
-      <span class="home-spore" style="--x:-25px;--y:-45px;--duration:3.5s;--delay:0s;"></span>
-      <span class="home-spore" style="--x:20px;--y:-35px;--duration:4.2s;--delay:0.8s;"></span>
-      <span class="home-spore" style="--x:-5px;--y:-60px;--duration:3s;--delay:1.5s;"></span>
-    </span>
-    <span class="home-brown-wrapper">
-      <span class="home-brown-mushroom">🍄‍🟫</span>
-      <span class="home-spore" style="--x:-15px;--y:-40px;--duration:3.8s;--delay:0.4s;background:#ffeaa7;box-shadow:0 0 6px #fdcb6e,0 0 10px #fff;"></span>
-      <span class="home-spore" style="--x:25px;--y:-50px;--duration:4.5s;--delay:1.2s;background:#ffeaa7;box-shadow:0 0 6px #fdcb6e,0 0 10px #fff;"></span>
-    </span>
-    <span class="home-grass grass-right">🍃</span>
-    <span class="home-tree right">🌳</span>
-    <span class="home-moon">🌖</span>
-  </div>
-  <p><strong>The Milky Way is awake.</strong> Myco hears a brown mushroom whispering your first clue.</p>
-  <span class="home-whisper">"Tap Play. Let's find what the forest is hiding."</span>
-</div>
-"""
-
-def play_hook_markdown() -> str:
-    return """
-<div class="play-hook">
-  <p class="eyebrow">Mission</p>
-  <h2>Goal: follow clues until Myco remembers the Impossible Mushroom.</h2>
-  <div class="hook-steps">
-    <span>1 · Move through the forest</span>
-    <span>2 · Search Clearing — mushroom pops up!</span>
-    <span>3 · Myco reacts · Pick, Study, or Follow Whisper</span>
-  </div>
-  <p>Every clue advances one mystery. Follow whispers to reveal why the MycoDex is regrowing a forest that vanished.</p>
-</div>
-"""
-
-def game_intro_markdown() -> str:
-    return """
-<div style="text-align:center;margin-bottom:.75rem;">
-  <h3>🌲 The Deep Forest</h3>
-  <p style="color:#359635;font-size:.9em;">
-    You step into the glowing undergrowth. Myco hops off your shoulder, its cap faintly pulsing.<br>
-    Click <strong>Search Clearing</strong> — watch Myco run toward whatever pops up.
-    <span class="ai-tick-badge">🤖 Myco AI roaming</span>
-  </p>
-</div>
-"""
-
-
-# ---------------------------------------------------------------------------
-# Forest scene — main animated panel
-# ---------------------------------------------------------------------------
-
-def forest_scene(
-    current: "MushroomState | None",
-    collection: "CollectionState | None",
-    position: "tuple[int,int] | None" = None,
-) -> str:
-    import time
-    count    = len(_safe_collection(collection))
-    area     = current_area(count)
-    pos_x, pos_y = _safe_position(position)
-    pos_cls  = f"pos-{pos_x}-{pos_y}"
-
-    # Safe defaults
-    mushroom_name = "Hidden mushroom"
-    rarity        = "common"
-    sprite        = "✨"
-    status        = "The moss is listening. Click Search Clearing to wake the forest."
-    omen          = "Myco is waiting to sense the first spore."
-    event_label   = "🌌 Dreaming Forest"
-    encounter     = "The next clearing may reveal a memory, creature, or poison omen."
-    mystery_label = "The Wrong Memory"
-    score_total   = "0"
-    health        = "3"
-    reward_text   = "Search a clearing to score spores."
-    state_cls     = "state-waiting"
-
-    if current is not None:
-        mushroom_name = current.get("name", "Mystery cluster")
-        rarity        = current.get("rarity", "Common").lower()
-        game_over     = current.get("game_over") == "Yes"
-        
-        event_label   = f"{current.get('event_emoji','✨')} {current.get('event_title','Strange Omen')}"
-        encounter     = current.get("encounter", "Go pick them up!")
-        mystery_label = current.get("mystery_title", "The Wrong Memory")
-        score_total   = current.get("score_total", "0")
-        health        = current.get("health", "3")
-        reward_text   = current.get("reward_text", "Dodge the poison, collect the rest!")
-        state_cls     = _scene_state_class(current)
-
-        if game_over:
-            status = "💀 GAME OVER: You stepped on a poisonous mushroom!"
-            omen   = "Press Search Clearing to start a new run."
-        elif current.get("picked") == "Yes":
-            status = "✅ Area clear! All safe mushrooms collected."
-            omen   = "Search the next clearing!"
-        else:
-            status = "Mushrooms sprouted! Move Myco over them to collect."
-            omen   = "🍄 Watch your step!"
-
-    anim_key = str(int(time.time() * 1000))[-6:]
-
-    return f'''{SCENE_STYLES}
-<div class="forest-scene rarity-{escape(rarity)} {pos_cls} {state_cls}" data-key="{anim_key}">
-  <div class="scene-hud">
-    <span>🧭 {escape(area.name)}</span>
-    <span>🎮 ({pos_x+1},{pos_y+1})</span>
-    <span>📖 {count} found</span>
-    <span>⭐ {escape(str(score_total))}</span>
-    <span>❤️ {escape(str(health))}/3</span>
-    <span>{escape(event_label)}</span>
-    <span>🧩 {escape(mystery_label)}</span>
-  </div>
-
-  <div class="scene-stage" aria-label="Magical forest scene">
-    <span class="tree tree-left">🌲</span>
-    <span class="tree tree-right">🌲</span>
-    <span class="grass grass-one">🌿</span>
-    <span class="grass grass-two">🍃</span>
-    <span class="myco-player" title="Myco">🍄</span>
-    <span class="mushroom-sprite" title="{escape(mushroom_name)}">{escape(sprite)}</span>
-    <span class="sparkle sparkle-one">✨</span>
-    <span class="sparkle sparkle-two">✦</span>
-    <span class="wood-log">🪵</span>
-  </div>
-
-  <div class="forest-map" aria-label="Forest grid">
-    {_movement_tiles(pos_x, pos_y, current)} 
-  </div>
-
-  <div class="scene-caption">
-    <strong>{escape(str(status))}</strong>
-    <span>{escape(str(omen))}</span>
-  </div>
-  <div class="score-burst" aria-live="polite">{escape(str(reward_text))}</div>
-  <div class="story-moment">
-    <strong>{escape(str(event_label))}</strong>
-    <span>{escape(str(encounter))}</span>
-  </div>
-</div>'''
-
-
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-def _safe_position(position):
-    if position is None:
-        return (1, 1)
-    try:
-        x, y = position
-        return (max(0, min(2, int(x))), max(0, min(2, int(y))))
-    except Exception:
-        return (1, 1)
-
-
-def _movement_tiles(active_x, active_y, current=None):
-    """Draws the grid, safely decoding strings to ensure mushrooms always show up!"""
-    mush_coords = {}
-    
-    # --- DEFENSIVE PARSING ---
-    # If Gradio passed the state as a string, turn it back into a dictionary
-    if isinstance(current, str):
-        try:
-            current = json.loads(current)
-        except:
-            try:
-                current = ast.literal_eval(current)
-            except:
-                current = {} # Default to empty if parsing fails
-
-    # Map out where the mushrooms are
-    if current and isinstance(current, dict) and "active_mushrooms" in current:
-        for m in current["active_mushrooms"]:
-            # Ensure we are using ints for coordinates, just in case
-            if m.get("picked") == "No" or m.get("picked") is False:
-                mx, my = int(m["mush_x"]), int(m["mush_y"])
-                mush_coords[(mx, my)] = m
-
-    tiles = []
-    for y in range(3):
-        for x in range(3):
-            # Ensure player coordinates are ints
-            is_player = (int(x), int(y)) == (int(active_x), int(active_y))
-            is_mush = (int(x), int(y)) in mush_coords
-            
-            active_class = " active" if is_player else ""
-            
-            if is_player:
-                icon = "🍄"  # Myco
-            elif is_mush:
-                # If it's a mushroom, show poison skull or magic sparkles
-                m_data = mush_coords[(int(x), int(y))]
-                icon = "☠️" if m_data.get("poison") == "Yes" else "✨"
-            else:
-                icon = "·"  # Empty grass
-                
-            tiles.append(f'<span class="map-tile{active_class}">{icon}</span>')
-            
-    return "".join(tiles)
-
-
-def _scene_state_class(current):
-    if not current:
-        return "state-waiting"
-    if current.get("game_over") == "Yes":
-        return "state-game-over"
-    if current.get("picked") == "Yes":
-        return "state-picked"
-    if current.get("poison") == "Yes":
-        return "state-danger"
-    return "state-discovered"
-
-def _safe_collection(collection):
-    return list(collection or [])
-
-
-# ---------------------------------------------------------------------------
-# Game status panel
-# ---------------------------------------------------------------------------
-
-def game_status_markdown(
-    current: "MushroomState | None",
-    collection: "CollectionState | None",
-    position: "tuple[int,int] | None" = None,
-) -> str:
-    count          = len(_safe_collection(collection))
-    pos_x, pos_y   = _safe_position(position)
-    active_mystery = next_mystery(count)
-    mystery_line   = _mystery_goal_line(active_mystery, count)
-
-    if current is None:
-        objective   = "Goal: solve **one mystery** — why does Myco remember a vanished forest?"
-        discovery   = "No active discovery yet. Move Myco, then Search Clearing."
-        ai_job      = "Myco AI is roaming — watch it search, study, and collect automatically."
-        event       = "**Event:** waiting for the first omen"
-        clue_line   = mystery_line
-        thread_line = "**Mystery thread:** The Wrong Memory — search the first clearing."
-        bloom_line  = f"**Impossible bloom:** {_mystery_bloom_meter(count)}"
-        score_line  = "**Score:** 0 spores · **Health:** 3/3"
-    else:
-        name      = current.get("name", "Mystery mushroom")
-        studied   = current.get("studied") == "Yes"
-        game_over = current.get("game_over") == "Yes"
-        picked    = current.get("picked") == "Yes"
-
-        if game_over:
-            objective = "**💀 GAME OVER** — press **Search Clearing** to start a new run."
-        elif picked:
-            objective = "Current objective: **move to the next clearing and search again**."
-        else:
-            next_step = "Collect it to preserve the clue" if studied else "Study it, then Collect or Pick"
-            objective = f"Current objective: **{next_step}**."
-
-        bloom_line  = f"**Impossible bloom:** {_mystery_bloom_meter(count)}"
-        score_line  = (
-            f"**Score:** {current.get('score_total','0')} spores · "
-            f"**Health:** {current.get('health','3')}/3 · "
-            f"**Last:** {current.get('reward_text','—')}"
-        )
-        discovery   = f"Active discovery: **{name}** · Rarity: **{current.get('rarity','Unknown')}**"
-        event       = f"**Event:** {current.get('event_emoji','✨')} {current.get('event_title','Strange Omen')}"
-        clue_line   = f"**Clue:** {current.get('clue','Myco is still listening.')}"
-        thread_line = (
-            f"**Mystery thread:** {current.get('mystery_title','The Wrong Memory')} — "
-            f"Next: {current.get('mystery_next','follow the whisper.')}"
-        )
-        ai_job = "Myco AI is watching — it will study and collect automatically while you explore."
-
-    return "\n".join((
-        "### 🎮 Quest Log",
-        f"**MycoDex:** {count} discoveries · **Map:** ({pos_x+1},{pos_y+1})",
-        discovery, objective, score_line, bloom_line,
-        event, clue_line, thread_line, mystery_line, ai_job,
-    ))
-
-
-# ---------------------------------------------------------------------------
-# Mushroom card
-# ---------------------------------------------------------------------------
-
-def mushroom_card(
-    mushroom: "Mushroom | None",
-    clue: "str | None" = None,
-    secret: "str | None" = None,
-    state: "MushroomState | None" = None,
-) -> str:
-    if mushroom is None:
-        return "### 🌲 Forest Clearing\nClick **Search Clearing** — watch Myco run toward the mushroom!"
-    s       = state or {}
-    poison  = mushroom.name in POISONOUS_MUSHROOM_NAMES
-    warning = "\n> ⚠️ **Myco senses danger — do NOT pick this without studying first!**" if poison else ""
-    return "\n".join((
-        f"### 🍄‍🟫 {mushroom.name}",
-        f"**{mushroom.rarity} discovery** · found near **{mushroom.habitat}**",
-        f"> {mushroom.lore}",
-        warning,
-        "",
-        f"* **Edible:** {mushroom.edible}",
-        f"* **Magic:** {mushroom.magic}",
-        f"* **Danger:** {mushroom.danger}",
-        f"* **Value:** {_mushroom_value_label(mushroom.rarity)}",
-        f"* **Poison risk:** {_poison_risk_label(mushroom.name)}",
-        f"* **Event:** {s.get('event_emoji','✨')} {s.get('event_title','Strange Omen')}",
-        f"* **Mystery:** {s.get('mystery_title','The Wrong Memory')}",
-        f"* **Clue:** {clue or 'Study with Myco to reveal the clue.'}",
-        f"* **Secret:** {secret or 'Collect it to see how the MycoDex reacts.'}",
-        f"* **Status:** {'⚠️ POISONOUS' if poison else '✅ Appears safe'}",
-    ))
-
-def _mushroom_value_label(rarity):
-    return {"Legendary": "100 spores", "Rare": "35 spores"}.get(rarity, "10 spores")
-
-def _poison_risk_label(name):
-    return "⚠️ POISONOUS — Game Over if picked!" if name in POISONOUS_MUSHROOM_NAMES else "No obvious poison"
-
-
-# ---------------------------------------------------------------------------
-# World map
-# ---------------------------------------------------------------------------
-
-def world_map_markdown(collection: "CollectionState | None") -> str:
-    count = len(_safe_collection(collection))
-    cards = []
-    for area in AREA_UNLOCKS:
-        unlocked = count >= area.required_discoveries
-        state    = "unlocked" if unlocked else "locked"
-        badge    = "✅ Unlocked" if unlocked else f"🔒 {area.required_discoveries - count} away"
-        cards.append("\n".join((
-            f'<div class="map-card {state}">',
-            '  <div class="map-card-top">',
-            f'    <strong>{escape(area.name)}</strong><span>{badge}</span>',
-            '  </div>',
-            f'  <p>{escape(area.description)}</p>',
-            '</div>',
-        )))
-    secrets = tuple(_secret_badge(t.name, count >= t.required_discoveries) for t in revealed_mysteries(count))
-    if not secrets:
-        secrets = (_secret_badge("First Spore", False),)
-    return "\n".join((
-        '<div class="world-map-panel">',
-        '  <div class="world-map-header"><p class="eyebrow">World Map</p>',
-        '  <h2>Forest Atlas</h2>',
-        f'  <p>{count} discoveries logged.</p></div>',
-        f'  <div class="achievement-row">{"".join(secrets)}</div>',
-        f'  <div class="map-grid">{"".join(cards)}</div>',
-        '</div>',
-    ))
-
-def _secret_badge(label, unlocked):
-    state = "earned" if unlocked else "pending"
-    icon  = "🔎" if unlocked else "◇"
-    return f'<span class="achievement {state}">{icon} {escape(label)}</span>'
-
-
-# ---------------------------------------------------------------------------
-# MycoDex
-# ---------------------------------------------------------------------------
-
-def dex_markdown(collection: "CollectionState | None") -> str:
-    current_collection = _safe_collection(collection)
-    if not current_collection:
-        return EMPTY_DEX
-    rows = ["### 📖 MycoDex", ""]
-    for entry in current_collection:
-        poison_flag = " ☠️" if entry.get("poison") == "Yes" else ""
-        rows.append(
-            f"* 🍄 **{entry['name']}**{poison_flag} — {entry['rarity']} — "
-            f"{entry['habitat']} — clue: {entry.get('clue','not studied yet')}"
-        )
-    return "\n".join(rows)
-
-
-# ---------------------------------------------------------------------------
-# Progress
-# ---------------------------------------------------------------------------
-
-def progress_markdown(collection: "CollectionState | None") -> str:
-    count          = len(_safe_collection(collection))
-    active_area    = current_area(count)
-    upcoming_area  = next_area(count)
-    unlocked_names = ", ".join(a.name for a in unlocked_areas(count))
-    rows = [
-        "### ✨ Forest Progress",
-        f"**MycoDex discoveries:** {count}",
-        f"**Current area:** {active_area.name} — {active_area.description}",
-        f"**Unlocked:** {unlocked_names}",
-    ]
-    upcoming_mystery = next_mystery(count)
-    if upcoming_area:
-        rows.append(f"**Next area:** {upcoming_area.required_discoveries - count} more to unlock **{upcoming_area.name}**.")
-    else:
-        rows.append(f"**All areas visible.** You reached **{AREA_UNLOCKS[-1].name}**.")
-    if upcoming_mystery:
-        rows.append(f"**Next secret:** {upcoming_mystery.required_discoveries - count} more to reveal **{upcoming_mystery.name}**.")
-    else:
-        rows.append("**All current secrets found.** Myco thinks the Elder is watching kindly.")
-    return "\n\n".join(rows)
-
-
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-def _mystery_goal_line(active_mystery, count):
-    if active_mystery is None:
-        return "**Mystery:** Every known clue is awake. Keep exploring for rare surprises."
-    remaining = active_mystery.required_discoveries - count
-    return f"**Mystery:** {remaining} clue discoveries until **{active_mystery.name}** — {active_mystery.clue}"
-
-def _mystery_bloom_meter(count):
-    filled = max(0, min(5, count))
-    petals = "".join("🌕" if i < filled else "🌑" for i in range(5))
-    if filled >= 5:
-        return f"{petals} Impossible Bloom visible"
-    return f"{petals} {5 - filled} clue-whispers remain"
-