rubic-cube/README.md

Rubik's Cube Logic Engine & Simulator

Overview

This application is a 3D animated, Interactive Rubik's Cube simulator and mathematical solver built from scratch using Vue.js. It aims to provide seamless mechanical interactions and mathematically perfectly rigorous tracking of a classic 3x3 Rubik's Cube state.

The software operates entirely in the browser using a custom Group Theory mathematical engine (DeepCube.js), which separates the heavy analytical permutation tracking from the 3D CSS visual layer using Web Workers.

Features

• Mechanical Realism: 3D CSS rendering precisely models physical cube mechanics. Dragging edge and corner pieces rotates the specific mechanical layer dynamically, while dragging the center elements pivots the entire camera view.
• Reactive Algorithm Queue: Execute complex algorithms fluidly. The dynamic queue evaluates incoming inputs and instantly intercepts redundances (e.g. evaluating U U into a single U2 animation, or cancelling out F into F' on the fly).
• Deep Mathematical Engine: Based entirely on Group Theory. It stores corner and edge permutation arrays combined with spatial orientation parities to guarantee that only physically legal mechanical states exist or can be scrambled.
• Intelligent Solvers:
  • Beginner Method (Human): Constructs the solution layer-by-layer simulating human heuristics natively with instantaneous O(1) algorithmic macros.
  • Kociemba's Algorithm (Optimal): Offloads pruning tables and recursive heuristic searches to Web Workers to instantly calculate and stream back the objectively shortest path solution (typically <20 moves).
• High Performance: Decoupling the single-threaded UI rendering stack from mathematical validations ensures 60 FPS 3D animations, even while executing computationally expensive analytical algorithms in the background.