js-chess-engine 1.0.3 → 2.0.1-rc.0

package/dist/adapters/APIAdapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * API Adapter for converting between internal and external representations
+ *
+ * Internal format uses:
+ * - Square indices (0-63)
+ * - Piece enums
+ * - InternalColor enum
+ *
+ * External format (v1 API) uses:
+ * - Square strings (A1-H8)
+ * - Piece symbols (K, Q, R, B, N, P, k, q, r, b, n, p)
+ * - Color strings ('white', 'black')
+ */
+import { InternalBoard, BoardConfig, MovesMap, Piece, PieceSymbol, InternalColor, Color, Square, SquareIndex } from '../types';
+import { InternalMove } from '../types/move.types';
+/**
+ * Convert internal board to public board configuration
+ *
+ * @param board - Internal board representation
+ * @returns Public board configuration (v1 API format)
+ */
+export declare function boardToConfig(board: InternalBoard): BoardConfig;
+/**
+ * Convert public board configuration to internal board
+ *
+ * @param config - Public board configuration
+ * @returns Internal board representation
+ */
+export declare function configToBoard(config: BoardConfig): InternalBoard;
+/**
+ * Convert board configuration to FEN string
+ *
+ * @param config - Public board configuration
+ * @returns FEN string
+ */
+export declare function configToFEN(config: BoardConfig): string;
+/**
+ * Convert internal moves to public moves map
+ *
+ * @param moves - Array of internal moves
+ * @returns Public moves map (from-square -> [to-squares])
+ */
+export declare function movesToMap(moves: InternalMove[]): MovesMap;
+/**
+ * Convert internal moves from a specific square to array of to-squares
+ *
+ * @param moves - Array of internal moves
+ * @param fromIndex - From square index
+ * @returns Array of to-square strings
+ */
+export declare function movesFromSquare(moves: InternalMove[], fromIndex: SquareIndex): Square[];
+/**
+ * Convert piece enum to piece symbol
+ *
+ * @param piece - Internal piece enum
+ * @returns Piece symbol or null if empty
+ */
+export declare function pieceToSymbol(piece: Piece): PieceSymbol | null;
+/**
+ * Convert piece symbol to piece enum
+ *
+ * @param symbol - Piece symbol
+ * @returns Internal piece enum
+ */
+export declare function symbolToPiece(symbol: PieceSymbol): Piece;
+/**
+ * Convert color string to internal color
+ *
+ * @param color - Color string
+ * @returns Internal color enum
+ */
+export declare function colorToInternal(color: Color): InternalColor;
+/**
+ * Convert internal color to color string
+ *
+ * @param color - Internal color enum
+ * @returns Color string
+ */
+export declare function internalToColor(color: InternalColor): Color;
+/**
+ * Normalize square string to uppercase (A1-H8)
+ * V1 API accepts case-insensitive input
+ *
+ * @param square - Square string (case-insensitive)
+ * @returns Normalized uppercase square string
+ */
+export declare function normalizeSquare(square: string): string;
+//# sourceMappingURL=APIAdapter.d.ts.map

package/dist/adapters/APIAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/APIAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,aAAa,EACb,WAAW,EACX,QAAQ,EACR,KAAK,EACL,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,EACN,WAAW,EACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CA0B/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAOhE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA4CvD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,QAAQ,CAe1D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,WAAW,GAAG,MAAM,EAAE,CAIvF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,CAgB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAexD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/adapters/APIAdapter.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * API Adapter for converting between internal and external representations
+ *
+ * Internal format uses:
+ * - Square indices (0-63)
+ * - Piece enums
+ * - InternalColor enum
+ *
+ * External format (v1 API) uses:
+ * - Square strings (A1-H8)
+ * - Piece symbols (K, Q, R, B, N, P, k, q, r, b, n, p)
+ * - Color strings ('white', 'black')
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boardToConfig = boardToConfig;
+exports.configToBoard = configToBoard;
+exports.configToFEN = configToFEN;
+exports.movesToMap = movesToMap;
+exports.movesFromSquare = movesFromSquare;
+exports.pieceToSymbol = pieceToSymbol;
+exports.symbolToPiece = symbolToPiece;
+exports.colorToInternal = colorToInternal;
+exports.internalToColor = internalToColor;
+exports.normalizeSquare = normalizeSquare;
+const types_1 = require("../types");
+const conversion_1 = require("../utils/conversion");
+/**
+ * Convert internal board to public board configuration
+ *
+ * @param board - Internal board representation
+ * @returns Public board configuration (v1 API format)
+ */
+function boardToConfig(board) {
+    const pieces = {};
+    // Convert mailbox to pieces object
+    for (let i = 0; i < 64; i++) {
+        const piece = board.mailbox[i];
+        if (piece !== types_1.Piece.EMPTY) {
+            const square = (0, conversion_1.indexToSquare)(i);
+            const symbol = pieceToSymbol(piece);
+            if (symbol) {
+                pieces[square] = symbol;
+            }
+        }
+    }
+    return {
+        pieces,
+        turn: board.turn === types_1.InternalColor.WHITE ? 'white' : 'black',
+        isFinished: board.isCheckmate || board.isStalemate,
+        check: board.isCheck,
+        checkMate: board.isCheckmate,
+        castling: { ...board.castlingRights },
+        enPassant: board.enPassantSquare !== null ? (0, conversion_1.indexToSquare)(board.enPassantSquare) : null,
+        halfMove: board.halfMoveClock,
+        fullMove: board.fullMoveNumber,
+    };
+}
+/**
+ * Convert public board configuration to internal board
+ *
+ * @param config - Public board configuration
+ * @returns Internal board representation
+ */
+function configToBoard(config) {
+    // We'll use FEN conversion for this as it's more straightforward
+    // First convert config to FEN, then parse FEN to internal board
+    // However, for simplicity, we can also build it directly
+    const { parseFEN } = require('../utils/fen');
+    const fen = configToFEN(config);
+    return parseFEN(fen);
+}
+/**
+ * Convert board configuration to FEN string
+ *
+ * @param config - Public board configuration
+ * @returns FEN string
+ */
+function configToFEN(config) {
+    // Build piece placement string
+    const ranks = [];
+    for (let rank = 7; rank >= 0; rank--) {
+        let rankStr = '';
+        let emptyCount = 0;
+        for (let file = 0; file < 8; file++) {
+            const square = (0, conversion_1.indexToSquare)((rank * 8 + file));
+            const piece = config.pieces[square];
+            if (!piece) {
+                emptyCount++;
+            }
+            else {
+                if (emptyCount > 0) {
+                    rankStr += emptyCount.toString();
+                    emptyCount = 0;
+                }
+                rankStr += piece;
+            }
+        }
+        if (emptyCount > 0) {
+            rankStr += emptyCount.toString();
+        }
+        ranks.push(rankStr);
+    }
+    const piecePlacement = ranks.join('/');
+    const activeColor = config.turn === 'white' ? 'w' : 'b';
+    let castling = '';
+    if (config.castling.whiteShort)
+        castling += 'K';
+    if (config.castling.whiteLong)
+        castling += 'Q';
+    if (config.castling.blackShort)
+        castling += 'k';
+    if (config.castling.blackLong)
+        castling += 'q';
+    if (!castling)
+        castling = '-';
+    const enPassant = config.enPassant ? config.enPassant.toLowerCase() : '-';
+    const halfMove = config.halfMove.toString();
+    const fullMove = config.fullMove.toString();
+    return `${piecePlacement} ${activeColor} ${castling} ${enPassant} ${halfMove} ${fullMove}`;
+}
+/**
+ * Convert internal moves to public moves map
+ *
+ * @param moves - Array of internal moves
+ * @returns Public moves map (from-square -> [to-squares])
+ */
+function movesToMap(moves) {
+    const movesMap = {};
+    for (const move of moves) {
+        const fromSquare = (0, conversion_1.indexToSquare)(move.from);
+        const toSquare = (0, conversion_1.indexToSquare)(move.to);
+        if (!movesMap[fromSquare]) {
+            movesMap[fromSquare] = [];
+        }
+        movesMap[fromSquare].push(toSquare);
+    }
+    return movesMap;
+}
+/**
+ * Convert internal moves from a specific square to array of to-squares
+ *
+ * @param moves - Array of internal moves
+ * @param fromIndex - From square index
+ * @returns Array of to-square strings
+ */
+function movesFromSquare(moves, fromIndex) {
+    return moves
+        .filter(move => move.from === fromIndex)
+        .map(move => (0, conversion_1.indexToSquare)(move.to));
+}
+/**
+ * Convert piece enum to piece symbol
+ *
+ * @param piece - Internal piece enum
+ * @returns Piece symbol or null if empty
+ */
+function pieceToSymbol(piece) {
+    switch (piece) {
+        case types_1.Piece.WHITE_KING: return 'K';
+        case types_1.Piece.WHITE_QUEEN: return 'Q';
+        case types_1.Piece.WHITE_ROOK: return 'R';
+        case types_1.Piece.WHITE_BISHOP: return 'B';
+        case types_1.Piece.WHITE_KNIGHT: return 'N';
+        case types_1.Piece.WHITE_PAWN: return 'P';
+        case types_1.Piece.BLACK_KING: return 'k';
+        case types_1.Piece.BLACK_QUEEN: return 'q';
+        case types_1.Piece.BLACK_ROOK: return 'r';
+        case types_1.Piece.BLACK_BISHOP: return 'b';
+        case types_1.Piece.BLACK_KNIGHT: return 'n';
+        case types_1.Piece.BLACK_PAWN: return 'p';
+        default: return null;
+    }
+}
+/**
+ * Convert piece symbol to piece enum
+ *
+ * @param symbol - Piece symbol
+ * @returns Internal piece enum
+ */
+function symbolToPiece(symbol) {
+    switch (symbol) {
+        case 'K': return types_1.Piece.WHITE_KING;
+        case 'Q': return types_1.Piece.WHITE_QUEEN;
+        case 'R': return types_1.Piece.WHITE_ROOK;
+        case 'B': return types_1.Piece.WHITE_BISHOP;
+        case 'N': return types_1.Piece.WHITE_KNIGHT;
+        case 'P': return types_1.Piece.WHITE_PAWN;
+        case 'k': return types_1.Piece.BLACK_KING;
+        case 'q': return types_1.Piece.BLACK_QUEEN;
+        case 'r': return types_1.Piece.BLACK_ROOK;
+        case 'b': return types_1.Piece.BLACK_BISHOP;
+        case 'n': return types_1.Piece.BLACK_KNIGHT;
+        case 'p': return types_1.Piece.BLACK_PAWN;
+    }
+}
+/**
+ * Convert color string to internal color
+ *
+ * @param color - Color string
+ * @returns Internal color enum
+ */
+function colorToInternal(color) {
+    return color === 'white' ? types_1.InternalColor.WHITE : types_1.InternalColor.BLACK;
+}
+/**
+ * Convert internal color to color string
+ *
+ * @param color - Internal color enum
+ * @returns Color string
+ */
+function internalToColor(color) {
+    return color === types_1.InternalColor.WHITE ? 'white' : 'black';
+}
+/**
+ * Normalize square string to uppercase (A1-H8)
+ * V1 API accepts case-insensitive input
+ *
+ * @param square - Square string (case-insensitive)
+ * @returns Normalized uppercase square string
+ */
+function normalizeSquare(square) {
+    return square.toUpperCase();
+}
+//# sourceMappingURL=APIAdapter.js.map

package/dist/adapters/APIAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIAdapter.js","sourceRoot":"","sources":["../../src/adapters/APIAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAsBH,sCA0BC;AAQD,sCAOC;AAQD,kCA4CC;AAQD,gCAeC;AASD,0CAIC;AAQD,sCAgBC;AAQD,sCAeC;AAQD,0CAEC;AAQD,0CAEC;AASD,0CAEC;AAnOD,oCAUkB;AAClB,oDAAmE;AAGnE;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAoB;IAC9C,MAAM,MAAM,GAAgC,EAAE,CAAC;IAE/C,mCAAmC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,aAAK,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,CAAgB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO;QACH,MAAM;QACN,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,qBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAC5D,UAAU,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW;QAClD,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,SAAS,EAAE,KAAK,CAAC,WAAW;QAC5B,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE;QACrC,SAAS,EAAE,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI;QACvF,QAAQ,EAAE,KAAK,CAAC,aAAa;QAC7B,QAAQ,EAAE,KAAK,CAAC,cAAc;KACjC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAmB;IAC7C,iEAAiE;IACjE,gEAAgE;IAChE,yDAAyD;IACzD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,MAAmB;IAC3C,+BAA+B;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACnC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAgB,CAAC,CAAC;YAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEpC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,UAAU,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACJ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACjB,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACjC,UAAU,GAAG,CAAC,CAAC;gBACnB,CAAC;gBACD,OAAO,IAAI,KAAK,CAAC;YACrB,CAAC;QACL,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAExD,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU;QAAE,QAAQ,IAAI,GAAG,CAAC;IAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS;QAAE,QAAQ,IAAI,GAAG,CAAC;IAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU;QAAE,QAAQ,IAAI,GAAG,CAAC;IAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS;QAAE,QAAQ,IAAI,GAAG,CAAC;IAC/C,IAAI,CAAC,QAAQ;QAAE,QAAQ,GAAG,GAAG,CAAC;IAE9B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAE5C,OAAO,GAAG,cAAc,IAAI,WAAW,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAC/F,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAqB;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,IAAA,0BAAa,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAA,0BAAa,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QAC9B,CAAC;QAED,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,KAAqB,EAAE,SAAsB;IACzE,OAAO,KAAK;SACP,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;SACvC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,0BAAa,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAY;IACtC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,KAAK,aAAK,CAAC,WAAW,CAAC,CAAC,OAAO,GAAG,CAAC;QACnC,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,KAAK,aAAK,CAAC,YAAY,CAAC,CAAC,OAAO,GAAG,CAAC;QACpC,KAAK,aAAK,CAAC,YAAY,CAAC,CAAC,OAAO,GAAG,CAAC;QACpC,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,KAAK,aAAK,CAAC,WAAW,CAAC,CAAC,OAAO,GAAG,CAAC;QACnC,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,KAAK,aAAK,CAAC,YAAY,CAAC,CAAC,OAAO,GAAG,CAAC;QACpC,KAAK,aAAK,CAAC,YAAY,CAAC,CAAC,OAAO,GAAG,CAAC;QACpC,KAAK,aAAK,CAAC,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAClC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACzB,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAmB;IAC7C,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,WAAW,CAAC;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,YAAY,CAAC;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,YAAY,CAAC;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,WAAW,CAAC;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,YAAY,CAAC;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,YAAY,CAAC;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,aAAK,CAAC,UAAU,CAAC;IACtC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,KAAY;IACxC,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,qBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAa,CAAC,KAAK,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,KAAoB;IAChD,OAAO,KAAK,KAAK,qBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/dist/ai/AIEngine.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AI Engine for js-chess-engine v2
+ *
+ * Orchestrates the AI search and provides level-based difficulty settings.
+ */
+import { InternalBoard, InternalMove } from '../types';
+import { AILevel } from '../types/ai.types';
+/**
+ * AI difficulty level configuration
+ * Maps AI levels (1-5) to search depths
+ */
+interface LevelConfig {
+    baseDepth: number;
+    extendedDepth: number;
+}
+/**
+ * AI Engine class
+ * Manages AI move selection and search
+ */
+export declare class AIEngine {
+    private search;
+    private currentTTSize;
+    constructor();
+    /**
+     * Find the best move for the current position
+     *
+     * @param board - Current board state
+     * @param level - AI difficulty level (1-5, default 3)
+     * @param ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256 MB, default 16)
+     * @returns Best move found by the AI
+     */
+    findBestMove(board: InternalBoard, level?: AILevel, ttSizeMB?: number): InternalMove | null;
+    /**
+     * Get the search depth for a given AI level
+     *
+     * @param level - AI level (1-5)
+     * @returns Depth configuration
+     */
+    static getLevelDepth(level: AILevel): LevelConfig;
+}
+export {};
+//# sourceMappingURL=AIEngine.d.ts.map

package/dist/ai/AIEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIEngine.d.ts","sourceRoot":"","sources":["../../src/ai/AIEngine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;;GAGG;AACH,UAAU,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACzB;AAcD;;;GAGG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAc;;IAMnC;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,GAAE,OAAW,EAAE,QAAQ,GAAE,MAAW,GAAG,YAAY,GAAG,IAAI;IAoBlG;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW;CAGpD"}

package/dist/ai/AIEngine.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * AI Engine for js-chess-engine v2
+ *
+ * Orchestrates the AI search and provides level-based difficulty settings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIEngine = void 0;
+const Search_1 = require("./Search");
+/**
+ * AI level to depth mapping
+ * Based on v1 behavior for compatibility
+ */
+const LEVEL_CONFIG = {
+    1: { baseDepth: 1, extendedDepth: 2 }, // Very easy
+    2: { baseDepth: 2, extendedDepth: 3 }, // Easy
+    3: { baseDepth: 3, extendedDepth: 4 }, // Medium (default)
+    4: { baseDepth: 4, extendedDepth: 5 }, // Hard
+    5: { baseDepth: 5, extendedDepth: 6 }, // Very hard
+};
+/**
+ * AI Engine class
+ * Manages AI move selection and search
+ */
+class AIEngine {
+    search;
+    currentTTSize = 16;
+    constructor() {
+        this.search = new Search_1.Search(this.currentTTSize);
+    }
+    /**
+     * Find the best move for the current position
+     *
+     * @param board - Current board state
+     * @param level - AI difficulty level (1-5, default 3)
+     * @param ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256 MB, default 16)
+     * @returns Best move found by the AI
+     */
+    findBestMove(board, level = 3, ttSizeMB = 16) {
+        // Recreate search if TT size changed
+        if (ttSizeMB !== this.currentTTSize) {
+            this.currentTTSize = ttSizeMB;
+            this.search = new Search_1.Search(ttSizeMB);
+        }
+        // Get depth configuration for this level
+        const config = LEVEL_CONFIG[level];
+        // Perform search
+        const result = this.search.findBestMove(board, config.baseDepth, config.extendedDepth);
+        return result ? result.move : null;
+    }
+    /**
+     * Get the search depth for a given AI level
+     *
+     * @param level - AI level (1-5)
+     * @returns Depth configuration
+     */
+    static getLevelDepth(level) {
+        return LEVEL_CONFIG[level];
+    }
+}
+exports.AIEngine = AIEngine;
+//# sourceMappingURL=AIEngine.js.map

package/dist/ai/AIEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIEngine.js","sourceRoot":"","sources":["../../src/ai/AIEngine.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,qCAAkC;AAWlC;;;GAGG;AACH,MAAM,YAAY,GAAiC;IAC/C,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,YAAY;IACpD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,OAAO;IAC/C,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,mBAAmB;IAC3D,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,OAAO;IAC/C,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,YAAY;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAa,QAAQ;IACT,MAAM,CAAS;IACf,aAAa,GAAW,EAAE,CAAC;IAEnC;QACI,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAoB,EAAE,QAAiB,CAAC,EAAE,WAAmB,EAAE;QACxE,qCAAqC;QACrC,IAAI,QAAQ,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,yCAAyC;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAEnC,iBAAiB;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CACnC,KAAK,EACL,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,aAAa,CACvB,CAAC;QAEF,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,KAAc;QAC/B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACJ;AA7CD,4BA6CC"}

package/dist/ai/Evaluator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Position evaluator for js-chess-engine v2
+ *
+ * Evaluates chess positions using material count and piece-square tables.
+ * Based on v1 implementation for API parity.
+ */
+import { InternalBoard, InternalColor } from '../types';
+import { Score } from '../types/ai.types';
+/**
+ * Score bounds for special positions
+ */
+export declare const SCORE_MIN = -1000;
+export declare const SCORE_MAX = 1000;
+export declare class Evaluator {
+    /**
+     * Evaluate a position from the perspective of the specified color
+     *
+     * @param board - Board to evaluate
+     * @param playerColor - Color to evaluate for (positive = good for this color)
+     * @param depth - Current search depth (used for mate scoring)
+     * @returns Score in centipawns (positive = good for playerColor)
+     */
+    static evaluate(board: InternalBoard, playerColor: InternalColor, depth?: number): Score;
+    /**
+     * Evaluate material balance
+     *
+     * @param board - Board to evaluate
+     * @param playerColor - Color to evaluate for
+     * @returns Material score
+     */
+    private static evaluateMaterial;
+    /**
+     * Evaluate piece-square table bonuses
+     *
+     * @param board - Board to evaluate
+     * @param playerColor - Color to evaluate for
+     * @returns Positional score
+     */
+    private static evaluatePieceSquareTables;
+    /**
+     * Get total material value on the board (used for endgame detection)
+     *
+     * @param board - Board to evaluate
+     * @returns Total material value
+     */
+    static getTotalMaterialValue(board: InternalBoard): number;
+}
+//# sourceMappingURL=Evaluator.d.ts.map

package/dist/ai/Evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Evaluator.d.ts","sourceRoot":"","sources":["../../src/ai/Evaluator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAS,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAsB1C;;GAEG;AACH,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,eAAO,MAAM,SAAS,OAAO,CAAC;AA+H9B,qBAAa,SAAS;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK;IAwB3F;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAoB/B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA0BxC;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;CAY7D"}