kokopu-react 1.1.0 → 1.4.0

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 ChangeLog
 =========
 
+1.4.0 (October 21, 2021)
+------------------------
+* Add support for plus/times/dot/circle in text markers.
+
+1.3.1 (September 27, 2021)
+--------------------------
+* Fix missing export for `ErrorBox`.
+
+1.3.0 (September 26, 2021)
+--------------------------
+* Expose component `ErrorBox`.
+* Minor fixes in documentation.
+
+1.2.0 (September 13, 2021)
+--------------------------
+* Fix ambiguous castling move issue at Chess960.
+
 1.1.0 (August 15, 2021)
 -----------------------
 * Provide interaction mode `playMoves`.

package/README.md

@@ -1,6 +1,8 @@
 Kokopu-React
 ============
 
+<img align="right" width="96" height="96" src="graphics/logo.svg" />
+
 Kokopu-React is a [React](https://reactjs.org/)-based library to create and display chessboard components.
 Kokopu-React is built on top of [Kokopu](https://www.npmjs.com/package/kokopu), a headless library that
 implements all the chess logic (game rules, parsing of [FEN](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation)

package/dist/lib/ArrowMarkerIcon.js

@@ -31,7 +31,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
@@ -85,10 +85,8 @@ var ArrowMarkerIcon = /*#__PURE__*/function (_React$Component) {
         x2: size - halfThickness * 3,
         y2: size / 2,
         stroke: this.props.color,
-        style: {
-          'strokeWidth': halfThickness * 2,
-          'markerEnd': "url(#".concat(this.arrowTipId, ")")
-        }
+        strokeWidth: halfThickness * 2,
+        markerEnd: "url(#".concat(this.arrowTipId, ")")
       }));
     }
   }]);

package/dist/lib/Chessboard.js

@@ -21,7 +21,11 @@ var _piecesets2 = _interopRequireDefault(require("./impl/piecesets"));
 
 var _ArrowTip = _interopRequireDefault(require("./impl/ArrowTip"));
 
-var _ErrorBox = _interopRequireDefault(require("./impl/ErrorBox"));
+var _TextSymbol = _interopRequireDefault(require("./impl/TextSymbol"));
+
+var _ErrorBox = _interopRequireDefault(require("./ErrorBox"));
+
+var _i18n = _interopRequireDefault(require("./i18n"));
 
 var _markers = require("./markers");
 
@@ -61,7 +65,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
@@ -133,12 +137,12 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
 
       if (info.positionError) {
         return /*#__PURE__*/_react["default"].createElement(_ErrorBox["default"], {
-          title: "Error while analysing a FEN string.",
+          title: _i18n["default"].INVALID_FEN_ERROR_TITLE,
           message: info.message
         });
       } else if (info.moveError) {
         return /*#__PURE__*/_react["default"].createElement(_ErrorBox["default"], {
-          title: "Invalid move notation.",
+          title: _i18n["default"].INVALID_NOTATION_ERROR_TITLE,
           message: info.message
         });
       }
@@ -406,10 +410,8 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
         x2: xTo,
         y2: yTo,
         stroke: colorset[this.props.editedArrowColor],
-        style: {
-          'strokeWidth': strokeWidth,
-          'markerEnd': "url(#".concat(arrowTipId, ")")
-        }
+        strokeWidth: strokeWidth,
+        markerEnd: "url(#".concat(arrowTipId, ")")
       });
     }
   }, {
@@ -565,16 +567,16 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
 
         x += squareSize / 2;
         y += squareSize / 2;
-        result.push( /*#__PURE__*/_react["default"].createElement("text", {
+        result.push( /*#__PURE__*/_react["default"].createElement("g", {
           key: 'txtm-' + sq,
-          className: "kokopu-annotation kokopu-label",
+          className: "kokopu-annotation"
+        }, /*#__PURE__*/_react["default"].createElement(_TextSymbol["default"], {
           x: x,
           y: y,
-          fill: colorset[value.color],
-          style: {
-            'fontSize': squareSize
-          }
-        }, value.symbol));
+          size: squareSize,
+          symbol: value.symbol,
+          color: colorset[value.color]
+        })));
       });
       return result;
     }
@@ -622,10 +624,8 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
           x2: xTo,
           y2: yTo,
           stroke: colorset[color],
-          style: {
-            'strokeWidth': strokeWidth,
-            'markerEnd': "url(#".concat(arrowTipId, ")")
-          }
+          strokeWidth: strokeWidth,
+          markerEnd: "url(#".concat(arrowTipId, ")")
         }));
       });
       return result;
@@ -661,10 +661,8 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
         x2: x,
         y2: y,
         stroke: colorset['highlight'],
-        style: {
-          'strokeWidth': squareSize * STROKE_THICKNESS_FACTOR,
-          'markerEnd': "url(#".concat(this.getArrowTipId('highlight'), ")")
-        }
+        strokeWidth: squareSize * STROKE_THICKNESS_FACTOR,
+        markerEnd: "url(#".concat(this.getArrowTipId('highlight'), ")")
       });
     }
   }, {
@@ -700,9 +698,7 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
         className: "kokopu-coordinate kokopu-label",
         x: x,
         y: y,
-        style: {
-          'fontSize': fontSize
-        }
+        fontSize: fontSize
       }, label);
     }
   }, {
@@ -716,9 +712,7 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
         className: "kokopu-coordinate kokopu-label",
         x: x,
         y: y,
-        style: {
-          'fontSize': fontSize
-        }
+        fontSize: fontSize
       }, label);
     }
   }, {
@@ -820,7 +814,6 @@ var Chessboard = /*#__PURE__*/function (_React$Component) {
               }
             });
             break;
-          // TODO fix chess960 castling
           // Other cases are not supposed to happen.
           // istanbul ignore next
 
@@ -1318,7 +1311,7 @@ function parsePosition(position) {
   } else {
     return {
       error: true,
-      message: 'Invalid "position" attribute.'
+      message: _i18n["default"].INVALID_POSITION_ATTRIBUTE_ERROR_MESSAGE
     };
   }
 }
@@ -1353,7 +1346,7 @@ function parseMove(position, move) {
   } else {
     return {
       error: true,
-      message: 'Invalid "move" attribute.'
+      message: _i18n["default"].INVALID_MOVE_ATTRIBUTE_ERROR_MESSAGE
     };
   }
 }

package/dist/lib/{impl/ErrorBox.js → ErrorBox.js}

@@ -9,7 +9,7 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 
 var _react = _interopRequireDefault(require("react"));
 
-require("../css/error_box.css");
+require("./css/error_box.css");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 

package/dist/lib/TextMarkerIcon.js

@@ -9,10 +9,10 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 
 var _react = _interopRequireDefault(require("react"));
 
-require("./css/label.css");
-
 var _util = require("./impl/util");
 
+var _TextSymbol = _interopRequireDefault(require("./impl/TextSymbol"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /******************************************************************************
@@ -52,15 +52,13 @@ function TextMarkerIcon(props) {
     viewBox: viewBox,
     width: size,
     height: size
-  }, /*#__PURE__*/_react["default"].createElement("text", {
-    className: "kokopu-label",
+  }, /*#__PURE__*/_react["default"].createElement(_TextSymbol["default"], {
     x: size / 2,
     y: size / 2,
-    fill: props.color,
-    style: {
-      'fontSize': size
-    }
-  }, props.symbol));
+    size: size,
+    symbol: props.symbol,
+    color: props.color
+  }));
 }
 
 TextMarkerIcon.propTypes = {
@@ -70,7 +68,10 @@ TextMarkerIcon.propTypes = {
   size: _propTypes["default"].number.isRequired,
 
   /**
-   * Symbol to represent on the icon. Must be either a letter (upper-case or lower-case) or a digit.
+   * Symbol to represent on the icon. Must be one of:
+   *  - any letter from A to Z (either upper-case or lower-case),
+   *  - any digit from 0 to 9,
+   *  - any symbol code among `'plus'`, `'times'`, `'dot'`, or `'circle'`.
    */
   symbol: _propTypes["default"].string.isRequired,
 

package/dist/lib/css/symbol.css

@@ -0,0 +1,25 @@
+/******************************************************************************
+ *                                                                            *
+ *    This file is part of Kokopu-React, a JavaScript chess library.          *
+ *    Copyright (C) 2021  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/>.                                         *
+ *                                                                            *
+ ******************************************************************************/
+
+
+.kokopu-symbolCircle {
+	fill: transparent;
+}

package/dist/lib/i18n.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+/******************************************************************************
+ *                                                                            *
+ *    This file is part of Kokopu-React, a JavaScript chess library.          *
+ *    Copyright (C) 2021  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/>.                                         *
+ *                                                                            *
+ ******************************************************************************/
+var i18n = {
+  INVALID_FEN_ERROR_TITLE: 'Invalid FEN string.',
+  INVALID_NOTATION_ERROR_TITLE: 'Invalid move notation.',
+  INVALID_POSITION_ATTRIBUTE_ERROR_MESSAGE: 'Invalid "position" attribute.',
+  INVALID_MOVE_ATTRIBUTE_ERROR_MESSAGE: 'Invalid "move" attribute.'
+};
+var _default = i18n;
+exports["default"] = _default;

package/dist/lib/impl/ArrowTip.js

@@ -43,9 +43,7 @@ function ArrowTip(props) {
     refX: 2.5,
     refY: 2,
     orient: "auto",
-    style: {
-      fill: props.color
-    }
+    fill: props.color
   }, /*#__PURE__*/_react["default"].createElement("path", {
     d: "M 4,2 L 0,4 L 1,2 L 0,0 Z"
   }));
@@ -60,8 +58,5 @@ ArrowTip.propTypes = {
   /**
    * Color to use to colorize the shape (for example: `'green'`, `'#ff0000'`...).
    */
-  color: _propTypes["default"].string
-};
-ArrowTip.defaultProps = {
-  color: 'currentcolor'
+  color: _propTypes["default"].string.isRequired
 };

package/dist/lib/impl/TextSymbol.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = TextSymbol;
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _react = _interopRequireDefault(require("react"));
+
+require("../css/label.css");
+
+require("../css/symbol.css");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+/******************************************************************************
+ *                                                                            *
+ *    This file is part of Kokopu-React, a JavaScript chess library.          *
+ *    Copyright (C) 2021  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/>.                                         *
+ *                                                                            *
+ ******************************************************************************/
+var SHAPE_THICKNESS_FACTOR = 0.1;
+var DOT_RADIUS_FACTOR = 0.15;
+var CIRCLE_RADIUS_FACTOR = 0.425;
+/**
+ * Symbol of a text marker.
+ */
+
+function TextSymbol(props) {
+  if (props.symbol === 'dot') {
+    return /*#__PURE__*/_react["default"].createElement("circle", {
+      cx: props.x,
+      cy: props.y,
+      r: props.size * DOT_RADIUS_FACTOR,
+      fill: props.color
+    });
+  } else if (props.symbol === 'circle') {
+    var thickness = props.size * SHAPE_THICKNESS_FACTOR;
+    return /*#__PURE__*/_react["default"].createElement("circle", {
+      className: "kokopu-symbolCircle",
+      cx: props.x,
+      cy: props.y,
+      r: props.size * CIRCLE_RADIUS_FACTOR,
+      stroke: props.color,
+      strokeWidth: thickness
+    });
+  } else {
+    var symbol = props.symbol === 'plus' ? '+' : props.symbol === 'times' ? "\xD7" : props.symbol;
+    return /*#__PURE__*/_react["default"].createElement("text", {
+      className: "kokopu-label",
+      x: props.x,
+      y: props.y,
+      fill: props.color,
+      fontSize: props.size
+    }, symbol);
+  }
+}
+
+TextSymbol.propTypes = {
+  /**
+   * X-coordinate of the center of the symbol.
+   */
+  x: _propTypes["default"].number.isRequired,
+
+  /**
+   * Y-coordinate of the center of the symbol.
+   */
+  y: _propTypes["default"].number.isRequired,
+
+  /**
+   * Size of the symbol (i.e. size of square in which the symbol is rendered).
+   */
+  size: _propTypes["default"].number.isRequired,
+
+  /**
+   * Symbol code.
+   */
+  symbol: _propTypes["default"].string.isRequired,
+
+  /**
+   * Color to use to colorize the shape (for example: `'green'`, `'#ff0000'`...).
+   */
+  color: _propTypes["default"].string.isRequired
+};

package/dist/lib/impl/util.js

@@ -3,13 +3,13 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.MIN_SQUARE_SIZE = exports.MAX_SQUARE_SIZE = void 0;
 exports.generateRandomId = generateRandomId;
-exports.sanitizeInteger = sanitizeInteger;
-exports.isValidSquare = isValidSquare;
-exports.isValidVector = isValidVector;
 exports.isValidColor = isValidColor;
+exports.isValidSquare = isValidSquare;
 exports.isValidSymbol = isValidSymbol;
-exports.MAX_SQUARE_SIZE = exports.MIN_SQUARE_SIZE = void 0;
+exports.isValidVector = isValidVector;
+exports.sanitizeInteger = sanitizeInteger;
 
 /******************************************************************************
  *                                                                            *
@@ -65,5 +65,5 @@ function isValidColor(color) {
 }
 
 function isValidSymbol(symbol) {
-  return /^[A-Za-z0-9]$/.test(symbol);
+  return /^(?:[A-Za-z0-9]|plus|times|dot|circle)$/.test(symbol);
 }

package/dist/lib/index.js

@@ -3,28 +3,34 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "flattenSquareMarkers", {
+Object.defineProperty(exports, "ArrowMarkerIcon", {
   enumerable: true,
   get: function get() {
-    return _markers.flattenSquareMarkers;
+    return _ArrowMarkerIcon["default"];
   }
 });
-Object.defineProperty(exports, "parseSquareMarkers", {
+Object.defineProperty(exports, "Chessboard", {
   enumerable: true,
   get: function get() {
-    return _markers.parseSquareMarkers;
+    return _Chessboard["default"];
   }
 });
-Object.defineProperty(exports, "flattenTextMarkers", {
+Object.defineProperty(exports, "ErrorBox", {
   enumerable: true,
   get: function get() {
-    return _markers.flattenTextMarkers;
+    return _ErrorBox["default"];
   }
 });
-Object.defineProperty(exports, "parseTextMarkers", {
+Object.defineProperty(exports, "SquareMarkerIcon", {
   enumerable: true,
   get: function get() {
-    return _markers.parseTextMarkers;
+    return _SquareMarkerIcon["default"];
+  }
+});
+Object.defineProperty(exports, "TextMarkerIcon", {
+  enumerable: true,
+  get: function get() {
+    return _TextMarkerIcon["default"];
   }
 });
 Object.defineProperty(exports, "flattenArrowMarkers", {
@@ -33,41 +39,51 @@ Object.defineProperty(exports, "flattenArrowMarkers", {
     return _markers.flattenArrowMarkers;
   }
 });
-Object.defineProperty(exports, "parseArrowMarkers", {
+Object.defineProperty(exports, "flattenSquareMarkers", {
   enumerable: true,
   get: function get() {
-    return _markers.parseArrowMarkers;
+    return _markers.flattenSquareMarkers;
   }
 });
-Object.defineProperty(exports, "Chessboard", {
+Object.defineProperty(exports, "flattenTextMarkers", {
   enumerable: true,
   get: function get() {
-    return _Chessboard["default"];
+    return _markers.flattenTextMarkers;
   }
 });
-Object.defineProperty(exports, "SquareMarkerIcon", {
+Object.defineProperty(exports, "i18n", {
   enumerable: true,
   get: function get() {
-    return _SquareMarkerIcon["default"];
+    return _i18n["default"];
   }
 });
-Object.defineProperty(exports, "TextMarkerIcon", {
+Object.defineProperty(exports, "parseArrowMarkers", {
   enumerable: true,
   get: function get() {
-    return _TextMarkerIcon["default"];
+    return _markers.parseArrowMarkers;
   }
 });
-Object.defineProperty(exports, "ArrowMarkerIcon", {
+Object.defineProperty(exports, "parseSquareMarkers", {
   enumerable: true,
   get: function get() {
-    return _ArrowMarkerIcon["default"];
+    return _markers.parseSquareMarkers;
+  }
+});
+Object.defineProperty(exports, "parseTextMarkers", {
+  enumerable: true,
+  get: function get() {
+    return _markers.parseTextMarkers;
   }
 });
 
 var _markers = require("./markers");
 
+var _i18n = _interopRequireDefault(require("./i18n"));
+
 var _Chessboard = _interopRequireDefault(require("./Chessboard"));
 
+var _ErrorBox = _interopRequireDefault(require("./ErrorBox"));
+
 var _SquareMarkerIcon = _interopRequireDefault(require("./SquareMarkerIcon"));
 
 var _TextMarkerIcon = _interopRequireDefault(require("./TextMarkerIcon"));

package/dist/lib/markers.js

@@ -3,12 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.flattenArrowMarkers = flattenArrowMarkers;
 exports.flattenSquareMarkers = flattenSquareMarkers;
 exports.flattenTextMarkers = flattenTextMarkers;
-exports.flattenArrowMarkers = flattenArrowMarkers;
+exports.parseArrowMarkers = parseArrowMarkers;
 exports.parseSquareMarkers = parseSquareMarkers;
 exports.parseTextMarkers = parseTextMarkers;
-exports.parseArrowMarkers = parseArrowMarkers;
 
 var _util = require("./impl/util");
 
@@ -50,8 +50,8 @@ function flattenSquareMarkers(markers) {
 /**
  * Transform a set of text markers defined as a "square -> (symbol, color)" struct into a comma-separated string.
  *
- * @param {object} markers For example: `{ e4: { symbol: 'A', color: 'g' }, d5: { symbol: 'z', color: 'r' }}`
- * @returns {string} For example: `'Rzd5,GAe4'`
+ * @param {object} markers For example: `{ e4: { symbol: 'A', color: 'g' }, d5: { symbol: 'z', color: 'r' }, h3: { symbol: 'plus', color: 'y' } }`
+ * @returns {string} For example: `'Rzd5,GAe4,Y(plus)h3'`
  */
 
 
@@ -69,7 +69,7 @@ function flattenTextMarkers(markers) {
         sq = _ref8[0],
         desc = _ref8[1];
 
-    return desc.color.toUpperCase() + desc.symbol + sq;
+    return desc.color.toUpperCase() + (desc.symbol.length === 1 ? desc.symbol : '(' + desc.symbol + ')') + sq;
   }).join(',');
 }
 /**
@@ -130,17 +130,17 @@ function parseSquareMarkers(markers) {
 /**
  * Parse a set of text markers defined as a comma-separated string into a "square -> (symbol, color)" struct.
  *
- * @param {string} markers For example: `'Rzd5,GAe4'`
- * @returns {object} For example: `{ e4: { symbol: 'A', color: 'g' }, d5: { symbol: 'z', color: 'r' }}`
+ * @param {string} markers For example: `'Rzd5,GAe4,Y(plus)h3'`
+ * @returns {object} For example: `{ e4: { symbol: 'A', color: 'g' }, d5: { symbol: 'z', color: 'r' }, h3: { symbol: 'plus', color: 'y' } }`
  */
 
 
 function parseTextMarkers(markers) {
   return parseMarkers(markers, function (token) {
-    return /^([GRY])([A-Za-z0-9])([a-h][1-8])$/.test(token) ? {
-      key: RegExp.$3,
+    return /^([GRY])(?:([A-Za-z0-9])|\((plus|times|dot|circle)\))([a-h][1-8])$/.test(token) ? {
+      key: RegExp.$4,
       value: {
-        symbol: RegExp.$2,
+        symbol: RegExp.$2 || RegExp.$3,
         color: RegExp.$1.toLowerCase()
       }
     } : undefined;