From 5554b8688a75d018c8e7947be26eeaf0108e562f Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 17:44:08 +0100
Subject: [PATCH 1/6] added a screenshot to the README

---
 README.md      |   9 +++------
 chessboard.png | Bin 0 -> 73079 bytes
 2 files changed, 3 insertions(+), 6 deletions(-)
 create mode 100644 chessboard.png

diff --git a/README.md b/README.md
index 3ad9012..d0edf6a 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,5 @@
-# [chessboard](https://eeoooue.github.io/chessboard/)
-
-moveable chess pieces on a chess board
-
-attempt to mimic [chess.com](http://chess.com) UI, using [Cburnett's chess pieces](https://commons.wikimedia.org/wiki/Category:SVG_chess_pieces)
-
+# [Chess](https://eeoooue.github.io/chessboard/)
 
+A plain implementation of Chess in TypeScript, based on the [chess.com](http://chess.com) UI, using [Cburnett's chess pieces](https://commons.wikimedia.org/wiki/Category:SVG_chess_pieces).
 
+![Chess Board](chessboard.png)
diff --git a/chessboard.png b/chessboard.png
new file mode 100644
index 0000000000000000000000000000000000000000..4384e7c476dde99e651bfd8578cc9ed8e7f780ef
GIT binary patch
literal 73079
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
Yyw0Cfphb-x`VKz_^o{pq|KfQ5A91_ioB#j-

literal 0
HcmV?d00001


From 783bc790f11295293f10c72b383c584fe3d96b0e Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 18:01:28 +0100
Subject: [PATCH 2/6] Pieces are no longer Observers, but BoardElement
 observers the ChessGame

---
 docs/board_element.js  |  3 +++
 docs/chess_game.js     | 25 ++++++++++++++-----------
 docs/piece.js          |  3 +--
 docs/pieces/pawn.js    |  4 ++--
 docs/web_chess_game.js |  1 +
 src/board_element.ts   |  9 +++++++--
 src/chess_game.ts      | 32 +++++++++++++++++++-------------
 src/piece.ts           |  7 ++-----
 src/pieces/pawn.ts     |  5 ++---
 src/web_chess_game.ts  |  3 +++
 10 files changed, 54 insertions(+), 38 deletions(-)

diff --git a/docs/board_element.js b/docs/board_element.js
index 6db8bd1..9175376 100644
--- a/docs/board_element.js
+++ b/docs/board_element.js
@@ -11,6 +11,9 @@ export class BoardElement {
         this.paintPieces(this.game.getPieces());
     }
     update(subject) {
+        this.refresh();
+    }
+    refresh() {
         this.clearPreviousBoard();
         this.paintPieces(this.game.getPieces());
     }
diff --git a/docs/chess_game.js b/docs/chess_game.js
index 79633ee..112f2df 100644
--- a/docs/chess_game.js
+++ b/docs/chess_game.js
@@ -12,13 +12,13 @@ export class ChessGame {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
     submitPromotionChoice(choice) {
         const pawn = this.getPromotingPawn();
         pawn.promoteTo(choice);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
     getPromotingPawn() {
         const i = (this.getTurnPlayer() == "b") ? 0 : 7;
@@ -57,6 +57,13 @@ export class ChessGame {
             piece.threatened = false;
         });
     }
+    rebuildMoveOptions() {
+        const pieces = this.getPieces();
+        this.possibleMoves = 0;
+        pieces.forEach((piece) => {
+            piece.populateMoveOptions();
+        });
+    }
     attach(observer) {
         this.observers.push(observer);
     }
@@ -70,7 +77,6 @@ export class ChessGame {
         }
     }
     notify() {
-        this.possibleMoves = 0;
         this.observers.forEach((observer) => {
             observer.update(this);
         });
@@ -83,7 +89,11 @@ export class ChessGame {
     }
     concludeTurn() {
         this.turncount += 1;
+        this.updateState();
+    }
+    updateState() {
         this.resetThreats();
+        this.rebuildMoveOptions();
         this.notify();
         this.checkGameOver();
     }
@@ -95,7 +105,7 @@ export class ChessGame {
         }
     }
     makeMove(movingPiece, end) {
-        this.removePiece(end.i, end.j);
+        this.clearSquare(end.i, end.j);
         movingPiece.moveTo(end);
         this.concludeTurn();
         if (movingPiece instanceof Pawn) {
@@ -107,13 +117,6 @@ export class ChessGame {
     clearSquare(i, j) {
         this.boardState[i][j] = new EmptyPiece(this, i, j);
     }
-    removePiece(i, j) {
-        if (this.validCoordinates(i, j)) {
-            const piece = this.boardState[i][j];
-            this.detach(piece);
-            this.clearSquare(i, j);
-        }
-    }
     legalPosition(i, j, colour) {
         if (this.validCoordinates(i, j)) {
             const piece = this.boardState[i][j];
diff --git a/docs/piece.js b/docs/piece.js
index d93cb63..d327af4 100644
--- a/docs/piece.js
+++ b/docs/piece.js
@@ -11,9 +11,8 @@ export class Piece {
         this.i = i;
         this.j = j;
         this.threatened = false;
-        game.attach(this);
     }
-    update(subject) {
+    populateMoveOptions() {
         this.possibleMoves = [];
         this.moveOptions(this.i, this.j);
         if (this.colour == this.game.getTurnPlayer()) {
diff --git a/docs/pieces/pawn.js b/docs/pieces/pawn.js
index d6d8fc5..ffc0f05 100644
--- a/docs/pieces/pawn.js
+++ b/docs/pieces/pawn.js
@@ -36,7 +36,7 @@ export class Pawn extends Piece {
         if (this.j != end.j && targetPiece instanceof EmptyPiece) {
             const victim = this.boardState[this.i][end.j];
             if (victim instanceof Pawn && victim.enPassantTurn == this.game.turncount) {
-                this.game.removePiece(this.i, end.j);
+                this.game.clearSquare(this.i, end.j);
             }
         }
     }
@@ -105,7 +105,7 @@ export class Pawn extends Piece {
     }
     promoteTo(choice) {
         const newPiece = this.getPromotionPiece(choice);
-        this.game.removePiece(this.i, this.j);
+        this.game.clearSquare(this.i, this.j);
         this.boardState[this.i][this.j] = newPiece;
     }
     getPromotionPiece(choice) {
diff --git a/docs/web_chess_game.js b/docs/web_chess_game.js
index 252d3eb..d4be301 100644
--- a/docs/web_chess_game.js
+++ b/docs/web_chess_game.js
@@ -19,6 +19,7 @@ export class WebChessGame {
         const move = new BoardPosition(i, j);
         if (move) {
             this.game.submitSelection(move);
+            // this.boardElement.refresh();
             if (this.game.moveTracker.active) {
                 const piece = this.game.boardState[move.i][move.j];
                 const tile = this.boardElement.grid[move.i][move.j];
diff --git a/src/board_element.ts b/src/board_element.ts
index 5c0f1b3..e583cde 100644
--- a/src/board_element.ts
+++ b/src/board_element.ts
@@ -28,6 +28,11 @@ export class BoardElement implements Observer {
 
     update(subject: Subject): void {
 
+        this.refresh();
+    }
+
+    refresh(): void {
+
         this.clearPreviousBoard()
         this.paintPieces(this.game.getPieces())
     }
@@ -111,7 +116,7 @@ export class BoardElement implements Observer {
         }
     }
 
-    paintTile(list: HTMLElement[], i: number, j: number, paint: string){
+    paintTile(list: HTMLElement[], i: number, j: number, paint: string) {
 
         const tile = this.createTile(paint);
         tile.addEventListener("click", () => {
@@ -138,7 +143,7 @@ export class BoardElement implements Observer {
         })
     }
 
-    illustrateMoveOption(position: BoardPosition){
+    illustrateMoveOption(position: BoardPosition) {
 
         const piece: Piece = this.game.boardState[position.i][position.j]
         if (piece instanceof EmptyPiece) {
diff --git a/src/chess_game.ts b/src/chess_game.ts
index 5e1a1c5..a311582 100644
--- a/src/chess_game.ts
+++ b/src/chess_game.ts
@@ -24,7 +24,7 @@ export class ChessGame implements Subject {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
 
     submitPromotionChoice(choice: string) {
@@ -33,7 +33,7 @@ export class ChessGame implements Subject {
         pawn.promoteTo(choice);
 
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
 
     getPromotingPawn(): Pawn {
@@ -86,6 +86,16 @@ export class ChessGame implements Subject {
         })
     }
 
+    rebuildMoveOptions(){
+
+        const pieces = this.getPieces();
+        this.possibleMoves = 0;
+
+        pieces.forEach((piece) => {
+            piece.populateMoveOptions();
+        })
+    }
+
     attach(observer: Observer): void {
 
         this.observers.push(observer);
@@ -104,7 +114,6 @@ export class ChessGame implements Subject {
 
     notify(): void {
 
-        this.possibleMoves = 0;
         this.observers.forEach((observer) => {
             observer.update(this);
         })
@@ -123,7 +132,13 @@ export class ChessGame implements Subject {
     concludeTurn(): void {
 
         this.turncount += 1;
+        this.updateState();
+    }
+
+    updateState(){
+
         this.resetThreats();
+        this.rebuildMoveOptions();
         this.notify();
         this.checkGameOver();
     }
@@ -139,7 +154,7 @@ export class ChessGame implements Subject {
 
     makeMove(movingPiece: Piece, end: BoardPosition) {
 
-        this.removePiece(end.i, end.j);
+        this.clearSquare(end.i, end.j);
         movingPiece.moveTo(end);
         this.concludeTurn();
 
@@ -155,15 +170,6 @@ export class ChessGame implements Subject {
         this.boardState[i][j] = new EmptyPiece(this, i, j);
     }
 
-    removePiece(i: number, j: number) {
-
-        if (this.validCoordinates(i, j)) {
-            const piece: Piece = this.boardState[i][j];
-            this.detach(piece);
-            this.clearSquare(i, j);
-        }
-    }
-
     legalPosition(i: number, j: number, colour: string): boolean {
 
         if (this.validCoordinates(i, j)) {
diff --git a/src/piece.ts b/src/piece.ts
index 175e7d8..8c26e11 100644
--- a/src/piece.ts
+++ b/src/piece.ts
@@ -1,11 +1,9 @@
 
 import { ChessGame } from './chess_game.js';
 import { BoardPosition } from './board_position.js';
-import { Observer } from './observer.js';
-import { Subject } from "./subject.js";
 import { AnalysisBoard } from './analysis_board.js';
 
-export class Piece implements Observer {
+export class Piece {
 
     public boardState: Piece[][];
     public game: ChessGame;
@@ -26,10 +24,9 @@ export class Piece implements Observer {
         this.i = i;
         this.j = j;
         this.threatened = false;
-        game.attach(this);
     }
 
-    update(subject: Subject): void {
+    populateMoveOptions(): void {
 
         this.possibleMoves = [];
         this.moveOptions(this.i, this.j);
diff --git a/src/pieces/pawn.ts b/src/pieces/pawn.ts
index e01f3a8..a621957 100644
--- a/src/pieces/pawn.ts
+++ b/src/pieces/pawn.ts
@@ -3,7 +3,6 @@ import { BoardPosition } from '../board_position.js';
 import { ChessGame } from '../chess_game.js';
 import { Piece } from "../piece.js";
 import { EmptyPiece } from './empty_piece.js';
-
 import { Bishop } from './bishop.js';
 import { Knight } from './knight.js';
 import { Rook } from './rook.js';
@@ -54,7 +53,7 @@ export class Pawn extends Piece {
             const victim = this.boardState[this.i][end.j]
 
             if (victim instanceof Pawn && victim.enPassantTurn == this.game.turncount){
-                this.game.removePiece(this.i, end.j);
+                this.game.clearSquare(this.i, end.j);
             }
         }
     }
@@ -138,7 +137,7 @@ export class Pawn extends Piece {
     promoteTo(choice: string){
 
         const newPiece = this.getPromotionPiece(choice);
-        this.game.removePiece(this.i, this.j);
+        this.game.clearSquare(this.i, this.j);
         this.boardState[this.i][this.j] = newPiece;
     }
 
diff --git a/src/web_chess_game.ts b/src/web_chess_game.ts
index 886f746..c1d5c42 100644
--- a/src/web_chess_game.ts
+++ b/src/web_chess_game.ts
@@ -35,6 +35,8 @@ export class WebChessGame {
 
         if (move) {
             this.game.submitSelection(move);
+            // this.boardElement.refresh();
+
             if (this.game.moveTracker.active){
                 const piece : Piece = this.game.boardState[move.i][move.j]
                 const tile = this.boardElement.grid[move.i][move.j]
@@ -42,6 +44,7 @@ export class WebChessGame {
                 const options: BoardPosition[] = piece.possibleMoves;
                 this.boardElement.paintMoveOptions(options);                
             }
+            
 
             if (this.game.state == "checkmate" || this.game.state == "stalemate"){
                 this.showEndCard();

From 1e6113a04808caffee606ff380ad8b1bd10229f4 Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 19:38:32 +0100
Subject: [PATCH 3/6] Revert "Pieces are no longer Observers, but BoardElement
 observers the ChessGame"

This reverts commit 783bc790f11295293f10c72b383c584fe3d96b0e.
---
 docs/board_element.js  |  3 ---
 docs/chess_game.js     | 25 +++++++++++--------------
 docs/piece.js          |  3 ++-
 docs/pieces/pawn.js    |  4 ++--
 docs/web_chess_game.js |  1 -
 src/board_element.ts   |  9 ++-------
 src/chess_game.ts      | 32 +++++++++++++-------------------
 src/piece.ts           |  7 +++++--
 src/pieces/pawn.ts     |  5 +++--
 src/web_chess_game.ts  |  3 ---
 10 files changed, 38 insertions(+), 54 deletions(-)

diff --git a/docs/board_element.js b/docs/board_element.js
index 9175376..6db8bd1 100644
--- a/docs/board_element.js
+++ b/docs/board_element.js
@@ -11,9 +11,6 @@ export class BoardElement {
         this.paintPieces(this.game.getPieces());
     }
     update(subject) {
-        this.refresh();
-    }
-    refresh() {
         this.clearPreviousBoard();
         this.paintPieces(this.game.getPieces());
     }
diff --git a/docs/chess_game.js b/docs/chess_game.js
index 112f2df..79633ee 100644
--- a/docs/chess_game.js
+++ b/docs/chess_game.js
@@ -12,13 +12,13 @@ export class ChessGame {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.updateState();
+        this.notify();
     }
     submitPromotionChoice(choice) {
         const pawn = this.getPromotingPawn();
         pawn.promoteTo(choice);
         this.state = "ongoing";
-        this.updateState();
+        this.notify();
     }
     getPromotingPawn() {
         const i = (this.getTurnPlayer() == "b") ? 0 : 7;
@@ -57,13 +57,6 @@ export class ChessGame {
             piece.threatened = false;
         });
     }
-    rebuildMoveOptions() {
-        const pieces = this.getPieces();
-        this.possibleMoves = 0;
-        pieces.forEach((piece) => {
-            piece.populateMoveOptions();
-        });
-    }
     attach(observer) {
         this.observers.push(observer);
     }
@@ -77,6 +70,7 @@ export class ChessGame {
         }
     }
     notify() {
+        this.possibleMoves = 0;
         this.observers.forEach((observer) => {
             observer.update(this);
         });
@@ -89,11 +83,7 @@ export class ChessGame {
     }
     concludeTurn() {
         this.turncount += 1;
-        this.updateState();
-    }
-    updateState() {
         this.resetThreats();
-        this.rebuildMoveOptions();
         this.notify();
         this.checkGameOver();
     }
@@ -105,7 +95,7 @@ export class ChessGame {
         }
     }
     makeMove(movingPiece, end) {
-        this.clearSquare(end.i, end.j);
+        this.removePiece(end.i, end.j);
         movingPiece.moveTo(end);
         this.concludeTurn();
         if (movingPiece instanceof Pawn) {
@@ -117,6 +107,13 @@ export class ChessGame {
     clearSquare(i, j) {
         this.boardState[i][j] = new EmptyPiece(this, i, j);
     }
+    removePiece(i, j) {
+        if (this.validCoordinates(i, j)) {
+            const piece = this.boardState[i][j];
+            this.detach(piece);
+            this.clearSquare(i, j);
+        }
+    }
     legalPosition(i, j, colour) {
         if (this.validCoordinates(i, j)) {
             const piece = this.boardState[i][j];
diff --git a/docs/piece.js b/docs/piece.js
index d327af4..d93cb63 100644
--- a/docs/piece.js
+++ b/docs/piece.js
@@ -11,8 +11,9 @@ export class Piece {
         this.i = i;
         this.j = j;
         this.threatened = false;
+        game.attach(this);
     }
-    populateMoveOptions() {
+    update(subject) {
         this.possibleMoves = [];
         this.moveOptions(this.i, this.j);
         if (this.colour == this.game.getTurnPlayer()) {
diff --git a/docs/pieces/pawn.js b/docs/pieces/pawn.js
index ffc0f05..d6d8fc5 100644
--- a/docs/pieces/pawn.js
+++ b/docs/pieces/pawn.js
@@ -36,7 +36,7 @@ export class Pawn extends Piece {
         if (this.j != end.j && targetPiece instanceof EmptyPiece) {
             const victim = this.boardState[this.i][end.j];
             if (victim instanceof Pawn && victim.enPassantTurn == this.game.turncount) {
-                this.game.clearSquare(this.i, end.j);
+                this.game.removePiece(this.i, end.j);
             }
         }
     }
@@ -105,7 +105,7 @@ export class Pawn extends Piece {
     }
     promoteTo(choice) {
         const newPiece = this.getPromotionPiece(choice);
-        this.game.clearSquare(this.i, this.j);
+        this.game.removePiece(this.i, this.j);
         this.boardState[this.i][this.j] = newPiece;
     }
     getPromotionPiece(choice) {
diff --git a/docs/web_chess_game.js b/docs/web_chess_game.js
index d4be301..252d3eb 100644
--- a/docs/web_chess_game.js
+++ b/docs/web_chess_game.js
@@ -19,7 +19,6 @@ export class WebChessGame {
         const move = new BoardPosition(i, j);
         if (move) {
             this.game.submitSelection(move);
-            // this.boardElement.refresh();
             if (this.game.moveTracker.active) {
                 const piece = this.game.boardState[move.i][move.j];
                 const tile = this.boardElement.grid[move.i][move.j];
diff --git a/src/board_element.ts b/src/board_element.ts
index e583cde..5c0f1b3 100644
--- a/src/board_element.ts
+++ b/src/board_element.ts
@@ -28,11 +28,6 @@ export class BoardElement implements Observer {
 
     update(subject: Subject): void {
 
-        this.refresh();
-    }
-
-    refresh(): void {
-
         this.clearPreviousBoard()
         this.paintPieces(this.game.getPieces())
     }
@@ -116,7 +111,7 @@ export class BoardElement implements Observer {
         }
     }
 
-    paintTile(list: HTMLElement[], i: number, j: number, paint: string) {
+    paintTile(list: HTMLElement[], i: number, j: number, paint: string){
 
         const tile = this.createTile(paint);
         tile.addEventListener("click", () => {
@@ -143,7 +138,7 @@ export class BoardElement implements Observer {
         })
     }
 
-    illustrateMoveOption(position: BoardPosition) {
+    illustrateMoveOption(position: BoardPosition){
 
         const piece: Piece = this.game.boardState[position.i][position.j]
         if (piece instanceof EmptyPiece) {
diff --git a/src/chess_game.ts b/src/chess_game.ts
index a311582..5e1a1c5 100644
--- a/src/chess_game.ts
+++ b/src/chess_game.ts
@@ -24,7 +24,7 @@ export class ChessGame implements Subject {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.updateState();
+        this.notify();
     }
 
     submitPromotionChoice(choice: string) {
@@ -33,7 +33,7 @@ export class ChessGame implements Subject {
         pawn.promoteTo(choice);
 
         this.state = "ongoing";
-        this.updateState();
+        this.notify();
     }
 
     getPromotingPawn(): Pawn {
@@ -86,16 +86,6 @@ export class ChessGame implements Subject {
         })
     }
 
-    rebuildMoveOptions(){
-
-        const pieces = this.getPieces();
-        this.possibleMoves = 0;
-
-        pieces.forEach((piece) => {
-            piece.populateMoveOptions();
-        })
-    }
-
     attach(observer: Observer): void {
 
         this.observers.push(observer);
@@ -114,6 +104,7 @@ export class ChessGame implements Subject {
 
     notify(): void {
 
+        this.possibleMoves = 0;
         this.observers.forEach((observer) => {
             observer.update(this);
         })
@@ -132,13 +123,7 @@ export class ChessGame implements Subject {
     concludeTurn(): void {
 
         this.turncount += 1;
-        this.updateState();
-    }
-
-    updateState(){
-
         this.resetThreats();
-        this.rebuildMoveOptions();
         this.notify();
         this.checkGameOver();
     }
@@ -154,7 +139,7 @@ export class ChessGame implements Subject {
 
     makeMove(movingPiece: Piece, end: BoardPosition) {
 
-        this.clearSquare(end.i, end.j);
+        this.removePiece(end.i, end.j);
         movingPiece.moveTo(end);
         this.concludeTurn();
 
@@ -170,6 +155,15 @@ export class ChessGame implements Subject {
         this.boardState[i][j] = new EmptyPiece(this, i, j);
     }
 
+    removePiece(i: number, j: number) {
+
+        if (this.validCoordinates(i, j)) {
+            const piece: Piece = this.boardState[i][j];
+            this.detach(piece);
+            this.clearSquare(i, j);
+        }
+    }
+
     legalPosition(i: number, j: number, colour: string): boolean {
 
         if (this.validCoordinates(i, j)) {
diff --git a/src/piece.ts b/src/piece.ts
index 8c26e11..175e7d8 100644
--- a/src/piece.ts
+++ b/src/piece.ts
@@ -1,9 +1,11 @@
 
 import { ChessGame } from './chess_game.js';
 import { BoardPosition } from './board_position.js';
+import { Observer } from './observer.js';
+import { Subject } from "./subject.js";
 import { AnalysisBoard } from './analysis_board.js';
 
-export class Piece {
+export class Piece implements Observer {
 
     public boardState: Piece[][];
     public game: ChessGame;
@@ -24,9 +26,10 @@ export class Piece {
         this.i = i;
         this.j = j;
         this.threatened = false;
+        game.attach(this);
     }
 
-    populateMoveOptions(): void {
+    update(subject: Subject): void {
 
         this.possibleMoves = [];
         this.moveOptions(this.i, this.j);
diff --git a/src/pieces/pawn.ts b/src/pieces/pawn.ts
index a621957..e01f3a8 100644
--- a/src/pieces/pawn.ts
+++ b/src/pieces/pawn.ts
@@ -3,6 +3,7 @@ import { BoardPosition } from '../board_position.js';
 import { ChessGame } from '../chess_game.js';
 import { Piece } from "../piece.js";
 import { EmptyPiece } from './empty_piece.js';
+
 import { Bishop } from './bishop.js';
 import { Knight } from './knight.js';
 import { Rook } from './rook.js';
@@ -53,7 +54,7 @@ export class Pawn extends Piece {
             const victim = this.boardState[this.i][end.j]
 
             if (victim instanceof Pawn && victim.enPassantTurn == this.game.turncount){
-                this.game.clearSquare(this.i, end.j);
+                this.game.removePiece(this.i, end.j);
             }
         }
     }
@@ -137,7 +138,7 @@ export class Pawn extends Piece {
     promoteTo(choice: string){
 
         const newPiece = this.getPromotionPiece(choice);
-        this.game.clearSquare(this.i, this.j);
+        this.game.removePiece(this.i, this.j);
         this.boardState[this.i][this.j] = newPiece;
     }
 
diff --git a/src/web_chess_game.ts b/src/web_chess_game.ts
index c1d5c42..886f746 100644
--- a/src/web_chess_game.ts
+++ b/src/web_chess_game.ts
@@ -35,8 +35,6 @@ export class WebChessGame {
 
         if (move) {
             this.game.submitSelection(move);
-            // this.boardElement.refresh();
-
             if (this.game.moveTracker.active){
                 const piece : Piece = this.game.boardState[move.i][move.j]
                 const tile = this.boardElement.grid[move.i][move.j]
@@ -44,7 +42,6 @@ export class WebChessGame {
                 const options: BoardPosition[] = piece.possibleMoves;
                 this.boardElement.paintMoveOptions(options);                
             }
-            
 
             if (this.game.state == "checkmate" || this.game.state == "stalemate"){
                 this.showEndCard();

From c8cb7b3e2596ebd33c86e63352cfe5fd8f1c508d Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 19:41:50 +0100
Subject: [PATCH 4/6] BoardElement no longer implements Observer

---
 src/board_element.ts | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/board_element.ts b/src/board_element.ts
index 5c0f1b3..0381f5d 100644
--- a/src/board_element.ts
+++ b/src/board_element.ts
@@ -5,10 +5,9 @@ import { BoardPosition } from "./board_position.js";
 import { Piece } from "./piece.js";
 import { EmptyPiece } from "./pieces/empty_piece.js";
 import { King } from "./pieces/king.js";
-import { Observer } from "./observer.js";
 import { Subject } from "./subject.js";
 
-export class BoardElement implements Observer {
+export class BoardElement {
 
     public boardContainer: HTMLElement;
     public grid: HTMLElement[][] = [];
@@ -20,13 +19,12 @@ export class BoardElement implements Observer {
         this.parent = parent;
         this.boardContainer = boardContainer;
         this.game = game;
-        this.game.attach(this);
 
         this.paintTiles()
         this.paintPieces(this.game.getPieces())
     }
 
-    update(subject: Subject): void {
+    repaint(): void {
 
         this.clearPreviousBoard()
         this.paintPieces(this.game.getPieces())

From 99f5528a0db5b196293a2aa0e7667ff739e6218b Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 19:51:20 +0100
Subject: [PATCH 5/6] now using a refresh() method in WebChessGame with Pieces
 that implement Observer

---
 docs/board_element.js  | 3 +--
 docs/chess_game.js     | 7 +++++--
 docs/promotion_card.js | 1 +
 docs/web_chess_game.js | 4 ++++
 src/chess_game.ts      | 9 +++++++--
 src/promotion_card.ts  | 1 +
 src/web_chess_game.ts  | 7 +++++++
 7 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/docs/board_element.js b/docs/board_element.js
index 6db8bd1..25bff25 100644
--- a/docs/board_element.js
+++ b/docs/board_element.js
@@ -6,11 +6,10 @@ export class BoardElement {
         this.parent = parent;
         this.boardContainer = boardContainer;
         this.game = game;
-        this.game.attach(this);
         this.paintTiles();
         this.paintPieces(this.game.getPieces());
     }
-    update(subject) {
+    repaint() {
         this.clearPreviousBoard();
         this.paintPieces(this.game.getPieces());
     }
diff --git a/docs/chess_game.js b/docs/chess_game.js
index 79633ee..4609b0f 100644
--- a/docs/chess_game.js
+++ b/docs/chess_game.js
@@ -12,13 +12,13 @@ export class ChessGame {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
     submitPromotionChoice(choice) {
         const pawn = this.getPromotingPawn();
         pawn.promoteTo(choice);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
     getPromotingPawn() {
         const i = (this.getTurnPlayer() == "b") ? 0 : 7;
@@ -83,6 +83,9 @@ export class ChessGame {
     }
     concludeTurn() {
         this.turncount += 1;
+        this.updateState();
+    }
+    updateState() {
         this.resetThreats();
         this.notify();
         this.checkGameOver();
diff --git a/docs/promotion_card.js b/docs/promotion_card.js
index 1c0080b..c6956f5 100644
--- a/docs/promotion_card.js
+++ b/docs/promotion_card.js
@@ -39,5 +39,6 @@ export class PromotionCard {
     submitChoice(text) {
         this.game.submitPromotionChoice(text);
         this.element.remove();
+        this.parent.refresh();
     }
 }
diff --git a/docs/web_chess_game.js b/docs/web_chess_game.js
index 252d3eb..cc0e662 100644
--- a/docs/web_chess_game.js
+++ b/docs/web_chess_game.js
@@ -19,6 +19,7 @@ export class WebChessGame {
         const move = new BoardPosition(i, j);
         if (move) {
             this.game.submitSelection(move);
+            this.refresh();
             if (this.game.moveTracker.active) {
                 const piece = this.game.boardState[move.i][move.j];
                 const tile = this.boardElement.grid[move.i][move.j];
@@ -34,6 +35,9 @@ export class WebChessGame {
             }
         }
     }
+    refresh() {
+        this.boardElement.repaint();
+    }
     askPromotionOption() {
         const promotionCard = new PromotionCard(this, this.game);
         this.boardContainer.appendChild(promotionCard.element);
diff --git a/src/chess_game.ts b/src/chess_game.ts
index 5e1a1c5..972eb5b 100644
--- a/src/chess_game.ts
+++ b/src/chess_game.ts
@@ -24,7 +24,7 @@ export class ChessGame implements Subject {
         this.moveTracker = new MoveTracker(this);
         this.boardBuilder = new BoardBuilder(this);
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
 
     submitPromotionChoice(choice: string) {
@@ -33,7 +33,7 @@ export class ChessGame implements Subject {
         pawn.promoteTo(choice);
 
         this.state = "ongoing";
-        this.notify();
+        this.updateState();
     }
 
     getPromotingPawn(): Pawn {
@@ -123,6 +123,11 @@ export class ChessGame implements Subject {
     concludeTurn(): void {
 
         this.turncount += 1;
+        this.updateState();
+    }
+
+    updateState(): void {
+
         this.resetThreats();
         this.notify();
         this.checkGameOver();
diff --git a/src/promotion_card.ts b/src/promotion_card.ts
index 6692a56..973d48a 100644
--- a/src/promotion_card.ts
+++ b/src/promotion_card.ts
@@ -66,5 +66,6 @@ export class PromotionCard {
 
         this.game.submitPromotionChoice(text);
         this.element.remove();
+        this.parent.refresh();
     }
 }
\ No newline at end of file
diff --git a/src/web_chess_game.ts b/src/web_chess_game.ts
index 886f746..143a785 100644
--- a/src/web_chess_game.ts
+++ b/src/web_chess_game.ts
@@ -35,6 +35,8 @@ export class WebChessGame {
 
         if (move) {
             this.game.submitSelection(move);
+            this.refresh();
+
             if (this.game.moveTracker.active){
                 const piece : Piece = this.game.boardState[move.i][move.j]
                 const tile = this.boardElement.grid[move.i][move.j]
@@ -53,6 +55,11 @@ export class WebChessGame {
         }
     }
 
+    refresh(): void {
+
+        this.boardElement.repaint();
+    }
+
     askPromotionOption(): void {
 
         const promotionCard = new PromotionCard(this, this.game);

From 439be0428462ea41ed667a6dfd359c16f5189ed3 Mon Sep 17 00:00:00 2001
From: eeoooue <pdmoorhouse@gmail.com>
Date: Thu, 8 Jun 2023 19:57:34 +0100
Subject: [PATCH 6/6] moved more code into Refresh() method & simplified
 processMove()

---
 docs/web_chess_game.js | 30 ++++++++++++++----------------
 src/web_chess_game.ts  | 36 +++++++++++++++++-------------------
 2 files changed, 31 insertions(+), 35 deletions(-)

diff --git a/docs/web_chess_game.js b/docs/web_chess_game.js
index cc0e662..19dd89d 100644
--- a/docs/web_chess_game.js
+++ b/docs/web_chess_game.js
@@ -17,26 +17,24 @@ export class WebChessGame {
     }
     processMove(i, j) {
         const move = new BoardPosition(i, j);
-        if (move) {
-            this.game.submitSelection(move);
-            this.refresh();
-            if (this.game.moveTracker.active) {
-                const piece = this.game.boardState[move.i][move.j];
-                const tile = this.boardElement.grid[move.i][move.j];
-                tile.classList.add("highlighted");
-                const options = piece.possibleMoves;
-                this.boardElement.paintMoveOptions(options);
-            }
-            if (this.game.state == "checkmate" || this.game.state == "stalemate") {
-                this.showEndCard();
-            }
-            if (this.game.state == "promotion") {
-                this.askPromotionOption();
-            }
+        this.game.submitSelection(move);
+        this.refresh();
+        if (this.game.moveTracker.active) {
+            const piece = this.game.boardState[move.i][move.j];
+            const tile = this.boardElement.grid[move.i][move.j];
+            tile.classList.add("highlighted");
+            const options = piece.possibleMoves;
+            this.boardElement.paintMoveOptions(options);
         }
     }
     refresh() {
         this.boardElement.repaint();
+        if (this.game.state == "checkmate" || this.game.state == "stalemate") {
+            this.showEndCard();
+        }
+        if (this.game.state == "promotion") {
+            this.askPromotionOption();
+        }
     }
     askPromotionOption() {
         const promotionCard = new PromotionCard(this, this.game);
diff --git a/src/web_chess_game.ts b/src/web_chess_game.ts
index 143a785..de3e97c 100644
--- a/src/web_chess_game.ts
+++ b/src/web_chess_game.ts
@@ -33,31 +33,29 @@ export class WebChessGame {
 
         const move: BoardPosition = new BoardPosition(i, j);
 
-        if (move) {
-            this.game.submitSelection(move);
-            this.refresh();
-
-            if (this.game.moveTracker.active){
-                const piece : Piece = this.game.boardState[move.i][move.j]
-                const tile = this.boardElement.grid[move.i][move.j]
-                tile.classList.add("highlighted")
-                const options: BoardPosition[] = piece.possibleMoves;
-                this.boardElement.paintMoveOptions(options);                
-            }
-
-            if (this.game.state == "checkmate" || this.game.state == "stalemate"){
-                this.showEndCard();
-            }
-    
-            if (this.game.state == "promotion"){
-                this.askPromotionOption();
-            }
+        this.game.submitSelection(move);
+        this.refresh();
+
+        if (this.game.moveTracker.active){
+            const piece : Piece = this.game.boardState[move.i][move.j]
+            const tile = this.boardElement.grid[move.i][move.j]
+            tile.classList.add("highlighted")
+            const options: BoardPosition[] = piece.possibleMoves;
+            this.boardElement.paintMoveOptions(options);                
         }
     }
 
     refresh(): void {
 
         this.boardElement.repaint();
+
+        if (this.game.state == "checkmate" || this.game.state == "stalemate"){
+            this.showEndCard();
+        }
+
+        if (this.game.state == "promotion"){
+            this.askPromotionOption();
+        }
     }
 
     askPromotionOption(): void {