rubico 2.11.0 → 2.12.1

package/README.md

@@ -23,7 +23,7 @@ const numbers = [1, 2, 3, 4, 5]
 pipe(numbers, [
   filter(isOdd),
   map(asyncSquare),
-  console.log, // [1, 9, 25]
+  console.log,
 ])
 ```
 
@@ -94,32 +94,37 @@ Rubico is a library for [A]synchronous Functional Programming in JavaScript. The
 
 ```javascript
 const {
-  // compose functions
+
+  // function composition
   pipe, compose, tap,
 
-  // control flow
+  // conditional operators
   switchCase,
 
-  // handle errors
+  // error handling
   tryCatch,
 
-  // compose data
+  // data construction
   all, assign, get, set, pick, omit,
 
-  // iterate
+  // iteration
   forEach,
 
-  // transform data
+  // transformation
   map, filter, reduce, transform, flatMap,
 
-  // compose predicates
-  and, or, not, some, every,
+  // data testing
+  some, every,
+
+  // logical operators
+  and, or, not,
 
   // comparison operators
   eq, gt, lt, gte, lte,
 
   // partial application
   thunkify, always, curry, __,
+
 } = rubico
 ```
 
@@ -133,7 +138,7 @@ pipe(helloPromise, [ // helloPromise is resolved for 'hello'
   // the Promise returned from the async function is resolved
   // and the resolved value is passed to console.log
 
-  console.log, // hello world
+  console.log,
 ])
 ```
 
@@ -151,7 +156,6 @@ const myDuplicatedSquaredObject = map(myObj, pipe([
 ]))
 
 console.log(myDuplicatedSquaredObject)
-// { a: [1, 1], b: [4, 4], c: [9, 9] }
 ```
 
 The Rubico operators are versatile and act on a wide range of vanilla JavaScript types to create declarative, extensible, and async-enabled function compositions. The same operator `map` can act on an array and also a `Map` data structure.
@@ -172,11 +176,6 @@ pipe(todoIDs, [
     response => response.json(),
 
     tap(console.log),
-    // { userId: 1, id: 4, title: 'et porro tempora', completed: true }
-    // { userId: 1, id: 1, title: 'delectus aut autem', completed: false }
-    // { userId: 1, id: 3, title: 'fugiat veniam minus', completed: false }
-    // { userId: 1, id: 2, title: 'quis ut nam facilis...', completed: false }
-    // { userId: 1, id: 5, title: 'laboriosam mollitia...', completed: false }
   ])),
 
   // group the todos by userId in a new Map
@@ -201,9 +200,6 @@ pipe(todoIDs, [
   })),
 
   tap(console.log),
-  // Map(1) {
-  //   1 => [ { userId: 1, id: 4, title: 'et porro tempora', completed: true } ]
-  // }
 ])
 ```
 
@@ -227,7 +223,7 @@ pipe(generateNumbers(), [
     Transducer.filter(isOdd),
     Transducer.map(asyncSquare),
   ), []),
-  console.log, // [1, 9, 25]
+  console.log,
 ])
 ```
 

package/Transducer.js

@@ -23,20 +23,18 @@ const Transducer = {}
  * ```coffeescript [specscript]
  * type SyncOrAsyncReducer = (accumulator any, value any)=>(nextAccumulator Promise|any)
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
- * type UnarySyncOrAsyncMapper = (element any)=>(resultElement Promise|any)
+ * type UnarySyncOrAsyncMapper = (item any)=>(mappedItem Promise|any)
  *
- * mapper UnarySyncOrAsyncMapper
- *
- * Transducer.map(mapper) -> mappingTransducer Transducer
+ * Transducer.map(mapper UnarySyncOrAsyncMapper) -> mappingTransducer Transducer
  * ```
  *
  * @description
- * Creates a mapping transducer. Elements of the transducer's reducing operation are transformed by the mapper function. It is possible to use an asynchronous mapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ * Creates a mapping [transducer](/blog/transducers-crash-course). Items of the transducer's reducing operation are transformed by the mapper function. It is possible to use an asynchronous mapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const square = number => number ** 2
  *
- * const concat = (array, element) => array.concat(element)
+ * const concat = (array, item) => array.concat(item)
  *
  * const mapSquare = Transducer.map(square)
  * // mapSquare is a transducer
@@ -45,23 +43,18 @@ const Transducer = {}
  * // now mapSquare is passed the reducer function concat; squareConcatReducer
  * // is a reducer with chained functionality square and concat
  *
- * console.log(
- *   reduce([1, 2, 3, 4, 5], squareConcatReducer, [])
- * ) // [1, 4, 9, 16, 25]
+ * const squaredNumbersRubicoReduce = reduce([1, 2, 3, 4, 5], squareConcatReducer, [])
+ * console.log(squaredNumbersRubicoReduce)
  *
  * // the same squareConcatReducer is consumable with vanilla JavaScript
- * console.log(
- *   [1, 2, 3, 4, 5].reduce(squareConcatReducer, [])
- * ) // [1, 4, 9, 16, 25]
+ * const squaredNumbersVanillaReduce = [1, 2, 3, 4, 5].reduce(squareConcatReducer, [])
+ * console.log(squaredNumbersVanillaReduce)
  *
  * // concat is implicit when transforming into arrays
- * console.log(
- *   transform([1, 2, 3, 4, 5], Transducer.map(square), [])
- * ) // [1, 4, 9, 16, 25]
+ * const squaredNumbersTransform = transform([1, 2, 3, 4, 5], Transducer.map(square), [])
+ * console.log(squaredNumbersTransform)
  * ```
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
- *
  * See also:
  *  * [thunkify](/docs/thunkify)
  *  * [Transducer.filter](/docs/Transducer.filter)
@@ -84,31 +77,27 @@ Transducer.map = function transducerMap(mapper) {
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
  * type UnarySyncOrAsyncPredicate = any=>Promise|boolean|any
  *
- * predicate UnarySyncOrAsyncPredicate
- *
- * Transducer.filter(predicate) -> filteringTransducer Transducer
+ * Transducer.filter(predicate UnarySyncOrAsyncPredicate) -> filteringTransducer Transducer
  * ```
  *
  * @description
- * Creates a filtering transducer. A filtering transducer filters out elements of its reducing operation if they test false by the predicate. It is possible to use an asynchronous predicate, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ * Creates a filtering [transducer](/blog/transducers-crash-course). A filtering transducer filters out items of its reducing operation if they test false by the predicate. It is possible to use an asynchronous predicate, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const isOdd = number => number % 2 == 1
  *
- * const concat = (array, element) => array.concat(element)
+ * const concat = (array, item) => array.concat(item)
  *
  * const concatOddNumbers = Transducer.filter(isOdd)(concat)
  *
  * const array = [1, 2, 3, 4, 5]
  *
  * const oddNumbers1 = array.reduce(concatOddNumbers, [])
- * console.log(oddNumbers1) // [1, 3, 5]
- *
  * const oddNumbers2 = transform(array, Transducer.filter(isOdd), [])
- * console.log(oddNumbers2) // [1, 3, 5]
- * ```
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
+ * console.log(oddNumbers1)
+ * console.log(oddNumbers2)
+ * ```
  *
  * See also:
  *  * [thunkify](/docs/thunkify)
@@ -131,27 +120,23 @@ Transducer.filter = function transducerFilter(predicate) {
  * type SyncOrAsyncReducer = (accumulator any, value any)=>(nextAccumulator Promise|any)
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
  * type Monad = Array|String|Set|Generator|AsyncGenerator|{ flatMap: string }|{ chain: string }|Object
- * type UnarySyncOrAsyncFlatMapper = (element any)=>(monad Promise|Monad|any)
+ * type UnarySyncOrAsyncFlatMapper = (item any)=>(monad Promise|Monad|any)
  *
- * flatMapper UnarySyncOrAsyncFlatMapper
- *
- * Transducer.flatMap(flatMapper) -> flatMappingTransducer Transducer
+ * Transducer.flatMap(flatMapper UnarySyncOrAsyncFlatMapper) -> flatMappingTransducer Transducer
  * ```
  *
  * @description
- * Creates a flatMapping transducer. A flatMapping transducer applies the flatMapper function to each element of its reducing operation, concatenating the results of the flatMapper execution onto the accumulator. It is possible to use an asynchronous flatMapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ * Creates a flatMapping [transducer](/blog/transducers-crash-course). A flatMapping transducer applies the flatMapper function to each item of its reducing operation, concatenating the results of the flatMapper execution onto the accumulator. It is possible to use an asynchronous flatMapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const powers = number => [number, number ** 2, number ** 3]
  *
  * const numbers = [1, 2, 3, 4, 5]
  *
- * console.log(
- *   transform(numbers, Transducer.flatMap(powers), [])
- * ) // [1, 1, 1, 2, 4, 8, 3, 9, 27, 4, 16, 64, 5, 25, 125]
- * ```
+ * const result = transform(numbers, Transducer.flatMap(powers), [])
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
+ * console.log(result)
+ * ```
  *
  * See also:
  *  * [thunkify](/docs/thunkify)
@@ -173,26 +158,23 @@ Transducer.flatMap = function transducerFlatMap(flatMapper) {
  * ```coffeescript [specscript]
  * type SyncOrAsyncReducer = (accumulator any, value any)=>(nextAccumulator Promise|any)
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
- * type UnarySyncOrAsyncCallback = (element any)=>Promise|undefined
- *
- * callback UnarySyncOrAsyncCallback
+ * type UnarySyncOrAsyncCallback = (item any)=>Promise|undefined
  *
- * Transducer.forEach(callback) -> forEachTransducer Transducer
+ * Transducer.forEach(callback UnarySyncOrAsyncCallback) -> forEachTransducer Transducer
  * ```
  *
  * @description
- * Executes a callback function for each element of a reducing operation, leaving the reducing operation unmodified. It is possible to use an asynchronous callback function, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ * Creates an iterative [transducer](/blog/transducers-crash-course). Executes a callback function for each item of a reducing operation, leaving each item unmodified. It is possible to use an asynchronous callback function, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const numbers = [1, 2, 3, 4, 5]
+ *
  * transform(numbers, compose(
  *   Transducer.map(number => number ** 2),
- *   Transducer.forEach(console.log), // 1 4 9 16 25
+ *   Transducer.forEach(console.log),
  * ), null)
  * ```
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
- *
  * See also:
  *  * [thunkify](/docs/thunkify)
  *  * [Transducer.map](/docs/Transducer.map)
@@ -214,11 +196,11 @@ Transducer.forEach = function transducerForEach(func) {
  * type SyncOrAsyncReducer = (accumulator any, value any)=>(nextAccumulator Promise|any)
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
  *
- * Transducer.passthrough Transducer
+ * Transducer.passthrough -> Transducer
  * ```
  *
  * @description
- * Creates a pasthrough transducer. The passthrough transducer simply passes each element of the reducing operation through to the next downstream operation, leaving the reducing operation unmodified.
+ * Creates a pasthrough [transducer](/blog/transducers-crash-course). The passthrough transducer simply passes each item of the reducing operation through to the next downstream transducer, leaving each item unmodified.
  *
  * ```javascript [playground]
  * const createAsyncNumbers = async function* () {
@@ -229,11 +211,10 @@ Transducer.forEach = function transducerForEach(func) {
  *   }
  * }
  *
- * transform(createAsyncNumbers(), Transducer.passthrough, [])
- *   .then(console.log) // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
- * ```
+ * const numbers = await transform(createAsyncNumbers(), Transducer.passthrough, [])
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
+ * console.log(numbers)
+ * ```
  *
  * See also:
  *  * [thunkify](/docs/thunkify)
@@ -256,14 +237,14 @@ Transducer.passthrough = function transducerPassthrough(reducer) {
  * type SyncOrAsyncReducer = (accumulator any, value any)=>(nextAccumulator Promise|any)
  * type Transducer = SyncOrAsyncReducer=>SyncOrAsyncReducer
  *
- * transducerTryer Transducer
- * catcher (error Error, element any)=>Promise|any
- *
- * Transducer.tryCatch(transducerTryer, catcher) -> tryCatchTransducer Transducer
+ * Transducer.tryCatch(
+ *   transducerTryer Transducer,
+ *   catcher (error Error, item any)=>(Promise|any)
+ * ) -> tryCatchTransducer Transducer
  * ```
  *
  * @description
- * Creates an error handling transducer. The error handling transducer wraps a transducer and catches any errors thrown by the transducer with the catcher function. The catcher function is provided the error as well as the element for which the error was thrown. It is possible for either the transducer or the catcher to be asynchronous, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ * Creates an error handling [transducer](/blog/transducers-crash-course). The error handling transducer wraps a transducer and catches any errors thrown by the transducer with the catcher function. The catcher function is provided the error and the item for which the error was thrown. It is possible for either the transducer or the catcher to be asynchronous, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const db = new Map()
@@ -295,8 +276,6 @@ Transducer.passthrough = function transducerPassthrough(reducer) {
  * ), null)
  * ```
  *
- * Read more on [transducers](/blog/transducers-crash-course-rubico-v2).
- *
  * See also:
  *  * [thunkify](/docs/thunkify)
  *  * [Transducer.map](/docs/Transducer.map)

package/__.js

@@ -12,9 +12,9 @@ const __ = require('./_internal/placeholder')
  * A special placeholder value `__` (two underscores) that denotes the position of an argument in a curried function.
  *
  * ```javascript [playground]
- * console.log(
- *   curry.arity(3, Array.of, __, 2, 3)(1),
- * ) // [1, 2, 3]
+ * const curriedFunction = curry.arity(3, Array.of, __, 2, 3)
+ *
+ * console.log(curriedFunction(1))
  * ```
  *
  * See also:

package/always.js

@@ -9,14 +9,14 @@ const always = require('./_internal/always')
  * ```
  *
  * @description
- * Creates a function from a value that always returns the provided value.
+ * Creates a function that always returns a value.
  *
  * ```javascript [playground]
  * const always5 = always(5)
  *
- * console.log(always5()) // 5
- * console.log(always5()) // 5
- * console.log(always5()) // 5
+ * console.log(always5())
+ * console.log(always5())
+ * console.log(always5())
  * ```
  *
  * See also:

package/and.js

@@ -97,37 +97,28 @@ const areAllPredicatesTruthy = function (args, predicates) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * args Array<any>
- * argsOrPromises Array<Promise|any>
+ * type SyncOrAsyncPredicate = (...arguments)=>Promise|boolean|any
  *
- * type SyncOrAsyncPredicate = (...args)=>Promise|boolean|any
- *
- * predicatesOrValues Array<SyncOrAsyncPredicate|boolean|any>
- *
- * and(values Array<boolean|any>) -> result boolean
- * and(...argsOrPromises, predicatesOrValues) -> Promise|boolean
- * and(predicatesOrValues)(...args) -> Promise|boolean
+ * and(values Array<boolean|any>) -> testResult boolean
+ * and(...arguments, predicatesOrValues Array<SyncOrAsyncPredicate|boolean|any>) -> testResult Promise|boolean
+ * and(predicatesOrValues Array<SyncOrAsyncPredicate|boolean|any>)(...arguments) -> testResult Promise|boolean
  * ```
  *
  * @description
- * Function equivalent to the [Logical AND](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Logical_AND) operator. Tests an array of predicate functions, promises, values, or a mix thereof.
- *
- * If provided an array of boolean values, `and` returns true if all boolean values are true.
+ * Logical operator. Tests an array of predicate functions, promises, or values, returning true if all predicates test true and all values are truthy.
  *
  * ```javascript [playground]
- * const oneIsLessThanThree = 1 < 3
- * const twoIsGreaterThanOne = 2 > 1
- * const threeIsEqualToThree = 3 === 3
- *
- * const condition = and([
- *   oneIsLessThanThree,
- *   twoIsGreaterThanOne,
- *   threeIsEqualToThree
+ * const isOddAndGreaterThan3 = and([
+ *   n => n % 2 == 1,
+ *   n => n > 3,
  * ])
- * console.log(condition) // true
+ *
+ * console.log(isOddAndGreaterThan3(5))
+ * console.log(isOddAndGreaterThan3(3))
+ * console.log(isOddAndGreaterThan3(6))
  * ```
  *
- * If any predicate functions are provided in the array, `and` returns an aggregate predicate function that returns true for a given set of arguments if all provided predicate functions test true. If any provided predicate functions are asynchronous, the aggregate predicate function becomes asynchronous.
+ * If the array contains predicate functions, `and` returns an aggregate predicate function that returns true if all predicate functions test true. If any predicate function is asynchronous, the aggregate predicate function is asynchronous.
  *
  * ```javascript [playground]
  * const isOdd = number => number % 2 == 1
@@ -141,17 +132,34 @@ const areAllPredicatesTruthy = function (args, predicates) {
  *   asyncIsLessThan3,
  * ])
  *
- * const condition = await aggregatePredicate(1)
- * console.log(condition) // true
+ * const booleanResult = await aggregatePredicate(1)
+ *
+ * console.log(booleanResult)
+ * ```
+ *
+ * If the array contains only values, `and` returns a boolean value.
+ *
+ * ```javascript [playground]
+ * const oneIsLessThanThree = 1 < 3
+ * const twoIsGreaterThanOne = 2 > 1
+ * const threeIsEqualToThree = 3 === 3
+ *
+ * const booleanResult = and([
+ *   oneIsLessThanThree,
+ *   twoIsGreaterThanOne,
+ *   threeIsEqualToThree
+ * ])
+ *
+ * console.log(booleanResult)
  * ```
  *
- * Any promises passed in data argument position are resolved for their values before further execution.
+ * Any promises in the array are resolved for their values before further execution.
  *
  * ```javascript [playground]
  * and(Promise.resolve(5), [
  *   n => n > 0,
  *   n => n < 10,
- * ]).then(console.log) // true
+ * ]).then(console.log)
  * ```
  *
  * See also:

package/assign.js

@@ -56,9 +56,9 @@ const _assign = function (object, funcs) {
  *   },
  * })
  *
- * const promise = asyncAssignTotal({ numbers: [1, 2, 3, 4, 5] })
+ * const result = await asyncAssignTotal({ numbers: [1, 2, 3, 4, 5] })
  *
- * promise.then(console.log)
+ * console.log(result)
  * ```
  *
  * If the argument object is a promise, it is resolved for its value before further execution for the eager interface only.

package/compose.js

@@ -30,6 +30,7 @@ const funcConcat = require('./_internal/funcConcat')
  * const g = x => x + 3
  *
  * const result = compose(5, [f, g])
+ *
  * console.log(result)
  * ```
  *

package/curry.js

@@ -10,18 +10,15 @@ const curryArity = require('./_internal/curryArity')
  * @synopsis
  * ```coffeescript [specscript]
  * __ Symbol(placeholder)
+ * argumentsWithPlaceholder Array<__|any>
  *
- * type ArgsWithPlaceholder = Array<__|any>
- *
- * args ArgsWithPlaceholder
- * moreArgs ArgsWithPlaceholder
- *
- * curry(func function, ...args) -> curriedFuncOrResult function|any
- * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
+ * curry(func function, ...arguments) -> result any
+ * curry(func function, ...argumentsWithPlaceholder) -> result any
+ * curry(func function, ...argumentsWithPlaceholder) -> curriedFunction function
  * ```
  *
  * @description
- * Enables partial application of a function's arguments in any order. Provide the placeholder value `__` to specify an argument to be resolved in the partially applied function.
+ * Enables partial application of a function's arguments in any order. The placeholder value [__](/docs/__) specifies an argument to be resolved in the partially applied function.
  *
  * ```javascript [playground]
  * const add = (a, b, c) => a + b + c
@@ -31,13 +28,12 @@ const curryArity = require('./_internal/curryArity')
  * console.log(curry(add, 'a')('b', 'c'))
  * console.log(curry(add, 'a', 'b')('c'))
  * console.log(curry(add)('a')('b')('c'))
- *
  * console.log(curry(add, __, 'b', 'c')('a'))
  * console.log(curry(add, __, __, 'c')('a', 'b'))
  * console.log(curry(add, __, __, 'c')(__, 'b')('a'))
  * ```
  *
- * Any promises passed in data argument position are resolved for their values before further execution.
+ * Any promises in `arguments` or `argumentsWithPlaceholder` are resolved for their values before further execution.
  *
  * ```javascript [playground]
  * const add = (a, b, c) => a + b + c
@@ -71,24 +67,29 @@ const curry = (func, ...args) => {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type __ = Symbol(placeholder)
- * type ArgsWithPlaceholder = Array<__|any>
- *
- * n number
- * args ArgsWithPlaceholder
- * moreArgs ArgsWithPlaceholder
+ * __ Symbol(placeholder)
+ * argumentsWithPlaceholder Array<__|any>
  *
- * curry.arity(n number, func function, ...args) -> curriedFuncOrResult function|any
- * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
+ * curry.arity(n number, func function, ...arguments) -> result any
+ * curry.arity(n number, func function, ...argumentsWithPlaceholder) -> result any
+ * curry.arity(n number, func function, ...argumentsWithPlaceholder) -> curriedFunction function
  * ```
  *
  * @description
- * [curry](/docs/curry) with specified arity (number of arguments taken by the function) as the first parameter.
+ * [curry](/docs/curry) with specified arity (number of arguments taken by the function).
+ *
+ * ```javascript [playground]
+ * const add = (a, b, c = 0) => a + b + c
+ *
+ * console.log(curry.arity(2, add, 1, 2))
+ * ```
+ *
+ * Any promises in `arguments` or `argumentsWithPlaceholder` are resolved for their values before further execution.
  *
  * ```javascript [playground]
  * const add = (a, b, c = 0) => a + b + c
  *
- * console.log(curry.arity(2, add, 1, 2)) // 3
+ * console.log(await curry.arity(2, add, Promise.resolve(1), 2))
  * ```
  *
  * See also:
@@ -113,15 +114,12 @@ curry.arity = function curryArity_(arity, func, ...args) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type __ = Symbol(placeholder)
- * type ArgsWithPlaceholder = Array<__|any>
- *
- * n number
- * args ArgsWithPlaceholder
- * moreArgs ArgsWithPlaceholder
+ * __ Symbol(placeholder)
+ * argumentsWithPlaceholder Array<__|any>
  *
- * curry.call(func function, context object, ...args) -> curriedFuncOrResult function|any
- * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
+ * curry.call(func function, context object, ...arguments) -> result any
+ * curry.call(func function, context object, ...argumentsWithPlaceholder) -> result any
+ * curry.call(func function, context object, ...argumentsWithPlaceholder) -> curriedFunction function
  * ```
  *
  * @description
@@ -147,6 +145,28 @@ curry.arity = function curryArity_(arity, func, ...args) {
  * console.log(curry.call(point.toString, box))
  * ```
  *
+ * Any promises in `arguments` are resolved for their values during thunk creation.
+ *
+ * ```javascript [playground]
+ * class Point {
+ *   constructor(x, y) {
+ *     this.x = x
+ *     this.y = y
+ *   }
+ *
+ *   distanceTo(point) {
+ *     const x2 = (point.x - this.x) ** 2
+ *     const y2 = (point.y - this.y) ** 2
+ *     return (x2 + y2) ** 0.5
+ *   }
+ * }
+ *
+ * const point1 = new Point(100, 100)
+ * const point2 = new Point(200, 200)
+ *
+ * console.log(await curry.call(point1.distanceTo, point1, Promise.resolve(point2)))
+ * ```
+ *
  * See also:
  *  * [eq](/docs/eq)
  *  * [thunkify](/docs/thunkify)

package/dist/Transducer.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/Transducer.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/__.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.10.0
+ * Rubico v2.12.1
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software