# Morse Code Practice Game 🎮

A terminal-based morse code practice game built with Deno. Improve your morse code translation skills through interactive gameplay with multiple difficulty levels and comprehensive statistics tracking.

## Features

- **Multiple Difficulty Modes**
  - 🟢 Easy: Single letters (A-Z)
  - 🟡 Medium: Single numbers (0-9)
  - 🟣 Hard: Common words
  - 🔴 Expert: Short phrases

- **Interactive TUI Interface**
  - Beautiful terminal UI with colors and tables
  - Real-time timer for each round
  - Immediate feedback on answers
  - Progress tracking with streak counter

- **Statistics Tracking**
  - Overall accuracy and performance metrics
  - Mode-specific statistics
  - Best streak tracking
  - Historical game data
  - Average time per round
  - Stats saved locally in project folder

- **Smart Feedback**
  - Immediate feedback on answers
  - Shows what your morse code translates to when incorrect
  - Helps you learn from mistakes

- **Flexible CLI**
  - Interactive menu mode (default)
  - Quick play mode with command-line arguments
  - Stats viewer
  - Built-in morse code reference

## Installation

Make sure you have [Deno](https://deno.land/) installed.

```bash
# Clone or download this repository
cd morse-game

# Make the script executable (optional)
chmod +x main.ts
```

## Usage

### Interactive Mode (Default)

Run the game and navigate through the menu:

```bash
deno task start
# or
deno run --allow-read --allow-write --allow-env main.ts
```

### Quick Play Mode

Start a game directly with custom settings:

```bash
# Play 5 rounds of letters mode with 20 seconds per round
deno task start play --mode letters --rounds 5 --time 20

# Play expert mode
deno task start play --mode phrases --rounds 10 --time 45
```

Options:
- `-m, --mode <mode>` - Game mode: `letters`, `numbers`, `words`, or `phrases` (default: letters)
- `-r, --rounds <number>` - Number of rounds (default: 10)
- `-t, --time <seconds>` - Seconds per round (default: 30)

### View Statistics

```bash
deno task start stats
```

### Show Reference

Display a morse code reference chart:

```bash
deno task start reference
```

### Reset Statistics

```bash
deno task start reset
```

## How to Play

1. **Select a difficulty mode** - Choose from letters, numbers, words, or phrases
2. **Configure your game** - Set the number of rounds and time per round
3. **Translate to morse code** - You'll be shown a challenge (letter, number, word, or phrase)
4. **Enter your answer** - Type the morse code using:
   - `.` (dot) for short signals
   - `-` (dash) for long signals
   - Space to separate letters
   - `/` to separate words
5. **Get instant feedback** - See if you got it right and track your streak
6. **Review your performance** - After all rounds, view detailed statistics

## Morse Code Basics

- Use `.` for dots and `-` for dashes
- Separate letters with spaces
- Use `/` for word boundaries
- Example: `HELLO` = `.... . .-.. .-.. ---`
- Example: `SOS` = `... --- ...`

## Statistics

The game tracks:
- Total games played
- Total rounds completed
- Correct and incorrect answers
- Overall accuracy percentage
- Average time per round
- Best streak (consecutive correct answers)
- Per-mode statistics

Stats are saved to `./data/stats.json` in the project directory.

When you answer incorrectly, the game shows what your morse code input actually translates to, helping you understand and learn from your mistakes.

## Development

```bash
# Run in watch mode for development
deno task dev

# Run with specific permissions
deno run --allow-read --allow-write --allow-env main.ts
```

## Project Structure

```
morse-game/
├── main.ts          # CLI entry point and command parser
├── game.ts          # Game logic and session management
├── morse.ts         # Morse code translation utilities
├── stats.ts         # Statistics tracking and persistence
├── ui.ts            # TUI interface and menus
├── deno.json        # Deno configuration and dependencies
└── README.md        # This file
```

## Dependencies

- [@cliffy/command](https://jsr.io/@cliffy/command) - CLI framework
- [@cliffy/prompt](https://jsr.io/@cliffy/prompt) - Interactive prompts
- [@cliffy/ansi](https://jsr.io/@cliffy/ansi) - ANSI colors and formatting
- [@cliffy/table](https://jsr.io/@cliffy/table) - Table rendering
- [@std/path](https://jsr.io/@std/path) - Path utilities
- [@std/fs](https://jsr.io/@std/fs) - File system utilities

## License

MIT

## Contributing

Feel free to open issues or submit pull requests!

---

**73** (Best regards in morse code) 📡