react-native-chess-kit 0.1.0 → 0.2.0

package/src/promotion-picker.tsx

@@ -0,0 +1,147 @@
+import React, { useCallback } from 'react';
+import { View, Pressable } from 'react-native';
+
+import type { ChessColor, PromotionPiece, PieceSetMap } from './types';
+import { squareToXY } from './use-board-pieces';
+import { PROMOTION_PIECE_PADDING } from './constants';
+
+// ---------------------------------------------------------------------------
+// Props
+// ---------------------------------------------------------------------------
+
+type PromotionPickerProps = {
+  /** Square the pawn is promoting on */
+  square: string;
+  /** Color of the promoting pawn */
+  pieceColor: 'w' | 'b';
+  /** Board size in pixels */
+  boardSize: number;
+  squareSize: number;
+  orientation: ChessColor;
+  /** Piece renderer (from renderPiece prop or pieceSet) */
+  renderPiece: (code: string, size: number) => React.ReactElement;
+  /** Called when user picks a promotion piece */
+  onSelect: (piece: PromotionPiece) => void;
+  /** Called when user cancels (taps outside) */
+  onCancel: () => void;
+};
+
+// ---------------------------------------------------------------------------
+// Promotion pieces in order
+// ---------------------------------------------------------------------------
+
+const PROMOTION_PIECES: PromotionPiece[] = ['q', 'r', 'b', 'n'];
+
+function promotionPieceCode(color: 'w' | 'b', piece: PromotionPiece): string {
+  return `${color}${piece}`;
+}
+
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+
+/**
+ * Promotion piece picker overlay.
+ *
+ * Appears as a vertical column of 4 pieces (Q, R, B, N) anchored to the
+ * promotion square. Expands downward when promoting on the top edge,
+ * upward when promoting on the bottom edge.
+ *
+ * A semi-transparent backdrop covers the board. Tapping outside cancels.
+ */
+export const PromotionPicker = React.memo(function PromotionPicker({
+  square,
+  pieceColor,
+  boardSize,
+  squareSize,
+  orientation,
+  renderPiece,
+  onSelect,
+  onCancel,
+}: PromotionPickerProps) {
+  const { x, y } = squareToXY(square, squareSize, orientation);
+  const pieceSize = squareSize * (1 - PROMOTION_PIECE_PADDING * 2);
+  const padding = squareSize * PROMOTION_PIECE_PADDING;
+
+  // Determine if the picker should expand downward or upward
+  // If the promotion square is in the top half, expand downward
+  const expandDown = y < boardSize / 2;
+
+  const handleSelect = useCallback(
+    (piece: PromotionPiece) => {
+      onSelect(piece);
+    },
+    [onSelect],
+  );
+
+  return (
+    <View
+      style={{
+        position: 'absolute',
+        width: boardSize,
+        height: boardSize,
+        zIndex: 200,
+      }}
+    >
+      {/* Backdrop -- dims the board and captures cancel taps */}
+      <Pressable
+        style={{
+          position: 'absolute',
+          width: boardSize,
+          height: boardSize,
+          backgroundColor: 'rgba(0, 0, 0, 0.4)',
+        }}
+        onPress={onCancel}
+      />
+
+      {/* Piece column */}
+      <View
+        style={{
+          position: 'absolute',
+          left: x,
+          top: expandDown ? y : y - squareSize * 3,
+          width: squareSize,
+          backgroundColor: '#ffffff',
+          borderRadius: 4,
+          // Subtle shadow for elevation
+          shadowColor: '#000',
+          shadowOffset: { width: 0, height: 2 },
+          shadowOpacity: 0.25,
+          shadowRadius: 4,
+          elevation: 8,
+          overflow: 'hidden',
+        }}
+      >
+        {PROMOTION_PIECES.map((piece) => {
+          const code = promotionPieceCode(pieceColor, piece);
+          return (
+            <Pressable
+              key={piece}
+              onPress={() => handleSelect(piece)}
+              style={({ pressed }) => ({
+                width: squareSize,
+                height: squareSize,
+                alignItems: 'center',
+                justifyContent: 'center',
+                backgroundColor: pressed ? 'rgba(0, 0, 0, 0.1)' : 'transparent',
+              })}
+              accessibilityLabel={`Promote to ${PIECE_NAMES[piece]}`}
+              accessibilityRole="button"
+            >
+              <View style={{ width: pieceSize, height: pieceSize }}>
+                {renderPiece(code, pieceSize)}
+              </View>
+            </Pressable>
+          );
+        })}
+      </View>
+    </View>
+  );
+});
+
+const PIECE_NAMES: Record<PromotionPiece, string> = {
+  q: 'Queen',
+  r: 'Rook',
+  b: 'Bishop',
+  n: 'Knight',
+};

package/src/static-board.tsx

@@ -0,0 +1,150 @@
+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 } 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,
+  withCoordinates = false,
+  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 boardSize = boardSizeProp ?? measuredSize;
+  const squareSize = boardSize / 8;
+  const boardColors = colors ?? DEFAULT_BOARD_COLORS;
+
+  // --- 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 (boardSize === 0) {
+    return (
+      <View style={{ flex: 1, aspectRatio: 1 }} onLayout={handleLayout} />
+    );
+  }
+
+  return (
+    <View
+      style={{ width: boardSize, height: boardSize }}
+      onLayout={boardSizeProp ? undefined : handleLayout}
+      accessibilityLabel="Chess board"
+      accessibilityRole="image"
+    >
+      {/* Layer 1: Board background */}
+      <BoardBackground
+        boardSize={boardSize}
+        lightColor={boardColors.light}
+        darkColor={boardColors.dark}
+      />
+
+      {/* Layer 2: Coordinates */}
+      {withCoordinates && (
+        <BoardCoordinates
+          boardSize={boardSize}
+          orientation={orientation}
+          lightColor={boardColors.light}
+          darkColor={boardColors.dark}
+          withLetters
+          withNumbers
+        />
+      )}
+
+      {/* 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>
+  );
+});

package/src/themes.ts

@@ -0,0 +1,129 @@
+import type { BoardTheme, BoardColors } from './types';
+
+// ---------------------------------------------------------------------------
+// Board color presets (matching popular chess platforms)
+// ---------------------------------------------------------------------------
+
+const greenTheme: BoardTheme = {
+  name: 'Green',
+  board: { light: '#eeeed2', dark: '#769656' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#769656', dark: '#eeeed2' },
+};
+
+const brownTheme: BoardTheme = {
+  name: 'Brown',
+  board: { light: '#f0d9b5', dark: '#b58863' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#b58863', dark: '#f0d9b5' },
+};
+
+const blueTheme: BoardTheme = {
+  name: 'Blue',
+  board: { light: '#dee3e6', dark: '#8ca2ad' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#8ca2ad', dark: '#dee3e6' },
+};
+
+const purpleTheme: BoardTheme = {
+  name: 'Purple',
+  board: { light: '#e8daf0', dark: '#9b72b0' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#9b72b0', dark: '#e8daf0' },
+};
+
+const grayTheme: BoardTheme = {
+  name: 'Gray',
+  board: { light: '#e0e0e0', dark: '#888888' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#888888', dark: '#e0e0e0' },
+};
+
+const woodTheme: BoardTheme = {
+  name: 'Wood',
+  board: { light: '#e6c88c', dark: '#a67c52' },
+  lastMove: 'rgba(255, 255, 0, 0.35)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.2)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#a67c52', dark: '#e6c88c' },
+};
+
+const iceTheme: BoardTheme = {
+  name: 'Ice',
+  board: { light: '#e8f0f8', dark: '#7ba0c4' },
+  lastMove: 'rgba(255, 255, 0, 0.35)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#7ba0c4', dark: '#e8f0f8' },
+};
+
+const tournamentTheme: BoardTheme = {
+  name: 'Tournament',
+  board: { light: '#fffff0', dark: '#3d945e' },
+  lastMove: 'rgba(255, 255, 0, 0.4)',
+  check: 'rgba(235, 97, 80, 0.8)',
+  selected: 'rgba(20, 85, 200, 0.5)',
+  legalDot: 'rgba(0, 0, 0, 0.25)',
+  premove: 'rgba(20, 85, 200, 0.3)',
+  arrow: 'rgba(243, 166, 50, 0.85)',
+  coordinates: { light: '#3d945e', dark: '#fffff0' },
+};
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+/** All built-in board themes */
+export const BOARD_THEMES = {
+  green: greenTheme,
+  brown: brownTheme,
+  blue: blueTheme,
+  purple: purpleTheme,
+  gray: grayTheme,
+  wood: woodTheme,
+  ice: iceTheme,
+  tournament: tournamentTheme,
+} as const;
+
+/** Shorthand board color presets (just light/dark, no overlay colors) */
+export const BOARD_COLORS: Record<keyof typeof BOARD_THEMES, BoardColors> = {
+  green: greenTheme.board,
+  brown: brownTheme.board,
+  blue: blueTheme.board,
+  purple: purpleTheme.board,
+  gray: grayTheme.board,
+  wood: woodTheme.board,
+  ice: iceTheme.board,
+  tournament: tournamentTheme.board,
+};