Coup de l'ordinateur : animation, traces et bouton Revoir

Le domaine donne le dernier coup demi-coup par demi-coup (plateaux
intermédiaires du moteur, pions frappés lus sur la barre) ; l'interface
fait glisser les pions puis laisse flèches, pions entourés et fantômes
jusqu'à l'action suivante. Scénario « Voir le coup de l'ordinateur »,
tests unitaires et test dans le navigateur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
2026-11-03 01:53:26 +01:00
co-authored by Claude Opus 5.5
parent 9c241de5c9
commit 7a9b376417
12 changed files with 851 additions and 101 deletions
+143
View File
@@ -0,0 +1,143 @@
// Un coup demi-coup par demi-coup (Game.lastMoveSteps), sur le vrai moteur
// WebAssembly : les plateaux intermédiaires que l'interface anime, et les
// pions frappés qu'elle signale.
//
// Copyright (C) 2026 les auteurs d'Ustagammon.
// Licence : GPLv3 ou ultérieure (voir LICENSE).
import assert from "node:assert/strict";
import { test } from "node:test";
import type { BoardSide } from "../src/domain/game/engine.js";
import { Game } from "../src/domain/game/game.js";
import {
BAR,
formatHalfMoves,
type PositionId,
parseHalfMoves,
} from "../src/domain/game/position.js";
import { fixedDice } from "../src/domain/game/roll.js";
import { loadNodeEngine } from "./support/node-engine.js";
// Le joueur, au trait : un pion sur sa case 13, quatorze sur sa case 6.
// L'ordinateur : un blot sur la case 10 du joueur (sa case 15), quatorze sur
// sa case 6.
const PLAYER_CAN_HIT = "4P8HEADg/wcEAA";
// Le joueur, au trait : un pion sur la barre, quatorze sur sa case 6.
// L'ordinateur : un blot sur la case 21 du joueur (sa case 4), quatorze sur
// sa case 6.
const PLAYER_ON_BAR = "yP8PAADg/wcAQA";
// Le joueur, au trait, n'a plus que deux pions, sur ses cases 6 et 5.
const PLAYER_ALMOST_DONE = "/38AAABQAAAAAA";
/** Une partie où le joueur, au trait, joue le jet dice à la position. */
async function playerMove(position: PositionId, dice: [number, number], move: string) {
const engine = await loadNodeEngine();
const game = Game.start(engine, {
dice: fixedDice(dice),
setup: { position, firstTurn: "player" },
});
await game.roll();
for (const halfMove of parseHalfMoves(move)) {
assert.equal(await game.playHalfMove(halfMove), true, formatHalfMoves([halfMove]));
}
return game;
}
/** Le nombre de pions d'un camp sur une case (1 à 24), sur la barre ou sortis. */
function at(side: BoardSide, point: number | "bar" | "off"): number {
if (point === "bar") {
return side.bar;
}
return point === "off" ? side.off : (side.points[point - 1] ?? 0);
}
test("un coup simple : un plateau par demi-coup, sans pion frappé", async () => {
const engine = await loadNodeEngine();
const game = Game.start(engine, { dice: fixedDice([3, 1]) });
for (const halfMove of parseHalfMoves("8/5 6/5")) {
await game.playHalfMove(halfMove);
}
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
assert.equal(steps.side, "player");
assert.equal(formatHalfMoves(steps.halfMoves), "8/5 6/5");
assert.deepEqual(steps.hits, [false, false]);
const counts = steps.boards.map((b) => [at(b.player, 8), at(b.player, 6), at(b.player, 5)]);
assert.deepEqual(counts, [
[3, 5, 0],
[2, 5, 1],
[2, 4, 2],
]);
// Le dernier plateau est celui de la partie après le coup.
assert.deepEqual(steps.boards[2], await game.displayedBoard());
});
test("un pion frappé part sur la barre au demi-coup qui le frappe", async () => {
const game = await playerMove(PLAYER_CAN_HIT, [3, 1], "13/10 10/9");
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
assert.deepEqual(steps.hits, [true, false]);
const bar = steps.boards.map((b) => at(b.computer, "bar"));
assert.deepEqual(bar, [0, 1, 1]);
// Le blot était sur la case 10 du joueur, la case 15 de l'ordinateur.
assert.equal(at(steps.boards[0]?.computer as BoardSide, 15), 1);
assert.equal(at(steps.boards[1]?.computer as BoardSide, 15), 0);
assert.equal(at(steps.boards[2]?.player as BoardSide, 9), 1);
});
test("un coup depuis la barre, qui frappe en rentrant", async () => {
const game = await playerMove(PLAYER_ON_BAR, [4, 2], "bar/21 6/4");
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
assert.deepEqual(steps.hits, [true, false]);
assert.deepEqual(
steps.boards.map((b) => [at(b.player, "bar"), at(b.player, 21), at(b.computer, "bar")]),
[
[1, 0, 0],
[0, 1, 1],
[0, 1, 1],
],
);
});
test("une sortie de pions, jusqu'à la fin de la partie", async () => {
const game = await playerMove(PLAYER_ALMOST_DONE, [6, 5], "6/off 5/off");
assert.equal(game.state.phase, "over");
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
assert.deepEqual(steps.hits, [false, false]);
assert.deepEqual(
steps.boards.map((b) => at(b.player, "off")),
[13, 14, 15],
);
});
test("le coup de l'ordinateur, vu dans sa propre numérotation", async () => {
const engine = await loadNodeEngine();
// Vous commencez avec 3-1, puis l'ordinateur tire 6-4.
const game = Game.start(engine, { dice: fixedDice([3, 1, 6, 4]) });
for (const halfMove of parseHalfMoves("8/5 6/5")) {
await game.playHalfMove(halfMove);
}
await game.playComputerTurn();
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
assert.equal(steps.side, "computer");
assert.equal(steps.boards.length, steps.halfMoves.length + 1);
// Chaque demi-coup déplace un pion de l'ordinateur de sa case de départ.
for (const [i, h] of steps.halfMoves.entries()) {
const from = h.from === BAR ? "bar" : h.from;
const before = steps.boards[i]?.computer as BoardSide;
const after = steps.boards[i + 1]?.computer as BoardSide;
assert.equal(at(after, from), at(before, from) - 1);
}
assert.deepEqual(steps.boards.at(-1), await game.displayedBoard());
});
test("avant le premier coup, il n'y a rien à montrer", async () => {
const engine = await loadNodeEngine();
const game = Game.start(engine, { dice: fixedDice([3, 1]) });
assert.equal(await game.lastMoveSteps(), null);
});
+79 -3
View File
@@ -7,10 +7,16 @@
import assert from "node:assert/strict";
import { Before, BeforeAll, Given, setDefaultTimeout, Then, When } from "@cucumber/cucumber";
import type { Engine, Move } from "../../src/domain/game/engine.js";
import type { BoardSide, Engine, Move } from "../../src/domain/game/engine.js";
import type { GameEvent } from "../../src/domain/game/events.js";
import { Game, STANDARD_PLY } from "../../src/domain/game/game.js";
import { type PositionId, parseHalfMoves, START_POSITION } from "../../src/domain/game/position.js";
import { Game, type MoveSteps, STANDARD_PLY } from "../../src/domain/game/game.js";
import {
BAR,
OFF,
type PositionId,
parseHalfMoves,
START_POSITION,
} from "../../src/domain/game/position.js";
import { fixedDice } from "../../src/domain/game/roll.js";
import type { GameState } from "../../src/domain/game/state.js";
import { loadNodeEngine } from "../support/node-engine.js";
@@ -27,11 +33,27 @@ const COMPUTER_DOUBLES = "6O5uAAC4uzsAAA";
// l'ordinateur n'en a sorti aucun.
const PLAYER_ALMOST_DONE = "/38AAABQAAAAAA";
// L'ordinateur, au trait : un pion sur sa case 13, quatorze sur sa case 1.
// Vous : un blot sur votre case 15 (sa case 10), deux pions sur votre case
// 13 (sa case 12), douze sur votre case 6. Avec 3-1, son seul coup permis
// est 13/10* 10/9 : il frappe votre blot.
const COMPUTER_MUST_HIT = "4P8BEwD/PwAEAA";
let engine: Engine;
let game: Game;
let accepted: boolean;
let positionBefore: PositionId;
let computerTurn: { before: GameState; ms: number };
let computerMove: MoveSteps;
/** Le nombre de pions d'un camp à une case d'un demi-coup (barre, sortie ou
* 1 à 24, dans sa numérotation). */
function checkersAt(side: BoardSide, point: number): number {
if (point === BAR) {
return side.bar;
}
return point === OFF ? side.off : (side.points[point - 1] ?? 0);
}
BeforeAll(async () => {
engine = await loadNodeEngine();
@@ -171,6 +193,60 @@ Then(
},
);
// ---------------------------------------------- Voir le coup de l'ordinateur
Given("un de vos pions est seul à portée de l'ordinateur", () => {
// L'ordinateur tirera 3-1. Le videau est chez vous : il ne peut pas
// doubler, il joue.
game = Game.start(engine, {
setup: {
position: COMPUTER_MUST_HIT,
firstTurn: "computer",
cube: { value: 2, owner: "player" },
},
dice: fixedDice([3, 1]),
});
});
When("l'ordinateur a joué", async () => {
await game.playComputerTurn();
const played = lastEvent();
assert.ok(played.type === "MovePlayed" && played.side === "computer");
const steps = await game.lastMoveSteps();
assert.ok(steps !== null);
computerMove = steps;
});
Then("son coup vous est montré case par case", async () => {
const { side, halfMoves, boards } = computerMove;
assert.equal(side, "computer");
assert.ok(halfMoves.length > 0);
assert.equal(boards.length, halfMoves.length + 1);
// Chaque plateau ne diffère du précédent que d'un pion de l'ordinateur,
// parti de la case de départ du demi-coup pour sa case d'arrivée.
for (const [i, h] of halfMoves.entries()) {
const before = boards[i]?.computer;
const after = boards[i + 1]?.computer;
assert.ok(before !== undefined && after !== undefined);
assert.equal(checkersAt(after, h.from), checkersAt(before, h.from) - 1);
assert.equal(checkersAt(after, h.to), checkersAt(before, h.to) + 1);
}
// Le dernier est le plateau de la partie.
assert.deepEqual(boards.at(-1), await game.displayedBoard());
});
Then("votre pion frappé part sur la barre", () => {
const { boards, hits } = computerMove;
const hit = hits.indexOf(true);
assert.ok(hit >= 0, "aucun pion frappé");
assert.equal(boards[hit]?.player.bar, 0);
assert.equal(boards[hit + 1]?.player.bar, 1);
});
Then("vous pouvez revoir son coup", async () => {
assert.deepEqual(await game.lastMoveSteps(), computerMove);
});
// ------------------------------------------------------------------ Videau
Given("l'ordinateur vous propose de doubler", async () => {
+51 -2
View File
@@ -10,9 +10,9 @@ import { readFileSync } from "node:fs";
import { test } from "node:test";
import type { BoardSide } from "../src/domain/game/engine.js";
import { appendEvent, EMPTY_JOURNAL } from "../src/domain/game/events.js";
import { START_POSITION } from "../src/domain/game/position.js";
import { parseHalfMoves, START_POSITION } from "../src/domain/game/position.js";
import { createGameStore } from "../src/storage/game-store.js";
import { boardModel, moveTargets, placeOf, pointSlot } from "../src/ui/board-model.js";
import { boardModel, moveTargets, moveTrace, placeOf, pointSlot } from "../src/ui/board-model.js";
import { parseFeature, parseGlossaryEntry, parseGlossaryIndex } from "../src/ui/help-text.js";
import { TEXTS } from "../src/ui/texts.js";
@@ -67,6 +67,55 @@ test("les demi-coups possibles donnent les pions jouables et leurs cases d'arriv
assert.deepEqual(targets.get("p3")?.get("off-player"), { from: 3, to: 0 });
});
test("traces d'un coup simple : une flèche par demi-coup, départs et arrivées", () => {
// L'ordinateur joue 13/9 13/7 dans sa numérotation : ses cases 13, 9 et
// 7 sont les cases 12, 16 et 18 du joueur.
const trace = moveTrace("computer", parseHalfMoves("13/9 13/7"), [false, false]);
assert.deepEqual(trace.arrows, [
{ from: "p12", to: "p16" },
{ from: "p12", to: "p18" },
]);
assert.deepEqual([...trace.left], [["p12", 2]]);
assert.deepEqual(
[...trace.landed],
[
["p16", 1],
["p18", 1],
],
);
assert.equal(trace.hits, 0);
});
test("traces : un pion qui fait étape ne laisse ni fantôme ni cercle à l'étape", () => {
const trace = moveTrace("computer", parseHalfMoves("24/18 18/14"), [false, true]);
assert.equal(trace.arrows.length, 2);
assert.deepEqual([...trace.left], [["p1", 1]]);
assert.deepEqual([...trace.landed], [["p11", 1]]);
assert.equal(trace.hits, 1);
});
test("traces : rentrée depuis la barre avec un pion frappé, sortie de pions", () => {
const entering = moveTrace("computer", parseHalfMoves("bar/22 6/4"), [true, false]);
assert.deepEqual(entering.arrows[0], { from: "bar-computer", to: "p3" });
assert.deepEqual(
[...entering.left],
[
["bar-computer", 1],
["p19", 1],
],
);
assert.equal(entering.hits, 1);
const bearingOff = moveTrace("computer", parseHalfMoves("6/off 5/off"), [false, false]);
assert.deepEqual([...bearingOff.landed], [["off-computer", 2]]);
assert.deepEqual(
[...bearingOff.left],
[
["p19", 1],
["p20", 1],
],
);
});
test("l'aide lit le scénario tel qu'il est écrit dans docs/scenarios/", () => {
const feature = parseFeature(read("docs/scenarios/jouer-une-partie.feature"));
assert.equal(feature.title, "Jouer une partie contre l'ordinateur");