kokopu-react 3.0.2 → 3.1.0

package/src/navigationboard/NavigationField.tsx

@@ -0,0 +1,185 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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/>.                                         *
+ *                                                                            *
+ * -------------------------------------------------------------------------- */
+
+
+import * as React from 'react';
+
+import { Game, Variation } from 'kokopu';
+
+import './NavigationField.css';
+
+
+interface NavigationFieldProps {
+	onFirstPressed?: () => void;
+	onPreviousPressed?: () => void;
+	onNextPressed?: () => void;
+	onLastPressed?: () => void;
+	onExitPressed?: () => void;
+}
+
+
+/**
+ * Invisible field, to capture keyboard events.
+ */
+export class NavigationField extends React.Component<NavigationFieldProps> {
+
+	private focusFieldRef: React.RefObject<HTMLAnchorElement> = React.createRef();
+
+	render() {
+		return (
+			<div className="kokopu-focusFieldContainer">
+				<a className="kokopu-focusField" href="#" ref={this.focusFieldRef} onKeyDown={evt => this.handleKeyDown(evt)}></a>
+			</div>
+		);
+	}
+
+	private handleKeyDown(evt: React.KeyboardEvent<HTMLAnchorElement>) {
+		/* eslint-disable no-unused-expressions */
+		doHandleKeyDown(evt, 'Home', this.props.onFirstPressed) ||
+		doHandleKeyDown(evt, 'ArrowLeft', this.props.onPreviousPressed) ||
+		doHandleKeyDown(evt, 'ArrowRight', this.props.onNextPressed) ||
+		doHandleKeyDown(evt, 'End', this.props.onLastPressed) ||
+		doHandleKeyDown(evt, 'Escape', this.props.onExitPressed);
+		/* eslint-enable */
+	}
+
+	/**
+	 * Set the focus to the component.
+	 */
+	focus(): void {
+		const target = this.focusFieldRef.current;
+		// istanbul ignore else
+		if (target) {
+			target.focus();
+		}
+	}
+
+}
+
+
+function doHandleKeyDown(evt: React.KeyboardEvent<HTMLAnchorElement>, targetKey: string, targetCallback: (() => void) | undefined) {
+
+	// Skip if the pressed key does not match the target key.
+	if (evt.key !== targetKey) {
+		return false;
+	}
+
+	// Otherwise, invoke the callback.
+	if (targetCallback) {
+		evt.preventDefault();
+		targetCallback();
+	}
+	return true;
+}
+
+
+/**
+ * Return the ID of the main variation in the given chess game.
+ * If the given selection corresponds already at the main variation, `undefined` is returned.
+ *
+ * @param game - Considered chess game.
+ * @param selection - ID of the selected move (or `'start'` for the beginning of the main variation).
+ * @public
+ */
+export function firstNodeId(game: Game, selection: string): string | undefined {
+	if (!game.findById(selection)) {
+		return undefined;
+	}
+	return selection === 'start' ? undefined : 'start';
+}
+
+
+/**
+ * Return the ID of the node immediately preceding the given selection in the given chess game.
+ * If no such node exists, `undefined` is returned.
+ *
+ * @param game - Considered chess game.
+ * @param selection - ID of the selected move (or `'start'` for the beginning of the main variation).
+ * @public
+ */
+export function previousNodeId(game: Game, selection: string): string | undefined {
+	let currentNode = game.findById(selection);
+	if (!currentNode) {
+		return undefined;
+	}
+	if (currentNode instanceof Variation) {
+		currentNode = currentNode.parentNode();
+		if (!currentNode) {
+			return undefined; // This case corresponds to the first variation being selected initially.
+		}
+	}
+	while (currentNode) {
+		const previousNode = currentNode.previous();
+		if (previousNode) {
+			return previousNode.id();
+		}
+		currentNode = currentNode.parentVariation().parentNode();
+	}
+	return 'start';
+}
+
+
+/**
+ * Return the ID of the node immediately following the given selection in the given chess game.
+ * If no such node exists, `undefined` is returned.
+ *
+ * @param game - Considered chess game.
+ * @param selection - ID of the selected move (or `'start'` for the beginning of the main variation).
+ * @public
+ */
+export function nextNodeId(game: Game, selection: string): string | undefined {
+	const currentNode = game.findById(selection);
+	if (!currentNode) {
+		return undefined;
+	}
+	const nextNode = currentNode instanceof Variation ? currentNode.first() : currentNode.next();
+	return nextNode ? nextNode.id() : undefined;
+}
+
+
+/**
+ * Return the ID of the node at then end of the variation in which lies the given selection in the given chess game.
+ * If the selection is already at the end its variation, `undefined` is returned.
+ *
+ * @param game - Considered chess game.
+ * @param selection - ID of the selected move (or `'start'` for the beginning of the main variation).
+ * @public
+ */
+export function lastNodeId(game: Game, selection: string): string | undefined {
+	let currentNode = game.findById(selection);
+	if (!currentNode) {
+		return undefined;
+	}
+	currentNode = currentNode instanceof Variation ? currentNode.first() : currentNode.next();
+	if (!currentNode) { // Ensure that the input node is not already the last one.
+		return undefined;
+	}
+	let currentNodeNotNull = currentNode;
+	while (true) {
+		const nextNode = currentNodeNotNull.next();
+		if (!nextNode) {
+			return currentNodeNotNull.id();
+		}
+		currentNodeNotNull = nextNode;
+	}
+}

package/src/navigationboard/NavigationToolbar.css

@@ -0,0 +1,51 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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/>.                                         *
+ *                                                                            *
+ * -------------------------------------------------------------------------- */
+
+
+.kokopu-navigationBoard {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+}
+
+.kokopu-navigationToolbar {
+	line-height: 0px;
+}
+
+.kokopu-navigationButton {
+	display: inline-block;
+	cursor: pointer;
+}
+
+.kokopu-navigationButton:hover {
+	opacity: 0.6;
+}
+
+* + .kokopu-navigationButton {
+	margin-left: 2px;
+}
+
+.kokopu-navigationSpacer {
+	display: inline-block;
+	width: 10px;
+}

package/src/navigationboard/NavigationToolbar.tsx

@@ -0,0 +1,174 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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/>.                                         *
+ *                                                                            *
+ * -------------------------------------------------------------------------- */
+
+
+
+import * as React from 'react';
+
+import { i18n } from '../i18n';
+
+import './NavigationToolbar.css';
+
+const THICKNESS = 2;
+const CHEVRON_SIZE = 7;
+const ARROW_SIZE = 5;
+const ARROW_LENGTH = 16;
+
+
+interface NavigationToolbarProps {
+	flipButtonVisible: boolean;
+	squareSize: number;
+	onFirstClicked?: () => void;
+	onPreviousClicked?: () => void;
+	onNextClicked?: () => void;
+	onLastClicked?: () => void;
+	onFlipClicked?: () => void;
+}
+
+
+/**
+ * Toolbar below the navigation board.
+ */
+export class NavigationToolbar extends React.Component<NavigationToolbarProps> {
+
+	render() {
+		const buttonSize = computeButtonSize(this.props.squareSize);
+		const marginTop = Math.round(buttonSize / 4);
+		return (
+			<div className="kokopu-navigationToolbar" style={{ marginTop: marginTop }}>
+				<NavigationButton size={buttonSize} tooltip={i18n.TOOLTIP_GO_FIRST} path={chevronPath(14, 16, -1) + ' ' + chevronPath(10, 16, -1)}
+					onClick={this.props.onFirstClicked} />
+				<NavigationButton size={buttonSize} tooltip={i18n.TOOLTIP_GO_PREVIOUS} path={chevronPath(12, 16, -1)}
+					onClick={this.props.onPreviousClicked} />
+				<NavigationButton size={buttonSize} tooltip={i18n.TOOLTIP_GO_NEXT} path={chevronPath(20, 16, 1)}
+					onClick={this.props.onNextClicked} />
+				<NavigationButton size={buttonSize} tooltip={i18n.TOOLTIP_GO_LAST} path={chevronPath(18, 16, 1) + ' ' + chevronPath(22, 16, 1)}
+					onClick={this.props.onLastClicked} />
+				{this.renderFlipButton(buttonSize)}
+			</div>
+		);
+	}
+
+	private renderFlipButton(buttonSize: number) {
+		if (!this.props.flipButtonVisible) {
+			return undefined;
+		}
+		return (<>
+			<div className="kokopu-navigationSpacer" />
+			<NavigationButton size={buttonSize} tooltip={i18n.TOOLTIP_FLIP} path={arrowPath(11, 25, 1) + ' ' + arrowPath(21, 7, -1)}
+				onClick={this.props.onFlipClicked} />
+		</>);
+	}
+
+}
+
+
+interface NavigationButtonProps {
+	size: number;
+	tooltip: string;
+	path: string;
+	onClick?: () => void;
+}
+
+
+/**
+ * Button for the navigation toolbar.
+ */
+function NavigationButton({ size, tooltip, path, onClick }: NavigationButtonProps) {
+	return (
+		<div className="kokopu-navigationButton" title={tooltip} onClick={onClick}>
+			<svg viewBox="0 0 32 32" width={size} height={size}>
+				<path d={`M 16 0 A 16 16 0 0 0 16 32 A 16 16 0 0 0 16 0 Z ${path}`} fill="currentcolor" />
+			</svg>
+		</div>
+	);
+}
+
+
+/**
+ *      * C
+ *     / \
+ *  B *   \
+ *     \   \
+ *      \   \
+ *     A *   * D
+ *      /   /
+ *     /   /
+ *  F *   /
+ *     \ /
+ *      * E
+ *
+ * (x,y) = middle of [AD]
+ */
+function chevronPath(x: number, y: number, direction: 1 | -1) {
+	const xA = x - direction * THICKNESS * Math.sqrt(2) / 2;
+	const xB = x - direction * (CHEVRON_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const xC = x - direction * (CHEVRON_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	const xD = x + direction * THICKNESS * Math.sqrt(2) / 2;
+	const yB = y - direction * (CHEVRON_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	const yC = y - direction * (CHEVRON_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const yE = y + direction * (CHEVRON_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const yF = y + direction * (CHEVRON_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	return `M ${xA} ${y} L ${xB} ${yB} L ${xC} ${yC} L ${xD} ${y} L ${xC} ${yE} L ${xB} ${yF} Z`;
+}
+
+
+/**
+ *      D +---+ E
+ *        |   |
+ *        |   |
+ *        |   |
+ *   B *  |   |  * G
+ *    / \ |   | / \
+ * A *   \|   |/   * H
+ *    \   *   *   /
+ *     \  C   F  /
+ *      \   O   /
+ *       \  *  /
+ *        \   /
+ *         \ /
+ *          *
+ *        (x,y)
+ */
+function arrowPath(x: number, y: number, direction: 1 | -1) {
+	const xA = x - direction * (ARROW_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const xB = x - direction * (ARROW_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	const xC = x - direction * THICKNESS / 2;
+	const xF = x + direction * THICKNESS / 2;
+	const xG = x + direction * (ARROW_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	const xH = x + direction * (ARROW_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const y0 = y - direction * THICKNESS * Math.sqrt(2) / 2;
+	const yA = y0 - direction * (ARROW_SIZE - THICKNESS / Math.sqrt(2) / 2);
+	const yB = y0 - direction * (ARROW_SIZE + THICKNESS / Math.sqrt(2) / 2);
+	const yC = yB + (xC - xB);
+	const yD = y - direction * ARROW_LENGTH;
+	return `M ${x} ${y} L ${xA} ${yA} L ${xB} ${yB} L ${xC} ${yC} V ${yD} H ${xF} V ${yC} L ${xG} ${yB} L ${xH} ${yA} Z`;
+}
+
+
+/**
+ * Return the height/width of the buttons assuming the given square size.
+ */
+function computeButtonSize(squareSize: number) {
+	return Math.round((squareSize * 2 + 116) / 7);
+}

package/test/05_chessboard_graphic.js

@@ -64,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/09_chessboard_small_screens.js

@@ -50,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

@@ -57,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

@@ -59,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') },
 	]);
@@ -111,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',
+	]);
+
+});