phaser-scene-navigation

# Phaser Scene Navigation ## Overview Standardize Phaser scene transitions and navigation testing patterns. Improve reliability of scene navigation testing. ## Scene Transition Methods - `this.scene.start('SceneName', data)` - Start new scene with data - `this.scene.switch('SceneName')` - Switch to existing scene - Test seam: `window.__TEST__.commands.clickStartGame()` - Navigate via UI See `references/transition-methods.md` for detailed transition patterns. ## Navigation Testing **Use test seam commands when available**: - `clickStartGame()` - Navigate to game - `clickPlayAgain()` - Restart game **Wait patterns**: - Wait for scene initialization before accessing test seam - Wait 1-2 seconds after transition before checking test seam - Use console logs to verify scene transitions **Don't rely solely on test seam sceneKey** (may lag on transitions) See `references/navigation-testing.md` for detailed testing patterns. ## Scene Lifecycle - Test seams are set up in `create()` method - Each scene creates its own `window.__TEST__` object - Old scene's test seam may persist briefly after transition - Wait 1-2 seconds after transition before checking test seam ## Common Navigation Patterns - **MainMenu → GameScene**: Use `clickStartGame()` test command - **GameScene → LevelCompleteScene**: Automatic on exit reach - **GameScene → GameOverScene**: Automatic on timer expire - **Any scene → MainMenu**: Use `this.scene.start('MainMenu')` ## Resources - `references/transition-methods.md` - Scene transition methods and data passing - `references/navigation-testing.md` - Wait patterns, console log verification