cm-chessboard 8.12.2 → 8.12.4

package/README.md

@@ -84,7 +84,12 @@ You can also copy the `assets` folder from `cm-chessboard/assets` to your projec
 
 To enable the user to move the pieces, you have to enable the move input.
 
+Markers are provided by the [Markers extension](https://shaack.com/projekte/cm-chessboard/examples/extensions/markers-extension.html) (not part of the core), so you need to import and enable it.
+
 ```javascript
+import {Chessboard, FEN, INPUT_EVENT_TYPE} from "./path/to/Chessboard.js"
+import {Markers} from "./path/to/extensions/markers/Markers.js"
+
 const board = new Chessboard(document.getElementById("board"), {
         position: FEN.start,
         assetsUrl: "../assets/",
@@ -147,10 +152,9 @@ this.props = {
 
 ### setPiece(square, piece, animated = false)
 
-Sets a piece on a square. Example: `board.setPiece("e4", PIECE.blackKnight, true)` or
-`board.setPiece("e4", "bn")`. Remove a Piece with `board.setPiece("e4", null)`. Returns a **Promise**, which is
-resolved,
-after the animation finished.
+Sets a piece on a square. Example: `board.setPiece("e4", PIECE.bn, true)` or
+`board.setPiece("e4", "bn")`. Remove a piece with `board.setPiece("e4", null)`. Returns a **Promise**, which is
+resolved after the animation finished.
 
 ### getPiece(square)
 
@@ -172,9 +176,9 @@ Sets the position as `fen` or only the position part of a `fen`. Returns a **Pro
 
 Returns the board position in form of the position part of a `fen`.
 
-### setOrientation(color)
+### setOrientation(color, animated = false)
 
-Sets the board orientation (color at bottom). Allowed values are `COLOR.white` or `COLOR.black`.
+Sets the board orientation (color at bottom). Allowed values are `COLOR.white` or `COLOR.black`. When `animated` is `true`, the board turns with an animation. Returns a **Promise**, which is resolved after the animation finished.
 
 [Example for **setOrientation**](https://shaack.com/projekte/cm-chessboard/examples/enable-input.html)
 
@@ -182,12 +186,6 @@ Sets the board orientation (color at bottom). Allowed values are `COLOR.white` o
 
 Returns the board orientation.
 
-### destroy()
-
-Removes the board from the DOM.
-
-[Example for **destroy**](https://shaack.com/projekte/cm-chessboard/examples/destroy-many-boards.html)
-
 ### enableMoveInput(eventHandler, color = undefined)
 
 Enables moves via user input (mouse or touch). Set optional `color`, if you want to enable the move input for a specific
@@ -242,6 +240,44 @@ chessboard.enableMoveInput((event) => {
 
 Disables moves via user input.
 
+### isMoveInputEnabled()
+
+Returns `true` if move input is currently enabled for white or black.
+
+### enableSquareSelect(eventType, eventHandler)
+
+Listens for pointer events on squares and calls `eventHandler` with an object `{eventType, event, chessboard, square}`. `eventType` defaults to `POINTER_EVENTS.pointerdown`; allowed values are in `POINTER_EVENTS` (e.g. `pointerdown`, `pointerup`, `pointermove`, …).
+
+```javascript
+board.enableSquareSelect(POINTER_EVENTS.pointerdown, (event) => {
+    console.log(event.square)
+})
+```
+
+[Example for **enableSquareSelect**](https://shaack.com/projekte/cm-chessboard/examples/pointer-events.html)
+
+### disableSquareSelect(eventType)
+
+Stops listening for the given pointer event type.
+
+### isSquareSelectEnabled()
+
+Returns `true` if square select is currently enabled.
+
+### addExtension(extensionClass, props)
+
+Adds an extension at runtime. Throws if the extension class is already added.
+
+### getExtension(extensionClass)
+
+Returns the instance of an added extension, or `null` if not found.
+
+### destroy()
+
+Removes the board from the DOM.
+
+[Example for **destroy**](https://shaack.com/projekte/cm-chessboard/examples/destroy-many-boards.html)
+
 ## Piece sets
 
 cm-chessboard supports alternative piece sets. A piece set is defined in an SVG sprite. cm-chessboard is shipped with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cm-chessboard",
-  "version": "8.12.2",
+  "version": "8.12.4",
   "description": "A JavaScript chessboard which is lightweight, ES6 module based, responsive, SVG rendered and without dependencies.",
   "keywords": [
     "chess",