react-native-chess-kit 0.1.0 → 0.2.1

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

@@ -4,6 +4,37 @@ 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';
+
+// ---------------------------------------------------------------------------
+// Callback types
+// ---------------------------------------------------------------------------
+
+/** Rich callbacks exposed to consumers (all optional) */
+
+/** Premove-related callbacks from board.tsx */
+
+// ---------------------------------------------------------------------------
+// Params
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Check if a piece color matches the current player turn */
+function isPieceTurn(pieceColor, currentTurn) {
+  return pieceColor === currentTurn;
+}
+
+/** Map piece color char to player ChessColor */
+function pieceColorToPlayer(color) {
+  return color === 'w' ? 'white' : 'black';
+}
+
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+
 /**
  * Single centralized gesture handler for the entire board.
  *
@@ -22,6 +53,13 @@ import { xyToSquare } from './use-board-pieces';
  * 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.
+ *
+ * v0.2.0 additions:
+ * - Rich callbacks (onPieceClick, onSquareClick, onPieceDragBegin, onPieceDragEnd)
+ * - Drag target square tracking (shared value for DragTargetHighlight)
+ * - Premove support (queue move when not your turn)
+ * - Haptic feedback via callback
+ * - Long press detection for onSquareLongPress
  */
 export function useBoardGesture({
   squareSize,
@@ -31,8 +69,12 @@ export function useBoardGesture({
   moveMethod,
   pieces,
   callbacks,
+  richCallbacks,
+  premoveCallbacks,
+  premovesEnabled = false,
   selectedSquare,
-  legalMoves
+  legalMoves,
+  currentTurn
 }) {
   // Shared values for drag tracking — updated on UI thread only
   const activeSquare = useSharedValue(null);
@@ -40,12 +82,14 @@ export function useBoardGesture({
   const dragY = useSharedValue(0);
   const isDragging = useSharedValue(false);
   const dragPieceCode = useSharedValue(null);
+  const dragTargetSquare = useSharedValue(null);
   const gestureState = {
     activeSquare,
     dragX,
     dragY,
     isDragging,
-    dragPieceCode
+    dragPieceCode,
+    dragTargetSquare
   };
 
   // --- Refs for frequently-changing data (read from JS thread via runOnJS) ---
@@ -58,6 +102,15 @@ export function useBoardGesture({
   legalMovesRef.current = legalMoves;
   const callbacksRef = useRef(callbacks);
   callbacksRef.current = callbacks;
+  const richCallbacksRef = useRef(richCallbacks);
+  richCallbacksRef.current = richCallbacks;
+  const premoveCallbacksRef = useRef(premoveCallbacks);
+  premoveCallbacksRef.current = premoveCallbacks;
+  const currentTurnRef = useRef(currentTurn);
+  currentTurnRef.current = currentTurn;
+
+  // Track the piece being dragged for rich drag-end callback
+  const draggedPieceRef = useRef(null);
 
   // --- JS-thread bridge functions called from worklets via runOnJS ---
   // These read current values from refs, so they always have fresh data.
@@ -68,11 +121,16 @@ export function useBoardGesture({
     const currentSelected = selectedSquareRef.current;
     const currentLegalMoves = legalMovesRef.current;
     const cbs = callbacksRef.current;
+    const rich = richCallbacksRef.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;
+    const isPlayerPiece = piece ? player === 'both' || pieceColorToPlayer(piece.color) === player : false;
+
+    // Check if it's this piece's turn (for premove detection)
+    const turn = currentTurnRef.current;
+    const isOwnTurn = piece && turn ? isPieceTurn(piece.color, turn) : true; // default to true if turn not tracked
 
     // Click-to-move: second tap on a legal target square
     const legalSquares = new Set(currentLegalMoves.map(m => m.square));
@@ -81,38 +139,136 @@ export function useBoardGesture({
       activeSquare.value = null;
       isDragging.value = false;
       dragPieceCode.value = null;
+      dragTargetSquare.value = null;
+      rich?.onHaptic?.('move');
       return;
     }
     if (isPlayerPiece && piece) {
-      // Tapped/started dragging a player piece
+      // Premove: player piece but not their turn
+      if (premovesEnabled && !isOwnTurn) {
+        // If there's already a selected square, this tap completes a premove
+        if (currentSelected && currentSelected !== square) {
+          premoveCallbacksRef.current?.onPremoveSet?.({
+            from: currentSelected,
+            to: square
+          });
+          cbs.onSelectionCleared();
+          activeSquare.value = null;
+          dragPieceCode.value = null;
+          dragTargetSquare.value = null;
+          return;
+        }
+        // First tap: select the piece for premove
+        activeSquare.value = square;
+        dragX.value = touchX;
+        dragY.value = touchY;
+        dragPieceCode.value = piece.code;
+        cbs.onPieceSelected(square);
+        rich?.onPieceClick?.(square, piece.code);
+        rich?.onHaptic?.('select');
+        return;
+      }
+
+      // Normal case: tapped/started dragging a player piece on their turn
       activeSquare.value = square;
       dragX.value = touchX;
       dragY.value = touchY;
       dragPieceCode.value = piece.code;
+      draggedPieceRef.current = {
+        square,
+        code: piece.code
+      };
       cbs.onPieceSelected(square);
+
+      // Rich callbacks
+      rich?.onPieceClick?.(square, piece.code);
+      rich?.onHaptic?.('select');
     } else {
-      // Tapped empty square or opponent piece — clear selection
+      // Tapped empty square or opponent piece
+
+      // If premoves enabled and there's a selection, check if this is a premove target
+      if (premovesEnabled && currentSelected && !isOwnTurn) {
+        premoveCallbacksRef.current?.onPremoveSet?.({
+          from: currentSelected,
+          to: square
+        });
+        cbs.onSelectionCleared();
+        activeSquare.value = null;
+        dragPieceCode.value = null;
+        dragTargetSquare.value = null;
+        return;
+      }
       activeSquare.value = null;
       dragPieceCode.value = null;
+      dragTargetSquare.value = null;
       if (currentSelected) {
         cbs.onSelectionCleared();
       }
+
+      // Rich callback: square click (empty square or opponent piece)
+      rich?.onSquareClick?.(square);
+    }
+  }, [squareSize, orientation, player, moveMethod, premovesEnabled, activeSquare, dragX, dragY, isDragging, dragPieceCode, dragTargetSquare]);
+  const handleDragStart = useCallback((touchX, touchY) => {
+    const rich = richCallbacksRef.current;
+    const dragged = draggedPieceRef.current;
+    if (dragged) {
+      rich?.onPieceDragBegin?.(dragged.square, dragged.code);
     }
-  }, [squareSize, orientation, player, moveMethod, activeSquare, dragX, dragY, isDragging, dragPieceCode]);
+    // Update drag target to current square
+    const square = xyToSquare(touchX, touchY, squareSize, orientation);
+    dragTargetSquare.value = square;
+  }, [squareSize, orientation, dragTargetSquare]);
+  const handleDragUpdate = useCallback((touchX, touchY) => {
+    // Update drag target square (for highlight). This runs on JS thread
+    // but is called from worklet via runOnJS only when the square changes.
+    const square = xyToSquare(touchX, touchY, squareSize, orientation);
+    dragTargetSquare.value = square;
+  }, [squareSize, orientation, dragTargetSquare]);
   const handleEnd = useCallback((touchX, touchY) => {
     const fromSquare = activeSquare.value;
     if (!fromSquare) return;
     const toSquare = xyToSquare(touchX, touchY, squareSize, orientation);
     isDragging.value = false;
+    dragTargetSquare.value = null;
+    const rich = richCallbacksRef.current;
+
+    // Fire drag end callback
+    const dragged = draggedPieceRef.current;
+    if (dragged) {
+      rich?.onPieceDragEnd?.(toSquare, dragged.code);
+      draggedPieceRef.current = null;
+    }
     if (fromSquare !== toSquare) {
-      callbacksRef.current.onPieceMoved(fromSquare, toSquare);
+      // Check if this is a premove (not your turn)
+      const turn = currentTurnRef.current;
+      const piece = piecesRef.current.find(p => p.square === fromSquare);
+      const isOwnTurn = piece && turn ? isPieceTurn(piece.color, turn) : true;
+      if (premovesEnabled && !isOwnTurn) {
+        premoveCallbacksRef.current?.onPremoveSet?.({
+          from: fromSquare,
+          to: toSquare
+        });
+      } else {
+        callbacksRef.current.onPieceMoved(fromSquare, toSquare);
+      }
     }
     activeSquare.value = null;
     dragPieceCode.value = null;
-  }, [squareSize, orientation, activeSquare, isDragging, dragPieceCode]);
+  }, [squareSize, orientation, activeSquare, isDragging, dragPieceCode, dragTargetSquare, premovesEnabled]);
+
+  // Long press handler (separate gesture, composed with pan)
+  const handleLongPress = useCallback((touchX, touchY) => {
+    const square = xyToSquare(touchX, touchY, squareSize, orientation);
+    richCallbacksRef.current?.onSquareLongPress?.(square);
+  }, [squareSize, orientation]);
 
   // --- Build the gesture (STABLE — only changes on layout/config changes) ---
   const canDrag = moveMethod !== 'click';
+
+  // Track the last drag target square to avoid redundant runOnJS calls
+  const lastDragTargetCol = useSharedValue(-1);
+  const lastDragTargetRow = useSharedValue(-1);
   const gesture = useMemo(() => {
     return Gesture.Pan().enabled(gestureEnabled).minDistance(0) // Also detect taps (zero-distance pans)
     .onBegin(e => {
@@ -120,11 +276,12 @@ export function useBoardGesture({
 
       // Bridge to JS for piece lookup + selection logic
       runOnJS(handleBegin)(e.x, e.y);
-    }).onStart(() => {
+    }).onStart(e => {
       'worklet';
 
       if (!canDrag || !activeSquare.value) return;
       isDragging.value = true;
+      runOnJS(handleDragStart)(e.x, e.y);
     }).onUpdate(e => {
       'worklet';
 
@@ -132,6 +289,15 @@ export function useBoardGesture({
       // Only 2 shared value writes — no JS bridge, no re-renders
       dragX.value = e.x;
       dragY.value = e.y;
+
+      // Update drag target square (only when square changes to minimize JS bridge calls)
+      const col = Math.max(0, Math.min(7, Math.floor(e.x / squareSize)));
+      const row = Math.max(0, Math.min(7, Math.floor(e.y / squareSize)));
+      if (col !== lastDragTargetCol.value || row !== lastDragTargetRow.value) {
+        lastDragTargetCol.value = col;
+        lastDragTargetRow.value = row;
+        runOnJS(handleDragUpdate)(e.x, e.y);
+      }
     }).onEnd(e => {
       'worklet';
 
@@ -142,10 +308,18 @@ export function useBoardGesture({
 
       // Safety reset if gesture was interrupted
       isDragging.value = false;
+      dragTargetSquare.value = null;
+      lastDragTargetCol.value = -1;
+      lastDragTargetRow.value = -1;
     });
-  }, [gestureEnabled, canDrag, handleBegin, handleEnd,
+  }, [gestureEnabled, canDrag, squareSize, handleBegin, handleDragStart, handleDragUpdate, handleEnd,
   // Shared values are stable refs — listed for exhaustive-deps but don't cause recreations
-  activeSquare, dragX, dragY, isDragging]);
+  activeSquare, dragX, dragY, isDragging, dragTargetSquare, lastDragTargetCol, lastDragTargetRow]);
+
+  // Compose with long press if the consumer wants it
+  // For now, long press is detected via a separate gesture that runs simultaneously.
+  // This is done at the board level if needed — keeping the pan gesture clean here.
+
   return {
     gesture,
     gestureState

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

@@ -1 +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":[]}
+{"version":3,"names":["useMemo","useCallback","useRef","Gesture","useSharedValue","runOnJS","xyToSquare","isPieceTurn","pieceColor","currentTurn","pieceColorToPlayer","color","useBoardGesture","squareSize","orientation","gestureEnabled","player","moveMethod","pieces","callbacks","richCallbacks","premoveCallbacks","premovesEnabled","selectedSquare","legalMoves","activeSquare","dragX","dragY","isDragging","dragPieceCode","dragTargetSquare","gestureState","piecesRef","current","selectedSquareRef","legalMovesRef","callbacksRef","richCallbacksRef","premoveCallbacksRef","currentTurnRef","draggedPieceRef","handleBegin","touchX","touchY","square","currentPieces","currentSelected","currentLegalMoves","cbs","rich","canClick","piece","find","p","isPlayerPiece","turn","isOwnTurn","legalSquares","Set","map","m","has","onPieceMoved","value","onHaptic","onPremoveSet","from","to","onSelectionCleared","code","onPieceSelected","onPieceClick","onSquareClick","handleDragStart","dragged","onPieceDragBegin","handleDragUpdate","handleEnd","fromSquare","toSquare","onPieceDragEnd","handleLongPress","onSquareLongPress","canDrag","lastDragTargetCol","lastDragTargetRow","gesture","Pan","enabled","minDistance","onBegin","e","x","y","onStart","onUpdate","col","Math","max","min","floor","row","onEnd","onFinalize"],"sourceRoot":"..\\..\\src","sources":["use-board-gesture.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/use-premove.js

@@ -0,0 +1,40 @@
+"use strict";
+
+import { useState, useCallback } from 'react';
+/**
+ * Manages a single premove queue (one premove at a time).
+ *
+ * Premoves work like lichess:
+ * 1. When it's not your turn, you can drag/click a move — it queues as a premove
+ * 2. The premove squares are highlighted with a distinct color
+ * 3. When your turn begins (FEN changes and it's now your turn), the premove
+ *    is automatically attempted via the board's internal chess.js
+ * 4. If the premove is legal, it's applied; if not, it's silently discarded
+ *
+ * The board.tsx orchestrates this: it calls consumePremove() in a useEffect
+ * that watches the FEN (turn change), then attempts the move.
+ */
+export function usePremove() {
+  const [premove, setPremoveState] = useState(null);
+  const setPremove = useCallback(pm => {
+    setPremoveState(pm);
+  }, []);
+  const clearPremove = useCallback(() => {
+    setPremoveState(null);
+  }, []);
+  const consumePremove = useCallback(() => {
+    let consumed = null;
+    setPremoveState(current => {
+      consumed = current;
+      return null;
+    });
+    return consumed;
+  }, []);
+  return {
+    premove,
+    setPremove,
+    clearPremove,
+    consumePremove
+  };
+}
+//# sourceMappingURL=use-premove.js.map

package/lib/module/use-premove.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","usePremove","premove","setPremoveState","setPremove","pm","clearPremove","consumePremove","consumed","current"],"sourceRoot":"..\\..\\src","sources":["use-premove.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,OAAO;AAmB7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,MAAM,CAACC,OAAO,EAAEC,eAAe,CAAC,GAAGJ,QAAQ,CAAqB,IAAI,CAAC;EAErE,MAAMK,UAAU,GAAGJ,WAAW,CAAEK,EAAe,IAAK;IAClDF,eAAe,CAACE,EAAE,CAAC;EACrB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,YAAY,GAAGN,WAAW,CAAC,MAAM;IACrCG,eAAe,CAAC,IAAI,CAAC;EACvB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMI,cAAc,GAAGP,WAAW,CAAC,MAA0B;IAC3D,IAAIQ,QAA4B,GAAG,IAAI;IACvCL,eAAe,CAAEM,OAAO,IAAK;MAC3BD,QAAQ,GAAGC,OAAO;MAClB,OAAO,IAAI;IACb,CAAC,CAAC;IACF,OAAOD,QAAQ;EACjB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLN,OAAO;IACPE,UAAU;IACVE,YAAY;IACZC;EACF,CAAC;AACH","ignoreList":[]}

package/lib/typescript/board-annotations.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { ChessColor, AnnotationData } from './types';
+type BoardAnnotationsProps = {
+    boardSize: number;
+    orientation: ChessColor;
+    squareSize: number;
+    annotations: AnnotationData[];
+};
+/**
+ * Text annotation badges on chess squares (!, ?, !!, ??, etc.).
+ *
+ * Each annotation appears as a small colored badge at the top-right
+ * corner of the target square. Positioned absolutely, pointer-events none.
+ */
+export declare const BoardAnnotations: React.NamedExoticComponent<BoardAnnotationsProps>;
+type AnnotationBadgeProps = {
+    square: string;
+    text: string;
+    squareSize: number;
+    orientation: ChessColor;
+    color?: string;
+    backgroundColor?: string;
+};
+/**
+ * Single annotation badge component.
+ * Exported for consumers who build their own overlay layers.
+ */
+export declare const Annotation: React.NamedExoticComponent<AnnotationBadgeProps>;
+export {};
+//# sourceMappingURL=board-annotations.d.ts.map

package/lib/typescript/board-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-annotations.d.ts","sourceRoot":"","sources":["../../src/board-annotations.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQ1D,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,mDAuD3B,CAAC;AAMH,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,kDA4CrB,CAAC"}

package/lib/typescript/board-arrows.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { ChessColor, ArrowData, ShapeData } from './types';
+type BoardArrowsProps = {
+    boardSize: number;
+    orientation: ChessColor;
+    arrows?: ArrowData[];
+    shapes?: ShapeData[];
+};
+/**
+ * SVG overlay for arrows and shapes drawn on the board.
+ *
+ * Uses a percentage-based 100x100 viewBox so coordinates map cleanly
+ * to the 8x8 grid (each square = 12.5 x 12.5 units).
+ *
+ * Renders above the pieces layer so arrows are always visible.
+ */
+export declare const BoardArrows: React.NamedExoticComponent<BoardArrowsProps>;
+type ArrowSvgProps = {
+    from: string;
+    to: string;
+    color: string;
+    width: number;
+    orientation: ChessColor;
+};
+declare const ArrowSvg: React.NamedExoticComponent<ArrowSvgProps>;
+export { ArrowSvg as Arrow };
+//# sourceMappingURL=board-arrows.d.ts.map

package/lib/typescript/board-arrows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-arrows.d.ts","sourceRoot":"","sources":["../../src/board-arrows.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAmDhE,KAAK,gBAAgB,GAAG;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,8CAsDtB,CAAC;AAMH,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,QAAA,MAAM,QAAQ,2CAgDZ,CAAC;AAMH,OAAO,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC"}

package/lib/typescript/board-highlights.d.ts

@@ -0,0 +1,65 @@
+import React from 'react';
+import { type SharedValue } from 'react-native-reanimated';
+import type { ChessColor, HighlightData } from './types';
+type BoardHighlightsProps = {
+    boardSize: number;
+    orientation: ChessColor;
+    squareSize: number;
+    /** Last move squares to highlight */
+    lastMove?: {
+        from: string;
+        to: string;
+    } | null;
+    lastMoveColor: string;
+    /** Check highlight on king square (auto-detected) */
+    checkSquare?: string | null;
+    checkColor: string;
+    /** Selected piece square */
+    selectedSquare?: string | null;
+    selectedColor: string;
+    /** Premove squares */
+    premoveSquares?: {
+        from: string;
+        to: string;
+    } | null;
+    premoveColor: string;
+    /** Custom highlights from consumer */
+    highlights?: HighlightData[];
+    /** Imperative highlights (from ref.highlight()) */
+    imperativeHighlights?: HighlightData[];
+};
+type DragTargetHighlightProps = {
+    squareSize: number;
+    orientation: ChessColor;
+    dragTargetSquare: SharedValue<string | null>;
+    color: string;
+};
+/**
+ * Renders all board square highlights as a single layer.
+ *
+ * Combines multiple highlight sources (last move, check, selected piece,
+ * premoves, custom, and imperative) into one flat list of colored rectangles.
+ * Rendered between the background and pieces layers.
+ *
+ * Uses plain Views (not Animated) because highlights change discretely
+ * on move events, not during animation frames.
+ */
+export declare const BoardHighlights: React.NamedExoticComponent<BoardHighlightsProps>;
+/**
+ * Highlight on the square currently under the dragged piece.
+ * Uses Reanimated shared values for zero-JS-bridge updates during drag.
+ */
+export declare const DragTargetHighlight: React.NamedExoticComponent<DragTargetHighlightProps>;
+type SquareHighlightProps = {
+    square: string;
+    color: string;
+    squareSize: number;
+    orientation: ChessColor;
+};
+/**
+ * Single square highlight component.
+ * Exported for consumers who build their own overlay layers.
+ */
+export declare const SquareHighlight: React.NamedExoticComponent<SquareHighlightProps>;
+export {};
+//# sourceMappingURL=board-highlights.d.ts.map

package/lib/typescript/board-highlights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-highlights.d.ts","sourceRoot":"","sources":["../../src/board-highlights.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAiB,EAEf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAOzD,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,aAAa,EAAE,CAAC;CACxC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,kDA+E1B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,sDAyC9B,CAAC;AAMH,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,kDAqB1B,CAAC"}

package/lib/typescript/board-piece.d.ts

@@ -1,13 +1,16 @@
 import React from 'react';
 import { type SharedValue } from 'react-native-reanimated';
+import type { AnimationConfig } from './types';
 type BoardPieceProps = {
     /** Target pixel position (top-left of destination square) */
     targetX: number;
     targetY: number;
     /** Square size in pixels */
     squareSize: number;
-    /** Move animation duration in ms */
-    moveDuration: number;
+    /** Animation config for piece movement (timing or spring) */
+    animationConfig?: AnimationConfig;
+    /** Fallback move duration if animationConfig not provided */
+    moveDuration?: number;
     /** The piece visual (rendered by parent via renderPiece) */
     children: React.ReactElement;
     /** Gesture state: is this piece currently being dragged? */
@@ -19,17 +22,24 @@ type BoardPieceProps = {
 /**
  * A single animated chess piece.
  *
- * Animates ONLY `transform` and `opacity` — Reanimated's fast path on Android.
- * No layout properties (top/left/width/height) are animated, avoiding costly
- * layout recalculations on low-end devices.
+ * Uses two nested Animated.Views to avoid the Reanimated warning
+ * "Property opacity may be overwritten by a layout animation":
+ *
+ * Outer view: position (transform) + exiting layout animation (FadeOut)
+ * Inner view: drag-hide opacity
+ *
+ * Only `transform` and `opacity` are animated — Reanimated's fast path
+ * on Android. No layout properties (top/left/width/height), avoiding
+ * costly layout recalculations on low-end devices.
  *
  * During drag:
- * - Original piece hides (opacity: 0) — the drag ghost shows instead
- * - No position changes on the original piece during drag
+ * - Inner view hides (opacity: 0) — the drag ghost shows instead
  *
  * After a move:
- * - Snaps to new position via withTiming on translateX/translateY
- * - Duration controlled by user's animation speed setting
+ * - Outer view snaps to new position via withTiming/withSpring
+ *
+ * On capture (unmount):
+ * - Outer view fades out via exiting FadeOut (no conflict with inner opacity)
  */
 export declare const BoardPieceView: React.NamedExoticComponent<BoardPieceProps>;
 export {};

package/lib/typescript/board-piece.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board-piece.d.ts","sourceRoot":"","sources":["../../src/board-piece.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAiB,EAIf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,KAAK,eAAe,GAAG;IACrB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;IAC7B,4DAA4D;IAC5D,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,6CA+D1B,CAAC"}
+{"version":3,"file":"board-piece.d.ts","sourceRoot":"","sources":["../../src/board-piece.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAiB,EAMf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,KAAK,eAAe,GAAG;IACrB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;IAC7B,4DAA4D;IAC5D,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA8BF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,6CAqE1B,CAAC"}

package/lib/typescript/board-pieces.d.ts

@@ -1,11 +1,12 @@
 import React from 'react';
 import type { SharedValue } from 'react-native-reanimated';
-import type { ChessColor, BoardPiece } from './types';
+import type { ChessColor, BoardPiece, AnimationConfig } from './types';
 type BoardPiecesProps = {
     pieces: BoardPiece[];
     squareSize: number;
     orientation: ChessColor;
     moveDuration: number;
+    animationConfig?: AnimationConfig;
     renderPiece: (code: string, size: number) => React.ReactElement;
     activeSquare: SharedValue<string | null>;
     isDragging: SharedValue<boolean>;

package/lib/typescript/board-pieces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board-pieces.d.ts","sourceRoot":"","sources":["../../src/board-pieces.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAItD,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAChE,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,8CA+B3B,CAAC"}
+{"version":3,"file":"board-pieces.d.ts","sourceRoot":"","sources":["../../src/board-pieces.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIvE,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAChE,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,8CAiC3B,CAAC"}

package/lib/typescript/board.d.ts

@@ -10,8 +10,17 @@ import type { BoardRef, BoardProps } from './types';
  * - 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.
+ * v0.2.0 layer stack (10 layers):
+ * 1. BoardBackground (64 squares)
+ * 2. BoardCoordinates (a-h, 1-8)
+ * 3. BoardHighlights (last move, check, selected, premove, custom, imperative)
+ * 4. DragTargetHighlight (animated, worklet-driven)
+ * 5. BoardLegalDots (legal move indicators)
+ * 6. BoardPiecesLayer (all pieces)
+ * 7. BoardArrows (SVG arrows + circles)
+ * 8. BoardAnnotations (text badges)
+ * 9. BoardDragGhost (floating piece)
+ * 10. PromotionPicker (modal, conditional)
  */
 export declare const Board: React.ForwardRefExoticComponent<BoardProps & React.RefAttributes<BoardRef>>;
 //# sourceMappingURL=board.d.ts.map

package/lib/typescript/board.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/board.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4E,MAAM,OAAO,CAAC;AAIjG,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAUrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,6EA+KhB,CAAC"}
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/board.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AASf,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EAKX,MAAM,SAAS,CAAC;AAoEjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK,6EAwfhB,CAAC"}