@cubingcenter/scrambler 0.6.3 → 0.8.0

package/dist/puzzles/cube4/worker-protocol.js

@@ -0,0 +1,58 @@
+/**
+ * Message protocol shared by the 4x4 Node worker (`worker.ts`), its pool
+ * (`worker-pool.ts`), and the browser equivalents (`browser-worker.ts`,
+ * `browser-worker-pool.ts`).
+ *
+ * Design notes:
+ *  - Tasks carry the FULL `generateCube4Scramble` options object. The
+ *    scrambler is a pure function of (seed, complete options), so forwarding
+ *    every option verbatim is what makes the pool output bit-identical to
+ *    the inline path for the same inputs.
+ *  - Errors cross the thread boundary as data (`Cube4SerializedError`):
+ *    `name`, `message`, `code` and `stack` survive, so typed solver errors
+ *    (e.g. `Cube4TargetMismatchError` with `code: "cube4-target-mismatch"`)
+ *    remain discriminated on the consumer side by name/code — the same
+ *    classification keys `scrambler.ts` itself uses. Classes cannot be
+ *    structured-cloned, so `instanceof` does not cross the boundary
+ *    (documented contract).
+ *
+ * This module is deliberately free of runtime imports (type-only imports
+ * are erased at emit) so it can be bundled for the browser worker without
+ * dragging Node-only code into the graph.
+ */
+/**
+ * Flattens an unknown thrown value into the structured-clone-safe shape
+ * above. Non-Error values are stringified so nothing is lost silently.
+ */
+export function serializeCube4Error(error) {
+    if (error instanceof Error) {
+        const code = error.code;
+        const primitiveCode = typeof code === "string" || typeof code === "number" ? code : undefined;
+        const serialized = {
+            name: error.name,
+            message: error.message
+        };
+        if (primitiveCode !== undefined)
+            serialized.code = primitiveCode;
+        if (typeof error.stack === "string")
+            serialized.stack = error.stack;
+        return serialized;
+    }
+    return { name: "Error", message: String(error) };
+}
+/**
+ * Rebuilds an Error from the wire shape, restoring `name`, `code` and
+ * `stack` (stack kept only as a debugging aid — its file locations point
+ * into the worker thread).
+ */
+export function deserializeCube4Error(serialized) {
+    const error = new Error(serialized.message);
+    error.name = serialized.name;
+    if (serialized.code !== undefined) {
+        error.code = serialized.code;
+    }
+    if (serialized.stack !== undefined) {
+        error.stack = serialized.stack;
+    }
+    return error;
+}

package/dist/puzzles/cube4/worker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Node.js worker_thread entry for 4x4 scramble generation.
+ *
+ * Lifecycle / lazy init: the thread boots without doing any work; the
+ * reduction + 3x3 tables (≈37 MB) are loaded on the FIRST task and then
+ * reused for every later task, because `scrambler.ts` deduplicates table
+ * loads per thread via its promise cache. Spawning is driven lazily by
+ * `worker-pool.ts` (one thread per queued job, up to the pool size), so a
+ * small batch never pays for idle threads.
+ *
+ * Protocol: see `worker-protocol.ts`. One task in flight per thread (the
+ * pool only re-dispatches after a response), but the handler is written to
+ * cope with concurrent messages just in case.
+ *
+ * Source-vs-dist loading: this file is excluded from the CommonJS build,
+ * so `import.meta` is safe here. When running from source the thread is
+ * booted with `execArgv: ["--import", "tsx"]` by the pool, but that flag
+ * alone does NOT register tsx's resolve hooks inside a worker thread
+ * (measured: `./x.js` → `./x.ts` mapping missing). Therefore, before any
+ * value import of the repo's `.js`-suffixed specifiers, we register the
+ * tsx hooks explicitly — `tsx/esm/api` resolves because source mode only
+ * happens inside a checkout with node_modules. From `dist/` no tsx is
+ * involved: the `.js` files are real.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/puzzles/cube4/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube4/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/puzzles/cube4/worker.js

@@ -0,0 +1,49 @@
+/**
+ * Node.js worker_thread entry for 4x4 scramble generation.
+ *
+ * Lifecycle / lazy init: the thread boots without doing any work; the
+ * reduction + 3x3 tables (≈37 MB) are loaded on the FIRST task and then
+ * reused for every later task, because `scrambler.ts` deduplicates table
+ * loads per thread via its promise cache. Spawning is driven lazily by
+ * `worker-pool.ts` (one thread per queued job, up to the pool size), so a
+ * small batch never pays for idle threads.
+ *
+ * Protocol: see `worker-protocol.ts`. One task in flight per thread (the
+ * pool only re-dispatches after a response), but the handler is written to
+ * cope with concurrent messages just in case.
+ *
+ * Source-vs-dist loading: this file is excluded from the CommonJS build,
+ * so `import.meta` is safe here. When running from source the thread is
+ * booted with `execArgv: ["--import", "tsx"]` by the pool, but that flag
+ * alone does NOT register tsx's resolve hooks inside a worker thread
+ * (measured: `./x.js` → `./x.ts` mapping missing). Therefore, before any
+ * value import of the repo's `.js`-suffixed specifiers, we register the
+ * tsx hooks explicitly — `tsx/esm/api` resolves because source mode only
+ * happens inside a checkout with node_modules. From `dist/` no tsx is
+ * involved: the `.js` files are real.
+ */
+import { parentPort } from "node:worker_threads";
+if (!parentPort) {
+    throw new Error("[cube4] worker.ts must be started as a worker_thread (use Cube4WorkerPool).");
+}
+const port = parentPort;
+if (import.meta.url.endsWith(".ts")) {
+    const tsxApi = await import("tsx/esm/api");
+    tsxApi.register();
+}
+const { generateCube4Scramble } = await import("./scrambler.js");
+const { serializeCube4Error } = await import("./worker-protocol.js");
+port.on("message", (task) => {
+    void (async () => {
+        const response = await (async () => {
+            try {
+                const result = await generateCube4Scramble(task.options);
+                return { id: task.id, ok: true, result };
+            }
+            catch (error) {
+                return { id: task.id, ok: false, error: serializeCube4Error(error) };
+            }
+        })();
+        port.postMessage(response);
+    })();
+});

package/dist/puzzles/pyraminx/solver/browser-loader.d.ts

@@ -1,14 +1,10 @@
-export declare function getCachedBrowserTables(): {
+export interface PyraminxBrowserTables {
     centersTable: Uint8Array;
     permutationTable: Uint16Array;
     orientationTable: Uint8Array;
     policyTable: Uint8Array;
-} | undefined;
+}
+export declare function getCachedBrowserTables(): PyraminxBrowserTables | undefined;
 export declare function clearCachedBrowserTables(): void;
-export declare function loadBrowserTables(baseUrl?: string): Promise<{
-    centersTable: Uint8Array;
-    permutationTable: Uint16Array;
-    orientationTable: Uint8Array;
-    policyTable: Uint8Array;
-}>;
+export declare function loadBrowserTables(baseUrl?: string): Promise<PyraminxBrowserTables>;
 //# sourceMappingURL=browser-loader.d.ts.map

package/dist/puzzles/pyraminx/solver/browser-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/browser-loader.ts"],"names":[],"mappings":"AAUA,wBAAgB,sBAAsB;kBANtB,UAAU;sBACN,WAAW;sBACX,UAAU;iBACf,UAAU;cAKxB;AACD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,YAAY,EAAE,UAAU,CAAC;IACzB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC,CAYD"}
+{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/browser-loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,UAAU,CAAC;IACzB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,WAAW,EAAE,UAAU,CAAC;CACzB;AAKD,wBAAgB,sBAAsB,IAAI,qBAAqB,GAAG,SAAS,CAE1E;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAkBxF"}

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

@@ -1,22 +1,42 @@
 import { PYRAMINX_SOLVER_TABLE_METADATA } from "./table-metadata.js";
 import { fetchTableBuffer as fetchCompressedTableBuffer } from "../../shared/compressed-fetch.js";
+const TABLES_DIR = "puzzles/pyraminx/solver/generated";
+const CACHE_NAME = "cubingcenter-scrambler-tables-v1";
 let cachedBrowserTables;
+let cachedBrowserTablesPromise;
 export function getCachedBrowserTables() {
     return cachedBrowserTables;
 }
 export function clearCachedBrowserTables() {
     cachedBrowserTables = undefined;
+    cachedBrowserTablesPromise = undefined;
 }
 export async function loadBrowserTables(baseUrl) {
     if (cachedBrowserTables)
         return cachedBrowserTables;
+    if (cachedBrowserTablesPromise) {
+        // One shared in-flight promise: concurrent calls trigger exactly one
+        // fetch pass (dedup).
+        return cachedBrowserTablesPromise;
+    }
+    const promise = fetchTables(baseUrl);
+    cachedBrowserTablesPromise = promise;
+    promise.then(() => { }, () => {
+        // A failed load must not poison the dedup slot: purge the rejected
+        // promise so a later call retries from scratch.
+        if (cachedBrowserTablesPromise === promise)
+            cachedBrowserTablesPromise = undefined;
+    });
+    return promise;
+}
+async function fetchTables(baseUrl) {
     const resolved = resolveBaseUrl(baseUrl);
     const manifest = await fetchManifest(resolved);
     const [centersTable, permutationTable, orientationTable, policyTable] = await Promise.all([
-        fetchUint8Table(resolved, manifest.files.centersTable, PYRAMINX_SOLVER_TABLE_METADATA.centersTable.entries),
-        fetchUint16Table(resolved, manifest.files.permutationTable, PYRAMINX_SOLVER_TABLE_METADATA.permutationTable.entries),
-        fetchUint8Table(resolved, manifest.files.orientationTable, PYRAMINX_SOLVER_TABLE_METADATA.orientationTable.entries),
-        fetchUint8Table(resolved, manifest.files.policyTable, PYRAMINX_SOLVER_TABLE_METADATA.policyTable.entries)
+        fetchUint8Table(resolved, manifest.files.centersTable, PYRAMINX_SOLVER_TABLE_METADATA.centersTable),
+        fetchUint16Table(resolved, manifest.files.permutationTable, PYRAMINX_SOLVER_TABLE_METADATA.permutationTable),
+        fetchUint8Table(resolved, manifest.files.orientationTable, PYRAMINX_SOLVER_TABLE_METADATA.orientationTable),
+        fetchUint8Table(resolved, manifest.files.policyTable, PYRAMINX_SOLVER_TABLE_METADATA.policyTable)
     ]);
     cachedBrowserTables = { centersTable, permutationTable, orientationTable, policyTable };
     return cachedBrowserTables;
@@ -43,19 +63,28 @@ async function fetchManifest(baseUrl) {
         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 fetchCompressedTableBuffer(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}`);
+/**
+ * Fetch + verify with the SAME checks as node-loader.ts: byte length from
+ * the manifest entries, FNV-1a checksum against the table-metadata
+ * constants (the values node asserts against).
+ */
+async function fetchUint8Table(baseUrl, entry, meta) {
+    const buffer = await fetchCompressedTableBuffer(baseUrl, TABLES_DIR, entry.file, {
+        cacheName: CACHE_NAME,
+        compressed: entry.compressed !== false,
+        expectedBytes: entry.entries,
+        expectedFnv1a: { value: meta.checksum, elementSize: 1 }
+    });
     return new Uint8Array(buffer);
 }
-async function fetchUint16Table(baseUrl, entry, expectedEntries) {
-    const buffer = await fetchCompressedTableBuffer(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);
+async function fetchUint16Table(baseUrl, entry, meta) {
+    const buffer = await fetchCompressedTableBuffer(baseUrl, TABLES_DIR, entry.file, {
+        cacheName: CACHE_NAME,
+        compressed: entry.compressed !== false,
+        expectedBytes: entry.entries * 2,
+        expectedFnv1a: { value: meta.checksum, elementSize: 2 }
+    });
+    const values = new Uint16Array(entry.entries);
     const view = new DataView(buffer);
     for (let i = 0; i < values.length; i++)
         values[i] = view.getUint16(i * 2, true);

package/dist/puzzles/pyraminx/solver/generated-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-assets.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/generated-assets.ts"],"names":[],"mappings":"AAaA,wBAAsB,iCAAiC,IAAI,OAAO,CAAC;IACjE,YAAY,EAAE,UAAU,CAAC;IACzB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC,CAYD"}
+{"version":3,"file":"generated-assets.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/generated-assets.ts"],"names":[],"mappings":"AAmBA,wBAAsB,iCAAiC,IAAI,OAAO,CAAC;IACjE,YAAY,EAAE,UAAU,CAAC;IACzB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC,CAWD"}

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

@@ -1,5 +1,11 @@
 import { getCachedBrowserTables } from "./browser-loader.js";
-let cachedTables;
+import { loadOnce } from "../../shared/load-once.js";
+// One shared in-flight promise for the node fs load (same pattern as
+// cube3/solver/generated-assets.ts): the previous `cached ??= await …` raced —
+// concurrent callers interleaving on the await both ran `loadNodeTables()`
+// (two filesystem reads, last assignment wins). On rejection the slot is
+// purged so the next call can retry.
+const nodeTablesSlot = { promise: undefined };
 function isBrowser() {
     return typeof self !== "undefined";
 }
@@ -12,8 +18,7 @@ export async function loadGeneratedPyraminxSolverTables() {
             "In browser environments, call `initializeScrambler(baseUrl)` " +
             "before generating scrambles.");
     }
-    cachedTables ??= await loadNodeTables();
-    return cachedTables;
+    return loadOnce(nodeTablesSlot, loadNodeTables);
 }
 async function loadNodeTables() {
     const loader = await import(

package/dist/puzzles/pyraminx/solver/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAe/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGjF;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAG3F;AAMD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGlF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAGvE;AAuCD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,CAGtE;AAaD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAsCzG;AAKD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAmCT"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGjF;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAG3F;AAMD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGlF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAGvE;AAoCD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,CAGtE;AAaD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAsCzG;AAKD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAmCT"}

package/dist/puzzles/pyraminx/solver/search.js

@@ -1,4 +1,4 @@
-import { POLICY_TABLE, CENTERS_TABLE, PERMUTATION_TABLE, ORIENTATION_TABLE, PYRAMINX_MOVES, MOVE_COUNT, PERMUTATION_COUNT, getCentersIndex, getOrientationIndex, getPermutationCompactIndex, ensureTablesLoaded } from "./tables.js";
+import { POLICY_TABLE, POLICY_TABLE_EXPANDED, CENTERS_TABLE, PERMUTATION_TABLE, ORIENTATION_TABLE, PYRAMINX_MOVES, MOVE_COUNT, PERMUTATION_COUNT, getCentersIndex, getOrientationIndex, getPermutationCompactIndex, ensureTablesLoaded } from "./tables.js";
 export async function solvePyraminx(state) {
     await ensureTablesLoaded();
     return solveWithTables(state).moves;
@@ -29,7 +29,7 @@ function solveWithTablesIndices(state) {
     const centersTable = CENTERS_TABLE;
     const permTable = PERMUTATION_TABLE;
     const orientTable = ORIENTATION_TABLE;
-    const policy = POLICY_TABLE;
+    const policy = POLICY_TABLE_EXPANDED;
     let c = getCentersIndex(state.centers);
     let p = getPermutationCompactIndex(state.edgesPerm);
     let o = getOrientationIndex(state.edgesOrient);
@@ -38,10 +38,7 @@ function solveWithTablesIndices(state) {
         return [];
     const moves = [];
     while (stateIndex !== 0) {
-        const bits = stateIndex * 3;
-        const byteIndex = bits >> 3;
-        const offset = bits & 7;
-        const m = ((policy[byteIndex] | ((policy[byteIndex + 1] ?? 0) << 8)) >> offset) & 0x07;
+        const m = policy[stateIndex];
         moves.push(m);
         c = centersTable[c * MOVE_COUNT + m];
         p = permTable[p * MOVE_COUNT + m];

package/dist/puzzles/pyraminx/solver/tables.d.ts

@@ -34,6 +34,12 @@ export declare let CENTERS_TABLE: Uint8Array | null;
 export declare let PERMUTATION_TABLE: Uint16Array | null;
 export declare let ORIENTATION_TABLE: Uint8Array | null;
 export declare let POLICY_TABLE: Uint8Array | null;
+/**
+ * Byte-expanded policy (one optimal move per state, no bit-unpacking in
+ * the hot walk). Built at load from the 3-bit packed table: +0.9 MB RAM,
+ * zero wire/format change.
+ */
+export declare let POLICY_TABLE_EXPANDED: Uint8Array | null;
 export declare function ensureTablesLoaded(): Promise<void>;
 export declare function arePyraminxTablesLoaded(): boolean;
 export declare function getPolicyMove(stateIndex: number): number;

package/dist/puzzles/pyraminx/solver/tables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/tables.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ/D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAWnE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIjE;AAGD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,eAAe,yBAAkD,CAAC;AAC/E,eAAO,MAAM,eAAe,0BAAqC,CAAC;AAalE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAK1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAK1D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAatE;AAMD,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,WAAW,QAA6C,CAAC;AACtE,eAAO,MAAM,qBAAqB,QAAmC,CAAC;AAGtE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAEjD,CAAC;AAMF,wBAAgB,oBAAoB,IAAI,UAAU,CAgBjD;AAED,wBAAgB,wBAAwB,IAAI,WAAW,CAkBtD;AAED,wBAAgB,wBAAwB,IAAI,UAAU,CAgBrD;AAKD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,UAAU,EACxB,SAAS,EAAE,WAAW,EACtB,WAAW,EAAE,UAAU,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA8C1C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAO1D;AAOD,eAAO,IAAI,aAAa,EAAE,UAAU,GAAG,IAAW,CAAC;AACnD,eAAO,IAAI,iBAAiB,EAAE,WAAW,GAAG,IAAW,CAAC;AACxD,eAAO,IAAI,iBAAiB,EAAE,UAAU,GAAG,IAAW,CAAC;AACvD,eAAO,IAAI,YAAY,EAAE,UAAU,GAAG,IAAW,CAAC;AAElD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5E;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9E;AACD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/pyraminx/solver/tables.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ/D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAWnE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIjE;AAGD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,eAAe,yBAAkD,CAAC;AAC/E,eAAO,MAAM,eAAe,0BAAqC,CAAC;AAalE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAK1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAK1D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAatE;AAMD,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,WAAW,QAA6C,CAAC;AACtE,eAAO,MAAM,qBAAqB,QAAmC,CAAC;AAGtE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAEjD,CAAC;AAMF,wBAAgB,oBAAoB,IAAI,UAAU,CAgBjD;AAED,wBAAgB,wBAAwB,IAAI,WAAW,CAkBtD;AAED,wBAAgB,wBAAwB,IAAI,UAAU,CAgBrD;AAKD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,UAAU,EACxB,SAAS,EAAE,WAAW,EACtB,WAAW,EAAE,UAAU,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA8C1C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAO1D;AAOD,eAAO,IAAI,aAAa,EAAE,UAAU,GAAG,IAAW,CAAC;AACnD,eAAO,IAAI,iBAAiB,EAAE,WAAW,GAAG,IAAW,CAAC;AACxD,eAAO,IAAI,iBAAiB,EAAE,UAAU,GAAG,IAAW,CAAC;AACvD,eAAO,IAAI,YAAY,EAAE,UAAU,GAAG,IAAW,CAAC;AAClD;;;;GAIG;AACH,eAAO,IAAI,qBAAqB,EAAE,UAAU,GAAG,IAAW,CAAC;AAE3D,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CASxD;AAYD,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5E;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9E;AACD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}

package/dist/puzzles/pyraminx/solver/tables.js

@@ -261,6 +261,12 @@ export let CENTERS_TABLE = null;
 export let PERMUTATION_TABLE = null;
 export let ORIENTATION_TABLE = null;
 export let POLICY_TABLE = null;
+/**
+ * Byte-expanded policy (one optimal move per state, no bit-unpacking in
+ * the hot walk). Built at load from the 3-bit packed table: +0.9 MB RAM,
+ * zero wire/format change.
+ */
+export let POLICY_TABLE_EXPANDED = null;
 export async function ensureTablesLoaded() {
     if (tablesLoaded)
         return;
@@ -269,8 +275,18 @@ export async function ensureTablesLoaded() {
     PERMUTATION_TABLE = tables.permutationTable;
     ORIENTATION_TABLE = tables.orientationTable;
     POLICY_TABLE = tables.policyTable;
+    POLICY_TABLE_EXPANDED = expandPolicy3Bit(tables.policyTable, STATE_COUNT);
     tablesLoaded = true;
 }
+function expandPolicy3Bit(packed, count) {
+    const expanded = new Uint8Array(count);
+    for (let index = 0; index < count; index += 1) {
+        const bits = index * 3;
+        const byteIndex = bits >> 3;
+        expanded[index] = (((packed[byteIndex] | ((packed[byteIndex + 1] ?? 0) << 8)) >> (bits & 7)) & 0x07);
+    }
+    return expanded;
+}
 export function arePyraminxTablesLoaded() {
     return tablesLoaded;
 }
@@ -300,4 +316,5 @@ export function resetTablesForTests() {
     PERMUTATION_TABLE = null;
     ORIENTATION_TABLE = null;
     POLICY_TABLE = null;
+    POLICY_TABLE_EXPANDED = null;
 }

package/dist/puzzles/shared/compressed-fetch.d.ts

@@ -1,5 +1,19 @@
+/** FNV-1a expectations from the legacy (non-sha256) manifests. */
+export interface ExpectedFnv1a {
+    /** FNV-1a 32-bit checksum (`>>> 0`) over the decoded numeric sequence. */
+    value: number;
+    /**
+     * Wire size of each hashed element: 1 = byte, 2 = uint16 LE, 4 = int32 LE.
+     * Mirrors how each node loader decodes values before hashing (`4` also
+     * covers the 3x3 int32 move tables: their hashed uint16 values are the
+     * same numbers, and XOR/`Math.imul` are sign-insensitive there).
+     */
+    elementSize: 1 | 2 | 4;
+    /** Hash 1-byte elements as signed int8 (Square-1's int8 tables). */
+    signed?: boolean;
+}
 export interface FetchTableBufferOptions {
-    /** Cache API cache name to store responses in (used by cube3). */
+    /** Cache API cache name to store responses in (used by all table loaders). */
     cacheName?: string;
     /**
      * Whether the manifest advertises precompressed variants for this file.
@@ -7,6 +21,28 @@ export interface FetchTableBufferOptions {
      * set to false to skip .br/.gz attempts entirely.
      */
     compressed?: boolean;
+    /**
+     * sha256 hex digest of the UNCOMPRESSED file (from its manifest entry).
+     * Verified after decompression; a mismatch rejects with the file URL.
+     */
+    expectedSha256?: string;
+    /** Exact byte length of the uncompressed file (from its manifest entry). */
+    expectedBytes?: number;
+    /**
+     * FNV-1a checksum from legacy manifests (cube2/cube3/pyraminx/skewb/sq1).
+     * Verified after the length check; a mismatch rejects with the file URL.
+     */
+    expectedFnv1a?: ExpectedFnv1a;
 }
 export declare function fetchTableBuffer(baseUrl: string, dir: string, file: string, options?: FetchTableBufferOptions): Promise<ArrayBuffer>;
+/**
+ * FNV-1a (32-bit) over the elements decoded from a wire buffer: the browser
+ * twin of the node loaders' `checksum(values)` (imul multiply, `>>> 0`
+ * result). `elementSize` mirrors each loader's decoding of the manifest
+ * checksum — see `ExpectedFnv1a`.
+ */
+export declare function fnv1a32(buffer: ArrayBuffer, elementSize: 1 | 2 | 4, signed?: boolean): number;
+/** sha256 hex of a buffer; WebCrypto when available, portable JS fallback otherwise. */
+export declare function sha256Hex(buffer: ArrayBuffer): Promise<string>;
+export declare function sha256HexJs(buffer: ArrayBuffer): string;
 //# sourceMappingURL=compressed-fetch.d.ts.map

package/dist/puzzles/shared/compressed-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compressed-fetch.d.ts","sourceRoot":"","sources":["../../../src/puzzles/shared/compressed-fetch.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkBD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CAuBtB"}
+{"version":3,"file":"compressed-fetch.d.ts","sourceRoot":"","sources":["../../../src/puzzles/shared/compressed-fetch.ts"],"names":[],"mappings":"AAeA,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAkBD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CAyDtB;AAmCD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,UAAQ,GAAG,MAAM,CAgB3F;AAED,wFAAwF;AACxF,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAYpE;AAcD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAmEvD"}