js-chess-engine 2.1.4 → 2.2.0

package/README.md

@@ -3,7 +3,7 @@
 ![GitHub package.json version](https://img.shields.io/github/package-json/v/josefjadrny/js-chess-engine)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Complete TypeScript chess engine without dependencies for Node.js >=24 and browsers. Includes configurable AI with difficulty levels 1-6.
+Complete TypeScript chess engine without dependencies for Node.js >=24 and browsers. Includes configurable AI with difficulty levels 1-5.
 
 **⚠️ Upgrading from v1?** See [Breaking Changes](#breaking-changes-from-v1) section at the end of this document
 
@@ -174,7 +174,7 @@ game.removePiece('E5')
 `game.aiMove(level)` - Calculate and perform the best move for the current player using AI. **Returns only the move** (v1 API compatible).
 
 Params:
-- `level` AILevel (_optional_) - AI difficulty level (1-6). See [Computer AI](#computer-ai) section. Default: 3
+- `level` AILevel (_optional_) - AI difficulty level (1-5). See [Computer AI](#computer-ai) section. Default: 3
 
 Returns: `HistoryEntry` - The played move (e.g., `{"E2": "E4"}`)
 
@@ -195,7 +195,7 @@ const board = game.exportJson()
 
 Params:
 - `options` object (_optional_) - Configuration options:
-  - `level` number (_optional_) - AI difficulty level (1-6). See [Computer AI](#computer-ai) section. Default: `3`
+  - `level` number (_optional_) - AI difficulty level (1-5). See [Computer AI](#computer-ai) section. Default: `3`
   - `play` boolean (_optional_) - Whether to apply the move to the game. Default: `true`. If `false`, returns the move without modifying the game state, and `board` will contain the current state (before the move).
   - `ttSizeMB` number (_optional_) - Transposition table size in MB (0 to disable, 0.25-256). Default: **auto-scaled by AI level**. See [Auto-Scaling Transposition Table](#transposition-table) for details.
 
@@ -382,7 +382,7 @@ const config2: BoardConfig = move(config1, 'E7', 'E5')
 
 Params:
 - `boardConfiguration` BoardConfig | string (_mandatory_) - Board [configuration](#board-configuration)
-- `level` AILevel (_optional_) - AI difficulty level (1-6). Default: 3
+- `level` AILevel (_optional_) - AI difficulty level (1-5). Default: 3
 
 Returns: `HistoryEntry` - The played move (e.g., `{"E2": "E4"}`)
 
@@ -403,7 +403,7 @@ console.log(move) // {"E2": "E4"}
 Params:
 - `boardConfiguration` BoardConfig | string (_mandatory_) - Board [configuration](#board-configuration)
 - `options` object (_optional_) - Configuration options:
-  - `level` number (_optional_) - AI difficulty level (1-6). Default: `3`
+  - `level` number (_optional_) - AI difficulty level (1-5). Default: `3`
   - `play` boolean (_optional_) - Whether to apply the move to the board. Default: `true`. If `false`, returns the move without modifying the board state, and `board` will contain the current state (before the move).
   - `ttSizeMB` number (_optional_) - Transposition table size in MB (0 to disable, 0.25-256). Default: **auto-scaled by AI level**. See [Auto-Scaling Transposition Table](#transposition-table) for details.
 
@@ -521,18 +521,17 @@ console.log(newConfig)
 
 ### Computer AI
 
-The engine includes a sophisticated AI based on the Minimax algorithm with alpha-beta pruning, enhanced with advanced performance optimizations. There are six difficulty levels:
+The engine includes a sophisticated AI based on the Minimax algorithm with alpha-beta pruning, enhanced with advanced performance optimizations. There are five difficulty levels:
 
 | Level | Alias             | Description                          | Search Depth |
 | :---: | :---------------- | :----------------------------------- | :----------: |
 |   1   | Beginner          | Very weak play, minimal lookahead    | 1-2 ply      |
 |   2   | Easy              | Suitable for new chess players       | 2-3 ply      |
-|   3   | Intermediate      | Balanced difficulty (default)        | 3-4 ply      |
-|   4   | Advanced          | Strong play with deeper search       | 4-5 ply      |
-|   5   | Expert            | Very strong play, deep search        | 5-6 ply      |
-|   6   | Master            | Maximum difficulty and search depth  | 6-7 ply      |
+|   3   | Intermediate      | Balanced difficulty (default)        | 3-5 ply      |
+|   4   | Advanced          | Strong play with deeper search       | 3-6 ply      |
+|   5   | Expert            | Very strong play, deep search        | 4-6 ply (max) |
 
-**Performance:** Response time increases exponentially with level. Benchmarked on modern hardware (Linux x64, Node.js v24): levels 1-2 ~30ms, level 3 ~50ms, levels 4-6 ~60-90ms. Actual performance varies based on hardware, position complexity, and cache size. Run `npm run benchmark` to measure performance on your system.
+**Performance:** Response time increases with level (deeper search + larger transposition table). Exact timings vary a lot by CPU, position complexity, and cache size, so the repo includes a benchmark script—run `npm run benchmark` to measure performance on your machine.
 
 ```typescript
 import { Game } from 'js-chess-engine'
@@ -546,7 +545,6 @@ game.aiMove(2)  // Easy
 game.aiMove(3)  // Intermediate (default)
 game.aiMove(4)  // Advanced
 game.aiMove(5)  // Expert
-game.aiMove(6)  // Master
 ```
 
 **Implementation Highlights:**
@@ -568,7 +566,6 @@ The engine automatically adjusts cache size based on AI level and environment:
 |    3     |     8 MB      |     4 MB      | Balanced (default)           |
 |    4     |    16 MB      |     8 MB      | Strong tactical play         |
 |    5     |    32 MB      |    16 MB      | Very strong play             |
-|    6     |    64 MB      |    32 MB      | Maximum strength             |
 
 Lower levels use less memory for faster responses, higher levels use more for better move quality. Browser cache sizes are appropriate for modern devices (2024+). Override with `ttSizeMB` option if needed.
 
@@ -699,7 +696,7 @@ ai(config, 3)  // Returns: { move: {"E2": "E4"}, board: {...} }
 ### 4. AI Difficulty Levels Changed
 
 - **v1:** Levels 0-4 (0=easiest, 4=hardest)
-- **v2:** Levels 1-6 (1=easiest, 6=hardest)
+- **v2:** Levels 1-5 (1=easiest, 5=hardest)
 
 **Migration:**
 - Level 0 → Level 1 (Beginner)
@@ -707,7 +704,6 @@ ai(config, 3)  // Returns: { move: {"E2": "E4"}, board: {...} }
 - Level 2 → Level 3 (Intermediate, default)
 - Level 3 → Level 4 (Advanced)
 - Level 4 → Level 5 (Expert)
-- New: Level 6 (Master)
 
 The default level has changed from `2` to `3` to maintain similar difficulty in the middle range.
 

package/dist/ai/AIEngine.d.ts

@@ -7,7 +7,7 @@ import { InternalBoard, InternalMove } from '../types';
 import { AILevel } from '../types/ai.types';
 /**
  * AI difficulty level configuration
- * Maps AI levels (1-6) to search depths
+ * Maps AI levels (1-5) to search depths
  */
 interface LevelConfig {
     baseDepth: number;
@@ -25,18 +25,31 @@ export declare class AIEngine {
      * Find the best move for the current position
      *
      * @param board - Current board state
-     * @param level - AI difficulty level (1-6, default 3)
+    * @param level - AI difficulty level (1-5, default 3)
      * @param ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256 MB, auto-scaled by level)
      * @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
+    * Get the search depth for a given AI level
      *
-     * @param level - AI level (1-6)
+    * @param level - AI level (1-5)
      * @returns Depth configuration
      */
     static getLevelDepth(level: AILevel): LevelConfig;
+    /**
+     * Adaptive depth heuristic.
+     *
+     * Contract:
+     * - Input: board + baseDepth (from level)
+     * - Output: adjusted depth (>= 1)
+     *
+    * Heuristic goals:
+    * - Never search shallower than the requested level depth.
+    * - If there are very few root legal moves (tactical / constrained), allow +1.
+    * - If the position is simplified (few pieces), allow +1 or +2.
+     */
+    private getAdaptiveDepth;
 }
 export {};
 //# sourceMappingURL=AIEngine.d.ts.map

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

@@ -1 +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;AAeD;;;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"}
+{"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;AAK5C;;;GAGG;AACH,UAAU,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACzB;AAgBD;;;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;IAuBlG;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW;IAIjD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;CA6B3B"}

package/dist/ai/AIEngine.js

@@ -7,17 +7,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIEngine = void 0;
 const Search_1 = require("./Search");
+const MoveGenerator_1 = require("../core/MoveGenerator");
+const types_1 = require("../types");
 /**
  * AI level to depth mapping
  * Based on v1 behavior for compatibility
  */
 const LEVEL_CONFIG = {
-    1: { baseDepth: 1, extendedDepth: 2 }, // Beginner
-    2: { baseDepth: 2, extendedDepth: 3 }, // Easy
-    3: { baseDepth: 3, extendedDepth: 4 }, // Intermediate (default)
-    4: { baseDepth: 4, extendedDepth: 5 }, // Advanced
-    5: { baseDepth: 5, extendedDepth: 6 }, // Expert
-    6: { baseDepth: 6, extendedDepth: 7 }, // Master
+    // NOTE: Depth is the single biggest speed lever.
+    // These values are intentionally conservative for browser-friendliness.
+    1: { baseDepth: 1, extendedDepth: 1 }, // Beginner
+    2: { baseDepth: 2, extendedDepth: 1 }, // Easy
+    3: { baseDepth: 3, extendedDepth: 2 }, // Intermediate (default)
+    4: { baseDepth: 3, extendedDepth: 3 }, // Advanced
+    5: { baseDepth: 4, extendedDepth: 2 }, // Expert
 };
 /**
  * AI Engine class
@@ -33,7 +36,7 @@ class AIEngine {
      * Find the best move for the current position
      *
      * @param board - Current board state
-     * @param level - AI difficulty level (1-6, default 3)
+    * @param level - AI difficulty level (1-5, default 3)
      * @param ttSizeMB - Transposition table size in MB (0 to disable, 0.25-256 MB, auto-scaled by level)
      * @returns Best move found by the AI
      */
@@ -45,19 +48,64 @@ class AIEngine {
         }
         // Get depth configuration for this level
         const config = LEVEL_CONFIG[level];
+        // Pick an effective depth based on current position complexity.
+        // This keeps early/midgame conservative, but lets endgames search deeper.
+        const effectiveDepth = this.getAdaptiveDepth(board, config.baseDepth, config.extendedDepth);
         // Perform search
-        const result = this.search.findBestMove(board, config.baseDepth, config.extendedDepth);
+        const result = this.search.findBestMove(board, effectiveDepth);
         return result ? result.move : null;
     }
     /**
-     * Get the search depth for a given AI level
+    * Get the search depth for a given AI level
      *
-     * @param level - AI level (1-6)
+    * @param level - AI level (1-5)
      * @returns Depth configuration
      */
     static getLevelDepth(level) {
         return LEVEL_CONFIG[level];
     }
+    /**
+     * Adaptive depth heuristic.
+     *
+     * Contract:
+     * - Input: board + baseDepth (from level)
+     * - Output: adjusted depth (>= 1)
+     *
+    * Heuristic goals:
+    * - Never search shallower than the requested level depth.
+    * - If there are very few root legal moves (tactical / constrained), allow +1.
+    * - If the position is simplified (few pieces), allow +1 or +2.
+     */
+    getAdaptiveDepth(board, baseDepth, allowedExtendedDepth) {
+        // Root branching factor (legal moves only)
+        const rootMoves = (0, MoveGenerator_1.generateLegalMoves)(board).length;
+        // Material simplification proxy: count non-empty pieces.
+        // (Mailbox is Int8Array, so iterating it is cheap.)
+        let pieceCount = 0;
+        for (const p of board.mailbox) {
+            if (p !== types_1.Piece.EMPTY)
+                pieceCount++;
+        }
+        let depth = baseDepth;
+        // Simplified endgames: search deeper.
+        // 32 pieces = starting position. Kings-only = 2.
+        if (pieceCount <= 10)
+            depth += 2;
+        else if (pieceCount <= 18)
+            depth += 1;
+        // Constrained positions: deeper can be affordable and tactically valuable.
+        if (rootMoves <= 12)
+            depth += 1;
+        // Safety rails
+        if (depth < baseDepth)
+            depth = baseDepth;
+        if (depth < 1)
+            depth = 1;
+        const maxDepth = baseDepth + Math.max(0, allowedExtendedDepth);
+        if (depth > maxDepth)
+            depth = maxDepth;
+        return depth;
+    }
 }
 exports.AIEngine = AIEngine;
 //# sourceMappingURL=AIEngine.js.map

package/dist/ai/AIEngine.js.map

@@ -1 +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,WAAW;IACnD,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,yBAAyB;IACjE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,WAAW;IACnD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,SAAS;IACjD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAG,SAAS;CACpD,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"}
+{"version":3,"file":"AIEngine.js","sourceRoot":"","sources":["../../src/ai/AIEngine.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,qCAAkC;AAClC,yDAA2D;AAC3D,oCAAiC;AAWjC;;;GAGG;AACH,MAAM,YAAY,GAAiC;IAC/C,iDAAiD;IACjD,wEAAwE;IACxE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAI,WAAW;IACpD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAI,OAAO;IAChD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAI,yBAAyB;IAClE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAI,WAAW;IACpD,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,EAAI,SAAS;CACrD,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,gEAAgE;QAChE,0EAA0E;QAC9E,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QAExF,iBAAiB;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CACnC,KAAK,EACL,cAAc,CACjB,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;IAED;;;;;;;;;;;OAWG;IACK,gBAAgB,CAAC,KAAoB,EAAE,SAAiB,EAAE,oBAA4B;QAC1F,2CAA2C;QAC3C,MAAM,SAAS,GAAG,IAAA,kCAAkB,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAEnD,yDAAyD;QACzD,oDAAoD;QACpD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,aAAK,CAAC,KAAK;gBAAE,UAAU,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,GAAG,SAAS,CAAC;QAEtB,sCAAsC;QACtC,iDAAiD;QACjD,IAAI,UAAU,IAAI,EAAE;YAAE,KAAK,IAAI,CAAC,CAAC;aAC5B,IAAI,UAAU,IAAI,EAAE;YAAE,KAAK,IAAI,CAAC,CAAC;QAEtC,2EAA2E;QAC3E,IAAI,SAAS,IAAI,EAAE;YAAE,KAAK,IAAI,CAAC,CAAC;QAEhC,eAAe;QACf,IAAI,KAAK,GAAG,SAAS;YAAE,KAAK,GAAG,SAAS,CAAC;QACzC,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,GAAG,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/D,IAAI,KAAK,GAAG,QAAQ;YAAE,KAAK,GAAG,QAAQ,CAAC;QAEvC,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AA1FD,4BA0FC"}

package/dist/ai/Evaluator.d.ts

@@ -1,88 +1,16 @@
 /**
- * Position evaluator for js-chess-engine v2
+ * Fast, deterministic evaluation.
  *
- * Evaluates chess positions using material count and piece-square tables.
- * Based on v1 implementation for API parity.
+ * Design goals:
+ * - Cheap (called at every leaf).
+ * - Stable (no expensive strategic features).
+ * - Returns a score from the perspective of `playerColor`.
  */
 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 const SCORE_MIN: Score;
+export declare const SCORE_MAX: Score;
 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 rook activity
-     * Rewards rooks on open/semi-open files and 7th rank
-     *
-     * @param board - Board to evaluate
-     * @param playerColor - Color to evaluate for
-     * @returns Rook activity score
-     */
-    private static evaluateRookActivity;
-    /**
-     * Evaluate king position in endgame
-     * In endgames, king should be centralized and active
-     *
-     * @param board - Board to evaluate
-     * @param playerColor - Color to evaluate for
-     * @returns Endgame king activity score
-     */
-    private static evaluateEndgameKing;
-    /**
-     * Get king square for a color
-     */
-    private static getKingSquare;
-    /**
-     * Evaluate passed pawns
-     * A passed pawn has no enemy pawns in front of it or on adjacent files
-     *
-     * @param board - Board to evaluate
-     * @param playerColor - Color to evaluate for
-     * @returns Passed pawn bonus score
-     */
-    private static evaluatePassedPawns;
-    /**
-     * 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;
-    /**
-     * Evaluate castling status
-     * Rewards having castled, which is a key strategic concept
-     *
-     * @param board - Board to evaluate
-     * @param playerColor - Color to evaluate for
-     * @returns Castling bonus score
-     */
-    private static evaluateCastling;
-    /**
-     * 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;
+    static evaluate(board: InternalBoard, playerColor: InternalColor, plyFromRoot?: number): Score;
 }
 //# sourceMappingURL=Evaluator.d.ts.map

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

@@ -1 +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;AAwB1C;;GAEG;AACH,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,eAAO,MAAM,SAAS,OAAO,CAAC;AAsI9B,qBAAa,SAAS;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK;IAgC3F;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyDnC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAuClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAc5B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoElC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAoB/B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA0BxC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4B/B;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;CAY7D"}
+{"version":3,"file":"Evaluator.d.ts","sourceRoot":"","sources":["../../src/ai/Evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAS,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,eAAO,MAAM,SAAS,EAAE,KAAkB,CAAC;AAC3C,eAAO,MAAM,SAAS,EAAE,KAAiB,CAAC;AAwH1C,qBAAa,SAAS;IAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,GAAE,MAAU,GAAG,KAAK;CAuBpG"}