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>

internal/sim/run.go

@@ -1,6 +1,9 @@
 package sim
 
-import "gitea.brasse-pc.eu/brasse/metro-puzzle-jp/internal/level"
+import (
+	"gitea.brasse-pc.eu/brasse/metro-puzzle-jp/internal/lang"
+	"gitea.brasse-pc.eu/brasse/metro-puzzle-jp/internal/level"
+)
 
 // Outcome är hur en banomgång står sig.
 type Outcome int
@@ -42,15 +45,42 @@ type Run struct {
 	DeniedAt   float64 // när spärren senast nekade (för HUD); < 0 = aldrig
 	Outcome    Outcome
 	Boarded    *level.Train
+
+	// Språk: ordboken, spelarens kunskap (delas mellan banor) och hjälpen.
+	Dict      *lang.Dictionary
+	Know      *lang.Knowledge
+	Help      HelpState
+	Revealed  map[level.Point]bool // skyltar som översatts helt via hjälp
+	Learned   string               // senast inlärda ord (för HUD-notis)
+	LearnedAt float64              // när det lärdes in; < 0 = aldrig
 }
 
-// NewRun startar banan med spelaren på startrutan.
-func NewRun(l *level.Level, speed float64) *Run {
+// HelpState är en pågående "fråga någon om hjälp".
+type HelpState struct {
+	Active    bool
+	At        level.Point // skyltrutan hjälpen gäller
+	Remaining float64
+	Total     float64
+}
+
+// NewRun startar banan med spelaren på startrutan. dict och know får vara
+// nil (tom ordbok respektive ny kunskap).
+func NewRun(l *level.Level, speed float64, dict *lang.Dictionary, know *lang.Knowledge) *Run {
+	if dict == nil {
+		dict = lang.NewDictionary()
+	}
+	if know == nil {
+		know = lang.NewKnowledge()
+	}
 	return &Run{
-		Level:    l,
-		Player:   NewMover(l.SpawnPoint(), speed),
-		Card:     Card{Balance: StartBalanceYen},
-		DeniedAt: -1,
+		Level:     l,
+		Player:    NewMover(l.SpawnPoint(), speed),
+		Card:      Card{Balance: StartBalanceYen},
+		DeniedAt:  -1,
+		Dict:      dict,
+		Know:      know,
+		Revealed:  map[level.Point]bool{},
+		LearnedAt: -1,
 	}
 }
 
@@ -82,6 +112,7 @@ func (r *Run) Step(dt float64, want Dir, board bool) {
 	before := r.Player.Tile
 	wasGate := r.inGate()
 	r.Steps += r.Player.Step(dt, want, r.CanEnter)
+	r.stepHelp(dt)
 	if r.Player.Tile != before && r.inGate() && !wasGate {
 		r.Card.Pay(r.Level.FareYen)
 		r.GatePasses++
@@ -136,3 +167,52 @@ func (r *Run) TrainVisible(t level.Tile) bool {
 	at, _ := tr.Schedule.Status(r.Time)
 	return at
 }
+
+// AskHelp börjar fråga en förbipasserande om vad skylten betyder. Kräver att
+// spelaren står stilla på en skylt som inte redan är avslöjad. Tiden beror
+// på japanska-nivån (lang.HelpSeconds).
+func (r *Run) AskHelp() bool {
+	sg := r.SignHere()
+	if sg == nil || r.Help.Active || r.Revealed[r.Player.Tile] || r.Outcome != Ongoing {
+		return false
+	}
+	secs := lang.HelpSeconds(r.Know.Level())
+	r.Help = HelpState{Active: true, At: r.Player.Tile, Remaining: secs, Total: secs}
+	return true
+}
+
+// stepHelp räknar ned hjälpen; att gå därifrån avbryter. När den är klar
+// avslöjas skylten och spelaren lär sig det första okända ordet på den.
+func (r *Run) stepHelp(dt float64) {
+	if !r.Help.Active {
+		return
+	}
+	if r.Player.Moving() || r.Player.Tile != r.Help.At {
+		r.Help = HelpState{}
+		return
+	}
+	r.Help.Remaining -= dt
+	if r.Help.Remaining > 0 {
+		return
+	}
+	r.Revealed[r.Help.At] = true
+	r.Know.Helps++
+	if sg := r.Level.SignAt(r.Help.At); sg != nil {
+		if w := lang.FirstUnknownWord(r.Dict, r.Know, sg.Text["ja"]); w != "" {
+			r.Know.Learn(w)
+			r.Learned, r.LearnedAt = w, r.Time
+		}
+	}
+	r.Help = HelpState{}
+}
+
+// SignRevealed rapporterar om skylten på rutan är helt översatt.
+func (r *Run) SignRevealed(p level.Point) bool { return r.Revealed[p] }
+
+// HelpProgress är 0..1 för en pågående hjälp.
+func (r *Run) HelpProgress() float64 {
+	if !r.Help.Active || r.Help.Total <= 0 {
+		return 0
+	}
+	return 1 - r.Help.Remaining/r.Help.Total
+}