rubico 1.9.6 → 2.0.0

package/compose.js

@@ -0,0 +1,46 @@
+const curry2 = require('./_internal/curry2')
+const __ = require('./_internal/placeholder')
+const promiseAll = require('./_internal/promiseAll')
+const funcApply = require('./_internal/funcApply')
+const areAnyValuesPromises = require('./_internal/areAnyValuesPromises')
+const funcConcat = require('./_internal/funcConcat')
+
+/**
+ * @name compose
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * compose(funcs Array<function>)(...args) -> result Promise|any
+ *
+ * compose(...args, funcs Array<function>) -> result Promise|any
+ * ```
+ *
+ * @description
+ * Creates a function composition from an array of functions, where each function passes its return value as a single argument to the previous function until all functions have executed. The last function is called with the arguments to the composition, while the result of a function composition is the return value of its first function. If any function of the composition is asynchronous, the result of the execution is a Promise. `compose` is effectively `pipe` in reverse.
+ *
+ * ```javascript [playground]
+ * const f = number => number * 2
+ *
+ * const g = number => number + 3
+ *
+ * console.log(
+ *   compose(5, [f, g]),
+ * ) // 16
+ * ```
+ */
+const compose = function (...args) {
+  const funcs = args.pop()
+  const composition = funcs.reduceRight(funcConcat)
+
+  if (args.length == 0) {
+    return composition
+  }
+
+  if (areAnyValuesPromises(args)) {
+    return promiseAll(args).then(curry2(funcApply, composition, __))
+  }
+
+  return composition(...args)
+}
+
+module.exports = compose

package/curry.js

@@ -5,15 +5,18 @@ const curryArity = require('./_internal/curryArity')
  *
  * @synopsis
  * ```coffeescript [specscript]
- * __ = Symbol(placeholder)
+ * type __ = Symbol(placeholder)
+ * type ArgsWithPlaceholder = Array<__|any>
  *
- * var func function,
- *   args ...(__|any),
- *   moreArgs ...(__|any)
+ * args ArgsWithPlaceholder
+ * moreArgs ArgsWithPlaceholder
  *
- * curry(func, ...args) -> curried function|any
+ * curry(
+ *   func function,
+ *   ...args
+ * ) -> curriedFuncOrResult function|any
  *
- * curry(func, ...args)(...moreArgs) -> curried function|any
+ * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
  * ```
  *
  * @description
@@ -40,18 +43,23 @@ const curry = (func, ...args) => curryArity(func.length, func, args)
  *
  * @synopsis
  * ```coffeescript [specscript]
- * __ = Symbol(placeholder)
+ * type __ = Symbol(placeholder)
+ * type ArgsWithPlaceholder = Array<__|any>
+ *
+ * args ArgsWithPlaceholder
+ * moreArgs ArgsWithPlaceholder
  *
- * var arity number,
+ * curry.arity(
+ *   arity number,
  *   func function,
- *   args Array<__|any>,
- *   curried function
+ *   ...args
+ * ) -> curriedFuncOrResult function|any
  *
- * curry.arity(arity, func, ...args) -> curried|any
+ * curriedFuncOrResult(...moreArgs) -> anotherCurriedFuncOrResult function|any
  * ```
  *
  * @description
- * `curry` with specified arity as the first parameter. Useful for locking down variadic functions.
+ * `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

package/dist/__.es.js

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const __ = Symbol.for('placeholder')

package/dist/__.es.min.js

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const __=Symbol.for("placeholder");export default __;

package/dist/__.js

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 

package/dist/__.min.js

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 

package/dist/__.min.mjs

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const __=Symbol.for("placeholder");export default __;

package/dist/__.mjs

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 const __ = Symbol.for('placeholder')

package/dist/all.es.js

@@ -1,14 +1,94 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 
+const isPromise = value => value != null && typeof value.then == 'function'
+
+const areAnyValuesPromises = function (values) {
+  const length = values.length
+  let index = -1
+  while (++index < length) {
+    const value = values[index]
+    if (isPromise(value)) {
+      return true
+    }
+  }
+  return false
+}
+
+const promiseAll = Promise.all.bind(Promise)
+
 const isArray = Array.isArray
 
 const __ = Symbol.for('placeholder')
 
+// argument resolver for curry2
+const curry2ResolveArg0 = (
+  baseFunc, arg1,
+) => function arg0Resolver(arg0) {
+  return baseFunc(arg0, arg1)
+}
+
+// argument resolver for curry2
+const curry2ResolveArg1 = (
+  baseFunc, arg0,
+) => function arg1Resolver(arg1) {
+  return baseFunc(arg0, arg1)
+}
+
+const curry2 = function (baseFunc, arg0, arg1) {
+  return arg0 == __
+    ? curry2ResolveArg0(baseFunc, arg1)
+    : curry2ResolveArg1(baseFunc, arg0)
+}
+
+// argument resolver for curryArgs2
+const curryArgs2ResolveArgs0 = (
+  baseFunc, arg1, arg2,
+) => function args0Resolver(...args) {
+  return baseFunc(args, arg1)
+}
+
+// argument resolver for curryArgs2
+const curryArgs2ResolveArgs1 = (
+  baseFunc, arg0, arg2,
+) => function arg1Resolver(...args) {
+  return baseFunc(arg0, args)
+}
+
+const curryArgs2 = function (baseFunc, arg0, arg1) {
+  if (arg0 == __) {
+    return curryArgs2ResolveArgs0(baseFunc, arg1)
+  }
+  return curryArgs2ResolveArgs1(baseFunc, arg0)
+}
+
+const functionArrayAll = function (funcs, args) {
+  const funcsLength = funcs.length,
+    result = Array(funcsLength)
+  let funcsIndex = -1, isAsync = false
+  while (++funcsIndex < funcsLength) {
+    const resultItem = funcs[funcsIndex](...args)
+    if (isPromise(resultItem)) {
+      isAsync = true
+    }
+    result[funcsIndex] = resultItem
+  }
+  return isAsync ? promiseAll(result) : result
+}
+
+const funcConcat = (
+  funcA, funcB,
+) => function pipedFunction(...args) {
+  const intermediate = funcA(...args)
+  return isPromise(intermediate)
+    ? intermediate.then(funcB)
+    : funcB(intermediate)
+}
+
 // argument resolver for curry3
 const curry3ResolveArg0 = (
   baseFunc, arg1, arg2,
@@ -40,118 +120,119 @@ const curry3 = function (baseFunc, arg0, arg1, arg2) {
   return curry3ResolveArg2(baseFunc, arg0, arg1)
 }
 
-const isPromise = value => value != null && typeof value.then == 'function'
+// argument resolver for curry4
+const curry4ResolveArg0 = (
+  baseFunc, arg1, arg2, arg3,
+) => function arg0Resolver(arg0) {
+  return baseFunc(arg0, arg1, arg2, arg3)
+}
 
-const promiseAll = Promise.all.bind(Promise)
+// argument resolver for curry4
+const curry4ResolveArg1 = (
+  baseFunc, arg0, arg2, arg3,
+) => function arg1Resolver(arg1) {
+  return baseFunc(arg0, arg1, arg2, arg3)
+}
+
+// argument resolver for curry4
+const curry4ResolveArg2 = (
+  baseFunc, arg0, arg1, arg3,
+) => function arg2Resolver(arg2) {
+  return baseFunc(arg0, arg1, arg2, arg3)
+}
 
-const callPropUnary = (value, property, arg0) => value[property](arg0)
+// argument resolver for curry4
+const curry4ResolveArg3 = (
+  baseFunc, arg0, arg1, arg2,
+) => function arg3Resolver(arg3) {
+  return baseFunc(arg0, arg1, arg2, arg3)
+}
 
-const arrayAll = function (array, predicate) {
-  const arrayLength = array.length,
-    promises = []
-  let index = -1
-  while (++index < arrayLength) {
-    const predication = predicate(array[index])
-    if (isPromise(predication)) {
-      promises.push(predication)
-    } else if (!predication) {
-      return false
-    }
+const curry4 = function (baseFunc, arg0, arg1, arg2, arg3) {
+  if (arg0 == __) {
+    return curry4ResolveArg0(baseFunc, arg1, arg2, arg3)
   }
-  return promises.length == 0
-    ? true
-    : promiseAll(promises).then(curry3(callPropUnary, __, 'every', Boolean))
-}
-
-const iteratorAll = function (iterator, predicate) {
-  const promises = []
-  for (const item of iterator) {
-    const predication = predicate(item)
-    if (isPromise(predication)) {
-      promises.push(predication)
-    } else if (!predication) {
-      return false
-    }
+  if (arg1 == __) {
+    return curry4ResolveArg1(baseFunc, arg0, arg2, arg3)
+  }
+  if (arg2 == __) {
+    return curry4ResolveArg2(baseFunc, arg0, arg1, arg3)
   }
-  return promises.length == 0
-    ? true
-    : promiseAll(promises).then(curry3(callPropUnary, __, 'every', Boolean))
+  return curry4ResolveArg3(baseFunc, arg0, arg1, arg2)
 }
 
-const SelfReferencingPromise = function (basePromise) {
-  const promise = basePromise.then(res => [res, promise])
-  return promise
+const objectSet = function (object, property, value) {
+  object[property] = value
+  return object
 }
 
-const promiseRace = Promise.race.bind(Promise)
-
-const asyncIteratorAll = async function (
-  asyncIterator, predicate, promisesInFlight, maxConcurrency = 20,
-) {
-  let iteration = await asyncIterator.next()
-  while (!iteration.done) {
-    if (promisesInFlight.size >= maxConcurrency) {
-      const [predication, promise] = await promiseRace(promisesInFlight)
-      promisesInFlight.delete(promise)
-      if (!predication) {
-        return false
-      }
-    }
-
-    const predication = predicate(iteration.value)
-    if (isPromise(predication)) {
-      promisesInFlight.add(SelfReferencingPromise(predication))
-    } else if (!predication) {
-      return false
-    }
-    iteration = await asyncIterator.next()
+const asyncFunctionArrayAllSeries = async function (funcs, args, result, funcsIndex) {
+  const funcsLength = funcs.length
+  while (++funcsIndex < funcsLength) {
+    const resultItem = funcs[funcsIndex](...args)
+    result[funcsIndex] = isPromise(resultItem) ? await resultItem : resultItem
   }
-  while (promisesInFlight.size > 0) {
-    const [predication, promise] = await promiseRace(promisesInFlight)
-    promisesInFlight.delete(promise)
-    if (!predication) {
-      return false
+  return result
+}
+
+const functionArrayAllSeries = function (funcs, args) {
+  const funcsLength = funcs.length, result = []
+  let funcsIndex = -1
+  while (++funcsIndex < funcsLength) {
+    const resultItem = funcs[funcsIndex](...args)
+    if (isPromise(resultItem)) {
+      return resultItem.then(funcConcat(
+        curry3(objectSet, result, funcsIndex, __),
+        curry4(asyncFunctionArrayAllSeries, funcs, args, __, funcsIndex)))
     }
+    result[funcsIndex] = resultItem
   }
-  return true
+  return result
 }
 
-const objectValues = Object.values
+const always = value => function getter() { return value }
 
-const reducerAllSync = (predicate, result, item) => result ? predicate(item) : false
-
-const reducerAll = predicate => function allReducer(result, item) {
-  return result === false ? false
-    : isPromise(result) ? result.then(
-      curry3(reducerAllSync, predicate, __, item))
-    : result ? predicate(item) : false
+const functionObjectAll = function (funcs, args) {
+  const result = {}, promises = []
+  for (const key in funcs) {
+    const resultItem = funcs[key](...args)
+    if (isPromise(resultItem)) {
+      promises.push(resultItem.then(curry3(objectSet, result, key, __)))
+    } else {
+      result[key] = resultItem
+    }
+  }
+  return promises.length == 0 ? result : promiseAll(promises).then(always(result))
 }
 
-const symbolIterator = Symbol.iterator
-
-const symbolAsyncIterator = Symbol.asyncIterator
-
-const all = predicate => function allTruthy(value) {
-  if (isArray(value)) {
-    return arrayAll(value, predicate)
-  }
-  if (value == null) {
-    return predicate(value)
+const all = function (...args) {
+  const funcs = args.pop()
+  if (args.length == 0) {
+    return isArray(funcs)
+      ? curryArgs2(functionArrayAll, funcs, __)
+      : curryArgs2(functionObjectAll, funcs, __)
   }
 
-  if (typeof value[symbolIterator] == 'function') {
-    return iteratorAll(value[symbolIterator](), predicate)
+  if (areAnyValuesPromises(args)) {
+    return isArray(funcs)
+      ? promiseAll(args).then(curry2(functionArrayAll, funcs, __))
+      : promiseAll(args).then(curry2(functionObjectAll, funcs, __))
   }
-  if (typeof value[symbolAsyncIterator] == 'function') {
-    return asyncIteratorAll(value[symbolAsyncIterator](), predicate, new Set())
-  }
-  if (typeof value.reduce == 'function') {
-    return value.reduce(reducerAll(predicate), true)
+
+  return isArray(funcs)
+    ? functionArrayAll(funcs, args)
+    : functionObjectAll(funcs, args)
+}
+
+all.series = function allSeries(...args) {
+  const funcs = args.pop()
+  if (args.length == 0) {
+    return curryArgs2(functionArrayAllSeries, funcs, __)
   }
-  if (value.constructor == Object) {
-    return arrayAll(objectValues(value), predicate)
+  if (areAnyValuesPromises(args)) {
+    return promiseAll(args).then(curry2(functionArrayAllSeries, funcs, __))
   }
-  return predicate(value)
+  return functionArrayAllSeries(funcs, args)
 }
 
 export default all

package/dist/all.es.min.js

@@ -1,7 +1,7 @@
 /**
- * rubico v1.9.6
+ * rubico v2.0.0
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
-const isArray=Array.isArray,__=Symbol.for("placeholder"),curry3ResolveArg0=(r,e,t)=>function(o){return r(o,e,t)},curry3ResolveArg1=(r,e,t)=>function(o){return r(e,o,t)},curry3ResolveArg2=(r,e,t)=>function(o){return r(e,t,o)},curry3=function(r,e,t,o){return e==__?curry3ResolveArg0(r,t,o):t==__?curry3ResolveArg1(r,e,o):curry3ResolveArg2(r,e,t)},isPromise=r=>null!=r&&"function"==typeof r.then,promiseAll=Promise.all.bind(Promise),callPropUnary=(r,e,t)=>r[e](t),arrayAll=function(r,e){const t=r.length,o=[];let n=-1;for(;++n<t;){const t=e(r[n]);if(isPromise(t))o.push(t);else if(!t)return!1}return 0==o.length||promiseAll(o).then(curry3(callPropUnary,__,"every",Boolean))},iteratorAll=function(r,e){const t=[];for(const o of r){const r=e(o);if(isPromise(r))t.push(r);else if(!r)return!1}return 0==t.length||promiseAll(t).then(curry3(callPropUnary,__,"every",Boolean))},SelfReferencingPromise=function(r){const e=r.then((r=>[r,e]));return e},promiseRace=Promise.race.bind(Promise),asyncIteratorAll=async function(r,e,t,o=20){let n=await r.next();for(;!n.done;){if(t.size>=o){const[r,e]=await promiseRace(t);if(t.delete(e),!r)return!1}const l=e(n.value);if(isPromise(l))t.add(SelfReferencingPromise(l));else if(!l)return!1;n=await r.next()}for(;t.size>0;){const[r,e]=await promiseRace(t);if(t.delete(e),!r)return!1}return!0},objectValues=Object.values,reducerAllSync=(r,e,t)=>!!e&&r(t),reducerAll=r=>function(e,t){return!1!==e&&(isPromise(e)?e.then(curry3(reducerAllSync,r,__,t)):!!e&&r(t))},symbolIterator=Symbol.iterator,symbolAsyncIterator=Symbol.asyncIterator,all=r=>function(e){return isArray(e)?arrayAll(e,r):null==e?r(e):"function"==typeof e[symbolIterator]?iteratorAll(e[symbolIterator](),r):"function"==typeof e[symbolAsyncIterator]?asyncIteratorAll(e[symbolAsyncIterator](),r,new Set):"function"==typeof e.reduce?e.reduce(reducerAll(r),!0):e.constructor==Object?arrayAll(objectValues(e),r):r(e)};export default all;
+const isPromise=r=>null!=r&&"function"==typeof r.then,areAnyValuesPromises=function(r){const n=r.length;let e=-1;for(;++e<n;){const n=r[e];if(isPromise(n))return!0}return!1},promiseAll=Promise.all.bind(Promise),isArray=Array.isArray,__=Symbol.for("placeholder"),curry2ResolveArg0=(r,n)=>function(e){return r(e,n)},curry2ResolveArg1=(r,n)=>function(e){return r(n,e)},curry2=function(r,n,e){return n==__?curry2ResolveArg0(r,e):curry2ResolveArg1(r,n)},curryArgs2ResolveArgs0=(r,n,e)=>function(...e){return r(e,n)},curryArgs2ResolveArgs1=(r,n,e)=>function(...e){return r(n,e)},curryArgs2=function(r,n,e){return n==__?curryArgs2ResolveArgs0(r,e):curryArgs2ResolveArgs1(r,n)},functionArrayAll=function(r,n){const e=r.length,t=Array(e);let o=-1,u=!1;for(;++o<e;){const e=r[o](...n);isPromise(e)&&(u=!0),t[o]=e}return u?promiseAll(t):t},funcConcat=(r,n)=>function(...e){const t=r(...e);return isPromise(t)?t.then(n):n(t)},curry3ResolveArg0=(r,n,e)=>function(t){return r(t,n,e)},curry3ResolveArg1=(r,n,e)=>function(t){return r(n,t,e)},curry3ResolveArg2=(r,n,e)=>function(t){return r(n,e,t)},curry3=function(r,n,e,t){return n==__?curry3ResolveArg0(r,e,t):e==__?curry3ResolveArg1(r,n,t):curry3ResolveArg2(r,n,e)},curry4ResolveArg0=(r,n,e,t)=>function(o){return r(o,n,e,t)},curry4ResolveArg1=(r,n,e,t)=>function(o){return r(n,o,e,t)},curry4ResolveArg2=(r,n,e,t)=>function(o){return r(n,e,o,t)},curry4ResolveArg3=(r,n,e,t)=>function(o){return r(n,e,t,o)},curry4=function(r,n,e,t,o){return n==__?curry4ResolveArg0(r,e,t,o):e==__?curry4ResolveArg1(r,n,t,o):t==__?curry4ResolveArg2(r,n,e,o):curry4ResolveArg3(r,n,e,t)},objectSet=function(r,n,e){return r[n]=e,r},asyncFunctionArrayAllSeries=async function(r,n,e,t){const o=r.length;for(;++t<o;){const o=r[t](...n);e[t]=isPromise(o)?await o:o}return e},functionArrayAllSeries=function(r,n){const e=r.length,t=[];let o=-1;for(;++o<e;){const e=r[o](...n);if(isPromise(e))return e.then(funcConcat(curry3(objectSet,t,o,__),(u=asyncFunctionArrayAllSeries,s=n,l=__,i=o,(c=r)==__?curry4ResolveArg0(u,s,l,i):s==__?curry4ResolveArg1(u,c,l,i):l==__?curry4ResolveArg2(u,c,s,i):curry4ResolveArg3(u,c,s,l))));t[o]=e}var u,c,s,l,i;return t},always=r=>function(){return r},functionObjectAll=function(r,n){const e={},t=[];for(const o in r){const u=r[o](...n);isPromise(u)?t.push(u.then(curry3(objectSet,e,o,__))):e[o]=u}return 0==t.length?e:promiseAll(t).then((o=e,function(){return o}));var o},all=function(...r){const n=r.pop();return 0==r.length?isArray(n)?curryArgs2(functionArrayAll,n,__):curryArgs2(functionObjectAll,n,__):areAnyValuesPromises(r)?isArray(n)?promiseAll(r).then(curry2(functionArrayAll,n,__)):promiseAll(r).then(curry2(functionObjectAll,n,__)):isArray(n)?functionArrayAll(n,r):functionObjectAll(n,r)};all.series=function(...r){const n=r.pop();return 0==r.length?curryArgs2(functionArrayAllSeries,n,__):areAnyValuesPromises(r)?promiseAll(r).then(curry2(functionArrayAllSeries,n,__)):functionArrayAllSeries(n,r)};export default all;