@cubingcenter/scrambler 0.1.0 → 0.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube3/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,CA+CzB"}
+{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/cube3/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,CAgDzB"}

package/dist/puzzles/cube3/scrambler.js

@@ -42,6 +42,7 @@ export async function generateCube3Scramble(options = {}) {
         metadata: {
             generator: "cube3-two-phase",
             generatorVersion: "1.0.0",
+            facelets,
             faceletString: formatCube3Facelets(facelets),
             state: JSON.parse(JSON.stringify(state)),
             solutionMoves: solution.moves,

package/dist/puzzles/cube4/scrambler.js

@@ -7,9 +7,9 @@ export const cube4ScrambleGenerator = {
         eventId: "444",
         name: "4x4x4 Cube",
         puzzle: "cube-4x4",
-        quality: "random-move",
-        generator: "cube4-random-move",
-        description: "Random-move 4x4 scramble with 40 moves."
+        quality: "random-state",
+        generator: "cubing-scramble",
+        description: "Random-state 4x4 scramble generated by cubing.js."
     },
     generate(options = {}) {
         return generateCube4Scramble(options);

package/dist/puzzles/index.d.ts

@@ -7,4 +7,5 @@ export * as cube6x6 from "./cube6x6/index.js";
 export * as cube7x7 from "./cube7x7/index.js";
 export * as pyraminx from "./pyraminx/index.js";
 export * as clock from "./clock/index.js";
+export * as skewb from "./skewb/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/puzzles/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/puzzles/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/puzzles/index.js

@@ -8,6 +8,7 @@ import { cube6ScrambleGenerator } from "./cube6x6/index.js";
 import { cube7ScrambleGenerator } from "./cube7x7/index.js";
 import { pyraminxScrambleGenerator } from "./pyraminx/index.js";
 import { clockScrambleGenerator } from "./clock/index.js";
+import { skewbScrambleGenerator } from "./skewb/index.js";
 registerScrambleGenerator(cube2ScrambleGenerator);
 registerScrambleGenerator(cube3ScrambleGenerator);
 registerScrambleGenerator(cube4ScrambleGenerator);
@@ -17,6 +18,7 @@ registerScrambleGenerator(cube6ScrambleGenerator);
 registerScrambleGenerator(cube7ScrambleGenerator);
 registerScrambleGenerator(pyraminxScrambleGenerator);
 registerScrambleGenerator(clockScrambleGenerator);
+registerScrambleGenerator(skewbScrambleGenerator);
 export * as cube2 from "./cube2/index.js";
 export * as cube3 from "./cube3/index.js";
 export * as cube4 from "./cube4/index.js";
@@ -26,3 +28,4 @@ export * as cube6x6 from "./cube6x6/index.js";
 export * as cube7x7 from "./cube7x7/index.js";
 export * as pyraminx from "./pyraminx/index.js";
 export * as clock from "./clock/index.js";
+export * as skewb from "./skewb/index.js";

package/dist/puzzles/pyraminx/facelets.d.ts

@@ -0,0 +1,7 @@
+import type { PyraminxState } from "./types.js";
+export type PyraminxFacelets = Record<"F" | "L" | "R" | "D", readonly string[]>;
+export declare function createSolvedPyraminxFacelets(): PyraminxFacelets;
+export declare function toPyraminxFacelets(state: PyraminxState): PyraminxFacelets;
+export declare function formatPyraminxFacelets(facelets: PyraminxFacelets): string;
+export declare function getPyraminxFaceOrder(): readonly ("F" | "L" | "R" | "D")[];
+//# sourceMappingURL=facelets.d.ts.map

package/dist/puzzles/pyraminx/facelets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facelets.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/facelets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;AA6DhF,wBAAgB,4BAA4B,IAAI,gBAAgB,CAO/D;AAyBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAiCzE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEzE;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,CAEzE"}

package/dist/puzzles/pyraminx/facelets.js

@@ -0,0 +1,97 @@
+const FACE_ORDER = ["F", "L", "R", "D"];
+// positionId -> sticker slots (each slot = one triangle cell of the grid).
+// Positions follow the scrambler piece model (moves.ts):
+//   edges 0..5 = UL, UR, UB, LR, LB, RB
+//   centers 0..3 = U, L, R, B
+//   tips 0..3 = U, L, R, B
+//
+// The slot layout is validated against the piece model by
+// test/pyraminx-facelets.test.ts (single moves + randomized sequences).
+const EDGE_POSITION_SLOTS = [
+    [["F", 1], ["L", 7]], // 0 UL
+    [["F", 3], ["R", 5]], // 1 UR
+    [["L", 2], ["R", 2]], // 2 UB
+    [["F", 6], ["D", 2]], // 3 LR
+    [["L", 5], ["D", 5]], // 4 LB
+    [["R", 7], ["D", 7]], // 5 RB
+];
+const CENTER_POSITION_SLOTS = [
+    [["F", 2], ["L", 3], ["R", 1]], // 0 U
+    [["F", 5], ["L", 6], ["D", 1]], // 1 L
+    [["F", 7], ["R", 6], ["D", 3]], // 2 R
+    [["L", 1], ["R", 3], ["D", 6]], // 3 B
+];
+const TIP_POSITION_SLOTS = [
+    [["F", 0], ["L", 4], ["R", 0]], // 0 U
+    [["F", 4], ["D", 0], ["L", 8]], // 1 L
+    [["F", 8], ["R", 8], ["D", 4]], // 2 R
+    [["L", 0], ["D", 8], ["R", 4]], // 3 B
+];
+// pieceId -> sticker colors (canonical order aligned with the role order above)
+const EDGE_PIECE_STICKERS = [
+    ["F", "L"], // 0 UL
+    ["F", "R"], // 1 UR
+    ["L", "R"], // 2 UB
+    ["F", "D"], // 3 LR
+    ["L", "D"], // 4 LB
+    ["R", "D"], // 5 RB
+];
+const CENTER_PIECE_STICKERS = [
+    ["F", "L", "R"], // 0 U
+    ["F", "L", "D"], // 1 L
+    ["F", "R", "D"], // 2 R
+    ["L", "R", "D"], // 3 B
+];
+const TIP_PIECE_STICKERS = [
+    ["F", "L", "R"], // 0 U
+    ["F", "D", "L"], // 1 L
+    ["F", "R", "D"], // 2 R
+    ["L", "D", "R"], // 3 B
+];
+export function createSolvedPyraminxFacelets() {
+    return {
+        F: Array.from({ length: 9 }, () => "F"),
+        L: Array.from({ length: 9 }, () => "L"),
+        R: Array.from({ length: 9 }, () => "R"),
+        D: Array.from({ length: 9 }, () => "D"),
+    };
+}
+function createEmptyPyraminxFacelets() {
+    return {
+        F: Array(9).fill("?"),
+        L: Array(9).fill("?"),
+        R: Array(9).fill("?"),
+        D: Array(9).fill("?"),
+    };
+}
+function placeOrientedStickers(facelets, slots, stickers, orientation) {
+    for (let index = 0; index < slots.length; index += 1) {
+        const [face, stickerIndex] = slots[index];
+        const sticker = stickers[(index - orientation + stickers.length) % stickers.length];
+        const arr = facelets[face];
+        arr[stickerIndex] = sticker;
+    }
+}
+export function toPyraminxFacelets(state) {
+    const facelets = createEmptyPyraminxFacelets();
+    for (let position = 0; position < 6; position += 1) {
+        const piece = state.edgesPerm[position];
+        const orientation = state.edgesOrient[position];
+        placeOrientedStickers(facelets, EDGE_POSITION_SLOTS[position], EDGE_PIECE_STICKERS[piece], orientation);
+    }
+    for (let position = 0; position < 4; position += 1) {
+        const orientation = state.centers[position];
+        placeOrientedStickers(facelets, CENTER_POSITION_SLOTS[position], CENTER_PIECE_STICKERS[position], orientation);
+    }
+    for (let position = 0; position < 4; position += 1) {
+        const orientation = state.tips[position];
+        placeOrientedStickers(facelets, TIP_POSITION_SLOTS[position], TIP_PIECE_STICKERS[position], orientation);
+    }
+    return facelets;
+}
+export function formatPyraminxFacelets(facelets) {
+    return FACE_ORDER.map((face) => facelets[face].join("")).join("");
+}
+export function getPyraminxFaceOrder() {
+    return FACE_ORDER;
+}

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

@@ -5,5 +5,7 @@ export { clonePyraminxState, createSolvedPyraminxState, pyraminxStatesEqual, isS
 export { permutationParity, validatePyraminxState, isAllowedRandomPyraminxState } from "./validation.js";
 export { generateRandomPyraminxState } from "./random-state.js";
 export { pyraminxScrambleGenerator, generatePyraminxScramble } from "./scrambler.js";
+export { createSolvedPyraminxFacelets, formatPyraminxFacelets, getPyraminxFaceOrder, toPyraminxFacelets } from "./facelets.js";
+export type { PyraminxFacelets } from "./facelets.js";
 export { solvePyraminx } from "./solver.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACd,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACd,MAAM,aAAa,CAAC"}

package/dist/puzzles/pyraminx/index.js

@@ -4,4 +4,5 @@ export { clonePyraminxState, createSolvedPyraminxState, pyraminxStatesEqual, isS
 export { permutationParity, validatePyraminxState, isAllowedRandomPyraminxState } from "./validation.js";
 export { generateRandomPyraminxState } from "./random-state.js";
 export { pyraminxScrambleGenerator, generatePyraminxScramble } from "./scrambler.js";
+export { createSolvedPyraminxFacelets, formatPyraminxFacelets, getPyraminxFaceOrder, toPyraminxFacelets } from "./facelets.js";
 export { solvePyraminx } from "./solver.js";

package/dist/puzzles/pyraminx/moves.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"moves.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/moves.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAqC,MAAM,YAAY,CAAC;AAKjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,CA4BzF;AA8DD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,aAAa,CAE1G;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAEtF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAMxE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAU7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAKnE"}
+{"version":3,"file":"moves.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/moves.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAqC,MAAM,YAAY,CAAC;AAKjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,CA4BzF;AA2DD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,aAAa,CAE1G;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAEtF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAMxE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAU7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAKnE"}

package/dist/puzzles/pyraminx/moves.js

@@ -30,56 +30,53 @@ function applySingleCoreMoveCW(state, face) {
     const centers = state.centers;
     const perm = state.edgesPerm;
     const orient = state.edgesOrient;
+    const tips = state.tips;
     // Clone arrays for temporary storage
     const prevPerm = [...perm];
     const prevOrient = [...orient];
     if (face === "U") {
-        // Center
+        // U: UL -> UB -> UR -> UL with the physical orientation (matches viz)
         centers[0] = (centers[0] + 1) % 3;
-        // Edges cycle: 0 -> 1 -> 2 -> 0 (UL -> UR -> UB -> UL)
-        // No orientation flips for U
-        perm[1] = prevPerm[0];
-        perm[2] = prevPerm[1];
-        perm[0] = prevPerm[2];
-        orient[1] = prevOrient[0];
-        orient[2] = prevOrient[1];
-        orient[0] = prevOrient[2];
+        tips[0] = (tips[0] + 1) % 3;
+        perm[0] = prevPerm[1];
+        perm[1] = prevPerm[2];
+        perm[2] = prevPerm[0];
+        orient[0] = (prevOrient[1] + 1) % 2;
+        orient[1] = (prevOrient[2] + 1) % 2;
+        orient[2] = prevOrient[0];
     }
     else if (face === "L") {
-        // Center
-        centers[1] = (centers[1] + 1) % 3;
-        // Edges cycle: 0 -> 4 -> 3 -> 0 (UL -> LB -> LR -> UL)
-        // Flips: UL(0) flips, LB(4) flips, LR(3) does not flip
-        perm[4] = prevPerm[0];
-        perm[3] = prevPerm[4];
-        perm[0] = prevPerm[3];
-        orient[4] = (prevOrient[0] + 1) % 2;
-        orient[3] = (prevOrient[4] + 1) % 2;
-        orient[0] = prevOrient[3];
+        // L: UL -> LB -> LR -> UL (physical, matches viz)
+        centers[1] = (centers[1] + 2) % 3;
+        tips[1] = (tips[1] + 1) % 3;
+        perm[0] = prevPerm[4];
+        perm[3] = prevPerm[0];
+        perm[4] = prevPerm[3];
+        orient[0] = prevOrient[4];
+        orient[3] = (prevOrient[0] + 1) % 2;
+        orient[4] = (prevOrient[3] + 1) % 2;
     }
     else if (face === "R") {
-        // Center
+        // R: UR -> LR -> RB -> UR (physical, matches viz)
         centers[2] = (centers[2] + 1) % 3;
-        // Edges cycle: 1 -> 3 -> 5 -> 1 (UR -> LR -> RB -> UR)
-        // Flips: UR(1) flips, LR(3) flips, RB(5) does not flip
-        perm[3] = prevPerm[1];
-        perm[5] = prevPerm[3];
-        perm[1] = prevPerm[5];
-        orient[3] = (prevOrient[1] + 1) % 2;
-        orient[5] = (prevOrient[3] + 1) % 2;
-        orient[1] = prevOrient[5];
+        tips[2] = (tips[2] + 1) % 3;
+        perm[1] = prevPerm[3];
+        perm[3] = prevPerm[5];
+        perm[5] = prevPerm[1];
+        orient[1] = (prevOrient[3] + 1) % 2;
+        orient[3] = (prevOrient[5] + 1) % 2;
+        orient[5] = prevOrient[1];
     }
     else if (face === "B") {
-        // Center
-        centers[3] = (centers[3] + 1) % 3;
-        // Edges cycle: 2 -> 5 -> 4 -> 2 (UB -> RB -> LB -> UB)
-        // Flips: UB(2) flips, RB(5) flips, LB(4) does not flip
-        perm[5] = prevPerm[2];
-        perm[4] = prevPerm[5];
-        perm[2] = prevPerm[4];
-        orient[5] = (prevOrient[2] + 1) % 2;
-        orient[4] = (prevOrient[5] + 1) % 2;
-        orient[2] = prevOrient[4];
+        // B: UB -> LB -> RB -> UB (physical, matches viz)
+        centers[3] = (centers[3] + 2) % 3;
+        tips[3] = (tips[3] + 1) % 3;
+        perm[2] = prevPerm[5];
+        perm[4] = prevPerm[2];
+        perm[5] = prevPerm[4];
+        orient[2] = prevOrient[5];
+        orient[4] = (prevOrient[2] + 1) % 2;
+        orient[5] = (prevOrient[4] + 1) % 2;
     }
 }
 export function applyPyraminxAlgorithm(state, moves) {

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

@@ -1 +1 @@
-{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/scrambler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO9F,eAAO,MAAM,yBAAyB,EAAE,iBAYvC,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,eAAe,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,cAAc,CAAC,CAyCzB"}
+{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/pyraminx/scrambler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ9F,eAAO,MAAM,yBAAyB,EAAE,iBAYvC,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,eAAe,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,cAAc,CAAC,CA+CzB"}

package/dist/puzzles/pyraminx/scrambler.js

@@ -2,9 +2,10 @@ import { generateRandomPyraminxState } from "./random-state.js";
 import { createSolvedPyraminxState } from "./state.js";
 import { applyPyraminxAlgorithm, invertPyraminxAlgorithm } from "./moves.js";
 import { solvePyraminx } from "./solver.js";
+import { formatPyraminxFacelets, toPyraminxFacelets } from "./facelets.js";
 export const pyraminxScrambleGenerator = {
     info: {
-        eventId: "pyrso",
+        eventId: "pyra",
         name: "Pyraminx",
         puzzle: "pyraminx",
         quality: "random-state",
@@ -20,15 +21,17 @@ export async function generatePyraminxScramble(options = {}) {
     // Solve the core edges and centers
     const solution = solvePyraminx(state);
     const scrambleMoves = invertPyraminxAlgorithm(solution);
-    // Append tips to scrambleMoves
+    // 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 = applyPyraminxAlgorithm(createSolvedPyraminxState(), scrambleMoves);
     const finalMoves = [...scrambleMoves];
     const tipsNotation = ["u", "l", "r", "b"];
     for (let i = 0; i < 4; i++) {
-        const tipVal = state.tips[i];
-        if (tipVal === 1) {
+        const delta = (state.tips[i] - coreState.tips[i] + 3) % 3;
+        if (delta === 1) {
             finalMoves.push(tipsNotation[i]);
         }
-        else if (tipVal === 2) {
+        else if (delta === 2) {
             finalMoves.push(`${tipsNotation[i]}'`);
         }
     }
@@ -41,14 +44,17 @@ export async function generatePyraminxScramble(options = {}) {
             throw new Error("Generated Pyraminx scramble does not reproduce the target random state.");
         }
     }
+    const facelets = toPyraminxFacelets(state);
     return {
-        eventId: "pyrso",
+        eventId: "pyra",
         scramble: finalMoves.join(" "),
         moves: finalMoves,
         quality: "random-state",
         generator: "pyraminx-ida-star",
         metadata: {
             state,
+            facelets,
+            faceletString: formatPyraminxFacelets(facelets),
             solutionMoves: solution,
             solutionDepth: solution.length
         }

package/dist/puzzles/skewb/facelets.d.ts

@@ -0,0 +1,6 @@
+import type { SkewbFacelets, SkewbState } from "./types.js";
+export declare function createSolvedSkewbFacelets(): SkewbFacelets;
+export declare function toSkewbFacelets(state: SkewbState): SkewbFacelets;
+export declare function formatSkewbFacelets(facelets: SkewbFacelets): string;
+export declare function getSkewbFaceOrder(): readonly string[];
+//# sourceMappingURL=facelets.d.ts.map

package/dist/puzzles/skewb/facelets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facelets.d.ts","sourceRoot":"","sources":["../../../src/puzzles/skewb/facelets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgC5D,wBAAgB,yBAAyB,IAAI,aAAa,CASzD;AAaD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAsBhE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD"}

package/dist/puzzles/skewb/facelets.js

@@ -0,0 +1,71 @@
+// Facelets model matching cubingcenter-viz/src/puzzles/skewb.ts
+// Each face has 5 stickers: 0=center, 1=TL,2=TR,3=BL,4=BR (net layout)
+const FACE_ORDER = ["U", "R", "F", "D", "L", "B"];
+// Canonical sticker faces per corner position: [UD sticker, RL sticker, FB sticker]
+const CORNER_STICKERS = [
+    ["U", "R", "F"],
+    ["U", "L", "F"],
+    ["U", "R", "B"],
+    ["U", "L", "B"],
+    ["D", "R", "F"],
+    ["D", "L", "F"],
+    ["D", "R", "B"],
+    ["D", "L", "B"],
+];
+// Facelet index of each corner position on each of its 3 faces, aligned with CORNER_STICKERS order.
+const CORNER_SLOTS = [
+    [["U", 4], ["R", 1], ["F", 2]],
+    [["U", 3], ["L", 2], ["F", 1]],
+    [["U", 2], ["R", 2], ["B", 1]],
+    [["U", 1], ["L", 1], ["B", 2]],
+    [["D", 2], ["R", 3], ["F", 4]],
+    [["D", 1], ["L", 4], ["F", 3]],
+    [["D", 4], ["R", 4], ["B", 3]],
+    [["D", 3], ["L", 3], ["B", 4]],
+];
+export function createSolvedSkewbFacelets() {
+    return {
+        U: Array.from({ length: 5 }, () => "U"),
+        R: Array.from({ length: 5 }, () => "R"),
+        F: Array.from({ length: 5 }, () => "F"),
+        D: Array.from({ length: 5 }, () => "D"),
+        L: Array.from({ length: 5 }, () => "L"),
+        B: Array.from({ length: 5 }, () => "B"),
+    };
+}
+function createEmptySkewbFacelets() {
+    return {
+        U: Array(5).fill("?"),
+        R: Array(5).fill("?"),
+        F: Array(5).fill("?"),
+        D: Array(5).fill("?"),
+        L: Array(5).fill("?"),
+        B: Array(5).fill("?"),
+    };
+}
+export function toSkewbFacelets(state) {
+    const facelets = createEmptySkewbFacelets();
+    // centers
+    for (let face = 0; face < 6; face++) {
+        const targetFace = FACE_ORDER[face];
+        facelets[targetFace][0] = FACE_ORDER[state.centers[face]];
+    }
+    // corners
+    for (let pos = 0; pos < 8; pos++) {
+        const piece = state.corners.permutation[pos];
+        const ori = state.corners.orientation[pos];
+        const slots = CORNER_SLOTS[pos];
+        const stickers = CORNER_STICKERS[piece];
+        for (let i = 0; i < 3; i++) {
+            const [face, idx] = slots[i];
+            facelets[face][idx] = stickers[(i + 3 - ori) % 3];
+        }
+    }
+    return facelets;
+}
+export function formatSkewbFacelets(facelets) {
+    return FACE_ORDER.map((face) => facelets[face].join("")).join("");
+}
+export function getSkewbFaceOrder() {
+    return FACE_ORDER;
+}

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

@@ -0,0 +1,10 @@
+export { SKEWB_MOVES, SKEWB_FACES } from "./types.js";
+export type { SkewbMove, SkewbState, SkewbFaceMove, SkewbRandomStateOptions, SkewbFacelets } from "./types.js";
+export { applySkewbAlgorithm, applySkewbMove, formatSkewbAlgorithm, invertSkewbAlgorithm, invertSkewbMove, parseSkewbAlgorithm, parseSkewbMove, } from "./moves.js";
+export { cloneSkewbState, createSolvedSkewbState, isSolvedSkewbState, skewbStatesEqual, } from "./state.js";
+export { permutationParity, validateSkewbState, isAllowedRandomSkewbState, isOneMoveFromSolvedSkewbState } from "./validation.js";
+export { generateRandomSkewbState } from "./random-state.js";
+export { createSolvedSkewbFacelets, formatSkewbFacelets, getSkewbFaceOrder, toSkewbFacelets } from "./facelets.js";
+export { solveSkewb, getStateIndex, getStateFromIndex } from "./solver.js";
+export { generateSkewbScramble, skewbScrambleGenerator } from "./scrambler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/puzzles/skewb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAClI,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/puzzles/skewb/index.js

@@ -0,0 +1,8 @@
+export { SKEWB_MOVES, SKEWB_FACES } from "./types.js";
+export { applySkewbAlgorithm, applySkewbMove, formatSkewbAlgorithm, invertSkewbAlgorithm, invertSkewbMove, parseSkewbAlgorithm, parseSkewbMove, } from "./moves.js";
+export { cloneSkewbState, createSolvedSkewbState, isSolvedSkewbState, skewbStatesEqual, } from "./state.js";
+export { permutationParity, validateSkewbState, isAllowedRandomSkewbState, isOneMoveFromSolvedSkewbState } from "./validation.js";
+export { generateRandomSkewbState } from "./random-state.js";
+export { createSolvedSkewbFacelets, formatSkewbFacelets, getSkewbFaceOrder, toSkewbFacelets } from "./facelets.js";
+export { solveSkewb, getStateIndex, getStateFromIndex } from "./solver.js";
+export { generateSkewbScramble, skewbScrambleGenerator } from "./scrambler.js";

package/dist/puzzles/skewb/moves.d.ts

@@ -0,0 +1,19 @@
+import type { SkewbMove, SkewbState } from "./types.js";
+interface MoveTable {
+    corners: {
+        permutation: readonly number[];
+        orientation: readonly number[];
+    };
+    centers: readonly number[];
+}
+declare const MOVE_TABLES: Record<string, MoveTable>;
+export declare function applySkewbMove(state: SkewbState, move: SkewbMove): SkewbState;
+export declare function applySkewbAlgorithm(state: SkewbState, moves: readonly SkewbMove[]): SkewbState;
+export declare function invertSkewbMove(move: SkewbMove): SkewbMove;
+export declare function invertSkewbAlgorithm(moves: readonly SkewbMove[]): SkewbMove[];
+export declare function parseSkewbMove(value: string): SkewbMove;
+export declare function parseSkewbAlgorithm(algorithm: string): SkewbMove[];
+export declare function formatSkewbAlgorithm(moves: readonly SkewbMove[]): string;
+export declare function getAllSkewbMovesForTables(): readonly string[];
+export { MOVE_TABLES };
+//# sourceMappingURL=moves.d.ts.map

package/dist/puzzles/skewb/moves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moves.d.ts","sourceRoot":"","sources":["../../../src/puzzles/skewb/moves.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxD,UAAU,SAAS;IACjB,OAAO,EAAE;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,QAAA,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAyB1C,CAAC;AAkBF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CAS7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,CAE9F;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAG1D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAE7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAGvD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAIlE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAExE;AAGD,wBAAgB,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAE7D;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/puzzles/skewb/moves.js

@@ -0,0 +1,84 @@
+import { SKEWB_MOVES } from "./types.js";
+import { cloneSkewbState } from "./state.js";
+const MOVE_TABLES = {
+    F: {
+        corners: { permutation: [0, 4, 1, 3, 2, 5, 6, 7], orientation: [1, 1, 1, 0, 1, 0, 0, 0] },
+        centers: [2, 0, 1, 3, 4, 5],
+    },
+    D: {
+        corners: { permutation: [5, 1, 2, 3, 4, 6, 0, 7], orientation: [2, 0, 0, 0, 2, 2, 2, 0] },
+        centers: [0, 2, 3, 1, 4, 5],
+    },
+    U: {
+        corners: { permutation: [0, 2, 7, 3, 4, 5, 6, 1], orientation: [0, 1, 1, 1, 0, 0, 0, 1] },
+        centers: [5, 1, 2, 3, 0, 4],
+    },
+    R: {
+        corners: { permutation: [0, 1, 4, 3, 7, 5, 6, 2], orientation: [0, 0, 1, 0, 1, 0, 1, 1] },
+        centers: [0, 3, 2, 5, 4, 1],
+    },
+    L: {
+        corners: { permutation: [0, 7, 2, 3, 1, 5, 6, 4], orientation: [0, 1, 0, 0, 1, 1, 0, 1] },
+        centers: [0, 1, 4, 2, 3, 5],
+    },
+    B: {
+        corners: { permutation: [0, 1, 2, 6, 4, 3, 5, 7], orientation: [0, 0, 0, 2, 0, 2, 2, 2] },
+        centers: [0, 1, 2, 4, 5, 3],
+    },
+};
+function applyFaceMove(state, table) {
+    const perm = state.corners.permutation;
+    const orient = state.corners.orientation;
+    const centers = state.centers;
+    const newPerm = table.corners.permutation.map((src) => perm[src]);
+    const newOrient = table.corners.permutation.map((src, tgt) => (orient[src] + table.corners.orientation[tgt]) % 3);
+    const newCenters = table.centers.map((src) => centers[src]);
+    for (let i = 0; i < perm.length; i++)
+        perm[i] = newPerm[i];
+    for (let i = 0; i < orient.length; i++)
+        orient[i] = newOrient[i];
+    for (let i = 0; i < centers.length; i++)
+        centers[i] = newCenters[i];
+}
+export function applySkewbMove(state, move) {
+    const face = move[0].toUpperCase();
+    const suffix = move.slice(1);
+    const table = MOVE_TABLES[face];
+    if (!table)
+        throw new Error(`Unknown Skewb move: ${move}`);
+    const repetitions = suffix === "'" || suffix === "2" ? 2 : 1;
+    const next = cloneSkewbState(state);
+    for (let i = 0; i < repetitions; i++)
+        applyFaceMove(next, table);
+    return next;
+}
+export function applySkewbAlgorithm(state, moves) {
+    return moves.reduce((current, move) => applySkewbMove(current, move), state);
+}
+export function invertSkewbMove(move) {
+    if (move.endsWith("'"))
+        return move.slice(0, -1);
+    return `${move}'`;
+}
+export function invertSkewbAlgorithm(moves) {
+    return [...moves].reverse().map(invertSkewbMove);
+}
+export function parseSkewbMove(value) {
+    if (SKEWB_MOVES.includes(value))
+        return value;
+    throw new Error(`Invalid Skewb move: ${value}`);
+}
+export function parseSkewbAlgorithm(algorithm) {
+    const trimmed = algorithm.trim();
+    if (trimmed.length === 0)
+        return [];
+    return trimmed.split(/\s+/).map(parseSkewbMove);
+}
+export function formatSkewbAlgorithm(moves) {
+    return moves.join(" ");
+}
+// For internal use by solver (needs all 6 faces for table generation)
+export function getAllSkewbMovesForTables() {
+    return ["R", "U", "L", "B", "F", "D"].flatMap((f) => [f, `${f}'`]);
+}
+export { MOVE_TABLES };

package/dist/puzzles/skewb/random-state.d.ts

@@ -0,0 +1,3 @@
+import type { SkewbRandomStateOptions, SkewbState } from "./types.js";
+export declare function generateRandomSkewbState(options?: SkewbRandomStateOptions): SkewbState;
+//# sourceMappingURL=random-state.d.ts.map

package/dist/puzzles/skewb/random-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-state.d.ts","sourceRoot":"","sources":["../../../src/puzzles/skewb/random-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMtE,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAS1F"}

package/dist/puzzles/skewb/random-state.js

@@ -0,0 +1,27 @@
+import { createRandomSource } from "../../random/index.js";
+import { isAllowedRandomSkewbState } from "./validation.js";
+import { applySkewbMove } from "./moves.js";
+import { createSolvedSkewbState } from "./state.js";
+import { SKEWB_MOVES } from "./types.js";
+export function generateRandomSkewbState(options = {}) {
+    const random = createRandomSource(options.seed);
+    const rejectTrivial = options.rejectTrivial ?? true;
+    for (let attempt = 0; attempt < 100; attempt++) {
+        const state = createLegalRandomState(random);
+        if (!rejectTrivial || isAllowedRandomSkewbState(state))
+            return state;
+    }
+    throw new Error("Unable to generate a non-trivial random Skewb state.");
+}
+function createLegalRandomState(random) {
+    // Generate a random reachable Skewb state via random walk from solved.
+    // Skewb has 3,149,280 reachable states with WCA moves (fixed corner).
+    // A walk of 30+ moves is sufficient to approach uniform distribution.
+    let state = createSolvedSkewbState();
+    const walkLength = 30 + random.nextInt(5); // 30-34 moves
+    for (let i = 0; i < walkLength; i++) {
+        const move = random.choice([...SKEWB_MOVES]);
+        state = applySkewbMove(state, move);
+    }
+    return state;
+}

package/dist/puzzles/skewb/scrambler.d.ts

@@ -0,0 +1,6 @@
+import type { ScrambleGenerator, ScrambleOptions, ScrambleResult } from "../../core/index.js";
+export declare const skewbScrambleGenerator: ScrambleGenerator;
+export declare function generateSkewbScramble(options?: ScrambleOptions & {
+    skipValidation?: boolean;
+}): Promise<ScrambleResult>;
+//# sourceMappingURL=scrambler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrambler.d.ts","sourceRoot":"","sources":["../../../src/puzzles/skewb/scrambler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO9F,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,CAiCzB"}