Add multiplayer bots, typing languages, and rework the UI layout

Multiplayer
- Quick match: POST /api/multiplayer/quickmatch returns whichever room is
  still filling, or opens one. Players never see a room code; joining by
  code stays for racing specific people.
- Bots fill quick-match rooms after a short wait so a new game is never an
  empty lobby. They only ever join quick-match rooms, never a room opened
  by code. One or two per room, drawn from separate ~40 and ~80 WPM tiers so
  two bots are never near each other's pace, and they stall to correct
  mistakes rather than typing a clean straight line.
- Live player count via GET /api/multiplayer/online, shown on the
  Multiplayer control and under the main menu's Multiplayer button.
- Per-racer colours: you are the theme accent, opponents take distinct hues
  that stay the same from lobby to race.
- The countdown no longer holds the room lock for its full three seconds,
  which is what reset clients mid-countdown.

Typing languages
- 16 languages for the generated-word modes, each with its own
  high-frequency vocabulary rather than a translation of the English list.
- Picker in the top-right rail; non-English uses its own list at every
  difficulty tier instead of falling back to English words.

Fix UTF-8 accuracy in the game core
- update_game_state mixed byte and character counts: total_characters_typed
  accumulated byte-length deltas while total_correct_characters compared a
  char index against that byte count. Equal on ASCII, so it went unnoticed;
  a correctly typed Spanish passage scored 6%. The old byte slicing would
  also have panicked if an index landed inside a multi-byte character.
  Rewritten char-based, with regression tests.

Programming mode
- Replaced prose about programming with real code: 26 syntax-highlighted
  snippets across JavaScript, Python, Rust, C/Go/Java and shell. Single-line
  by necessity, since the typing input is a single-line field.

Layout and readability
- One icon rail arrangement on every screen: Settings/Store under the
  wordmark, Language/Theme/Friends/Account top-right, Stats/Leaderboard/
  Multiplayer bottom-right.
- Main menu: mode picker moved out of the Single Player button, which it was
  notching a divider through and pushing the label off-centre.
- Escape returns to the menu, closing any open popover first, and confirms
  before abandoning a live race.
- Split --text-color and --sub-color per theme; they shared one value that
  measured 3.65:1 against the background, below the 4.5:1 body-text floor.
- Semantic colours used in exactly one place each: gold for a personal best,
  amber for the race countdown and the mobile-result badge.
- Passage now sits in the same place on the typing and end screens, and its
  column is a whole number of characters wide so wrapping cannot leave a
  permanent gap on the right.
- End screen: keystrokes and a correct/wrong/extra/missed split, attribution
  carried over from the typing screen, and a graph with a separate error
  axis, axis titles including seconds, and smoothed lines.

1 files changed, 65 insertions, 55 deletions

diff --git a/README.md b/README.md
index aad3b85..991d2e5 100644..100755
--- a/README.md
+++ b/README.md
@@ -1,77 +1,87 @@
-# _Typerpunk_
+# TyperPunk
 
-**_Typerpunk_** is a simple typing game written in Rust, where players are challenged to type sentences as quickly as possible. The game calculates the player's typing speed in Words Per Minute (WPM) and time taken.
+A modern typing test in your terminal (CLI) and in the browser (Web).
 
-> NOTE: Game is still in early stages of development. Plenty of features will be implemented such as programming related minigames, difficulty/custom settings and multiplayer to name a few. There are also plans to make this into not just a "cmdline" game but also have a fully fledged website and desktop gui client as well.
+## Quick Start
 
-## Features (beta)
+- **CLI (Terminal UI)**
+  ```bash
+  # Clone and enter
+  git clone https://github.com/yourusername/typerpunk.git
+  cd typerpunk
 
-- Randomly selects sentences from a provided list for the player to type.
-- Calculates typing speed in Words Per Minute (WPM).
-- Color-coded feedback on typed characters (green for correct, red for incorrect, gray for untyped).
+  # Install for CLI (builds TUI and optionally merges dataset packs)
+  ./install.sh
 
-## Installation
+  # Run CLI
+  cargo run --package typerpunk-tui
+  ```
 
-To play **_Typerpunk_**, make sure you have Rust installed on your system. You can install Rust from [rustup.rs](https://rustup.rs/).
+- **Web**
+  ```bash
+  # From repo root: builds WASM and starts the static dev server
+  ./web/launch.sh
+  ```
+  Opens http://localhost:4173
 
-- Can also use this to quickly download rust:
+## Dataset (shared by CLI and Web)
 
-```bash
-curl https://sh.rustup.rs -sSf | sh -s
-```
+- **Offline (recommended)**
+  - Add texts to `data/packs/*.json` with fields:
+    ```json
+    { "category": "programming", "content": "80-400 chars…", "attribution": "Author" }
+    ```
+  - Merge packs into the shared `texts.json` at repo root:
+    ```bash
+    node scripts/merge_packs.js
+    ```
 
-- Clone this repository:
+- **Online (optional, web only)**
+  - Host a `texts.json` and set a URL in the page (e.g., `web/index.html`):
+    ```html
+    <script>window.TYPERPUNK_TEXTS_URL = "https://your.cdn/path/to/texts.json";</script>
+    ```
+  - The web app uses the online dataset if reachable; otherwise it falls back to the bundled file.
 
-```bash
-git clone https://github.com/srdusr/typerpunk.git
-```
+Notes:
+- `web/launch.sh` copies the root `texts.json` into `web/src/data/texts.json` for local dev.
+- A small fallback dataset is kept in `web/src/data/texts.json`.
 
-- Navigate to the project directory:
+## CLI Keys
 
-```bash
-cd typerpunk
-```
+- Start: Enter
+- Quit: Esc
+- Change category: Left/Right
+- Delete word: Ctrl+Backspace / Alt+Backspace / Ctrl+H / Ctrl+W
 
-- Build and run the game:
+## Scripts Scope
 
-```bash
-cargo run --release
-```
+- `install.sh`: CLI-focused (Rust toolchain, dataset merge via Node, builds TUI)
+- `web/launch.sh`: Web dev workflow (WASM build + zero-dependency static server)
 
-## How to Play
+No npm packages are used anywhere in this repo. Node.js is used only as a
+runtime for small built-in-module-only scripts (`scripts/merge_packs.js`,
+`web/serve.mjs`); nothing is ever installed from the npm registry.
 
-- Run the executable:
+## Repo Layout
 
-```bash
-./target/release/typerpunk
 ```
-
-- Or put the executable into your path. Example:
-
-```bash
-sudo cp target/release/typerpunk /usr/local/bin
+typerpunk/
+├── Cargo.toml            # Workspace configuration
+├── crates/
+│   ├── core/            # Shared core functionality
+│   └── tui/             # Terminal UI implementation
+├── data/
+│   └── packs/           # Offline dataset packs
+├── web/                 # Web app (plain HTML/CSS/JS, no build step)
+│   ├── src/
+│   ├── index.html
+│   └── serve.mjs
+├── scripts/
+│   └── merge_packs.js   # Merge packs into texts.json
+└── README.md
 ```
 
-### Gameplay:
-
-When the game starts, you will see a main menu.  
-Press `Enter` to begin the typing challenge.  
-Random text will be shown and game will only start as soon as you start typing.  
-Press `Enter` when you have finished typing the sentence.  
-The game will display your Words Per Minute (WPM) and time taken.  
-To play again, press `Enter` at the End screen.  
-To quit the game, press `Esc` at any time.
-
-### Controls:
-
-`Enter`: Submit typed sentence or proceed in menus.  
-`Backspace`: Delete the last character.  
-`Esc`: Quit the game or go back to the main menu.
-
-## Contributing
-
-Contributions are welcome! If you have any ideas, bug fixes, or improvements, feel free to open an issue or submit a pull request.
-
 ## License
 
-This project is licensed under the MIT License - see the LICENSE file for details.
+MIT