rubico 2.7.10 → 2.8.1

package/LICENSE

@@ -1,21 +1,9 @@
-The MIT License (MIT)
+The CLOUT Free and Open Source Software License (CFOSS)
 
-Copyright (c) 2025 Richard Tong
+© Richard Yufei Tong, King of Software
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+  1. This permission notice is included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE, OR IN THE USE OF OR OTHER DEALINGS OF THE SOFTWARE.

package/README.md

@@ -121,7 +121,7 @@ const {
 } = rubico
 ```
 
-With [A]synchronous Functional Programming, any function may be asynchronous and return a promise. All promises are resolved for their values before continuing with the operation.
+With [A]synchronous Functional Programming, any function may be asynchronous and return a promise, and arguments may be promises as well. If a promise is provided to a Rubico operator in argument position, it is resolved for its value before continuing with the operation.
 
 ```javascript [playground]
 const helloPromise = Promise.resolve('hello')

package/_internal/curryArity.js

@@ -1,4 +1,9 @@
+const areAnyValuesPromises = require('./areAnyValuesPromises')
+const promiseAll = require('./promiseAll')
 const __ = require('./placeholder')
+const curry4 = require('./curry4')
+const curry3 = require('./curry3')
+const funcApply2 = require('./funcApply2')
 
 /**
  * @name _curryArity
@@ -9,13 +14,14 @@ const __ = require('./placeholder')
  *
  * var arity number,
  *   func function,
+ *   context object,
  *   args Array<__|any>,
  *   curried function
  *
- * _curryArity(arity, func, args) -> curried|any
+ * _curryArity(context, arity, func, args) -> curried|any
  * ```
  */
-const _curryArity = (arity, func, args) => function curried(...curriedArgs) {
+const _curryArity = (arity, func, context, args) => function curried(...curriedArgs) {
   const argsLength = args.length,
     curriedArgsLength = curriedArgs.length,
     nextArgs = []
@@ -34,10 +40,16 @@ const _curryArity = (arity, func, args) => function curried(...curriedArgs) {
     } else {
       nextArgs.push(arg)
     }
+
     if (nextArgs.length == arity) {
+      if (areAnyValuesPromises(nextArgs)) {
+        return numCurriedPlaceholders == 0
+          ? promiseAll(nextArgs).then(curry3(funcApply2, func, context, __))
+          : promiseAll(nextArgs).then(curry4(curryArity, arity, func, context, __))
+      }
       return numCurriedPlaceholders == 0
-        ? func(...nextArgs)
-        : curryArity(arity, func, nextArgs)
+        ? func.apply(context, nextArgs)
+        : curryArity(arity, func, context, nextArgs)
     }
   }
 
@@ -47,13 +59,22 @@ const _curryArity = (arity, func, args) => function curried(...curriedArgs) {
       numCurriedPlaceholders += 1
     }
     nextArgs.push(curriedArg)
+
     if (nextArgs.length == arity) {
+      if (areAnyValuesPromises(nextArgs)) {
+        return numCurriedPlaceholders == 0
+          ? promiseAll(nextArgs).then(curry3(funcApply2, func, context, __))
+          : promiseAll(nextArgs).then(curry4(curryArity, arity, func, context, __))
+      }
       return numCurriedPlaceholders == 0
-        ? func(...nextArgs)
-        : curryArity(arity, func, nextArgs)
+        ? func.apply(context, nextArgs)
+        : curryArity(arity, func, context, nextArgs)
     }
   }
-  return curryArity(arity, func, nextArgs)
+
+  return areAnyValuesPromises(nextArgs)
+    ? promiseAll(nextArgs).then(curry4(curryArity, arity, func, context, __))
+    : curryArity(arity, func, context, nextArgs)
 }
 
 /**
@@ -65,29 +86,30 @@ const _curryArity = (arity, func, args) => function curried(...curriedArgs) {
  *
  * var arity number,
  *   func function,
+ *   context object,
  *   args Array<__|any>,
  *   curried function
  *
- * curryArity(arity, func, args) -> curried|any
+ * curryArity(arity, func, context, args) -> curried|any
  * ```
  *
  * @description
  * Create a curried version of a function with specified arity.
  */
 
-const curryArity = function (arity, func, args) {
+const curryArity = function (arity, func, context, args) {
   const argsLength = args.length
   if (argsLength < arity) {
-    return _curryArity(arity, func, args)
+    return _curryArity(arity, func, context, args)
   }
   let argsIndex = -1
   while (++argsIndex < argsLength) {
     const arg = args[argsIndex]
     if (arg == __) {
-      return _curryArity(arity, func, args)
+      return _curryArity(arity, func, context, args)
     }
   }
-  return func(...args)
+  return func.apply(context, args)
 }
 
 module.exports = curryArity

package/_internal/funcApply2.js

@@ -0,0 +1,18 @@
+/**
+ * @name funcApply2
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * funcApply2<
+ *   func function,
+ *   context object,
+ *   args Array
+ * >(func, args) -> func(...args)
+ * ```
+ *
+ * @description
+ * Apply arguments to a function with context.
+ */
+const funcApply2 = (func, context, args) => func.apply(context, args)
+
+module.exports = funcApply2

package/_internal/mapMapEntries.js

@@ -11,7 +11,7 @@ const mapMapEntriesForEachCallback = (
 ) => function callback(value, key) {
   const mapping = mapper([key, value])
   if (isPromise(mapping)) {
-    promises.push(mapping.then(spread2(curryArity(3, mapSet, [result]))))
+    promises.push(mapping.then(spread2(curryArity(3, mapSet, this, [result]))))
   } else {
     result.set(mapping[0], mapping[1])
   }

package/_internal/objectMapEntries.js

@@ -24,7 +24,7 @@ const objectMapEntries = function (object, mapper) {
       mapping = mapper([key, value])
     if (isPromise(mapping)) {
       promises.push(mapping.then(
-        spread2(curryArity(3, objectSet, [result]))))
+        spread2(curryArity(3, objectSet, this, [result]))))
     } else {
       result[mapping[0]] = mapping[1]
     }

package/curry.js

@@ -1,3 +1,7 @@
+const areAnyValuesPromises = require('./_internal/areAnyValuesPromises')
+const promiseAll = require('./_internal/promiseAll')
+const __ = require('./_internal/placeholder')
+const curry4 = require('./_internal/curry4')
 const curryArity = require('./_internal/curryArity')
 
 /**
@@ -17,20 +21,32 @@ const curryArity = require('./_internal/curryArity')
  * ```
  *
  * @description
- * Enable 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. Provide the placeholder value `__` to specify an argument to be resolved in the partially applied function.
  *
  * ```javascript [playground]
  * const add = (a, b, c) => a + b + c
  *
- * console.log(curry(add, 'a', 'b', 'c')) // 'abc'
- * console.log(curry(add)('a', 'b', 'c')) // 'abc'
- * console.log(curry(add, 'a')('b', 'c')) // 'abc'
- * console.log(curry(add, 'a', 'b')('c')) // 'abc'
- * console.log(curry(add)('a')('b')('c')) // 'abc'
+ * 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, 'a', 'b')('c'))
+ * console.log(curry(add)('a')('b')('c'))
  *
- * console.log(curry(add, __, 'b', 'c')('a')) // abc
- * console.log(curry(add, __, __, 'c')('a', 'b')) // abc
- * console.log(curry(add, __, __, 'c')(__, 'b')('a')) // abc
+ * 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 argument position are resolved for their values before further execution. This only applies to the eager version of the API.
+ *
+ * ```javascript [playground]
+ * const add = (a, b, c) => a + b + c
+ *
+ * curry(add, Promise.resolve('a'), 'b', 'c').then(console.log)
+ *
+ * let curried = await curry(add, __, __, Promise.resolve('c'))
+ * curried = await curried(__, Promise.resolve('b'))
+ * console.log(curried('a'))
  * ```
  *
  * See also:
@@ -38,11 +54,17 @@ const curryArity = require('./_internal/curryArity')
  *  * [thunkify](/docs/thunkify)
  *  * [always](/docs/always)
  *  * [curry.arity](/docs/curry.arity)
+ *  * [curry.call](/docs/curry.call)
  *  * [__](/docs/__)
  *  * [Transducer.map](/docs/Transducer.map)
  *
  */
-const curry = (func, ...args) => curryArity(func.length, func, args)
+const curry = (func, ...args) => {
+  if (areAnyValuesPromises(args)) {
+    return promiseAll(args).then(curry4(curryArity, func.length, func, this, __))
+  }
+  return curryArity(func.length, func, this, args)
+}
 
 /**
  * @name curry.arity
@@ -61,7 +83,7 @@ const curry = (func, ...args) => curryArity(func.length, func, args)
  * ```
  *
  * @description
- * `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) as the first parameter.
  *
  * ```javascript [playground]
  * const add = (a, b, c = 0) => a + b + c
@@ -74,12 +96,73 @@ const curry = (func, ...args) => curryArity(func.length, func, args)
  *  * [thunkify](/docs/thunkify)
  *  * [always](/docs/always)
  *  * [curry](/docs/curry)
+ *  * [curry.call](/docs/curry.call)
  *  * [__](/docs/__)
  *  * [Transducer.map](/docs/Transducer.map)
  *
  */
 curry.arity = function curryArity_(arity, func, ...args) {
-  return curryArity(arity, func, args)
+  if (areAnyValuesPromises(args)) {
+    return promiseAll(args).then(curry4(curryArity, arity, func, this, __))
+  }
+  return curryArity(arity, func, this, args)
+}
+
+/**
+ * @name curry.call
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type __ = Symbol(placeholder)
+ * type ArgsWithPlaceholder = Array<__|any>
+ *
+ * n number
+ * args ArgsWithPlaceholder
+ * moreArgs ArgsWithPlaceholder
+ *
+ * curry.call(func function, context object, ...args) -> curriedFuncOrResult function|any
+ * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
+ * ```
+ *
+ * @description
+ * [curry](/docs/curry) with specified context.
+ *
+ * ```javascript [playground]
+ * class Point {
+ *   constructor(x, y) {
+ *     this.x = x
+ *     this.y = y
+ *   }
+ *
+ *   toString() {
+ *     return `(${this.x}, ${this.y})`
+ *   }
+ * }
+ *
+ * const point = new Point(100, 100)
+ *
+ * const box = { x: 5, y: 10 }
+ *
+ * console.log(curry.call(point.toString, point))
+ * console.log(curry.call(point.toString, box))
+ * ```
+ *
+ * See also:
+ *  * [eq](/docs/eq)
+ *  * [thunkify](/docs/thunkify)
+ *  * [always](/docs/always)
+ *  * [curry](/docs/curry)
+ *  * [curry.arity](/docs/curry.arity)
+ *  * [__](/docs/__)
+ *  * [Transducer.map](/docs/Transducer.map)
+ *
+ */
+curry.call = function call(func, context, ...args) {
+  if (areAnyValuesPromises(args)) {
+    return promiseAll(args).then(curry4(curryArity, func.length, func, context, __))
+  }
+  return curryArity(func.length, func, context, args)
 }
 
+
 module.exports = curry

package/dist/Transducer.es.js

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

package/dist/Transducer.es.min.js

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

package/dist/Transducer.js

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

package/dist/Transducer.min.js

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

package/dist/Transducer.mjs

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

package/dist/__.es.js

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

package/dist/__.es.min.js

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

package/dist/__.js

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

package/dist/__.min.js

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

package/dist/__.mjs

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

package/dist/all.es.js

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

package/dist/all.es.min.js

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

package/dist/all.js

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

package/dist/all.min.js

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

package/dist/all.mjs

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

package/dist/always.es.js

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

package/dist/always.es.min.js

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

package/dist/always.js

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

package/dist/always.min.js

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

package/dist/always.mjs

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

package/dist/and.es.js

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

package/dist/and.es.min.js

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

package/dist/and.js

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

package/dist/and.min.js

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

package/dist/and.mjs

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

package/dist/assign.es.js

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

package/dist/assign.es.min.js

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

package/dist/assign.js

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

package/dist/assign.min.js

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

package/dist/assign.mjs

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

package/dist/compose.es.js

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

package/dist/compose.es.min.js

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

package/dist/compose.js

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

package/dist/compose.min.js

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

package/dist/compose.mjs

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