Enhance SudokuPuzzle with Grid Generation from Given Cells

[teogor]

Introduce Grid Generation from Given Cells

This pull request enhances the SudokuPuzzle class with the capability to generate a grid containing pre-filled given cells:

New Function:

fun SudokuPuzzle.generateGridWithGivens(): List<List<Int>>

Purpose:

• Generates a grid representation of the Sudoku puzzle with the given cells filled in.
• Constructs a 2D list where each inner list represents a row and each element stores a cell value.
• Simplifies display or external manipulation of Sudoku puzzles with pre-filled values.

Functionality:

1. Retrieves the grid size based on the sudokuType.uniqueDigitsCount.
2. Initializes a mutable 2D list to hold the grid values, initially filled with zeros.
3. Iterates through the givens collection.
4. For each given, assigns its value to the corresponding grid cell using its row and col coordinates.
5. Returns the completed grid as a read-only list of lists.

Benefits:

• Improved Flexibility: Enables working with Sudoku puzzles in a grid-like format with given cells.
• Simplified UI Display: Facilitates visual representation of Sudoku puzzles with pre-filled values.
• External Manipulation: Supports processing or solving Sudoku puzzles with givens using grid-based logic.