kokopu-react 1.11.0 → 2.0.0

package/src/Movetext.js

@@ -1,671 +0,0 @@
-/******************************************************************************
- *                                                                            *
- *    This file is part of Kokopu-React, a JavaScript chess library.          *
- *    Copyright (C) 2021-2023  Yoann Le Montagner <yo35 -at- melix.net>       *
- *                                                                            *
- *    This program 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,         *
- *    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 PropTypes from 'prop-types';
-import React from 'react';
-import { exception, Database, Game, nagSymbol, pgnRead } from 'kokopu';
-
-import HtmlSanitizer from './impl/HtmlSanitizer';
-import { fillPlaceholder } from './impl/util';
-import Chessboard from './Chessboard';
-import ErrorBox from './ErrorBox';
-import { moveFormatter } from './formatmove';
-import i18n from './i18n';
-
-import './css/movetext.css';
-
-
-/**
- * Display a chess game, i.e. the headers (name of the players, event, etc.), the moves, and all the related annotations if any (comments, variations, NAGs...).
- */
-export default class Movetext extends React.Component {
-
-	constructor(props) {
-		super(props);
-		this.focusFieldRef = React.createRef();
-	}
-
-	render() {
-		let info = parseGame(this.props.game, this.props.gameIndex);
-		if (info.error) {
-			return <ErrorBox title={i18n.INVALID_PGN_ERROR_TITLE} message={info.message} text={info.text} errorIndex={info.errorIndex} lineNumber={info.lineNumber} />;
-		}
-		return (
-			<div className="kokopu-movetext">
-				{this.renderHeaders(info.game)}
-				{this.renderBody(info.game)}
-				{this.renderFocusField(info.game)}
-			</div>
-		);
-	}
-
-	renderHeaders(game) {
-		if (!this.props.headerVisible) {
-			return undefined;
-		}
-		let headers = [];
-		headers.push(this.renderPlayerHeaders(game, 'w'));
-		headers.push(this.renderPlayerHeaders(game, 'b'));
-		headers.push(this.renderEventRoundHeaders(game));
-		headers.push(this.renderDateSiteHeaders(game));
-		headers.push(this.renderAnnotatorHeader(game));
-		return headers.some(element => element !== undefined) ? <div className="kokopu-headers">{headers}</div> : undefined;
-	}
-
-	/**
-	 * Header containing the player-related information (name, rating, title) corresponding to the given color.
-	 */
-	renderPlayerHeaders(game, color) {
-		let playerName = game.playerName(color);
-		if (playerName === undefined) {
-			return undefined;
-		}
-		let title = game.playerTitle(color);
-		let rating = game.playerElo(color);
-
-		let classNames = [ 'kokopu-headerGroup-player', color === 'w' ? 'kokopu-headerGroup-whitePlayer' : 'kokopu-headerGroup-blackPlayer' ];
-		let colorTag = <span className="kokopu-colorTag"></span>;
-		let playerNameElement = <span className="kokopu-header-playerName">{sanitizeHtml(playerName)}</span>;
-		let titleElement = title === undefined ? undefined : <span className="kokopu-header-playerTitle">{sanitizeHtml(title)}</span>;
-		let ratingElement = rating === undefined ? undefined : <span className="kokopu-header-playerRating">{rating}</span>;
-		let separator = title === undefined || rating === undefined ? undefined : '\u00a0'; // \u00a0 == &nbsp;
-		let titleRatingGroup = title === undefined && rating === undefined ? undefined : <span className="kokopu-headerGroup-titleRating">{titleElement}{separator}{ratingElement}</span>;
-		return <div className={classNames.join(' ')} key={'player-' + color}>{colorTag}{playerNameElement}{titleRatingGroup}</div>;
-	}
-
-	/**
-	 * Header containing the event-related information: event + round.
-	 */
-	renderEventRoundHeaders(game) {
-		let evt = game.event();
-		if (evt === undefined) {
-			return undefined;
-		}
-		let fullRound = game.fullRound();
-		let roundElement = fullRound === undefined ? undefined : <span className="kokopu-header-round">{fullRound}</span>;
-		let evtElement = <span className="kokopu-header-event">{sanitizeHtml(evt)}</span>;
-		return <div className="kokopu-headerGroup-eventRound" key="event-round">{evtElement}{roundElement}</div>;
-	}
-
-	/**
-	 * Header containing the date/place information.
-	 */
-	renderDateSiteHeaders(game) {
-		let date = game.date();
-		let site = game.site();
-		if(date === undefined && site === undefined) {
-			return undefined;
-		}
-		let dateElement = date === undefined ? undefined : <span className="kokopu-header-date">{capitalizeFirstWord(game.dateAsString())}</span>;
-		let siteElement = site === undefined ? undefined : <span className="kokopu-header-site">{sanitizeHtml(site)}</span>;
-		let separator = date === undefined || site === undefined ? undefined : '\u00a0\u2013\u00a0'; // \u00a0 == &nbsp;   \u2013 == &ndash;
-		return <div className="kokopu-headerGroup-dateSite" key="date-site">{dateElement}{separator}{siteElement}</div>;
-	}
-
-	/**
-	 * Header containing the annotator information.
-	 */
-	renderAnnotatorHeader(game) {
-		let annotator = game.annotator();
-		if (annotator === undefined) {
-			return undefined;
-		}
-		annotator = fillPlaceholder(i18n.ANNOTATED_BY, annotator);
-		return <div className="kokopu-header-annotator" key="annotator">{sanitizeHtml(annotator)}</div>;
-	}
-
-	renderFocusField(game) {
-		if (this.props.interactionMode !== 'selectMove') {
-			return undefined;
-		}
-		return (
-			<div className="kokopu-focusFieldContainer">
-				<a className="kokopu-focusField" href="#" ref={this.focusFieldRef} onKeyDown={evt => this.handleKeyDownInFocusField(evt, game)}></a>
-			</div>
-		);
-	}
-
-	renderBody(game) {
-		let notationTextBuilder = moveFormatter(this.props.pieceSymbols);
-		return this.renderVariation(notationTextBuilder, game.mainVariation(), 'main-variation', true, game.result());
-	}
-
-	/**
-	 * Render the given variation and its sub-variations, recursively.
-	 */
-	renderVariation(notationTextBuilder, variation, variationKey, isMainVariation, gameResult) {
-
-		let moveGroups = []; // ... and also long comments and long sub-variations
-		let currentMoveGroupElements = [];
-
-		// Close the current move group, if any.
-		function closeMoveGroup() {
-			if (!variation.isLongVariation() || currentMoveGroupElements.length === 0) {
-				return;
-			}
-			moveGroups.push(<div className="kokopu-moveGroup" key={'group-' + moveGroups.length}>{currentMoveGroupElements}</div>);
-			currentMoveGroupElements = [];
-		}
-
-		// Write the initial comment, if any.
-		let variationComment = this.extractComment(variation);
-		if (variationComment !== undefined) {
-			if (variation.isLongComment()) {
-				moveGroups.push(this.renderComment(variation, variationComment, true));
-			}
-			else {
-				currentMoveGroupElements.push(this.renderComment(variation, variationComment, true));
-			}
-		}
-
-		// Visit all the PGN nodes (one node per move) within the variation.
-		let forcePrintMoveNumber = true;
-		let node = variation.first();
-		while (node !== undefined) {
-
-			// Write the move, including directly related information (i.e. move number + NAGs).
-			currentMoveGroupElements.push(this.renderMove(notationTextBuilder, node, forcePrintMoveNumber));
-
-			// Write the comment (if any).
-			let nodeComment = this.extractComment(node);
-			if (nodeComment !== undefined) {
-				if (node.isLongComment()) {
-					closeMoveGroup();
-					moveGroups.push(this.renderComment(node, nodeComment, false));
-				}
-				else {
-					currentMoveGroupElements.push(this.renderComment(node, nodeComment, false));
-				}
-			}
-
-			// Write the sub-variations.
-			let hasNonEmptySubVariations = false;
-			for (let [index, subVariation] of node.variations().entries()) {
-				let subVariationElement = this.renderVariation(notationTextBuilder, subVariation, node.fullMoveNumber() + node.moveColor() + '-variation-' + index, false);
-				if (subVariationElement) {
-					if (subVariation.isLongVariation()) {
-						closeMoveGroup();
-						moveGroups.push(subVariationElement);
-					}
-					else {
-						currentMoveGroupElements.push(subVariationElement);
-					}
-					hasNonEmptySubVariations = true;
-				}
-			}
-
-			// Back to the current variation, go to the next move.
-			forcePrintMoveNumber = (nodeComment !== undefined || hasNonEmptySubVariations);
-			node = node.next();
-		}
-
-		// Append the game result at the end of the main variation.
-		if (isMainVariation && gameResult !== '*') {
-			currentMoveGroupElements.push(<span className="kokopu-gameResult" key="gameResult">{formatResult(gameResult)}</span>);
-		}
-
-		// Close the last move group, and return the result.
-		closeMoveGroup();
-		let elements = variation.isLongVariation() ? moveGroups : currentMoveGroupElements;
-		if (elements.length === 0) {
-			return undefined;
-		}
-		if (isMainVariation) {
-			return <div className="kokopu-variation kokopu-mainVariation" key={variationKey}>{elements}</div>;
-		}
-		else if (variation.isLongVariation()) {
-			return <div className="kokopu-variation kokopu-subVariation" key={variationKey}>{elements}</div>;
-		}
-		else {
-			return <span className="kokopu-variation kokopu-subVariation" key={variationKey}>{elements}</span>;
-		}
-	}
-
-	/**
-	 * Render the given move, move number, and NAG (if any).
-	 */
-	renderMove(notationTextBuilder, node, forcePrintMoveNumber) {
-
-		// Move number
-		let moveNumber = undefined;
-		if (forcePrintMoveNumber || node.moveColor() === 'w') {
-			let moveNumberText  = node.fullMoveNumber() + (node.moveColor() === 'w' ? '.' : '\u2026');
-			moveNumber = <span className="kokopu-moveNumber">{moveNumberText}</span>;
-		}
-
-		// SAN notation.
-		let notationText = notationTextBuilder(node.notation());
-
-		// NAGs
-		let nagElements = node.nags().map(nag => <span className="kokopu-nag" key={nag}>{nagSymbol(nag)}</span>);
-
-		// Class
-		let nodeId = node.id();
-		let moveClassNames = [ 'kokopu-move' ];
-		let onClick = undefined;
-		if (this.props.selection && this.props.selection === nodeId) {
-			moveClassNames.push('kokopu-selectedMove');
-		}
-		if (this.props.interactionMode === 'selectMove') {
-			moveClassNames.push('kokopu-clickableMove');
-			onClick = () => this.handleNodeClicked(nodeId);
-		}
-
-		return (
-			<span className={moveClassNames.join(' ')} key={node.fullMoveNumber() + node.moveColor()}>
-				<span className="kokopu-moveContent" onClick={onClick}>
-					{moveNumber}
-					<span className="kokopu-moveNotation">{notationText}</span>
-					{nagElements.length === 0 ? undefined : nagElements}
-				</span>
-			</span>
-		);
-	}
-
-	/**
-	 * Render the given text comment with its diagrams, if any.
-	 */
-	renderComment(node, comment, isVariation) {
-		let content;
-		let sanitizer = createSanitizer(true);
-		if (this.props.diagramVisible && comment.includes('[#]')) {
-			content = [];
-			let isFirstPart = true;
-			for (let [index, part] of comment.split('[#]').entries()) {
-				if (!isFirstPart) {
-					let position = isVariation ? node.initialPosition() : node.position();
-					let diagram = <Chessboard position={position} squareMarkers={node.tag('csl')} arrowMarkers={node.tag('cal')} textMarkers={node.tag('ctl')}
-						flipped={this.props.diagramOptions.flipped}
-						squareSize={this.props.diagramOptions.squareSize}
-						coordinateVisible={this.props.diagramOptions.coordinateVisible}
-						smallScreenLimits={this.props.diagramOptions.smallScreenLimits}
-						colorset={this.props.diagramOptions.colorset}
-						pieceset={this.props.diagramOptions.pieceset}
-					/>;
-					content.push(<div className="kokopu-diagram" key={'diagram-' + index}>{diagram}</div>);
-				}
-				isFirstPart = false;
-				part = part.trim();
-				if (part.length !== 0) {
-					content.push(sanitizeHtml(part, sanitizer));
-				}
-			}
-		}
-		else {
-			content = sanitizeHtml(comment, sanitizer);
-		}
-		let key = isVariation ? 'initial-comment' : node.fullMoveNumber() + node.moveColor() + '-comment';
-		return node.isLongComment() ? <div className="kokopu-comment" key={key}>{content}</div> : <span className="kokopu-comment" key={key}>{content}</span>;
-	}
-
-	extractComment(node) {
-		let comment = node.comment();
-		if (comment) {
-
-			// Remove the diagrams if necessary.
-			if (!this.props.diagramVisible) {
-				comment = comment.replace(/\[#\]/g, ' ');
-			}
-
-			// Trim and sanitize the space characters.
-			comment = comment.replace(/\s+/g, ' ').trim();
-		}
-		return comment ? comment : undefined;
-	}
-
-	handleKeyDownInFocusField(evt, game) {
-		if (evt.key !== 'Home' && evt.key !== 'ArrowLeft' && evt.key !== 'ArrowRight' && evt.key !== 'End') {
-			return;
-		}
-		evt.preventDefault();
-		if (!this.props.selection) {
-			return;
-		}
-		let nodeId = undefined;
-		let evtOrigin = '';
-		if (evt.key === 'Home') {
-			nodeId = Movetext.firstNodeId(game, this.props.selection);
-			evtOrigin = 'key-first';
-		}
-		else if (evt.key === 'ArrowLeft') {
-			nodeId = Movetext.previousNodeId(game, this.props.selection);
-			evtOrigin = 'key-previous';
-		}
-		else if (evt.key === 'ArrowRight') {
-			nodeId = Movetext.nextNodeId(game, this.props.selection);
-			evtOrigin = 'key-next';
-		}
-		else { // evt.key === 'End'
-			nodeId = Movetext.lastNodeId(game, this.props.selection);
-			evtOrigin = 'key-last';
-		}
-		if (nodeId && this.props.onMoveSelected) {
-			this.props.onMoveSelected(nodeId, evtOrigin);
-		}
-	}
-
-	handleNodeClicked(nodeId) {
-		this.focus();
-		if (this.props.onMoveSelected) {
-			this.props.onMoveSelected(nodeId === this.props.selection ? undefined : nodeId, 'click');
-		}
-	}
-
-	/**
-	 * Set the focus to the current component.
-	 *
-	 * @public
-	 */
-	focus() {
-		this.focusFieldRef.current.focus();
-	}
-
-	/**
-	 * 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.
-	 *
-	 * This corresponds to the operation performed when the user presses key "home" on a `Movetext` component.
-	 *
-	 * @param {kokopu.Game} game Considered chess game.
-	 * @param {string} selection ID of the selected move (or `'start'` for the beginning of the main variation).
-	 * @returns {string?}
-	 * @public
-	 */
-	static 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.
-	 *
-	 * This corresponds to the operation performed when the user presses key "arrow left" on a `Movetext` component.
-	 *
-	 * @param {kokopu.Game} game Considered chess game.
-	 * @param {string} selection ID of the selected move (or `'start'` for the beginning of the main variation).
-	 * @returns {string?}
-	 * @public
-	 */
-	static previousNodeId(game, selection) {
-		let currentNode = game.findById(selection);
-		if (!currentNode) {
-			return undefined;
-		}
-		if (selection === 'start') {
-			return undefined;
-		}
-		else if (selection.endsWith('start')) {
-			currentNode = currentNode.parentNode(); // `.parentNode()` returns always non-null ref here
-		}
-		while (currentNode) {
-			let 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.
-	 *
-	 * This corresponds to the operation performed when the user presses key "arrow right" on a `Movetext` component.
-	 *
-	 * @param {kokopu.Game} game Considered chess game.
-	 * @param {string} selection ID of the selected move (or `'start'` for the beginning of the main variation).
-	 * @returns {string?}
-	 * @public
-	 */
-	static nextNodeId(game, selection) {
-		let currentNode = game.findById(selection);
-		if (!currentNode) {
-			return undefined;
-		}
-		let nextNode = selection.endsWith('start') ? 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.
-	 *
-	 * This corresponds to the operation performed when the user presses key "end" on a `Movetext` component.
-	 *
-	 * @param {kokopu.Game} game Considered chess game.
-	 * @param {string} selection ID of the selected move (or `'start'` for the beginning of the main variation).
-	 * @returns {string?}
-	 * @public
-	 */
-	static lastNodeId(game, selection) {
-		let currentNode = game.findById(selection);
-		if (!currentNode) {
-			return undefined;
-		}
-		currentNode = selection.endsWith('start') ? currentNode.first() : currentNode.next();
-		if (!currentNode) { // Ensure that the input node is not already the last one.
-			return undefined;
-		}
-		while (true) {
-			let nextNode = currentNode.next();
-			if (!nextNode) {
-				return currentNode.id();
-			}
-			currentNode = nextNode;
-		}
-	}
-}
-
-
-Movetext.propTypes = {
-
-	/**
-	 * Displayed position. Can be a [kokopu.Game](https://kokopu.yo35.org/docs/current/classes/Game.html) object,
-	 * a [kokopu.Database](https://kokopu.yo35.org/docs/current/classes/Database.html) object,
-	 * or a [PGN string](https://en.wikipedia.org/wiki/Portable_Game_Notation).
-	 */
-	game: PropTypes.oneOfType([
-		PropTypes.instanceOf(Game),
-		PropTypes.instanceOf(Database),
-		PropTypes.string
-	]),
-
-	/**
-	 * Index of the game to display (only if attribute `game` is a [kokopu.Database](https://kokopu.yo35.org/docs/current/classes/Database.html)
-	 * or a [PGN string](https://en.wikipedia.org/wiki/Portable_Game_Notation)): `0` for the first game of the database/PGN, `1` for the second one, etc.
-	 * If omitted, the first game of the database/PGN is displayed.
-	 */
-	gameIndex: PropTypes.number,
-
-	/**
-	 * Options applicable to the diagrams in the comments. See [Chessboard](#/Components/Chessboard) for more details about each option.
-	 */
-	diagramOptions: PropTypes.shape({
-		flipped: Chessboard.propTypes.flipped,
-		squareSize: Chessboard.propTypes.squareSize,
-		coordinateVisible: Chessboard.propTypes.coordinateVisible,
-		smallScreenLimits: Chessboard.propTypes.smallScreenLimits,
-		colorset: Chessboard.propTypes.colorset,
-		pieceset: Chessboard.propTypes.pieceset,
-	}),
-
-	/**
-	 * Symbols to use for the chess pieces. Can be:
-	 * - `'native'`: use the first letter of the piece names (in English),
-	 * - `'localized'`: use the symbols defined by `i18n.PIECE_SYMBOLS`,
-	 * - `'figurines'`: use the figurines,
-	 * - or an object defining 6 string-valued properties named `K`, `Q`, `R`, `B`, `N` and `P`.
-	 */
-	pieceSymbols: PropTypes.oneOfType([
-		PropTypes.oneOf([ 'native', 'localized', 'figurines' ]),
-		PropTypes.shape({
-			K: PropTypes.string.isRequired,
-			Q: PropTypes.string.isRequired,
-			R: PropTypes.string.isRequired,
-			B: PropTypes.string.isRequired,
-			N: PropTypes.string.isRequired,
-			P: PropTypes.string.isRequired
-		})
-	]),
-
-	/**
-	 * Whether the diagrams within the comments (if any) are displayed or not.
-	 */
-	diagramVisible: PropTypes.bool,
-
-	/**
-	 * Whether the game headers (if any) are displayed or not.
-	 */
-	headerVisible: PropTypes.bool,
-
-	/**
-	 * ID of the selected move (or `'start'` for the beginning of the main variation).
-	 * Use [kokopu.Node#id](https://kokopu.yo35.org/docs/current/classes/Node.html#id) to get the ID of a game move.
-	 */
-	selection: PropTypes.string,
-
-	/**
-	 * Type of action allowed with the mouse/keys on the component. If undefined, then the user cannot interact with the component.
-	 *
-	 * - `'selectMove'` allows the user to select a move.
-	 */
-	interactionMode: PropTypes.oneOf([ 'selectMove' ]),
-
-	/**
-	 * Callback invoked when the user selects a move (only if `interactionMode` is set to `'selectMove'`).
-	 *
-	 * @param {string?} nodeId ID of the selected move (as returned by [kokopu.Node#id](https://kokopu.yo35.org/docs/current/classes/Node.html#id)),
-	 *                         `'start'` for the beginning of the main variation, or `undefined` if the user unselects the previously selected move.
-	 * @param {string} evtOrigin Origin of the event. Can be:
-	 *                        - `'key-first'`: the event has been triggered by the "go-to-first-move" key (aka. the home key),
-	 *                        - `'key-previous'`: the event has been triggered by the "go-to-previous-move" key (aka. the arrow left key),
-	 *                        - `'key-next'`: the event has been triggered by the "go-to-next-move" key (aka. the arrow right key),
-	 *                        - `'key-last'`: the event has been triggered by the "go-to-last-move" key (aka. the end key),
-	 *                        - `'click'`: the event has been triggered by a mouse click on a move.
-	 */
-	onMoveSelected: PropTypes.func,
-};
-
-
-Movetext.defaultProps = {
-	game: new Game(),
-	gameIndex: 0,
-	diagramOptions: {},
-	pieceSymbols: 'native',
-	diagramVisible: true,
-	headerVisible: true,
-};
-
-
-/**
- * Example: `'hello world'` is turned into `'Hello world'`.
- */
-function capitalizeFirstWord(text) {
-	return text.length===0 ? '' : text.charAt(0).toUpperCase() + text.slice(1);
-}
-
-
-function formatResult(result) {
-	switch (result) {
-		case '1/2-1/2': return '\u00bd\u2013\u00bd';
-		case '1-0': return '1\u20130';
-		case '0-1': return '0\u20131';
-	}
-}
-
-
-function createSanitizer(withBlockTags) {
-	let allowedTags = [
-		'span', // general purpose
-		'a', // links
-		'b', 'strong', 'i', 'em', // bold, italic
-		'del', 'ins', 's', 'u', // underline, strikethrough
-		'sub', 'sup', // subscript, superscript
-		'abbr', // acronym (typically associated to a title=".." tooltip)
-		'q', 'cite', // quotation and title of a work
-		'mark', // highlighted text
-		'small', // smaller text
-	];
-	let allowedAttributes = {
-		'*': [ 'class', 'id', 'title' ],
-		'a': [ 'href', 'target' ],
-	};
-	if (withBlockTags) {
-		allowedTags = allowedTags.concat([
-			'div', // general purpose
-			'h1', 'h2', 'h3', 'h4', 'h5', 'h6', // headings
-			'p', 'br', // paragraph and line break
-			'blockquote', // long quotation
-			'img', // image
-			'pre', // preformatted text
-			'ul', 'ol', 'li', // lists
-		]);
-		Object.assign(allowedAttributes, {
-			'img': [ 'alt', 'src', 'height', 'width' ],
-		});
-	}
-	return new HtmlSanitizer({ allowedTags: allowedTags, allowedAttributes: allowedAttributes });
-}
-
-
-function sanitizeHtml(text, sanitizer) {
-	if (!sanitizer) {
-		sanitizer = createSanitizer(false);
-	}
-	let result = sanitizer.parse(text);
-	return result ?? text;
-}
-
-
-/**
- * Try to interpret the given object as a chess game.
- */
-function parseGame(game, gameIndex) {
-	if (game instanceof Game) {
-		return { error: false, game: game };
-	}
-	else if (game instanceof Database || typeof game === 'string') {
-		if (!Number.isInteger(gameIndex) || gameIndex < 0) {
-			return { error: true, message: i18n.INVALID_GAME_INDEX_ATTRIBUTE_ERROR_MESSAGE };
-		}
-		try {
-			const result = game instanceof Database ? game.game(gameIndex) : pgnRead(game, gameIndex);
-			return { error: false, game: result };
-		}
-		catch (e) {
-			// istanbul ignore else
-			if (e instanceof exception.InvalidPGN) {
-				return { error: true, message: e.message, text: e.pgn, errorIndex: e.index, lineNumber: e.lineNumber };
-			}
-			else {
-				throw e;
-			}
-		}
-	}
-	else {
-		return { error: true, message: i18n.INVALID_GAME_ATTRIBUTE_ERROR_MESSAGE };
-	}
-}