Update app.py

app.py

@@ -466,6 +466,38 @@ EXPLAIN_TAB_ROUNDTRIP_EN = "Runs **(ES/EN→Conlang)→(Conlang→ES/EN)** to ve
 EXPLAIN_CHECKBOX_EN = "Drop articles ~10–15%, Zero copula ~5–10% extra, Remove pronouns variable, Max Exact 40–60% for >100 chars."
 LEXICON_FRIENDLY_EN = "We use **WordNet (OMW)**, pair ES words with EN, clean & sort by frequency, assign short **codes** (Minimax/Kōmín), and save three JSONs so the app can encode/decode compactly."
 
+# >>> NUEVO <<< ——— Explicación directa de los “botones / modos” (ES/EN)
+EXPLAIN_MODES_ES = """
+**¿Qué hace cada botón / modo?** *(Marca uno en “🧭 Modo de uso”)*
+
+- **🔁 Traducir**: Convierte lo que escribes en **Texto** al **Destino** que elijas (ES/EN/Minimax/Kōmín).  
+  Si el **Destino** es conlang, puedes activar **Omitir artículos**, **Cópula cero**, **Quitar pronombres** y **Máx. Compresión Exacta**.  
+  Abajo verás el **% de compactación** “base” (sin casillas) y “con tus opciones”.
+
+- **🛠️ Construir (ES/EN → Conlang)**: Obliga a que la salida sea **Minimax** o **Kōmín** (desde Español o Inglés).  
+  Aplica **reglas del conlang** (orden/partículas) y las **opciones de compactación**.
+
+- **🗝️ Decodificar (Conlang → ES/EN)**: Pega texto en **Minimax/Kōmín** y obtén **Español** o **Inglés**.  
+  Si el texto trae **`~...`**, se devuelve el **original exacto**. Sin `~...`, se reconstruye de forma **semi-lossless**.
+
+- **🔄 Prueba ida→vuelta**: Hace **(ES/EN → Conlang) → (Conlang → ES/EN)** para comprobar la **reversibilidad**.  
+  Con **Máx. Compresión Exacta**, la vuelta coincide **bit a bit**.
+"""
+EXPLAIN_MODES_EN = """
+**What does each button / mode do?** *(Tick one in “🧭 Mode”)*
+
+- **🔁 Translate**: Converts **Text** to your **Target** (ES/EN/Minimax/Kōmín).  
+  If the **Target** is a conlang, you can enable **Drop articles**, **Zero copula**, **Remove pronouns**, and **Max Exact Compression**.  
+  Below you’ll see **compaction %** for the **base** (no options) and **your options**.
+
+- **🛠️ Build (ES/EN → Conlang)**: Forces output in **Minimax** or **Kōmín** (from ES/EN), applying conlang phrasing and **compaction** options.
+
+- **🗝️ Decode (Conlang → ES/EN)**: Paste **Minimax/Kōmín** and get **Spanish** or **English**.  
+  If it ends with **`~...`**, you get the **bit-perfect original**. Otherwise, it reconstructs **semi-losslessly**.
+
+- **🔄 Round-trip**: Runs **(ES/EN → Conlang) → (Conlang → ES/EN)** to check **reversibility**. With **Max Exact**, it’s bit-for-bit.
+"""
+
 # ---------- Utilidades de compactación y vista previa ----------
 def _pct_comp(original: str, result: str) -> float:
     if not original: return 0.0
@@ -605,6 +637,14 @@ with gr.Blocks(title="Universal Conlang Translator", theme=gr.themes.Soft()) as
     gr.Markdown("## 🌍 Idioma / Language")
     lang = gr.Radio(["ES","EN"], value="ES", label="Selecciona / Select")
 
+    # >>> NUEVO <<< — Acordeones con explicación de los botones/modos (mismo nivel)
+    acc_modes_es = gr.Accordion("📖 ¿Qué hace cada botón / modo? (ES)", open=False, visible=True)
+    with acc_modes_es:
+        gr.Markdown(EXPLAIN_MODES_ES)
+    acc_modes_en = gr.Accordion("📖 What does each button / mode do? (EN)", open=False, visible=False)
+    with acc_modes_en:
+        gr.Markdown(EXPLAIN_MODES_EN)
+
     # Acordeones intro + léxico (mismo nivel)
     acc_intro_es = gr.Accordion("☑️ Opciones y compactación — guía rápida (ES)", open=False, visible=True)
     with acc_intro_es: gr.Markdown(EXPLAIN_CHECKBOX_ES)
@@ -656,6 +696,7 @@ with gr.Blocks(title="Universal Conlang Translator", theme=gr.themes.Soft()) as
         # Accordions ES/EN
         vis_es = not is_en; vis_en = is_en
         updates = [
+            _vis(vis_es), _vis(vis_en),  # >>> NUEVO <<< acc_modes_es, acc_modes_en
             _vis(vis_es), _vis(vis_en),  # intro accordions
             _vis(vis_es), _vis(vis_en),  # lexicon accordions
         ]
@@ -675,6 +716,7 @@ with gr.Blocks(title="Universal Conlang Translator", theme=gr.themes.Soft()) as
         switch_everything,
         [lang, cb_tr, cb_bu, cb_de, cb_rt],
         [
+            acc_modes_es, acc_modes_en,             # >>> NUEVO <<<
             acc_intro_es, acc_intro_en, acc_lex_es, acc_lex_en,
             panel_tr_es, panel_bu_es, panel_de_es, panel_rt_es,
             panel_tr_en, panel_bu_en, panel_de_en, panel_rt_en,
@@ -687,6 +729,7 @@ with gr.Blocks(title="Universal Conlang Translator", theme=gr.themes.Soft()) as
             switch_everything,
             [lang, cb_tr, cb_bu, cb_de, cb_rt],
             [
+                acc_modes_es, acc_modes_en,         # >>> NUEVO <<<
                 acc_intro_es, acc_intro_en, acc_lex_es, acc_lex_en,
                 panel_tr_es, panel_bu_es, panel_de_es, panel_rt_es,
                 panel_tr_en, panel_bu_en, panel_de_en, panel_rt_en,
@@ -704,3 +747,4 @@ if __name__ == "__main__":
 
 
 
+