Update app.py

app.py

@@ -11,7 +11,7 @@ import time
 import os
 import base64
 
-# --- CONFIGURAÇÕES ---
+# --- CONFIGURATION ---
 GRID_NUMBERS = [
     10, 12, 14, 15, 16, 18, 20, 21,
     24, 25, 27, 28, 30, 32, 35, 36,
@@ -19,9 +19,9 @@ GRID_NUMBERS = [
     63, 64, 70, 72, 80, 81, 90, 100
 ]
 KEYBOARD_KEYS = [2, 3, 4, 5, 6, 7, 8, 9, 10]
-MAX_TIME = 200  # Tempo aumentado conforme solicitado
+MAX_TIME = 200 
 
-# --- CARREGAMENTO DE ÁUDIO (BASE64) ---
+# --- AUDIO LOADING (BASE64 for Zero Latency) ---
 def get_audio_base64(filename):
     path = os.path.join("sounds", filename)
     if os.path.exists(path):
@@ -30,7 +30,7 @@ def get_audio_base64(filename):
             return "data:audio/wav;base64," + base64.b64encode(data).decode()
     return ""
 
-# Pré-carrega os sons da pasta /sounds para o dicionário JS
+# Pre-load sounds from the /sounds folder
 SOUNDS = {
     "click": get_audio_base64("click.wav"),
     "correct": get_audio_base64("correct.wav"),
@@ -38,20 +38,20 @@ SOUNDS = {
     "complete": get_audio_base64("complete.wav")
 }
 
-# --- JAVASCRIPT PARA PLAYBACK IMEDIATO ---
+# --- JAVASCRIPT FOR INSTANT PLAYBACK ---
 js_sound_trigger = """
 (tag) => {
     if (!tag) return;
     const soundData = """ + str(SOUNDS) + """;
     if (soundData[tag]) {
         const audio = new Audio(soundData[tag]);
-        audio.play().catch(e => console.log("Audio playback blocked"));
+        audio.play().catch(e => console.log("Audio blocked: Interact with the page first."));
     }
     return tag;
 }
 """
 
-# --- LÓGICA DO JOGO ---
+# --- GAME LOGIC ---
 def get_empty_state():
     return {
         "solved": [False] * 32,
@@ -64,7 +64,7 @@ def get_empty_state():
 
 def handle_game_logic(state, action_type, value=None):
     if state["game_over"]:
-        return state, "Game Over!", ""
+        return state, "Game Over! Restart to play.", ""
 
     feedback = "Select a target number..."
     sound_key = "click"
@@ -94,34 +94,34 @@ def handle_game_logic(state, action_type, value=None):
                     sound_key = "wrong"
                 state["current_factors"] = []
 
-    # Cálculo do Score
     elapsed = int(time.time() - state["start_time"])
     state["score"] = max(0, MAX_TIME - elapsed)
     
     if all(state["solved"]):
         state["game_over"] = True
-        feedback = f"🏆 VICTORY! Final Score: {state['score']}"
-        sound_key = "complete" # Som final solicitado
+        feedback = "🏆 CONGRATULATIONS! ALL SOLVED!"
+        sound_key = "complete"
 
     return state, feedback, sound_key
 
-# --- INTERFACE ---
+# --- STYLING ---
 custom_css = """
 .grid-btn { min-width: 80px !important; height: 80px !important; font-size: 20px !important; margin: 2px !important; }
-.kb-btn { min-width: 60px !important; height: 50px !important; }
+.kb-btn { min-width: 60px !important; height: 60px !important; font-size: 18px !important; }
 """
 
 with gr.Blocks(title="Autuori - Factorization Game", css=custom_css) as demo:
     state = gr.State(get_empty_state())
     
-    # Campo invisível que dispara o som via JS
+    # Hidden field to trigger JS sound
     sound_trigger = gr.Textbox(visible=False)
     sound_trigger.change(None, inputs=sound_trigger, js=js_sound_trigger)
 
-    gr.Markdown("# 🎮 Interactive Factorization v1.5 EN\n**Developer: Marcos Autuori**")
+    gr.Markdown("# 🎮 Interactive Factorization v1.5 EN\n**Developed by Marcos Autuori**")
     
     with gr.Row():
         with gr.Column(scale=4):
+            # 4x8 Target Grid
             grid_buttons = []
             for r in range(4):
                 with gr.Row():
@@ -131,14 +131,19 @@ with gr.Blocks(title="Autuori - Factorization Game", css=custom_css) as demo:
                         grid_buttons.append(btn)
         
         with gr.Column(scale=1):
-            status_box = gr.Textbox(label="Status", value="Select a blue target", interactive=False)
+            # Status & Info
+            status_box = gr.Textbox(label="Status", value="Select a target", interactive=False)
             score_display = gr.Number(label="Score", value=MAX_TIME, interactive=False)
             
-            gr.Markdown("### Factors")
+            gr.Markdown("### Factor Keyboard")
             keyboard_btns = []
-            for val in KEYBOARD_KEYS:
-                kb_btn = gr.Button(str(val), variant="secondary", elem_classes="kb-btn")
-                keyboard_btns.append(kb_btn)
+            # Keyboard 3x3 (Correct Layout)
+            for r_kb in range(3):
+                with gr.Row():
+                    for c_kb in range(3):
+                        val = KEYBOARD_KEYS[r_kb * 3 + c_kb]
+                        kb_btn = gr.Button(str(val), variant="secondary", elem_classes="kb-btn")
+                        keyboard_btns.append(kb_btn)
             
             reset_btn = gr.Button("Restart Game", variant="stop")
 
@@ -150,7 +155,7 @@ with gr.Blocks(title="Autuori - Factorization Game", css=custom_css) as demo:
             updates.append(gr.update(value=label, variant=variant, interactive=not s["solved"][i]))
         return updates + [s["score"]]
 
-    # Eventos
+    # Events
     for i, btn in enumerate(grid_buttons):
         btn.click(
             fn=lambda s, idx=i: handle_game_logic(s, "select_target", idx),