js-chess-engine 1.0.2 → 2.0.0

package/dist/core/zobrist.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Zobrist hashing for position identification
+ *
+ * Zobrist hashing provides a fast way to uniquely identify board positions
+ * for use in the transposition table. Each piece on each square gets a random
+ * 64-bit number, and the hash is the XOR of all piece positions plus state.
+ */
+import { Piece, SquareIndex, InternalBoard } from '../types';
+/**
+ * Initialize Zobrist hash tables with random 64-bit numbers
+ *
+ * This should be called once at startup. Uses a simple PRNG seeded
+ * with a fixed value for deterministic hashing.
+ */
+export declare function initZobrist(): void;
+/**
+ * Compute the Zobrist hash for a board position
+ *
+ * @param board - Board to hash
+ * @returns 64-bit Zobrist hash
+ */
+export declare function computeZobristHash(board: InternalBoard): bigint;
+/**
+ * Update hash after moving a piece
+ *
+ * This is more efficient than recomputing the entire hash.
+ *
+ * @param hash - Current hash
+ * @param piece - Piece being moved
+ * @param from - Source square
+ * @param to - Destination square
+ * @returns Updated hash
+ */
+export declare function updateHashMove(hash: bigint, piece: Piece, from: SquareIndex, to: SquareIndex): bigint;
+/**
+ * Update hash after capturing a piece
+ *
+ * @param hash - Current hash
+ * @param capturedPiece - Piece being captured
+ * @param square - Square where capture occurred
+ * @returns Updated hash
+ */
+export declare function updateHashCapture(hash: bigint, capturedPiece: Piece, square: SquareIndex): bigint;
+/**
+ * Toggle side to move in hash
+ *
+ * @param hash - Current hash
+ * @returns Updated hash with toggled side
+ */
+export declare function toggleSide(hash: bigint): bigint;
+/**
+ * Update hash for castling rights change
+ *
+ * @param hash - Current hash
+ * @param whiteShortOld - Old white short castling right
+ * @param whiteShortNew - New white short castling right
+ * @param whiteLongOld - Old white long castling right
+ * @param whiteLongNew - New white long castling right
+ * @param blackShortOld - Old black short castling right
+ * @param blackShortNew - New black short castling right
+ * @param blackLongOld - Old black long castling right
+ * @param blackLongNew - New black long castling right
+ * @returns Updated hash
+ */
+export declare function updateHashCastling(hash: bigint, whiteShortOld: boolean, whiteShortNew: boolean, whiteLongOld: boolean, whiteLongNew: boolean, blackShortOld: boolean, blackShortNew: boolean, blackLongOld: boolean, blackLongNew: boolean): bigint;
+/**
+ * Update hash for en passant square change
+ *
+ * @param hash - Current hash
+ * @param oldSquare - Old en passant square (or null)
+ * @param newSquare - New en passant square (or null)
+ * @returns Updated hash
+ */
+export declare function updateHashEnPassant(hash: bigint, oldSquare: SquareIndex | null, newSquare: SquareIndex | null): bigint;
+/**
+ * Add a piece to the hash
+ *
+ * @param hash - Current hash
+ * @param piece - Piece to add
+ * @param square - Square where piece is added
+ * @returns Updated hash
+ */
+export declare function addPieceToHash(hash: bigint, piece: Piece, square: SquareIndex): bigint;
+/**
+ * Remove a piece from the hash
+ *
+ * @param hash - Current hash
+ * @param piece - Piece to remove
+ * @param square - Square where piece is removed
+ * @returns Updated hash
+ */
+export declare function removePieceFromHash(hash: bigint, piece: Piece, square: SquareIndex): bigint;
+//# sourceMappingURL=zobrist.d.ts.map

package/dist/core/zobrist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zobrist.d.ts","sourceRoot":"","sources":["../../src/core/zobrist.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAiB,aAAa,EAAE,MAAM,UAAU,CAAC;AAmC5E;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CA0ClC;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAyC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,WAAW,GAChB,MAAM,CAYR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,KAAK,EACpB,MAAM,EAAE,WAAW,GACpB,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,GACtB,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,WAAW,GAAG,IAAI,EAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,GAC9B,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAMtF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAM3F"}

package/dist/core/zobrist.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Zobrist hashing for position identification
+ *
+ * Zobrist hashing provides a fast way to uniquely identify board positions
+ * for use in the transposition table. Each piece on each square gets a random
+ * 64-bit number, and the hash is the XOR of all piece positions plus state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initZobrist = initZobrist;
+exports.computeZobristHash = computeZobristHash;
+exports.updateHashMove = updateHashMove;
+exports.updateHashCapture = updateHashCapture;
+exports.toggleSide = toggleSide;
+exports.updateHashCastling = updateHashCastling;
+exports.updateHashEnPassant = updateHashEnPassant;
+exports.addPieceToHash = addPieceToHash;
+exports.removePieceFromHash = removePieceFromHash;
+const types_1 = require("../types");
+const constants_1 = require("../utils/constants");
+// ==================== Zobrist Key Tables ====================
+/**
+ * Random 64-bit numbers for Zobrist hashing
+ * [piece][square] -> random bigint
+ */
+let pieceKeys = [];
+/**
+ * Random number for side to move (white)
+ */
+let sideKey = 0n;
+/**
+ * Random numbers for castling rights
+ * [0] = white short, [1] = white long, [2] = black short, [3] = black long
+ */
+let castlingKeys = [];
+/**
+ * Random numbers for en passant file
+ * [file] -> random bigint (8 files)
+ */
+let enPassantKeys = [];
+/**
+ * Flag to check if Zobrist keys are initialized
+ */
+let initialized = false;
+// ==================== Initialization ====================
+/**
+ * Initialize Zobrist hash tables with random 64-bit numbers
+ *
+ * This should be called once at startup. Uses a simple PRNG seeded
+ * with a fixed value for deterministic hashing.
+ */
+function initZobrist() {
+    if (initialized) {
+        return;
+    }
+    // Initialize pseudo-random number generator with seed
+    let seed = 12345n;
+    const rand64 = () => {
+        // Simple XORShift64 PRNG
+        seed ^= seed << 13n;
+        seed ^= seed >> 7n;
+        seed ^= seed << 17n;
+        return seed;
+    };
+    // Initialize piece keys [piece type][square]
+    pieceKeys = [];
+    for (let piece = 0; piece <= 12; piece++) {
+        pieceKeys[piece] = [];
+        for (let square = 0; square < constants_1.TOTAL_SQUARES; square++) {
+            pieceKeys[piece][square] = rand64();
+        }
+    }
+    // Initialize side key (for white to move)
+    sideKey = rand64();
+    // Initialize castling keys
+    castlingKeys = [
+        rand64(), // white short
+        rand64(), // white long
+        rand64(), // black short
+        rand64(), // black long
+    ];
+    // Initialize en passant keys (one per file)
+    enPassantKeys = [];
+    for (let file = 0; file < 8; file++) {
+        enPassantKeys[file] = rand64();
+    }
+    initialized = true;
+}
+// ==================== Hash Computation ====================
+/**
+ * Compute the Zobrist hash for a board position
+ *
+ * @param board - Board to hash
+ * @returns 64-bit Zobrist hash
+ */
+function computeZobristHash(board) {
+    if (!initialized) {
+        initZobrist();
+    }
+    let hash = 0n;
+    // XOR piece positions
+    for (let square = 0; square < constants_1.TOTAL_SQUARES; square++) {
+        const piece = board.mailbox[square];
+        if (piece !== types_1.Piece.EMPTY) {
+            hash ^= pieceKeys[piece][square];
+        }
+    }
+    // XOR side to move (if white)
+    if (board.turn === types_1.InternalColor.WHITE) {
+        hash ^= sideKey;
+    }
+    // XOR castling rights
+    if (board.castlingRights.whiteShort) {
+        hash ^= castlingKeys[0];
+    }
+    if (board.castlingRights.whiteLong) {
+        hash ^= castlingKeys[1];
+    }
+    if (board.castlingRights.blackShort) {
+        hash ^= castlingKeys[2];
+    }
+    if (board.castlingRights.blackLong) {
+        hash ^= castlingKeys[3];
+    }
+    // XOR en passant square
+    if (board.enPassantSquare !== null) {
+        const file = board.enPassantSquare % 8;
+        hash ^= enPassantKeys[file];
+    }
+    return hash;
+}
+/**
+ * Update hash after moving a piece
+ *
+ * This is more efficient than recomputing the entire hash.
+ *
+ * @param hash - Current hash
+ * @param piece - Piece being moved
+ * @param from - Source square
+ * @param to - Destination square
+ * @returns Updated hash
+ */
+function updateHashMove(hash, piece, from, to) {
+    if (!initialized) {
+        initZobrist();
+    }
+    // Remove piece from old square
+    hash ^= pieceKeys[piece][from];
+    // Add piece to new square
+    hash ^= pieceKeys[piece][to];
+    return hash;
+}
+/**
+ * Update hash after capturing a piece
+ *
+ * @param hash - Current hash
+ * @param capturedPiece - Piece being captured
+ * @param square - Square where capture occurred
+ * @returns Updated hash
+ */
+function updateHashCapture(hash, capturedPiece, square) {
+    if (!initialized) {
+        initZobrist();
+    }
+    // Remove captured piece
+    hash ^= pieceKeys[capturedPiece][square];
+    return hash;
+}
+/**
+ * Toggle side to move in hash
+ *
+ * @param hash - Current hash
+ * @returns Updated hash with toggled side
+ */
+function toggleSide(hash) {
+    if (!initialized) {
+        initZobrist();
+    }
+    return hash ^ sideKey;
+}
+/**
+ * Update hash for castling rights change
+ *
+ * @param hash - Current hash
+ * @param whiteShortOld - Old white short castling right
+ * @param whiteShortNew - New white short castling right
+ * @param whiteLongOld - Old white long castling right
+ * @param whiteLongNew - New white long castling right
+ * @param blackShortOld - Old black short castling right
+ * @param blackShortNew - New black short castling right
+ * @param blackLongOld - Old black long castling right
+ * @param blackLongNew - New black long castling right
+ * @returns Updated hash
+ */
+function updateHashCastling(hash, whiteShortOld, whiteShortNew, whiteLongOld, whiteLongNew, blackShortOld, blackShortNew, blackLongOld, blackLongNew) {
+    if (!initialized) {
+        initZobrist();
+    }
+    // XOR out old castling rights
+    if (whiteShortOld)
+        hash ^= castlingKeys[0];
+    if (whiteLongOld)
+        hash ^= castlingKeys[1];
+    if (blackShortOld)
+        hash ^= castlingKeys[2];
+    if (blackLongOld)
+        hash ^= castlingKeys[3];
+    // XOR in new castling rights
+    if (whiteShortNew)
+        hash ^= castlingKeys[0];
+    if (whiteLongNew)
+        hash ^= castlingKeys[1];
+    if (blackShortNew)
+        hash ^= castlingKeys[2];
+    if (blackLongNew)
+        hash ^= castlingKeys[3];
+    return hash;
+}
+/**
+ * Update hash for en passant square change
+ *
+ * @param hash - Current hash
+ * @param oldSquare - Old en passant square (or null)
+ * @param newSquare - New en passant square (or null)
+ * @returns Updated hash
+ */
+function updateHashEnPassant(hash, oldSquare, newSquare) {
+    if (!initialized) {
+        initZobrist();
+    }
+    // XOR out old en passant
+    if (oldSquare !== null) {
+        const oldFile = oldSquare % 8;
+        hash ^= enPassantKeys[oldFile];
+    }
+    // XOR in new en passant
+    if (newSquare !== null) {
+        const newFile = newSquare % 8;
+        hash ^= enPassantKeys[newFile];
+    }
+    return hash;
+}
+/**
+ * Add a piece to the hash
+ *
+ * @param hash - Current hash
+ * @param piece - Piece to add
+ * @param square - Square where piece is added
+ * @returns Updated hash
+ */
+function addPieceToHash(hash, piece, square) {
+    if (!initialized) {
+        initZobrist();
+    }
+    return hash ^ pieceKeys[piece][square];
+}
+/**
+ * Remove a piece from the hash
+ *
+ * @param hash - Current hash
+ * @param piece - Piece to remove
+ * @param square - Square where piece is removed
+ * @returns Updated hash
+ */
+function removePieceFromHash(hash, piece, square) {
+    if (!initialized) {
+        initZobrist();
+    }
+    return hash ^ pieceKeys[piece][square];
+}
+// Initialize on module load
+initZobrist();
+//# sourceMappingURL=zobrist.js.map

package/dist/core/zobrist.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+/**
+ * js-chess-engine v2
+ *
+ * Public API for chess game management
+ */
+import { BoardConfig, MovesMap, PieceSymbol, HistoryEntry } from './types';
+export * from './types';
+/**
+ * Main Game class - manages chess game state and moves
+ */
+export declare class Game {
+    private board;
+    private history;
+    private aiEngine;
+    /**
+     * Create a new game
+     *
+     * @param configuration - Optional board configuration (JSON object, FEN string, or undefined for new game)
+     */
+    constructor(configuration?: BoardConfig | string);
+    /**
+     * Make a move
+     *
+     * @param from - From square (case-insensitive, e.g., 'E2' or 'e2')
+     * @param to - To square (case-insensitive, e.g., 'E4' or 'e4')
+     * @returns Board configuration after the move
+     */
+    move(from: string, to: string): BoardConfig;
+    /**
+     * Get all legal moves, optionally filtered by from-square
+     *
+     * @param from - Optional from square to filter moves
+     * @returns Map of from-squares to array of to-squares
+     */
+    moves(from?: string): MovesMap;
+    /**
+     * Set a piece on a square
+     *
+     * @param square - Square to place piece (case-insensitive)
+     * @param piece - Piece symbol (K, Q, R, B, N, P, k, q, r, b, n, p)
+     */
+    setPiece(square: string, piece: PieceSymbol): void;
+    /**
+     * Remove a piece from a square
+     *
+     * @param square - Square to remove piece from (case-insensitive)
+     */
+    removePiece(square: string): void;
+    /**
+     * Get move history
+     *
+     * @returns Array of history entries with board state after each move
+     */
+    getHistory(): Array<BoardConfig & {
+        move: HistoryEntry;
+    }>;
+    /**
+     * Export current board state as JSON configuration
+     *
+     * @returns Board configuration object
+     */
+    exportJson(): BoardConfig;
+    /**
+     * Export current board state as FEN string
+     *
+     * @returns FEN string
+     */
+    exportFEN(): string;
+    /**
+     * Print board to console (Unicode chess pieces)
+     */
+    printToConsole(): void;
+    /**
+     * Make an AI move (v1 compatible - returns only the move)
+     *
+     * @param level - AI level (1-5, default 3)
+     * @returns The played move object (e.g., {"E2": "E4"})
+     */
+    aiMove(level?: number): HistoryEntry;
+    /**
+     * Make an AI move and return both move and board state
+     *
+     * @param options - Optional configuration object
+     * @param options.level - AI difficulty level (1-5, default: 3)
+     * @param options.play - Whether to apply the move to the game (default: true). If false, only returns the move without modifying game state.
+     * @param options.ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256). Default: auto-scaled by level (e.g., level 3: 16 MB Node.js, 2 MB browser)
+     * @returns Object containing the move and board configuration (current state if play=false, updated state if play=true)
+     */
+    ai(options?: {
+        level?: number;
+        play?: boolean;
+        ttSizeMB?: number;
+    }): {
+        move: HistoryEntry;
+        board: BoardConfig;
+    };
+}
+/**
+ * Get all legal moves for a position
+ *
+ * @param config - Board configuration or FEN string
+ * @returns Map of from-squares to array of to-squares
+ */
+export declare function moves(config: BoardConfig | string): MovesMap;
+/**
+ * Get board status
+ *
+ * @param config - Board configuration or FEN string
+ * @returns Board configuration with current status
+ */
+export declare function status(config: BoardConfig | string): BoardConfig;
+/**
+ * Get FEN string for a position
+ *
+ * @param config - Board configuration or FEN string
+ * @returns FEN string
+ */
+export declare function getFen(config: BoardConfig | string): string;
+/**
+ * Make a move on a board
+ *
+ * @param config - Board configuration or FEN string
+ * @param from - From square
+ * @param to - To square
+ * @returns Board configuration after the move
+ */
+export declare function move(config: BoardConfig | string, from: string, to: string): BoardConfig;
+/**
+ * Make an AI move (v1 compatible - returns only the move)
+ *
+ * @param config - Board configuration or FEN string
+ * @param level - AI level (1-5, default 3)
+ * @returns The played move object (e.g., {"E2": "E4"})
+ */
+export declare function aiMove(config: BoardConfig | string, level?: number): HistoryEntry;
+/**
+ * Make an AI move and return both move and board state
+ *
+ * @param config - Board configuration or FEN string
+ * @param options - Optional configuration object
+ * @param options.level - AI difficulty level (1-5, default: 3)
+ * @param options.play - Whether to apply the move to the game (default: true). If false, only returns the move without modifying game state.
+ * @param options.ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256). Default: auto-scaled by level (e.g., level 3: 16 MB Node.js, 2 MB browser)
+ * @returns Object containing the move and board configuration (current state if play=false, updated state if play=true)
+ */
+export declare function ai(config: BoardConfig | string, options?: {
+    level?: number;
+    play?: boolean;
+    ttSizeMB?: number;
+}): {
+    move: HistoryEntry;
+    board: BoardConfig;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEH,WAAW,EACX,QAAQ,EAER,WAAW,EACX,YAAY,EACf,MAAM,SAAS,CAAC;AAkBjB,cAAc,SAAS,CAAC;AAExB;;GAEG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAW;IAE3B;;;;OAIG;gBACS,aAAa,CAAC,EAAE,WAAW,GAAG,MAAM;IAehD;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAyB3C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ;IAa9B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAOlD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjC;;;;OAIG;IACH,UAAU,IAAI,KAAK,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC;IA4BzD;;;;OAIG;IACH,UAAU,IAAI,WAAW;IAIzB;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,cAAc,IAAI,IAAI;IAqBtB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,GAAE,MAAU,GAAG,YAAY;IA0BvC;;;;;;;;OAQG;IACH,EAAE,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE;CA2CtH;AA0BD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAGxF;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,YAAY,CAGpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,EAAE,CACd,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACpE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAG5C"}