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/mal-och-tester.md

@@ -56,6 +56,9 @@ att bygga på Linux som på Windows.
   minispel och event-timing att testa deterministiskt.
 - **Inga tester kräver display.** Smoke-testet av själva fönstret körs
   manuellt (eller på en maskin med skärm) med `-smoke`.
+- **Innehållet testas mot ordboken.** Ny japansk text i en bana som inte
+  finns i `jp-dictionary.json` fäller `go test` – det är så vi garanterar
+  att skyltsystemet alltid kan översätta allt spelaren kan möta.
 
 ### Testnivåer
 
@@ -89,6 +92,12 @@ att bygga på Linux som på Windows.
 | `internal/sim` | `TestBotWinsLevel001` | **Simuleringstest M2:** bot går kortaste vägen, passerar spärren (saldo dras en gång), väntar in tåget, kliver på → vinst; Step är no-op efteråt |
 | `internal/sim` | `TestBotLosesOnWrongTrain`, `TestBoardOnlyWhenTrainPresent` | Fel tåg → förlust; Enter utan tåg inne gör inget |
 | `internal/sim` | `TestGateNeedsCardBalance`, `TestSignHereOnlyWhenStill` | Tomt kort stoppas och registreras för HUD; mellan två spärrutor gratis; skylt visas bara stilla |
+| `internal/lang` | `TestTokenizeLongestMatchAndKinds` | Längsta matchning, ord/okänt/övrigt, `Unknown` pekar ut vad ordboken saknar |
+| `internal/lang` | `TestRenderPartialTranslation`, `TestKanaReadingWithoutMeaning`, `TestReadingsShownFromLevel2` | **Samma skylt visar exakt det spelaren kan**: kända ord översatta, okända kvar, kana som romaji när kana kan, läsningar från nivå 2 |
+| `internal/lang` | `TestLearnUnlocksKanaAndLevels`, `TestFirstUnknownWord` | Nivåformeln, kana låses upp efter tre kana-ord, vilket ord hjälpen lär ut |
+| `internal/lang` | `TestHelpSeconds`, `TestEnglishShareAndDeterminism` | Hjälptiden sjunker med nivån men inte under golvet; engelska-andelen per svårighet (1 = alltid, 5 = aldrig), deterministisk, ~60 % på svårighet 2 |
+| `internal/lang` | `TestParseDictionaryValidation`, `TestShippedDictionary`, `TestAllJapaneseInLevelsIsInDictionary` | Ordboken är komplett per post och **täcker all japanska i banorna** |
+| `internal/sim` | `TestAskHelpRevealsSignAndTeachesWord`, `TestHelpIsCancelledByWalkingAway`, `TestNoHelpOffSign` | Hjälpen tar rätt tid, avslöjar skylten, lär första okända ordet; avbryts när man går; kräver skylt |
 | `internal/archtest` | `TestOnlyPresentationPackagesImportEbitengine` | Beroenderegeln ovan |
 
 ### Planerade tester per milstolpe
@@ -97,7 +106,7 @@ att bygga på Linux som på Windows.
 |------------------------|----------------------------------------|
 | ~~M1 Rörelse & kamera~~ ✓ | Kollision mot vägg, rörelse i 4 riktningar, kamera klampas till kartan – finns, se tabellen ovan |
 | ~~M2 Stationen~~ ✓ | Tidtabell, spärr med/utan saldo, vinst/förlust, bot klarar bana 001 headless – finns, se tabellen ovan |
-| M3 Japanska & skyltar | Delvis översättning ger exakt de ord spelaren kan; andel engelska följer svårighetstabellen; ordboken: alla nycklar har kana/romaji/en/sv; alla skyltord i banorna finns i ordboken; hjälptid = f(japanska-nivå) |
+| ~~M3 Japanska & skyltar~~ ✓ | Delvis översättning, engelska-andel, ordbokens fullständighet och täckning, hjälptid – finns, se tabellen ovan |
 | M4 Lämmeltåget | Mätare sjunker med rätt takt; event-frekvens ökar med gruppstorlek; event väljs deterministiskt per seed |
 | M5 Minikarta | Upptäckta rutor markeras, återställs per bana; avgångar syns från start |
 | M6 Kort/biljetter/minispel | Saldo dras i spärr; tomt kort → automatkrav; biljettminispel: rätt/fel biljett; telefon-skanning misslyckas med given procent per seed; batteri tar bara slut över tröskeltid |

doc/plan.md

@@ -32,7 +32,7 @@ brasse-linux01-runnern, inte Pi5:n.
 
 ## Milstolpar
 
-M0 skelett ✓ → M1 rörelse/kamera ✓ → M2 tåg/spärrar/vinst ✓ → M3 japanska/skyltar
+M0 skelett ✓ → M1 rörelse/kamera ✓ → M2 tåg/spärrar/vinst ✓ → M3 japanska/skyltar ✓
 → M4 lämmeltåget → M5 minikarta → M6 kort/biljetter/minispel → M7
 svårighet/poäng/debuffar → M8 progression/sparfiler → M9 navigeringslägen →
 M10 story-innehåll → M11 oändligt läge/NG+ → M12 ljud/polish/release.
@@ -58,7 +58,8 @@ Vad som ska vara testat per milstolpe: [mal-och-tester.md](mal-och-tester.md).
 
 - ~~Repo-namn~~ – beslutat: `metro-puzzle-jp` (Gitea 2026-10-23). Visningsnamnet "Metro Puzzle JP" är bara text i `resources/text/`.
 - "Game box-liknande" banval: tolkat som spelbräde/världskarta – stämmer det?
-- Font: PixelMplus (fler kanji, 10/12 px) eller Misaki (8 px, tajtare)?
-  Avgörs i M3 när skyltar renderas på riktigt.
+- ~~Font~~ – beslutat: PixelMplus 10/12 px (M3).
+- Hur ska spelaren lära sig ord utöver "fråga om hjälp"? Förslag: att klara
+  en bana lär ut resmålets namn; skill tree i M8 kan ge kana direkt.
 - Ska Oändligt läge dela sparfil med story eller ha egen?
 - Hur många huvudbanor siktar vi på i storyn? (Påverkar M10:s omfattning.)

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