Play Loop

import type { Board, GeneratedPuzzle } from "@reetesh/sudoku-engine";
import { createEngine } from "@reetesh/sudoku-engine";
 
const engine = createEngine({ variant: "classic" }); // or any VariantId
 
type Session = {
  game: GeneratedPuzzle;
  board: Board;
};
 
function start(difficulty: "easy" | "medium" | "hard" | "expert"): Session | null {
  const game = engine.generatePuzzle(difficulty);
  if (!game) return null;
  return { game, board: game.puzzle.map((r) => [...r]) };
}
 
function place(session: Session, row: number, col: number, value: number | null) {
  const result = engine.applyMove(
    session.board,
    row,
    col,
    value,
    session.game.puzzle, // protects givens
  );
  if (!result.success) return { ok: false as const, reason: result.reason };
  return { ok: true as const, board: result.board };
}
 
function won(session: Session) {
  return (
    engine.isBoardComplete(session.board) &&
    engine.isSolvedCorrectly(session.board, session.game.solution)
  );
}

import { puzzleFromString, validateImportedPuzzle } from "@reetesh/sudoku-engine";
 
const board = puzzleFromString(
  "53..7....6..195....98....6.8...6...34..8.3..17...2...6.6....28....419..5....8..79",
);
if (!board) throw new Error("bad length / charset");
 
const check = validateImportedPuzzle(board);
// { valid, unique, solvable, puzzle?, error? }