cubegin 0.0.1

package/dist/scramble-puzzle/src/square1/square1-state.mjs

@@ -0,0 +1,115 @@
+import { InvalidMoveError } from "../errors.mjs";
+import { validateSquareOneMove } from "./square1-parser.mjs";
+//#region ../scramble-puzzle/src/square1/square1-state.ts
+const PIECE_COUNT = 24;
+const TOP_START = 0;
+const BOTTOM_START = 12;
+const HALF_PIECE_COUNT = 12;
+const SLICE_WIDTH = 6;
+const SOLVED_SQUARE_ONE_PIECES = [
+	0,
+	0,
+	1,
+	2,
+	2,
+	3,
+	4,
+	4,
+	5,
+	6,
+	6,
+	7,
+	8,
+	9,
+	9,
+	10,
+	11,
+	11,
+	12,
+	13,
+	13,
+	14,
+	15,
+	15
+];
+const SQUARE_ONE_TURNS = [
+	-5,
+	-4,
+	-3,
+	-2,
+	-1,
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+const createSquareOneState = (sliceSolved, pieces) => {
+	if (pieces.length !== PIECE_COUNT) throw new RangeError(`square1 state must contain 24 piece positions: ${pieces.length}`);
+	for (const piece of pieces) if (!Number.isSafeInteger(piece) || piece < 0 || piece > 15) throw new RangeError("square1 pieces must be integer piece indexes from 0 to 15");
+	return Object.freeze({
+		sliceSolved,
+		pieces: Object.freeze([...pieces])
+	});
+};
+const rotateHalf = (pieces, start, turn) => {
+	const offset = (-turn % HALF_PIECE_COUNT + HALF_PIECE_COUNT) % HALF_PIECE_COUNT;
+	const half = pieces.slice(start, start + HALF_PIECE_COUNT);
+	for (let index = 0; index < HALF_PIECE_COUNT; index += 1) pieces[start + index] = half[(offset + index) % HALF_PIECE_COUNT];
+};
+const rotateTopAndBottom = (pieces, move) => {
+	const nextPieces = [...pieces];
+	rotateHalf(nextPieces, TOP_START, move.top);
+	rotateHalf(nextPieces, BOTTOM_START, move.bottom);
+	return nextPieces;
+};
+const slashPieces = (pieces) => {
+	const nextPieces = [...pieces];
+	for (let index = 0; index < SLICE_WIDTH; index += 1) {
+		const topIndex = TOP_START + SLICE_WIDTH + index;
+		const bottomIndex = BOTTOM_START + index;
+		const bottomPiece = nextPieces[bottomIndex];
+		nextPieces[bottomIndex] = nextPieces[topIndex];
+		nextPieces[topIndex] = bottomPiece;
+	}
+	return nextPieces;
+};
+const createSolvedSquareOneState = () => createSquareOneState(true, SOLVED_SQUARE_ONE_PIECES);
+const canSquareOneSlash = (state) => state.pieces[0] !== state.pieces[11] && state.pieces[6] !== state.pieces[5] && state.pieces[12] !== state.pieces[23] && state.pieces[18] !== state.pieces[17];
+const applySquareOneMove = (state, move) => {
+	const validMove = validateSquareOneMove(move);
+	if (validMove.type === "slash") {
+		if (!canSquareOneSlash(state)) throw new InvalidMoveError("/", "square1");
+		return createSquareOneState(!state.sliceSolved, slashPieces(state.pieces));
+	}
+	return createSquareOneState(state.sliceSolved, rotateTopAndBottom(state.pieces, validMove));
+};
+const areSquareOneStatesEqual = (a, b) => a.sliceSolved === b.sliceSolved && a.pieces.length === PIECE_COUNT && b.pieces.length === PIECE_COUNT && a.pieces.every((piece, index) => piece === b.pieces[index]);
+const getSquareOneSuccessors = (state) => {
+	const successors = [];
+	for (const top of SQUARE_ONE_TURNS) for (const bottom of SQUARE_ONE_TURNS) {
+		if (top === 0 && bottom === 0) continue;
+		const move = {
+			type: "tuple",
+			top,
+			bottom
+		};
+		successors.push({
+			move,
+			state: applySquareOneMove(state, move)
+		});
+	}
+	if (canSquareOneSlash(state)) {
+		const move = { type: "slash" };
+		successors.push({
+			move,
+			state: applySquareOneMove(state, move)
+		});
+	}
+	return Object.freeze(successors);
+};
+const getSquareOneScrambleSuccessors = (state) => getSquareOneSuccessors(state).filter((successor) => canSquareOneSlash(successor.state));
+//#endregion
+export { applySquareOneMove, areSquareOneStatesEqual, canSquareOneSlash, createSolvedSquareOneState, getSquareOneScrambleSuccessors, getSquareOneSuccessors };

package/dist/scramble-puzzle/src/square1/square1-state2.d.mts

@@ -0,0 +1,21 @@
+import { SquareOneMove } from "./square1-parser.mjs";
+
+//#region .build/vendor/scramble-puzzle/src/square1/square1-state.d.ts
+type SquareOnePiece = number;
+type SquareOnePieces = readonly SquareOnePiece[];
+interface SquareOneState {
+  readonly sliceSolved: boolean;
+  readonly pieces: SquareOnePieces;
+}
+interface SquareOneSuccessor {
+  readonly move: SquareOneMove;
+  readonly state: SquareOneState;
+}
+declare const createSolvedSquareOneState: () => SquareOneState;
+declare const canSquareOneSlash: (state: SquareOneState) => boolean;
+declare const applySquareOneMove: (state: SquareOneState, move: SquareOneMove) => SquareOneState;
+declare const areSquareOneStatesEqual: (a: SquareOneState, b: SquareOneState) => boolean;
+declare const getSquareOneSuccessors: (state: SquareOneState) => readonly SquareOneSuccessor[];
+declare const getSquareOneScrambleSuccessors: (state: SquareOneState) => readonly SquareOneSuccessor[];
+//#endregion
+export { SquareOnePiece, SquareOnePieces, SquareOneState, SquareOneSuccessor, applySquareOneMove, areSquareOneStatesEqual, canSquareOneSlash, createSolvedSquareOneState, getSquareOneScrambleSuccessors, getSquareOneSuccessors };

package/dist/scramble-puzzle/src/square1/square1-state2.mjs

@@ -0,0 +1,115 @@
+import { InvalidMoveError } from "../errors2.mjs";
+import { validateSquareOneMove } from "./square1-parser2.mjs";
+//#region .build/vendor/scramble-puzzle/src/square1/square1-state.ts
+const PIECE_COUNT = 24;
+const TOP_START = 0;
+const BOTTOM_START = 12;
+const HALF_PIECE_COUNT = 12;
+const SLICE_WIDTH = 6;
+const SOLVED_SQUARE_ONE_PIECES = [
+	0,
+	0,
+	1,
+	2,
+	2,
+	3,
+	4,
+	4,
+	5,
+	6,
+	6,
+	7,
+	8,
+	9,
+	9,
+	10,
+	11,
+	11,
+	12,
+	13,
+	13,
+	14,
+	15,
+	15
+];
+const SQUARE_ONE_TURNS = [
+	-5,
+	-4,
+	-3,
+	-2,
+	-1,
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+const createSquareOneState = (sliceSolved, pieces) => {
+	if (pieces.length !== PIECE_COUNT) throw new RangeError(`square1 state must contain 24 piece positions: ${pieces.length}`);
+	for (const piece of pieces) if (!Number.isSafeInteger(piece) || piece < 0 || piece > 15) throw new RangeError("square1 pieces must be integer piece indexes from 0 to 15");
+	return Object.freeze({
+		sliceSolved,
+		pieces: Object.freeze([...pieces])
+	});
+};
+const rotateHalf = (pieces, start, turn) => {
+	const offset = (-turn % HALF_PIECE_COUNT + HALF_PIECE_COUNT) % HALF_PIECE_COUNT;
+	const half = pieces.slice(start, start + HALF_PIECE_COUNT);
+	for (let index = 0; index < HALF_PIECE_COUNT; index += 1) pieces[start + index] = half[(offset + index) % HALF_PIECE_COUNT];
+};
+const rotateTopAndBottom = (pieces, move) => {
+	const nextPieces = [...pieces];
+	rotateHalf(nextPieces, TOP_START, move.top);
+	rotateHalf(nextPieces, BOTTOM_START, move.bottom);
+	return nextPieces;
+};
+const slashPieces = (pieces) => {
+	const nextPieces = [...pieces];
+	for (let index = 0; index < SLICE_WIDTH; index += 1) {
+		const topIndex = TOP_START + SLICE_WIDTH + index;
+		const bottomIndex = BOTTOM_START + index;
+		const bottomPiece = nextPieces[bottomIndex];
+		nextPieces[bottomIndex] = nextPieces[topIndex];
+		nextPieces[topIndex] = bottomPiece;
+	}
+	return nextPieces;
+};
+const createSolvedSquareOneState = () => createSquareOneState(true, SOLVED_SQUARE_ONE_PIECES);
+const canSquareOneSlash = (state) => state.pieces[0] !== state.pieces[11] && state.pieces[6] !== state.pieces[5] && state.pieces[12] !== state.pieces[23] && state.pieces[18] !== state.pieces[17];
+const applySquareOneMove = (state, move) => {
+	const validMove = validateSquareOneMove(move);
+	if (validMove.type === "slash") {
+		if (!canSquareOneSlash(state)) throw new InvalidMoveError("/", "square1");
+		return createSquareOneState(!state.sliceSolved, slashPieces(state.pieces));
+	}
+	return createSquareOneState(state.sliceSolved, rotateTopAndBottom(state.pieces, validMove));
+};
+const areSquareOneStatesEqual = (a, b) => a.sliceSolved === b.sliceSolved && a.pieces.length === PIECE_COUNT && b.pieces.length === PIECE_COUNT && a.pieces.every((piece, index) => piece === b.pieces[index]);
+const getSquareOneSuccessors = (state) => {
+	const successors = [];
+	for (const top of SQUARE_ONE_TURNS) for (const bottom of SQUARE_ONE_TURNS) {
+		if (top === 0 && bottom === 0) continue;
+		const move = {
+			type: "tuple",
+			top,
+			bottom
+		};
+		successors.push({
+			move,
+			state: applySquareOneMove(state, move)
+		});
+	}
+	if (canSquareOneSlash(state)) {
+		const move = { type: "slash" };
+		successors.push({
+			move,
+			state: applySquareOneMove(state, move)
+		});
+	}
+	return Object.freeze(successors);
+};
+const getSquareOneScrambleSuccessors = (state) => getSquareOneSuccessors(state).filter((successor) => canSquareOneSlash(successor.state));
+//#endregion
+export { applySquareOneMove, areSquareOneStatesEqual, canSquareOneSlash, createSolvedSquareOneState, getSquareOneScrambleSuccessors, getSquareOneSuccessors };

package/dist/scramble-puzzle.d.mts

@@ -0,0 +1,25 @@
+import { PuzzleId, WCA_EVENT_IDS, WCA_EVENT_INFO, WcaEventId, WcaEventInfo } from "./scramble-puzzle/src/events2.mjs";
+import { AppliedPuzzleState, PuzzleDefinition } from "./scramble-puzzle/src/puzzle-definition.mjs";
+import { applyAlgorithm, splitAlgorithm } from "./scramble-puzzle/src/algorithm.mjs";
+import { CubeFace, CubeLayerMove, CubeMove, CubeRotationMove } from "./scramble-puzzle/src/cube/cube-move2.mjs";
+import { CubeFaceState, CubeFacelet, CubeImage, CubeState, applyCubeMove, areCubeStatesEqual, createSolvedCubeState } from "./scramble-puzzle/src/cube/cube-state2.mjs";
+import { createCubeDefinition } from "./scramble-puzzle/src/cube/cube-definition.mjs";
+import { parseCubeAlgorithm, parseCubeMove } from "./scramble-puzzle/src/cube/cube-parser.mjs";
+import { ClockDirection, ClockMove, ClockRotationMove, ClockTurnMove, ClockTurnName, parseClockAlgorithm, parseClockMove } from "./scramble-puzzle/src/clock/clock-parser.mjs";
+import { ClockPositions, ClockState, applyClockMove, areClockStatesEqual, createSolvedClockState } from "./scramble-puzzle/src/clock/clock-state2.mjs";
+import { createClockDefinition } from "./scramble-puzzle/src/clock/clock-definition.mjs";
+import { MEGAMINX_FACES, MegaminxBigTurnMove, MegaminxBigTurnName, MegaminxFace, MegaminxFaceMove, MegaminxMove, MegaminxMoveAmount, parseMegaminxAlgorithm, parseMegaminxMove } from "./scramble-puzzle/src/megaminx/megaminx-parser2.mjs";
+import { MegaminxFaceState, MegaminxFacelet, MegaminxImage, MegaminxState, applyMegaminxMove, areMegaminxStatesEqual, createSolvedMegaminxState } from "./scramble-puzzle/src/megaminx/megaminx-state2.mjs";
+import { createMegaminxDefinition } from "./scramble-puzzle/src/megaminx/megaminx-definition.mjs";
+import { PYRAMINX_AXES, PYRAMINX_FACES, PyraminxAxis, PyraminxFace, PyraminxMove, PyraminxMoveAmount, PyraminxTipMove, PyraminxTurnMove, parsePyraminxAlgorithm, parsePyraminxMove } from "./scramble-puzzle/src/pyraminx/pyraminx-parser2.mjs";
+import { PyraminxFaceState, PyraminxFacelet, PyraminxImage, PyraminxState, applyPyraminxMove, arePyraminxStatesEqual, createSolvedPyraminxState } from "./scramble-puzzle/src/pyraminx/pyraminx-state2.mjs";
+import { createPyraminxDefinition } from "./scramble-puzzle/src/pyraminx/pyraminx-definition.mjs";
+import { SKEWB_AXES, SKEWB_FACES, SkewbAxis, SkewbFace, SkewbMove, SkewbMoveAmount, parseSkewbAlgorithm, parseSkewbMove } from "./scramble-puzzle/src/skewb/skewb-parser2.mjs";
+import { SkewbFaceState, SkewbFacelet, SkewbImage, SkewbState, applySkewbMove, areSkewbStatesEqual, createSolvedSkewbState } from "./scramble-puzzle/src/skewb/skewb-state2.mjs";
+import { createSkewbDefinition } from "./scramble-puzzle/src/skewb/skewb-definition.mjs";
+import { SquareOneMove, SquareOneSlashMove, SquareOneTupleMove, SquareOneTurn, getSquareOneMoveCost, getSquareOneSlashabilityMoveCost, parseSquareOneAlgorithm, parseSquareOneMove } from "./scramble-puzzle/src/square1/square1-parser.mjs";
+import { SquareOnePiece, SquareOnePieces, SquareOneState, SquareOneSuccessor, applySquareOneMove, areSquareOneStatesEqual, canSquareOneSlash, createSolvedSquareOneState, getSquareOneScrambleSuccessors, getSquareOneSuccessors } from "./scramble-puzzle/src/square1/square1-state2.mjs";
+import { createSquareOneDefinition } from "./scramble-puzzle/src/square1/square1-definition.mjs";
+import { AnyPuzzleDefinition, PuzzleRegistry, createPuzzleRegistry } from "./scramble-puzzle/src/registry.mjs";
+import { InvalidMoveError, InvalidScrambleError, ScramblePuzzleError, UnregisteredPuzzleError } from "./scramble-puzzle/src/errors.mjs";
+export { type AnyPuzzleDefinition, type AppliedPuzzleState, type ClockDirection, type ClockMove, type ClockPositions, type ClockRotationMove, type ClockState, type ClockTurnMove, type ClockTurnName, type CubeFace, type CubeFaceState, type CubeFacelet, type CubeImage, type CubeLayerMove, type CubeMove, type CubeRotationMove, type CubeState, InvalidMoveError, InvalidScrambleError, MEGAMINX_FACES, type MegaminxBigTurnMove, type MegaminxBigTurnName, type MegaminxFace, type MegaminxFaceMove, type MegaminxFaceState, type MegaminxFacelet, type MegaminxImage, type MegaminxMove, type MegaminxMoveAmount, type MegaminxState, PYRAMINX_AXES, PYRAMINX_FACES, type PuzzleDefinition, type PuzzleId, type PuzzleRegistry, type PyraminxAxis, type PyraminxFace, type PyraminxFaceState, type PyraminxFacelet, type PyraminxImage, type PyraminxMove, type PyraminxMoveAmount, type PyraminxState, type PyraminxTipMove, type PyraminxTurnMove, SKEWB_AXES, SKEWB_FACES, ScramblePuzzleError, type SkewbAxis, type SkewbFace, type SkewbFaceState, type SkewbFacelet, type SkewbImage, type SkewbMove, type SkewbMoveAmount, type SkewbState, type SquareOneMove, type SquareOnePiece, type SquareOnePieces, type SquareOneSlashMove, type SquareOneState, type SquareOneSuccessor, type SquareOneTupleMove, type SquareOneTurn, UnregisteredPuzzleError, WCA_EVENT_IDS, WCA_EVENT_INFO, type WcaEventId, type WcaEventInfo, applyAlgorithm, applyClockMove, applyCubeMove, applyMegaminxMove, applyPyraminxMove, applySkewbMove, applySquareOneMove, areClockStatesEqual, areCubeStatesEqual, areMegaminxStatesEqual, arePyraminxStatesEqual, areSkewbStatesEqual, areSquareOneStatesEqual, canSquareOneSlash, createClockDefinition, createCubeDefinition, createMegaminxDefinition, createPuzzleRegistry, createPyraminxDefinition, createSkewbDefinition, createSolvedClockState, createSolvedCubeState, createSolvedMegaminxState, createSolvedPyraminxState, createSolvedSkewbState, createSolvedSquareOneState, createSquareOneDefinition, getSquareOneMoveCost, getSquareOneScrambleSuccessors, getSquareOneSlashabilityMoveCost, getSquareOneSuccessors, parseClockAlgorithm, parseClockMove, parseCubeAlgorithm, parseCubeMove, parseMegaminxAlgorithm, parseMegaminxMove, parsePyraminxAlgorithm, parsePyraminxMove, parseSkewbAlgorithm, parseSkewbMove, parseSquareOneAlgorithm, parseSquareOneMove, splitAlgorithm };

package/dist/scramble-puzzle.mjs

@@ -0,0 +1,23 @@
+import { WCA_EVENT_IDS, WCA_EVENT_INFO } from "./scramble-puzzle/src/events2.mjs";
+import { InvalidMoveError, InvalidScrambleError, ScramblePuzzleError, UnregisteredPuzzleError } from "./scramble-puzzle/src/errors2.mjs";
+import { applyAlgorithm, splitAlgorithm } from "./scramble-puzzle/src/algorithm2.mjs";
+import { parseCubeAlgorithm, parseCubeMove } from "./scramble-puzzle/src/cube/cube-parser2.mjs";
+import { applyCubeMove, areCubeStatesEqual, createSolvedCubeState } from "./scramble-puzzle/src/cube/cube-state2.mjs";
+import { createCubeDefinition } from "./scramble-puzzle/src/cube/cube-definition2.mjs";
+import { parseClockAlgorithm, parseClockMove } from "./scramble-puzzle/src/clock/clock-parser2.mjs";
+import { applyClockMove, areClockStatesEqual, createSolvedClockState } from "./scramble-puzzle/src/clock/clock-state2.mjs";
+import { createClockDefinition } from "./scramble-puzzle/src/clock/clock-definition2.mjs";
+import { MEGAMINX_FACES, parseMegaminxAlgorithm, parseMegaminxMove } from "./scramble-puzzle/src/megaminx/megaminx-parser2.mjs";
+import { applyMegaminxMove, areMegaminxStatesEqual, createSolvedMegaminxState } from "./scramble-puzzle/src/megaminx/megaminx-state2.mjs";
+import { createMegaminxDefinition } from "./scramble-puzzle/src/megaminx/megaminx-definition2.mjs";
+import { PYRAMINX_AXES, PYRAMINX_FACES, parsePyraminxAlgorithm, parsePyraminxMove } from "./scramble-puzzle/src/pyraminx/pyraminx-parser2.mjs";
+import { applyPyraminxMove, arePyraminxStatesEqual, createSolvedPyraminxState } from "./scramble-puzzle/src/pyraminx/pyraminx-state2.mjs";
+import { createPyraminxDefinition } from "./scramble-puzzle/src/pyraminx/pyraminx-definition2.mjs";
+import { SKEWB_AXES, SKEWB_FACES, parseSkewbAlgorithm, parseSkewbMove } from "./scramble-puzzle/src/skewb/skewb-parser2.mjs";
+import { applySkewbMove, areSkewbStatesEqual, createSolvedSkewbState } from "./scramble-puzzle/src/skewb/skewb-state2.mjs";
+import { createSkewbDefinition } from "./scramble-puzzle/src/skewb/skewb-definition2.mjs";
+import { getSquareOneMoveCost, getSquareOneSlashabilityMoveCost, parseSquareOneAlgorithm, parseSquareOneMove } from "./scramble-puzzle/src/square1/square1-parser2.mjs";
+import { applySquareOneMove, areSquareOneStatesEqual, canSquareOneSlash, createSolvedSquareOneState, getSquareOneScrambleSuccessors, getSquareOneSuccessors } from "./scramble-puzzle/src/square1/square1-state2.mjs";
+import { createSquareOneDefinition } from "./scramble-puzzle/src/square1/square1-definition2.mjs";
+import { createPuzzleRegistry } from "./scramble-puzzle/src/registry.mjs";
+export { InvalidMoveError, InvalidScrambleError, MEGAMINX_FACES, PYRAMINX_AXES, PYRAMINX_FACES, SKEWB_AXES, SKEWB_FACES, ScramblePuzzleError, UnregisteredPuzzleError, WCA_EVENT_IDS, WCA_EVENT_INFO, applyAlgorithm, applyClockMove, applyCubeMove, applyMegaminxMove, applyPyraminxMove, applySkewbMove, applySquareOneMove, areClockStatesEqual, areCubeStatesEqual, areMegaminxStatesEqual, arePyraminxStatesEqual, areSkewbStatesEqual, areSquareOneStatesEqual, canSquareOneSlash, createClockDefinition, createCubeDefinition, createMegaminxDefinition, createPuzzleRegistry, createPyraminxDefinition, createSkewbDefinition, createSolvedClockState, createSolvedCubeState, createSolvedMegaminxState, createSolvedPyraminxState, createSolvedSkewbState, createSolvedSquareOneState, createSquareOneDefinition, getSquareOneMoveCost, getSquareOneScrambleSuccessors, getSquareOneSlashabilityMoveCost, getSquareOneSuccessors, parseClockAlgorithm, parseClockMove, parseCubeAlgorithm, parseCubeMove, parseMegaminxAlgorithm, parseMegaminxMove, parsePyraminxAlgorithm, parsePyraminxMove, parseSkewbAlgorithm, parseSkewbMove, parseSquareOneAlgorithm, parseSquareOneMove, splitAlgorithm };

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "cubegin",
+  "version": "0.0.1",
+  "description": "Public Cubegin package entrypoints for scramble generation, parsing, and SVG rendering.",
+  "license": "GPL-3.0-only",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./scramble-core": "./dist/scramble-core.mjs",
+    "./scramble-image": "./dist/scramble-image.mjs",
+    "./scramble-puzzle": "./dist/scramble-puzzle.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "dev": "node scripts/build.mjs --watch",
+    "release:prepare": "node scripts/release.mjs",
+    "test": "vp test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@cubegin/scramble-core": "workspace:*",
+    "@cubegin/scramble-image": "workspace:*",
+    "@cubegin/scramble-puzzle": "workspace:*",
+    "@types/node": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "vitest": "catalog:"
+  }
+}