Array.fromSingleton

Author: jmagaram

src/Core__Array.res

@@ -246,4 +246,4 @@ let findMap = (arr, f) => {
 
 @send external at: (array<'a>, int) => option<'a> = "at"
 
-@val external fromOneItem: 'a => array<'a> = "Array.of"
+@val external fromSingleton: 'a => array<'a> = "Array.of"

src/Core__Array.resi

@@ -971,17 +971,21 @@ let findMap: (array<'a>, 'a => option<'b>) => option<'b>
 external at: (array<'a>, int) => option<'a> = "at"
 
 /**
-`fromOneItem` generates a new array from a single value. See [Array.of on MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/of)
+`fromSingleton` generates a new array from a single value.
 
 ## Examples
 
 ```rescript
-3->Array.fromOneItem // [3]
-undefined->Array.fromOneItem // [undefined]
-Some("abc")->Array.fromOneItem // [Some("abc")]
-[1,2,3]->Array.fromOneItem // [[1,2,3]]
-{"x": 3, "y": 5}->Array.fromOneItem // Some({"x": 3, "y": 5})
+3->Array.fromSingleton // [3]
+undefined->Array.fromSingleton // [undefined]
+Some("abc")->Array.fromSingleton // [Some("abc")]
+{"x": 3, "y": 5}->Array.fromSingleton // Some({"x": 3, "y": 5})
 ```
+
+## Specifications
+
+- [Array.of MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/of)
+- [Array.of ECMAScript Language Specification](https://tc39.es/ecma262/multipage/indexed-collections.html#sec-array.of)
 */
 @val
-external fromOneItem: 'a => array<'a> = "Array.of"
+external fromSingleton: 'a => array<'a> = "Array.of"

test/ArrayTests.mjs

@@ -407,27 +407,27 @@ function singletonTest(a, title) {
           "ArrayTests.res",
           103,
           22,
-          46
+          48
         ],
-        "fromOneItem : " + title + ""
+        "fromSingleton : " + title + ""
       ], Array.of(a), Caml_obj.equal, [a]);
   Test.run([
         [
           "ArrayTests.res",
           104,
           22,
-          46
+          48
         ],
-        "fromOneItem : " + title + ""
+        "fromSingleton : " + title + ""
       ], Array.of(a).length, eq, 1);
   Test.run([
         [
           "ArrayTests.res",
           106,
           15,
-          39
+          41
         ],
-        "fromOneItem : " + title + ""
+        "fromSingleton : " + title + ""
       ], Array.of(a)[0], (function (i, j) {
           return i === j;
         }), a);

test/ArrayTests.res

@@ -100,16 +100,16 @@ Test.run(
 )
 
 let singletonTest = (a, title) => {
-  Test.run(__POS_OF__(`fromOneItem : ${title}`), Array.fromOneItem(a), (i, j) => i == j, [a])
-  Test.run(__POS_OF__(`fromOneItem : ${title}`), Array.fromOneItem(a)->Array.length, eq, 1)
+  Test.run(__POS_OF__(`fromSingleton : ${title}`), Array.fromSingleton(a), (i, j) => i == j, [a])
+  Test.run(__POS_OF__(`fromSingleton : ${title}`), Array.fromSingleton(a)->Array.length, eq, 1)
   Test.run(
-    __POS_OF__(`fromOneItem : ${title}`),
-    Array.fromOneItem(a)->Array.getUnsafe(0),
+    __POS_OF__(`fromSingleton : ${title}`),
+    Array.fromSingleton(a)->Array.getUnsafe(0),
     (i, j) => i === j,
     a,
   )
 }
-let m = {"x": 3, "y": 5}->Array.fromOneItem
+let m = {"x": 3, "y": 5}->Array.fromSingleton
 3->singletonTest("Single integer")
 "abc"->singletonTest("Single string")
 undefined->singletonTest("undefined")