@cubingcenter/scrambler 0.4.0 → 0.4.1

package/dist-cjs/puzzles/cube2/validation.js

@@ -7,6 +7,17 @@ exports.permutationParity = permutationParity;
 const types_js_1 = require("./types.js");
 const moves_js_1 = require("./moves.js");
 const state_js_1 = require("./state.js");
+const tables_js_1 = require("./solver/tables.js");
+// Precomputed coordinate encodings of every single-move state, so the
+// "one move from solved" check is a couple of O(n) encodings + 18 comparisons
+// instead of 18 full state applications.
+const ONE_MOVE_FROM_SOLVED_ENCODED = types_js_1.CUBE2_MOVES.map((move) => {
+    const state = (0, moves_js_1.applyCube2Move)((0, state_js_1.createSolvedCube2State)(), move);
+    return {
+        p: (0, tables_js_1.encodePermutation)(state.corners.permutation),
+        o: (0, tables_js_1.encodeOrientation)(state.corners.orientation)
+    };
+});
 function validateCube2State(state) {
     const errors = [
         ...validatePermutation("corner", state.corners.permutation, types_js_1.CORNER_COUNT),
@@ -24,8 +35,9 @@ function validateCube2State(state) {
     };
 }
 function isOneMoveFromSolvedCube2State(state) {
-    const solved = (0, state_js_1.createSolvedCube2State)();
-    return types_js_1.CUBE2_MOVES.some((move) => (0, state_js_1.cube2StatesEqual)((0, moves_js_1.applyCube2Move)(solved, move), state));
+    const p = (0, tables_js_1.encodePermutation)(state.corners.permutation);
+    const o = (0, tables_js_1.encodeOrientation)(state.corners.orientation);
+    return ONE_MOVE_FROM_SOLVED_ENCODED.some((entry) => entry.p === p && entry.o === o);
 }
 function isAllowedRandomCube2State(state) {
     return validateCube2State(state).valid &&

package/dist-cjs/puzzles/cube3/index.js

@@ -33,7 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.solver = exports.toCube3Facelets = exports.getCube3FaceOrder = exports.formatCube3Facelets = exports.generateCube3Scramble = exports.cube3ScrambleGenerator = exports.generateRandomCube3State = exports.validateCube3State = exports.permutationParity = exports.isOneMoveFromSolvedCube3State = exports.isAllowedRandomCube3State = exports.isSolvedCube3State = exports.cube3StatesEqual = exports.createSolvedCube3State = exports.cloneCube3State = exports.parseCube3Move = exports.parseCube3Algorithm = exports.invertCube3Move = exports.invertCube3Algorithm = exports.formatCube3Algorithm = exports.applyCube3Move = exports.applyCube3Algorithm = exports.EDGE_COUNT = exports.CORNER_COUNT = exports.CUBE3_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.solver = exports.toCube3Facelets = exports.getCube3FaceOrder = exports.formatCube3Facelets = exports.generateCube3Scramble = exports.cube3ScrambleGenerator = exports.generateRandomCube3State = exports.validateCube3State = exports.permutationParity = exports.isOneMoveFromSolvedCube3State = exports.isAllowedRandomCube3State = exports.isSolvedCube3State = exports.cube3StatesEqual = exports.createSolvedCube3State = exports.cloneCube3State = exports.parseCube3Move = exports.parseCube3Algorithm = exports.invertCube3Move = exports.invertCube3Algorithm = exports.formatCube3Algorithm = exports.applyCube3Move = exports.applyCube3Algorithm = exports.EDGE_COUNT = exports.CORNER_COUNT = exports.CUBE3_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.cube3ScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CUBE3_MOVES", { enumerable: true, get: function () { return types_js_1.CUBE3_MOVES; } });
 Object.defineProperty(exports, "CORNER_COUNT", { enumerable: true, get: function () { return types_js_1.CORNER_COUNT; } });
@@ -58,11 +61,17 @@ Object.defineProperty(exports, "permutationParity", { enumerable: true, get: fun
 Object.defineProperty(exports, "validateCube3State", { enumerable: true, get: function () { return validation_js_1.validateCube3State; } });
 var random_state_js_1 = require("./random-state.js");
 Object.defineProperty(exports, "generateRandomCube3State", { enumerable: true, get: function () { return random_state_js_1.generateRandomCube3State; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "cube3ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.cube3ScrambleGenerator; } });
-Object.defineProperty(exports, "generateCube3Scramble", { enumerable: true, get: function () { return scrambler_js_1.generateCube3Scramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "cube3ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.cube3ScrambleGenerator; } });
+Object.defineProperty(exports, "generateCube3Scramble", { enumerable: true, get: function () { return scrambler_js_2.generateCube3Scramble; } });
 var facelets_js_1 = require("./facelets.js");
 Object.defineProperty(exports, "formatCube3Facelets", { enumerable: true, get: function () { return facelets_js_1.formatCube3Facelets; } });
 Object.defineProperty(exports, "getCube3FaceOrder", { enumerable: true, get: function () { return facelets_js_1.getCube3FaceOrder; } });
 Object.defineProperty(exports, "toCube3Facelets", { enumerable: true, get: function () { return facelets_js_1.toCube3Facelets; } });
 exports.solver = __importStar(require("./solver/index.js"));
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/cube3/solver/browser-loader.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCachedBrowserTables = getCachedBrowserTables;
 exports.clearCachedBrowserTables = clearCachedBrowserTables;
 exports.loadBrowserTables = loadBrowserTables;
+const compressed_fetch_js_1 = require("../../shared/compressed-fetch.js");
+const TABLES_DIR = "puzzles/cube3/solver/generated";
+const CACHE_NAME = "cubingcenter-scrambler-tables-v1";
 let browserTables;
 function resolveBaseUrl(provided) {
     if (provided) {
@@ -54,31 +57,6 @@ async function loadBrowserTables(baseUrl) {
     };
     return browserTables;
 }
-const CACHE_NAME = "cubingcenter-scrambler-tables-v1";
-async function cachedFetch(url) {
-    // Try Cache API first
-    if (typeof caches !== "undefined") {
-        try {
-            const cache = await caches.open(CACHE_NAME);
-            const cached = await cache.match(url);
-            if (cached) {
-                return cached.arrayBuffer();
-            }
-            const response = await fetch(url);
-            if (response.ok) {
-                // Clone before reading so we can store the clone
-                await cache.put(url, response.clone());
-            }
-            return response.arrayBuffer();
-        }
-        catch {
-            // Cache API failed (e.g. quota exceeded, private mode) — fall through
-        }
-    }
-    // Fallback: plain fetch
-    const response = await fetch(url);
-    return response.arrayBuffer();
-}
 async function fetchManifest(baseUrl) {
     const url = `${baseUrl}/puzzles/cube3/solver/generated/manifest.json`;
     const response = await fetch(url);
@@ -92,8 +70,7 @@ async function fetchManifest(baseUrl) {
     return manifest;
 }
 async function fetchMoveTable(baseUrl, entry) {
-    const url = `${baseUrl}/puzzles/cube3/solver/generated/${entry.file}`;
-    const buffer = await cachedFetch(url);
+    const buffer = await (0, compressed_fetch_js_1.fetchTableBuffer)(baseUrl, TABLES_DIR, entry.file, { cacheName: CACHE_NAME, compressed: entry.compressed !== false });
     const expectedBytes = entry.range * entry.moves.length * 4;
     if (buffer.byteLength !== expectedBytes) {
         throw new Error(`Invalid byte size for ${entry.coordinate} move table.`);
@@ -113,8 +90,7 @@ async function fetchMoveTable(baseUrl, entry) {
     };
 }
 async function fetchPruningTable(baseUrl, entry) {
-    const url = `${baseUrl}/puzzles/cube3/solver/generated/${entry.file}`;
-    const buffer = await cachedFetch(url);
+    const buffer = await (0, compressed_fetch_js_1.fetchTableBuffer)(baseUrl, TABLES_DIR, entry.file, { cacheName: CACHE_NAME, compressed: entry.compressed !== false });
     const expectedBytes = Math.ceil(entry.range / 2);
     if (buffer.byteLength !== expectedBytes) {
         throw new Error(`Invalid byte size for ${entry.coordinate} pruning table.`);

package/dist-cjs/puzzles/cube4/index.js

@@ -3,7 +3,10 @@
 // cube4 barrel exports
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCube4FaceOrder = exports.formatCube4Facelets = exports.toCube4Facelets = exports.generateCube4Scramble = exports.cube4ScrambleGenerator = exports.FACE_MOVE_EFFECTS = exports.parseMove = exports.parseCube4Move = exports.parseCube4Algorithm = exports.formatCube4Algorithm = exports.invertCube4Algorithm = exports.invertCube4Move = exports.applyCube4Algorithm = exports.applyCube4Move = exports.areWingsPaired = exports.areCentersReduced = exports.isSolvedCube4State = exports.cube4StatesEqual = exports.cloneCube4State = exports.createSolvedCube4State = exports.CUBE4_OUTER_MOVES = exports.CUBE4_ALL_MOVES = exports.CUBE4_FACE_MOVES = exports.B = exports.L = exports.D = exports.F = exports.R = exports.U = exports.CENTERS_PER_FACE = exports.FACE_COUNT = exports.CENTER_COUNT = exports.WING_COUNT = exports.CORNER_COUNT = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.getCube4FaceOrder = exports.formatCube4Facelets = exports.toCube4Facelets = exports.generateCube4Scramble = exports.cube4ScrambleGenerator = exports.FACE_MOVE_EFFECTS = exports.parseMove = exports.parseCube4Move = exports.parseCube4Algorithm = exports.formatCube4Algorithm = exports.invertCube4Algorithm = exports.invertCube4Move = exports.applyCube4Algorithm = exports.applyCube4Move = exports.areWingsPaired = exports.areCentersReduced = exports.isSolvedCube4State = exports.cube4StatesEqual = exports.cloneCube4State = exports.createSolvedCube4State = exports.CUBE4_OUTER_MOVES = exports.CUBE4_ALL_MOVES = exports.CUBE4_FACE_MOVES = exports.B = exports.L = exports.D = exports.F = exports.R = exports.U = exports.CENTERS_PER_FACE = exports.FACE_COUNT = exports.CENTER_COUNT = exports.WING_COUNT = exports.CORNER_COUNT = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.cube4ScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CORNER_COUNT", { enumerable: true, get: function () { return types_js_1.CORNER_COUNT; } });
 Object.defineProperty(exports, "WING_COUNT", { enumerable: true, get: function () { return types_js_1.WING_COUNT; } });
@@ -36,10 +39,16 @@ Object.defineProperty(exports, "parseCube4Algorithm", { enumerable: true, get: f
 Object.defineProperty(exports, "parseCube4Move", { enumerable: true, get: function () { return moves_js_1.parseCube4Move; } });
 Object.defineProperty(exports, "parseMove", { enumerable: true, get: function () { return moves_js_1.parseMove; } });
 Object.defineProperty(exports, "FACE_MOVE_EFFECTS", { enumerable: true, get: function () { return moves_js_1.FACE_MOVE_EFFECTS; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "cube4ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.cube4ScrambleGenerator; } });
-Object.defineProperty(exports, "generateCube4Scramble", { enumerable: true, get: function () { return scrambler_js_1.generateCube4Scramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "cube4ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.cube4ScrambleGenerator; } });
+Object.defineProperty(exports, "generateCube4Scramble", { enumerable: true, get: function () { return scrambler_js_2.generateCube4Scramble; } });
 var facelets_js_1 = require("./facelets.js");
 Object.defineProperty(exports, "toCube4Facelets", { enumerable: true, get: function () { return facelets_js_1.toCube4Facelets; } });
 Object.defineProperty(exports, "formatCube4Facelets", { enumerable: true, get: function () { return facelets_js_1.formatCube4Facelets; } });
 Object.defineProperty(exports, "getCube4FaceOrder", { enumerable: true, get: function () { return facelets_js_1.getCube4FaceOrder; } });
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/cube5x5/index.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCube5Scramble = exports.cube5ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE5_ALL_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.generateCube5Scramble = exports.cube5ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE5_ALL_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.cube5ScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CUBE5_ALL_MOVES", { enumerable: true, get: function () { return types_js_1.CUBE5_ALL_MOVES; } });
 Object.defineProperty(exports, "SCRAMBLE_LENGTH", { enumerable: true, get: function () { return types_js_1.SCRAMBLE_LENGTH; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "cube5ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.cube5ScrambleGenerator; } });
-Object.defineProperty(exports, "generateCube5Scramble", { enumerable: true, get: function () { return scrambler_js_1.generateCube5Scramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "cube5ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.cube5ScrambleGenerator; } });
+Object.defineProperty(exports, "generateCube5Scramble", { enumerable: true, get: function () { return scrambler_js_2.generateCube5Scramble; } });
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/cube6x6/index.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCube6Scramble = exports.cube6ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE6_ALL_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.generateCube6Scramble = exports.cube6ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE6_ALL_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.cube6ScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CUBE6_ALL_MOVES", { enumerable: true, get: function () { return types_js_1.CUBE6_ALL_MOVES; } });
 Object.defineProperty(exports, "SCRAMBLE_LENGTH", { enumerable: true, get: function () { return types_js_1.SCRAMBLE_LENGTH; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "cube6ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.cube6ScrambleGenerator; } });
-Object.defineProperty(exports, "generateCube6Scramble", { enumerable: true, get: function () { return scrambler_js_1.generateCube6Scramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "cube6ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.cube6ScrambleGenerator; } });
+Object.defineProperty(exports, "generateCube6Scramble", { enumerable: true, get: function () { return scrambler_js_2.generateCube6Scramble; } });
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/cube7x7/index.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCube7Scramble = exports.cube7ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE7_ALL_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.generateCube7Scramble = exports.cube7ScrambleGenerator = exports.SCRAMBLE_LENGTH = exports.CUBE7_ALL_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.cube7ScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CUBE7_ALL_MOVES", { enumerable: true, get: function () { return types_js_1.CUBE7_ALL_MOVES; } });
 Object.defineProperty(exports, "SCRAMBLE_LENGTH", { enumerable: true, get: function () { return types_js_1.SCRAMBLE_LENGTH; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "cube7ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.cube7ScrambleGenerator; } });
-Object.defineProperty(exports, "generateCube7Scramble", { enumerable: true, get: function () { return scrambler_js_1.generateCube7Scramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "cube7ScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.cube7ScrambleGenerator; } });
+Object.defineProperty(exports, "generateCube7Scramble", { enumerable: true, get: function () { return scrambler_js_2.generateCube7Scramble; } });
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/megaminx/index.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMegaminxScramble = exports.megaminxScrambleGenerator = exports.MOVES_PER_LINE = exports.SCRAMBLE_LINES = exports.MEGAMINX_D_MOVES = exports.MEGAMINX_R_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.generateMegaminxScramble = exports.megaminxScrambleGenerator = exports.MOVES_PER_LINE = exports.SCRAMBLE_LINES = exports.MEGAMINX_D_MOVES = exports.MEGAMINX_R_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.megaminxScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "MEGAMINX_R_MOVES", { enumerable: true, get: function () { return types_js_1.MEGAMINX_R_MOVES; } });
 Object.defineProperty(exports, "MEGAMINX_D_MOVES", { enumerable: true, get: function () { return types_js_1.MEGAMINX_D_MOVES; } });
 Object.defineProperty(exports, "SCRAMBLE_LINES", { enumerable: true, get: function () { return types_js_1.SCRAMBLE_LINES; } });
 Object.defineProperty(exports, "MOVES_PER_LINE", { enumerable: true, get: function () { return types_js_1.MOVES_PER_LINE; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "megaminxScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.megaminxScrambleGenerator; } });
-Object.defineProperty(exports, "generateMegaminxScramble", { enumerable: true, get: function () { return scrambler_js_1.generateMegaminxScramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "megaminxScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.megaminxScrambleGenerator; } });
+Object.defineProperty(exports, "generateMegaminxScramble", { enumerable: true, get: function () { return scrambler_js_2.generateMegaminxScramble; } });
+var index_js_2 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_2.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_2.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_2.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_2.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_2.initializeScrambler; } });

package/dist-cjs/puzzles/pyraminx/index.js

@@ -1,6 +1,42 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.solvePyraminx = exports.toPyraminxFacelets = exports.getPyraminxFaceOrder = exports.formatPyraminxFacelets = exports.createSolvedPyraminxFacelets = exports.generatePyraminxScramble = exports.pyraminxScrambleGenerator = exports.generateRandomPyraminxState = exports.isAllowedRandomPyraminxState = exports.validatePyraminxState = exports.permutationParity = exports.isSolvedPyraminxState = exports.pyraminxStatesEqual = exports.createSolvedPyraminxState = exports.clonePyraminxState = exports.parsePyraminxMove = exports.parsePyraminxAlgorithm = exports.invertPyraminxMove = exports.invertPyraminxAlgorithm = exports.formatPyraminxAlgorithm = exports.applyPyraminxMove = exports.applyPyraminxAlgorithm = exports.PYRAMINX_TIPS = exports.PYRAMINX_CORE_MOVES = void 0;
+exports.initializeScrambler = exports.getSupportedEvents = exports.getEventInfo = exports.generateScrambles = exports.generateScramble = exports.solver = exports.solvePyraminxWithInfo = exports.solvePyraminx = exports.toPyraminxFacelets = exports.getPyraminxFaceOrder = exports.formatPyraminxFacelets = exports.createSolvedPyraminxFacelets = exports.generatePyraminxScramble = exports.pyraminxScrambleGenerator = exports.generateRandomPyraminxState = exports.isAllowedRandomPyraminxState = exports.validatePyraminxState = exports.permutationParity = exports.isSolvedPyraminxState = exports.pyraminxStatesEqual = exports.createSolvedPyraminxState = exports.clonePyraminxState = exports.parsePyraminxMove = exports.parsePyraminxAlgorithm = exports.invertPyraminxMove = exports.invertPyraminxAlgorithm = exports.formatPyraminxAlgorithm = exports.applyPyraminxMove = exports.applyPyraminxAlgorithm = exports.PYRAMINX_TIPS = exports.PYRAMINX_CORE_MOVES = void 0;
+const index_js_1 = require("../../core/index.js");
+const scrambler_js_1 = require("./scrambler.js");
+(0, index_js_1.registerScrambleGenerator)(scrambler_js_1.pyraminxScrambleGenerator);
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "PYRAMINX_CORE_MOVES", { enumerable: true, get: function () { return types_js_1.PYRAMINX_CORE_MOVES; } });
 Object.defineProperty(exports, "PYRAMINX_TIPS", { enumerable: true, get: function () { return types_js_1.PYRAMINX_TIPS; } });
@@ -23,13 +59,21 @@ Object.defineProperty(exports, "validatePyraminxState", { enumerable: true, get:
 Object.defineProperty(exports, "isAllowedRandomPyraminxState", { enumerable: true, get: function () { return validation_js_1.isAllowedRandomPyraminxState; } });
 var random_state_js_1 = require("./random-state.js");
 Object.defineProperty(exports, "generateRandomPyraminxState", { enumerable: true, get: function () { return random_state_js_1.generateRandomPyraminxState; } });
-var scrambler_js_1 = require("./scrambler.js");
-Object.defineProperty(exports, "pyraminxScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_1.pyraminxScrambleGenerator; } });
-Object.defineProperty(exports, "generatePyraminxScramble", { enumerable: true, get: function () { return scrambler_js_1.generatePyraminxScramble; } });
+var scrambler_js_2 = require("./scrambler.js");
+Object.defineProperty(exports, "pyraminxScrambleGenerator", { enumerable: true, get: function () { return scrambler_js_2.pyraminxScrambleGenerator; } });
+Object.defineProperty(exports, "generatePyraminxScramble", { enumerable: true, get: function () { return scrambler_js_2.generatePyraminxScramble; } });
 var facelets_js_1 = require("./facelets.js");
 Object.defineProperty(exports, "createSolvedPyraminxFacelets", { enumerable: true, get: function () { return facelets_js_1.createSolvedPyraminxFacelets; } });
 Object.defineProperty(exports, "formatPyraminxFacelets", { enumerable: true, get: function () { return facelets_js_1.formatPyraminxFacelets; } });
 Object.defineProperty(exports, "getPyraminxFaceOrder", { enumerable: true, get: function () { return facelets_js_1.getPyraminxFaceOrder; } });
 Object.defineProperty(exports, "toPyraminxFacelets", { enumerable: true, get: function () { return facelets_js_1.toPyraminxFacelets; } });
-var solver_js_1 = require("./solver.js");
-Object.defineProperty(exports, "solvePyraminx", { enumerable: true, get: function () { return solver_js_1.solvePyraminx; } });
+var index_js_2 = require("./solver/index.js");
+Object.defineProperty(exports, "solvePyraminx", { enumerable: true, get: function () { return index_js_2.solvePyraminx; } });
+Object.defineProperty(exports, "solvePyraminxWithInfo", { enumerable: true, get: function () { return index_js_2.solvePyraminxWithInfo; } });
+exports.solver = __importStar(require("./solver/index.js"));
+var index_js_3 = require("../../core/index.js");
+Object.defineProperty(exports, "generateScramble", { enumerable: true, get: function () { return index_js_3.generateScramble; } });
+Object.defineProperty(exports, "generateScrambles", { enumerable: true, get: function () { return index_js_3.generateScrambles; } });
+Object.defineProperty(exports, "getEventInfo", { enumerable: true, get: function () { return index_js_3.getEventInfo; } });
+Object.defineProperty(exports, "getSupportedEvents", { enumerable: true, get: function () { return index_js_3.getSupportedEvents; } });
+Object.defineProperty(exports, "initializeScrambler", { enumerable: true, get: function () { return index_js_3.initializeScrambler; } });

package/dist-cjs/puzzles/pyraminx/scrambler.js

@@ -3,18 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pyraminxScrambleGenerator = void 0;
 exports.generatePyraminxScramble = generatePyraminxScramble;
 const random_state_js_1 = require("./random-state.js");
-const state_js_1 = require("./state.js");
 const moves_js_1 = require("./moves.js");
-const solver_js_1 = require("./solver.js");
+const index_js_1 = require("./solver/index.js");
 const facelets_js_1 = require("./facelets.js");
+const types_js_1 = require("./types.js");
+// Face -> tip index (U,L,R,B order, same as PYRAMINX_TIPS).
+const FACE_TIP_INDEX = { U: 0, L: 1, R: 2, B: 3 };
 exports.pyraminxScrambleGenerator = {
     info: {
         eventId: "pymx",
         name: "Pyraminx",
         puzzle: "pyraminx",
         quality: "random-state",
-        generator: "pyraminx-ida-star",
-        description: "Random-state Pyraminx scramble generated by an optimal bidirectional BFS solver."
+        generator: "pyraminx-optimal",
+        description: "Random-state Pyraminx scramble generated by an optimal solver with precalculated tables."
     },
     generate(options = {}) {
         return generatePyraminxScramble(options);
@@ -23,30 +25,32 @@ exports.pyraminxScrambleGenerator = {
 async function generatePyraminxScramble(options = {}) {
     const state = (0, random_state_js_1.generateRandomPyraminxState)(options);
     // Solve the core edges and centers
-    const solution = (0, solver_js_1.solvePyraminx)(state);
+    const solution = await (0, index_js_1.solvePyraminx)(state);
     const scrambleMoves = (0, moves_js_1.invertPyraminxAlgorithm)(solution);
     // Append tips: layer moves already rotate tips, so we need the delta
     // between the target tips and the tips produced by the core scramble.
-    const coreState = (0, moves_js_1.applyPyraminxAlgorithm)((0, state_js_1.createSolvedPyraminxState)(), scrambleMoves);
+    // Computed arithmetically from the move sequence (no state replay).
+    const coreTips = [0, 0, 0, 0];
+    for (const move of scrambleMoves) {
+        const isInverse = move.endsWith("'");
+        const face = isInverse ? move.slice(0, -1) : move;
+        const tipIndex = FACE_TIP_INDEX[face];
+        if (tipIndex !== undefined) {
+            coreTips[tipIndex] = (coreTips[tipIndex] + (isInverse ? 2 : 1)) % 3;
+        }
+    }
     const finalMoves = [...scrambleMoves];
-    const tipsNotation = ["u", "l", "r", "b"];
     for (let i = 0; i < 4; i++) {
-        const delta = (state.tips[i] - coreState.tips[i] + 3) % 3;
+        const delta = (state.tips[i] - coreTips[i] + 3) % 3;
         if (delta === 1) {
-            finalMoves.push(tipsNotation[i]);
+            finalMoves.push(types_js_1.PYRAMINX_TIPS[i]);
         }
         else if (delta === 2) {
-            finalMoves.push(`${tipsNotation[i]}'`);
+            finalMoves.push(`${types_js_1.PYRAMINX_TIPS[i]}'`);
         }
     }
-    if (!options.skipValidation) {
-        const scrambledState = (0, moves_js_1.applyPyraminxAlgorithm)((0, state_js_1.createSolvedPyraminxState)(), finalMoves);
-        if (scrambledState.edgesPerm.toString() !== state.edgesPerm.toString() ||
-            scrambledState.edgesOrient.toString() !== state.edgesOrient.toString() ||
-            scrambledState.centers.toString() !== state.centers.toString() ||
-            scrambledState.tips.toString() !== state.tips.toString()) {
-            throw new Error("Generated Pyraminx scramble does not reproduce the target random state.");
-        }
+    if (!options.skipValidation && !(0, index_js_1.verifyPyraminxScramble)(state, finalMoves)) {
+        throw new Error("Generated Pyraminx scramble does not reproduce the target random state.");
     }
     const facelets = (0, facelets_js_1.toPyraminxFacelets)(state);
     return {
@@ -54,7 +58,7 @@ async function generatePyraminxScramble(options = {}) {
         scramble: finalMoves.join(" "),
         moves: finalMoves,
         quality: "random-state",
-        generator: "pyraminx-ida-star",
+        generator: "pyraminx-optimal",
         metadata: {
             state,
             facelets,

package/dist-cjs/puzzles/pyraminx/solver/browser-loader.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedBrowserTables = getCachedBrowserTables;
+exports.clearCachedBrowserTables = clearCachedBrowserTables;
+exports.loadBrowserTables = loadBrowserTables;
+const table_metadata_js_1 = require("./table-metadata.js");
+const compressed_fetch_js_1 = require("../../shared/compressed-fetch.js");
+let cachedBrowserTables;
+function getCachedBrowserTables() {
+    return cachedBrowserTables;
+}
+function clearCachedBrowserTables() {
+    cachedBrowserTables = undefined;
+}
+async function loadBrowserTables(baseUrl) {
+    if (cachedBrowserTables)
+        return cachedBrowserTables;
+    const resolved = resolveBaseUrl(baseUrl);
+    const manifest = await fetchManifest(resolved);
+    const [centersTable, permutationTable, orientationTable, policyTable] = await Promise.all([
+        fetchUint8Table(resolved, manifest.files.centersTable, table_metadata_js_1.PYRAMINX_SOLVER_TABLE_METADATA.centersTable.entries),
+        fetchUint16Table(resolved, manifest.files.permutationTable, table_metadata_js_1.PYRAMINX_SOLVER_TABLE_METADATA.permutationTable.entries),
+        fetchUint8Table(resolved, manifest.files.orientationTable, table_metadata_js_1.PYRAMINX_SOLVER_TABLE_METADATA.orientationTable.entries),
+        fetchUint8Table(resolved, manifest.files.policyTable, table_metadata_js_1.PYRAMINX_SOLVER_TABLE_METADATA.policyTable.entries)
+    ]);
+    cachedBrowserTables = { centersTable, permutationTable, orientationTable, policyTable };
+    return cachedBrowserTables;
+}
+function resolveBaseUrl(provided) {
+    if (provided)
+        return provided.replace(/\/$/, "");
+    if (typeof document !== "undefined") {
+        const script = document.currentScript;
+        if (script?.src) {
+            const base = new URL(".", script.src).href;
+            return base.replace(/\/$/, "");
+        }
+    }
+    return ".";
+}
+async function fetchManifest(baseUrl) {
+    const url = `${baseUrl}/puzzles/pyraminx/solver/generated/manifest.json`;
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`Failed to load pyraminx solver table manifest from ${url}: ${response.status} ${response.statusText}`);
+    const manifest = (await response.json());
+    if (manifest.version !== 1)
+        throw new Error(`Unsupported pyraminx solver table manifest version: ${manifest.version}`);
+    return manifest;
+}
+const TABLES_DIR = "puzzles/pyraminx/solver/generated";
+const CACHE_NAME = "cubingcenter-scrambler-tables-v1";
+async function fetchUint8Table(baseUrl, entry, expectedEntries) {
+    const buffer = await (0, compressed_fetch_js_1.fetchTableBuffer)(baseUrl, TABLES_DIR, entry.file, { cacheName: CACHE_NAME, compressed: entry.compressed !== false });
+    if (buffer.byteLength !== expectedEntries)
+        throw new Error(`Invalid byte size for ${entry.file}`);
+    return new Uint8Array(buffer);
+}
+async function fetchUint16Table(baseUrl, entry, expectedEntries) {
+    const buffer = await (0, compressed_fetch_js_1.fetchTableBuffer)(baseUrl, TABLES_DIR, entry.file, { cacheName: CACHE_NAME, compressed: entry.compressed !== false });
+    if (buffer.byteLength !== expectedEntries * 2)
+        throw new Error(`Invalid byte size for ${entry.file}`);
+    const values = new Uint16Array(expectedEntries);
+    const view = new DataView(buffer);
+    for (let i = 0; i < values.length; i++)
+        values[i] = view.getUint16(i * 2, true);
+    return values;
+}

package/dist-cjs/puzzles/pyraminx/solver/generated/manifest.json

@@ -0,0 +1,26 @@
+{
+  "version": 1,
+  "files": {
+    "centersTable": {
+      "file": "centers-table.bin",
+      "entries": 648,
+      "checksum": 4058180805
+    },
+    "permutationTable": {
+      "file": "permutation-table.bin",
+      "entries": 2880,
+      "checksum": 4161414597
+    },
+    "orientationTable": {
+      "file": "orientation-table.bin",
+      "entries": 256,
+      "checksum": 3608176069
+    },
+    "policyTable": {
+      "file": "policy.bin",
+      "entries": 349920,
+      "checksum": 4047562730,
+      "maxDepth": 11
+    }
+  }
+}

package/dist-cjs/puzzles/pyraminx/solver/generated-assets.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGeneratedPyraminxSolverTables = loadGeneratedPyraminxSolverTables;
+const browser_loader_js_1 = require("./browser-loader.js");
+let cachedTables;
+function isBrowser() {
+    return typeof self !== "undefined";
+}
+async function loadGeneratedPyraminxSolverTables() {
+    if (isBrowser()) {
+        const browserTables = (0, browser_loader_js_1.getCachedBrowserTables)();
+        if (browserTables)
+            return browserTables;
+        throw new Error("Pyraminx solver tables are not loaded. " +
+            "In browser environments, call `initializeScrambler(baseUrl)` " +
+            "before generating scrambles.");
+    }
+    cachedTables ??= await loadNodeTables();
+    return cachedTables;
+}
+async function loadNodeTables() {
+    const loader = await Promise.resolve().then(() => __importStar(require(
+    /* webpackIgnore: true */
+    /* @vite-ignore */
+    "./node-loader.js")));
+    return loader.readGeneratedPyraminxSolverTables();
+}

package/dist-cjs/puzzles/pyraminx/solver/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGeneratedPyraminxSolverTables = exports.PYRAMINX_SOLVER_TABLE_METADATA = void 0;
+__exportStar(require("./tables.js"), exports);
+__exportStar(require("./search.js"), exports);
+var table_metadata_js_1 = require("./table-metadata.js");
+Object.defineProperty(exports, "PYRAMINX_SOLVER_TABLE_METADATA", { enumerable: true, get: function () { return table_metadata_js_1.PYRAMINX_SOLVER_TABLE_METADATA; } });
+var generated_assets_js_1 = require("./generated-assets.js");
+Object.defineProperty(exports, "loadGeneratedPyraminxSolverTables", { enumerable: true, get: function () { return generated_assets_js_1.loadGeneratedPyraminxSolverTables; } });