multi-puzzle-solver 0.9.27__tar.gz → 0.9.30__tar.gz

{multi_puzzle_solver-0.9.27/src/multi_puzzle_solver.egg-info → multi_puzzle_solver-0.9.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-puzzle-solver
-Version: 0.9.27
+Version: 0.9.30
 Summary: Efficient solvers for numerous popular and esoteric logic puzzles using CP-SAT
 Author: Ar-Kareem
 Project-URL: Homepage, https://github.com/Ar-Kareem/puzzle_solver
@@ -26,7 +26,7 @@ Requires-Dist: pytest-xdist; extra == "dev"
 
 # Python Puzzle Solver
 
-Solve numerous classical logic puzzles automatically in Python. 
+Solve countless (50+) classical logic puzzles automatically in Python. 
 
 ## Quick Start
 
@@ -73,7 +73,7 @@ Time taken: 0.04 seconds
 
 ## Introduction
 
-The aim of this repo is to provide very efficient solvers (i.e. not brute force solvers) for many popular pencil logic puzzles like Nonograms, Sudoku, Minesweeper, and many more lesser known ones.
+The aim of this repo is to provide very efficient solvers (i.e. not brute force solvers) for countless (50+) popular pencil logic puzzles like Nonograms, Sudoku, Minesweeper, and many more lesser known ones.
 
 If you happen to have a puzzle similar to the ones listed below and want to solve it (or see how many potential solutions a partially covered board has), then this repo is perfect for you.
 
@@ -338,7 +338,34 @@ These are all the puzzles that are implemented in this repo. <br> Click on any o
   </td>
   <td align="center">
     <a href="#nurikabe-puzzle-type-45"><b>Nurikabe</b><br><br>
-      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/nurikabe_unsolved.png" alt="Nurikabe" width="140">
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/nurikabe_solved.png" alt="Nurikabe" width="140">
+    </a>
+  </td>
+</tr>
+<tr>
+  <td align="center">
+    <a href="#heyawake-puzzle-type-46"><b>Heyawake</b><br><br>
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/heyawake_solved.png" alt="Heyawake" width="140">
+    </a>
+  </td>
+  <td align="center">
+    <a href="#shingoki-puzzle-type-47"><b>Shingoki</b><br><br>
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shingoki_solved.png" alt="Shingoki" width="140">
+    </a>
+  </td>
+  <td align="center">
+    <a href="#tapa-puzzle-type-48"><b>Tapa</b><br><br>
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/tapa_solved.png" alt="Tapa" width="140">
+    </a>
+  </td>
+  <td align="center">
+    <a href="#binairo-plus-puzzle-type-49"><b>Binairo Plus</b><br><br>
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/binairo_plus_solved.png" alt="Binairo Plus" width="140">
+    </a>
+  </td>
+  <td align="center">
+    <a href="#shakashaka-puzzle-type-50"><b>Shakashaka</b><br><br>
+      <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shakashaka_solved.png" alt="Shakashaka" width="140">
     </a>
   </td>
 </tr>
@@ -401,6 +428,12 @@ These are all the puzzles that are implemented in this repo. <br> Click on any o
   - [Palisade (Puzzle Type #43)](#palisade-puzzle-type-43)
   - [Flip (Puzzle Type #44)](#flip-puzzle-type-44)
   - [Nurikabe (Puzzle Type #45)](#nurikabe-puzzle-type-45)
+  - [Heyawake (Puzzle Type #46)](#heyawake-puzzle-type-46)
+  - [Shingoki (Puzzle Type #47)](#shingoki-puzzle-type-47)
+  - [Tapa (Puzzle Type #48)](#tapa-puzzle-type-48)
+  - [Binairo Plus (Puzzle Type #49)](#binairo-plus-puzzle-type-49)
+  - [Shakashaka (Puzzle Type #50)](#shakashaka-puzzle-type-50)
+  - [Kakuro (Puzzle Type #51)](#kakuro-puzzle-type-51)
   - [Why SAT / CP-SAT?](#why-sat--cp-sat)
   - [Testing](#testing)
   - [Contributing](#contributing)
@@ -1088,7 +1121,11 @@ Time taken: 0.03 seconds
 
 ## Singles (Puzzle Type #10)
 
-* [**Play online**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/js/singles.html)
+Also known as "Hitori",
+
+* [**Play online 1**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/js/singles.html)
+
+* [**Play online 2**](https://www.puzzle-hitori.com/)
 
 * [**Instructions**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/doc/singles.html#singles)
 
@@ -1128,24 +1165,41 @@ board = np.array([
 binst = solver.Board(board=board)
 solutions = binst.solve_and_print()
 ```
+
 **Script Output**
+
 ```python
 Solution found
-[['B' ' ' 'B' ' ' 'B' ' ' ' ' 'B' ' ' ' ' ' ' ' ']
- [' ' ' ' ' ' ' ' ' ' 'B' ' ' ' ' ' ' 'B' ' ' 'B']
- ['B' ' ' 'B' ' ' 'B' ' ' 'B' ' ' 'B' ' ' 'B' ' ']
- [' ' ' ' ' ' 'B' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ']
- ['B' ' ' 'B' ' ' ' ' 'B' ' ' 'B' ' ' 'B' ' ' 'B']
- [' ' ' ' ' ' 'B' ' ' ' ' 'B' ' ' ' ' ' ' 'B' ' ']
- [' ' 'B' ' ' ' ' 'B' ' ' ' ' 'B' ' ' 'B' ' ' ' ']
- [' ' ' ' 'B' ' ' ' ' ' ' 'B' ' ' ' ' ' ' ' ' ' ']
- [' ' 'B' ' ' ' ' ' ' 'B' ' ' ' ' 'B' ' ' ' ' 'B']
- ['B' ' ' 'B' ' ' 'B' ' ' ' ' 'B' ' ' ' ' 'B' ' ']
- [' ' ' ' ' ' ' ' ' ' 'B' ' ' ' ' 'B' ' ' ' ' ' ']
- ['B' ' ' ' ' 'B' ' ' ' ' ' ' 'B' ' ' ' ' 'B' ' ']]
+    0   0   0   0   0   0   0   0   0   0   1   1  
+    0   1   2   3   4   5   6   7   8   9   0   1
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│▒▒▒│ 6 │▒▒▒│ 4 │▒▒▒│ 8 │ 9 │▒▒▒│ 5 │ 1 │ 3 │ 7 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│ 2 │ 8 │ 5 │ 7 │ 1 │▒▒▒│ 4 │ 3 │ 6 │▒▒▒│10 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│▒▒▒│ 7 │▒▒▒│11 │▒▒▒│ 6 │▒▒▒│10 │▒▒▒│ 2 │▒▒▒│ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│11 │ 9 │ 4 │▒▒▒│ 6 │ 1 │ 2 │ 5 │ 3 │10 │ 7 │ 8 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│▒▒▒│ 5 │▒▒▒│ 9 │ 7 │▒▒▒│ 6 │▒▒▒│11 │▒▒▒│ 4 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│ 1 │ 3 │ 7 │▒▒▒│12 │ 5 │▒▒▒│ 2 │ 9 │ 6 │▒▒▒│ 4 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│ 6 │▒▒▒│ 1 │ 3 │▒▒▒│ 4 │11 │▒▒▒│ 2 │▒▒▒│ 8 │10 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│ 3 │11 │▒▒▒│ 6 │ 2 │ 9 │▒▒▒│ 1 │ 4 │ 8 │12 │ 5 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│ 4 │▒▒▒│ 8 │ 5 │11 │▒▒▒│ 3 │ 6 │▒▒▒│ 9 │ 1 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│▒▒▒│ 4 │▒▒▒│ 2 │▒▒▒│10 │ 1 │▒▒▒│ 8 │ 5 │▒▒▒│ 6 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+10│ 5 │ 1 │ 6 │10 │ 9 │▒▒▒│ 8 │ 4 │▒▒▒│ 3 │ 2 │12 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+11│▒▒▒│ 2 │12 │▒▒▒│ 8 │ 3 │ 5 │▒▒▒│10 │ 4 │▒▒▒│11 │
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
 Solutions found: 1
 status: OPTIMAL
-Time taken: 2.14 seconds
+Time taken: 0.04 seconds
 ```
 
 **Solved puzzle**
@@ -1290,7 +1344,11 @@ Time taken: 0.03 seconds
 
 ## Range (Puzzle Type #13)
 
-* [**Play online**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/js/range.html)
+Also known as "Kurodoko"
+
+* [**Play online 1**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/js/range.html)
+
+* [**Play online 2**](https://www.puzzle-kurodoko.com/)
 
 * [**Instructions**](https://www.chiark.greenend.org.uk/~sgtatham/puzzles/doc/range.html#range)
 
@@ -3594,31 +3652,52 @@ solutions = binst.solve_and_print()
 
 ```python
 Solution found
-[
-    [ 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W' ],
-    [ 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W' ],
-    [ 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'B' ],
-    [ 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'B' ],
-    [ 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'B', 'W' ],
-    [ 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'W', 'B' ],
-    [ 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'B', 'W' ],
-    [ 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'W', 'B' ],
-    [ 'W', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'W' ],
-    [ 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B' ],
-    [ 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'W' ],
-    [ 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W' ],
-    [ 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'B' ],
-    [ 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'W' ],
-    [ 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B' ],
-    [ 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W' ],
-    [ 'W', 'B', 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B' ],
-    [ 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'B', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'W' ],
-    [ 'W', 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'B', 'W', 'B' ],
-    [ 'B', 'W', 'B', 'B', 'W', 'B', 'W', 'B', 'W', 'W', 'B', 'B', 'W', 'W', 'B', 'W', 'B', 'W', 'W', 'B' ],
-]
+    0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1  
+    0   1   2   3   4   5   6   7   8   9   0   1   2   3   4   5   6   7   8   9
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+10│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+11│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+12│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+13│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+14│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+15│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+16│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+17│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+18│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+19│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │   │▒▒▒│
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
 Solutions found: 1
 status: OPTIMAL
-Time taken: 0.03 seconds
+Time taken: 0.02 seconds
 ```
 
 **Solved puzzle**
@@ -3893,6 +3972,7 @@ This picture won't mean much as the game is about the sequence of moves not the
 <img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/flip_solved.png" alt="Flip solved" width="500">
 
 ---
+
 ## Nurikabe (Puzzle Type #45)
 
 * [**Play online**](https://www.puzzle-nurikabe.com/)
@@ -3922,8 +4002,6 @@ Read more about the history and methods behind nurikabe in the [Wikipedia nurika
 
 Code to utilize this package and solve the puzzle:
 
-(Note: the solver also supports random mapping of squares to the neighbors they flip, see the test cases in `tests/test_flip.py` for usage examples)
-
 ```python
 import numpy as np
 from puzzle_solver import nurikabe_solver as solver
@@ -3955,8 +4033,6 @@ solutions = binst.solve_and_print()
 
 **Script Output**
 
-The output tells you which squares to tap to solve the puzzle.
-
 ```python
 Solution found
     0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1  
@@ -4013,6 +4089,739 @@ Time taken: 1.62 seconds
 
 ---
 
+## Heyawake (Puzzle Type #46)
+
+* [**Play online**](https://www.puzzle-heyawake.com/)
+
+* [**Solver Code**][46]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+ You have to color the cells of the grid in black and white according to the rules:
+- Regions with a number should contain black cells matching the number.
+- 2 black cells cannot be adjacent horizontally or vertically.
+- A straight (orthogonal) line of connected white cells cannot span across more than 2 regions.
+- All white cells should be connected in a single group.
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/heyawake_unsolved.png" alt="Heyawake unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import heyawake_solver as solver
+board = np.array([
+    ['00', '01', '02', '03', '04', '04', '04', '04', '04', '04', '04', '04', '04', '04', '05', '05', '06', '06', '07', '07'],
+    ['00', '08', '02', '03', '09', '09', '10', '10', '10', '11', '11', '12', '12', '12', '05', '05', '06', '06', '07', '07'],
+    ['00', '08', '02', '03', '09', '09', '13', '13', '13', '11', '11', '12', '12', '12', '14', '14', '14', '15', '15', '16'],
+    ['17', '17', '17', '03', '09', '09', '18', '18', '19', '11', '11', '20', '20', '21', '21', '22', '22', '15', '15', '16'],
+    ['17', '17', '17', '23', '23', '23', '23', '23', '19', '11', '11', '24', '24', '21', '21', '25', '25', '25', '25', '26'],
+    ['27', '28', '28', '23', '23', '23', '23', '23', '29', '29', '30', '31', '32', '32', '32', '25', '25', '25', '25', '26'],
+    ['27', '28', '28', '33', '34', '34', '35', '35', '35', '36', '30', '31', '32', '32', '32', '25', '25', '25', '25', '26'],
+    ['27', '28', '28', '33', '34', '34', '35', '35', '35', '37', '37', '31', '32', '32', '32', '25', '25', '25', '25', '38'],
+    ['27', '28', '28', '39', '39', '39', '40', '40', '40', '41', '41', '31', '42', '42', '42', '42', '42', '43', '43', '38'],
+    ['27', '28', '28', '39', '39', '39', '40', '40', '40', '41', '41', '44', '44', '44', '44', '44', '44', '43', '43', '38'],
+    ['27', '45', '45', '39', '39', '39', '46', '46', '47', '41', '41', '44', '44', '44', '44', '44', '44', '48', '48', '48'],
+    ['49', '45', '45', '50', '50', '50', '46', '46', '47', '41', '41', '51', '52', '52', '52', '52', '53', '53', '53', '54'],
+    ['49', '55', '56', '57', '57', '57', '58', '58', '58', '41', '41', '51', '52', '52', '52', '52', '53', '53', '53', '54'],
+    ['49', '55', '59', '57', '57', '57', '58', '58', '58', '60', '60', '61', '61', '62', '62', '63', '63', '63', '63', '54'],
+    ['49', '64', '64', '57', '57', '57', '58', '58', '58', '60', '60', '61', '61', '62', '62', '63', '63', '63', '63', '54'],
+    ['49', '64', '64', '65', '65', '66', '58', '58', '58', '60', '60', '61', '61', '67', '67', '63', '63', '63', '63', '54'],
+    ['49', '64', '64', '65', '65', '66', '58', '58', '58', '60', '60', '61', '61', '67', '67', '68', '68', '69', '70', '54'],
+    ['49', '71', '71', '72', '72', '72', '73', '74', '74', '74', '75', '76', '76', '67', '67', '68', '68', '69', '77', '54'],
+    ['49', '71', '71', '72', '72', '72', '73', '74', '74', '74', '75', '78', '78', '78', '78', '79', '80', '80', '77', '54'],
+    ['81', '81', '81', '81', '81', '81', '81', '82', '82', '82', '75', '83', '83', '83', '83', '79', '80', '80', '77', '54']
+])
+region_to_clue = {
+    '04': 4, '09': 0, '06': 0, '16': 0, '13': 2, '24': 0, '32': 5, '27': 3, '34': 0,
+    '39': 3, '37': 0, '41': 3, '38': 2, '43': 0, '44': 4, '54': 3, '53': 2, '70': 1,
+    '80': 2, '67': 1, '83': 2, '82': 2, '73': 0, '72': 1, '71': 2, '64': 1, '56': 1,
+    '45': 0, '57': 2, '58': 5, '66': 0, '60': 3, '61': 2
+}
+binst = solver.Board(board=board, region_to_clue=region_to_clue)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+```python
+Solution found
+    0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1
+    0   1   2   3   4   5   6   7   8   9   0   1   2   3   4   5   6   7   8   9
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│   │   │▒▒▒│   │ 4 │▒▒▒│ 4 │▒▒▒│ 4 │ 4 │▒▒▒│ 4 │▒▒▒│ 4 │   │▒▒▒│   │   │   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│▒▒▒│   │   │▒▒▒│   │   │   │   │   │▒▒▒│   │   │   │   │▒▒▒│   │   │   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│   │   │▒▒▒│   │   │   │▒▒▒│ 2 │▒▒▒│   │   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│   │▒▒▒│   │▒▒▒│   │   │   │▒▒▒│   │   │   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│   │   │   │   │▒▒▒│   │   │   │▒▒▒│   │▒▒▒│   │   │   │   │▒▒▒│   │   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│▒▒▒│   │   │   │   │▒▒▒│   │   │   │▒▒▒│   │   │▒▒▒│ 5 │▒▒▒│   │   │   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│ 3 │   │▒▒▒│   │   │   │▒▒▒│   │   │   │▒▒▒│   │ 5 │▒▒▒│ 5 │   │▒▒▒│   │   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│▒▒▒│   │   │▒▒▒│   │   │   │   │▒▒▒│   │   │   │▒▒▒│ 5 │▒▒▒│   │   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│ 3 │   │▒▒▒│ 3 │▒▒▒│ 3 │   │▒▒▒│   │▒▒▒│ 3 │▒▒▒│   │   │   │   │▒▒▒│   │   │ 2 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│ 3 │▒▒▒│   │ 3 │ 3 │▒▒▒│   │   │   │ 3 │▒▒▒│ 4 │ 4 │▒▒▒│ 4 │▒▒▒│ 4 │   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+10│▒▒▒│   │   │ 3 │▒▒▒│ 3 │▒▒▒│   │   │▒▒▒│ 3 │▒▒▒│ 4 │ 4 │▒▒▒│ 4 │ 4 │   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+11│   │   │   │▒▒▒│   │   │   │   │▒▒▒│ 3 │ 3 │   │▒▒▒│   │   │▒▒▒│ 2 │▒▒▒│ 2 │ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+12│   │   │▒▒▒│ 2 │ 2 │▒▒▒│ 5 │▒▒▒│ 5 │ 3 │ 3 │▒▒▒│   │   │   │   │▒▒▒│ 2 │ 2 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+13│   │▒▒▒│   │ 2 │ 2 │ 2 │▒▒▒│ 5 │ 5 │▒▒▒│ 3 │ 2 │ 2 │▒▒▒│   │   │   │▒▒▒│   │ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+14│   │ 1 │▒▒▒│ 2 │ 2 │▒▒▒│ 5 │▒▒▒│ 5 │ 3 │▒▒▒│ 2 │ 2 │   │▒▒▒│   │   │   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+15│▒▒▒│ 1 │ 1 │   │▒▒▒│   │ 5 │ 5 │ 5 │▒▒▒│ 3 │▒▒▒│ 2 │ 1 │ 1 │▒▒▒│   │   │   │ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+16│   │ 1 │ 1 │▒▒▒│   │   │▒▒▒│ 5 │▒▒▒│ 3 │ 3 │ 2 │▒▒▒│ 1 │ 1 │   │▒▒▒│   │▒▒▒│ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+17│   │ 2 │▒▒▒│ 1 │ 1 │ 1 │   │▒▒▒│   │   │   │▒▒▒│   │▒▒▒│ 1 │   │   │▒▒▒│   │ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+18│   │▒▒▒│ 2 │ 1 │ 1 │▒▒▒│   │   │   │   │▒▒▒│   │   │   │   │   │▒▒▒│ 2 │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+19│   │   │   │   │▒▒▒│   │   │▒▒▒│ 2 │▒▒▒│   │ 2 │▒▒▒│ 2 │▒▒▒│   │ 2 │▒▒▒│   │ 3 │
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+Solutions found: 1
+status: OPTIMAL
+Time taken: 38.04 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/heyawake_solved.png" alt="Heyawake solved" width="500">
+
+---
+
+## Shingoki (Puzzle Type #47)
+
+Also called "Semaphores".
+
+* [**Play online**](https://www.puzzle-shingoki.com/)
+
+* [**Solver Code**][47]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+You have to draw lines between the dots to form a single loop without crossings or branches. The loop should pass through all black and white circles in such a way that:
+- White circles must be passed through in a straight line
+- Black circles must be turned upon
+- The numbers in the circles show the sum of the lengths of the 2 straight lines going out of that circle. 
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shingoki_unsolved.png" alt="Shingoki unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import shingoki_solver as solver
+board = np.array([
+    ['  ', '  ', '  ', '  ', '  ', '4B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '  ', '5B', '  ', '  ', '2B', '  ', '  ', '3B', '  ', '  ', '  ', '3W', '  ', '  ', '  ', '  ', '2B', '  '],
+    ['2B', '2B', '  ', '2W', '  ', '  ', '  ', '  ', '  ', '  ', '2B', '  ', '2B', '  ', '  ', '  ', '3B', '5W', '  ', '  ', '11W'],
+    ['  ', '  ', '  ', '  ', '  ', '3B', '  ', '3B', '  ', '  ', '  ', '  ', '2B', '  ', '  ', '  ', '  ', '  ', '3W', '  ', '  '],
+    ['  ', '2W', '  ', '  ', '2B', '  ', '2W', '  ', '3W', '  ', '2W', '2B', '2B', '  ', '  ', '  ', '  ', '  ', '  ', '8W', '  '],
+    ['  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '6B', '  ', '  ', '  ', '  ', '4B', '2W', '  ', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '2B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '2W', '  ', '  ', '  ', '4B', '  ', '  '],
+    ['  ', '2B', '2W', '  ', '  ', '  ', '3B', '  ', '  ', '  ', '  ', '3W', '  ', '  ', '  ', '  ', '  ', '  ', '3B', '  ', '  '],
+    ['4W', '3B', '  ', '  ', '3W', '  ', '  ', '  ', '  ', '  ', '3B', '  ', '6B', '  ', '  ', '  ', '2B', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '2W', '7B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '3W', '  ', '3W', '4W', '5B', '  ', '  ', '  ', '  ', '5W', '  ', '4W', '  ', '  ', '  ', '2W', '  ', '  '],
+    ['7B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '3B', '  '],
+    ['  ', '  ', '  ', '  ', '2B', '  ', '4W', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '5B', '  ', '  ', '  '],
+    ['  ', '  ', '2W', '  ', '  ', '2B', '  ', '4W', '3W', '  ', '  ', '  ', '  ', '  ', '  ', '5B', '2B', '  ', '3W', '  ', '  '],
+    ['  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '3B', '  ', '7W', '  ', '2B', '5B', '  ', '  ', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '  ', '  ', '3B', '2B', '  ', '  ', '  ', '3W', '  ', '2B', '  ', '  ', '  ', '2W', '  ', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '2W', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '3B', '  '],
+    ['  ', '4W', '  ', '  ', '2B', '3B', '  ', '  ', '  ', '2B', '4B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '3W', '  ', '  '],
+    ['7W', '  ', '3B', '  ', '  ', '2B', '  ', '  ', '  ', '4B', '  ', '  ', '  ', '  ', '2W', '3B', '  ', '2B', '  ', '  ', '  '],
+    ['  ', '  ', '  ', '3W', '  ', '3W', '  ', '  ', '2B', '  ', '  ', '  ', '  ', '  ', '  ', '  ', '3W', '  ', '2W', '  ', '  '],
+    ['  ', '2B', '  ', '  ', '  ', '  ', '5W', '  ', '  ', '  ', '  ', '5W', '  ', '  ', '  ', '6B', '  ', '  ', '  ', '  ', '  '],
+])
+binst = solver.Board(board=board)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+Note that the solver is much slower for large puzzles like this example and take ~3 minutes to find a valid solution and ~7 minutes to verify that no other solutions exist.
+
+```python
+Solution found
+    0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1  
+    0   1   2   3   4   5   6   7   8   9   0   1   2   3   4   5   6   7   8   9
+                      ┌───────────┐   ┌───────────────────────────┐   ┌───┐   ┌───┐
+ 0  .   .   .   .   . │ .   .   . │ . │ .   .   .   .   .   .   . │ . │ . │ . │ . │
+  ┌───────────────┐   └───┐   ┌───┘   │   ┌───────┐   ┌───────────┘   │   └───┘   │
+ 1│ .   .   .   . │ .   . │ . │ .   . │ . │ .   . │ . │ .   .   .   . │ .   .   . │
+  └───┐   ┌───────┘   ┌───┘   └───┐   │   └───┐   └───┘       ┌───┐   │   ┌───┐   │
+ 2  . │ . │ .   .   . │ .   .   . │ . │ .   . │ .   .   .   . │ . │ . │ . │ . │ . │
+  ┌───┘   └───┐       └───────┐   │   │   ┌───┘   ┌───┐   ┌───┘   │   │   │   │   │
+ 3│ .   .   . │ .   .   .   . │ . │ . │ . │ .   . │ . │ . │ .   . │ . │ . │ . │ . │
+  └───────┐   └───┐   ┌───────┘   │   │   │   ┌───┘   └───┘   ┌───┘   │   │   │   │
+ 4  .   . │ .   . │ . │ .   .   . │ . │ . │ . │ .   .   .   . │ .   . │ . │ . │ . │
+  ┌───────┘   ┌───┘   └───────┐   └───┘   └───┘   ┌───────┐   │       └───┘   │   │
+ 5│ .   .   . │ .   .   .   . │ .   .   .   .   . │ .   . │ . │ .   .   .   . │ . │
+  └───┐   ┌───┘       ┌───┐   └───────────────────┘       │   └───────────┐   │   │
+ 6  . │ . │ .   .   . │ . │ .   .   .   .   .   .   .   . │ .   .   .   . │ . │ . │
+  ┌───┘   │       ┌───┘   └───────┐       ┌───────────┐   └───┐   ┌───────┘   │   │
+ 7│ .   . │ .   . │ .   .   .   . │ .   . │ .   .   . │ .   . │ . │ .   .   . │ . │
+  │   ┌───┘       │   ┌───────┐   └───────┘   ┌───┐   │   ┌───┘   └───┐       │   │
+ 8│ . │ .   .   . │ . │ .   . │ .   .   .   . │ . │ . │ . │ .   .   . │ .   . │ . │
+  │   │           │   │   ┌───┘   ┌───────┐   │   │   │   │   ┌───┐   │       │   │
+ 9│ . │ .   .   . │ . │ . │ .   . │ .   . │ . │ . │ . │ . │ . │ . │ . │ .   . │ . │
+  │   └───────────┘   │   │   ┌───┘       │   │   │   │   │   │   │   └───────┘   │
+10│ .   .   .   .   . │ . │ . │ .   .   . │ . │ . │ . │ . │ . │ . │ .   .   .   . │
+  └───────────┐   ┌───┘   │   │           │   │   │   │   │   │   └───────┐   ┌───┘
+11  .   .   . │ . │ .   . │ . │ .   .   . │ . │ . │ . │ . │ . │ .   .   . │ . │ .
+  ┌───┐       └───┘       │   │   ┌───┐   │   │   │   └───┘   │   ┌───┐   │   │
+12│ . │ .   .   .   .   . │ . │ . │ . │ . │ . │ . │ .   .   . │ . │ . │ . │ . │ .
+  │   └───────┐       ┌───┘   │   │   │   │   │   └───┐       └───┘   │   │   └───┐
+13│ .   .   . │ .   . │ .   . │ . │ . │ . │ . │ .   . │ .   .   .   . │ . │ .   . │
+  │   ┌───┐   │       └───────┘   │   └───┘   │   ┌───┘   ┌───────┐   │   └───┐   │
+14│ . │ . │ . │ .   .   .   .   . │ .   .   . │ . │ .   . │ .   . │ . │ .   . │ . │
+  │   │   │   └───────┐   ┌───┐   └───────────┘   └───┐   │       │   │   ┌───┘   │
+15│ . │ . │ .   .   . │ . │ . │ .   .   .   .   .   . │ . │ .   . │ . │ . │ .   . │
+  │   │   └───────┐   └───┘   │       ┌───┐           │   │       └───┘   │   ┌───┘
+16│ . │ .   .   . │ .   .   . │ .   . │ . │ .   .   . │ . │ .   .   .   . │ . │ .
+  │   │       ┌───┘   ┌───────┘   ┌───┘   └───────────┘   └───┐   ┌───┐   │   │
+17│ . │ .   . │ .   . │ .   .   . │ .   .   .   .   .   .   . │ . │ . │ . │ . │ .
+  │   └───┐   │   ┌───┘       ┌───┘   ┌───────────┐   ┌───────┘   │   └───┘   └───┐
+18│ .   . │ . │ . │ .   .   . │ .   . │ .   .   . │ . │ .   .   . │ .   .   .   . │
+  └───┐   │   │   └───────────┘   ┌───┘   ┌───────┘   └───────┐   │   ┌───────┐   │
+19  . │ . │ . │ .   .   .   .   . │ .   . │ .   .   .   .   . │ . │ . │ .   . │ . │
+      └───┘   └───────────────────┘       └───────────────────┘   └───┘       └───┘
+Solutions found: 1
+status: OPTIMAL
+Time taken: 425.97 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shingoki_solved.png" alt="Shingoki solved" width="500">
+
+---
+
+## Tapa (Puzzle Type #48)
+
+* [**Play online**](https://www.puzzle-tapa.com/)
+
+* [**Instructions**](https://www.gmpuzzles.com/blog/tapa-rules-and-info/)
+
+* [**Solver Code**][48]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+You are given a grid where some cells have numbers. Your goal is to shade some cells black to satisfy the following rules:
+
+   - Cells with numbers cannot be shaded
+   - The shaded cells cannot form a 2×2 square
+   - Numbers in a cell indicate the length of consecutive shaded blocks in the neighboring cells. If there is more than one number in a cell, then there must be at least one white (unshaded) cell between the black cell groups.
+   - The shaded cells should form a single connected area.
+   - The numbers in a cell represent the length of consecutive shaded blocks in the 8 neighboring cells. 
+     - A single number N represents N consecutive shaded cells around the number.
+     - Multiple numbers represent multiple consecutive shaded cells around the number, each separated by at least one white cell.
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/tapa_unsolved.png" alt="Tapa unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import tapa_solver as solver
+board = np.array([
+    ['   ', '   ', '   ', '   ', '   ', '3  ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '3  ', '   ', '   ', '   ', '   ', '   '],
+    ['   ', '   ', '   ', '   ', '2/3', '   ', '   ','1/2/2','   ', '3/3', '7  ', '   ', '7  ', '   ', '   ', '2/3', '   ', '   ', '   ', '   '],
+    ['   ', '2/4', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '2/3', '   '],
+    ['   ', '   ', '   ', '1/3','1/1/2','   ', '   ', '7  ', '   ', '   ', '   ', '   ', '7  ', '   ','   ','1/1/1/1','1/3','   ', '   ', '   '],
+    ['   ', '   ','1/1/3','   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '1/4', '   ', '   '],
+
+    ['   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ','1/1/3','1/2', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   '],
+    ['   ', '   ', '5  ', '   ', '   ','1/1/1','1/1', '   ', '   ', '   ', '   ', '   ', '   ', '1/3', '2/3', '   ', '   ', '3/3', '   ', '   '],
+    ['   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   '],
+
+    ['   ', '   ','1/1/2','   ', '   ', '   ', '   ', '   ', '7  ', '3/3', '3/3', '2/4', '   ', '   ', '   ', '   ', '   ', '6  ', '   ', '   '],
+    ['   ', '1/4', '   ', '   ', '2/3', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '2/4', '   ', '   ', '1/3', '   '],
+    ['   ', '1/3', '   ', '   ', '1/4', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '2/3', '   ', '   ','1/1/2','   '],
+    ['   ', '   ', '6  ', '   ', '   ', '   ', '   ', '   ', '1/1', '1/2','1/1/2','1/4', '   ', '   ', '   ', '   ', '   ', '6  ', '   ', '   '],
+    ['   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   '],
+
+    ['   ', '   ', '3/3', '   ', '   ', '1/2', '1/1', '   ', '   ', '   ', '   ', '   ', '   ', '1/3','1/1/3','   ', '   ', '2/3', '   ', '   '],
+    ['   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '4  ', '1/3', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   '],
+    ['   ', '   ', '1/4', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '1/3', '   ', '   '],
+
+    ['   ', '   ', '   ', '1/3','1/1/3','   ', '   ', '6  ', '   ', '   ', '   ', '   ', '7  ', '   ', '   ','1/1/2','1/3', '   ', '   ', '   '],
+    ['   ', '2/3', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '2/3', '   '],
+    ['   ', '   ', '   ', '   ', '2/3', '   ', '   ', '6  ', '   ', '1/3', '4  ', '   ', '6  ', '   ', '   ', '2/3', '   ', '   ', '   ', '   '],
+    ['   ', '   ', '   ', '   ', '   ', '1/1', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '   ', '1/1', '   ', '   ', '   ', '   ', '   '],
+])
+binst = solver.Board(board=board)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+```python
+Solution found
+    0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1  
+    0   1   2   3   4   5   6   7   8   9   0   1   2   3   4   5   6   7   8   9  
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│   │▒▒▒│▒▒▒│▒▒▒│   │ 3 │▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│ 3 │   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│▒▒▒│▒▒▒│   │▒▒▒│2/3│▒▒▒│▒▒▒│...│   │3/3│ 7 │▒▒▒│ 7 │▒▒▒│▒▒▒│2/3│▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│▒▒▒│2/4│▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│2/3│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│▒▒▒│   │▒▒▒│1/3│...│▒▒▒│▒▒▒│ 7 │▒▒▒│   │   │▒▒▒│ 7 │▒▒▒│   │...│1/3│▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│▒▒▒│▒▒▒│...│▒▒▒│   │   │▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│1/4│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│...│1/2│   │   │   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│▒▒▒│   │ 5 │▒▒▒│   │...│1/1│   │▒▒▒│   │▒▒▒│   │   │1/3│2/3│▒▒▒│   │3/3│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│▒▒▒│▒▒▒│...│   │▒▒▒│▒▒▒│   │▒▒▒│ 7 │3/3│3/3│2/4│▒▒▒│   │   │▒▒▒│▒▒▒│ 6 │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│▒▒▒│1/4│   │▒▒▒│2/3│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│2/4│▒▒▒│▒▒▒│1/3│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+10│▒▒▒│1/3│▒▒▒│▒▒▒│1/4│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│2/3│▒▒▒│   │...│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+11│▒▒▒│   │ 6 │▒▒▒│▒▒▒│   │▒▒▒│   │1/1│1/2│...│1/4│▒▒▒│   │   │   │▒▒▒│ 6 │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+12│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+13│▒▒▒│   │3/3│   │   │1/2│1/1│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│1/3│...│▒▒▒│   │2/3│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+14│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│ 4 │1/3│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+15│▒▒▒│   │1/4│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│▒▒▒│   │   │▒▒▒│1/3│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+16│▒▒▒│   │▒▒▒│1/3│...│▒▒▒│   │ 6 │▒▒▒│▒▒▒│▒▒▒│▒▒▒│ 7 │▒▒▒│▒▒▒│...│1/3│▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+17│▒▒▒│2/3│▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│2/3│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+18│▒▒▒│   │   │▒▒▒│2/3│▒▒▒│   │ 6 │▒▒▒│1/3│ 4 │▒▒▒│ 6 │   │▒▒▒│2/3│▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+19│▒▒▒│▒▒▒│▒▒▒│▒▒▒│   │1/1│▒▒▒│▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│1/1│   │▒▒▒│▒▒▒│▒▒▒│▒▒▒│
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+Solutions found: 1
+status: OPTIMAL
+Time taken: 14.20 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/tapa_solved.png" alt="Tapa solved" width="500">
+
+---
+
+## Binairo Plus (Puzzle Type #49)
+
+* [**Play online**](https://www.puzzle-binairo.com/binairo-plus-6x6-easy/)
+
+* [**Solver Code**][49]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+Binairo+ is played on a rectangular grid with no standard size. Some cells start out filled with black or white circles. The rest of the cells are empty. The goal is to place circles in all cells in such a way that:
+1. Each row and each column must contain an equal number of white and black circles.
+2. More than two circles of the same color can't be adjacent.
+3. Two cells with a "=" sign between them should contain circles of the same type.
+4. Two cells with a "x" sign between them should contain circles of the opposite type. 
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/binairo_plus_unsolved.png" alt="Binairo Plus unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import binairo_plus_solver as solver
+board = np.array([
+    [' ', ' ', 'W', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' '],
+    ['B', ' ', ' ', ' ', 'W', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', 'B'],
+    [' ', ' ', ' ', ' ', ' ', 'W', ' ', ' ', 'W', ' ', ' ', ' ', ' ', ' '],
+    ['B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'W'],
+    [' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' '],
+    ['W', ' ', 'B', ' ', 'W', ' ', ' ', ' ', ' ', 'W', ' ', 'B', ' ', 'B'],
+    [' ', ' ', 'W', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' '],
+    [' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'W', ' ', ' '],
+    ['B', ' ', 'W', ' ', 'B', ' ', ' ', ' ', ' ', 'W', ' ', 'W', ' ', 'B'],
+    [' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', 'W', ' ', ' ', ' '],
+    ['W', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B'],
+    [' ', ' ', ' ', ' ', ' ', 'W', ' ', ' ', 'W', ' ', ' ', ' ', ' ', ' '],
+    ['W', ' ', ' ', ' ', 'W', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', 'W'],
+    [' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'W', ' ', ' '],
+])
+# between cells horizontally
+arith_rows = np.array([
+    [' ', ' ', ' ', '=', ' ', 'x', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', 'x', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    ['x', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '=', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', 'x', 'x', ' ', ' ', ' ', 'x', ' ', ' ', ' ', ' '],
+])
+# between cells vertically
+arith_cols = np.array([
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', '=', ' ', ' ', 'x', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', 'x', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', 'x', '=', ' ', '=', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', 'x', ' ', ' ', ' ', ' ', ' ', 'x', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '=', ' ', 'x', ' ', ' ', ' ', 'x', ' '],
+])
+binst = solver.Board(board=board, arith_rows=arith_rows, arith_cols=arith_cols)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+```python
+Solution found
+    0   0   0   0   0   0   0   0   0   0   1   1   1   1
+    0   1   2   3   4   5   6   7   8   9   0   1   2   3
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│   │   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│▒▒▒│▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+10│   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│   │   │▒▒▒│   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+11│▒▒▒│▒▒▒│   │   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│   │   │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+12│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │   │▒▒▒│▒▒▒│   │▒▒▒│▒▒▒│   │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+13│   │   │▒▒▒│▒▒▒│   │▒▒▒│   │▒▒▒│   │▒▒▒│▒▒▒│   │   │▒▒▒│
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+Solutions found: 1
+status: OPTIMAL
+Time taken: 0.00 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/binairo_plus_solved.png" alt="Binairo Plus solved" width="500">
+
+---
+
+## Shakashaka (Puzzle Type #50)
+
+Also called "Proof of Quilt"
+
+* [**Play online**](https://www.puzzle-shakashaka.com/)
+
+* [**Solver Code**][50]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+Shakashaka is played on a rectangular grid. The grid has both black cells and white cells in it.
+The objective is to place black triangles in the white cell in such a way so that they form white rectangular (or square) areas.
+- The triangles are right angled and occupy half of the white square divided diagonally.
+- You can place triangles only in white cells
+- The numbers in the black cells indicate how many triangles are adjacent, vertically and horizontally.
+- The white rectangles can be either straight or rotated at 45° 
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shakashaka_unsolved.png" alt="Shakashaka unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import shakashaka_solver as solver
+board = np.array([
+    [' ', ' ', 'B', ' ', '1', ' ', ' ', '1', ' ', ' ', 'B', 'B', ' ', ' ', ' ', '2', ' ', ' ', ' ', ' ', 'B', ' ', 'B', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '4', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', ' ', ' ', 'B'],
+    ['1', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '2', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '4', ' ', ' ', ' ', ' '],
+    [' ', ' ', '3', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' '],
+    [' ', ' ', ' ', '1', ' ', ' ', '2', ' ', ' ', ' ', ' ', 'B', ' ', '3', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', 'B', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', '4', ' ', ' ', ' ', 'B'],
+    [' ', 'B', '2', ' ', ' ', 'B', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', '2', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '4', ' ', ' '],
+    ['B', ' ', ' ', ' ', ' ', 'B', ' ', ' ', '1', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    ['0', ' ', ' ', 'B', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', 'B', 'B', 'B', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', ' ', 'B'],
+    ['0', ' ', ' ', 'B', ' ', ' ', ' ', 'B', ' ', ' ', ' ', '1', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '3', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '2', ' ', 'B', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', 'B', ' ', 'B', ' ', 'B', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', '4', ' ', ' ', '3', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', '4', ' ', ' ', ' ', ' '],
+    [' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', '3', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', '3'],
+    ['B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', '1', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '4', ' ', ' ', ' '],
+    [' ', ' ', 'B', ' ', 'B', ' ', ' ', '2', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', 'B', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '0', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' '],
+    ['B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '2', 'B', ' ', ' ', '2', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' ', '1', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', '3', ' ', ' ', ' ', '2', ' ', ' ', '1', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', 'B', ' ', ' ', ' ', ' '],
+    [' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', 'B', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', '2'],
+    ['2', ' ', ' ', 'B', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', 'B', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', ' ', '3', ' ', ' ', ' ', ' ', ' ', '2', ' ', ' ', ' ', ' ', '0', ' ', ' ', ' ', ' ', ' ', '2', ' '],
+])
+binst = solver.Board(board=board)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+(Note: It took so long to find a good text-based visualization to the solution that is both readable and looks good, this isn't the best but it finally does the job)
+
+```python
+Solution found
+┌──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐
+│     /│\     │      │██████│      │     /│\     │      │██████│██████│      │      │██████│     /│\     │      │██████│     /│\     │██████│      │██████│      │     /│\     │
+│  /███│██\   │   .  │██████│   1  │  /███│██\   │   1  │██████│██████│   .  │   .  │██████│  /███│██\   │   2  │██████│  /███│██\   │██████│   .  │██████│   .  │  /███│██\   │
+│/█████│█████\│      │██████│      │/█████│█████\│      │██████│██████│      │      │██████│/█████│█████\│      │██████│/█████│█████\│██████│      │██████│      │/█████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│\█████│█████/│     /│\     │██████│\█████│█████/│██████│     /│\     │██████│      │██████│\█████│██████│\     │      │\█████│██████│\     │██████│     /│\     │\█████│█████/│
+│  \███│██/   │  /███│██\   │██████│  \███│██/   │██████│  /███│██\   │██████│   .  │██████│  \███│██████│██\   │   .  │  \███│██████│██\   │██████│  /███│██\   │  \███│██/   │
+│     \│/     │/█████│█████\│██████│     \│/     │██████│/█████│█████\│██████│      │██████│     \│██████│█████\│      │     \│██████│█████\│██████│/█████│█████\│     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│     /│██████│██████│\     │     /│\     │      │\█████│██████│\     │██████│     /│\     │\█████│██████│\     │      │\█████│█████/│     /│██████│██████│\     │██████│
+│██████│  /███│██████│██████│██\   │  /███│██\   │   3  │  \███│██████│██\   │██████│  /███│██\   │  \███│██████│██\   │   4  │  \███│██/   │  /███│██████│██████│██\   │██████│
+│██████│/█████│██████│██████│█████\│/█████│█████\│      │     \│██████│█████\│██████│/█████│█████\│     \│██████│█████\│      │     \│/     │/█████│██████│██████│█████\│██████│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│\█████│██████│██████│█████/│\█████│█████/│     /│\     │\█████│█████/│      │\█████│█████/│██████│\█████│██████│\     │      │██████│\█████│██████│██████│█████/│      │
+│██████│  \███│██████│██████│██/   │  \███│██/   │  /███│██\   │  \███│██/   │   .  │  \███│██/   │██████│  \███│██████│██\   │   3  │██████│  \███│██████│██████│██/   │   .  │
+│██████│     \│██████│██████│/     │     \│/     │/█████│█████\│     \│/     │      │     \│/     │██████│     \│██████│█████\│      │██████│     \│██████│██████│/     │      │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│\█████│█████/│     /│\     │     /│██████│█████/│██████│      │     /│\     │     /│\     │██████│\█████│█████/│     /│\     │      │\█████│█████/│██████│██████│
+│   1  │██████│  \███│██/   │  /███│██\   │  /███│██████│██/   │██████│   2  │  /███│██\   │  /███│██\   │██████│  \███│██/   │  /███│██\   │   4  │  \███│██/   │██████│██████│
+│      │██████│     \│/     │/█████│█████\│/█████│██████│/     │██████│      │/█████│█████\│/█████│█████\│██████│     \│/     │/█████│█████\│      │     \│/     │██████│██████│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│     /│\     │      │██████│\█████│█████/│\█████│█████/│     /│\     │██████│\█████│█████/│\█████│█████/│     /│\     │██████│\█████│█████/│     /│\     │      │     /│\     │
+│  /███│██\   │   3  │██████│  \███│██/   │  \███│██/   │  /███│██\   │██████│  \███│██/   │  \███│██/   │  /███│██\   │██████│  \███│██/   │  /███│██\   │   .  │  /███│██\   │
+│/█████│█████\│      │██████│     \│/     │     \│/     │/█████│█████\│██████│     \│/     │     \│/     │/█████│█████\│██████│     \│/     │/█████│█████\│      │/█████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│\█████│██████│\     │      │██████│██████│      │     /│██████│██████│\     │      │██████│      │     /│██████│█████/│      │     /│\     │\█████│██████│\     │\█████│█████/│
+│  \███│██████│██\   │   1  │██████│██████│   2  │  /███│██████│██████│██\   │   .  │██████│   3  │  /███│██████│██/   │   .  │  /███│██\   │  \███│██████│██\   │  \███│██/   │
+│     \│██████│█████\│      │██████│██████│      │/█████│██████│██████│█████\│      │██████│      │/█████│██████│/     │      │/█████│█████\│     \│██████│█████\│     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│\█████│█████/│      │██████│██████│      │\█████│██████│██████│█████/│██████│     /│\     │\█████│█████/│      │██████│\█████│█████/│      │\█████│█████/│██████│      │
+│██████│  \███│██/   │   .  │██████│██████│   .  │  \███│██████│██████│██/   │██████│  /███│██\   │  \███│██/   │   3  │██████│  \███│██/   │   4  │  \███│██/   │██████│   .  │
+│██████│     \│/     │      │██████│██████│      │     \│██████│██████│/     │██████│/█████│█████\│     \│/     │      │██████│     \│/     │      │     \│/     │██████│      │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│      │      │     /│\     │      │██████│██████│\█████│█████/│      │     /│██████│█████/│      │██████│     /│\     │     /│\     │     /│\     │      │     /│\     │
+│██████│   .  │   2  │  /███│██\   │   .  │██████│██████│  \███│██/   │   3  │  /███│██████│██/   │   2  │██████│  /███│██\   │  /███│██\   │  /███│██\   │   4  │  /███│██\   │
+│██████│      │      │/█████│█████\│      │██████│██████│     \│/     │      │/█████│██████│/     │      │██████│/█████│█████\│/█████│█████\│/█████│█████\│      │/█████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│██████│\█████│█████/│      │██████│██████│      │██████│██████│\█████│█████/│██████│██████│     /│██████│█████/│\█████│█████/│\█████│█████/│     /│██████│█████/│
+│   .  │██████│██████│  \███│██/   │   .  │██████│██████│   1  │██████│██████│  \███│██/   │██████│██████│  /███│██████│██/   │  \███│██/   │  \███│██/   │  /███│██████│██/   │
+│      │██████│██████│     \│/     │      │██████│██████│      │██████│██████│     \│/     │██████│██████│/█████│██████│/     │     \│/     │     \│/     │/█████│██████│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│██████│      │     /│\     │██████│██████│      │     /│\     │██████│      │      │      │\█████│█████/│     /│\     │      │██████│     /│██████│█████/│      │
+│   0  │██████│██████│   .  │  /███│██\   │██████│██████│   .  │  /███│██\   │██████│   .  │   .  │   .  │  \███│██/   │  /███│██\   │   3  │██████│  /███│██████│██/   │   .  │
+│      │██████│██████│      │/█████│█████\│██████│██████│      │/█████│█████\│██████│      │      │      │     \│/     │/█████│█████\│      │██████│/█████│██████│/     │      │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│██████│      │\█████│██████│\     │      │     /│██████│█████/│      │██████│     /│\     │██████│     /│██████│██████│\     │██████│\█████│█████/│      │██████│
+│   0  │██████│██████│   .  │  \███│██████│██\   │   .  │  /███│██████│██/   │   1  │██████│  /███│██\   │██████│  /███│██████│██████│██\   │██████│  \███│██/   │   3  │██████│
+│      │██████│██████│      │     \│██████│█████\│      │/█████│██████│/     │      │██████│/█████│█████\│██████│/█████│██████│██████│█████\│██████│     \│/     │      │██████│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│     /│\     │     /│\     │\█████│██████│\     │\█████│█████/│      │██████│      │\█████│█████/│      │\█████│██████│██████│██████│\     │      │     /│\     │██████│
+│██████│  /███│██\   │  /███│██\   │  \███│██████│██\   │  \███│██/   │   2  │██████│   .  │  \███│██/   │   .  │  \███│██████│██████│██████│██\   │   .  │  /███│██\   │██████│
+│██████│/█████│█████\│/█████│█████\│     \│██████│█████\│     \│/     │      │██████│      │     \│/     │      │     \│██████│██████│██████│█████\│      │/█████│█████\│██████│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│     /│██████│█████/│\█████│█████/│      │\█████│█████/│      │██████│      │██████│      │██████│      │     /│\     │\█████│██████│██████│█████/│██████│\█████│██████│\     │
+│  /███│██████│██/   │  \███│██/   │   .  │  \███│██/   │   .  │██████│   .  │██████│   .  │██████│   .  │  /███│██\   │  \███│██████│██████│██/   │██████│  \███│██████│██\   │
+│/█████│██████│/     │     \│/     │      │     \│/     │      │██████│      │██████│      │██████│      │/█████│█████\│     \│██████│██████│/     │██████│     \│██████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│\█████│█████/│     /│\     │      │     /│\     │      │██████│      │██████│     /│\     │     /│\     │\█████│█████/│      │\█████│█████/│      │     /│\     │\█████│█████/│
+│  \███│██/   │  /███│██\   │   4  │  /███│██\   │   3  │██████│   .  │██████│  /███│██\   │  /███│██\   │  \███│██/   │   .  │  \███│██/   │   4  │  /███│██\   │  \███│██/   │
+│     \│/     │/█████│█████\│      │/█████│█████\│      │██████│      │██████│/█████│█████\│/█████│█████\│     \│/     │      │     \│/     │      │/█████│█████\│     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│      │\█████│██████│\     │\█████│█████/│     /│\     │██████│      │\█████│█████/│\█████│█████/│      │     /│\     │      │     /│\     │\█████│██████│\     │      │
+│██████│   .  │  \███│██████│██\   │  \███│██/   │  /███│██\   │██████│   .  │  \███│██/   │  \███│██/   │   3  │  /███│██\   │   .  │  /███│██\   │  \███│██████│██\   │   3  │
+│██████│      │     \│██████│█████\│     \│/     │/█████│█████\│██████│      │     \│/     │     \│/     │      │/█████│█████\│      │/█████│█████\│     \│██████│█████\│      │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│██████│\█████│█████/│██████│██████│\█████│█████/│      │     /│\     │██████│      │██████│██████│\█████│██████│\     │\█████│█████/│      │\█████│██████│\     │
+│   .  │██████│██████│  \███│██/   │██████│██████│  \███│██/   │   .  │  /███│██\   │██████│   1  │██████│██████│  \███│██████│██\   │  \███│██/   │   4  │  \███│██████│██\   │
+│      │██████│██████│     \│/     │██████│██████│     \│/     │      │/█████│█████\│██████│      │██████│██████│     \│██████│█████\│     \│/     │      │     \│██████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│     /│\     │      │██████│      │██████│██████│      │██████│     /│██████│██████│\     │      │██████│██████│      │\█████│█████/│      │     /│\     │██████│\█████│█████/│
+│  /███│██\   │   .  │██████│   .  │██████│██████│   2  │██████│  /███│██████│██████│██\   │   .  │██████│██████│   .  │  \███│██/   │   .  │  /███│██\   │██████│  \███│██/   │
+│/█████│█████\│      │██████│      │██████│██████│      │██████│/█████│██████│██████│█████\│      │██████│██████│      │     \│/     │      │/█████│█████\│██████│     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│\█████│█████/│██████│     /│\     │██████│██████│     /│\     │\█████│██████│██████│██████│\     │██████│██████│      │██████│     /│\     │\█████│█████/│      │     /│\     │
+│  \███│██/   │██████│  /███│██\   │██████│██████│  /███│██\   │  \███│██████│██████│██████│██\   │██████│██████│   0  │██████│  /███│██\   │  \███│██/   │   .  │  /███│██\   │
+│     \│/     │██████│/█████│█████\│██████│██████│/█████│█████\│     \│██████│██████│██████│█████\│██████│██████│      │██████│/█████│█████\│     \│/     │      │/█████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │██████│     /│██████│█████/│██████│██████│\█████│█████/│      │\█████│██████│██████│█████/│██████│██████│      │     /│██████│█████/│██████│██████│██████│\█████│█████/│
+│   .  │██████│  /███│██████│██/   │██████│██████│  \███│██/   │   .  │  \███│██████│██████│██/   │██████│██████│   .  │  /███│██████│██/   │██████│██████│██████│  \███│██/   │
+│      │██████│/█████│██████│/     │██████│██████│     \│/     │      │     \│██████│██████│/     │██████│██████│      │/█████│██████│/     │██████│██████│██████│     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│     /│██████│█████/│     /│\     │      │      │██████│██████│      │\█████│█████/│     /│\     │      │     /│██████│█████/│██████│      │     /│\     │     /│\     │
+│██████│  /███│██████│██/   │  /███│██\   │   2  │   .  │██████│██████│   2  │  \███│██/   │  /███│██\   │   .  │  /███│██████│██/   │██████│   1  │  /███│██\   │  /███│██\   │
+│██████│/█████│██████│/     │/█████│█████\│      │      │██████│██████│      │     \│/     │/█████│█████\│      │/█████│██████│/     │██████│      │/█████│█████\│/█████│█████\│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│     /│██████│█████/│      │\█████│██████│\     │      │██████│██████│      │     /│\     │\█████│█████/│██████│\█████│█████/│      │██████│      │\█████│█████/│\█████│█████/│
+│  /███│██████│██/   │   3  │  \███│██████│██\   │   2  │██████│██████│   1  │  /███│██\   │  \███│██/   │██████│  \███│██/   │   .  │██████│   .  │  \███│██/   │  \███│██/   │
+│/█████│██████│/     │      │     \│██████│█████\│      │██████│██████│      │/█████│█████\│     \│/     │██████│     \│/     │      │██████│      │     \│/     │     \│/     │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│\█████│█████/│      │██████│██████│\█████│██████│\     │██████│██████│      │\█████│██████│\     │      │     /│\     │      │     /│\     │██████│██████│     /│\     │      │
+│  \███│██/   │   .  │██████│██████│  \███│██████│██\   │██████│██████│   .  │  \███│██████│██\   │   .  │  /███│██\   │   .  │  /███│██\   │██████│██████│  /███│██\   │   2  │
+│     \│/     │      │██████│██████│     \│██████│█████\│██████│██████│      │     \│██████│█████\│      │/█████│█████\│      │/█████│█████\│██████│██████│/█████│█████\│      │
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│      │     /│\     │      │     /│\     │\█████│██████│\     │     /│\     │      │\█████│██████│\     │\█████│█████/│██████│\█████│█████/│      │     /│██████│█████/│██████│
+│   2  │  /███│██\   │   .  │  /███│██\   │  \███│██████│██\   │  /███│██\   │   3  │  \███│██████│██\   │  \███│██/   │██████│  \███│██/   │   .  │  /███│██████│██/   │██████│
+│      │/█████│█████\│      │/█████│█████\│     \│██████│█████\│/█████│█████\│      │     \│██████│█████\│     \│/     │██████│     \│/     │      │/█████│██████│/     │██████│
+├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
+│██████│\█████│█████/│██████│\█████│█████/│      │\█████│█████/│\█████│█████/│██████│      │\█████│█████/│██████│██████│      │██████│██████│██████│\█████│█████/│      │██████│
+│██████│  \███│██/   │██████│  \███│██/   │   3  │  \███│██/   │  \███│██/   │██████│   2  │  \███│██/   │██████│██████│   0  │██████│██████│██████│  \███│██/   │   2  │██████│
+│██████│     \│/     │██████│     \│/     │      │     \│/     │     \│/     │██████│      │     \│/     │██████│██████│      │██████│██████│██████│     \│/     │      │██████│
+└──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘Solutions found: 1
+status: OPTIMAL
+Time taken: 0.37 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/shakashaka_solved.png" alt="Shakashaka solved" width="500">
+
+---
+
+## Kakuro (Puzzle Type #51)
+
+* [**Play online**](https://www.puzzle-kakuro.com/)
+
+* [**Solver Code**][51]
+
+<details>
+  <summary><strong>Rules</strong></summary>
+
+Kakuro is played on a rectangular grid by placing numbers in the white cells such that:
+   1. Each white cell should contain a number from 1 through 9
+   2. The clues in the black cells tells the sum of the numbers in the consecutive white cells next to that clue. (on the right or down)
+   3. The numbers in consecutive white cells must be unique.
+
+</details>
+
+**Unsolved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/kakuro_unsolved.png" alt="Kakuro unsolved" width="500">
+
+Code to utilize this package and solve the puzzle:
+
+```python
+import numpy as np
+from puzzle_solver import kakuro_solver as solver
+board = np.array([
+    ['#', '#', ' ', ' ', '#', ' ', ' ', '#', ' ', ' '],
+    [' ', ' ', ' ', ' ', '#', ' ', ' ', ' ', ' ', ' '],
+    [' ', ' ', ' ', '#', ' ', ' ', '#', ' ', ' ', '#'],
+    ['#', '#', ' ', ' ', ' ', '#', '#', ' ', ' ', '#'],
+    [' ', ' ', '#', ' ', ' ', ' ', ' ', '#', ' ', ' '],
+    [' ', ' ', '#', ' ', ' ', ' ', ' ', '#', ' ', ' '],
+    ['#', ' ', ' ', '#', '#', ' ', ' ', ' ', '#', '#'],
+    ['#', ' ', ' ', '#', ' ', ' ', '#', ' ', ' ', ' '],
+    [' ', ' ', ' ', ' ', ' ', '#', ' ', ' ', ' ', ' '],
+    [' ', ' ', '#', ' ', ' ', '#', ' ', ' ', '#', '#'],
+])
+row_sums = [[7, 16, 12, ], [28, 23, ], [22, 16, 9, ], [18, 15, ], [12, 11, 16, ], [9, 24, 8, ], [7, 9, ], [14, 7, 20, ], [23, 30, ], [11, 3, 4, ]]
+col_sums = [[14, 12, 8, ], [15, 21, ], [29, 23, ], [8, 10, 11, ], [24, 8, ], [21, 13, ], [17, 12, 11, ], [21, 15, ], [29, 17, ], [4, 16, 15]]
+binst = solver.Board(board=board, row_sums=row_sums, col_sums=col_sums)
+solutions = binst.solve_and_print()
+```
+
+**Script Output**
+
+```python
+Solution found
+    0   0   0   0   0   0   0   0   0   0
+    0   1   2   3   4   5   6   7   8   9
+  ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+ 0│▒▒▒│▒▒▒│ 5 │ 2 │▒▒▒│ 7 │ 9 │▒▒▒│ 9 │ 3 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 1│ 5 │ 9 │ 8 │ 6 │▒▒▒│ 5 │ 8 │ 7 │ 2 │ 1 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 2│ 9 │ 6 │ 7 │▒▒▒│ 7 │ 9 │▒▒▒│ 5 │ 4 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 3│▒▒▒│▒▒▒│ 9 │ 3 │ 6 │▒▒▒│▒▒▒│ 9 │ 6 │▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 4│ 9 │ 3 │▒▒▒│ 2 │ 3 │ 1 │ 5 │▒▒▒│ 7 │ 9 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 5│ 3 │ 6 │▒▒▒│ 5 │ 8 │ 7 │ 4 │▒▒▒│ 1 │ 7 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 6│▒▒▒│ 1 │ 6 │▒▒▒│▒▒▒│ 2 │ 3 │ 4 │▒▒▒│▒▒▒│
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 7│▒▒▒│ 5 │ 9 │▒▒▒│ 4 │ 3 │▒▒▒│ 3 │ 8 │ 9 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 8│ 1 │ 2 │ 8 │ 9 │ 3 │▒▒▒│ 8 │ 7 │ 9 │ 6 │
+  ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+ 9│ 7 │ 4 │▒▒▒│ 2 │ 1 │▒▒▒│ 3 │ 1 │▒▒▒│▒▒▒│
+  └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+Solutions found: 1
+status: OPTIMAL
+Time taken: 0.00 seconds
+```
+
+**Solved puzzle**
+
+<img src="https://raw.githubusercontent.com/Ar-Kareem/puzzle_solver/master/images/kakuro_solved.png" alt="Kakuro solved" width="500">
+
+---
+
 ---
 
 ## Why SAT / CP-SAT?
@@ -4109,3 +4918,9 @@ Issues and PRs welcome!
 [43]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/palisade "puzzle_solver/src/puzzle_solver/puzzles/palisade at master · Ar-Kareem/puzzle_solver · GitHub"
 [44]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/flip "puzzle_solver/src/puzzle_solver/puzzles/flip at master · Ar-Kareem/puzzle_solver · GitHub"
 [45]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/nurikabe "puzzle_solver/src/puzzle_solver/puzzles/nurikabe at master · Ar-Kareem/puzzle_solver · GitHub"
+[46]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/heyawake "puzzle_solver/src/puzzle_solver/puzzles/heyawake at master · Ar-Kareem/puzzle_solver · GitHub"
+[47]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/shingoki "puzzle_solver/src/puzzle_solver/puzzles/shingoki at master · Ar-Kareem/puzzle_solver · GitHub"
+[48]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/tapa "puzzle_solver/src/puzzle_solver/puzzles/tapa at master · Ar-Kareem/puzzle_solver · GitHub"
+[49]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/binairo_plus "puzzle_solver/src/puzzle_solver/puzzles/binairo_plus at master · Ar-Kareem/puzzle_solver · GitHub"
+[50]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/shakashaka "puzzle_solver/src/puzzle_solver/puzzles/shakashaka at master · Ar-Kareem/puzzle_solver · GitHub"
+[51]: https://github.com/Ar-Kareem/puzzle_solver/tree/master/src/puzzle_solver/puzzles/kakuro "puzzle_solver/src/puzzle_solver/puzzles/kakuro at master · Ar-Kareem/puzzle_solver · GitHub"