Sync flatten-array (#340)

Note that on this track we use lists instead of arrays for
the flatten-array exercise.

[no important files changed]

Author: keiravillekode

exercises/practice/flatten-array/.docs/instructions.md

@@ -1,11 +1,16 @@
 # Instructions
 
-Take a nested list and return a single flattened list with all values except nil/null.
+Take a nested array of any depth and return a fully flattened array.
 
-The challenge is to take an arbitrarily-deep nested list-like structure and produce a flattened structure without any nil/null values.
+Note that some language tracks may include null-like values in the input array, and the way these values are represented varies by track.
+Such values should be excluded from the flattened array.
 
-For example:
+Additionally, the input may be of a different data type and contain different types, depending on the track.
 
-input: [1,[2,3,null,4],[null],5]
+Check the test suite for details.
 
-output: [1,2,3,4,5]
+## Example
+
+input: `[1, [2, 6, null], [[null, [4]], 5]]`
+
+output: `[1, 2, 6, 4, 5]`

exercises/practice/flatten-array/.docs/introduction.md

@@ -0,0 +1,7 @@
+# Introduction
+
+A shipment of emergency supplies has arrived, but there's a problem.
+To protect from damage, the items — flashlights, first-aid kits, blankets — are packed inside boxes, and some of those boxes are nested several layers deep inside other boxes!
+
+To be prepared for an emergency, everything must be easily accessible in one box.
+Can you unpack all the supplies and place them into a single box, so they're ready when needed most?

exercises/practice/flatten-array/.meta/tests.toml

@@ -32,12 +32,32 @@ description = "null values are omitted from the final result"
 
 [c6cf26de-8ccd-4410-84bd-b9efd88fd2bc]
 description = "consecutive null values at the front of the list are omitted from the final result"
+include = false
+
+[bc72da10-5f55-4ada-baf3-50e4da02ec8e]
+description = "consecutive null values at the front of the array are omitted from the final result"
+reimplements = "c6cf26de-8ccd-4410-84bd-b9efd88fd2bc"
 
 [382c5242-587e-4577-b8ce-a5fb51e385a1]
 description = "consecutive null values in the middle of the list are omitted from the final result"
+include = false
+
+[6991836d-0d9b-4703-80a0-3f1f23eb5981]
+description = "consecutive null values in the middle of the array are omitted from the final result"
+reimplements = "382c5242-587e-4577-b8ce-a5fb51e385a1"
 
 [ef1d4790-1b1e-4939-a179-51ace0829dbd]
 description = "6 level nest list with null values"
+include = false
+
+[dc90a09c-5376-449c-a7b3-c2d20d540069]
+description = "6 level nested array with null values"
+reimplements = "ef1d4790-1b1e-4939-a179-51ace0829dbd"
 
 [85721643-705a-4150-93ab-7ae398e2942d]
 description = "all values in nested list are null"
+include = false
+
+[51f5d9af-8f7f-4fb5-a156-69e8282cb275]
+description = "all values in nested array are null"
+reimplements = "85721643-705a-4150-93ab-7ae398e2942d"

exercises/practice/flatten-array/test.sml

@@ -22,14 +22,14 @@ val testsuite =
         flatten nested |> Expect.equalTo [0, 1, 2]
       end),
 
-    test "flattens a nested array"
+    test "flattens a nested list"
       (fn _ => let
         val nested = List [List [List []]]
       in
         flatten nested |> Expect.equalTo []
       end),
 
-    test "flattens array with just integers present"
+    test "flattens list with just integers present"
       (fn _ => let
         val nested = List [Elem 1,
                            List [Elem 2, Elem 3, Elem 4, Elem 5, Elem 6, Elem 7],
@@ -86,7 +86,7 @@ val testsuite =
         flatten nested |> Expect.equalTo [1, 4]
       end),
 
-    test "6 level nest list with Empty values"
+    test "6 level nested list with Empty values"
       (fn _ => let
         val nested = List [Elem 0,
                            Elem 2,
@@ -102,15 +102,15 @@ val testsuite =
 
     test "all values in nested list are Empty"
       (fn _ => let
-         val nested = List [Empty,
-                            List [List [List [Empty]]],
-                            Empty,
-                            Empty,
-                            List [List [Empty, Empty], Empty],
-                            Empty]
-       in
-         flatten nested |> Expect.equalTo []
-       end)
+        val nested = List [Empty,
+                           List [List [List [Empty]]],
+                           Empty,
+                           Empty,
+                           List [List [Empty, Empty], Empty],
+                           Empty]
+      in
+        flatten nested |> Expect.equalTo []
+      end)
   ]
 
 val _ = Test.run testsuite