Files
Zauberwald/src/ui/screens.ts
T

481 lines
13 KiB
TypeScript
Raw Normal View History

import type {
CompanionType,
KeyboardLayout,
ScreenName,
Progress,
LessonPhase,
TypingExerciseState,
} from "../types";
import { companions } from "../companion/characters";
import { saveProgress, getProgress } from "../storage/db";
import {
createExerciseState,
createWordExerciseState,
getCurrentWordIndex,
handleKeyPress,
getCurrentLetter,
} from "../game/typing";
import { renderKeyboard, highlightKey, pressKey } from "../game/keyboard";
import { getLevelByNumber } from "../game/levels";
import { getLetterIntro } from "../companion/companion";
import { getWordsForLevel } from "../game/words";
import { playCorrectSound } from "../audio/sounds";
export function initWelcomeScreen(
db: IDBDatabase,
navigateTo: (screen: ScreenName) => void,
): void {
let selectedCompanion: CompanionType | null = null;
let selectedLayout: KeyboardLayout = "de";
const grid = document.getElementById("companion-grid")!;
const startBtn = document.getElementById("start-btn") as HTMLButtonElement;
const layoutToggle = document.getElementById("layout-toggle")!;
// Render companion cards
companions.forEach((c) => {
const card = document.createElement("button");
card.className = "companion-card";
card.dataset.companion = c.type;
card.innerHTML = `
<img class="companion-card__avatar" src="${c.avatarUrl}" alt="${c.name}"
onerror="this.style.display='none'; this.nextElementSibling.style.display='block';">
<span class="companion-card__emoji" style="display:none">${c.emoji}</span>
<span class="companion-card__name">${c.name}</span>
`;
card.addEventListener("click", () => {
grid.querySelectorAll(".companion-card").forEach((el) =>
el.classList.remove("companion-card--selected"),
);
card.classList.add("companion-card--selected");
selectedCompanion = c.type;
startBtn.disabled = false;
});
grid.appendChild(card);
});
// Layout toggle
layoutToggle.addEventListener("click", (e) => {
const btn = (e.target as HTMLElement).closest(
".layout-btn",
) as HTMLButtonElement | null;
if (!btn) return;
layoutToggle
.querySelectorAll(".layout-btn")
.forEach((el) => el.classList.remove("layout-btn--active"));
btn.classList.add("layout-btn--active");
selectedLayout = btn.dataset.layout as KeyboardLayout;
});
// Start button
startBtn.addEventListener("click", async () => {
if (!selectedCompanion) return;
const progress: Progress = {
id: 1,
currentLevel: 1,
completedLevels: [],
totalSessions: 0,
sessionDates: [],
selectedCharacter: selectedCompanion,
selectedLayout: selectedLayout,
totalCorrect: 0,
totalErrors: 0,
errorKeyCounts: {},
lastPlayedLevels: [],
};
await saveProgress(db, progress);
navigateTo("forest");
});
}
// Finger description for companion letter intros
const fingerDescriptions: Record<string, string> = {
f: "linker Zeigefinger",
j: "rechter Zeigefinger",
d: "linker Mittelfinger",
k: "rechter Mittelfinger",
s: "linker Ringfinger",
l: "rechter Ringfinger",
a: "linker kleiner Finger",
ö: "rechter kleiner Finger",
g: "linker Zeigefinger (Streckung)",
h: "rechter Zeigefinger (Streckung)",
e: "linker Mittelfinger (obere Reihe)",
i: "rechter Mittelfinger (obere Reihe)",
" ": "Daumen",
};
// Encouragement messages for repetition protection
const encouragementMessages = [
"Magst du sehen, was als Naechstes kommt? Im Wald gibt es noch so viel zu entdecken!",
"Der Wald wartet auf dich! Jedes Mal, wenn du uebst, waechst etwas Neues.",
"Schau mal, was sich im Wald versteckt! Probier es einfach noch einmal.",
"Dein Wald wird immer schoener. Komm, wir entdecken zusammen weiter!",
];
export function initLessonScreen(
db: IDBDatabase,
level: number,
layout: KeyboardLayout,
onComplete: (
level: number,
stats: {
totalCorrect: number;
totalErrors: number;
errorKeys: Record<string, number>;
},
) => void,
onCancel?: () => void,
isReview = false,
showEncouragement = false,
): () => void {
const letterArea = document.getElementById("letter-area")!;
const keyboardContainer = document.getElementById("lesson-keyboard")!;
const backBtn = document.getElementById(
"lesson-back-btn",
) as HTMLButtonElement;
const phaseIndicator = document.getElementById("lesson-phase-indicator")!;
const companionArea = document.getElementById("lesson-companion")!;
const companionText = document.getElementById("lesson-companion-text")!;
// Cumulative stats across all phases
let cumulativeCorrect = 0;
let cumulativeErrors = 0;
const errorKeys: Record<string, number> = {};
// Active keydown handler reference for cleanup
let activeKeyDown: ((e: KeyboardEvent) => void) | null = null;
let cancelled = false;
function cleanup(): void {
cancelled = true;
if (activeKeyDown) {
document.removeEventListener("keydown", activeKeyDown);
activeKeyDown = null;
}
letterArea.innerHTML = "";
}
function setPhase(phase: LessonPhase): void {
const labels: Record<LessonPhase, string> = {
discover: "Entdecken",
practice: "Ueben",
words: "Woerter",
};
phaseIndicator.textContent = labels[phase];
}
// Show companion avatar
let characterType: CompanionType = "fee";
const progressPromise = getProgress(db).then((progress) => {
if (!progress) return;
characterType = progress.selectedCharacter;
const companion = companions.find(
(c) => c.type === progress.selectedCharacter,
);
if (!companion) return;
const avatar = document.getElementById(
"lesson-companion-avatar",
) as HTMLImageElement;
avatar.src = companion.avatarUrl;
avatar.alt = companion.name;
companionArea.style.display = "flex";
});
// Render keyboard
renderKeyboard(keyboardContainer, layout, level);
// --- Helper: run a letter exercise phase (practice or fallback) ---
function runLetterExercise(
state: TypingExerciseState,
onDone: () => void,
): void {
function showCurrentLetter(): void {
const letter = getCurrentLetter(state);
if (!letter) return;
letterArea.innerHTML = "";
const letterEl = document.createElement("div");
letterEl.className = "falling-letter";
letterEl.textContent =
letter === " " ? "\u2423" : letter.toUpperCase();
letterArea.appendChild(letterEl);
highlightKey(letter);
}
showCurrentLetter();
function onKeyDown(e: KeyboardEvent): void {
if (e.key.length > 1 && e.key !== " ") return;
e.preventDefault();
const expectedKey = getCurrentLetter(state);
const result = handleKeyPress(state, e.key);
pressKey(e.key);
if (result.correct) {
cumulativeCorrect++;
playCorrectSound();
const currentEl = letterArea.querySelector(".falling-letter");
if (currentEl) {
currentEl.classList.add("falling-letter--dissolve");
}
if (result.exerciseComplete) {
document.removeEventListener("keydown", onKeyDown);
activeKeyDown = null;
onDone();
} else {
setTimeout(() => showCurrentLetter(), 300);
}
} else {
cumulativeErrors++;
if (expectedKey) {
errorKeys[expectedKey] = (errorKeys[expectedKey] || 0) + 1;
}
}
}
if (activeKeyDown) {
document.removeEventListener("keydown", activeKeyDown);
}
activeKeyDown = onKeyDown;
document.addEventListener("keydown", onKeyDown);
}
// --- Helper: run word exercise phase ---
function runWordExercise(
state: TypingExerciseState,
onDone: () => void,
): void {
function renderWordDisplay(): void {
letterArea.innerHTML = "";
if (!state.words || !state.wordBoundaries) return;
const wordIdx = getCurrentWordIndex(state);
const wordStart = state.wordBoundaries[wordIdx]!;
const word = state.words[wordIdx]!;
const container = document.createElement("div");
container.className = "word-display";
for (let i = 0; i < word.length; i++) {
const span = document.createElement("span");
span.className = "word-display__letter";
const globalIdx = wordStart + i;
if (globalIdx < state.currentLetterIndex) {
span.classList.add("word-display__letter--done");
} else if (globalIdx === state.currentLetterIndex) {
span.classList.add("word-display__letter--active");
}
span.textContent = word[i]!.toUpperCase();
container.appendChild(span);
}
letterArea.appendChild(container);
// Highlight expected key on keyboard
const currentLetter = getCurrentLetter(state);
if (currentLetter) highlightKey(currentLetter);
}
renderWordDisplay();
function onKeyDown(e: KeyboardEvent): void {
if (e.key.length > 1 && e.key !== " ") return;
e.preventDefault();
const expectedKey = getCurrentLetter(state);
const result = handleKeyPress(state, e.key);
pressKey(e.key);
if (result.correct) {
cumulativeCorrect++;
playCorrectSound();
if (result.exerciseComplete) {
document.removeEventListener("keydown", onKeyDown);
activeKeyDown = null;
onDone();
} else {
renderWordDisplay();
}
} else {
cumulativeErrors++;
if (expectedKey) {
errorKeys[expectedKey] = (errorKeys[expectedKey] || 0) + 1;
}
}
}
if (activeKeyDown) {
document.removeEventListener("keydown", activeKeyDown);
}
activeKeyDown = onKeyDown;
document.addEventListener("keydown", onKeyDown);
}
// --- Phase flow ---
async function startFlow(): Promise<void> {
await progressPromise;
if (cancelled) return;
// Encouragement message before starting (repetition protection)
if (showEncouragement) {
companionText.textContent =
encouragementMessages[
Math.floor(Math.random() * encouragementMessages.length)
]!;
companionArea.style.display = "flex";
await new Promise<void>((resolve) => setTimeout(resolve, 3000));
if (cancelled) return;
}
// PHASE 1: DISCOVER (skip for reviews)
if (!isReview) {
await runDiscoverPhase();
if (cancelled) return;
}
// PHASE 2: PRACTICE
await runPracticePhase();
if (cancelled) return;
// PHASE 3: WORDS
await runWordsPhase();
if (cancelled) return;
// All phases complete
onComplete(level, {
totalCorrect: cumulativeCorrect,
totalErrors: cumulativeErrors,
errorKeys,
});
}
async function runDiscoverPhase(): Promise<void> {
setPhase("discover");
const levelDef = getLevelByNumber(level);
if (!levelDef) return;
for (const key of levelDef.newKeys) {
if (cancelled) return;
if (key === " ") continue; // Skip space in discover
const fingerDesc = fingerDescriptions[key] || "ein Finger";
const introText = await getLetterIntro(
characterType,
key.toUpperCase(),
fingerDesc,
db,
);
if (cancelled) return;
// Show companion intro text
companionText.textContent = introText;
companionArea.style.display = "flex";
// Show the letter
letterArea.innerHTML = "";
const letterEl = document.createElement("div");
letterEl.className = "falling-letter";
letterEl.textContent = key.toUpperCase();
letterArea.appendChild(letterEl);
// Highlight and pulse the target key
highlightKey(key);
const keyEl = document.querySelector(
`[data-key="${key}"]`,
) as HTMLElement | null;
if (keyEl) {
keyEl.classList.add("keyboard__key--discover-pulse");
}
// Wait for child to press the correct key once
await new Promise<void>((resolve) => {
function onKeyDown(e: KeyboardEvent): void {
if (e.key.length > 1 && e.key !== " ") return;
e.preventDefault();
pressKey(e.key);
if (e.key.toLowerCase() === key.toLowerCase()) {
document.removeEventListener("keydown", onKeyDown);
activeKeyDown = null;
if (keyEl) {
keyEl.classList.remove(
"keyboard__key--discover-pulse",
);
}
resolve();
}
}
if (activeKeyDown) {
document.removeEventListener("keydown", activeKeyDown);
}
activeKeyDown = onKeyDown;
document.addEventListener("keydown", onKeyDown);
});
}
// Clear discover UI
letterArea.innerHTML = "";
companionText.textContent = "";
}
function runPracticePhase(): Promise<void> {
setPhase("practice");
const state = createExerciseState(level);
return new Promise<void>((resolve) => {
runLetterExercise(state, resolve);
});
}
function runWordsPhase(): Promise<void> {
setPhase("words");
const wordCount = 4;
let words: string[];
if (isReview) {
// Mix words from current and previous 1-2 levels
const levelsToMix = [level];
if (level > 1) levelsToMix.push(level - 1);
if (level > 2) levelsToMix.push(level - 2);
words = [];
for (const lvl of levelsToMix) {
words.push(...getWordsForLevel(lvl, 2));
}
// Shuffle and take wordCount
for (let i = words.length - 1; i > 0; i--) {
const j = Math.floor(Math.random() * (i + 1));
[words[i], words[j]] = [words[j]!, words[i]!];
}
words = words.slice(0, wordCount);
} else {
words = getWordsForLevel(level, wordCount);
if (words.length < 3) {
words = getWordsForLevel(level, 3);
}
}
if (words.length === 0) {
// Fallback: skip words phase if no words available
return Promise.resolve();
}
const state = createWordExerciseState(words);
return new Promise<void>((resolve) => {
runWordExercise(state, resolve);
});
}
// Start the flow
startFlow();
// Back button to cancel lesson
backBtn.onclick = () => {
cleanup();
if (onCancel) onCancel();
};
// Return cleanup function
return cleanup;
}