Files
Zauberwald/.planning/quick/260329-tv5-bungsanleitung-dauerhaft-statt-titel-anz/260329-tv5-PLAN.md
T

2.8 KiB

type, description, files_modified
type description files_modified
quick Uebungsanleitung dauerhaft statt Titel anzeigen
src/ui/screens.ts
Replace the phase titles "Ueben"/"Woerter" with the companion instruction texts, and keep them visible for the entire phase duration. Remove the 2.5s timeout pattern that currently shows/hides the instructions.

Purpose: The child should always see what to do during practice/words phases, not just a brief flash of instructions. Output: Modified screens.ts with persistent instruction text in the phase indicator.

@src/ui/screens.ts Task 1: Replace phase titles with instruction text and remove 2.5s delay src/ui/screens.ts In the `setPhase()` function (line 160-167), change the labels map: - `practice` label: from "Ueben" to "Jetzt kannst du ueben! Druecke die Taste zu dem Buchstaben, der herunterfaellt." - `words` label: from "Woerter" to "Jetzt kommen ganze Woerter! Tippe die Buchstaben nacheinander ein." - `discover` label: keep "Entdecken" as-is

In runPracticePhase() (line 472-484), remove:

  • Lines 474-479: the companionText.textContent assignment, companionArea.style.display, the setTimeout/await 2500ms delay, the cancelled check after delay, and the companionText clearing
  • Keep: setPhase("practice"), createExerciseState(level), and the runLetterExercise promise

In runWordsPhase() (line 486+), remove:

  • Lines 488-493: the companionText.textContent assignment, companionArea.style.display, the setTimeout/await 2500ms delay, the cancelled check after delay, and the companionText clearing
  • Keep: setPhase("words"), and everything from const wordCount onward cd /home/dev/workspace/zauberwald && npx tsc --noEmit && npx vitest run 2>&1 | tail -20
  • setPhase("practice") sets the phase indicator to the full instruction text instead of "Ueben"
  • setPhase("words") sets the phase indicator to the full instruction text instead of "Woerter"
  • No setTimeout 2500ms delay in either runPracticePhase or runWordsPhase
  • No companionText assignment or clearing in those two functions
  • Instruction text stays visible for the entire phase duration via the phase indicator
Run `npx tsc --noEmit` and `npx vitest run` -- both must pass. Manual check: start a lesson, observe that practice/words phases show the instruction text in the phase indicator area throughout the entire phase.

<success_criteria>

  • Phase indicator shows full instruction text during practice and words phases
  • No 2.5s delay before exercises start
  • No companion text flickering (set then cleared)
  • TypeScript compiles, tests pass </success_criteria>