rubico 2.1.0 → 2.2.0

package/es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.1.0
+ * rubico v2.2.0
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -125,12 +125,42 @@ const curry3 = function (baseFunc, arg0, arg1, arg2) {
   return curry3ResolveArg2(baseFunc, arg0, arg1)
 }
 
-const tap = func => function tapping(...args) {
+// 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)
+}
+
+// _tap(args Array, func function) -> Promise|any
+const _tap = function (args, func) {
   const result = args[0],
     call = func(...args)
   return isPromise(call) ? call.then(always(result)) : result
 }
 
+const tap = function (...args) {
+  const func = args.pop()
+  if (args.length == 0) {
+    return curryArgs2(_tap, __, func)
+  }
+  return _tap(args, func)
+}
+
 tap.if = (predicate, func) => function tappingIf(...args) {
   const predication = predicate(...args)
   if (isPromise(predication)) {
@@ -148,27 +178,6 @@ tap.if = (predicate, func) => function tappingIf(...args) {
 
 const isArray = Array.isArray
 
-// 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)
@@ -1447,43 +1456,45 @@ const callConcat = function (object, values) {
   return object.concat(values)
 }
 
-const identityTransform = function (collection, transducer, result) {
+const identityTransform = function (collection, transducer, accum) {
   const nil = genericReduce(collection, transducer(noop), null)
-  return isPromise(nil) ? nil.then(always(result)) : result
+  return isPromise(nil) ? nil.then(always(accum)) : accum
 }
 
-const genericTransform = function (collection, transducer, result) {
-  if (isArray(result)) {
-    return genericReduce(collection, transducer(arrayExtend), result)
+const genericTransform = function (collection, transducer, accum) {
+  if (isArray(accum)) {
+    return genericReduce(collection, transducer(arrayExtend), accum)
   }
-  if (isBinary(result)) {
+  if (isBinary(accum)) {
     const intermediateArray = genericReduce(collection, transducer(arrayExtend), [])
     return isPromise(intermediateArray)
-      ? intermediateArray.then(curry2(binaryExtend, result, __))
-      : binaryExtend(result, intermediateArray)
+      ? intermediateArray.then(curry2(binaryExtend, accum, __))
+      : binaryExtend(accum, intermediateArray)
   }
-  if (result == null) {
-    return identityTransform(collection, transducer, result)
+  if (accum == null) {
+    return identityTransform(collection, transducer, accum)
   }
 
-  const resultConstructor = result.constructor
-  if (typeof result == 'string' || resultConstructor == String) {
-    // TODO: use array + join over adding
-    return genericReduce(collection, transducer(add), result)
+  const constructor = accum.constructor
+  if (typeof accum == 'string' || constructor == String) {
+    const result = genericReduce(collection, transducer(arrayExtend), [accum])
+    return isPromise(result)
+      ? result.then(curry3(callPropUnary, __, 'join', ''))
+      : result.join('')
   }
-  if (typeof result.concat == 'function') {
-    return genericReduce(collection, transducer(callConcat), result)
+  if (typeof accum.concat == 'function') {
+    return genericReduce(collection, transducer(callConcat), accum)
   }
-  if (typeof result.write == 'function') {
-    return genericReduce(collection, transducer(streamExtend), result)
+  if (typeof accum.write == 'function') {
+    return genericReduce(collection, transducer(streamExtend), accum)
   }
-  if (resultConstructor == Set) {
-    return genericReduce(collection, transducer(setExtend), result)
+  if (constructor == Set) {
+    return genericReduce(collection, transducer(setExtend), accum)
   }
-  if (resultConstructor == Object) {
-    return genericReduce(collection, transducer(objectAssign), result)
+  if (constructor == Object) {
+    return genericReduce(collection, transducer(objectAssign), accum)
   }
-  return identityTransform(collection, transducer, result)
+  return identityTransform(collection, transducer, accum)
 }
 
 // _transform(collection any, transducer function, initialValue function|any) -> Promise

package/index.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.1.0
+ * rubico v2.2.0
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
@@ -131,12 +131,42 @@ const curry3 = function (baseFunc, arg0, arg1, arg2) {
   return curry3ResolveArg2(baseFunc, arg0, arg1)
 }
 
-const tap = func => function tapping(...args) {
+// 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)
+}
+
+// _tap(args Array, func function) -> Promise|any
+const _tap = function (args, func) {
   const result = args[0],
     call = func(...args)
   return isPromise(call) ? call.then(always(result)) : result
 }
 
+const tap = function (...args) {
+  const func = args.pop()
+  if (args.length == 0) {
+    return curryArgs2(_tap, __, func)
+  }
+  return _tap(args, func)
+}
+
 tap.if = (predicate, func) => function tappingIf(...args) {
   const predication = predicate(...args)
   if (isPromise(predication)) {
@@ -154,27 +184,6 @@ tap.if = (predicate, func) => function tappingIf(...args) {
 
 const isArray = Array.isArray
 
-// 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)
@@ -1453,43 +1462,45 @@ const callConcat = function (object, values) {
   return object.concat(values)
 }
 
-const identityTransform = function (collection, transducer, result) {
+const identityTransform = function (collection, transducer, accum) {
   const nil = genericReduce(collection, transducer(noop), null)
-  return isPromise(nil) ? nil.then(always(result)) : result
+  return isPromise(nil) ? nil.then(always(accum)) : accum
 }
 
-const genericTransform = function (collection, transducer, result) {
-  if (isArray(result)) {
-    return genericReduce(collection, transducer(arrayExtend), result)
+const genericTransform = function (collection, transducer, accum) {
+  if (isArray(accum)) {
+    return genericReduce(collection, transducer(arrayExtend), accum)
   }
-  if (isBinary(result)) {
+  if (isBinary(accum)) {
     const intermediateArray = genericReduce(collection, transducer(arrayExtend), [])
     return isPromise(intermediateArray)
-      ? intermediateArray.then(curry2(binaryExtend, result, __))
-      : binaryExtend(result, intermediateArray)
+      ? intermediateArray.then(curry2(binaryExtend, accum, __))
+      : binaryExtend(accum, intermediateArray)
   }
-  if (result == null) {
-    return identityTransform(collection, transducer, result)
+  if (accum == null) {
+    return identityTransform(collection, transducer, accum)
   }
 
-  const resultConstructor = result.constructor
-  if (typeof result == 'string' || resultConstructor == String) {
-    // TODO: use array + join over adding
-    return genericReduce(collection, transducer(add), result)
+  const constructor = accum.constructor
+  if (typeof accum == 'string' || constructor == String) {
+    const result = genericReduce(collection, transducer(arrayExtend), [accum])
+    return isPromise(result)
+      ? result.then(curry3(callPropUnary, __, 'join', ''))
+      : result.join('')
   }
-  if (typeof result.concat == 'function') {
-    return genericReduce(collection, transducer(callConcat), result)
+  if (typeof accum.concat == 'function') {
+    return genericReduce(collection, transducer(callConcat), accum)
   }
-  if (typeof result.write == 'function') {
-    return genericReduce(collection, transducer(streamExtend), result)
+  if (typeof accum.write == 'function') {
+    return genericReduce(collection, transducer(streamExtend), accum)
   }
-  if (resultConstructor == Set) {
-    return genericReduce(collection, transducer(setExtend), result)
+  if (constructor == Set) {
+    return genericReduce(collection, transducer(setExtend), accum)
   }
-  if (resultConstructor == Object) {
-    return genericReduce(collection, transducer(objectAssign), result)
+  if (constructor == Object) {
+    return genericReduce(collection, transducer(objectAssign), accum)
   }
-  return identityTransform(collection, transducer, result)
+  return identityTransform(collection, transducer, accum)
 }
 
 // _transform(collection any, transducer function, initialValue function|any) -> Promise

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rubico",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "[a]synchronous functional programming",
   "author": "Richard Tong",
   "license": "MIT",
@@ -9,7 +9,48 @@
     "type": "git",
     "url": "github:a-synchronous/rubico"
   },
-  "homepage": "https://rubico.land",
+  "homepage": "https://rubico.land/",
+  "files": [
+    "_internal",
+    "dist",
+    "x",
+    "index.js",
+    "es.js",
+    "global.js",
+    "pipe.js",
+    "compose.js",
+    "tap.js",
+    "forEach.js",
+    "switchCase.js",
+    "tryCatch.js",
+    "all.js",
+    "assign.js",
+    "get.js",
+    "set.js",
+    "pick.js",
+    "omit.js",
+    "map.js",
+    "filter.js",
+    "flatMap.js",
+    "reduce.js",
+    "transform.js",
+    "and.js",
+    "or.js",
+    "not.js",
+    "some.js",
+    "every.js",
+    "eq.js",
+    "gt.js",
+    "lt.js",
+    "gte.js",
+    "lte.js",
+    "thunkify.js",
+    "always.js",
+    "curry.js",
+    "__.js",
+    "AggregateReducer.js",
+    "Transducer.js"
+  ],
   "keywords": [
     "function-composition",
     "asynchronous",

package/tap.js

@@ -3,13 +3,22 @@ const always = require('./_internal/always')
 const thunkifyArgs = require('./_internal/thunkifyArgs')
 const thunkConditional = require('./_internal/thunkConditional')
 const curry3 = require('./_internal/curry3')
+const curryArgs2 = require('./_internal/curryArgs2')
 const __ = require('./_internal/placeholder')
 
+// _tap(args Array, func function) -> Promise|any
+const _tap = function (args, func) {
+  const result = args[0],
+    call = func(...args)
+  return isPromise(call) ? call.then(always(result)) : result
+}
+
 /**
  * @name tap
  *
  * @synopsis
  * ```coffeescript [specscript]
+ * tap(...args, func function) -> Promise|args[0]
  * tap(func function)(...args) -> Promise|args[0]
  * ```
  *
@@ -28,10 +37,12 @@ const __ = require('./_internal/placeholder')
  *                 // 'foobarbaz'
  * ```
  */
-const tap = func => function tapping(...args) {
-  const result = args[0],
-    call = func(...args)
-  return isPromise(call) ? call.then(always(result)) : result
+const tap = function (...args) {
+  const func = args.pop()
+  if (args.length == 0) {
+    return curryArgs2(_tap, __, func)
+  }
+  return _tap(args, func)
 }
 
 /**

package/.eslintignore

@@ -1,5 +0,0 @@
-archive
-dist
-es.js
-index.js
-benchmarks