react-native-chess-kit 0.4.1 → 0.5.0

package/lib/typescript/index.d.ts

@@ -7,6 +7,6 @@ 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 type { ChessColor, MoveMethod, PromotionPiece, HapticType, PieceCode, BoardRef, BoardProps, BoardColors, StaticBoardProps, CoordinatePosition, 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;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"}
+{"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,EAChB,kBAAkB,EAGlB,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/static-board.d.ts.map

@@ -1 +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"}
+{"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,8CAqKtB,CAAC"}

package/lib/typescript/types.d.ts

@@ -3,6 +3,8 @@ import type { SharedValue, BaseAnimationBuilder } from 'react-native-reanimated'
 export type ChessColor = 'white' | 'black';
 /** How the user interacts with pieces */
 export type MoveMethod = 'drag' | 'click' | 'both';
+/** Where to render file/rank coordinate labels */
+export type CoordinatePosition = 'inside' | 'outside' | 'none';
 /** Promotion piece choice */
 export type PromotionPiece = 'q' | 'r' | 'b' | 'n';
 /** Haptic feedback event types -- consumer wires to their preferred haptics library */
@@ -147,9 +149,18 @@ export type BoardProps = {
     premovesEnabled?: boolean;
     /** Board square colors. Default: green theme */
     colors?: BoardColors;
-    /** Whether to show file labels (a-h). Default: true */
+    /**
+     * Where to render file/rank coordinate labels.
+     * - 'inside'  — overlaid on the edge squares (default)
+     * - 'outside' — in a gutter around the board (board shrinks slightly)
+     * - 'none'    — hidden
+     *
+     * @default 'inside'
+     */
+    coordinatePosition?: CoordinatePosition;
+    /** @deprecated Use coordinatePosition instead. Kept for backwards compat. */
     withLetters?: boolean;
-    /** Whether to show rank numbers (1-8). Default: true */
+    /** @deprecated Use coordinatePosition instead. Kept for backwards compat. */
     withNumbers?: boolean;
     /** Custom piece renderer. Receives piece code ('wp', 'bk', etc.) and pixel size. */
     renderPiece?: (pieceCode: string, size: number) => React.ReactElement;
@@ -188,12 +199,13 @@ export type BoardProps = {
     animateFlip?: boolean;
     /**
      * Custom exiting animation for pieces (played on unmount, e.g. captures).
-     * Pass `undefined` to disable all piece exit animations (useful when
-     * remounting the entire board via a React key change — prevents all
-     * pieces from fading out simultaneously).
-     * Default: FadeOut.duration(150)
+     * - `undefined` (or omitted): uses default FadeOut.duration(150)
+     * - `null`: disables all piece exit animations (pieces vanish instantly).
+     *   Useful when remounting the entire board via a React key change to
+     *   prevent all pieces from fading out simultaneously.
+     * - Any `BaseAnimationBuilder`: uses the provided animation.
      */
-    pieceExitAnimation?: BaseAnimationBuilder | typeof BaseAnimationBuilder;
+    pieceExitAnimation?: BaseAnimationBuilder | typeof BaseAnimationBuilder | null;
     /**
      * Called when a pawn promotion occurs. If not provided, auto-promotes to queen.
      * Return the chosen piece to complete the promotion.
@@ -232,7 +244,16 @@ export type StaticBoardProps = {
     boardSize?: number;
     /** Board square colors. Default: green theme */
     colors?: BoardColors;
-    /** Whether to show coordinate labels. Default: false */
+    /**
+     * Where to render file/rank coordinate labels.
+     * - 'inside'  — overlaid on the edge squares
+     * - 'outside' — in a gutter around the board (board shrinks slightly)
+     * - 'none'    — hidden (default)
+     *
+     * @default 'none'
+     */
+    coordinatePosition?: CoordinatePosition;
+    /** @deprecated Use coordinatePosition instead */
     withCoordinates?: boolean;
     /** Custom piece renderer */
     renderPiece?: (pieceCode: string, size: number) => React.ReactElement;

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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAMjF,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEnD,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,6BAA6B;AAC7B,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnD,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAMjE,uDAAuD;AACvD,MAAM,MAAM,SAAS,GACjB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,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,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B,CAAC;AAMF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAM5E,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG;KACvB,IAAI,IAAI,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY;CAC1D,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG;IACvB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAMF,MAAM,MAAM,QAAQ,GAAG;IACrB;;;OAGG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,+EAA+E;IAC/E,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;IACjB,gCAAgC;IAChC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAMF,MAAM,MAAM,UAAU,GAAG;IAGvB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,WAAW,EAAE,UAAU,CAAC;IAIxB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,iDAAiD;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAI1B,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IACtE,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,CAAC;IAIvB,yDAAyD;IACzD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,yEAAyE;IACzE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,kCAAkC;IAClC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IAIzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IAIzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,oBAAoB,GAAG,OAAO,oBAAoB,GAAG,IAAI,CAAC;IAI/E;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IAIrF,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9D,kEAAkE;IAClE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5D,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,mCAAmC;IACnC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IACtE,yBAAyB;IACzB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,wBAAwB;IACxB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,aAAa;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC,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;IAC1C,2EAA2E;IAC3E,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-chess-kit",
-  "version": "0.4.1",
+  "version": "0.5.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",

package/src/board-coordinates.tsx

@@ -1,7 +1,7 @@
 import React from 'react';
 import { View, Text } from 'react-native';
 
-import type { ChessColor } from './types';
+import type { ChessColor, CoordinatePosition } from './types';
 
 type BoardCoordinatesProps = {
   boardSize: number;
@@ -10,6 +10,10 @@ type BoardCoordinatesProps = {
   darkColor: string;
   withLetters: boolean;
   withNumbers: boolean;
+  /** 'inside' overlays on edge squares, 'outside' renders in a gutter area. */
+  position?: 'inside' | 'outside';
+  /** Gutter width in pixels (only used when position='outside'). */
+  gutterWidth?: number;
 };
 
 const FILES_WHITE = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'];
@@ -18,11 +22,13 @@ 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.
+ * File letters (a-h) and rank numbers (1-8) drawn on or around the board.
  *
- * 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.
+ * Two modes:
+ * - **inside** (default): absolute-positioned inside each edge square, colors
+ *   alternate to contrast with the square behind them.
+ * - **outside**: rendered in a gutter area around the board. Rank numbers to
+ *   the left, file letters along the bottom. Uses the dark square color.
  */
 export const BoardCoordinates = React.memo(function BoardCoordinates({
   boardSize,
@@ -31,15 +37,105 @@ export const BoardCoordinates = React.memo(function BoardCoordinates({
   darkColor,
   withLetters,
   withNumbers,
+  position = 'inside',
+  gutterWidth = 0,
 }: 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;
 
+  // ── Outside mode: labels in gutter area around the board ──
+  if (position === 'outside') {
+    const fontSize = gutterWidth * 0.65;
+    const textColor = darkColor;
+
+    return (
+      <>
+        {/* Rank numbers — left gutter, vertically centered on each row */}
+        {withNumbers && (
+          <View
+            style={{
+              position: 'absolute',
+              left: 0,
+              top: 0,
+              width: gutterWidth,
+              height: boardSize,
+            }}
+            pointerEvents="none"
+          >
+            {ranks.map((rank, row) => (
+              <View
+                key={`r-${rank}`}
+                style={{
+                  position: 'absolute',
+                  top: row * squareSize,
+                  width: gutterWidth,
+                  height: squareSize,
+                  alignItems: 'center',
+                  justifyContent: 'center',
+                }}
+              >
+                <Text
+                  style={{
+                    fontSize,
+                    fontWeight: '600',
+                    color: textColor,
+                  }}
+                >
+                  {rank}
+                </Text>
+              </View>
+            ))}
+          </View>
+        )}
+
+        {/* File letters — bottom gutter, horizontally centered on each column */}
+        {withLetters && (
+          <View
+            style={{
+              position: 'absolute',
+              left: withNumbers ? gutterWidth : 0,
+              bottom: 0,
+              width: boardSize,
+              height: gutterWidth,
+            }}
+            pointerEvents="none"
+          >
+            {files.map((file, col) => (
+              <View
+                key={`f-${file}`}
+                style={{
+                  position: 'absolute',
+                  left: col * squareSize,
+                  width: squareSize,
+                  height: gutterWidth,
+                  alignItems: 'center',
+                  justifyContent: 'center',
+                }}
+              >
+                <Text
+                  style={{
+                    fontSize,
+                    fontWeight: '600',
+                    color: textColor,
+                  }}
+                >
+                  {file}
+                </Text>
+              </View>
+            ))}
+          </View>
+        )}
+      </>
+    );
+  }
+
+  // ── Inside mode (default): absolute-positioned inside edge squares ──
+  const fontSize = squareSize * 0.22;
+  const padding = squareSize * 0.06;
+
   return (
     <View
       style={{ position: 'absolute', width: boardSize, height: boardSize }}
@@ -48,7 +144,6 @@ export const BoardCoordinates = React.memo(function BoardCoordinates({
       {/* 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;
 
@@ -72,7 +167,6 @@ export const BoardCoordinates = React.memo(function BoardCoordinates({
       {/* 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;
 

package/src/board.tsx

@@ -33,6 +33,7 @@ import {
   DEFAULT_PREMOVE_COLOR,
   DEFAULT_DRAG_TARGET_COLOR,
   CAPTURE_FADE_DURATION,
+  COORDINATE_GUTTER_SCALE,
 } from './constants';
 import { DefaultPieceSet } from './pieces';
 import { useBoardPieces } from './use-board-pieces';
@@ -131,8 +132,9 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
 
     // Appearance
     colors,
-    withLetters = true,
-    withNumbers = true,
+    coordinatePosition: coordinatePositionProp,
+    withLetters: withLettersProp,
+    withNumbers: withNumbersProp,
     renderPiece,
     pieceSet,
 
@@ -155,7 +157,7 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
     moveDuration = DEFAULT_MOVE_DURATION,
     animationConfig,
     animateFlip = true,
-    pieceExitAnimation = FadeOut.duration(CAPTURE_FADE_DURATION),
+    pieceExitAnimation,
 
     // Promotion
     onPromotion,
@@ -179,10 +181,26 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
     setMeasuredSize(Math.min(width, height));
   }, []);
 
-  const boardSize = boardSizeProp ?? measuredSize;
-  const squareSize = boardSize / 8;
+  const outerSize = boardSizeProp ?? measuredSize;
   const boardColors = colors ?? DEFAULT_BOARD_COLORS;
 
+  // Resolve coordinate position: new prop takes precedence over legacy booleans
+  const coordinatePosition = coordinatePositionProp
+    ?? (withLettersProp === false && withNumbersProp === false ? 'none' : 'inside');
+  const isOutside = coordinatePosition === 'outside';
+  const isCoordVisible = coordinatePosition !== 'none';
+
+  // When outside: reserve gutter space; inner board = outer minus gutters
+  const gutterWidth = isOutside ? Math.round((outerSize / 8) * COORDINATE_GUTTER_SCALE) : 0;
+  const boardSize = isOutside ? outerSize - gutterWidth : outerSize;
+  const squareSize = boardSize / 8;
+
+  // Resolve piece exit animation: null = disabled, undefined = default FadeOut
+  const resolvedPieceExitAnimation =
+    pieceExitAnimation === null
+      ? undefined
+      : (pieceExitAnimation ?? FadeOut.duration(CAPTURE_FADE_DURATION));
+
   // --- Board flip animation ---
   const flipRotation = useSharedValue(orientation === 'black' ? 180 : 0);
   const prevOrientationRef = useRef(orientation);
@@ -506,17 +524,20 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
   }));
 
   // If no size yet (auto-sizing), render invisible container for measurement
-  if (boardSize === 0) {
+  if (outerSize === 0) {
     return (
       <View style={{ flex: 1, aspectRatio: 1 }} onLayout={handleLayout} />
     );
   }
 
-  return (
+  // Inner board with all interactive layers
+  const boardContent = (
     <GestureDetector gesture={gesture}>
       <View
-        style={{ width: boardSize, height: boardSize }}
-        onLayout={boardSizeProp ? undefined : handleLayout}
+        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="adjustable"
       >
@@ -527,15 +548,18 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
           darkColor={boardColors.dark}
         />
 
-        {/* Layer 2: Coordinate labels (a-h, 1-8) */}
-        <BoardCoordinates
-          boardSize={boardSize}
-          orientation={orientation}
-          lightColor={boardColors.light}
-          darkColor={boardColors.dark}
-          withLetters={withLetters}
-          withNumbers={withNumbers}
-        />
+        {/* Layer 2: Inside coordinate labels (when position='inside') */}
+        {isCoordVisible && !isOutside && (
+          <BoardCoordinates
+            boardSize={boardSize}
+            orientation={orientation}
+            lightColor={boardColors.light}
+            darkColor={boardColors.dark}
+            withLetters
+            withNumbers
+            position="inside"
+          />
+        )}
 
         {/* Layer 3: Square highlights (last move, check, selected, premove, custom, imperative) */}
         <BoardHighlights
@@ -583,7 +607,7 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
           renderPiece={resolvedRenderer}
           activeSquare={gestureState.activeSquare}
           isDragging={gestureState.isDragging}
-          exitingAnimation={pieceExitAnimation}
+          exitingAnimation={resolvedPieceExitAnimation}
         />
 
         {/* Layer 7: Arrows + shapes (SVG overlay) */}
@@ -632,4 +656,30 @@ export const Board = forwardRef<BoardRef, BoardProps>(function Board(
       </View>
     </GestureDetector>
   );
+
+  // Outside coordinates: wrap board in outer container with gutter
+  if (isOutside) {
+    return (
+      <View
+        style={{ width: outerSize, height: boardSize + gutterWidth }}
+        onLayout={boardSizeProp ? undefined : handleLayout}
+      >
+        {boardContent}
+
+        {/* Outside coordinate labels in the gutter area */}
+        <BoardCoordinates
+          boardSize={boardSize}
+          orientation={orientation}
+          lightColor={boardColors.light}
+          darkColor={boardColors.dark}
+          withLetters
+          withNumbers
+          position="outside"
+          gutterWidth={gutterWidth}
+        />
+      </View>
+    );
+  }
+
+  return boardContent;
 });

package/src/constants.ts

@@ -75,6 +75,9 @@ export const ANNOTATION_SCALE = 0.35;
 /** Coordinate font size as fraction of square size */
 export const COORDINATE_FONT_SCALE = 0.22;
 
+/** Outside-coordinate gutter width as fraction of square size */
+export const COORDINATE_GUTTER_SCALE = 0.45;
+
 /** Drag ghost scale factor (1.1x larger than normal piece) */
 export const DRAG_GHOST_SCALE = 1.1;
 

package/src/index.ts

@@ -65,6 +65,7 @@ export type {
   BoardProps,
   BoardColors,
   StaticBoardProps,
+  CoordinatePosition,
 
   // Piece data (useful for custom piece renderers)
   BoardPiece,

package/src/static-board.tsx

@@ -2,7 +2,7 @@ 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 { 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';
@@ -24,7 +24,8 @@ export const StaticBoard = React.memo(function StaticBoard({
   orientation = 'white',
   boardSize: boardSizeProp,
   colors,
-  withCoordinates = false,
+  coordinatePosition: coordinatePositionProp,
+  withCoordinates,
   renderPiece,
   pieceSet,
   lastMove,
@@ -39,10 +40,19 @@ export const StaticBoard = React.memo(function StaticBoard({
     setMeasuredSize(Math.min(width, height));
   }, []);
 
-  const boardSize = boardSizeProp ?? measuredSize;
-  const squareSize = boardSize / 8;
+  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);
 
@@ -59,16 +69,18 @@ export const StaticBoard = React.memo(function StaticBoard({
   }, [renderPiece, pieceSet]);
 
   // If no size yet (auto-sizing), render invisible container for measurement
-  if (boardSize === 0) {
+  if (outerSize === 0) {
     return (
       <View style={{ flex: 1, aspectRatio: 1 }} onLayout={handleLayout} />
     );
   }
 
-  return (
+  const boardContent = (
     <View
-      style={{ width: boardSize, height: boardSize }}
-      onLayout={boardSizeProp ? undefined : handleLayout}
+      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"
     >
@@ -79,8 +91,8 @@ export const StaticBoard = React.memo(function StaticBoard({
         darkColor={boardColors.dark}
       />
 
-      {/* Layer 2: Coordinates */}
-      {withCoordinates && (
+      {/* Layer 2: Inside coordinates */}
+      {isCoordVisible && !isOutside && (
         <BoardCoordinates
           boardSize={boardSize}
           orientation={orientation}
@@ -88,6 +100,7 @@ export const StaticBoard = React.memo(function StaticBoard({
           darkColor={boardColors.dark}
           withLetters
           withNumbers
+          position="inside"
         />
       )}
 
@@ -147,4 +160,28 @@ export const StaticBoard = React.memo(function StaticBoard({
       )}
     </View>
   );
+
+  if (isOutside) {
+    return (
+      <View
+        style={{ width: outerSize, height: boardSize + gutterWidth }}
+        onLayout={boardSizeProp ? undefined : handleLayout}
+      >
+        {boardContent}
+
+        <BoardCoordinates
+          boardSize={boardSize}
+          orientation={orientation}
+          lightColor={boardColors.light}
+          darkColor={boardColors.dark}
+          withLetters
+          withNumbers
+          position="outside"
+          gutterWidth={gutterWidth}
+        />
+      </View>
+    );
+  }
+
+  return boardContent;
 });

package/src/types.ts

@@ -10,6 +10,9 @@ export type ChessColor = 'white' | 'black';
 /** How the user interacts with pieces */
 export type MoveMethod = 'drag' | 'click' | 'both';
 
+/** Where to render file/rank coordinate labels */
+export type CoordinatePosition = 'inside' | 'outside' | 'none';
+
 /** Promotion piece choice */
 export type PromotionPiece = 'q' | 'r' | 'b' | 'n';
 
@@ -208,9 +211,18 @@ export type BoardProps = {
 
   /** Board square colors. Default: green theme */
   colors?: BoardColors;
-  /** Whether to show file labels (a-h). Default: true */
+  /**
+   * Where to render file/rank coordinate labels.
+   * - 'inside'  — overlaid on the edge squares (default)
+   * - 'outside' — in a gutter around the board (board shrinks slightly)
+   * - 'none'    — hidden
+   *
+   * @default 'inside'
+   */
+  coordinatePosition?: CoordinatePosition;
+  /** @deprecated Use coordinatePosition instead. Kept for backwards compat. */
   withLetters?: boolean;
-  /** Whether to show rank numbers (1-8). Default: true */
+  /** @deprecated Use coordinatePosition instead. Kept for backwards compat. */
   withNumbers?: boolean;
   /** Custom piece renderer. Receives piece code ('wp', 'bk', etc.) and pixel size. */
   renderPiece?: (pieceCode: string, size: number) => React.ReactElement;
@@ -255,12 +267,13 @@ export type BoardProps = {
   animateFlip?: boolean;
   /**
    * Custom exiting animation for pieces (played on unmount, e.g. captures).
-   * Pass `undefined` to disable all piece exit animations (useful when
-   * remounting the entire board via a React key change — prevents all
-   * pieces from fading out simultaneously).
-   * Default: FadeOut.duration(150)
+   * - `undefined` (or omitted): uses default FadeOut.duration(150)
+   * - `null`: disables all piece exit animations (pieces vanish instantly).
+   *   Useful when remounting the entire board via a React key change to
+   *   prevent all pieces from fading out simultaneously.
+   * - Any `BaseAnimationBuilder`: uses the provided animation.
    */
-  pieceExitAnimation?: BaseAnimationBuilder | typeof BaseAnimationBuilder;
+  pieceExitAnimation?: BaseAnimationBuilder | typeof BaseAnimationBuilder | null;
 
   // --- Promotion ---
 
@@ -307,7 +320,16 @@ export type StaticBoardProps = {
   boardSize?: number;
   /** Board square colors. Default: green theme */
   colors?: BoardColors;
-  /** Whether to show coordinate labels. Default: false */
+  /**
+   * Where to render file/rank coordinate labels.
+   * - 'inside'  — overlaid on the edge squares
+   * - 'outside' — in a gutter around the board (board shrinks slightly)
+   * - 'none'    — hidden (default)
+   *
+   * @default 'none'
+   */
+  coordinatePosition?: CoordinatePosition;
+  /** @deprecated Use coordinatePosition instead */
   withCoordinates?: boolean;
   /** Custom piece renderer */
   renderPiece?: (pieceCode: string, size: number) => React.ReactElement;