react-native-chess-kit 0.5.2 → 0.5.4

package/src/static-board.tsx

@@ -1,187 +1,186 @@
-import React, { useState, useCallback, useMemo } from 'react';
-import { View, type LayoutChangeEvent } from 'react-native';
-
-import type { StaticBoardProps, ChessColor, PieceCode } from './types';
-import { DEFAULT_BOARD_COLORS, DEFAULT_LAST_MOVE_COLOR, COORDINATE_GUTTER_SCALE } from './constants';
-import { DefaultPieceSet } from './pieces';
-import { useBoardPieces, squareToXY } from './use-board-pieces';
-import { BoardBackground } from './board-background';
-import { BoardCoordinates } from './board-coordinates';
-import { BoardHighlights } from './board-highlights';
-import { BoardArrows } from './board-arrows';
-import { BoardAnnotations } from './board-annotations';
-
-/**
- * Non-interactive chess board — optimized for lists, thumbnails, and analysis previews.
- *
- * No gesture handler, no drag ghost, no legal move dots.
- * Just: background + coordinates + highlights + pieces + arrows + annotations.
- *
- * Significantly lighter than the full Board component.
- */
-export const StaticBoard = React.memo(function StaticBoard({
-  fen,
-  orientation = 'white',
-  boardSize: boardSizeProp,
-  colors,
-  coordinatePosition: coordinatePositionProp,
-  withCoordinates,
-  renderPiece,
-  pieceSet,
-  lastMove,
-  highlights,
-  arrows,
-  annotations,
-}: StaticBoardProps) {
-  // --- Auto-sizing via onLayout when boardSize not provided ---
-  const [measuredSize, setMeasuredSize] = useState(0);
-  const handleLayout = useCallback((e: LayoutChangeEvent) => {
-    const { width, height } = e.nativeEvent.layout;
-    setMeasuredSize(Math.min(width, height));
-  }, []);
-
-  const outerSize = boardSizeProp ?? measuredSize;
-  const boardColors = colors ?? DEFAULT_BOARD_COLORS;
-
-  // Resolve coordinate position: new prop > legacy boolean > 'none'
-  const coordinatePosition = coordinatePositionProp
-    ?? (withCoordinates ? 'inside' : 'none');
-  const isOutside = coordinatePosition === 'outside';
-  const isCoordVisible = coordinatePosition !== 'none';
-
-  const gutterWidth = isOutside ? Math.round((outerSize / 8) * COORDINATE_GUTTER_SCALE) : 0;
-  const boardSize = isOutside ? outerSize - gutterWidth : outerSize;
-  const squareSize = boardSize / 8;
-
-  // --- Piece data from FEN ---
-  const pieces = useBoardPieces(fen);
-
-  // --- Resolve piece renderer: renderPiece > pieceSet > DefaultPieceSet ---
-  const resolvedRenderer = useMemo(() => {
-    if (renderPiece) return renderPiece;
-    const set = pieceSet ?? DefaultPieceSet;
-    return (code: string, size: number) => {
-      const renderer = set[code as PieceCode];
-      if (renderer) return renderer(size);
-      // Fallback for unknown piece codes
-      return <View style={{ width: size, height: size }} />;
-    };
-  }, [renderPiece, pieceSet]);
-
-  // If no size yet (auto-sizing), render invisible container for measurement
-  if (outerSize === 0) {
-    return (
-      <View style={{ flex: 1, aspectRatio: 1 }} onLayout={handleLayout} />
-    );
-  }
-
-  const boardContent = (
-    <View
-      style={isOutside
-        ? { width: boardSize, height: boardSize, position: 'absolute', top: 0, right: 0 }
-        : { width: boardSize, height: boardSize }}
-      onLayout={!isOutside && !boardSizeProp ? handleLayout : undefined}
-      accessibilityLabel="Chess board"
-      accessibilityRole="image"
-    >
-      {/* Layer 1: Board background */}
-      <BoardBackground
-        boardSize={boardSize}
-        lightColor={boardColors.light}
-        darkColor={boardColors.dark}
-      />
-
-      {/* Layer 2: Inside coordinates */}
-      {isCoordVisible && !isOutside && (
-        <BoardCoordinates
-          boardSize={boardSize}
-          orientation={orientation}
-          lightColor={boardColors.light}
-          darkColor={boardColors.dark}
-          withLetters
-          withNumbers
-          position="inside"
-        />
-      )}
-
-      {/* Layer 3: Highlights */}
-      <BoardHighlights
-        boardSize={boardSize}
-        orientation={orientation}
-        squareSize={squareSize}
-        lastMove={lastMove}
-        lastMoveColor={DEFAULT_LAST_MOVE_COLOR}
-        checkColor="transparent"
-        selectedColor="transparent"
-        premoveColor="transparent"
-        highlights={highlights}
-      />
-
-      {/* Layer 4: Pieces (static — no animation needed) */}
-      <View
-        style={{ position: 'absolute', width: boardSize, height: boardSize }}
-        pointerEvents="none"
-      >
-        {pieces.map((piece) => {
-          const { x, y } = squareToXY(piece.square, squareSize, orientation);
-          return (
-            <View
-              key={piece.id}
-              style={{
-                position: 'absolute',
-                width: squareSize,
-                height: squareSize,
-                transform: [{ translateX: x }, { translateY: y }],
-              }}
-            >
-              {resolvedRenderer(piece.code, squareSize)}
-            </View>
-          );
-        })}
-      </View>
-
-      {/* Layer 5: Arrows */}
-      {arrows && arrows.length > 0 && (
-        <BoardArrows
-          boardSize={boardSize}
-          orientation={orientation}
-          arrows={arrows}
-        />
-      )}
-
-      {/* Layer 6: Annotations */}
-      {annotations && annotations.length > 0 && (
-        <BoardAnnotations
-          boardSize={boardSize}
-          orientation={orientation}
-          squareSize={squareSize}
-          annotations={annotations}
-        />
-      )}
-    </View>
-  );
-
-  if (isOutside) {
-    return (
-      <View
-        style={{ width: outerSize, height: boardSize + gutterWidth }}
-        onLayout={boardSizeProp ? undefined : handleLayout}
-      >
-        {boardContent}
-
-        <BoardCoordinates
-          boardSize={boardSize}
-          orientation={orientation}
-          lightColor={boardColors.light}
-          darkColor={boardColors.dark}
-          withLetters
-          withNumbers
-          position="outside"
-          gutterWidth={gutterWidth}
-        />
-      </View>
-    );
-  }
-
-  return boardContent;
-});
+import React, { useState, useCallback, useMemo } from 'react';
+import { View, type LayoutChangeEvent } from 'react-native';
+
+import type { StaticBoardProps, PieceCode } from './types';
+import {
+  DEFAULT_BOARD_COLORS,
+  DEFAULT_LAST_MOVE_COLOR,
+  COORDINATE_GUTTER_SCALE,
+} from './constants';
+import { DefaultPieceSet } from './pieces';
+import { useBoardPieces, squareToXY } from './use-board-pieces';
+import { BoardBackground } from './board-background';
+import { BoardCoordinates } from './board-coordinates';
+import { BoardHighlights } from './board-highlights';
+import { BoardArrows } from './board-arrows';
+import { BoardAnnotations } from './board-annotations';
+
+/**
+ * Non-interactive chess board — optimized for lists, thumbnails, and analysis previews.
+ *
+ * No gesture handler, no drag ghost, no legal move dots.
+ * Just: background + coordinates + highlights + pieces + arrows + annotations.
+ *
+ * Significantly lighter than the full Board component.
+ */
+export const StaticBoard = React.memo(function StaticBoard({
+  fen,
+  orientation = 'white',
+  boardSize: boardSizeProp,
+  colors,
+  coordinatePosition: coordinatePositionProp,
+  withCoordinates,
+  renderPiece,
+  pieceSet,
+  lastMove,
+  highlights,
+  arrows,
+  annotations,
+}: StaticBoardProps) {
+  // --- Auto-sizing via onLayout when boardSize not provided ---
+  const [measuredSize, setMeasuredSize] = useState(0);
+  const handleLayout = useCallback((e: LayoutChangeEvent) => {
+    const { width, height } = e.nativeEvent.layout;
+    setMeasuredSize(Math.min(width, height));
+  }, []);
+
+  const outerSize = boardSizeProp ?? measuredSize;
+  const boardColors = colors ?? DEFAULT_BOARD_COLORS;
+
+  // Resolve coordinate position: new prop > legacy boolean > 'none'
+  const coordinatePosition = coordinatePositionProp ?? (withCoordinates ? 'inside' : 'none');
+  const isOutside = coordinatePosition === 'outside';
+  const isCoordVisible = coordinatePosition !== 'none';
+
+  const gutterWidth = isOutside ? Math.round((outerSize / 8) * COORDINATE_GUTTER_SCALE) : 0;
+  const boardSize = isOutside ? outerSize - gutterWidth : outerSize;
+  const squareSize = boardSize / 8;
+
+  // --- Piece data from FEN ---
+  const pieces = useBoardPieces(fen);
+
+  // --- Resolve piece renderer: renderPiece > pieceSet > DefaultPieceSet ---
+  const resolvedRenderer = useMemo(() => {
+    if (renderPiece) return renderPiece;
+    const set = pieceSet ?? DefaultPieceSet;
+    return (code: string, size: number) => {
+      const renderer = set[code as PieceCode];
+      if (renderer) return renderer(size);
+      // Fallback for unknown piece codes
+      return <View style={{ width: size, height: size }} />;
+    };
+  }, [renderPiece, pieceSet]);
+
+  // If no size yet (auto-sizing), render invisible container for measurement
+  if (outerSize === 0) {
+    return <View style={{ flex: 1, aspectRatio: 1 }} onLayout={handleLayout} />;
+  }
+
+  const boardContent = (
+    <View
+      style={
+        isOutside
+          ? { width: boardSize, height: boardSize, position: 'absolute', top: 0, right: 0 }
+          : { width: boardSize, height: boardSize }
+      }
+      onLayout={!isOutside && !boardSizeProp ? handleLayout : undefined}
+      accessibilityLabel="Chess board"
+      accessibilityRole="image"
+    >
+      {/* Layer 1: Board background */}
+      <BoardBackground
+        boardSize={boardSize}
+        lightColor={boardColors.light}
+        darkColor={boardColors.dark}
+      />
+
+      {/* Layer 2: Inside coordinates */}
+      {isCoordVisible && !isOutside && (
+        <BoardCoordinates
+          boardSize={boardSize}
+          orientation={orientation}
+          lightColor={boardColors.light}
+          darkColor={boardColors.dark}
+          withLetters
+          withNumbers
+          position="inside"
+        />
+      )}
+
+      {/* Layer 3: Highlights */}
+      <BoardHighlights
+        boardSize={boardSize}
+        orientation={orientation}
+        squareSize={squareSize}
+        lastMove={lastMove}
+        lastMoveColor={DEFAULT_LAST_MOVE_COLOR}
+        checkColor="transparent"
+        selectedColor="transparent"
+        premoveColor="transparent"
+        highlights={highlights}
+      />
+
+      {/* Layer 4: Pieces (static — no animation needed) */}
+      <View
+        style={{ position: 'absolute', width: boardSize, height: boardSize }}
+        pointerEvents="none"
+      >
+        {pieces.map((piece) => {
+          const { x, y } = squareToXY(piece.square, squareSize, orientation);
+          return (
+            <View
+              key={piece.id}
+              style={{
+                position: 'absolute',
+                width: squareSize,
+                height: squareSize,
+                transform: [{ translateX: x }, { translateY: y }],
+              }}
+            >
+              {resolvedRenderer(piece.code, squareSize)}
+            </View>
+          );
+        })}
+      </View>
+
+      {/* Layer 5: Arrows */}
+      {arrows && arrows.length > 0 && (
+        <BoardArrows boardSize={boardSize} orientation={orientation} arrows={arrows} />
+      )}
+
+      {/* Layer 6: Annotations */}
+      {annotations && annotations.length > 0 && (
+        <BoardAnnotations
+          boardSize={boardSize}
+          orientation={orientation}
+          squareSize={squareSize}
+          annotations={annotations}
+        />
+      )}
+    </View>
+  );
+
+  if (isOutside) {
+    return (
+      <View
+        style={{ width: outerSize, height: boardSize + gutterWidth }}
+        onLayout={boardSizeProp ? undefined : handleLayout}
+      >
+        {boardContent}
+
+        <BoardCoordinates
+          boardSize={boardSize}
+          orientation={orientation}
+          lightColor={boardColors.light}
+          darkColor={boardColors.dark}
+          withLetters
+          withNumbers
+          position="outside"
+          gutterWidth={gutterWidth}
+        />
+      </View>
+    );
+  }
+
+  return boardContent;
+});

package/src/types.ts

@@ -25,8 +25,18 @@ export type HapticType = 'select' | 'move' | 'capture' | 'error';
 
 /** Standard piece codes used throughout the library */
 export type PieceCode =
-  | 'wp' | 'wn' | 'wb' | 'wr' | 'wq' | 'wk'
-  | 'bp' | 'bn' | 'bb' | 'br' | 'bq' | 'bk';
+  | 'wp'
+  | 'wn'
+  | 'wb'
+  | 'wr'
+  | 'wq'
+  | 'wk'
+  | 'bp'
+  | 'bn'
+  | 'bb'
+  | 'br'
+  | 'bq'
+  | 'bk';
 
 /** A single piece on the board with its position and identity */
 export type BoardPiece = {
@@ -278,15 +288,26 @@ export type BoardProps = {
   // --- Promotion ---
 
   /**
-   * Called when a pawn promotion occurs. If not provided, auto-promotes to queen.
-   * Return the chosen piece to complete the promotion.
+   * Auto-promote pawns to this piece without showing the picker.
+   * When set, the promotion picker is skipped entirely.
+   * Example: `autoPromoteTo="q"` always promotes to queen.
+   */
+  autoPromoteTo?: PromotionPiece;
+
+  /**
+   * Called when a pawn promotion occurs. If not provided, the built-in
+   * promotion picker is shown. Return the chosen piece to complete the
+   * promotion, or throw/reject to cancel.
+   *
+   * When provided, the built-in picker is NOT shown — the consumer is
+   * expected to handle piece selection via their own UI.
    */
   onPromotion?: (from: string, to: string) => Promise<PromotionPiece> | PromotionPiece;
 
   // --- Callbacks ---
 
-  /** Called after a visual move is applied */
-  onMove?: (info: { from: string; to: string }) => void;
+  /** Called after a visual move is applied. Includes `promotion` when a pawn promotes. */
+  onMove?: (info: { from: string; to: string; promotion?: PromotionPiece }) => void;
   /** Called when a piece is tapped */
   onPieceClick?: (square: string, piece: PieceCode) => void;
   /** Called when an empty square or opponent piece is tapped */