Reference
Roadmap
Shipped features and planned work for @reetesh/sudoku-engine.
Roadmap
Shipped (3.0.0)
| Area | Status |
|---|---|
| Classic / 6×6 / Diagonal / Hyper | Stable |
| Windoku / Jigsaw | Stable |
| Killer / Thermo / Kropki / Samurai | Stable |
Architecture (lazy facades, BatchEngine, custom definition, heuristics) | Stable |
| Product docs suite (hub, guides, troubleshooting, API) | Stable |
Next variants (famous / widely played)
Prioritized for fame and fit with houses + meta:
Tier 1 — high demand, fits current architecture
| Variant | Approach |
|---|---|
| Arrow | Meta (circle + path sum) |
| XV | Meta (edge labels: X=10, V=5) |
| Sandwich | Meta / outside clues (sum between 1 and 9) |
| Little Killer | Meta (diagonal outside sums) |
| Greater-than | Meta (inequalities between cells) |
| Consecutive | Meta (marked adjacent pairs differ by 1) |
| Anti-knight / Anti-king | Extra uniqueness (chess-move peers) |
| Asterisk / Girandola | Extra houses (like Hyper/Windoku) |
| 4×4 (Shidoku) | New grid preset (same pattern as 6×6) |
| 16×16 (Hexadoku) | Larger grid + digit set |
Tier 2 — enthusiast / modern apps
| Variant | Notes |
|---|---|
| Non-consecutive | Global adjacency rule |
| German Whispers | Line meta (≥5 difference) |
| Renban | Line = consecutive set |
| Palindrome | Line reads both ways |
| Miracle | Anti-knight + anti-king + non-consecutive combo |
| Odd–Even | Cell parity marks |
| Quadruples | Corner circle with four digits |
Tier 3 — multi-grid family (Samurai siblings)
Sohei · Butterfly · Flower · Cross · Gattai · Twin / Duadoku
Near term (product)
- Publish 3.0.0 to npm
- Richer
examples/for meta UIs and custom jigsaw maps - npm release / CI publish polish
Long term
- Runtime plugin registration (if demand exists)
- Deeper human-solving technique engine (beyond heuristic rating)
Non-goals (for now)
- UI components
- Puzzle databases / import formats beyond string serialization
- Standalone products (KenKen, Futoshiki-as-app, Binairo) — keep Sudoku-shaped
How to contribute a variant
- Add house/meta builders in
core/. - Register preset in
variants/registry.ts(or ship asdefineVariantsample). - Extend tests (
ALL_VARIANTS/META_VARIANTS/ QA rigorous). - Document in OVERVIEW.md, GUIDES.md, and API.md.
See ARCHITECTURE.md · Docs hub.