kokopu-react 3.0.1 → 3.1.0

package/src/sanitization.ts

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/src/types.ts

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/src/util.ts

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/01_types.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/02_chessboard_util.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/03_error_box_graphic.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/04_icons_graphic.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/05_chessboard_graphic.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *
@@ -62,6 +64,8 @@ describeWithBrowser('Chessboard graphic', browserContext => {
 		'promotion',
 		'wrong move type',
 		'wrong move arrow color type',
+		'null-move',
+		'illegal null-move',
 	]);
 
 	itChecksScreenshots(browserContext, '05_chessboard_graphic/theme', [

package/test/06_chessboard_animation.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/07_chessboard_interaction.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/08_chessboard_play_moves.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *

package/test/09_chessboard_small_screens.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *
@@ -48,3 +50,24 @@ describeWithBrowser('Chessboard on small-screens', browserContext => {
 	itCheckScreenshotWithWidth(690);
 
 });
+
+
+describeWithBrowser('Chessboard on small-screens with top/bottom components', browserContext => {
+
+	itChecksScreenshots(browserContext, '09_chessboard_small_screens/top_bottom_components', [
+		'default top component',
+		'default bottom component',
+	]);
+
+	function itCheckScreenshotWithReducedWidth(itemIndex, label) {
+		itCustom(browserContext, '09_chessboard_small_screens/top_bottom_components', itemIndex, label, async element => {
+			await setWindowWidth(browserContext, 700);
+			await takeScreenshot(browserContext, label, element);
+			await compareScreenshot(browserContext, label);
+		});
+	}
+
+	itCheckScreenshotWithReducedWidth(0, 'reduced top component');
+	itCheckScreenshotWithReducedWidth(1, 'reduced bottom component');
+
+});

package/test/10_movetext_graphic.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *
@@ -55,6 +57,11 @@ describeWithBrowser('Movetext graphic', browserContext => {
 		'hidden diagrams',
 		'wrong diagram options 1',
 		'wrong diagram options 2',
+		'wrong piece symbol value',
+	]);
+
+	itChecksScreenshots(browserContext, '10_movetext_graphic/format_move', [
+		'format text',
 	]);
 
 });

package/test/11_movetext_interaction.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *
@@ -57,7 +59,11 @@ describeWithBrowser('Movetext interaction', browserContext => {
 		{ searchedText: 'cxd5', expectedText: tpl('5w', 'click') },
 	]);
 
-	itCheckClickMove(2, 'click on with variations', [
+	itCheckClickMove(2, 'click on unselected without callback', [
+		{ searchedText: 'cxd5', expectedText: '' },
+	]);
+
+	itCheckClickMove(3, 'click on with variations', [
 		{ searchedText: 'Bb5', expectedText: tpl(undefined, 'click') },
 		{ searchedText: 'Nc6', expectedText: tpl('1b-v0-2b', 'click') },
 	]);
@@ -109,15 +115,15 @@ describeWithBrowser('Movetext interaction', browserContext => {
 
 	itCheckKeyboardActions(0, 'key on disabled', '', '', '', '', '');
 	itCheckKeyboardActions(1, 'key on unselected', '', '', '', '', '');
-	itCheckKeyboardActions(2, 'key on with variations 1', tpl('start', 'key-first'), tpl('1b-v0-2b', 'key-previous'), tpl('1b-v0-3w-v0-3b', 'key-next'),
+	itCheckKeyboardActions(3, 'key on with variations 1', tpl('start', 'key-first'), tpl('1b-v0-2b', 'key-previous'), tpl('1b-v0-3w-v0-3b', 'key-next'),
 		tpl('1b-v0-3w-v0-4w', 'key-last'), TPL_EXIT);
-	itCheckKeyboardActions(3, 'key on with variations 2', tpl('start', 'key-first'), tpl('1b-v0-2w', 'key-previous'), tpl('1b-v0-3w', 'key-next'),
+	itCheckKeyboardActions(4, 'key on with variations 2', tpl('start', 'key-first'), tpl('1b-v0-2w', 'key-previous'), tpl('1b-v0-3w', 'key-next'),
 		tpl('1b-v0-3w', 'key-last'), TPL_EXIT);
-	itCheckKeyboardActions(4, 'key on start selected', '', '', tpl('1w', 'key-next'), tpl('6b', 'key-last'), TPL_EXIT);
-	itCheckKeyboardActions(5, 'key on first selected', tpl('start', 'key-first'), tpl('start', 'key-previous'), tpl('1b', 'key-next'), tpl('6b', 'key-last'), TPL_EXIT);
-	itCheckKeyboardActions(6, 'key on last selected', tpl('start', 'key-first'), tpl('6w', 'key-previous'), '', '', TPL_EXIT);
-	itCheckKeyboardActions(7, 'key on invalid selection', '', '', '', '', '');
-	itCheckKeyboardActions(8, 'key on sub-variation selected', tpl('start', 'key-first'), tpl('1w', 'key-previous'), tpl('1b-v0-1b', 'key-next'),
+	itCheckKeyboardActions(5, 'key on start selected', '', '', tpl('1w', 'key-next'), tpl('6b', 'key-last'), TPL_EXIT);
+	itCheckKeyboardActions(6, 'key on first selected', tpl('start', 'key-first'), tpl('start', 'key-previous'), tpl('1b', 'key-next'), tpl('6b', 'key-last'), TPL_EXIT);
+	itCheckKeyboardActions(7, 'key on last selected', tpl('start', 'key-first'), tpl('6w', 'key-previous'), '', '', TPL_EXIT);
+	itCheckKeyboardActions(8, 'key on invalid selection', '', '', '', '', '');
+	itCheckKeyboardActions(9, 'key on sub-variation selected', tpl('start', 'key-first'), tpl('1w', 'key-previous'), tpl('1b-v0-1b', 'key-next'),
 		tpl('1b-v0-3w', 'key-last'), TPL_EXIT);
 
 	itChecksScreenshots(browserContext, '11_movetext_interaction/error', [

package/test/12_navigation_board.js

@@ -0,0 +1,168 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *                                                                            *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
+ *    modify it under the terms of the GNU Lesser General Public License      *
+ *    as published by the Free Software Foundation, either version 3 of       *
+ *    the License, or (at your option) any later version.                     *
+ *                                                                            *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
+ *    GNU Lesser General Public License for more details.                     *
+ *                                                                            *
+ *    You should have received a copy of the GNU Lesser General               *
+ *    Public License along with this program. If not, see                     *
+ *    <http://www.gnu.org/licenses/>.                                         *
+ *                                                                            *
+ * -------------------------------------------------------------------------- */
+
+
+const { describeWithBrowser, itCustom, setSandbox, compareSandbox, takeScreenshot, compareScreenshot, itChecksScreenshots } = require('./common/graphic');
+const { By, Key } = require('selenium-webdriver');
+const test = require('unit.js');
+
+
+describeWithBrowser('Navigation board - Uncontrolled behavior', browserContext => {
+
+	itChecksScreenshots(browserContext, '12_navigation_board/uncontrolled', [
+		'initial state default',
+		'initial state at end',
+		'initial state at specific ID',
+		'initial state default with game index',
+		'initial state on null-move',
+	]);
+
+	function itCheckClickButton(itemIndex, label, buttons) {
+		itCustom(browserContext, '12_navigation_board/uncontrolled', itemIndex, label, async element => {
+			await setSandbox(browserContext, '');
+			for (let i = 0; i < buttons.length; ++i) {
+				const buttonElement = await element.findElement(By.xpath(`.//div[@title='${buttons[i].title}']`));
+				await buttonElement.click();
+				await compareSandbox(browserContext, buttons[i].expectedSandbox ?? '');
+				await takeScreenshot(browserContext, `${label} ${i}`, element);
+			}
+			for (let i = 0; i < buttons.length; ++i) {
+				await compareScreenshot(browserContext, `${label} ${i}`);
+			}
+		});
+	}
+
+	itCheckClickButton(0, 'regular flipping', [
+		{ title: 'Flip the board' },
+		{ title: 'Flip the board' },
+	]);
+
+	itCheckClickButton(2, 'regular navigation', [
+		{ title: 'Go to the next move' },
+		{ title: 'Go to the previous move' },
+		{ title: 'Go to the previous move' },
+		{ title: 'Go to the beginning of the game' },
+		{ title: 'Go to the end of the game' },
+		{ title: 'Flip the board' },
+	]);
+
+	itCheckClickButton(3, 'forbidden navigation at beginning', [
+		{ title: 'Go to the previous move' },
+		{ title: 'Go to the beginning of the game' },
+		{ title: 'Flip the board', expectedSandbox: 'Flip state changed: false' },
+	]);
+
+	itCheckClickButton(1, 'forbidden navigation at end', [
+		{ title: 'Go to the next move' },
+		{ title: 'Go to the end of the game' },
+		{ title: 'Flip the board' },
+	]);
+
+	function itCheckPressKey(itemIndex, label, keys) {
+		itCustom(browserContext, '12_navigation_board/uncontrolled', itemIndex, label, async element => {
+			await setSandbox(browserContext, '');
+			const focusFieldElements = await element.findElements(By.className('kokopu-focusField'));
+
+			test.value(focusFieldElements.length).is(1);
+			const focusFieldElement = focusFieldElements[0];
+
+			for (let i = 0; i < keys.length; ++i) {
+				await focusFieldElement.sendKeys(keys[i].code);
+				await compareSandbox(browserContext, keys[i].expectedSandbox ?? '');
+				await takeScreenshot(browserContext, `${label} ${i}`, element);
+			}
+			for (let i = 0; i < keys.length; ++i) {
+				await compareScreenshot(browserContext, `${label} ${i}`);
+			}
+		});
+	}
+
+	itCheckPressKey(4, 'navigation with keys', [
+		{ code: Key.ARROW_LEFT },
+		{ code: Key.HOME },
+		{ code: Key.ARROW_RIGHT },
+		{ code: Key.ESCAPE },
+		{ code: Key.END },
+	]);
+
+});
+
+
+describeWithBrowser('Navigation board - Controlled behavior', browserContext => {
+
+	itChecksScreenshots(browserContext, '12_navigation_board/controlled', [
+		'default',
+		'overriding initial node ID',
+		'invalid node ID',
+	]);
+
+	function itCheckClickButton(itemIndex, label, buttons) {
+		itCustom(browserContext, '12_navigation_board/controlled', itemIndex, label, async element => {
+			await setSandbox(browserContext, '');
+			for (let i = 0; i < buttons.length; ++i) {
+				const buttonElement = await element.findElement(By.xpath(`.//div[@title='${buttons[i].title}']`));
+				await buttonElement.click();
+				await compareSandbox(browserContext, buttons[i].expectedSandbox ?? '');
+				await takeScreenshot(browserContext, `${label} ${i}`, element);
+			}
+			for (let i = 0; i < buttons.length; ++i) {
+				await compareScreenshot(browserContext, `${label} ${i}`);
+			}
+		});
+	}
+
+	itCheckClickButton(0, 'regular navigation', [
+		{ title: 'Go to the beginning of the game', expectedSandbox: 'Node ID changed: start' },
+		{ title: 'Go to the previous move', expectedSandbox: 'Node ID changed: 16b' },
+		{ title: 'Go to the next move', expectedSandbox: 'Node ID changed: 17b' },
+		{ title: 'Go to the end of the game', expectedSandbox: 'Node ID changed: 28b' },
+	]);
+
+	itCheckClickButton(1, 'no callback defined', [
+		{ title: 'Go to the beginning of the game' },
+		{ title: 'Flip the board' },
+	]);
+
+	itCheckClickButton(2, 'forbidden navigation', [
+		{ title: 'Go to the previous move' },
+		{ title: 'Flip the board', expectedSandbox: 'Flip state changed: true' },
+	]);
+
+});
+
+
+describeWithBrowser('Navigation board graphic', browserContext => {
+
+	itChecksScreenshots(browserContext, '12_navigation_board/error', [
+		'pgn parsing error',
+		'wrong game type',
+	]);
+
+	itChecksScreenshots(browserContext, '12_navigation_board/theme', [
+		'small',
+		'large',
+		'custom 1',
+		'custom 2',
+	]);
+
+});

package/test/common/graphic.js

@@ -1,14 +1,16 @@
-/* -------------------------------------------------------------------------- *
+/*!
+ * -------------------------------------------------------------------------- *
  *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
+ *    Kokopu-React - A React-based library of chess-related components.       *
+ *    <https://www.npmjs.com/package/kokopu-react>                            *
+ *    Copyright (C) 2021-2024  Yoann Le Montagner <yo35 -at- melix.net>       *
  *                                                                            *
- *    This program is free software: you can redistribute it and/or           *
+ *    Kokopu-React is free software: you can redistribute it and/or           *
  *    modify it under the terms of the GNU Lesser General Public License      *
  *    as published by the Free Software Foundation, either version 3 of       *
  *    the License, or (at your option) any later version.                     *
  *                                                                            *
- *    This program is distributed in the hope that it will be useful,         *
+ *    Kokopu-React is distributed in the hope that it will be useful,         *
  *    but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the            *
  *    GNU Lesser General Public License for more details.                     *