map-generator/README.md

Map Generator — Chargement des scripts et tests

Résumé rapide

• Le projet charge Bootstrap (bundle) puis un petit loader qui injecte les scripts JS organisés dans public/assets/js.

Ordre recommandé de chargement (actuel)

1. bundle de dépendances (Bootstrap JS) — inclus via CDN ou assets
2. /assets/js/core/dom-ready.js — expose window.MG.domReady
3. /assets/js/core/geom.js — expose window.MG.geom (axialToPixel, computeZoom, computePanOffset)
4. /assets/js/ui/header.js — interactions de l'en-tête
5. /assets/js/editor/map-editor.js — éditeur de carte (utilise window.MG)

Notes

• Les helpers sont exposés sur window.MG pour éviter les problèmes d'absence de bundler.
• Le loader actuel est un script simple qui insère les fichiers dans l'ordre. Pour un projet JavaScript plus gros, il est recommandé d'utiliser un bundler (Vite, Webpack ou Rollup). Avantages: tree-shaking, modules ES, meilleure gestion des dépendances, sourcemaps et tests plus simples.

Exécution des tests unitaires JS

1. Installer les dépendances dev: npm install
2. Lancer les tests: npm test

Prochaines améliorations possibles

• Migrer les fichiers JS vers modules ES et ajouter un build step (Vite recommandé pour dev rapide).
• Ajouter tests pour les interactions DOM (jest + testing-library) et tests e2e si nécessaire.