@cubingcenter/scrambler 0.4.0 → 0.5.0

package/README.md

@@ -10,10 +10,12 @@ The package currently ships random-state scramblers for `222` (2x2x2), `333` (3x
 - Runtime: Node.js
 - Language: TypeScript
 - Package manager: pnpm
-- Registered events: `222`, `333`, `444`
-- Main technical modules: `cube2`, `cube3`, `cube4`
-- 2x2 quality: random-state target + optimal IDA* corner solver + verified scramble inversion
+- Registered events: `222`, `333`, `444`, `555`, `666`, `777`, `pymx`, `skwb`, `clck`, `mgmx`
+- Main technical modules: `cube2`, `cube3`, `cube4`, `pyraminx`, `skewb`, `clock`, `megaminx`, `cube5x5`, `cube6x6`, `cube7x7`
+- 2x2 quality: random-state target + optimal table-guided solver + verified scramble inversion
 - 3x3 quality: random-state target + two-phase solver + verified scramble inversion
+- Pyraminx quality: random-state target + optimal policy-table solver (all 933,120 core states verified)
+- Skewb quality: random-state target + optimal policy-table solver (all 3,149,280 states; exact uniform sampling)
 - 4x4 quality: reduced 4x4 random-state target + existing 3x3 two-phase finish; full center/wing random-state reduction is isolated under `cube4.reduction`
 
 This library is intended for practice, training, and internal CubingCenter use. Do not present it as an official WCA competition scrambler; sanctioned competitions must use the official program required by the delegate/organization.
@@ -60,6 +62,28 @@ console.log(batch.map((item) => item.scramble));
 
 `generateScramble("333")` returns a legal random-state 3x3 scramble. Its metadata includes the target cubie state, timer-ready facelets, a 54-character facelet string, and solver diagnostics.
 
+`generateScramble("pymx")` returns a legal random-state Pyraminx scramble. Its metadata includes the target state, facelets, solution moves and depth. Pyraminx/2x2/3x3 accept `{ skipValidation: true }` to skip the per-call verification for maximum throughput (the scramble correctness is covered by exhaustive tests).
+
+## Scoped imports (web / smaller bundles)
+
+Importing the root entry loads every puzzle. For web apps, import only the
+puzzle you need — each subpath registers its own generator, so
+`generateScramble` works right away:
+
+```ts
+import { generateScramble, initializeScrambler } from "@cubingcenter/scrambler/puzzles/pyraminx";
+// "222" | "333" | "444" | "555" | "666" | "777" | "pymx" | "skwb" | "clck" | "mgmx"
+await initializeScrambler("/scrambler-tables", "pymx");
+const result = await generateScramble("pymx", { seed: "demo" });
+```
+
+In the browser, solver tables are fetched from the base URL you pass to
+`initializeScrambler` and served from `puzzles/<puzzle>/solver/generated/`.
+The demo repo ships precompressed `.br`/`.gz` variants of the tables (see
+`pnpm tables:web:sync`); the loaders download those automatically when
+`DecompressionStream` is available (Pyraminx ~470 KB → ~345 KB, cube3
+~6.6 MB → ~2.2 MB).
+
 ## 2x2 Technical Module
 
 ```ts
@@ -98,6 +122,46 @@ const validation = cube3.validateCube3State(state);
 
 The `cube3.solver` namespace is exported for advanced tooling and validation. Normal consumers should prefer `generateScramble("333")`.
 
+## Pyraminx Technical Module
+
+```ts
+import { pyraminx } from "@cubingcenter/scrambler";
+
+const solved = pyraminx.createSolvedPyraminxState();
+const moved = pyraminx.applyPyraminxAlgorithm(solved, ["R", "U", "R'"]);
+const state = pyraminx.generateRandomPyraminxState({ seed: "demo" });
+const facelets = pyraminx.toPyraminxFacelets(state);
+const faceletString = pyraminx.formatPyraminxFacelets(facelets);
+const validation = pyraminx.validatePyraminxState(state);
+const solution = await pyraminx.solvePyraminx(state); // optimal, policy-table based
+```
+
+`generateRandomPyraminxState` returns a legal random state (centers, edges and tips), not a scramble sequence.
+
+`toPyraminxFacelets` returns four triangular faces (`F L R D`) with nine stickers each. `formatPyraminxFacelets` produces a stable 36-character string.
+
+The solver only covers the core (centers + edges); tips are appended by the scrambler. The `pyraminx.solver` namespace exposes the compact coordinates and the policy table; its optimality is verified exhaustively over all 933,120 core states (`pnpm verify:pyraminx:exhaustive`). Normal consumers should prefer `generateScramble("pymx")`.
+
+## Skewb Technical Module
+
+```ts
+import { skewb } from "@cubingcenter/scrambler";
+
+const solved = skewb.createSolvedSkewbState();
+const moved = skewb.applySkewbAlgorithm(solved, ["R", "U", "R'"]);
+const state = await skewb.generateRandomSkewbState({ seed: "demo" });
+const facelets = skewb.toSkewbFacelets(state);
+const faceletString = skewb.formatSkewbFacelets(facelets);
+const validation = skewb.validateSkewbState(state);
+const solution = await skewb.solveSkewb(state); // optimal, policy-table based
+```
+
+`generateRandomSkewbState` returns a legal random state, not a scramble sequence. It samples the compact group rank uniformly, so every one of the 3,149,280 reachable states is exactly as likely as any other.
+
+`toSkewbFacelets` returns six faces with five stickers each. `formatSkewbFacelets` produces a stable 30-character string.
+
+Both `generateRandomSkewbState` and `solveSkewb` are async: they need the solver tables, which load lazily in Node and are prefetched in the browser via `initializeScrambler(baseUrl, "skwb")` (or `skewb.solveSkewbSync` after preloading). The `skewb.solver` namespace exposes the compact rank coordinates and the 3-bit policy table (all 3,149,280 states, God's number 11). Normal consumers should prefer `generateScramble("skwb")`.
+
 ## 4x4 Technical Module
 
 ```ts

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrG;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,iBAAmC,GAC5C,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,iBAAmC,GAAG,SAAS,EAAE,CAE7F;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,iBAAmC,GAC5C,SAAS,CAQX;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,eAAoB,EAC7B,QAAQ,GAAE,iBAAmC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,EAC7B,QAAQ,GAAE,iBAAmC,GAC5C,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BrG;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,iBAAmC,GAC5C,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,iBAAmC,GAAG,SAAS,EAAE,CAE7F;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,iBAAmC,GAC5C,SAAS,CAQX;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,eAAoB,EAC7B,QAAQ,GAAE,iBAAmC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,EAC7B,QAAQ,GAAE,iBAAmC,GAC5C,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B"}

package/dist/core/api.js

@@ -1,7 +1,5 @@
 import { GeneratorFailedError, InvalidCountError, UnsupportedEventError } from "./errors.js";
 import { defaultRegistry } from "./registry.js";
-import { loadBrowserTables as loadCube2BrowserTables } from "../puzzles/cube2/solver/browser-loader.js";
-import { loadBrowserTables as loadCube3BrowserTables } from "../puzzles/cube3/solver/browser-loader.js";
 /**
  * Pre-load solver tables in browser environments.
  * In Node.js this is a no-op (tables are read lazily from the filesystem).
@@ -18,16 +16,30 @@ export async function initializeScrambler(baseUrl, eventId) {
         // Node.js — tables are loaded on-demand from the filesystem
         return;
     }
+    // Lazy imports keep per-puzzle subpath bundles from pulling in the
+    // loaders of every other puzzle.
     if (eventId === "222" || eventId === "222so") {
-        await loadCube2BrowserTables(baseUrl);
+        const { loadBrowserTables } = await import("../puzzles/cube2/solver/browser-loader.js");
+        await loadBrowserTables(baseUrl);
     }
     else if (eventId === "333") {
-        await loadCube3BrowserTables(baseUrl);
+        const { loadBrowserTables } = await import("../puzzles/cube3/solver/browser-loader.js");
+        await loadBrowserTables(baseUrl);
+    }
+    else if (eventId === "pymx") {
+        const { loadBrowserTables } = await import("../puzzles/pyraminx/solver/browser-loader.js");
+        await loadBrowserTables(baseUrl);
+    }
+    else if (eventId === "skwb") {
+        const { loadBrowserTables } = await import("../puzzles/skewb/solver/browser-loader.js");
+        await loadBrowserTables(baseUrl);
     }
     else if (!eventId) {
         await Promise.all([
-            loadCube2BrowserTables(baseUrl),
-            loadCube3BrowserTables(baseUrl)
+            import("../puzzles/cube2/solver/browser-loader.js").then((m) => m.loadBrowserTables(baseUrl)),
+            import("../puzzles/cube3/solver/browser-loader.js").then((m) => m.loadBrowserTables(baseUrl)),
+            import("../puzzles/pyraminx/solver/browser-loader.js").then((m) => m.loadBrowserTables(baseUrl)),
+            import("../puzzles/skewb/solver/browser-loader.js").then((m) => m.loadBrowserTables(baseUrl))
         ]);
     }
 }

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
 export { GeneratorFailedError, InvalidCountError, InvalidOptionsError, ScramblerError, UnsupportedEventError } from "./errors.js";
 export { DefaultScramblerRegistry, defaultRegistry } from "./registry.js";
 export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler, registerScrambleGenerator } from "./api.js";
-export type { EventId, EventInfo, ScrambleGenerator, ScrambleOptions, ScrambleQuality, ScrambleResult, ScramblerRegistry } from "./types.js";
+export type { EventId, EventInfo, ScrambleGenerator, ScrambleOptions, ScrambleQuality, ScrambleResult, ScramblerRegistry, SupportedEventId } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/core/types.d.ts

@@ -1,8 +1,15 @@
 export type EventId = string;
+export type SupportedEventId = "222" | "333" | "444" | "555" | "666" | "777" | "pymx" | "skwb" | "clck" | "mgmx";
 export type ScrambleQuality = "random-state" | "random-move" | "training" | "placeholder";
 export interface ScrambleOptions {
     seed?: string | number;
     metadata?: Record<string, unknown>;
+    /**
+     * Skips the internal "scramble reproduces the target state" verification.
+     * The scramblers are verified exhaustively by the test suite, so this is
+     * safe to enable for maximum throughput; it trades a safety net for speed.
+     */
+    skipValidation?: boolean;
 }
 export interface ScrambleResult {
     eventId: EventId;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,aAAa,GACb,UAAU,GACV,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrD,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAG7B,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,aAAa,GACb,UAAU,GACV,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrD,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CAChC"}

package/dist/puzzles/clock/index.d.ts

@@ -1,2 +1,3 @@
 export { clockScrambleGenerator, generateClockScramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/clock/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/clock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/clock/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/clock/index.js

@@ -1 +1,5 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { clockScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(clockScrambleGenerator);
 export { clockScrambleGenerator, generateClockScramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/cube2/index.d.ts

@@ -7,4 +7,5 @@ export { generateRandomCube2State } from "./random-state.js";
 export { cube2ScrambleGenerator, generateCube2Scramble } from "./scrambler.js";
 export { formatCube2Facelets, getCube2FaceOrder, toCube2Facelets } from "./facelets.js";
 export * as solver from "./solver/index.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube2/index.js

@@ -1,3 +1,6 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube2ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube2ScrambleGenerator);
 export { CUBE2_MOVES, CORNER_COUNT } from "./types.js";
 export { applyCube2Algorithm, applyCube2Move, formatCube2Algorithm, invertCube2Algorithm, invertCube2Move, parseCube2Algorithm, parseCube2Move } from "./moves.js";
 export { cloneCube2State, createSolvedCube2State, cube2StatesEqual, isSolvedCube2State } from "./state.js";
@@ -6,3 +9,4 @@ export { generateRandomCube2State } from "./random-state.js";
 export { cube2ScrambleGenerator, generateCube2Scramble } from "./scrambler.js";
 export { formatCube2Facelets, getCube2FaceOrder, toCube2Facelets } from "./facelets.js";
 export * as solver from "./solver/index.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/cube2/scrambler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/scrambler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW9F,eAAO,MAAM,sBAAsB,EAAE,iBAYpC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,eAAe,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,cAAc,CAAC,CA0CzB"}
+{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/scrambler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAS9F,eAAO,MAAM,sBAAsB,EAAE,iBAYpC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,eAAe,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,cAAc,CAAC,CAwCzB"}

package/dist/puzzles/cube2/scrambler.js

@@ -1,8 +1,7 @@
-import { applyCube2Algorithm, formatCube2Algorithm, invertCube2Algorithm } from "./moves.js";
+import { formatCube2Algorithm, invertCube2Algorithm } from "./moves.js";
 import { generateRandomCube2State } from "./random-state.js";
-import { createSolvedCube2State, cube2StatesEqual, isSolvedCube2State } from "./state.js";
 import { formatCube2Facelets, toCube2Facelets } from "./facelets.js";
-import { solveCube2State } from "./solver/index.js";
+import { solveCube2State, verifyCube2Scramble, verifyCube2Solution } from "./solver/index.js";
 export const cube2ScrambleGenerator = {
     info: {
         eventId: "222",
@@ -21,11 +20,10 @@ export async function generateCube2Scramble(options = {}) {
     const solution = await solveCube2State(state);
     const scrambleMoves = invertCube2Algorithm(solution.moves);
     if (!options.skipValidation) {
-        const scrambledState = applyCube2Algorithm(createSolvedCube2State(), scrambleMoves);
-        if (!cube2StatesEqual(scrambledState, state)) {
+        if (!verifyCube2Scramble(state, scrambleMoves)) {
             throw new Error("Generated 2x2 scramble does not reproduce the target random state.");
         }
-        if (!isSolvedCube2State(solution.state)) {
+        if (!verifyCube2Solution(state, solution.moves)) {
             throw new Error("Generated 2x2 solution does not solve the target random state.");
         }
         if (scrambleMoves.length < 2) {

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

@@ -1 +1 @@
-{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/browser-loader.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB;sBALlB,WAAW;sBACX,WAAW;eAClB,UAAU;cAKtB;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,WAAW,CAAC;IAC9B,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC,CAqBD"}
+{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/browser-loader.ts"],"names":[],"mappings":"AAWA,wBAAgB,sBAAsB;sBALlB,WAAW;sBACX,WAAW;eAClB,UAAU;cAKtB;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,WAAW,CAAC;IAC9B,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC,CAqBD"}

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

@@ -1,4 +1,6 @@
 import { CUBE2_SOLVER_TABLE_METADATA } from "./table-metadata.js";
+import { fetchTableBuffer } from "../../shared/compressed-fetch.js";
+const TABLES_DIR = "puzzles/cube2/solver/generated";
 let cachedBrowserTables;
 export function getCachedBrowserTables() {
     return cachedBrowserTables;
@@ -50,12 +52,7 @@ async function fetchManifest(baseUrl) {
     return manifest;
 }
 async function fetchUint16Table(baseUrl, entry, expectedEntries) {
-    const url = `${baseUrl}/puzzles/cube2/solver/generated/${entry.file}`;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`Failed to load ${entry.file}: ${response.status} ${response.statusText}`);
-    }
-    const buffer = await response.arrayBuffer();
+    const buffer = await fetchTableBuffer(baseUrl, TABLES_DIR, entry.file, { compressed: entry.compressed !== false });
     if (buffer.byteLength !== expectedEntries * 2) {
         throw new Error(`Invalid byte size for ${entry.file}`);
     }
@@ -67,12 +64,7 @@ async function fetchUint16Table(baseUrl, entry, expectedEntries) {
     return values;
 }
 async function fetchUint8Table(baseUrl, entry, expectedEntries) {
-    const url = `${baseUrl}/puzzles/cube2/solver/generated/${entry.file}`;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`Failed to load ${entry.file}: ${response.status} ${response.statusText}`);
-    }
-    const buffer = await response.arrayBuffer();
+    const buffer = await fetchTableBuffer(baseUrl, TABLES_DIR, entry.file, { compressed: entry.compressed !== false });
     if (buffer.byteLength !== expectedEntries) {
         throw new Error(`Invalid byte size for ${entry.file}`);
     }

package/dist/puzzles/cube2/solver/index.d.ts

@@ -1,3 +1,3 @@
-export { solveCube2State } from "./search.js";
+export { solveCube2State, verifyCube2Scramble, verifyCube2Solution } from "./search.js";
 export type { Cube2Solution } from "./search.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube2/solver/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/puzzles/cube2/solver/index.js

@@ -1 +1 @@
-export { solveCube2State } from "./search.js";
+export { solveCube2State, verifyCube2Scramble, verifyCube2Solution } from "./search.js";

package/dist/puzzles/cube2/solver/search.d.ts

@@ -5,4 +5,6 @@ export interface Cube2Solution {
     state: Cube2State;
 }
 export declare function solveCube2State(state: Cube2State): Promise<Cube2Solution>;
+export declare function verifyCube2Scramble(state: Cube2State, scrambleMoves: readonly Cube2Move[]): boolean;
+export declare function verifyCube2Solution(state: Cube2State, solutionMoves: readonly Cube2Move[]): boolean;
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CA6D/E"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube2/solver/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CA6D/E;AAoBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAUnG;AAGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAOnG"}

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

@@ -48,3 +48,29 @@ export async function solveCube2State(state) {
         state: createSolvedCube2State()
     };
 }
+const MOVE_INDEX = {};
+for (let i = 0; i < BFS_MOVES.length; i++) {
+    MOVE_INDEX[BFS_MOVES[i]] = i;
+}
+function walkCube2Coordinates(permIndex, orientIndex, moves) {
+    const permTable = PERMUTATION_TABLE;
+    const orientTable = ORIENTATION_TABLE;
+    for (const move of moves) {
+        const m = MOVE_INDEX[move];
+        permIndex = permTable[permIndex * MOVE_COUNT + m];
+        orientIndex = orientTable[orientIndex * MOVE_COUNT + m];
+    }
+    return { permIndex, orientIndex };
+}
+// Applies moves over coordinate indexes (no full state clones) and checks
+// they reproduce the target state.
+export function verifyCube2Scramble(state, scrambleMoves) {
+    const { permIndex, orientIndex } = walkCube2Coordinates(encodePermutation([0, 1, 2, 3, 4, 5, 6, 7]), encodeOrientation([0, 0, 0, 0, 0, 0, 0, 0]), scrambleMoves);
+    return (permIndex === encodePermutation(state.corners.permutation) &&
+        orientIndex === encodeOrientation(state.corners.orientation));
+}
+// Checks that the solution leads the target state back to solved coordinates.
+export function verifyCube2Solution(state, solutionMoves) {
+    const { permIndex, orientIndex } = walkCube2Coordinates(encodePermutation(state.corners.permutation), encodeOrientation(state.corners.orientation), solutionMoves);
+    return permIndex === 0 && orientIndex === 0;
+}

package/dist/puzzles/cube2/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAkB3E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAGxE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAIpE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAYvE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube2/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAgBpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAkB3E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAIxE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAIpE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAYvE"}

package/dist/puzzles/cube2/validation.js

@@ -1,6 +1,17 @@
 import { CUBE2_MOVES, CORNER_COUNT } from "./types.js";
 import { applyCube2Move } from "./moves.js";
-import { createSolvedCube2State, cube2StatesEqual, isSolvedCube2State } from "./state.js";
+import { createSolvedCube2State, isSolvedCube2State } from "./state.js";
+import { encodeOrientation, encodePermutation } from "./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 = CUBE2_MOVES.map((move) => {
+    const state = applyCube2Move(createSolvedCube2State(), move);
+    return {
+        p: encodePermutation(state.corners.permutation),
+        o: encodeOrientation(state.corners.orientation)
+    };
+});
 export function validateCube2State(state) {
     const errors = [
         ...validatePermutation("corner", state.corners.permutation, CORNER_COUNT),
@@ -18,8 +29,9 @@ export function validateCube2State(state) {
     };
 }
 export function isOneMoveFromSolvedCube2State(state) {
-    const solved = createSolvedCube2State();
-    return CUBE2_MOVES.some((move) => cube2StatesEqual(applyCube2Move(solved, move), state));
+    const p = encodePermutation(state.corners.permutation);
+    const o = encodeOrientation(state.corners.orientation);
+    return ONE_MOVE_FROM_SOLVED_ENCODED.some((entry) => entry.p === p && entry.o === o);
 }
 export function isAllowedRandomCube2State(state) {
     return validateCube2State(state).valid &&

package/dist/puzzles/cube3/index.d.ts

@@ -7,4 +7,5 @@ export { cube3ScrambleGenerator, generateCube3Scramble } from "./scrambler.js";
 export { formatCube3Facelets, getCube3FaceOrder, toCube3Facelets } from "./facelets.js";
 export * as solver from "./solver/index.js";
 export type { Cube3Face, Cube3Facelets, Cube3Move, Cube3FaceMove, Cube3MoveSuffix, Cube3RandomStateOptions, Cube3Sticker, Cube3State, Cube3ValidationResult } from "./types.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,qBAAqB,EACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube3/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube3/index.js

@@ -1,3 +1,6 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube3ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube3ScrambleGenerator);
 export { CUBE3_MOVES, CORNER_COUNT, EDGE_COUNT } from "./types.js";
 export { applyCube3Algorithm, applyCube3Move, formatCube3Algorithm, invertCube3Algorithm, invertCube3Move, parseCube3Algorithm, parseCube3Move } from "./moves.js";
 export { cloneCube3State, createSolvedCube3State, cube3StatesEqual, isSolvedCube3State } from "./state.js";
@@ -6,3 +9,4 @@ export { generateRandomCube3State } from "./random-state.js";
 export { cube3ScrambleGenerator, generateCube3Scramble } from "./scrambler.js";
 export { formatCube3Facelets, getCube3FaceOrder, toCube3Facelets } from "./facelets.js";
 export * as solver from "./solver/index.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/browser-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAKV,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAqCrB,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,SAAS,CAEtE;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0CpF"}
+{"version":3,"file":"browser-loader.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/browser-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAKV,iBAAiB,EAClB,MAAM,aAAa,CAAC;AA0CrB,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,SAAS,CAEtE;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0CpF"}

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

@@ -1,3 +1,6 @@
+import { fetchTableBuffer } from "../../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) {
@@ -49,31 +52,6 @@ export 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);
@@ -87,8 +65,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 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.`);
@@ -108,8 +85,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 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/puzzles/cube4/index.d.ts

@@ -4,4 +4,5 @@ export { createSolvedCube4State, cloneCube4State, cube4StatesEqual, isSolvedCube
 export { applyCube4Move, applyCube4Algorithm, invertCube4Move, invertCube4Algorithm, formatCube4Algorithm, parseCube4Algorithm, parseCube4Move, parseMove, FACE_MOVE_EFFECTS } from "./moves.js";
 export { cube4ScrambleGenerator, generateCube4Scramble } from "./scrambler.js";
 export { toCube4Facelets, formatCube4Facelets, getCube4FaceOrder } from "./facelets.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube4/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube4/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube4/index.js

@@ -1,8 +1,12 @@
 // ---------------------------------------------------------------------------
 // cube4 barrel exports
 // ---------------------------------------------------------------------------
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube4ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube4ScrambleGenerator);
 export { CORNER_COUNT, WING_COUNT, CENTER_COUNT, FACE_COUNT, CENTERS_PER_FACE, U, R, F, D, L, B, CUBE4_FACE_MOVES, CUBE4_ALL_MOVES, CUBE4_OUTER_MOVES } from "./types.js";
 export { createSolvedCube4State, cloneCube4State, cube4StatesEqual, isSolvedCube4State, areCentersReduced, areWingsPaired } from "./state.js";
 export { applyCube4Move, applyCube4Algorithm, invertCube4Move, invertCube4Algorithm, formatCube4Algorithm, parseCube4Algorithm, parseCube4Move, parseMove, FACE_MOVE_EFFECTS } from "./moves.js";
 export { cube4ScrambleGenerator, generateCube4Scramble } from "./scrambler.js";
 export { toCube4Facelets, formatCube4Facelets, getCube4FaceOrder } from "./facelets.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/cube5x5/index.d.ts

@@ -1,4 +1,5 @@
 export type { Cube5Move } from "./types.js";
 export { CUBE5_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube5ScrambleGenerator, generateCube5Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube5x5/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube5x5/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube5x5/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube5x5/index.js

@@ -1,2 +1,6 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube5ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube5ScrambleGenerator);
 export { CUBE5_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube5ScrambleGenerator, generateCube5Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/cube6x6/index.d.ts

@@ -1,4 +1,5 @@
 export type { Cube6Move } from "./types.js";
 export { CUBE6_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube6ScrambleGenerator, generateCube6Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube6x6/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube6x6/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube6x6/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube6x6/index.js

@@ -1,2 +1,6 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube6ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube6ScrambleGenerator);
 export { CUBE6_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube6ScrambleGenerator, generateCube6Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/cube7x7/index.d.ts

@@ -1,4 +1,5 @@
 export type { Cube7Move } from "./types.js";
 export { CUBE7_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube7ScrambleGenerator, generateCube7Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/cube7x7/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube7x7/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube7x7/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/puzzles/cube7x7/index.js

@@ -1,2 +1,6 @@
+import { registerScrambleGenerator } from "../../core/index.js";
+import { cube7ScrambleGenerator } from "./scrambler.js";
+registerScrambleGenerator(cube7ScrambleGenerator);
 export { CUBE7_ALL_MOVES, SCRAMBLE_LENGTH } from "./types.js";
 export { cube7ScrambleGenerator, generateCube7Scramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";

package/dist/puzzles/megaminx/index.d.ts

@@ -1,4 +1,5 @@
 export type { MegaminxMove } from "./types.js";
 export { MEGAMINX_R_MOVES, MEGAMINX_D_MOVES, SCRAMBLE_LINES, MOVES_PER_LINE } from "./types.js";
 export { megaminxScrambleGenerator, generateMegaminxScramble } from "./scrambler.js";
+export { generateScramble, generateScrambles, getEventInfo, getSupportedEvents, initializeScrambler } from "../../core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/puzzles/megaminx/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/megaminx/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/megaminx/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}