rubico 2.7.1 → 2.7.3

package/dist/x/values.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * 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.1
+ * rubico v2.7.3
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.1
+ * rubico v2.7.3
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -2873,7 +2873,9 @@ const not = function (...args) {
     }
     return _not(args, predicateOrValue)
   }
-  return !predicateOrValue
+  return isPromise(predicateOrValue)
+    ? predicateOrValue.then(negate)
+    : !predicateOrValue
 }
 
 // argument resolver for curryArgs4
@@ -3276,15 +3278,11 @@ const omit = function (arg0, arg1) {
   return _omit(arg0, arg1)
 }
 
-const thunkify = function (func, ...args) {
+const thunkify = (func, ...args) => function thunk() {
   if (areAnyValuesPromises(args)) {
-    return promiseAll(args).then(resolvedArgs => function thunk() {
-      return func(...resolvedArgs)
-    })
-  }
-  return function thunk() {
-    return func(...args)
+    return promiseAll(args).then(curry2(funcApply, func, __))
   }
+  return func(...args)
 }
 
 const curry = (func, ...args) => curryArity(func.length, func, args)

package/every.js

@@ -43,9 +43,8 @@ const _every = function (collection, predicate) {
  * ```coffeescript [specscript]
  * type Foldable = Array|Set|Map|Generator|AsyncGenerator|{ reduce: function }|Object
  *
- * every(fold Foldable, predicate function) -> result Promise|boolean
- *
- * every(predicate function)(fold Foldable) -> result Promise|boolean
+ * every(foldable Foldable, predicate function) -> result Promise|boolean
+ * every(predicate function)(foldable Foldable) -> result Promise|boolean
  * ```
  *
  * @description

package/filter.js

@@ -95,11 +95,11 @@ const _filter = function (value, predicate) {
  * type Predicate = (
  *   value any,
  *   indexOrKey number|string|any,
- *   filt Filterable,
+ *   filterable Filterable,
  * )=>boolean
  *
- * filter(filt Filterable, predicate Predicate) -> result Promise|Filterable
- * filter(predicate Predicate)(filt Filterable) -> result Promise|Filterable
+ * filter(filterable Promise|Filterable, predicate Predicate) -> result Promise|Filterable
+ * filter(predicate Predicate)(filterable Filterable) -> result Promise|Filterable
  * ```
  *
  * @description

package/flatMap.js

@@ -69,11 +69,13 @@ const _flatMap = function (value, flatMapper) {
  * type FlatMapper = (
  *   item any,
  *   indexOrKey number|string|any,
- *   mon Monad
+ *   monad Monad
  * )=>Promise|Monad|any
  *
- * flatMap(mon Monad, flatMapper FlatMapper) -> result Promise|Monad
- * flatMap(flatMapper FlatMapper)(mon Monad) -> result Promise|Monad
+ * flatMapper FlatMapper
+ *
+ * flatMap(monad Promise|Monad, flatMapper) -> result Promise|Monad
+ * flatMap(flatMapper)(monad Monad) -> result Promise|Monad
  * ```
  *
  * @description

package/index.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.1
+ * rubico v2.7.3
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -2879,7 +2879,9 @@ const not = function (...args) {
     }
     return _not(args, predicateOrValue)
   }
-  return !predicateOrValue
+  return isPromise(predicateOrValue)
+    ? predicateOrValue.then(negate)
+    : !predicateOrValue
 }
 
 // argument resolver for curryArgs4
@@ -3282,15 +3284,11 @@ const omit = function (arg0, arg1) {
   return _omit(arg0, arg1)
 }
 
-const thunkify = function (func, ...args) {
+const thunkify = (func, ...args) => function thunk() {
   if (areAnyValuesPromises(args)) {
-    return promiseAll(args).then(resolvedArgs => function thunk() {
-      return func(...resolvedArgs)
-    })
-  }
-  return function thunk() {
-    return func(...args)
+    return promiseAll(args).then(curry2(funcApply, func, __))
   }
+  return func(...args)
 }
 
 const curry = (func, ...args) => curryArity(func.length, func, args)

package/map.js

@@ -98,11 +98,11 @@ const _map = function (value, f) {
  * type Mapper = (
  *   item any,
  *   indexOrKey number|string|any,
- *   ftor Functor
+ *   functor Functor
  * )=>(resultItem Promise|any)
  *
- * map(ftor Promise|Functor, mapper Mapper) -> result Promise|Functor
- * map(mapper Mapper)(ftor Functor) -> result Promise|Functor
+ * map(functor Promise|Functor, mapper Mapper) -> result Promise|Functor
+ * map(mapper Mapper)(functor Functor) -> result Promise|Functor
  * ```
  *
  * @description

package/not.js

@@ -19,11 +19,16 @@ const _not = function (args, predicate) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * not(value boolean) -> negated boolean
+ * args Array<any>
+ * argsOrPromises Array<Promise|any>
+ *
+ * type Predicate = (...args)=>Promise|boolean
  *
- * not(...args, predicate function) -> negated boolean
+ * predicate Predicate
  *
- * not(predicate function)(...args) -> negated boolean
+ * not(value boolean) -> negated boolean
+ * not(...argsOrPromises, predicate) -> negated Promise|boolean
+ * not(predicate)(...args) -> negated Promise|boolean
  * ```
  *
  * @description
@@ -73,7 +78,9 @@ const not = function (...args) {
     }
     return _not(args, predicateOrValue)
   }
-  return !predicateOrValue
+  return isPromise(predicateOrValue)
+    ? predicateOrValue.then(negate)
+    : !predicateOrValue
 }
 
 module.exports = not

package/omit.js

@@ -20,9 +20,8 @@ const _omit = function (source, paths) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * omit(paths Array<string>)(source Object) -> omitted Object
- *
- * omit(source Object, paths Array<string>) -> omitted Object
+ * omit(source Promise|Object, paths Array<string>) -> result Object
+ * omit(paths Array<string>)(source Object) -> result Object
  * ```
  *
  * @description

package/or.js

@@ -97,36 +97,49 @@ const areAnyPredicatesTruthy = function (args, predicates) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * or(values Array<boolean>) -> result boolean
+ * args Array<any>
+ * argsOrPromises Array<Promise|any>
+ * predicatesOrValues Array<function|boolean|any>
  *
- * or(...args, predicatesOrValues Array<function|boolean>) -> Promise|boolean
- *
- * or(predicatesOrValues Array<function|boolean>)(...args) -> Promise|boolean
+ * or(values Array<boolean|any>) -> result boolean
+ * or(...argsOrPromises, predicatesOrValues) -> Promise|boolean
+ * or(predicatesOrValues)(...args) -> Promise|boolean
  * ```
  *
  * @description
- * Tests an array of boolean values, returning true if any boolean values are truthy.
+ * Function equivalent to the [logical OR](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_OR) operator. Tests arrays of predicate functions, promises, values, or a mix thereof.
+ *
+ * If provided an array of boolean values, `or` returns true if any boolean values are truthy.
  *
  * ```javascript [playground]
  * const oneIsLessThanZero = 1 < 0
  * const oneIsGreaterThanTwo = 1 > 2
  * const threeIsNotEqualToThree = 3 !== 3
  *
- * console.log(
- *   or([oneIsLessThanZero, oneIsGreaterThanTwo, threeIsNotEqualToThree]),
- * ) // false
+ * const condition = or([
+ *   oneIsLessThanZero,
+ *   oneIsGreaterThanTwo,
+ *   threeIsNotEqualToThree
+ * ])
+ * console.log(condition) // false
  * ```
  *
- * If any values in the array are synchronous or asynchronous predicate functions, `or` takes another argument to test concurrently against the predicate functions, returning true if any array values or resolved values from the predicates are truthy.
+ * If any predicate functions are provided in the array, `or` returns an aggregate predicate function that returns true for a given set of arguments if any provided predicate functions test true. If any provided predicate functions are asynchronous, the aggregate predicate function becomes asynchronous.
  *
  * ```javascript [playground]
  * const isOdd = number => number % 2 == 1
- *
- * const isEven = number => number % 2 == 0
- *
- * console.log(
- *   or([isOdd, isEven])(0),
- * ) // true
+ * const isNegative = number => number < 0
+ * const asyncIsGreaterThan3 = async number => number > 3
+ *
+ * const aggregatePredicate = or([
+ *   false,
+ *   isOdd,
+ *   isNegative,
+ *   asyncIsGreaterThan3,
+ * ])
+ *
+ * const condition = await aggregatePredicate(2)
+ * console.log(condition) // false
  * ```
  *
  * Any promises passed in argument position are resolved for their values before further execution. This only applies to the eager version of the API.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rubico",
-  "version": "2.7.1",
+  "version": "2.7.3",
   "description": "[a]synchronous functional programming",
   "author": "Richard Tong",
   "license": "MIT",

package/pick.js

@@ -27,9 +27,8 @@ const _pick = function (source, keys) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * pick(object Object, keys Array<string>) -> result Object
- *
- * pick(keys Array<string>)(object Object) -> result Object
+ * pick(source Promise|Object, keys Array<string>) -> result Object
+ * pick(keys Array<string>)(source Object) -> result Object
  * ```
  *
  * @description

package/pipe.js

@@ -12,12 +12,10 @@ const __ = require('./_internal/placeholder')
  * ```coffeescript [specscript]
  * funcs Array<function>
  * args Array<any>
- * argsWithPromises Array<Promise|any>
+ * argsOrPromises Array<Promise|any>
  *
  * pipe(funcs)(...args) -> result Promise|any
- *
- * pipe(...argsWithPromises, funcs Array<function>) -> result Promise|any
- *
+ * pipe(...argsOrPromises, funcs Array<function>) -> result Promise|any
  * pipe(...funcs)(...args) -> result Promise|any
  * ```
  *

package/reduce.js

@@ -27,21 +27,16 @@ const _reduce = function (collection, reducer, initial) {
  *   accumulator any,
  *   item any,
  *   indexOrKey number|string|any,
- *   fold Foldable
+ *   foldable Foldable
  * )=>(nextAccumulator Promise|any)
  *
- * type Resolver = (fold Foldable)=>Promise|any
+ * type Resolver = (foldable Foldable)=>Promise|any
  *
- * reduce(
- *   fold Foldable,
- *   reducer Reducer,
- *   initial? Resolver|any
- * ) -> result Promise|any
+ * reducer Reducer
+ * initial Resolver|any
  *
- * reduce(
- *   reducer Reducer,
- *   initial? Resolver|any
- * )(fold Foldable) -> result Promise|any
+ * reduce(foldable Promise|Foldable, reducer, initial?) -> result Promise|any
+ * reduce(reducer, initial?)(foldable Foldable) -> result Promise|any
  * ```
  *
  * @description

package/some.js

@@ -42,9 +42,8 @@ const _some = function (collection, predicate) {
  * ```coffeescript [specscript]
  * type Foldable = Array|Set|Map|Generator|AsyncGenerator|{ reduce: function }|Object
  *
- * some(collection Foldable, predicate function) -> Promise|boolean
- *
- * some(predicate function)(collection Foldable) -> Promise|boolean
+ * some(foldable Foldable, predicate function) -> Promise|boolean
+ * some(predicate function)(foldable Foldable) -> Promise|boolean
  * ```
  *
  * @description

package/switchCase.js

@@ -12,20 +12,18 @@ const curryArgs3 = require('./_internal/curryArgs3')
  *
  * @synopsis
  * ```coffeescript [specscript]
- * switchCase(conditionalValues Array<boolean|any>) -> Promise|any
- *
- * switchCase(
- *   ...args,
- *   conditionalFuncsOrValues Array<function|boolean|any>
- * ) -> Promise|any
- *
- * switchCase(
- *   conditionalFuncsOrValues Array<function|boolean|any>
- * )(...args) -> Promise|any
+ * args Array<any>
+ * argsOrPromises Array<Promise|any>
+ * conditionalPromisesOrValues Array<Promise|boolean|any>
+ * conditionalFuncsOrPromisesOrValues Array<function|Promise|boolean|any>
+ *
+ * switchCase(conditionalPromisesOrValues) -> Promise|any
+ * switchCase(...argsOrPromises, conditionalFuncsOrPromisesOrValues) -> Promise|any
+ * switchCase(conditionalFuncsOrPromisesOrValues)(...args) -> Promise|any
  * ```
  *
  * @description
- * Functional equivalent to the [Conditional (ternary) operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_Operator). Accepts an array of conditional functions that specifies cases as pairings of `predicate` and `resolver` functions with the exception of the last, default resolver. All functions are provided with the same arguments and executed in series. The result of a `switchCase` operation is either the result of the execution the last default resolver, or the result of the execution of the first resolver where the associated predicate tested true.
+ * Function equivalent to the [Conditional (ternary) operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_Operator). Accepts an array of conditional functions that specifies cases as pairings of `predicate` and `resolver` functions with the exception of the last, default resolver. All functions are provided with the same arguments and executed in series. The result of a `switchCase` operation is either the result of the execution the last default resolver, or the result of the execution of the first resolver where the associated predicate tested true.
  *
  * ```javascript [playground]
  * const fruitIsYellow = fruit => fruit.color == 'yellow'

package/tap.js

@@ -23,8 +23,9 @@ const _tap = function (args, f) {
  * @synopsis
  * ```coffeescript [specscript]
  * args Array<any>
+ * argsOrPromises Array<Promise|any>
  *
- * tap(...args, f function) -> Promise|args[0]
+ * tap(...argsOrPromises, f function) -> Promise|args[0]
  * tap(f function)(...args) -> Promise|args[0]
  * ```
  *
@@ -104,8 +105,9 @@ const _tapIf = function (predicate, f, args) {
  * @synopsis
  * ```coffeescript [specscript]
  * args Array<any>
+ * argsOrPromises Array<Promise|any>
  *
- * tap.if(...args, predicate function, f function) -> Promise|args[0]
+ * tap.if(...argsOrPromises, predicate function, f function) -> Promise|args[0]
  * tap.if(predicate function, f function)(...args) -> Promise|args[0]
  * ```
  *

package/thunkify.js

@@ -9,13 +9,11 @@ const funcApply = require('./_internal/funcApply')
  *
  * @synopsis
  * ```coffeescript [specscript]
- * argsWithPromises Array<Promise|any>
- *
- * thunkify(func function, ...argsWithPromises) -> thunk function
+ * thunkify(func function, ...args) -> thunk ()=>func(...args)
  * ```
  *
  * @description
- * Create a thunk function from an original function and any number of arguments. A thunk function takes no arguments, and when called, executes the original function with the previously provided arguments. The original function is said to be "thunkified".
+ * Create a thunk function from another function and any number of arguments. The thunk function takes no arguments, and when called, executes the other function with the provided arguments. The other function is said to be "thunkified".
  *
  * ```javascript [playground]
  * const add = (a, b) => a + b
@@ -25,17 +23,6 @@ const funcApply = require('./_internal/funcApply')
  * console.log(thunkAdd12()) // 3
  * ```
  *
- * If any promises are passed as arguments, they are resolved before being applied to the original function, and `thunkify` returns a promise of the thunk function.
- *
- * ```javascript [playground]
- * const add = (a, b) => a + b
- *
- * const promise = thunkify(add, Promise.resolve(1), 2)
- * const thunkAdd12 = await promise
- *
- * console.log(thunkAdd12()) // 3
- * ```
- *
  * See also:
  *  * [eq](/docs/eq)
  *  * [always](/docs/always)
@@ -44,15 +31,11 @@ const funcApply = require('./_internal/funcApply')
  *  * [Transducer.map](/docs/Transducer.map)
  *
  */
-const thunkify = function (func, ...args) {
+const thunkify = (func, ...args) => function thunk() {
   if (areAnyValuesPromises(args)) {
-    return promiseAll(args).then(resolvedArgs => function thunk() {
-      return func(...resolvedArgs)
-    })
-  }
-  return function thunk() {
-    return func(...args)
+    return promiseAll(args).then(curry2(funcApply, func, __))
   }
+  return func(...args)
 }
 
 module.exports = thunkify

package/transform.js

@@ -33,18 +33,13 @@ const _transform = function (collection, transducer, initialValue) {
  * type Semigroup =
  *   Array|String|Set|TypedArray|{ concat: function }|{ write: function }|Object
  *
- * type SemigroupResolver = (fold Foldable)=>Promise|Semigroup
+ * type SemigroupResolver = (foldable Foldable)=>Promise|Semigroup
  *
- * transform(
- *   fold Foldable,
- *   transducer Transducer,
- *   initial? Semigroup|SemigroupResolver,
- * ) -> result Promise|Semigroup
+ * transducer Transducer
+ * initial Semigroup|SemigroupResolver
  *
- * transform(
- *   transducer Transducer,
- *   initial? Semigroup|SemigroupResolver,
- * )(fold Foldable) -> result Promise|Semigroup
+ * transform(foldable Promise|Foldable, transducer, initial?) -> result Promise|Semigroup
+ * transform(transducer, initial?)(foldable Foldable) -> result Promise|Semigroup
  * ```
  *
  * @description

package/tryCatch.js

@@ -22,13 +22,15 @@ const _tryCatch = function (tryer, catcher, args) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * tryCatch(tryer function, catcher function)(...args) -> Promise|any
+ * args Array<any>
+ * argsOrPromises Array<Promise|any>
  *
- * tryCatch(...args, tryer function, catcher function) -> Promise|any
+ * tryCatch(tryer function, catcher function)(...args) -> Promise|any
+ * tryCatch(...argsOrPromises, tryer function, catcher function) -> Promise|any
  * ```
  *
  * @description
- * Handles errors with a `tryer` and a `catcher` function. Calls the `tryer` function with the provided arguments and catches any errors thrown by the `tryer` function with the `catcher` function. If the `tryer` function is asynchronous and returns a rejected promise, the `catcher` function will execute with the value of the rejected promise. The `catcher` function is called with the error and all arguments supplied to the `tryer` function.
+ * Function equivalent to the [try...catch](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch) statement. Accepts two functions: a `tryer` function and a `catcher` function. Calls the `tryer` function and catches any errors thrown by the `tryer` function with the `catcher` function.
  *
  * ```javascript [playground]
  * const throwsIfOdd = number => {
@@ -38,18 +40,43 @@ const _tryCatch = function (tryer, catcher, args) {
  *   console.log('did not throw for', number)
  * }
  *
- * const errorHandler = tryCatch(throwsIfOdd, (error, number) => {
+ * const errorHandler = (error, number) => {
  *   console.log('caught error from number', number)
  *   console.log(error)
- * })
+ * }
+ *
+ * const handler = tryCatch(throwsIfOdd, errorHandler)
+ *
+ * handler(2) // did not throw for 2
+ * handler(3) // caught error from number 3
+ *            // Error: 3 is odd
+ *
+ * ```
+ *
+ * If the `tryer` function is asynchronous and throws an error, the `catcher` function will catch the rejected promise.
+ *
+ * ```javascript [playground]
+ * const rejectsIfOdd = async number => {
+ *   if (number % 2 == 1) {
+ *     throw new Error(`${number} is odd`)
+ *   }
+ *   console.log('did not throw for', number)
+ * }
+ *
+ * const errorHandler = (error, number) => {
+ *   console.log('caught error from number', number)
+ *   console.log(error)
+ * }
+ *
+ * const asyncHandler = tryCatch(rejectsIfOdd, errorHandler)
  *
- * errorHandler(2) // did not throw for 2
- * errorHandler(3) // caught error from number 3
+ * asyncHandler(2) // did not throw for 2
+ * asyncHandler(3) // caught error from number 3
  *                 // Error: 3 is odd
  *
  * ```
  *
- * `tryCatch` behaves eagerly (executes immediately with a single call and not with multiple calls like a higher order function) when passed any amount of nonfunction (primitive or object) arguments before the `tryer` and `catcher` functions.
+ * When provided any number of arguments before the tryer and catcher functions, `tryCatch` executes immediately.
  *
  * ```javascript [playground]
  * const add = (a, b) => a + b