react-native-chess-kit 0.4.2 → 0.5.1

package/src/pieces/index.ts

@@ -1 +1 @@
-export { DefaultPieceSet } from './default-pieces';
+export { DefaultPieceSet } from './default-pieces';

package/src/promotion-picker.tsx

@@ -1,147 +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',
-};
+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

@@ -1,150 +1,187 @@
-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>
-  );
-});
+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;
+});