rubico 2.6.5 → 2.7.0

package/dist/x/values.es.js

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

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

@@ -1,7 +1,7 @@
 /**
- * rubico v2.6.2
+ * rubico v2.7.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2024 Richard Tong
+ * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const objectValues=Object.values,values=e=>null==e?[]:"function"==typeof e.values?[...e.values()]:objectValues(e);export default values;

package/dist/x/values.js

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

package/dist/x/values.min.js

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

package/dist/x/values.mjs

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

package/dist/x/when.es.js

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

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

@@ -1,7 +1,7 @@
 /**
- * rubico v2.6.2
+ * rubico v2.7.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2024 Richard Tong
+ * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const isPromise=r=>null!=r&&"function"==typeof r.then,always=r=>function(){return r},__=Symbol.for("placeholder"),thunkify1=(r,n)=>function(){return r(n)},curry3ResolveArg0=(r,n,e)=>function(u){return r(u,n,e)},curry3ResolveArg1=(r,n,e)=>function(u){return r(n,u,e)},curry3ResolveArg2=(r,n,e)=>function(u){return r(n,e,u)},curry3=function(r,n,e,u){return n==__?curry3ResolveArg0(r,e,u):e==__?curry3ResolveArg1(r,n,u):curry3ResolveArg2(r,n,e)},thunkConditional=(r,n,e)=>r?n():e(),when=(r,n)=>function(e){const u=r(e);return isPromise(u)?u.then(curry3(thunkConditional,__,thunkify1(n,e),always(e))):u?n(e):e};export default when;

package/dist/x/when.js

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

package/dist/x/when.min.js

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

package/dist/x/when.mjs

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

package/eq.d.ts

@@ -20,7 +20,7 @@ export = eq;
  * Test for [equality (`==`)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality) between two values.
  *
  * ```javascript [playground]
- * const areNamesEqual = eq('Ted', 'George')
+ * const areNamesEqual = eq('Ted', 'John')
  *
  * console.log(areNamesEqual) // false
  * ```
@@ -28,11 +28,11 @@ export = eq;
  * If either of the two values are resolver functions, `eq` returns a function that resolves the values to compare from its arguments.
  *
  * ```javascript [playground]
- * const personIsGeorge = eq(get('name'), 'George')
+ * const personIsJohn = eq(get('name'), 'John')
  *
- * const person = { name: 'George', likes: 'bananas' }
+ * const person = { name: 'John', likes: 'bananas' }
  *
- * if (personIsGeorge(person)) {
+ * if (personIsJohn(person)) {
  *   console.log('The person is george')
  * }
  * ```
@@ -40,8 +40,8 @@ export = eq;
  * `eq` supports a lazy API for composability.
  *
  * ```javascript [playground]
- * pipe({ name: 'George' }, [
- *   eq('George', get('name')),
+ * pipe({ name: 'John' }, [
+ *   eq('John', get('name')),
  *   console.log, // true
  * ])
  * ```

package/eq.js

@@ -22,7 +22,7 @@ const equals = require('./_internal/equals')
  * Test for [equality (`==`)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality) between two values.
  *
  * ```javascript [playground]
- * const areNamesEqual = eq('Ted', 'George')
+ * const areNamesEqual = eq('Ted', 'John')
  *
  * console.log(areNamesEqual) // false
  * ```
@@ -30,11 +30,11 @@ const equals = require('./_internal/equals')
  * If either of the two values are resolver functions, `eq` returns a function that resolves the values to compare from its arguments.
  *
  * ```javascript [playground]
- * const personIsGeorge = eq(get('name'), 'George')
+ * const personIsJohn = eq(get('name'), 'John')
  *
- * const person = { name: 'George', likes: 'bananas' }
+ * const person = { name: 'John', likes: 'bananas' }
  *
- * if (personIsGeorge(person)) {
+ * if (personIsJohn(person)) {
  *   console.log('The person is george')
  * }
  * ```
@@ -42,8 +42,8 @@ const equals = require('./_internal/equals')
  * `eq` supports a lazy API for composability.
  *
  * ```javascript [playground]
- * pipe({ name: 'George' }, [
- *   eq('George', get('name')),
+ * pipe({ name: 'John' }, [
+ *   eq('John', get('name')),
  *   console.log, // true
  * ])
  * ```
@@ -54,6 +54,14 @@ const equals = require('./_internal/equals')
  * eq(Promise.resolve({ a: 1, b: 1 }), get('a'), get('b')).then(console.log) // true
  * ```
  *
+ * See also:
+ *  * [and](/docs/and)
+ *  * [gt](/docs/gt)
+ *  * [lt](/docs/lt)
+ *  * [gte](/docs/gte)
+ *  * [lte](/docs/lte)
+ *  * [thunkify](/docs/thunkify)
+ *
  * @execution concurrent
  */
 

package/es.js

@@ -1,7 +1,7 @@
 /**
- * rubico v2.6.2
+ * rubico v2.7.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2024 Richard Tong
+ * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 
@@ -67,6 +67,10 @@ const curry2 = function (baseFunc, arg0, arg1) {
 }
 
 const pipe = function (...args) {
+  if (typeof args[0] == 'function') {
+    return args.reduce(funcConcat)
+  }
+
   const funcs = args.pop()
   const pipeline = funcs.reduce(funcConcat)
 
@@ -82,6 +86,10 @@ const pipe = function (...args) {
 }
 
 const compose = function (...args) {
+  if (typeof args[0] == 'function') {
+    return args.reduceRight(funcConcat)
+  }
+
   const funcs = args.pop()
   const composition = funcs.reduceRight(funcConcat)
 
@@ -423,26 +431,6 @@ const all = function (...args) {
   return isArray(resolversOrValues)
     ? functionArrayAll(resolversOrValues, argValues)
     : functionObjectAll(resolversOrValues, argValues)
-
-  /*
-  ////////////////////////////////////////////////////////////////
-  const funcs = args.pop()
-  if (args.length == 0) {
-    return isArray(funcs)
-      ? curryArgs2(functionArrayAll, funcs, __)
-      : curryArgs2(functionObjectAll, funcs, __)
-  }
-
-  if (areAnyValuesPromises(args)) {
-    return isArray(funcs)
-      ? promiseAll(args).then(curry2(functionArrayAll, funcs, __))
-      : promiseAll(args).then(curry2(functionObjectAll, funcs, __))
-  }
-
-  return isArray(funcs)
-    ? functionArrayAll(funcs, args)
-    : functionObjectAll(funcs, args)
-  */
 }
 
 all.series = function allSeries(...args) {
@@ -1173,39 +1161,39 @@ const mapMapEntries = function (source, mapper) {
     : promiseAll(promises).then(always(result))
 }
 
-const _map = function (value, mapper) {
+const _map = function (value, f) {
   if (isArray(value)) {
-    return arrayMap(value, mapper)
+    return arrayMap(value, f)
   }
   if (value == null) {
     return value
   }
 
   if (typeof value.then == 'function') {
-    return value.then(mapper)
+    return value.then(f)
   }
   if (typeof value.map == 'function') {
-    return value.map(mapper)
+    return value.map(f)
   }
   if (typeof value == 'string' || value.constructor == String) {
-    return stringMap(value, mapper)
+    return stringMap(value, f)
   }
   if (value.constructor == Set) {
-    return setMap(value, mapper)
+    return setMap(value, f)
   }
   if (value.constructor == Map) {
-    return mapMap(value, mapper)
+    return mapMap(value, f)
   }
   if (typeof value[symbolIterator] == 'function') {
-    return MappingIterator(value[symbolIterator](), mapper)
+    return MappingIterator(value[symbolIterator](), f)
   }
   if (typeof value[symbolAsyncIterator] == 'function') {
-    return MappingAsyncIterator(value[symbolAsyncIterator](), mapper)
+    return MappingAsyncIterator(value[symbolAsyncIterator](), f)
   }
   if (value.constructor == Object) {
-    return objectMap(value, mapper)
+    return objectMap(value, f)
   }
-  return mapper(value)
+  return f(value)
 }
 
 const map = function (arg0, arg1) {
@@ -1217,16 +1205,16 @@ const map = function (arg0, arg1) {
     : _map(arg0, arg1)
 }
 
-// _mapEntries(value Object|Map, mapper function) -> Object|Map
-const _mapEntries = (value, mapper) => {
+// _mapEntries(value Object|Map, f function) -> Object|Map
+const _mapEntries = (value, f) => {
   if (value == null) {
     throw new TypeError('value is not an Object or Map')
   }
   if (value.constructor == Object) {
-    return objectMapEntries(value, mapper)
+    return objectMapEntries(value, f)
   }
   if (value.constructor == Map) {
-    return mapMapEntries(value, mapper)
+    return mapMapEntries(value, f)
   }
   throw new TypeError('value is not an Object or Map')
 }
@@ -1272,26 +1260,26 @@ map.series = function mapSeries(arg0, arg1) {
     : _mapSeries(arg0, arg1)
 }
 
-const _mapPool = function (collection, concurrency, f) {
-  if (isArray(collection)) {
-    return arrayMapPool(collection, concurrency, f)
+const _mapPool = function (f, concurrency, mapper) {
+  if (isArray(f)) {
+    return arrayMapPool(f, concurrency, mapper)
   }
-  if (collection == null) {
-    throw new TypeError(`invalid collection ${collection}`)
+  if (f == null) {
+    throw new TypeError(`invalid functor ${f}`)
   }
-  if (typeof collection == 'string' || collection.constructor == String) {
-    return stringMapPool(collection, concurrency, f)
+  if (typeof f == 'string' || f.constructor == String) {
+    return stringMapPool(f, concurrency, mapper)
   }
-  if (collection.constructor == Set) {
-    return setMapPool(collection, concurrency, f)
+  if (f.constructor == Set) {
+    return setMapPool(f, concurrency, mapper)
   }
-  if (collection.constructor == Map) {
-    return mapMapPool(collection, concurrency, f)
+  if (f.constructor == Map) {
+    return mapMapPool(f, concurrency, mapper)
   }
-  if (collection.constructor == Object) {
-    return objectMapPool(collection, concurrency, f)
+  if (f.constructor == Object) {
+    return objectMapPool(f, concurrency, mapper)
   }
-  throw new TypeError(`invalid collection ${collection}`)
+  throw new TypeError(`invalid functor ${f}`)
 }
 
 map.pool = function mapPool(arg0, arg1, arg2) {
@@ -1496,7 +1484,9 @@ const filter = function (arg0, arg1) {
   if (typeof arg0 == 'function') {
     return curry2(_filter, __, arg0)
   }
-  return _filter(arg0, arg1)
+  return isPromise(arg0)
+    ? arg0.then(curry2(_filter, __, arg1))
+    : _filter(arg0, arg1)
 }
 
 const objectValues = Object.values
@@ -1757,17 +1747,17 @@ const genericReduce = function (collection, reducer, result) {
     : reducer(result, collection)
 }
 
-// _reduce(collection any, reducer function, initialValue function|any) -> Promise
-const _reduce = function (collection, reducer, initialValue) {
-  if (typeof initialValue == 'function') {
-    const actualInitialValue = initialValue(collection)
+// _reduce(collection any, reducer function, initial function|any) -> Promise
+const _reduce = function (collection, reducer, initial) {
+  if (typeof initial == 'function') {
+    const actualInitialValue = initial(collection)
     return isPromise(actualInitialValue)
       ? actualInitialValue.then(curry3(genericReduce, collection, reducer, __))
       : genericReduce(collection, reducer, actualInitialValue)
   }
-  return isPromise(initialValue)
-    ? initialValue.then(curry3(genericReduce, collection, reducer, __))
-    : genericReduce(collection, reducer, initialValue)
+  return isPromise(initial)
+    ? initial.then(curry3(genericReduce, collection, reducer, __))
+    : genericReduce(collection, reducer, initial)
 }
 
 const reduce = function (...args) {

package/every.js

@@ -41,15 +41,15 @@ const _every = function (collection, predicate) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Foldable = Array|Iterable|AsyncIterable|{ reduce: function }|Object
+ * type Foldable = Array|Set|Map|Generator|AsyncGenerator|{ reduce: function }|Object
  *
- * every(collection Foldable, predicate function) -> result Promise|boolean
+ * every(fold Foldable, predicate function) -> result Promise|boolean
  *
- * every(predicate function)(collection Foldable) -> result Promise|boolean
+ * every(predicate function)(fold Foldable) -> result Promise|boolean
  * ```
  *
  * @description
- * Test a predicate concurrently across all items of a collection, returning true if all predications are truthy.
+ * Test a predicate concurrently across all items of a foldable, returning true if all executions return true.
  *
  * ```javascript [playground]
  * const isOdd = number => number % 2 == 1
@@ -63,7 +63,16 @@ const _every = function (collection, predicate) {
  * ) // true
  * ```
  *
- * The collection can be any iterable, async iterable, or object values iterable collection. Below is an example of `every` accepting an async generator as the collection.
+ * The following data types are considered to be foldables:
+ *  * `array`
+ *  * `set`
+ *  * `map`
+ *  * `generator`
+ *  * `async generator`
+ *  * `object with .reduce method`
+ *  * `object`
+ *
+ * `every` works for async generators.
  *
  * ```javascript [playground]
  * const asyncNumbers = async function* () {
@@ -88,6 +97,11 @@ const _every = function (collection, predicate) {
  * every(Promise.resolve([1, 2, 3, 4, 5]), n => n < 6).then(console.log) // true
  * ```
  *
+ * See also:
+ *  * [map](/docs/map)
+ *  * [some](/docs/some)
+ *  * [and](/docs/and)
+ *
  * @execution concurrent
  *
  * @muxing