kokopu-react 3.0.2 → 3.1.0

package/dist/lib/navigationboard/NavigationField.js

@@ -0,0 +1,154 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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 { Variation } from 'kokopu';
+import './NavigationField.css';
+/**
+ * Invisible field, to capture keyboard events.
+ */
+export class NavigationField extends React.Component {
+    constructor() {
+        super(...arguments);
+        this.focusFieldRef = React.createRef();
+    }
+    render() {
+        return (React.createElement("div", { className: "kokopu-focusFieldContainer" },
+            React.createElement("a", { className: "kokopu-focusField", href: "#", ref: this.focusFieldRef, onKeyDown: evt => this.handleKeyDown(evt) })));
+    }
+    handleKeyDown(evt) {
+        /* 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() {
+        const target = this.focusFieldRef.current;
+        // istanbul ignore else
+        if (target) {
+            target.focus();
+        }
+    }
+}
+function doHandleKeyDown(evt, targetKey, targetCallback) {
+    // 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, selection) {
+    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, selection) {
+    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, selection) {
+    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, selection) {
+    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;
+    }
+}
+//# sourceMappingURL=NavigationField.js.map

package/dist/lib/navigationboard/NavigationField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationField.js","sourceRoot":"","sources":["../../../src/navigationboard/NavigationField.tsx"],"names":[],"mappings":"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"}

package/dist/lib/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/dist/lib/navigationboard/NavigationToolbar.d.ts

@@ -0,0 +1,41 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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 './NavigationToolbar.css';
+interface NavigationToolbarProps {
+    flipButtonVisible: boolean;
+    squareSize: number;
+    onFirstClicked?: () => void;
+    onPreviousClicked?: () => void;
+    onNextClicked?: () => void;
+    onLastClicked?: () => void;
+    onFlipClicked?: () => void;
+}
+/**
+ * Toolbar below the navigation board.
+ */
+export declare class NavigationToolbar extends React.Component<NavigationToolbarProps> {
+    render(): React.JSX.Element;
+    private renderFlipButton;
+}
+export {};

package/dist/lib/navigationboard/NavigationToolbar.js

@@ -0,0 +1,124 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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;
+/**
+ * Toolbar below the navigation board.
+ */
+export class NavigationToolbar extends React.Component {
+    render() {
+        const buttonSize = computeButtonSize(this.props.squareSize);
+        const marginTop = Math.round(buttonSize / 4);
+        return (React.createElement("div", { className: "kokopu-navigationToolbar", style: { marginTop: marginTop } },
+            React.createElement(NavigationButton, { size: buttonSize, tooltip: i18n.TOOLTIP_GO_FIRST, path: chevronPath(14, 16, -1) + ' ' + chevronPath(10, 16, -1), onClick: this.props.onFirstClicked }),
+            React.createElement(NavigationButton, { size: buttonSize, tooltip: i18n.TOOLTIP_GO_PREVIOUS, path: chevronPath(12, 16, -1), onClick: this.props.onPreviousClicked }),
+            React.createElement(NavigationButton, { size: buttonSize, tooltip: i18n.TOOLTIP_GO_NEXT, path: chevronPath(20, 16, 1), onClick: this.props.onNextClicked }),
+            React.createElement(NavigationButton, { size: buttonSize, tooltip: i18n.TOOLTIP_GO_LAST, path: chevronPath(18, 16, 1) + ' ' + chevronPath(22, 16, 1), onClick: this.props.onLastClicked }),
+            this.renderFlipButton(buttonSize)));
+    }
+    renderFlipButton(buttonSize) {
+        if (!this.props.flipButtonVisible) {
+            return undefined;
+        }
+        return (React.createElement(React.Fragment, null,
+            React.createElement("div", { className: "kokopu-navigationSpacer" }),
+            React.createElement(NavigationButton, { size: buttonSize, tooltip: i18n.TOOLTIP_FLIP, path: arrowPath(11, 25, 1) + ' ' + arrowPath(21, 7, -1), onClick: this.props.onFlipClicked })));
+    }
+}
+/**
+ * Button for the navigation toolbar.
+ */
+function NavigationButton({ size, tooltip, path, onClick }) {
+    return (React.createElement("div", { className: "kokopu-navigationButton", title: tooltip, onClick: onClick },
+        React.createElement("svg", { viewBox: "0 0 32 32", width: size, height: size },
+            React.createElement("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" }))));
+}
+/**
+ *      * C
+ *     / \
+ *  B *   \
+ *     \   \
+ *      \   \
+ *     A *   * D
+ *      /   /
+ *     /   /
+ *  F *   /
+ *     \ /
+ *      * E
+ *
+ * (x,y) = middle of [AD]
+ */
+function chevronPath(x, y, direction) {
+    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, y, direction) {
+    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) {
+    return Math.round((squareSize * 2 + 116) / 7);
+}
+//# sourceMappingURL=NavigationToolbar.js.map

package/dist/lib/navigationboard/NavigationToolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationToolbar.js","sourceRoot":"","sources":["../../../src/navigationboard/NavigationToolbar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;gFAqBgF;AAIhF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,yBAAyB,CAAC;AAEjC,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,YAAY,GAAG,EAAE,CAAC;AAcxB;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK,CAAC,SAAiC;IAE7E,MAAM;QACL,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC7C,OAAO,CACN,6BAAK,SAAS,EAAC,0BAA0B,EAAC,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;YACxE,oBAAC,gBAAgB,IAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAChI,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAI;YACvC,oBAAC,gBAAgB,IAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EACnG,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAI;YAC1C,oBAAC,gBAAgB,IAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAC9F,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAI;YACtC,oBAAC,gBAAgB,IAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAC7H,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAI;YACrC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAC7B,CACN,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,UAAkB;QAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,CAAC;YACP,6BAAK,SAAS,EAAC,yBAAyB,GAAG;YAC3C,oBAAC,gBAAgB,IAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EACtH,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAI,CACpC,CAAC,CAAC;IACN,CAAC;CAED;AAWD;;GAEG;AACH,SAAS,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAyB;IAChF,OAAO,CACN,6BAAK,SAAS,EAAC,yBAAyB,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;QACxE,6BAAK,OAAO,EAAC,WAAW,EAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI;YACjD,8BAAM,CAAC,EAAE,mDAAmD,IAAI,EAAE,EAAE,IAAI,EAAC,cAAc,GAAG,CACrF,CACD,CACN,CAAC;AACH,CAAC;AAGD;;;;;;;;;;;;;;GAcG;AACH,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,SAAiB;IAC3D,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;AAC9F,CAAC;AAGD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS,EAAE,SAAiB;IACzD,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,YAAY,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;AACtH,CAAC;AAGD;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAAkB;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/doc_src/demo/PageChessboardMove.tsx

@@ -180,6 +180,23 @@ export default class Page extends React.Component<object, PageState> {
 				positionAfter: null,
 			});
 		}
+		else if (move === '--') {
+			const positionAfter = new Position(currentPosition);
+			if (positionAfter.playNullMove()) {
+				this.setState({
+					position: currentPosition,
+					playedMove: '--',
+					positionAfter: positionAfter,
+				});
+			}
+			else {
+				this.setState({
+					position: currentPosition,
+					playedMove: '',
+					positionAfter: null,
+				});
+			}
+		}
 		else {
 			try {
 				const moveDescriptor = currentPosition.notation(move);

package/doc_src/demo/PageNavigationBoardBase.tsx

@@ -0,0 +1,194 @@
+/*!
+ * -------------------------------------------------------------------------- *
+ *                                                                            *
+ *    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 { AnnotationColor, ArrowMarkerIcon, Chessboard, NavigationBoard } from '../../src/index';
+import { buildComponentDemoCode } from './util';
+
+import Box from '@mui/material/Box';
+import FormControl from '@mui/material/FormControl';
+import FormControlLabel from '@mui/material/FormControlLabel';
+import InputLabel from '@mui/material/InputLabel';
+import MenuItem from '@mui/material/MenuItem';
+import Select from '@mui/material/Select';
+import Slider from '@mui/material/Slider';
+import Stack from '@mui/material/Stack';
+import Switch from '@mui/material/Switch';
+import ToggleButton from '@mui/material/ToggleButton';
+import ToggleButtonGroup from '@mui/material/ToggleButtonGroup';
+import Typography from '@mui/material/Typography';
+
+import './demo.css';
+import pgn from './game-3.pgn';
+
+
+const COLOR_ICON_SIZE = 16;
+
+
+interface PageState {
+	squareSize: number;
+	coordinateVisible: boolean;
+	turnVisible: boolean;
+	colorset: string;
+	pieceset: string;
+	moveArrowVisible: boolean;
+	moveArrowColor: AnnotationColor;
+	animated: boolean;
+	flipButtonVisible: boolean;
+}
+
+
+export default class Page extends React.Component<object, PageState> {
+
+	constructor(props: object) {
+		super(props);
+		this.state = {
+			squareSize: 40,
+			coordinateVisible: true,
+			turnVisible: true,
+			colorset: 'original',
+			pieceset: 'cburnett',
+			moveArrowVisible: true,
+			moveArrowColor: 'b',
+			animated: true,
+			flipButtonVisible: true,
+		};
+	}
+
+	render() {
+		return (
+			<Stack spacing={2} mt={2}>
+				{this.renderControls()}
+				{this.renderNavigationBoard()}
+				{this.renderCode()}
+			</Stack>
+		);
+	}
+
+	private renderControls() {
+		return (<>
+			<Stack direction="row" spacing={2} alignItems="center">
+				<FormControlLabel label="Show flip button"
+					control={<Switch checked={this.state.flipButtonVisible} onChange={() => this.setState({ flipButtonVisible: !this.state.flipButtonVisible })} color="primary" />}
+				/>
+				<FormControlLabel label="Show coordinates"
+					control={<Switch checked={this.state.coordinateVisible} onChange={() => this.setState({ coordinateVisible: !this.state.coordinateVisible })} color="primary" />}
+				/>
+				<FormControlLabel label="Show turn"
+					control={<Switch checked={this.state.turnVisible} onChange={() => this.setState({ turnVisible: !this.state.turnVisible })} color="primary" />}
+				/>
+				<FormControlLabel label="Animated"
+					control={<Switch checked={this.state.animated} onChange={() => this.setState({ animated: !this.state.animated })} color="primary" />}
+				/>
+			</Stack>
+			<Box>
+				<Typography gutterBottom>Square size</Typography>
+				<Slider
+					value={this.state.squareSize} onChange={(_, newValue) => this.setState({ squareSize: newValue as number })}
+					min={Chessboard.minSquareSize()} max={Chessboard.maxSquareSize()} step={1} valueLabelDisplay="on" color="primary"
+				/>
+			</Box>
+			<Stack direction="row" spacing={2} alignItems="center">
+				<FormControl variant="standard">
+					<InputLabel id="colorset-label">Colorset</InputLabel>
+					<Select labelId="colorset-label" sx={{ width: '8em' }} value={this.state.colorset} onChange={evt => this.setState({ colorset: evt.target.value })}>
+						{Object.keys(Chessboard.colorsets()).sort().map(colorset => <MenuItem key={colorset} value={colorset}>{colorset}</MenuItem>)}
+					</Select>
+				</FormControl>
+				<FormControl variant="standard">
+					<InputLabel id="pieceset-label">Pieceset</InputLabel>
+					<Select labelId="pieceset-label" sx={{ width: '8em' }} value={this.state.pieceset} onChange={evt => this.setState({ pieceset: evt.target.value })}>
+						{Object.keys(Chessboard.piecesets()).sort().map(pieceset => <MenuItem key={pieceset} value={pieceset}>{pieceset}</MenuItem>)}
+					</Select>
+				</FormControl>
+				<FormControlLabel label="Show move arrow"
+					control={<Switch checked={this.state.moveArrowVisible} onChange={() => this.setState({ moveArrowVisible: !this.state.moveArrowVisible })} color="primary" />}
+				/>
+				{this.renderMoveArrowColorSelector()}
+			</Stack>
+		</>);
+	}
+
+	private renderMoveArrowColorSelector() {
+		if (!this.state.moveArrowVisible) {
+			return undefined;
+		}
+		const colorset = Chessboard.colorsets()['original'];
+		return (
+			<ToggleButtonGroup value={this.state.moveArrowColor} exclusive size="small" onChange={(_, newColor) => this.handleMoveArrowColorChanged(newColor)}>
+				<ToggleButton value="b"><ArrowMarkerIcon size={COLOR_ICON_SIZE} color={colorset.cb} /></ToggleButton>
+				<ToggleButton value="g"><ArrowMarkerIcon size={COLOR_ICON_SIZE} color={colorset.cg} /></ToggleButton>
+				<ToggleButton value="r"><ArrowMarkerIcon size={COLOR_ICON_SIZE} color={colorset.cr} /></ToggleButton>
+				<ToggleButton value="y"><ArrowMarkerIcon size={COLOR_ICON_SIZE} color={colorset.cy} /></ToggleButton>
+			</ToggleButtonGroup>
+		);
+	}
+
+	private renderNavigationBoard() {
+		return (
+			<Box>
+				<NavigationBoard
+					game={pgn}
+					initialNodeId="end"
+					squareSize={this.state.squareSize}
+					coordinateVisible={this.state.coordinateVisible}
+					turnVisible={this.state.turnVisible}
+					colorset={this.state.colorset}
+					pieceset={this.state.pieceset}
+					moveArrowVisible={this.state.moveArrowVisible}
+					moveArrowColor={this.state.moveArrowColor}
+					animated={this.state.animated}
+					flipButtonVisible={this.state.flipButtonVisible}
+				/>
+			</Box>
+		);
+	}
+
+	private renderCode() {
+		const attributes: string[] = [];
+		attributes.push('game={pgn}');
+		attributes.push('initialNodeId="end"');
+		attributes.push(`squareSize={${this.state.squareSize}}`);
+		attributes.push(`coordinateVisible={${this.state.coordinateVisible}}`);
+		attributes.push(`turnVisible={${this.state.turnVisible}}`);
+		attributes.push(`colorset="${this.state.colorset}"`);
+		attributes.push(`pieceset="${this.state.pieceset}"`);
+		attributes.push(`moveArrowVisible={${this.state.moveArrowVisible}}`);
+		if (this.state.moveArrowVisible) {
+			attributes.push(`moveArrowColor="${this.state.moveArrowColor}"`);
+		}
+		attributes.push(`animated={${this.state.animated}}`);
+		attributes.push(`flipButtonVisible={${this.state.flipButtonVisible}}`);
+		const pgnDeclaration = 'const pgn = `\n' + pgn.trim() + '`;\n\n';
+		return <pre className="kokopu-demoCode">{pgnDeclaration + buildComponentDemoCode('NavigationBoard', attributes)}</pre>;
+	}
+
+	private handleMoveArrowColorChanged(newColor: AnnotationColor | null) {
+		if (newColor !== null) {
+			this.setState({ moveArrowColor: newColor });
+		}
+	}
+
+}