Terra Incognita

⚠️ Ouvrir index.html par double-clic ne fonctionne plus. Le jeu est découpé en modules ES natifs, que les navigateurs ne chargent pas depuis file://. Lancez npm run dev et ouvrez l'adresse affichée.

Wargame à hexagones au tour par tour : les Bleus contre les Rouges, deux armées de même force, sur une carte tirée au hasard à chaque partie (forêts, rivières, routes, villes). Huit tours, contre une IA ou à deux sur le même écran. Construit sur le moteur du Saillant (branche main).

Prérequis

Node 22 ou plus. Aucune dépendance à installer : pas de bundler, pas de transpileur.

Lancer le jeu

npm run dev

Sert le dossier en local avec npx serve . (téléchargé au premier lancement). N'importe quel serveur statique fait l'affaire, par exemple python3 -m http.server.

Tester

npm test          # node --test : tests de règles dans tests/*.test.js
npm run test:watch

Les tests couvrent la couche src/rules/ (règles pures, sans DOM ni horloge) avec des tests de comportement formulés dans le vocabulaire du jeu.

Organisation

Dossier	Rôle
src/config.js	Constantes : terrains, génération de carte, ordre de bataille, table des résultats, seuils, IA, délais
src/rules/	Règles pures : grille, génération de carte, déploiement, mouvement, contrôle, ravitaillement, combat, victoire, tours
src/state/	État partagé (store), requêtes liées à la partie en cours, sauvegarde
src/render/	Tout ce qui écrit à l'écran : carte SVG, panneau, piste, fenêtres, son
src/input/	Écouteurs d'événements : carte, boutons, fenêtres, zoom, son
src/loop/	Orchestration : phases, ordres des joueurs, IA
src/main.js	Point d'entrée : câblage, dés, premier affichage
styles.css	Feuille de style
docs/decisions.md	Décisions du refactor et questions ouvertes
docs/prd/	Spécifications : extraction du cœur, Terra Incognita