@mirasen/react-chessboard 1.1.1 → 1.2.0

package/README.md

@@ -298,10 +298,25 @@ When `true`, promotion automatically selects a queen. When omitted or `false`, t
 
 ### `checkSquare`
 
-Highlights the king's square when in check. Pass the king's square string (e.g. `'e1'`) to show a red glow; pass `null` or omit to clear it. The chessboard does not detect check itself — your rules layer (e.g. `chess.js`) is responsible for determining when and which square to highlight.
+Type: `SquareString | ColorInput | null`
+
+Highlights the king's square when in check with a red radial glow. Pass `null` or omit to remove the highlight. The chessboard does not detect check itself — your rules layer (e.g. `chess.js`) is responsible for determining when to apply it.
+
+Two forms are accepted:
+
+**Color shorthand** — pass the side to move (`'w'`/`'b'` or `'white'`/`'black'`); the extension auto-locates the king on the board. Recommended when integrating with a rules engine like chess.js:
+
+```tsx
+<Chessboard
+  checkSquare={chess.isCheck() ? chess.turn() : null}
+  ...
+/>
+```
+
+**Explicit square** — pass the king's square string directly if you already know it:
 
 ```tsx
-<Chessboard checkSquare={chess.isCheck() ? kingSquare : null} ... />
+<Chessboard checkSquare={chess.isCheck() ? 'e1' : null} ... />
 ```
 
 ### `className` and `style`

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { Chessboard as CoreChessboard, ColorInput, MovabilityInput, MoveOutput, MoveRequestInput, PositionInput, SquareString } from '@mirasen/chessboard';
+import type { ColorInput, Chessboard as CoreChessboard, MovabilityInput, MoveOutput, MoveRequestInput, PositionInput, SquareString } from '@mirasen/chessboard';
 import type { CSSProperties } from 'react';
 export type ChessboardHandle = CoreChessboard;
 export type BoardOrientation = ColorInput;
@@ -17,7 +17,7 @@ export type ChessboardProps = {
     movability?: MovabilityInput;
     onUIMove?: (move: MoveOutput) => void;
     autoPromoteToQueen?: boolean;
-    checkSquare?: SquareString | null;
+    checkSquare?: SquareString | ColorInput | null;
     className?: string;
     style?: CSSProperties;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mirasen/react-chessboard",
 	"description": "A React chessboard component with built-in interaction, promotion, animation, and chess.js integration.",
-	"version": "1.1.1",
+	"version": "1.2.0",
 	"license": "MIT",
 	"keywords": [
 		"mirasen",
@@ -56,12 +56,12 @@
 		"LICENSE"
 	],
 	"dependencies": {
-		"@mirasen/chessboard": "^1.4.0"
+		"@mirasen/chessboard": "^1.5.0"
 	},
 	"peerDependencies": {
+		"chess.js": "^1.4.0",
 		"react": ">=18",
-		"react-dom": ">=18",
-		"chess.js": "^1.4.0"
+		"react-dom": ">=18"
 	},
 	"peerDependenciesMeta": {
 		"chess.js": {