@intrastellar/lozza 0.1.0 → 0.2.0

package/README.md

@@ -4,3 +4,10 @@ Browser-compatible Lozza chess engine for userscripts and Node.js.
 
 The package exposes `getBestMoveFromFen(fen, options)` through CommonJS and
 also publishes `globalThis.DLPLozza` when loaded as a browser script.
+
+`getBestMoveFromFenPersistent(fen, options)` keeps Lozza's transposition table
+between searches. The userscript worker build uses a 16 MB hash setting and
+keeps the search off the page's main thread.
+
+For userscripts, load `worker.js` with `@require`. It publishes
+`globalThis.DLPLozzaWorkerURL`, which can be passed to a browser `Worker`.

package/index.js

@@ -4769,7 +4769,7 @@ function captureUciOutput (commands) {
 
 }
 
-function getBestMoveFromFen (fen, options) {
+function normalizeSearchRequest (fen, options) {
 
     options = options || {};
 
@@ -4797,13 +4797,11 @@ function getBestMoveFromFen (fen, options) {
     if (sanitizedMoves.length > 0)
         positionCommand += ' moves ' + sanitizedMoves.join(' ');
 
-    const output = captureUciOutput(
-        'setoption name hash value ' + hash + '\n' +
-        'setoption name multipv value 1\n' +
-        'ucinewgame\n' +
-        positionCommand + '\n' +
-        'go depth ' + depth
-    );
+    return { depth, hash, positionCommand };
+
+}
+
+function parseBestMoveOutput (output, depth) {
 
     const bestMoveLine = output.find(line => line.startsWith('bestmove '));
 
@@ -4822,13 +4820,72 @@ function getBestMoveFromFen (fen, options) {
 
 }
 
+function getBestMoveFromFen (fen, options) {
+
+    const request = normalizeSearchRequest(fen, options);
+
+    const output = captureUciOutput(
+        'setoption name hash value ' + request.hash + '\n' +
+        'setoption name multipv value 1\n' +
+        'ucinewgame\n' +
+        request.positionCommand + '\n' +
+        'go depth ' + request.depth
+    );
+
+    return parseBestMoveOutput(output, request.depth);
+
+}
+
+let persistentEngineHash = null;
+let persistentEngineInitialized = false;
+
+function initializePersistentEngine (hash) {
+
+    hash = Math.max(parseInt(hash || ttDefault, 10) || ttDefault, 1);
+
+    captureUciOutput(
+        'setoption name hash value ' + hash + '\n' +
+        'setoption name multipv value 1\n' +
+        'ucinewgame'
+    );
+
+    persistentEngineHash = hash;
+    persistentEngineInitialized = true;
+
+    return { hash };
+
+}
+
+function getBestMoveFromFenPersistent (fen, options) {
+
+    options = options || {};
+    const requestedHash = Math.max(parseInt(options.hash || ttDefault, 10) || ttDefault, 1);
+
+    if (options.newGame || !persistentEngineInitialized || persistentEngineHash !== requestedHash)
+        initializePersistentEngine(requestedHash);
+
+    const request = normalizeSearchRequest(fen, options);
+    const output = captureUciOutput(
+        request.positionCommand + '\n' +
+        'go depth ' + request.depth
+    );
+
+    return parseBestMoveOutput(output, request.depth);
+}
+
 if (nodeHost) {
     module.exports = {
-        getBestMoveFromFen: getBestMoveFromFen
+        getBestMoveFromFen: getBestMoveFromFen,
+        getBestMoveFromFenPersistent: getBestMoveFromFenPersistent,
+        initializePersistentEngine: initializePersistentEngine
     };
 }
 
 if (typeof globalThis !== 'undefined') {
-    globalThis.DLPLozza = { getBestMoveFromFen };
+    globalThis.DLPLozza = {
+        getBestMoveFromFen,
+        getBestMoveFromFenPersistent,
+        initializePersistentEngine
+    };
 }
 

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@intrastellar/lozza",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Browser-compatible Lozza chess engine for userscripts and Node.js",
   "main": "index.js",
   "type": "commonjs",
   "files": [
     "index.js",
+    "worker.js",
     "README.md"
   ],
   "keywords": [