react-native-chess-kit 0.1.0 → 0.2.0

package/lib/typescript/constants.d.ts

@@ -0,0 +1,54 @@
+import type { BoardColors } from './types';
+/** Default board colors (chess.com green) */
+export declare const DEFAULT_BOARD_COLORS: BoardColors;
+/** Default last-move highlight color */
+export declare const DEFAULT_LAST_MOVE_COLOR = "rgba(255, 255, 0, 0.4)";
+/** Default check highlight color (red radial feel) */
+export declare const DEFAULT_CHECK_COLOR = "rgba(235, 97, 80, 0.8)";
+/** Default selected piece square color */
+export declare const DEFAULT_SELECTED_COLOR = "rgba(20, 85, 200, 0.5)";
+/** Default premove highlight color */
+export declare const DEFAULT_PREMOVE_COLOR = "rgba(20, 85, 200, 0.3)";
+/** Default drag target highlight color */
+export declare const DEFAULT_DRAG_TARGET_COLOR = "rgba(0, 0, 0, 0.1)";
+/** Default arrow color */
+export declare const DEFAULT_ARROW_COLOR = "rgba(243, 166, 50, 0.85)";
+/** Default shape (circle) color */
+export declare const DEFAULT_SHAPE_COLOR = "rgba(21, 120, 27, 0.7)";
+/** Default annotation background color */
+export declare const DEFAULT_ANNOTATION_BG = "rgba(235, 97, 80, 0.9)";
+/** Default annotation text color */
+export declare const DEFAULT_ANNOTATION_TEXT = "#ffffff";
+/** Default move animation duration in ms */
+export declare const DEFAULT_MOVE_DURATION = 200;
+/** Duration for capture fade-out animation in ms */
+export declare const CAPTURE_FADE_DURATION = 150;
+/** Legal move dot size as fraction of square size */
+export declare const DOT_SCALE = 0.28;
+/** Legal move capture ring size as fraction of square size */
+export declare const RING_SCALE = 0.85;
+/** Legal move capture ring border as fraction of square size */
+export declare const RING_BORDER_RATIO = 0.08;
+/** Arrow stroke width as fraction of square size (percentage-based viewBox) */
+export declare const ARROW_STROKE_WIDTH = 2.5;
+/** Arrow head size */
+export declare const ARROW_HEAD_SIZE = 2.5;
+/** Arrow shorten amount (to avoid overlapping squares) */
+export declare const ARROW_SHORTEN_BY = 4;
+/** Annotation badge size as fraction of square size */
+export declare const ANNOTATION_SCALE = 0.35;
+/** Coordinate font size as fraction of square size */
+export declare const COORDINATE_FONT_SCALE = 0.22;
+/** Drag ghost scale factor (1.1x larger than normal piece) */
+export declare const DRAG_GHOST_SCALE = 1.1;
+/** Promotion picker piece padding as fraction of square size */
+export declare const PROMOTION_PIECE_PADDING = 0.1;
+export declare const PIECE_CODES: readonly ["wp", "wn", "wb", "wr", "wq", "wk", "bp", "bn", "bb", "br", "bq", "bk"];
+/** Board square indices 0-63 (pre-computed) */
+export declare const SQUARE_INDICES: number[];
+/** File letters in order */
+export declare const FILES_WHITE: readonly ["a", "b", "c", "d", "e", "f", "g", "h"];
+export declare const FILES_BLACK: readonly ["h", "g", "f", "e", "d", "c", "b", "a"];
+export declare const RANKS_WHITE: readonly ["8", "7", "6", "5", "4", "3", "2", "1"];
+export declare const RANKS_BLACK: readonly ["1", "2", "3", "4", "5", "6", "7", "8"];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,EAAE,WAGlC,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,oCAAoC;AACpC,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAMjD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAMzC,qDAAqD;AACrD,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,8DAA8D;AAC9D,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,sBAAsB;AACtB,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAM3C,eAAO,MAAM,WAAW,mFAGd,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,cAAc,UAA0C,CAAC;AAEtE,4BAA4B;AAC5B,eAAO,MAAM,WAAW,mDAAoD,CAAC;AAC7E,eAAO,MAAM,WAAW,mDAAoD,CAAC;AAC7E,eAAO,MAAM,WAAW,mDAAoD,CAAC;AAC7E,eAAO,MAAM,WAAW,mDAAoD,CAAC"}

package/lib/typescript/index.d.ts

@@ -1,4 +1,12 @@
 export { Board } from './board';
-export type { ChessColor, MoveMethod, BoardRef, BoardProps, BoardColors, BoardPiece, ParsedPiece, GestureState, LegalMoveTarget, } from './types';
+export { StaticBoard } from './static-board';
+export { SquareHighlight } from './board-highlights';
+export { Arrow } from './board-arrows';
+export { Annotation } from './board-annotations';
+export { PromotionPicker } from './promotion-picker';
+export { DefaultPieceSet } from './pieces';
+export { BOARD_THEMES, BOARD_COLORS } from './themes';
+export { DEFAULT_BOARD_COLORS, DEFAULT_LAST_MOVE_COLOR, DEFAULT_CHECK_COLOR, DEFAULT_SELECTED_COLOR, DEFAULT_PREMOVE_COLOR, DEFAULT_DRAG_TARGET_COLOR, DEFAULT_ARROW_COLOR, DEFAULT_SHAPE_COLOR, DEFAULT_ANNOTATION_BG, DEFAULT_ANNOTATION_TEXT, DEFAULT_MOVE_DURATION, CAPTURE_FADE_DURATION, } from './constants';
+export type { ChessColor, MoveMethod, PromotionPiece, HapticType, PieceCode, BoardRef, BoardProps, BoardColors, StaticBoardProps, BoardPiece, ParsedPiece, PieceSetMap, HighlightData, ArrowData, ShapeData, AnnotationData, PremoveData, AnimationConfig, TimingAnimationConfig, SpringAnimationConfig, BoardTheme, GestureState, LegalMoveTarget, } from './types';
 export { squareToXY, xyToSquare } from './use-board-pieces';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMtD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAMrB,YAAY,EAEV,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EAGT,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAGhB,UAAU,EACV,WAAW,EACX,WAAW,EAGX,aAAa,EACb,SAAS,EACT,SAAS,EACT,cAAc,EACd,WAAW,EAGX,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAGrB,UAAU,EAGV,YAAY,EAGZ,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { PieceSetMap } from '../types';
+export declare const DefaultPieceSet: PieceSetMap;
+//# sourceMappingURL=default-pieces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-pieces.d.ts","sourceRoot":"","sources":["../../../src/pieces/default-pieces.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA+W5C,eAAO,MAAM,eAAe,EAAE,WAa7B,CAAC"}

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

@@ -0,0 +1,2 @@
+export { DefaultPieceSet } from './default-pieces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pieces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/typescript/promotion-picker.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { ChessColor, PromotionPiece } from './types';
+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 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 declare const PromotionPicker: React.NamedExoticComponent<PromotionPickerProps>;
+export {};
+//# sourceMappingURL=promotion-picker.d.ts.map

package/lib/typescript/promotion-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-picker.d.ts","sourceRoot":"","sources":["../../src/promotion-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AAQvE,KAAK,oBAAoB,GAAG;IAC1B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;IACtB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,yDAAyD;IACzD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAChE,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAgBF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,kDAwF1B,CAAC"}

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { StaticBoardProps } from './types';
+/**
+ * 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 declare const StaticBoard: React.NamedExoticComponent<StaticBoardProps>;
+//# sourceMappingURL=static-board.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-board.d.ts","sourceRoot":"","sources":["../../src/static-board.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAG9D,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,SAAS,CAAC;AAUvE;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,8CAgItB,CAAC"}

package/lib/typescript/themes.d.ts

@@ -0,0 +1,15 @@
+import type { BoardTheme, BoardColors } from './types';
+/** All built-in board themes */
+export declare const BOARD_THEMES: {
+    readonly green: BoardTheme;
+    readonly brown: BoardTheme;
+    readonly blue: BoardTheme;
+    readonly purple: BoardTheme;
+    readonly gray: BoardTheme;
+    readonly wood: BoardTheme;
+    readonly ice: BoardTheme;
+    readonly tournament: BoardTheme;
+};
+/** Shorthand board color presets (just light/dark, no overlay colors) */
+export declare const BOARD_COLORS: Record<keyof typeof BOARD_THEMES, BoardColors>;
+//# sourceMappingURL=themes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA0GvD,gCAAgC;AAChC,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,OAAO,YAAY,EAAE,WAAW,CASvE,CAAC"}

package/lib/typescript/types.d.ts

@@ -3,6 +3,12 @@ import type { SharedValue } from 'react-native-reanimated';
 export type ChessColor = 'white' | 'black';
 /** How the user interacts with pieces */
 export type MoveMethod = 'drag' | 'click' | 'both';
+/** Promotion piece choice */
+export type PromotionPiece = 'q' | 'r' | 'b' | 'n';
+/** Haptic feedback event types -- consumer wires to their preferred haptics library */
+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';
 /** 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" */
@@ -20,13 +26,94 @@ export type ParsedPiece = {
     square: string;
     color: 'w' | 'b';
 };
+/** A square highlight (colored rectangle on a specific square) */
+export type HighlightData = {
+    square: string;
+    color: string;
+};
+/** An arrow drawn between two squares */
+export type ArrowData = {
+    from: string;
+    to: string;
+    /** Arrow color. Default: theme-dependent */
+    color?: string;
+    /** Stroke width as percentage of square size. Default: 0.2 */
+    width?: number;
+};
+/** A shape drawn on the board */
+export type ShapeData = {
+    type: 'circle';
+    square: string;
+    color?: string;
+};
+/** A text annotation on a square (!, ?, !!, ??, etc.) */
+export type AnnotationData = {
+    square: string;
+    text: string;
+    color?: string;
+    backgroundColor?: string;
+};
+/** A premove queued for execution */
+export type PremoveData = {
+    from: string;
+    to: string;
+    promotion?: PromotionPiece;
+};
+export type TimingAnimationConfig = {
+    type: 'timing';
+    /** Duration in ms. Default: 200 */
+    duration?: number;
+};
+export type SpringAnimationConfig = {
+    type: 'spring';
+    /** Damping ratio. Default: 0.7 */
+    damping?: number;
+    /** Stiffness. Default: 200 */
+    stiffness?: number;
+    /** Mass. Default: 1 */
+    mass?: number;
+};
+/** Animation configuration for piece movement */
+export type AnimationConfig = TimingAnimationConfig | SpringAnimationConfig;
+/** Map of piece code to React element renderer */
+export type PieceSetMap = {
+    [code in PieceCode]: (size: number) => React.ReactElement;
+};
+export type BoardColors = {
+    light: string;
+    dark: string;
+};
+/** A complete board theme with all configurable colors */
+export type BoardTheme = {
+    /** Display name for the theme */
+    name: string;
+    /** Square colors */
+    board: BoardColors;
+    /** Last move highlight color */
+    lastMove: string;
+    /** Check highlight color */
+    check: string;
+    /** Selected piece square color */
+    selected: string;
+    /** Legal move dot color */
+    legalDot: string;
+    /** Premove highlight color */
+    premove: string;
+    /** Arrow default color */
+    arrow: string;
+    /** Coordinate text colors */
+    coordinates: {
+        light: string;
+        dark: string;
+    };
+};
 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 a square with a color. Adds to existing imperative highlights. */
     highlight: (square: string, color: string) => void;
     /** Clear all imperative highlights */
     clearHighlights: () => void;
@@ -34,41 +121,122 @@ export type BoardRef = {
     resetBoard: (fen: string) => void;
     /** Undo the last visually applied move (snap back to previous position) */
     undo: () => void;
-};
-export type BoardColors = {
-    light: string;
-    dark: string;
+    /** Clear any queued premoves */
+    clearPremoves: () => void;
 };
 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';
+    /** Board width/height in pixels. If omitted, auto-sizes from parent via onLayout. */
+    boardSize?: number;
+    /** Whether gesture interaction is enabled. Default: true */
+    gestureEnabled?: boolean;
+    /** Which side can interact: 'white', 'black', or 'both'. Default: 'both' */
+    player?: ChessColor | 'both';
+    /** How the user moves pieces. Default: 'both' */
+    moveMethod?: MoveMethod;
+    /** Whether to show legal move dots when a piece is selected. Default: true */
+    showLegalMoves?: boolean;
+    /** Enable premove queuing. Default: false */
+    premovesEnabled?: boolean;
+    /** Board square colors. Default: green theme */
+    colors?: BoardColors;
+    /** Whether to show file labels (a-h). Default: true */
+    withLetters?: boolean;
+    /** Whether to show rank numbers (1-8). Default: true */
+    withNumbers?: boolean;
+    /** Custom piece renderer. Receives piece code ('wp', 'bk', etc.) and pixel size. */
+    renderPiece?: (pieceCode: string, size: number) => React.ReactElement;
+    /** Built-in piece set (alternative to renderPiece). Default: built-in SVG set */
+    pieceSet?: PieceSetMap;
+    /** Last move to highlight (yellow on from/to squares) */
+    lastMove?: {
+        from: string;
+        to: string;
+    } | null;
+    /** Custom highlights. Merged with auto-highlights (last move, check). */
+    highlights?: HighlightData[];
+    /** Arrows to draw on the board */
+    arrows?: ArrowData[];
+    /** Shapes to draw on the board (circles) */
+    shapes?: ShapeData[];
+    /** Text annotations on squares (!, ?, etc.) */
+    annotations?: AnnotationData[];
+    /** Show drag target indicator under finger during drag. Default: true */
+    showDragTarget?: boolean;
+    /** Last move highlight color. Default: 'rgba(255,255,0,0.4)' */
+    lastMoveColor?: string;
+    /** Check highlight color. Default: radial gradient red */
+    checkHighlightColor?: string;
+    /** Selected piece square color. Default: 'rgba(20,85,200,0.5)' */
+    selectedSquareColor?: string;
+    /** Premove highlight color. Default: 'rgba(20,85,200,0.3)' */
+    premoveColor?: string;
+    /** Drag target highlight color. Default: 'rgba(0,0,0,0.1)' */
+    dragTargetColor?: string;
+    /** Move animation duration in ms (0 = instant). Default: 200 */
+    moveDuration?: number;
+    /** Animation configuration (timing or spring). Overrides moveDuration if provided. */
+    animationConfig?: AnimationConfig;
+    /** Animate board rotation on orientation change. Default: true */
+    animateFlip?: boolean;
+    /**
+     * Called when a pawn promotion occurs. If not provided, auto-promotes to queen.
+     * Return the chosen piece to complete the promotion.
+     */
+    onPromotion?: (from: string, to: string) => Promise<PromotionPiece> | PromotionPiece;
     /** 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. */
+    /** Called when a piece is tapped */
+    onPieceClick?: (square: string, piece: PieceCode) => void;
+    /** Called when an empty square or opponent piece is tapped */
+    onSquareClick?: (square: string) => void;
+    /** Called when a piece drag begins */
+    onPieceDragBegin?: (square: string, piece: PieceCode) => void;
+    /** Called when a piece drag ends (regardless of move validity) */
+    onPieceDragEnd?: (square: string, piece: PieceCode) => void;
+    /** Called on long-press of a square */
+    onSquareLongPress?: (square: string) => void;
+    /** Called when a premove is set */
+    onPremove?: (premove: PremoveData) => void;
+    /**
+     * Haptic feedback callback. Consumer wires to their preferred haptics library.
+     * Called with event type: 'select' (piece pickup), 'move' (piece drop),
+     * 'capture' (piece takes), 'error' (invalid move).
+     */
+    onHaptic?: (type: HapticType) => void;
+};
+export type StaticBoardProps = {
+    /** Board position in FEN notation */
+    fen: string;
+    /** Which color is at the bottom. Default: 'white' */
+    orientation?: ChessColor;
+    /** Board width/height in pixels. If omitted, auto-sizes from parent. */
+    boardSize?: number;
+    /** Board square colors. Default: green theme */
+    colors?: BoardColors;
+    /** Whether to show coordinate labels. Default: false */
+    withCoordinates?: boolean;
+    /** Custom piece renderer */
     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;
+    /** Built-in piece set */
+    pieceSet?: PieceSetMap;
+    /** Last move highlight */
+    lastMove?: {
+        from: string;
+        to: string;
+    } | null;
+    /** Custom highlights */
+    highlights?: HighlightData[];
+    /** Arrows */
+    arrows?: ArrowData[];
+    /** Annotations */
+    annotations?: AnnotationData[];
 };
 export type GestureState = {
     /** Square the active piece started from (null if no drag/selection) */
@@ -80,6 +248,8 @@ export type GestureState = {
     isDragging: SharedValue<boolean>;
     /** The piece code being dragged (for rendering the ghost) */
     dragPieceCode: SharedValue<string | null>;
+    /** Square currently under the dragged piece (for drag target highlight) */
+    dragTargetSquare: SharedValue<string | null>;
 };
 export type LegalMoveTarget = {
     square: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,23 @@
 import { Gesture } from 'react-native-gesture-handler';
-import type { ChessColor, MoveMethod, BoardPiece, LegalMoveTarget, GestureState } from './types';
+import type { ChessColor, MoveMethod, BoardPiece, LegalMoveTarget, GestureState, PieceCode, HapticType, PremoveData } from './types';
 type GestureCallbacks = {
     onPieceSelected: (square: string) => void;
     onPieceMoved: (from: string, to: string) => void;
     onSelectionCleared: () => void;
 };
+/** Rich callbacks exposed to consumers (all optional) */
+type RichCallbacks = {
+    onPieceClick?: (square: string, piece: PieceCode) => void;
+    onSquareClick?: (square: string) => void;
+    onPieceDragBegin?: (square: string, piece: PieceCode) => void;
+    onPieceDragEnd?: (square: string, piece: PieceCode) => void;
+    onSquareLongPress?: (square: string) => void;
+    onHaptic?: (type: HapticType) => void;
+};
+/** Premove-related callbacks from board.tsx */
+type PremoveCallbacks = {
+    onPremoveSet?: (premove: PremoveData) => void;
+};
 type UseBoardGestureParams = {
     squareSize: number;
     orientation: ChessColor;
@@ -13,10 +26,16 @@ type UseBoardGestureParams = {
     moveMethod: MoveMethod;
     pieces: BoardPiece[];
     callbacks: GestureCallbacks;
+    richCallbacks?: RichCallbacks;
+    premoveCallbacks?: PremoveCallbacks;
+    /** Whether premoves are enabled */
+    premovesEnabled?: boolean;
     /** Currently selected square (for tap-to-move second tap) */
     selectedSquare: string | null;
     /** Legal move targets from the currently selected piece */
     legalMoves: LegalMoveTarget[];
+    /** Whose turn it is ('w' or 'b') — used for premove detection */
+    currentTurn?: 'w' | 'b';
 };
 type UseBoardGestureReturn = {
     gesture: ReturnType<typeof Gesture.Pan>;
@@ -40,7 +59,14 @@ type UseBoardGestureReturn = {
  * 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 declare function useBoardGesture({ squareSize, orientation, gestureEnabled, player, moveMethod, pieces, callbacks, selectedSquare, legalMoves, }: UseBoardGestureParams): UseBoardGestureReturn;
+export declare function useBoardGesture({ squareSize, orientation, gestureEnabled, player, moveMethod, pieces, callbacks, richCallbacks, premoveCallbacks, premovesEnabled, selectedSquare, legalMoves, currentTurn, }: UseBoardGestureParams): UseBoardGestureReturn;
 export {};
 //# sourceMappingURL=use-board-gesture.d.ts.map

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

@@ -1 +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"}
+{"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,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,SAAS,EACT,UAAU,EACV,WAAW,EACZ,MAAM,SAAS,CAAC;AAOjB,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,yDAAyD;AACzD,KAAK,aAAa,GAAG;IACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5D,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,+CAA+C;AAC/C,KAAK,gBAAgB,GAAG;IACtB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C,CAAC;AAMF,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,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,iEAAiE;IACjE,WAAW,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CACzB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAoBF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,WAAW,EACX,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,EACN,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,eAAuB,EACvB,cAAc,EACd,UAAU,EACV,WAAW,GACZ,EAAE,qBAAqB,GAAG,qBAAqB,CAwR/C"}

package/lib/typescript/use-premove.d.ts

@@ -0,0 +1,31 @@
+import type { PremoveData } from './types';
+type UsePremoveReturn = {
+    /** The currently queued premove (only one at a time, like lichess) */
+    premove: PremoveData | null;
+    /** Queue a premove. Replaces any existing premove. */
+    setPremove: (premove: PremoveData) => void;
+    /** Clear the queued premove */
+    clearPremove: () => void;
+    /**
+     * Try to execute the queued premove.
+     * Returns the premove if one was queued (so the caller can apply it),
+     * then clears the queue. Returns null if no premove was queued.
+     */
+    consumePremove: () => PremoveData | null;
+};
+/**
+ * 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 declare function usePremove(): UsePremoveReturn;
+export {};
+//# sourceMappingURL=use-premove.d.ts.map

package/lib/typescript/use-premove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-premove.d.ts","sourceRoot":"","sources":["../../src/use-premove.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,gBAAgB,GAAG;IACtB,sEAAsE;IACtE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,sDAAsD;IACtD,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C,+BAA+B;IAC/B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB;;;;OAIG;IACH,cAAc,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA0B7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-chess-kit",
-  "version": "0.1.0",
+  "version": "0.2.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",
@@ -44,7 +44,8 @@
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-gesture-handler": ">=2.0.0",
-    "react-native-reanimated": ">=3.0.0"
+    "react-native-reanimated": ">=3.0.0",
+    "react-native-svg": ">=13.0.0"
   },
   "devDependencies": {
     "@types/react": "~19.1.0",
@@ -54,6 +55,7 @@
     "react-native-builder-bob": "^0.35.0",
     "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~4.1.1",
+    "react-native-svg": "~15.11.2",
     "typescript": "~5.9.2"
   },
   "react-native-builder-bob": {