Redefining Puzzle Generation: Sudoklify's Innovative Approach

[teogor]

Updated docs

What's New

• Key Features: Explore an array of functionalities that make Sudoklify stand out:

  • Efficient and customizable Sudoku puzzle generation algorithms ✨
  • Support for various grid sizes, including 4x4, 9x9, 16x16, and more 📐
  • Multiple difficulty levels - Easy, Medium, Hard, and Expert 🌟
  • Flexible token mapping system for personalized puzzle representation 🎨
  • Intuitive API for puzzle generation, population, and solution retrieval 🧩
  • Randomization techniques for puzzle layout and digit placement 🔀

• Redefining Puzzle Generation: Sudoklify reimagines how Sudoku puzzles are generated. Instead of the traditional method of removing numbers one by one, Sudoklify leverages an ingenious approach. It starts with a solvable "seed" puzzle and applies a series of transformative algorithms to craft fresh puzzles. This unique process ensures rapid puzzle creation without complex backend resources.

• Unparalleled Puzzle Diversity: Each seed employed by Sudoklify unlocks a staggering 2.4 trillion unique puzzles. To put this in perspective, if you solved one puzzle every 3 minutes, it would take over 13 million lifetimes to exhaust a single seed. 🎉

• Transformative Algorithms: Sudoklify harnesses various transformations to create captivating puzzles:

  • Board Rotation: Four permutations (0°, 90°, 180°, 270°).
  • Column Stacks Shuffle: Six permutations (3!).
  • Row Bands Shuffle: Another six permutations (3!).
  • Column Shuffle: A whopping 216 permutations (3! x 3! x 3!).
  • Row Shuffle: An additional 216 permutations (3! x 3! x 3!).
  • Number Swapping: An incredible 362,880 permutations (9!).

• Usage: Learn how to generate Sudoku puzzles using Sudoklify:

  1. Add Sudoklify as a dependency in your project.
  2. Create a ParamsBuilder to configure puzzle generation parameters.
  3. Generate Sudoku puzzles using the generateSudoku extension function.

• Accessing Generated Sudoku: Get insights into accessing properties of the generatedSudoku instance, including puzzle and solution strings, difficulty level, and grid type.

• Contributing: Contributions to Sudoklify are welcome! Open issues or submit pull requests for ideas, bug reports, and feature requests.

Join the Sudoklify community and experience the next evolution of Sudoku puzzle generation! 🧠🧩🚀