react-native-chess-kit 0.1.0

package/lib/module/board.js

@@ -0,0 +1,184 @@
+"use strict";
+
+import React, { forwardRef, useState, useCallback, useImperativeHandle, useEffect } from 'react';
+import { View } from 'react-native';
+import { GestureDetector } from 'react-native-gesture-handler';
+import { useBoardPieces } from './use-board-pieces';
+import { useBoardState } from './use-board-state';
+import { useBoardGesture } from './use-board-gesture';
+import { BoardBackground } from './board-background';
+import { BoardCoordinates } from './board-coordinates';
+import { BoardLegalDots } from './board-legal-dots';
+import { BoardPiecesLayer } from './board-pieces';
+import { BoardDragGhost } from './board-drag-ghost';
+
+/**
+ * High-performance custom chess board built on Reanimated + Gesture Handler.
+ *
+ * Architecture:
+ * - 1 gesture handler (vs 32 in typical implementations)
+ * - ~40 components mounted (vs ~281)
+ * - ~75 native views (vs ~470)
+ * - 0 React Context providers
+ * - 0 re-renders during drag (pure worklet — only 2 shared value writes per frame)
+ *
+ * Follows chess.com/lichess pattern: single gesture receiver on the board,
+ * coordinate math to determine touched piece, shared values for drag state.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export const Board = /*#__PURE__*/forwardRef(function Board({
+  fen,
+  orientation,
+  boardSize,
+  gestureEnabled,
+  player,
+  onMove,
+  colors,
+  moveDuration,
+  withLetters,
+  withNumbers,
+  renderPiece,
+  showLegalMoves,
+  moveMethod
+}, ref) {
+  const squareSize = boardSize / 8;
+
+  // --- Piece data from FEN ---
+  const pieces = useBoardPieces(fen);
+
+  // --- Chess.js for legal move validation ---
+  const boardState = useBoardState(fen);
+
+  // Sync internal chess.js when parent changes FEN (puzzle reset, opponent move, etc.)
+  // Must be in useEffect — side effects during render violate React's rules
+  // and can fire multiple times in concurrent mode.
+  useEffect(() => {
+    boardState.loadFen(fen);
+  }, [fen, boardState]);
+
+  // --- Selection state (triggers legal dots display) ---
+  const [selectedSquare, setSelectedSquare] = useState(null);
+  const [legalMoves, setLegalMoves] = useState([]);
+
+  // Default piece renderer (no-op if parent provides renderPiece)
+  const defaultRenderPiece = useCallback((code, size) => /*#__PURE__*/_jsx(View, {
+    style: {
+      width: size,
+      height: size,
+      backgroundColor: 'rgba(0,0,0,0.3)'
+    }
+  }), []);
+  const pieceRenderer = renderPiece ?? defaultRenderPiece;
+
+  // --- Gesture callbacks ---
+  const handlePieceSelected = useCallback(square => {
+    setSelectedSquare(square);
+    if (showLegalMoves) {
+      setLegalMoves(boardState.getLegalMoves(square));
+    }
+  }, [showLegalMoves, boardState]);
+  const handleSelectionCleared = useCallback(() => {
+    setSelectedSquare(null);
+    setLegalMoves([]);
+  }, []);
+  const handlePieceMoved = useCallback((from, to) => {
+    // Clear selection and legal dots
+    setSelectedSquare(null);
+    setLegalMoves([]);
+
+    // Notify parent — parent decides whether to accept/reject
+    onMove?.({
+      from,
+      to
+    });
+  }, [onMove]);
+
+  // --- Single centralized gesture ---
+  const {
+    gesture,
+    gestureState
+  } = useBoardGesture({
+    squareSize,
+    orientation,
+    gestureEnabled,
+    player,
+    moveMethod,
+    pieces,
+    callbacks: {
+      onPieceSelected: handlePieceSelected,
+      onPieceMoved: handlePieceMoved,
+      onSelectionCleared: handleSelectionCleared
+    },
+    selectedSquare,
+    legalMoves
+  });
+
+  // --- Imperative ref for parent (move, highlight, reset, undo) ---
+  useImperativeHandle(ref, () => ({
+    move: move => {
+      // Pre-apply to internal chess.js so subsequent getLegalMoves calls
+      // reflect the new position. The parent will also update the FEN prop,
+      // which triggers useBoardPieces -> piece position animates via shared values.
+      boardState.applyMove(move.from, move.to);
+    },
+    highlight: (_square, _color) => {
+      // Highlights are handled by overlay layers in the consuming app,
+      // not internally — this is a no-op stub for API compatibility.
+      // Use the Board's overlay API or render your own highlight layer.
+    },
+    clearHighlights: () => {
+      // Same as highlight — handled by overlay layer
+    },
+    resetBoard: newFen => {
+      boardState.loadFen(newFen);
+      setSelectedSquare(null);
+      setLegalMoves([]);
+    },
+    undo: () => {
+      boardState.undoMove();
+      setSelectedSquare(null);
+      setLegalMoves([]);
+    }
+  }));
+  return /*#__PURE__*/_jsx(GestureDetector, {
+    gesture: gesture,
+    children: /*#__PURE__*/_jsxs(View, {
+      style: {
+        width: boardSize,
+        height: boardSize
+      },
+      children: [/*#__PURE__*/_jsx(BoardBackground, {
+        boardSize: boardSize,
+        lightColor: colors.light,
+        darkColor: colors.dark
+      }), /*#__PURE__*/_jsx(BoardCoordinates, {
+        boardSize: boardSize,
+        orientation: orientation,
+        lightColor: colors.light,
+        darkColor: colors.dark,
+        withLetters: withLetters,
+        withNumbers: withNumbers
+      }), showLegalMoves && /*#__PURE__*/_jsx(BoardLegalDots, {
+        legalMoves: legalMoves,
+        squareSize: squareSize,
+        orientation: orientation
+      }), /*#__PURE__*/_jsx(BoardPiecesLayer, {
+        pieces: pieces,
+        squareSize: squareSize,
+        orientation: orientation,
+        moveDuration: moveDuration,
+        renderPiece: pieceRenderer,
+        activeSquare: gestureState.activeSquare,
+        isDragging: gestureState.isDragging
+      }), /*#__PURE__*/_jsx(BoardDragGhost, {
+        squareSize: squareSize,
+        isDragging: gestureState.isDragging,
+        dragX: gestureState.dragX,
+        dragY: gestureState.dragY,
+        dragPieceCode: gestureState.dragPieceCode,
+        renderPiece: pieceRenderer
+      })]
+    })
+  });
+});
+//# sourceMappingURL=board.js.map

package/lib/module/board.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","forwardRef","useState","useCallback","useImperativeHandle","useEffect","View","GestureDetector","useBoardPieces","useBoardState","useBoardGesture","BoardBackground","BoardCoordinates","BoardLegalDots","BoardPiecesLayer","BoardDragGhost","jsx","_jsx","jsxs","_jsxs","Board","fen","orientation","boardSize","gestureEnabled","player","onMove","colors","moveDuration","withLetters","withNumbers","renderPiece","showLegalMoves","moveMethod","ref","squareSize","pieces","boardState","loadFen","selectedSquare","setSelectedSquare","legalMoves","setLegalMoves","defaultRenderPiece","code","size","style","width","height","backgroundColor","pieceRenderer","handlePieceSelected","square","getLegalMoves","handleSelectionCleared","handlePieceMoved","from","to","gesture","gestureState","callbacks","onPieceSelected","onPieceMoved","onSelectionCleared","move","applyMove","highlight","_square","_color","clearHighlights","resetBoard","newFen","undo","undoMove","children","lightColor","light","darkColor","dark","activeSquare","isDragging","dragX","dragY","dragPieceCode"],"sourceRoot":"..\\..\\src","sources":["board.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,21 @@
+"use strict";
+
+// react-native-chess-kit
+// High-performance chess board for React Native
+
+// ---------------------------------------------------------------------------
+// Main component
+// ---------------------------------------------------------------------------
+
+export { Board } from './board';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Utility functions (useful for overlay positioning)
+// ---------------------------------------------------------------------------
+
+export { squareToXY, xyToSquare } from './use-board-pieces';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Board","squareToXY","xyToSquare"],"sourceRoot":"..\\..\\src","sources":["index.ts"],"mappings":";;AAAA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,KAAK,QAAQ,SAAS;;AAE/B;AACA;AACA;;AAuBA;AACA;AACA;;AAEA,SAASC,UAAU,EAAEC,UAAU,QAAQ,oBAAoB","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/use-board-gesture.js

@@ -0,0 +1,154 @@
+"use strict";
+
+import { useMemo, useCallback, useRef } from 'react';
+import { Gesture } from 'react-native-gesture-handler';
+import { useSharedValue, runOnJS } from 'react-native-reanimated';
+import { xyToSquare } from './use-board-pieces';
+/**
+ * Single centralized gesture handler for the entire board.
+ *
+ * Instead of 32 separate Gesture.Pan() handlers (one per piece), we use ONE
+ * handler on the board container. Touch -> coordinate math -> which piece.
+ *
+ * Supports three modes:
+ * - 'drag': drag piece to target square
+ * - 'click': tap source piece, then tap target square
+ * - 'both': drag or click (default)
+ *
+ * All drag position tracking uses shared values — zero JS bridge calls,
+ * zero re-renders during drag. Only the final move triggers JS via runOnJS.
+ *
+ * The gesture object is STABLE (only recreated when squareSize, orientation,
+ * gestureEnabled, player, or moveMethod change). Frequently-changing data
+ * (pieces, selectedSquare, legalMoves) is read from refs via runOnJS bridge
+ * functions, avoiding costly gesture teardown/rebuild on every move.
+ */
+export function useBoardGesture({
+  squareSize,
+  orientation,
+  gestureEnabled,
+  player,
+  moveMethod,
+  pieces,
+  callbacks,
+  selectedSquare,
+  legalMoves
+}) {
+  // Shared values for drag tracking — updated on UI thread only
+  const activeSquare = useSharedValue(null);
+  const dragX = useSharedValue(0);
+  const dragY = useSharedValue(0);
+  const isDragging = useSharedValue(false);
+  const dragPieceCode = useSharedValue(null);
+  const gestureState = {
+    activeSquare,
+    dragX,
+    dragY,
+    isDragging,
+    dragPieceCode
+  };
+
+  // --- Refs for frequently-changing data (read from JS thread via runOnJS) ---
+  // These update every move but do NOT cause gesture object recreation.
+  const piecesRef = useRef(pieces);
+  piecesRef.current = pieces;
+  const selectedSquareRef = useRef(selectedSquare);
+  selectedSquareRef.current = selectedSquare;
+  const legalMovesRef = useRef(legalMoves);
+  legalMovesRef.current = legalMoves;
+  const callbacksRef = useRef(callbacks);
+  callbacksRef.current = callbacks;
+
+  // --- JS-thread bridge functions called from worklets via runOnJS ---
+  // These read current values from refs, so they always have fresh data.
+
+  const handleBegin = useCallback((touchX, touchY) => {
+    const square = xyToSquare(touchX, touchY, squareSize, orientation);
+    const currentPieces = piecesRef.current;
+    const currentSelected = selectedSquareRef.current;
+    const currentLegalMoves = legalMovesRef.current;
+    const cbs = callbacksRef.current;
+    const canClick = moveMethod !== 'drag';
+
+    // Build lookup for the current touch
+    const piece = currentPieces.find(p => p.square === square);
+    const isPlayerPiece = piece ? player === 'both' || (piece.color === 'w' ? 'white' : 'black') === player : false;
+
+    // Click-to-move: second tap on a legal target square
+    const legalSquares = new Set(currentLegalMoves.map(m => m.square));
+    if (canClick && currentSelected && legalSquares.has(square)) {
+      cbs.onPieceMoved(currentSelected, square);
+      activeSquare.value = null;
+      isDragging.value = false;
+      dragPieceCode.value = null;
+      return;
+    }
+    if (isPlayerPiece && piece) {
+      // Tapped/started dragging a player piece
+      activeSquare.value = square;
+      dragX.value = touchX;
+      dragY.value = touchY;
+      dragPieceCode.value = piece.code;
+      cbs.onPieceSelected(square);
+    } else {
+      // Tapped empty square or opponent piece — clear selection
+      activeSquare.value = null;
+      dragPieceCode.value = null;
+      if (currentSelected) {
+        cbs.onSelectionCleared();
+      }
+    }
+  }, [squareSize, orientation, player, moveMethod, activeSquare, dragX, dragY, isDragging, dragPieceCode]);
+  const handleEnd = useCallback((touchX, touchY) => {
+    const fromSquare = activeSquare.value;
+    if (!fromSquare) return;
+    const toSquare = xyToSquare(touchX, touchY, squareSize, orientation);
+    isDragging.value = false;
+    if (fromSquare !== toSquare) {
+      callbacksRef.current.onPieceMoved(fromSquare, toSquare);
+    }
+    activeSquare.value = null;
+    dragPieceCode.value = null;
+  }, [squareSize, orientation, activeSquare, isDragging, dragPieceCode]);
+
+  // --- Build the gesture (STABLE — only changes on layout/config changes) ---
+  const canDrag = moveMethod !== 'click';
+  const gesture = useMemo(() => {
+    return Gesture.Pan().enabled(gestureEnabled).minDistance(0) // Also detect taps (zero-distance pans)
+    .onBegin(e => {
+      'worklet';
+
+      // Bridge to JS for piece lookup + selection logic
+      runOnJS(handleBegin)(e.x, e.y);
+    }).onStart(() => {
+      'worklet';
+
+      if (!canDrag || !activeSquare.value) return;
+      isDragging.value = true;
+    }).onUpdate(e => {
+      'worklet';
+
+      if (!canDrag || !isDragging.value) return;
+      // Only 2 shared value writes — no JS bridge, no re-renders
+      dragX.value = e.x;
+      dragY.value = e.y;
+    }).onEnd(e => {
+      'worklet';
+
+      if (!isDragging.value || !activeSquare.value) return;
+      runOnJS(handleEnd)(e.x, e.y);
+    }).onFinalize(() => {
+      'worklet';
+
+      // Safety reset if gesture was interrupted
+      isDragging.value = false;
+    });
+  }, [gestureEnabled, canDrag, handleBegin, handleEnd,
+  // Shared values are stable refs — listed for exhaustive-deps but don't cause recreations
+  activeSquare, dragX, dragY, isDragging]);
+  return {
+    gesture,
+    gestureState
+  };
+}
+//# sourceMappingURL=use-board-gesture.js.map

package/lib/module/use-board-gesture.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useCallback","useRef","Gesture","useSharedValue","runOnJS","xyToSquare","useBoardGesture","squareSize","orientation","gestureEnabled","player","moveMethod","pieces","callbacks","selectedSquare","legalMoves","activeSquare","dragX","dragY","isDragging","dragPieceCode","gestureState","piecesRef","current","selectedSquareRef","legalMovesRef","callbacksRef","handleBegin","touchX","touchY","square","currentPieces","currentSelected","currentLegalMoves","cbs","canClick","piece","find","p","isPlayerPiece","color","legalSquares","Set","map","m","has","onPieceMoved","value","code","onPieceSelected","onSelectionCleared","handleEnd","fromSquare","toSquare","canDrag","gesture","Pan","enabled","minDistance","onBegin","e","x","y","onStart","onUpdate","onEnd","onFinalize"],"sourceRoot":"..\\..\\src","sources":["use-board-gesture.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/use-board-pieces.js

@@ -0,0 +1,189 @@
+"use strict";
+
+import { useMemo, useRef } from 'react';
+const FEN_PIECE_MAP = {
+  p: {
+    code: 'bp',
+    color: 'b'
+  },
+  r: {
+    code: 'br',
+    color: 'b'
+  },
+  n: {
+    code: 'bn',
+    color: 'b'
+  },
+  b: {
+    code: 'bb',
+    color: 'b'
+  },
+  q: {
+    code: 'bq',
+    color: 'b'
+  },
+  k: {
+    code: 'bk',
+    color: 'b'
+  },
+  P: {
+    code: 'wp',
+    color: 'w'
+  },
+  R: {
+    code: 'wr',
+    color: 'w'
+  },
+  N: {
+    code: 'wn',
+    color: 'w'
+  },
+  B: {
+    code: 'wb',
+    color: 'w'
+  },
+  Q: {
+    code: 'wq',
+    color: 'w'
+  },
+  K: {
+    code: 'wk',
+    color: 'w'
+  }
+};
+const FILES = 'abcdefgh';
+
+/**
+ * Parse the piece-placement part of a FEN string into an array of pieces.
+ * Pure function — no React dependencies, suitable for worklets if needed.
+ */
+function parseFenPieces(fen) {
+  const placement = fen.split(' ')[0];
+  const ranks = placement.split('/');
+  const pieces = [];
+  for (let rankIdx = 0; rankIdx < ranks.length; rankIdx++) {
+    const rank = ranks[rankIdx];
+    let fileIdx = 0;
+    for (const char of rank) {
+      if (char >= '1' && char <= '8') {
+        fileIdx += parseInt(char, 10);
+        continue;
+      }
+      const mapping = FEN_PIECE_MAP[char];
+      if (mapping) {
+        // FEN ranks are from rank 8 (index 0) down to rank 1 (index 7)
+        const square = `${FILES[fileIdx]}${8 - rankIdx}`;
+        pieces.push({
+          code: mapping.code,
+          square,
+          color: mapping.color
+        });
+      }
+      fileIdx++;
+    }
+  }
+  return pieces;
+}
+
+/**
+ * Convert square notation to pixel coordinates (top-left corner).
+ * Orientation-aware: flips the board when playing as black.
+ */
+export function squareToXY(square, squareSize, orientation) {
+  'worklet';
+
+  const fileIdx = square.charCodeAt(0) - 97; // 'a'=0 .. 'h'=7
+  const rankIdx = parseInt(square[1], 10) - 1; // '1'=0 .. '8'=7
+
+  const col = orientation === 'white' ? fileIdx : 7 - fileIdx;
+  const row = orientation === 'white' ? 7 - rankIdx : rankIdx;
+  return {
+    x: col * squareSize,
+    y: row * squareSize
+  };
+}
+
+/**
+ * Convert pixel coordinates to a square notation string.
+ * Clamps to board bounds. Orientation-aware.
+ */
+export function xyToSquare(x, y, squareSize, orientation) {
+  'worklet';
+
+  const col = Math.max(0, Math.min(7, Math.floor(x / squareSize)));
+  const row = Math.max(0, Math.min(7, Math.floor(y / squareSize)));
+  const fileIdx = orientation === 'white' ? col : 7 - col;
+  const rankIdx = orientation === 'white' ? 7 - row : row;
+
+  // String.fromCharCode not available in worklets — use lookup
+  const files = 'abcdefgh';
+  return `${files[fileIdx]}${rankIdx + 1}`;
+}
+
+/**
+ * Manages the piece list derived from FEN, with stable IDs for React keys.
+ *
+ * Stable IDs prevent unmount/remount cycles when pieces change position.
+ * A piece keeps its ID as long as it exists on the board — only capture
+ * (removal) or promotion (code change) creates a new ID.
+ */
+export function useBoardPieces(fen) {
+  // Track piece-code counters across renders for stable ID assignment
+  const idCounterRef = useRef({});
+  const prevPiecesRef = useRef([]);
+  return useMemo(() => {
+    const parsed = parseFenPieces(fen);
+    const prev = prevPiecesRef.current;
+    const prevBySquare = new Map(prev.map(p => [p.square, p]));
+
+    // Try to reuse IDs from previous render:
+    // 1. Same code on same square -> keep ID (piece didn't move)
+    // 2. Same code moved to a new square -> find unmatched previous piece of same code
+    const usedPrevIds = new Set();
+    const result = [];
+
+    // First pass: exact square matches (piece stayed or appeared on same square)
+    const unmatched = [];
+    for (const p of parsed) {
+      const existing = prevBySquare.get(p.square);
+      if (existing && existing.code === p.code && !usedPrevIds.has(existing.id)) {
+        usedPrevIds.add(existing.id);
+        result.push({
+          ...p,
+          id: existing.id
+        });
+      } else {
+        unmatched.push(p);
+      }
+    }
+
+    // Second pass: match unmatched pieces by code to previous pieces that moved
+    for (const p of unmatched) {
+      let matchedId = null;
+      for (const prevPiece of prev) {
+        if (prevPiece.code === p.code && !usedPrevIds.has(prevPiece.id)) {
+          matchedId = prevPiece.id;
+          usedPrevIds.add(prevPiece.id);
+          break;
+        }
+      }
+      if (matchedId) {
+        result.push({
+          ...p,
+          id: matchedId
+        });
+      } else {
+        // New piece (promotion, or first render) — assign fresh ID
+        const counter = idCounterRef.current;
+        counter[p.code] = (counter[p.code] ?? 0) + 1;
+        result.push({
+          ...p,
+          id: `${p.code}-${counter[p.code]}`
+        });
+      }
+    }
+    prevPiecesRef.current = result;
+    return result;
+  }, [fen]);
+}
+//# sourceMappingURL=use-board-pieces.js.map

package/lib/module/use-board-pieces.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useRef","FEN_PIECE_MAP","p","code","color","r","n","b","q","k","P","R","N","B","Q","K","FILES","parseFenPieces","fen","placement","split","ranks","pieces","rankIdx","length","rank","fileIdx","char","parseInt","mapping","square","push","squareToXY","squareSize","orientation","charCodeAt","col","row","x","y","xyToSquare","Math","max","min","floor","files","useBoardPieces","idCounterRef","prevPiecesRef","parsed","prev","current","prevBySquare","Map","map","usedPrevIds","Set","result","unmatched","existing","get","has","id","add","matchedId","prevPiece","counter"],"sourceRoot":"..\\..\\src","sources":["use-board-pieces.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/use-board-state.js

@@ -0,0 +1,74 @@
+"use strict";
+
+import { useRef, useCallback } from 'react';
+import { Chess } from 'chess.js';
+/**
+ * Manages the internal chess.js instance for legal move validation.
+ *
+ * This mirrors the visual board state. When the parent passes a new FEN,
+ * the internal chess.js is synced. Legal move queries and move application
+ * happen against this instance.
+ *
+ * The chess.js instance lives in a ref — no React state, no re-renders.
+ */
+export function useBoardState(initialFen) {
+  const chessRef = useRef(null);
+  if (!chessRef.current) chessRef.current = new Chess(initialFen);
+  const getLegalMoves = useCallback(square => {
+    try {
+      const moves = chessRef.current.moves({
+        square: square,
+        verbose: true
+      });
+      return moves.map(m => ({
+        square: m.to,
+        isCapture: m.captured !== undefined
+      }));
+    } catch {
+      return [];
+    }
+  }, []);
+  const isPlayerPiece = useCallback((square, pieces, player) => {
+    const piece = pieces.find(p => p.square === square);
+    if (!piece) return false;
+    if (player === 'both') return true;
+    const pieceColor = piece.color === 'w' ? 'white' : 'black';
+    return pieceColor === player;
+  }, []);
+  const applyMove = useCallback((from, to, promotion) => {
+    try {
+      chessRef.current.move({
+        from: from,
+        to: to,
+        promotion: promotion
+      });
+      return {
+        applied: true,
+        fen: chessRef.current.fen()
+      };
+    } catch {
+      return {
+        applied: false
+      };
+    }
+  }, []);
+  const undoMove = useCallback(() => {
+    const result = chessRef.current.undo();
+    return result ? chessRef.current.fen() : null;
+  }, []);
+  const loadFen = useCallback(fen => {
+    chessRef.current.load(fen);
+  }, []);
+  const getFen = useCallback(() => chessRef.current.fen(), []);
+  const getTurn = useCallback(() => chessRef.current.turn(), []);
+  return {
+    getLegalMoves,
+    isPlayerPiece,
+    applyMove,
+    undoMove,
+    loadFen,
+    getFen,
+    getTurn
+  };
+}
+//# sourceMappingURL=use-board-state.js.map