M3: japanska skyltar – pixelfont, ordbok, kunskap, delvis översättning, hjälp

- resources/text/fonts: PixelMplus 10/12 px (M+ FONT LICENSE) + licens;
  all text ritas via text/v2 på heltalspositioner, debugfonten är borta
- internal/lang: ordbok (60 ord, validerad), tokenisering med längsta
  matchning, Knowledge (ord + kana, nivå 0–5, hintar), Render (kända ord
  markerade/översatta, okända kvar, kana som romaji), EnglishShare/
  ShowEnglish per svårighet (deterministiskt per bana+position),
  HelpSeconds; datatest kräver att all japanska i banorna finns i ordboken
- sim.Run: AskHelp (H) med väntetid efter nivå, avbryts om man går,
  avslöjar skylten och lär första okända ordet; Knowledge delas mellan banor
- game: skylt- och avgångstavlor renderade genom kunskapen med färgkodning,
  engelsk rad på lätta banor, hjälp-förlopp, "Nytt ord"-notis, HUD visar
  resmålet på japanska från nivå 1 och japanska-nivå; meny med svårighet;
  pixelbaserad radbrytning av färgade textsegment; -know-flagga
- tools/shots: tre skyltbilder (skylt, hjälp, nytt ord) med förkunskap
- docs/README/wiki uppdaterade

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

doc/roadmap.md

@@ -14,7 +14,7 @@ de styr hur milstolparna byggs.
 | Speldata | **JSON** i `resources/data/` | Läsbart, diffbart i git, `encoding/json` i standardbiblioteket. Byt till TOML bara om kommentarer blir ett verkligt behov. |
 | Bygg | **`go run ./tools/build`** | Ett Go-program i stället för make/bash/PowerShell. Samma kommando på alla plattformar. Stämplar version och läge, kopierar resurser. |
 | IDE | **VS Code + tillägget `golang.go`** | `.vscode/tasks.json` (bygg/test) och `.vscode/launch.json` (F5 med delve). Tillägget installerar delve åt dig. |
-| Font | **PixelMplus** (10/12 px) eller **Misaki** (8 px) via `ebiten/v2/text/v2` | Pixelfonter med kana **och kanji**. Fri licens. Krävs för att skyltar ska kunna visas på riktigt. Beslut i M3. |
+| Font | **PixelMplus** 10/12 px via `ebiten/v2/text/v2` | Pixelfont med kana **och kanji** (JIS 1+2), M+ FONT LICENSE. Valdes framför Misaki (8 px) för läsbarhetens skull – 10 px kanji går att läsa vid 3–4× skala. |
 | Ljud | `ebiten/v2/audio` med OGG Vorbis (musik, jinglar) och WAV (korta effekter) | Ingår i Ebitengine, inga externa bibliotek. |
 | Slump | `math/rand/v2` (PCG) genom `internal/rng` | Seedbart, deterministiskt, del-seeds per kontext. |
 | Sparfiler | JSON i `os.UserConfigDir()/metro-puzzle-jp/` | Rätt plats på både Linux (`~/.config`) och Windows (`%AppData%`). |
@@ -58,7 +58,8 @@ metro-puzzle-jp/
 │   ├── res/                hittar och läser resources/ (ren Go)
 │   ├── rng/                seedad slump (ren Go)
 │   ├── level/              banformat, validering, BFS (ren Go)
-│   ├── sim/                rutbaserad rörelse, kollision, kamera, banomgång (Run: klocka, kort, spärrar, tåg) – ren Go
+│   ├── sim/                rutbaserad rörelse, kollision, kamera, banomgång (Run: klocka, kort, spärrar, tåg, hjälp) – ren Go
+│   ├── lang/               ordbok, tokenisering, kunskap, delvis översättning, engelska-andel, hjälptid – ren Go
 │   ├── game/               Ebitengine-loop, scener, input, rendering, skriptläge  ← får använda Ebitengine
 │   ├── archtest/           beroenderegler
 │   └── …                   kommande: lang/, nav/, score/, save/, minigame/, ui/, audio/
@@ -68,7 +69,7 @@ metro-puzzle-jp/
 ├── resources/              kopieras bredvid binären vid bygge
 │   ├── sprites/            bilder, tilesets, UI
 │   ├── sound/              OGG/WAV
-│   ├── text/               sv.json, en.json, jp-dictionary.json, fonts/
+│   ├── text/               sv.json, en.json, jp-dictionary.json, fonts/PixelMplus*.ttf
 │   └── data/               levels/, items, skills (JSON)
 ├── doc/                    denna dokumentation (doc/img/ = skärmdumpar från tools/shots)
 ├── .gitea/workflows/       CI: test + release-zippar för linux/windows på brasse-linux01-runnern
@@ -162,20 +163,40 @@ på **brasse-linux01-runnern** (label `linux-amd64`), aldrig på Pi5:n.
 - **Klar när:** `TestBotWinsLevel001` låter en bot gå kortaste vägen,
   passera spärren, vänta in tåget och kliva på – headless. ✓
 
-### M3 – Japanska och skyltsystemet
+### M3 – Japanska och skyltsystemet ✓ (klar 2026-10-23)
 
 - **Mål:** spelets identitet – skyltar på japanska som man lär sig läsa.
-- Pixelfont med kana + kanji (beslut PixelMplus/Misaki, licens in i repot).
-- Kunskapsmodell: vilka tecken/ord spelaren kan. Skyltar renderas med
-  delvis översättning, egen färg för det som är översatt, interaktion för
-  att se översättning.
-- Andel engelska på skyltar styrs av banans svårighet.
-- "Fråga en japan": NPC-interaktion med väntetid beroende på japanska-nivå.
-- Hintar i UI/bana skalar med japanska-nivå.
-- **Teknik:** `internal/lang` (ordbok, kunskap, översättningslogik – ren
-  Go), `text/v2` i `internal/game`.
+- **Font:** PixelMplus 10/12 px (M+ FONT LICENSE, i repot under
+  `resources/text/fonts/`), ritad med `text/v2` på heltalspositioner. All
+  text i spelet går via den; debugfonten är borta.
+- **Ordbok** (`resources/text/jp-dictionary.json`, 60 ord): japanska →
+  kana, romaji, sv, en, tier. Ett test kräver att all japanska i banorna
+  (skyltar, namn, resmål, linjer) finns i ordboken.
+- **Kunskapsmodell** (`lang.Knowledge`): kända ord + kana-läsning.
+  Nivå 0–5 = kända ord / 4. Kana låses upp efter tre kända kana-ord.
+- **Rendering** (`lang.Render`): skylten tokeniseras med längsta matchning;
+  kända ord markeras i gult i originalet och översätts i raden under,
+  okända står kvar på japanska i grått, kana-ord som kan läsas men inte
+  förstås visas som romaji i grönt. Avgångstavlan på perrongen är en skylt
+  som alla andra.
+- **Engelska efter svårighet** (`lang.ShowEnglish`): andel skyltar med
+  engelsk rad 100/60/30/10/0 % för svårighet 1–5, deterministiskt per
+  bana + position.
+- **Fråga någon om hjälp** (H): tar `lang.HelpSeconds(nivå)` sekunder
+  (6 s på nivå 0, ned till 2 s), avbryts om man går, avslöjar hela skylten
+  och lär spelaren det första okända ordet på den. Notis "Nytt ord".
+- **Hintar efter nivå:** från nivå 1 visar HUD:en resmålet på japanska (att
+  matcha mot skyltarna), från nivå 2 visas läsningen efter kända ord.
+- Kunskapen följer med mellan banor under en session (`Game.Know`); att
+  spara den på disk är M8. Flaggan `-know ord,ord` ger förkunskap för
+  tester och skärmdumpar.
+- **Teknik:** `internal/lang` (ren Go, 11 tester + datatester), `sim.Run`
+  (hjälp-tillstånd, avslöjade skyltar), `internal/game/text.go`
+  (pixelbaserad radbrytning av färgade textsegment).
 - **Klar när:** samma skylt visar olika mycket beroende på kunskap, och det
-  är testat; bana 001 spelas med japanska skyltar.
+  är testat (`TestRenderPartialTranslation`, `TestKanaReadingWithoutMeaning`,
+  `TestAskHelpRevealsSignAndTeachesWord`); bana 001 spelas med japanska
+  skyltar. ✓
 
 ### M4 – Lämmeltåget och mätarna