react-native-chess-kit 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","useCallback","Chess","useBoardState","initialFen","chessRef","current","getLegalMoves","square","moves","verbose","map","m","to","isCapture","captured","undefined","isPlayerPiece","pieces","player","piece","find","p","pieceColor","color","applyMove","from","promotion","move","applied","fen","undoMove","result","undo","loadFen","load","getFen","getTurn","turn"],"sourceRoot":"..\\..\\src","sources":["use-board-state.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,15 @@
+import React from 'react';
+type BoardBackgroundProps = {
+    boardSize: number;
+    lightColor: string;
+    darkColor: string;
+};
+/**
+ * 64 static colored squares forming the chess board grid.
+ *
+ * These are plain Views with backgroundColor — no animations, no gesture
+ * handlers. They never re-render after mount unless the board theme changes.
+ */
+export declare const BoardBackground: React.NamedExoticComponent<BoardBackgroundProps>;
+export {};
+//# sourceMappingURL=board-background.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-background.d.ts","sourceRoot":"","sources":["../../src/board-background.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kDA2B1B,CAAC"}

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { ChessColor } from './types';
+type BoardCoordinatesProps = {
+    boardSize: number;
+    orientation: ChessColor;
+    lightColor: string;
+    darkColor: string;
+    withLetters: boolean;
+    withNumbers: boolean;
+};
+/**
+ * File letters (a-h) and rank numbers (1-8) drawn on the board edges.
+ *
+ * Rendered as absolute-positioned Text components inside each corner square.
+ * File letters appear on the bottom rank, rank numbers on the left file.
+ * Colors alternate to contrast with the square behind them.
+ */
+export declare const BoardCoordinates: React.NamedExoticComponent<BoardCoordinatesProps>;
+export {};
+//# sourceMappingURL=board-coordinates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-coordinates.d.ts","sourceRoot":"","sources":["../../src/board-coordinates.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,mDAuE3B,CAAC"}

package/lib/typescript/board-drag-ghost.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { type SharedValue } from 'react-native-reanimated';
+type BoardDragGhostProps = {
+    squareSize: number;
+    isDragging: SharedValue<boolean>;
+    dragX: SharedValue<number>;
+    dragY: SharedValue<number>;
+    dragPieceCode: SharedValue<string | null>;
+    /** Render the piece image for a given piece code */
+    renderPiece: (code: string, size: number) => React.ReactElement;
+};
+/**
+ * Floating piece that follows the user's finger during drag.
+ *
+ * Only ONE instance exists — not one per piece. It reads drag position
+ * from shared values on the UI thread, so zero JS bridge calls and
+ * zero re-renders while dragging.
+ */
+export declare const BoardDragGhost: React.NamedExoticComponent<BoardDragGhostProps>;
+export {};
+//# sourceMappingURL=board-drag-ghost.d.ts.map

package/lib/typescript/board-drag-ghost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-drag-ghost.d.ts","sourceRoot":"","sources":["../../src/board-drag-ghost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAiB,EAEf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,aAAa,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,oDAAoD;IACpD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,iDA4CzB,CAAC"}

package/lib/typescript/board-legal-dots.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { ChessColor, LegalMoveTarget } from './types';
+type BoardLegalDotsProps = {
+    legalMoves: LegalMoveTarget[];
+    squareSize: number;
+    orientation: ChessColor;
+};
+/**
+ * Legal move indicator dots, rendered only when a piece is selected.
+ *
+ * Dots are CONDITIONALLY rendered (only for actual legal move squares,
+ * typically 5-15) instead of always mounting 64 invisible dot views.
+ */
+export declare const BoardLegalDots: React.NamedExoticComponent<BoardLegalDotsProps>;
+export {};
+//# sourceMappingURL=board-legal-dots.d.ts.map

package/lib/typescript/board-legal-dots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-legal-dots.d.ts","sourceRoot":"","sources":["../../src/board-legal-dots.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG3D,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,iDAsDzB,CAAC"}

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

@@ -0,0 +1,36 @@
+import React from 'react';
+import { type SharedValue } from 'react-native-reanimated';
+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;
+    /** The piece visual (rendered by parent via renderPiece) */
+    children: React.ReactElement;
+    /** Gesture state: is this piece currently being dragged? */
+    activeSquare: SharedValue<string | null>;
+    isDragging: SharedValue<boolean>;
+    /** This piece's current square */
+    square: string;
+};
+/**
+ * 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.
+ *
+ * During drag:
+ * - Original piece hides (opacity: 0) — the drag ghost shows instead
+ * - No position changes on the original piece during drag
+ *
+ * After a move:
+ * - Snaps to new position via withTiming on translateX/translateY
+ * - Duration controlled by user's animation speed setting
+ */
+export declare const BoardPieceView: React.NamedExoticComponent<BoardPieceProps>;
+export {};
+//# sourceMappingURL=board-piece.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { SharedValue } from 'react-native-reanimated';
+import type { ChessColor, BoardPiece } from './types';
+type BoardPiecesProps = {
+    pieces: BoardPiece[];
+    squareSize: number;
+    orientation: ChessColor;
+    moveDuration: number;
+    renderPiece: (code: string, size: number) => React.ReactElement;
+    activeSquare: SharedValue<string | null>;
+    isDragging: SharedValue<boolean>;
+};
+/**
+ * Renders all pieces on the board.
+ *
+ * Each piece gets a stable key (from useBoardPieces) so React doesn't
+ * unmount/remount pieces that moved — it updates their position props
+ * and the BoardPieceView animates the transition.
+ */
+export declare const BoardPiecesLayer: React.NamedExoticComponent<BoardPiecesProps>;
+export {};
+//# sourceMappingURL=board-pieces.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/board.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { BoardRef, BoardProps } from './types';
+/**
+ * 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.
+ */
+export declare const Board: React.ForwardRefExoticComponent<BoardProps & React.RefAttributes<BoardRef>>;
+//# sourceMappingURL=board.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,4 @@
+export { Board } from './board';
+export type { ChessColor, MoveMethod, BoardRef, BoardProps, BoardColors, BoardPiece, ParsedPiece, GestureState, LegalMoveTarget, } from './types';
+export { squareToXY, xyToSquare } from './use-board-pieces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,YAAY,EAEV,UAAU,EACV,UAAU,EAGV,QAAQ,EACR,UAAU,EACV,WAAW,EAGX,UAAU,EACV,WAAW,EAGX,YAAY,EAGZ,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,88 @@
+import type { SharedValue } from 'react-native-reanimated';
+/** Board orientation / side color */
+export type ChessColor = 'white' | 'black';
+/** How the user interacts with pieces */
+export type MoveMethod = 'drag' | 'click' | 'both';
+/** A single piece on the board with its position and identity */
+export type BoardPiece = {
+    /** Unique stable identifier (survives position changes): e.g. "wp-0", "bk-0" */
+    id: string;
+    /** Piece code matching standard notation: 'wp', 'wn', 'wb', 'wr', 'wq', 'wk', 'bp', etc. */
+    code: string;
+    /** Current square in algebraic notation: 'a1'..'h8' */
+    square: string;
+    /** 'w' or 'b' */
+    color: 'w' | 'b';
+};
+/** Intermediate representation from FEN parsing (before ID assignment) */
+export type ParsedPiece = {
+    code: string;
+    square: string;
+    color: 'w' | 'b';
+};
+export type BoardRef = {
+    /** Pre-apply a move to internal state. Visual animation happens when parent updates the FEN prop. */
+    move: (move: {
+        from: string;
+        to: string;
+    }) => void;
+    /** Highlight a square with a color */
+    highlight: (square: string, color: string) => void;
+    /** Clear all imperative highlights */
+    clearHighlights: () => void;
+    /** Reset board to a new FEN position */
+    resetBoard: (fen: string) => void;
+    /** Undo the last visually applied move (snap back to previous position) */
+    undo: () => void;
+};
+export type BoardColors = {
+    light: string;
+    dark: string;
+};
+export type BoardProps = {
+    /** Current board position in FEN notation */
+    fen: string;
+    /** Which color is at the bottom of the board */
+    orientation: ChessColor;
+    /** Board width/height in pixels */
+    boardSize: number;
+    /** Whether gesture interaction is enabled */
+    gestureEnabled: boolean;
+    /** Which side can interact: 'white', 'black', or 'both' */
+    player: ChessColor | 'both';
+    /** Called after a visual move is applied */
+    onMove?: (info: {
+        from: string;
+        to: string;
+    }) => void;
+    /** Board square colors */
+    colors: BoardColors;
+    /** Move animation duration in ms (0 = instant) */
+    moveDuration: number;
+    /** Whether to show file labels (a-h) */
+    withLetters: boolean;
+    /** Whether to show rank numbers (1-8) */
+    withNumbers: boolean;
+    /** Custom piece renderer. Receives piece code ('wp', 'bk', etc.) and pixel size. */
+    renderPiece?: (pieceCode: string, size: number) => React.ReactElement;
+    /** Whether to show legal move dots when a piece is selected */
+    showLegalMoves: boolean;
+    /** How the user moves pieces */
+    moveMethod: MoveMethod;
+};
+export type GestureState = {
+    /** Square the active piece started from (null if no drag/selection) */
+    activeSquare: SharedValue<string | null>;
+    /** Current drag position in board-local pixels */
+    dragX: SharedValue<number>;
+    dragY: SharedValue<number>;
+    /** Whether a drag gesture is currently active */
+    isDragging: SharedValue<boolean>;
+    /** The piece code being dragged (for rendering the ghost) */
+    dragPieceCode: SharedValue<string | null>;
+};
+export type LegalMoveTarget = {
+    square: string;
+    isCapture: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAMnD,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG;IACvB,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;CAClB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;CAClB,CAAC;AAMF,MAAM,MAAM,QAAQ,GAAG;IACrB,qGAAqG;IACrG,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,sCAAsC;IACtC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,sCAAsC;IACtC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,wCAAwC;IACxC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,WAAW,EAAE,UAAU,CAAC;IACxB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,cAAc,EAAE,OAAO,CAAC;IACxB,2DAA2D;IAC3D,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IACtE,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,gCAAgC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAMF,MAAM,MAAM,YAAY,GAAG;IACzB,uEAAuE;IACvE,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,kDAAkD;IAClD,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,iDAAiD;IACjD,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,aAAa,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/lib/typescript/use-board-gesture.d.ts

@@ -0,0 +1,46 @@
+import { Gesture } from 'react-native-gesture-handler';
+import type { ChessColor, MoveMethod, BoardPiece, LegalMoveTarget, GestureState } from './types';
+type GestureCallbacks = {
+    onPieceSelected: (square: string) => void;
+    onPieceMoved: (from: string, to: string) => void;
+    onSelectionCleared: () => void;
+};
+type UseBoardGestureParams = {
+    squareSize: number;
+    orientation: ChessColor;
+    gestureEnabled: boolean;
+    player: ChessColor | 'both';
+    moveMethod: MoveMethod;
+    pieces: BoardPiece[];
+    callbacks: GestureCallbacks;
+    /** Currently selected square (for tap-to-move second tap) */
+    selectedSquare: string | null;
+    /** Legal move targets from the currently selected piece */
+    legalMoves: LegalMoveTarget[];
+};
+type UseBoardGestureReturn = {
+    gesture: ReturnType<typeof Gesture.Pan>;
+    gestureState: GestureState;
+};
+/**
+ * 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 declare function useBoardGesture({ squareSize, orientation, gestureEnabled, player, moveMethod, pieces, callbacks, selectedSquare, legalMoves, }: UseBoardGestureParams): UseBoardGestureReturn;
+export {};
+//# sourceMappingURL=use-board-gesture.d.ts.map

package/lib/typescript/use-board-gesture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-board-gesture.d.ts","sourceRoot":"","sources":["../../src/use-board-gesture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAMvD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGjG,KAAK,gBAAgB,GAAG;IACtB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,6DAA6D;IAC7D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,WAAW,EACX,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,EACN,SAAS,EACT,cAAc,EACd,UAAU,GACX,EAAE,qBAAqB,GAAG,qBAAqB,CAwI/C"}

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

@@ -0,0 +1,23 @@
+import type { ChessColor, BoardPiece } from './types';
+/**
+ * Convert square notation to pixel coordinates (top-left corner).
+ * Orientation-aware: flips the board when playing as black.
+ */
+export declare function squareToXY(square: string, squareSize: number, orientation: ChessColor): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert pixel coordinates to a square notation string.
+ * Clamps to board bounds. Orientation-aware.
+ */
+export declare function xyToSquare(x: number, y: number, squareSize: number, orientation: ChessColor): string;
+/**
+ * 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 declare function useBoardPieces(fen: string): BoardPiece[];
+//# sourceMappingURL=use-board-pieces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-board-pieces.d.ts","sourceRoot":"","sources":["../../src/use-board-pieces.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAe,MAAM,SAAS,CAAC;AAmDnE;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAS1B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,GACtB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAwDxD"}

package/lib/typescript/use-board-state.d.ts

@@ -0,0 +1,35 @@
+import type { ChessColor, BoardPiece, LegalMoveTarget } from './types';
+type MoveResult = {
+    /** Whether the move was applied to the internal chess.js instance */
+    applied: boolean;
+    /** The new FEN after the move (if applied) */
+    fen?: string;
+};
+type BoardStateReturn = {
+    /** Get legal moves for a piece on the given square */
+    getLegalMoves: (square: string) => LegalMoveTarget[];
+    /** Check if a given square has a piece belonging to the active player */
+    isPlayerPiece: (square: string, pieces: BoardPiece[], player: ChessColor | 'both') => boolean;
+    /** Apply a move to the internal chess state. Returns the new FEN if valid. */
+    applyMove: (from: string, to: string, promotion?: string) => MoveResult;
+    /** Undo the last move on the internal chess state */
+    undoMove: () => string | null;
+    /** Load a new FEN into the internal chess state */
+    loadFen: (fen: string) => void;
+    /** Get the current FEN from internal state */
+    getFen: () => string;
+    /** Get the current turn from internal state */
+    getTurn: () => 'w' | 'b';
+};
+/**
+ * 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 declare function useBoardState(initialFen: string): BoardStateReturn;
+export {};
+//# sourceMappingURL=use-board-state.d.ts.map

package/lib/typescript/use-board-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-board-state.d.ts","sourceRoot":"","sources":["../../src/use-board-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvE,KAAK,UAAU,GAAG;IAChB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,sDAAsD;IACtD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;IACrD,yEAAyE;IACzE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,KAAK,OAAO,CAAC;IAC9F,8EAA8E;IAC9E,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;IACxE,qDAAqD;IACrD,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAgElE"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "react-native-chess-kit",
+  "version": "0.1.0",
+  "description": "High-performance chess board for React Native. Single gesture handler, ~40 components, 0 re-renders during drag. Built on Reanimated + Gesture Handler.",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf lib"
+  },
+  "keywords": [
+    "react-native",
+    "chess",
+    "chessboard",
+    "chess-board",
+    "reanimated",
+    "gesture-handler",
+    "performance",
+    "60fps"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anas-asghar4831/react-native-chess-kit"
+  },
+  "homepage": "https://github.com/anas-asghar4831/react-native-chess-kit#readme",
+  "bugs": {
+    "url": "https://github.com/anas-asghar4831/react-native-chess-kit/issues"
+  },
+  "author": "anas-asghar4831",
+  "license": "MIT",
+  "peerDependencies": {
+    "chess.js": ">=1.0.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.70.0",
+    "react-native-gesture-handler": ">=2.0.0",
+    "react-native-reanimated": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "~19.1.0",
+    "chess.js": "^1.4.0",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-builder-bob": "^0.35.0",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-reanimated": "~4.1.1",
+    "typescript": "~5.9.2"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/board-background.tsx

@@ -0,0 +1,46 @@
+import React from 'react';
+import { View } from 'react-native';
+
+type BoardBackgroundProps = {
+  boardSize: number;
+  lightColor: string;
+  darkColor: string;
+};
+
+/**
+ * 64 static colored squares forming the chess board grid.
+ *
+ * These are plain Views with backgroundColor — no animations, no gesture
+ * handlers. They never re-render after mount unless the board theme changes.
+ */
+export const BoardBackground = React.memo(function BoardBackground({
+  boardSize,
+  lightColor,
+  darkColor,
+}: BoardBackgroundProps) {
+  const squareSize = boardSize / 8;
+
+  return (
+    <View style={{ width: boardSize, height: boardSize, flexDirection: 'row', flexWrap: 'wrap' }}>
+      {SQUARE_INDICES.map((i) => {
+        const row = Math.floor(i / 8);
+        const col = i % 8;
+        const isLight = (row + col) % 2 === 0;
+
+        return (
+          <View
+            key={i}
+            style={{
+              width: squareSize,
+              height: squareSize,
+              backgroundColor: isLight ? lightColor : darkColor,
+            }}
+          />
+        );
+      })}
+    </View>
+  );
+});
+
+// Pre-computed array of 0-63 to avoid allocation on every render
+const SQUARE_INDICES = Array.from({ length: 64 }, (_, i) => i);

package/src/board-coordinates.tsx

@@ -0,0 +1,98 @@
+import React from 'react';
+import { View, Text } from 'react-native';
+
+import type { ChessColor } from './types';
+
+type BoardCoordinatesProps = {
+  boardSize: number;
+  orientation: ChessColor;
+  lightColor: string;
+  darkColor: string;
+  withLetters: boolean;
+  withNumbers: boolean;
+};
+
+const FILES_WHITE = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'];
+const FILES_BLACK = ['h', 'g', 'f', 'e', 'd', 'c', 'b', 'a'];
+const RANKS_WHITE = ['8', '7', '6', '5', '4', '3', '2', '1'];
+const RANKS_BLACK = ['1', '2', '3', '4', '5', '6', '7', '8'];
+
+/**
+ * File letters (a-h) and rank numbers (1-8) drawn on the board edges.
+ *
+ * Rendered as absolute-positioned Text components inside each corner square.
+ * File letters appear on the bottom rank, rank numbers on the left file.
+ * Colors alternate to contrast with the square behind them.
+ */
+export const BoardCoordinates = React.memo(function BoardCoordinates({
+  boardSize,
+  orientation,
+  lightColor,
+  darkColor,
+  withLetters,
+  withNumbers,
+}: BoardCoordinatesProps) {
+  if (!withLetters && !withNumbers) return null;
+
+  const squareSize = boardSize / 8;
+  const fontSize = squareSize * 0.22;
+  const padding = squareSize * 0.06;
+  const files = orientation === 'white' ? FILES_WHITE : FILES_BLACK;
+  const ranks = orientation === 'white' ? RANKS_WHITE : RANKS_BLACK;
+
+  return (
+    <View
+      style={{ position: 'absolute', width: boardSize, height: boardSize }}
+      pointerEvents="none"
+    >
+      {/* Rank numbers along left edge (inside each row's first square) */}
+      {withNumbers &&
+        ranks.map((rank, row) => {
+          // First column square: row 0 col 0 = light if (0+0)%2===0
+          const isLight = row % 2 === 0;
+          const textColor = isLight ? darkColor : lightColor;
+
+          return (
+            <Text
+              key={`r-${rank}`}
+              style={{
+                position: 'absolute',
+                left: padding,
+                top: row * squareSize + padding,
+                fontSize,
+                fontWeight: '700',
+                color: textColor,
+              }}
+            >
+              {rank}
+            </Text>
+          );
+        })}
+
+      {/* File letters along bottom edge (inside each column's last square) */}
+      {withLetters &&
+        files.map((file, col) => {
+          // Last row (7), column col: light if (7+col)%2===0
+          const isLight = (7 + col) % 2 === 0;
+          const textColor = isLight ? darkColor : lightColor;
+
+          return (
+            <Text
+              key={`f-${file}`}
+              style={{
+                position: 'absolute',
+                right: (7 - col) * squareSize + padding,
+                bottom: padding,
+                fontSize,
+                fontWeight: '700',
+                color: textColor,
+                textAlign: 'right',
+              }}
+            >
+              {file}
+            </Text>
+          );
+        })}
+    </View>
+  );
+});