chore: merge Fix/742 migrate doctest to jest (#749)

* Remove QuickSelect doctest

There are more Jest test cases already.

* Remove AverageMedian doctest

Already migrated to jest

* Migrate doctest for BinaryExponentiationRecursive.js

(also remove inline "main" test method)

* Migrate doctest for EulersTotient.js

(also remove inline "main" test method)

* Migrate doctest for PrimeFactors.js

(also remove inline "main" test method)

* Migrate doctest for BogoSort.js

Re-write prototype-polluting helper methods, too.

(also remove inline test driver code)

* Migrate doctest for BeadSort.js

(also remove inline test driver code)

* Migrate doctest for BucketSort.js

(also remove inline test driver code)

* Migrate doctest for CocktailShakerSort.js

(also remove inline test driver code)

* Migrate doctest for MergeSort.js

(also remove inline test driver code)

* Migrate doctest for QuickSort.js

(also remove inline test driver code)

* Migrate doctest for ReverseString.js

(also remove inline test driver code)

* Migrate doctest for ReverseString.js

* Migrate doctest for ValidateEmail.js

* Migrate doctest for ConwaysGameOfLife.js

(remove the animate code, too)

* Remove TernarySearch doctest

Already migrated to jest

* Migrate doctest for BubbleSort.js

(also remove inline test driver code)

* Remove doctest from CI and from dependencies

relates to #742
fixes #586

* Migrate doctest for RgbHsvConversion.js

* Add --fix option to "standard" npm script

* Migrate doctest for BreadthFirstSearch.js

(also remove inline test driver code)

* Migrate doctest for BreadthFirstShortestPath.js

(also remove inline test driver code)

* Migrate doctest for EulerMethod.js

(also remove inline test driver code)

Move manual test-code for plotting stuff in the browser in a distinct file, too. Those "*.manual-test.js" files are excluded from the UpdateDirectory.mjs script, as well.

* Migrate doctest for Mandelbrot.js

(also remove inline test driver code & moved manual drawing test into a *.manual-test.js)

* Migrate doctest for FloodFill.js

* Migrate doctest for KochSnowflake.js

(also move manual drawing test into a *.manual-test.js)

* Update npm lockfile

* Update README and COMMITTING with a few bits & bobs regarding testing & code quality

Recursive/FloodFill.test.js

@@ -0,0 +1,80 @@
+import { breadthFirstSearch, depthFirstSearch } from './FloodFill'
+
+// some constants
+const black = [0, 0, 0]
+const green = [0, 255, 0]
+const violet = [255, 0, 255]
+const white = [255, 255, 255]
+const orange = [255, 128, 0]
+
+describe('FloodFill', () => {
+  it('should calculate the correct colors using breadth-first approach', () => {
+    expect(testBreadthFirst([1, 1], green, orange, [1, 1])).toEqual(orange)
+    expect(testBreadthFirst([1, 1], green, orange, [0, 1])).toEqual(violet)
+    expect(testBreadthFirst([1, 1], green, orange, [6, 4])).toEqual(white)
+  })
+
+  it('should calculate the correct colors using depth-first approach', () => {
+    expect(testDepthFirst([1, 1], green, orange, [1, 1])).toEqual(orange)
+    expect(testDepthFirst([1, 1], green, orange, [0, 1])).toEqual(violet)
+    expect(testDepthFirst([1, 1], green, orange, [6, 4])).toEqual(white)
+  })
+})
+
+/**
+ * Utility-function to test the function "breadthFirstSearch".
+ *
+ * @param fillLocation The start location on the image where the flood fill is applied.
+ * @param targetColor The old color to be replaced.
+ * @param replacementColor The new color to replace the old one.
+ * @param testLocation The location of the color to be checked.
+ * @return The color at testLocation.
+ */
+function testBreadthFirst (fillLocation, targetColor, replacementColor, testLocation) {
+  const rgbData = generateTestRgbData()
+  breadthFirstSearch(rgbData, fillLocation, targetColor, replacementColor)
+  return rgbData[testLocation[0]][testLocation[1]]
+}
+
+/**
+ * Utility-function to test the function "depthFirstSearch".
+ *
+ * @param fillLocation The start location on the image where the flood fill is applied.
+ * @param targetColor The old color to be replaced.
+ * @param replacementColor The new color to replace the old one.
+ * @param testLocation The location of the color to be checked.
+ * @return The color at testLocation.
+ */
+function testDepthFirst (fillLocation, targetColor, replacementColor, testLocation) {// eslint-disable-line
+  const rgbData = generateTestRgbData()
+  depthFirstSearch(rgbData, fillLocation, targetColor, replacementColor)
+  return rgbData[testLocation[0]][testLocation[1]]
+}
+
+/**
+ * Generates the rgbData-matrix for the tests.
+ *
+ * @return example rgbData-matrix.
+ */
+function generateTestRgbData () {
+  const layout = [
+    [violet, violet, green, green, black, green, green],
+    [violet, green, green, black, green, green, green],
+    [green, green, green, black, green, green, green],
+    [black, black, green, black, white, white, green],
+    [violet, violet, black, violet, violet, white, white],
+    [green, green, green, violet, violet, violet, violet],
+    [violet, violet, violet, violet, violet, violet, violet]
+  ]
+
+  // transpose layout-matrix so the x-index comes before the y-index
+  const transposed = []
+  for (let x = 0; x < layout[0].length; x++) {
+    transposed[x] = []
+    for (let y = 0; y < layout.length; y++) {
+      transposed[x][y] = layout[y][x]
+    }
+  }
+
+  return transposed
+}