rubico 2.7.3 → 2.7.5

package/dist/x/unionWith.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -97,8 +97,8 @@ const identity = value => value
 
 const asyncIteratorForEach = async function (asyncIterator, callback) {
   const promises = []
-  for await (const item of asyncIterator) {
-    const operation = callback(item)
+  for await (const element of asyncIterator) {
+    const operation = callback(element)
     if (isPromise(operation)) {
       promises.push(operation)
     }
@@ -118,44 +118,44 @@ const arrayFlatten = function (array) {
   let index = -1
 
   while (++index < length) {
-    const item = array[index]
-    if (isArray(item)) {
-      const itemLength = item.length
-      let itemIndex = -1
-      while (++itemIndex < itemLength) {
-        result.push(item[itemIndex])
+    const element = array[index]
+    if (isArray(element)) {
+      const elementLength = element.length
+      let elementIndex = -1
+      while (++elementIndex < elementLength) {
+        result.push(element[elementIndex])
       }
-    } else if (item == null) {
-      result.push(item)
-    } else if (typeof item.then == 'function') {
-      promises.push(item.then(curry2(arrayPush, result, __)))
-    } else if (typeof item[symbolIterator] == 'function') {
-      for (const subItem of item) {
-        result.push(subItem)
+    } else if (element == null) {
+      result.push(element)
+    } else if (typeof element.then == 'function') {
+      promises.push(element.then(curry2(arrayPush, result, __)))
+    } else if (typeof element[symbolIterator] == 'function') {
+      for (const subElement of element) {
+        result.push(subElement)
       }
-    } else if (typeof item[symbolAsyncIterator] == 'function') {
+    } else if (typeof element[symbolAsyncIterator] == 'function') {
       promises.push(asyncIteratorForEach(
-        item[symbolAsyncIterator](), curry2(arrayPush, result, __)))
-    } else if (typeof item.chain == 'function') {
-      const monadValue = item.chain(identity)
+        element[symbolAsyncIterator](), curry2(arrayPush, result, __)))
+    } else if (typeof element.chain == 'function') {
+      const monadValue = element.chain(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.flatMap == 'function') {
-      const monadValue = item.flatMap(identity)
+    } else if (typeof element.flatMap == 'function') {
+      const monadValue = element.flatMap(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.reduce == 'function') {
-      const folded = item.reduce(funcConcatSync(
+    } else if (typeof element.reduce == 'function') {
+      const folded = element.reduce(funcConcatSync(
         getArg1, curry2(arrayPush, result, __)), null)
       isPromise(folded) && promises.push(folded)
-    } else if (item.constructor == Object) {
-      for (const key in item) {
-        result.push(item[key])
+    } else if (element.constructor == Object) {
+      for (const key in element) {
+        result.push(element[key])
       }
     } else {
-      result.push(item)
+      result.push(element)
     }
   }
   return promises.length == 0
@@ -184,12 +184,12 @@ const arrayIncludesWith = function (array, value, comparator) {
 const arrayUniqWithAsync = async function (array, comparator, result, index) {
   const length = array.length
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
     if (!(
-      isPromise(itemAlreadyExists) ? await itemAlreadyExists : itemAlreadyExists
+      isPromise(elementAlreadyExists) ? await elementAlreadyExists : elementAlreadyExists
     )) {
-      result.push(item)
+      result.push(element)
     }
   }
   return result
@@ -200,14 +200,14 @@ const arrayUniqWith = function (array, comparator) {
     result = []
   let index = -1
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
-    if (isPromise(itemAlreadyExists)) {
-      return itemAlreadyExists.then(funcConcatSync(
-        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, item)),
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
+    if (isPromise(elementAlreadyExists)) {
+      return elementAlreadyExists.then(funcConcatSync(
+        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, element)),
         thunkify4(arrayUniqWithAsync, array, comparator, result, index)))
-    } else if (!itemAlreadyExists) {
-      result.push(item)
+    } else if (!elementAlreadyExists) {
+      result.push(element)
     }
   }
   return result

package/dist/x/unionWith.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unionWith.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -103,8 +103,8 @@ const identity = value => value
 
 const asyncIteratorForEach = async function (asyncIterator, callback) {
   const promises = []
-  for await (const item of asyncIterator) {
-    const operation = callback(item)
+  for await (const element of asyncIterator) {
+    const operation = callback(element)
     if (isPromise(operation)) {
       promises.push(operation)
     }
@@ -124,44 +124,44 @@ const arrayFlatten = function (array) {
   let index = -1
 
   while (++index < length) {
-    const item = array[index]
-    if (isArray(item)) {
-      const itemLength = item.length
-      let itemIndex = -1
-      while (++itemIndex < itemLength) {
-        result.push(item[itemIndex])
+    const element = array[index]
+    if (isArray(element)) {
+      const elementLength = element.length
+      let elementIndex = -1
+      while (++elementIndex < elementLength) {
+        result.push(element[elementIndex])
       }
-    } else if (item == null) {
-      result.push(item)
-    } else if (typeof item.then == 'function') {
-      promises.push(item.then(curry2(arrayPush, result, __)))
-    } else if (typeof item[symbolIterator] == 'function') {
-      for (const subItem of item) {
-        result.push(subItem)
+    } else if (element == null) {
+      result.push(element)
+    } else if (typeof element.then == 'function') {
+      promises.push(element.then(curry2(arrayPush, result, __)))
+    } else if (typeof element[symbolIterator] == 'function') {
+      for (const subElement of element) {
+        result.push(subElement)
       }
-    } else if (typeof item[symbolAsyncIterator] == 'function') {
+    } else if (typeof element[symbolAsyncIterator] == 'function') {
       promises.push(asyncIteratorForEach(
-        item[symbolAsyncIterator](), curry2(arrayPush, result, __)))
-    } else if (typeof item.chain == 'function') {
-      const monadValue = item.chain(identity)
+        element[symbolAsyncIterator](), curry2(arrayPush, result, __)))
+    } else if (typeof element.chain == 'function') {
+      const monadValue = element.chain(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.flatMap == 'function') {
-      const monadValue = item.flatMap(identity)
+    } else if (typeof element.flatMap == 'function') {
+      const monadValue = element.flatMap(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.reduce == 'function') {
-      const folded = item.reduce(funcConcatSync(
+    } else if (typeof element.reduce == 'function') {
+      const folded = element.reduce(funcConcatSync(
         getArg1, curry2(arrayPush, result, __)), null)
       isPromise(folded) && promises.push(folded)
-    } else if (item.constructor == Object) {
-      for (const key in item) {
-        result.push(item[key])
+    } else if (element.constructor == Object) {
+      for (const key in element) {
+        result.push(element[key])
       }
     } else {
-      result.push(item)
+      result.push(element)
     }
   }
   return promises.length == 0
@@ -190,12 +190,12 @@ const arrayIncludesWith = function (array, value, comparator) {
 const arrayUniqWithAsync = async function (array, comparator, result, index) {
   const length = array.length
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
     if (!(
-      isPromise(itemAlreadyExists) ? await itemAlreadyExists : itemAlreadyExists
+      isPromise(elementAlreadyExists) ? await elementAlreadyExists : elementAlreadyExists
     )) {
-      result.push(item)
+      result.push(element)
     }
   }
   return result
@@ -206,14 +206,14 @@ const arrayUniqWith = function (array, comparator) {
     result = []
   let index = -1
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
-    if (isPromise(itemAlreadyExists)) {
-      return itemAlreadyExists.then(funcConcatSync(
-        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, item)),
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
+    if (isPromise(elementAlreadyExists)) {
+      return elementAlreadyExists.then(funcConcatSync(
+        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, element)),
         thunkify4(arrayUniqWithAsync, array, comparator, result, index)))
-    } else if (!itemAlreadyExists) {
-      result.push(item)
+    } else if (!elementAlreadyExists) {
+      result.push(element)
     }
   }
   return result

package/dist/x/unionWith.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unionWith.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -97,8 +97,8 @@ const identity = value => value
 
 const asyncIteratorForEach = async function (asyncIterator, callback) {
   const promises = []
-  for await (const item of asyncIterator) {
-    const operation = callback(item)
+  for await (const element of asyncIterator) {
+    const operation = callback(element)
     if (isPromise(operation)) {
       promises.push(operation)
     }
@@ -118,44 +118,44 @@ const arrayFlatten = function (array) {
   let index = -1
 
   while (++index < length) {
-    const item = array[index]
-    if (isArray(item)) {
-      const itemLength = item.length
-      let itemIndex = -1
-      while (++itemIndex < itemLength) {
-        result.push(item[itemIndex])
+    const element = array[index]
+    if (isArray(element)) {
+      const elementLength = element.length
+      let elementIndex = -1
+      while (++elementIndex < elementLength) {
+        result.push(element[elementIndex])
       }
-    } else if (item == null) {
-      result.push(item)
-    } else if (typeof item.then == 'function') {
-      promises.push(item.then(curry2(arrayPush, result, __)))
-    } else if (typeof item[symbolIterator] == 'function') {
-      for (const subItem of item) {
-        result.push(subItem)
+    } else if (element == null) {
+      result.push(element)
+    } else if (typeof element.then == 'function') {
+      promises.push(element.then(curry2(arrayPush, result, __)))
+    } else if (typeof element[symbolIterator] == 'function') {
+      for (const subElement of element) {
+        result.push(subElement)
       }
-    } else if (typeof item[symbolAsyncIterator] == 'function') {
+    } else if (typeof element[symbolAsyncIterator] == 'function') {
       promises.push(asyncIteratorForEach(
-        item[symbolAsyncIterator](), curry2(arrayPush, result, __)))
-    } else if (typeof item.chain == 'function') {
-      const monadValue = item.chain(identity)
+        element[symbolAsyncIterator](), curry2(arrayPush, result, __)))
+    } else if (typeof element.chain == 'function') {
+      const monadValue = element.chain(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.flatMap == 'function') {
-      const monadValue = item.flatMap(identity)
+    } else if (typeof element.flatMap == 'function') {
+      const monadValue = element.flatMap(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(curry2(arrayPush, result, __)))
         : result.push(monadValue)
-    } else if (typeof item.reduce == 'function') {
-      const folded = item.reduce(funcConcatSync(
+    } else if (typeof element.reduce == 'function') {
+      const folded = element.reduce(funcConcatSync(
         getArg1, curry2(arrayPush, result, __)), null)
       isPromise(folded) && promises.push(folded)
-    } else if (item.constructor == Object) {
-      for (const key in item) {
-        result.push(item[key])
+    } else if (element.constructor == Object) {
+      for (const key in element) {
+        result.push(element[key])
       }
     } else {
-      result.push(item)
+      result.push(element)
     }
   }
   return promises.length == 0
@@ -184,12 +184,12 @@ const arrayIncludesWith = function (array, value, comparator) {
 const arrayUniqWithAsync = async function (array, comparator, result, index) {
   const length = array.length
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
     if (!(
-      isPromise(itemAlreadyExists) ? await itemAlreadyExists : itemAlreadyExists
+      isPromise(elementAlreadyExists) ? await elementAlreadyExists : elementAlreadyExists
     )) {
-      result.push(item)
+      result.push(element)
     }
   }
   return result
@@ -200,14 +200,14 @@ const arrayUniqWith = function (array, comparator) {
     result = []
   let index = -1
   while (++index < length) {
-    const item = array[index],
-      itemAlreadyExists = arrayIncludesWith(result, item, comparator)
-    if (isPromise(itemAlreadyExists)) {
-      return itemAlreadyExists.then(funcConcatSync(
-        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, item)),
+    const element = array[index],
+      elementAlreadyExists = arrayIncludesWith(result, element, comparator)
+    if (isPromise(elementAlreadyExists)) {
+      return elementAlreadyExists.then(funcConcatSync(
+        curry3(thunkConditional, __, noop, thunkify2(arrayPush, result, element)),
         thunkify4(arrayUniqWithAsync, array, comparator, result, index)))
-    } else if (!itemAlreadyExists) {
-      result.push(item)
+    } else if (!elementAlreadyExists) {
+      result.push(element)
     }
   }
   return result

package/dist/x/uniq.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.es.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.3
+ * rubico v2.7.5
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/eq.js

@@ -6,20 +6,28 @@ const equals = require('./_internal/equals')
  *
  * @synopsis
  * ```coffeescript [specscript]
- * eq(leftValue Promise|any, rightValue Promise|any) -> boolean
+ * args Array<any>
+ * argsOrPromises Array<Promise|any>
  *
- * eq(leftValue Promise|any, right function)(...args) -> Promise|boolean
- * eq(...args, leftValue Promise|any, right function) -> Promise|boolean
+ * type SyncOrAsyncResolver = (...args)=>Promise|any
  *
- * eq(left function, rightValue Promise|any)(...args) -> Promise|boolean
- * eq(...args, left function, rightValue Promise|any) -> Promise|boolean
+ * leftValue Promise|any
+ * rightValue Promise|any
+ * leftResolver SyncOrAsyncResolver
+ * rightResolver SyncOrAsyncResolver
+ *
+ * eq(leftValue, rightValue) -> Promise|boolean
+ * eq(...argsOrPromises, leftResolver, rightValue) -> Promise|boolean
+ * eq(...argsOrPromises, leftValue, rightResolver) -> Promise|boolean
+ * eq(...argsOrPromises, leftResolver, rightResolver) -> Promise|boolean
+ * eq(leftResolver, rightValue)(...args) -> Promise|boolean
+ * eq(leftValue, rightResolver)(...args) -> Promise|boolean
+ * eq(leftResolver, rightResolver)(...args) -> Promise|boolean
  *
- * eq(left function, right function)(...args) -> Promise|boolean
- * eq(...args, left function, right function) -> Promise|boolean
  * ```
  *
  * @description
- * Test for [equality (`==`)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality) between two values.
+ * Function equivalent to the [Equality (==)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality) operator. Tests for equality (`==`) between two values.
  *
  * ```javascript [playground]
  * const areNamesEqual = eq('Ted', 'John')
@@ -27,7 +35,7 @@ const equals = require('./_internal/equals')
  * console.log(areNamesEqual) // false
  * ```
  *
- * If either of the two values are resolver functions, `eq` returns a function that resolves the values to compare from its arguments.
+ * If either of the two values are resolver functions, `eq` returns a function that resolves the value(s) to compare.
  *
  * ```javascript [playground]
  * const personIsJohn = eq(get('name'), 'John')
@@ -35,10 +43,24 @@ const equals = require('./_internal/equals')
  * const person = { name: 'John', likes: 'bananas' }
  *
  * if (personIsJohn(person)) {
- *   console.log('The person is george')
+ *   console.log('The person is John')
  * }
  * ```
  *
+ * If either of the two resolver functions is asynchronous, `eq` returns an asynchronous function.
+ *
+ * ```javascript [playground]
+ * const asyncPersonIsJohn = eq(async person => person.name, 'John')
+ *
+ * const person = { name: 'John', likes: 'bananas' }
+ *
+ * asyncPersonIsJohn(person).then(condition => {
+ *   if (condition) {
+ *     console.log('The person is John')
+ *   }
+ * })
+ * ```
+ *
  * `eq` supports a lazy API for composability.
  *
  * ```javascript [playground]