Update app.py

app.py

@@ -1,7 +1,22 @@
+"""
+================================================================================
+                    INTERACTIVE FACTORIZATION v1.4 EN
+================================================================================
+Main Developer:
+    Marcos Autuori (MarcosAutuori)
+    
+Development Assistance:
+    Gemini / GitHub Copilot
+
+Technologies Used:
+    Python 3.12, Gradio
+================================================================================
+"""
+
 import gradio as gr
 import time
 
-# Dados extraídos do seu factorization_game.py
+# Data from the original v1.4 EN script
 GRID_NUMBERS = [
     10, 12, 14, 15, 16, 18, 20, 21,
     24, 25, 27, 28, 30, 32, 35, 36,
@@ -12,6 +27,7 @@ KEYBOARD_KEYS = [2, 3, 4, 5, 6, 7, 8, 9, 10]
 MAX_TIME = 150
 
 def get_empty_state():
+    """Initializes game state"""
     return {
         "solved": [False] * 32,
         "selected_idx": None,
@@ -31,22 +47,22 @@ def format_grid_button(idx, solved_list, selected_idx):
 
 def handle_game_logic(state, action_type, value=None):
     if state["game_over"]:
-        return state, "Fim de jogo! Reinicie para jogar."
+        return state, "Game Over! Restart to play again."
 
-    feedback = "Selecione um número na grade..."
+    feedback = "Select a number from the grid..."
     
     if action_type == "select_target":
         state["selected_idx"] = value
         state["current_factors"] = []
-        feedback = f"Fatorar o número: {GRID_NUMBERS[value]}"
+        feedback = f"Factoring: {GRID_NUMBERS[value]}"
         
     elif action_type == "select_factor":
         if state["selected_idx"] is None:
-            feedback = "⚠️ Selecione um número na grade primeiro!"
+            feedback = "⚠️ Select a grid number first!"
         else:
             state["current_factors"].append(int(value))
             factors_str = " x ".join(map(str, state["current_factors"]))
-            feedback = f"Multiplicando: {factors_str}"
+            feedback = f"Current Factors: {factors_str}"
             
             if len(state["current_factors"]) == 2:
                 a, b = state["current_factors"]
@@ -54,44 +70,49 @@ def handle_game_logic(state, action_type, value=None):
                 
                 if a * b == target:
                     state["solved"][state["selected_idx"]] = True
-                    feedback = f"✔️ {a} x {b} = {target}! Correto!"
+                    feedback = f"✔️ {a} x {b} = {target}! Correct!"
                     state["selected_idx"] = None
                     state["current_factors"] = []
                 else:
-                    feedback = f"❌ {a} x {b} = {a*b} (Errado para {target})."
+                    feedback = f"❌ {a} x {b} = {a*b} (Wrong for {target})."
                     state["current_factors"] = []
 
+    # Update Score and Check Completion
     elapsed = int(time.time() - state["start_time"])
     state["score"] = max(0, MAX_TIME - elapsed)
     
     if all(state["solved"]):
         state["game_over"] = True
-        feedback = f"🏆 COMPLETO! Pontuação: {state['score']}"
+        feedback = f"🏆 COMPLETE! Final Score: {state['score']}"
 
     return state, feedback
 
-# CSS customizado para garantir retângulos idênticos
+# CSS for 4x8 uniform grid and consistent layout
 custom_css = """
 .grid-btn { 
-    min-width: 70px !important; 
-    height: 70px !important; 
-    font-size: 18px !important;
+    min-width: 80px !important; 
+    height: 80px !important; 
+    font-size: 20px !important;
     margin: 2px !important;
 }
 .kb-btn {
-    min-width: 50px !important;
+    min-width: 60px !important;
     height: 50px !important;
 }
 """
 
-with gr.Blocks(title="Factorization Game v1.4", css=custom_css) as demo:
+with gr.Blocks(title="Autuori - Factorization Game", css=custom_css) as demo:
     state = gr.State(get_empty_state())
     
-    gr.Markdown("# 🎮 Interactive Factorization v1.4 EN\n**Desenvolvedor:** Marcos Autuori")
+    with gr.Row():
+        gr.Markdown("""
+        # 🎮 Interactive Factorization v1.4 EN
+        **Developed by Marcos Autuori** | Select a target and match its factors!
+        """)
     
     with gr.Row():
         with gr.Column(scale=4):
-            # Grade 4x8 Uniforme
+            # 4x8 Grid
             grid_buttons = []
             for r in range(4):
                 with gr.Row():
@@ -101,12 +122,12 @@ with gr.Blocks(title="Factorization Game v1.4", css=custom_css) as demo:
                         grid_buttons.append(btn)
         
         with gr.Column(scale=1):
-            status_box = gr.Textbox(label="Status", value="Selecione um número", interactive=False)
-            score_display = gr.Number(label="Pontos", value=MAX_TIME, interactive=False)
+            # Side Status Panel
+            status_box = gr.Textbox(label="Status", value="Select a blue number", interactive=False)
+            score_display = gr.Number(label="Score (Time)", value=MAX_TIME, interactive=False)
             
-            gr.Markdown("### Fatores")
+            gr.Markdown("### Keyboard")
             keyboard_btns = []
-            # Organiza o teclado em 3 linhas para melhor visual no painel lateral
             for r_kb in range(3):
                 with gr.Row():
                     for c_kb in range(3):
@@ -114,13 +135,14 @@ with gr.Blocks(title="Factorization Game v1.4", css=custom_css) as demo:
                         kb_btn = gr.Button(str(val), variant="secondary", elem_classes="kb-btn")
                         keyboard_btns.append(kb_btn)
             
-            reset_btn = gr.Button("Reiniciar", variant="stop")
+            reset_btn = gr.Button("Restart Game", variant="stop")
 
+    # Helper function to refresh the whole UI
     def update_ui(s):
         updates = [format_grid_button(i, s["solved"], s["selected_idx"]) for i in range(32)]
         return updates + [s["score"]]
 
-    # Eventos da Grade
+    # Grid Events
     for i, btn in enumerate(grid_buttons):
         btn.click(
             fn=lambda s, idx=i: handle_game_logic(s, "select_target", idx),
@@ -128,7 +150,7 @@ with gr.Blocks(title="Factorization Game v1.4", css=custom_css) as demo:
             outputs=[state, status_box]
         ).then(fn=update_ui, inputs=[state], outputs=grid_buttons + [score_display])
 
-    # Eventos do Teclado (Correção de loop/closure)
+    # Keyboard Events
     for kb_btn in keyboard_btns:
         kb_btn.click(
             fn=lambda s, v=kb_btn.value: handle_game_logic(s, "select_factor", v),
@@ -136,10 +158,11 @@ with gr.Blocks(title="Factorization Game v1.4", css=custom_css) as demo:
             outputs=[state, status_box]
         ).then(fn=update_ui, inputs=[state], outputs=grid_buttons + [score_display])
 
+    # Reset Event
     def reset_all():
         new_state = get_empty_state()
         updates = [gr.update(value=str(num), variant="secondary", interactive=True) for num in GRID_NUMBERS]
-        return [new_state, "Jogo reiniciado!"] + updates + [MAX_TIME]
+        return [new_state, "Game Restarted!"] + updates + [MAX_TIME]
 
     reset_btn.click(fn=reset_all, outputs=[state, status_box] + grid_buttons + [score_display])