M12: ljud, inställningar och release v0.1.0

tools/gensound syntetiserar 21 ljud: fyra stationsmelodier i klockklang
(en per station via melody-fältet eller banans id), ankomstjingel,
ding-dong vid inrullning, dörrsignal vid avgång, spärrens pip och
nekande, kiosk, toalett, lärt ord, bekräfta/varning, byte, personal,
vinst, förlust, flygplan, sorl och menymusik. sfx.go spelar effekter
utifrån vad som hänt i sim.Run sedan förra bildrutan. Ljudlagret har
huvudvolym × effekter/musik och byter inte slinga i onödan.
Inställningar (S på bankartan, sparas): volymer, språk sv/en som laddas
om direkt, fönsterskala, fullskärm (F11 överallt) och tangentöversikt.
Fönsterikon från genart. CHANGELOG.md. Tester för ljudfiler, melodival
och inställningar. Docs, wiki och skärmdumpar uppdaterade.

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

doc/mal-och-tester.md

@@ -139,6 +139,8 @@ att bygga på Linux som på Windows.
 | `internal/endless` | `TestPlanIsDeterministicAndValid`, `TestDestinationsNeedTrapAndRoute` | **M11:** samma seed → samma följd, annan seed → annan; varje mål har 1–4 rätta tåg och en fälla, nytt resmål, inga byten, aldrig samma station två gånger i rad; sällskapet växer och tidsgränsen krymper |
 | `internal/progress` | `TestNewGamePlusKeepsSkillsResetsItems` | **M11:** NG+ behåller skills, XP, skillpoäng och klarad story; nollställer items, utrustning och banresultat |
 | `internal/save` | `TestEndlessRecords` | **M11:** poänglistan sorterad, kapad till fem, "ny bästa" bara när toppen slås |
+| `internal/game` | `TestAllSoundsDecode`, `TestMelodyForIsStableAndKnown` | **M12:** alla ljud i `AllSounds` finns, avkodas och är minst 50 ms; melodin per bana är stabil och känd; ljudlagret är nil-säkert |
+| `internal/save` | `TestSettingsDefaultsAndNormalize` | **M12:** standardinställningar, klampning av volymer/skala, okänt språk blir sv, saknade inställningar fylls i |
 | `internal/level` | `TestToiletSides` | **M10d:** 005 och 008b har toaletter bara innanför, 007b på båda sidor, 007 och 008 bara utanför; innanför bara på banor med spärrar utan återvändo |
 | `internal/sim` | `TestJourneyWithTransfer`, `TestJourneyWrongTrainOnSecondLeg`, `TestChainLevelsLoad` | **M10:** bytet fortsätter omgången på nästa station med klocka, plånbok, sällskap och par-summa; vinst först på sista delbanan; fel håll på bytesstationen förlorar; delbanor laddas enskilt |
 | `internal/minigame` | `TestCarPickAlightingAndChoice`, `TestCrowdLevelNarrowsZone`, `TestRideCrowdLetPass` | Folk av först (för tidigt räknas), seedad trängsel med minst en lugn vagn, val; trängsel smalnar zonen; resan: kortare tid per station, passagerare som vill förbi, blockerade räknas |
@@ -167,7 +169,7 @@ att bygga på Linux som på Windows.
 | ~~M10d Toaletter innanför/utanför~~ ✓ | Toaletterna ligger på rätt sida av spärrarna per bana – finns, se tabellen ovan |
 | M10b Bussar och vägar | Bussar följer tidtabell och vägrutor; hållplatser bedöms som perronger; överstimulerande UI-reglaget påverkar bara presentationen |
 | ~~M11 Oändligt läge & NG+~~ ✓ | Målsekvens deterministisk per seed, giltiga mål med fälla, NG+ behåller skills men nollställer items, poänglista – finns, se tabellen ovan |
-| M12 Ljud & polish | Alla ljudfiler som refereras finns och går att avkoda; Windows-binär startar (manuellt) |
+| ~~M12 Ljud & polish~~ ✓ | Alla ljudfiler som refereras finns och går att avkoda, stationsmelodi per bana, inställningar normaliseras – finns, se tabellen ovan; Windows-binär startar (manuellt, kvar) |
 
 ### Acceptanskriterier för "klar"
 
@@ -188,7 +190,8 @@ En milstolpe är klar när:
 - [ ] Tomt kort tvingar till automaten; minispelet är begripligt första gången.
 - [ ] Minikartan fylls i när man går runt och nollställs vid ny bana.
 - [ ] Spara mitt i en bana, ladda, och få samma minispelsutfall.
-- [ ] Ljud spelas vid ankomst och avgång; inget knaster vid loop.
+- [ ] Ljud spelas vid ankomst (jingel + ding-dong) och avgång (stationsmelodi + dörrsignal); inget knaster när sorlet och menymusiken loopar.
+- [ ] Inställningarna (S) ändrar volym, språk, skala och fullskärm direkt och överlever omstart.
 - [ ] Samma sparfil fungerar på Linux och Windows.
 
 ### Kommandon

doc/roadmap.md

@@ -673,13 +673,37 @@ på **brasse-linux01-runnern** (label `linux-amd64`), aldrig på Pi5:n.
 - **Kvar till senare:** oändligt läge med byten (resor över två stationer),
   stationer som genereras vid körning (generatorn in i repot).
 
-### M12 – Ljud, polish och release
+### M12 – Ljud, polish och release ✓ (klar 2026-10-25)
 
 - Riktiga avgångsmelodier/ankomstjinglar (ersätter placeholders från M7b),
   utrop, effekter, musik; mixning och volyminställningar.
 - Inställningar (ljudnivåer, språk sv/en, skala, tangenter).
 - Windows-test på riktig maskin, ikon i exe:n, eventuell Gitea-CI med
   releaser enligt playbooken.
+- **Så blev det:** `tools/gensound` syntetiserar 21 ljud (egna
+  kompositioner, deterministiska): fyra **stationsmelodier** i
+  klockklang (`melody-a`–`d`, banans `melody`-fält eller vald efter id),
+  ankomstjingel, ding-dong vid inrullning, dörrsignal vid avgång,
+  spärrens pip/nekande, kiosk, toalett, lärt ord, bekräfta/varning, byte,
+  personal, vinst, förlust, flygplan, sorl och en menymusikslinga.
+  `internal/game/sfx.go` spelar effekterna utifrån vad som hänt i `sim.Run`
+  sedan förra bildrutan (räknare och tidsstämplar), tågfaserna i
+  `trains.go`. **Ljudlagret** har tre volymer (huvud × effekter resp.
+  musik/sorl) och byter inte slinga i onödan (menymusiken fortsätter
+  mellan karta, inställningar och listor). **Inställningar** (S på
+  bankartan, sparas i sparfilen): volymer, språk sv/en (texterna laddas om
+  direkt), fönsterskala 1–6 (0 = flaggan `-scale`), fullskärm (även F11
+  överallt), plus en tangentöversikt. **Fönsterikon** (`icon.png` från
+  genart) sätts vid start. **Release:** `CHANGELOG.md` och taggen
+  `v0.1.0` → versionerad release på Gitea (CI:n bygger redan Linux och
+  Windows). Windows-testet på riktig maskin och ikon inbakad i exe:n
+  (.syso) är kvar att göra manuellt.
+- **Klar när:** alla ljud finns och avkodas (`game.TestAllSoundsDecode`),
+  stationsmelodin är stabil per bana (`TestMelodyForIsStableAndKnown`),
+  inställningar får standardvärden och normaliseras
+  (`save.TestSettingsDefaultsAndNormalize`), `melody`-fältet valideras. ✓
+- **Kvar till senare:** ikon i exe:n (.syso), omdefinierbara tangenter,
+  riktiga inspelningar, Windows-test på riktig maskin (Björn).
 
 ## Prioritering
 

doc/spelbeskrivning.md

@@ -283,6 +283,7 @@ från skills i skill tree, och från unika skills man får av sidouppdrag.
 | "flera stopp och byten" | En resa är en kedja av banfiler (`next` → delbana med `kind: "leg"`). Samma omgång fortsätter på nästa station med klocka, plånbok och sällskap; resmålet i HUD:en visas "via" bytesstationen. Vilken bytesstation som gäller bestämmer banan – spelaren väljer tåg, inte rutt | Fri ruttplanering (välj själv var man byter) är en möjlig utbyggnad |
 | "slutar när man ska tillbaka till flygplatsen" | Sista huvudbanan (008) går Tokyo → Nippori → Narita flygplats med Keisei. När den klaras första gången visas hemresan: planet lyfter, resan summeras, eftertexter | Slutet går att se igen via `-ending` |
 | Buss | Uppskjuten till M10b (vägrutor, hållplatser, egen sprite) | |
+| "De ikoniska melodierna" | Egna syntetiserade stationsmelodier i klockklang (fyra stycken, en per station) – riktiga JR-melodier är upphovsrättsskyddade och spelas inte in | Byt filerna i `resources/sound/` om egna inspelningar finns |
 | "Oändligt läge … målen är slumpade" | Målen är storyns stationer med lottade resmål (samma labyrint, samma tåg, nytt resmål avgör vilket tåg som är rätt), seedat; sällskapet växer och tidsgränsen krymper per mål; omgången slutar vid första förlust och hamnar i en egen poänglista | Slumpade labyrinter vid körning kan komma senare |
 | "New Game+ … behåll alla dina skills" | Skills, XP och språkkunskap behålls; items, stjärnor, pengar och debuffar nollställs; sällskapet är en person större per NG+-varv | |
 | Repo-namnet | Arbetsnamnet var "jp-subway-pussel"; Björn döpte Gitea-repot till **metro-puzzle-jp** (2026-10-23), så repo, modul, binär och titel heter så | Spelets visningsnamn "Metro Puzzle JP" kan ändras fritt i `resources/text/*.json` |