Update utils.py

utils.py

@@ -195,3 +195,70 @@ def score_drawing(image_path, expected_sides):
     except Exception as e:
         print(f"[OpenCV ERROR] Failed to process image: {e}")
         return 0, 0
+
+
+
+# --- NEW: Gradio UI Helper Functions ---
+
+def save_final_answer(current_index, current_answer, all_answers):
+    """A dedicated function to save the last answer before submitting."""
+    all_answers[current_index] = current_answer
+    return all_answers
+
+def update_view(new_index, all_answers, module):
+    """Updates the UI elements when navigating to a new question."""
+    q_data = module.STRUCTURED_QUESTIONS[new_index]
+    progress = f"## {q_data['main_cat']} - Q{q_data['main_num']}{q_data['sub_letter']} ({new_index + 1} of {module.TOTAL_QUESTIONS})"
+    
+    is_drawing_q = "draw a copy" in q_data["question"]
+    
+    return (
+        f"Say 🔊 {q_data['question']}",
+        all_answers[new_index],
+        new_index,
+        progress,
+        q_data["instruction"],
+        module.QUESTION_CHOICES[new_index],
+        gr.update(visible=is_drawing_q),
+        None  # Clear the audio_input component
+    )
+
+def save_and_navigate(direction, current_index, current_answer, all_answers, module):
+    """Saves the current answer and moves to the next/previous question."""
+    all_answers[current_index] = current_answer
+    if direction == "next":
+        new_index = min(current_index + 1, module.TOTAL_QUESTIONS - 1)
+    else:  # prev
+        new_index = max(current_index - 1, 0)
+    return update_view(new_index, all_answers, module) + (all_answers,)
+
+def jump_to_question(selected_choice, current_index, current_answer, all_answers, module):
+    """Saves the current answer and jumps to the selected question."""
+    if not selected_choice:
+        return update_view(current_index, all_answers, module) + (all_answers,)
+    all_answers[current_index] = current_answer
+    new_index = module.QUESTION_CHOICES.index(selected_choice)
+    return update_view(new_index, all_answers, module) + (all_answers,)
+
+def reset_app(module):
+    """Resets the state of an assessment tab to its initial view."""
+    initial_q = module.STRUCTURED_QUESTIONS[0]
+    is_drawing_q = "draw a copy" in initial_q["question"]
+    return (
+        0,  # question_index
+        [""] * module.TOTAL_QUESTIONS,  # answers
+        "",  # score_lines
+        "",  # total
+        f"Say 🔊 {initial_q['question']}",  # question_button
+        f"## {initial_q['main_cat']} - Q{initial_q['main_num']}{initial_q['sub_letter']} (1 of {module.TOTAL_QUESTIONS})",
+        initial_q["instruction"],
+        "",  # answer_text
+        module.QUESTION_CHOICES[0],  # jump_nav
+        None,  # audio_input
+        None,  # image_upload
+        gr.update(visible=False),  # start_over_btn
+        gr.update(visible=True),   # submit_btn
+        None,   # tts_audio
+        ""      # score_state
+    )
+