docs(INTEGRATION): documenter les paramètres advantage/disadvantage externes de resolve_weapon_attack #3

New issue

Open

opened 2026-07-02 05:53:51 +00:00 by Reliodas · 0 comments

Reliodas commented

2026-07-02 05:53:51 +00:00

Owner

Constat d'audit (2026-07-02). La 1.17.0 a ajouté advantage/disadvantage (sources externes, défaut false) à RulesEngine.resolve_weapon_attack et au wrapper DndRules, mais docs/INTEGRATION.md (sections FR et EN) n'en parle pas. C'est pourtant une capacité pensée pour le consommateur (portée longue, couverture gérées côté jeu).

À faire :

Ajouter la signature complète et un court exemple (annulation mutuelle avantage+désavantage → jet normal) dans les deux langues, aligné sur la sémantique de Combat.resolve_attack().
La garde d'arité de tests/unit/test_consumer_api.gd parse les appels RulesEngine.<call>(…) des snippets : vérifier qu'elle reste verte avec les nouveaux exemples.

Réf : core/attack_rules.gd:11-16, CHANGELOG 1.17.0.

**Constat d'audit (2026-07-02).** La 1.17.0 a ajouté `advantage`/`disadvantage` (sources externes, défaut `false`) à `RulesEngine.resolve_weapon_attack` et au wrapper `DndRules`, mais `docs/INTEGRATION.md` (sections FR **et** EN) n'en parle pas. C'est pourtant une capacité pensée pour le consommateur (portée longue, couverture gérées côté jeu). **À faire :** - Ajouter la signature complète et un court exemple (annulation mutuelle avantage+désavantage → jet normal) dans les deux langues, aligné sur la sémantique de `Combat.resolve_attack()`. - La garde d'arité de `tests/unit/test_consumer_api.gd` parse les appels `RulesEngine.<call>(…)` des snippets : vérifier qu'elle reste verte avec les nouveaux exemples. Réf : `core/attack_rules.gd:11-16`, CHANGELOG 1.17.0.