rubico 2.7.3 → 2.7.5

package/_internal/generatorFunctionReduce.js

@@ -19,7 +19,7 @@ const iteratorReduce = require('./iteratorReduce')
  * ```
  *
  * @description
- * Execute a reducer for each item of a generator function, returning a single value.
+ * Execute a reducer for each element of a generator function, returning a single value.
  */
 const generatorFunctionReduce = (
   generatorFunction, reducer, result,

package/_internal/iteratorEvery.js

@@ -16,8 +16,8 @@ const callPropUnary = require('./callPropUnary')
  */
 const iteratorEvery = function (iterator, predicate) {
   const promises = []
-  for (const item of iterator) {
-    const predication = predicate(item)
+  for (const element of iterator) {
+    const predication = predicate(element)
     if (isPromise(predication)) {
       promises.push(predication)
     } else if (!predication) {

package/_internal/iteratorFind.js

@@ -18,13 +18,13 @@ const always = require('./always')
 const iteratorFindAsync = async function (iterator, predicate) {
   let iteration = iterator.next()
   while (!iteration.done) {
-    const item = iteration.value
-    let predication = predicate(item)
+    const element = iteration.value
+    let predication = predicate(element)
     if (isPromise(predication)) {
       predication = await predication
     }
     if (predication) {
-      return item
+      return element
     }
     iteration = iterator.next()
   }
@@ -44,16 +44,16 @@ const iteratorFindAsync = async function (iterator, predicate) {
 const iteratorFind = function (iterator, predicate) {
   let iteration = iterator.next()
   while (!iteration.done) {
-    const item = iteration.value,
-      predication = predicate(item)
+    const element = iteration.value,
+      predication = predicate(element)
     if (isPromise(predication)) {
       return predication.then(curry3(
         thunkConditional,
         __,
-        always(item),
+        always(element),
         thunkify2(iteratorFindAsync, iterator, predicate)))
     } else if (predication) {
-      return item
+      return element
     }
     iteration = iterator.next()
   }

package/_internal/iteratorForEach.d.ts

@@ -12,7 +12,7 @@ export = iteratorForEach;
  * ```
  *
  * @description
- * Call a callback for each item of an iterator. Return a promise if any executions are asynchronous.
+ * Call a callback for each element of an iterator. Return a promise if any executions are asynchronous.
  *
  * Note: iterator is consumed
  */

package/_internal/iteratorForEach.js

@@ -15,14 +15,14 @@ const always = require('./always')
  * ```
  *
  * @description
- * Call a callback for each item of an iterator. Return a promise if any executions are asynchronous.
+ * Call a callback for each element of an iterator. Return a promise if any executions are asynchronous.
  *
  * Note: iterator is consumed
  */
 const iteratorForEach = function (iterator, callback) {
   const promises = []
-  for (const item of iterator) {
-    const operation = callback(item)
+  for (const element of iterator) {
+    const operation = callback(element)
     if (isPromise(operation)) {
       promises.push(operation)
     }

package/_internal/iteratorForEachSeries.js

@@ -26,7 +26,7 @@ const _iteratorForEachSeriesAsync = async function (iterator, callback) {
  * ```
  *
  * @description
- * Call a callback for each item of an iterator. Return a promise if any executions are asynchronous.
+ * Call a callback for each element of an iterator. Return a promise if any executions are asynchronous.
  *
  * Note: iterator is consumed
  */

package/_internal/iteratorReduce.d.ts

@@ -13,6 +13,6 @@ export = iteratorReduce;
  * ```
  *
  * @description
- * Execute a reducer for each item of an iterator, returning a single value.
+ * Execute a reducer for each element of an iterator, returning a single value.
  */
 declare function iteratorReduce(iterator: any, reducer: any, result: any): any;

package/_internal/iteratorReduce.js

@@ -16,7 +16,7 @@ const isPromise = require('./isPromise')
  * ```
  *
  * @description
- * Execute a reducer for each item of an iterator or async iterator, returning a promise of a single value.
+ * Execute a reducer for each element of an iterator or async iterator, returning a promise of a single value.
  */
 const iteratorReduceAsync = async function (
   iterator, reducer, result,
@@ -50,7 +50,7 @@ const iteratorReduceAsync = async function (
  * ```
  *
  * @description
- * Execute a reducer for each item of an iterator, returning a single value.
+ * Execute a reducer for each element of an iterator, returning a single value.
  */
 const iteratorReduce = function (iterator, reducer, result) {
   let iteration = iterator.next()

package/_internal/iteratorSome.js

@@ -14,8 +14,8 @@ const isPromise = require('./isPromise')
  * ```
  */
 const iteratorSome = function (iterator, predicate) {
-  for (const item of iterator) {
-    const predication = predicate(item)
+  for (const element of iterator) {
+    const predication = predicate(element)
     if (isPromise(predication)) {
       return asyncIteratorSome(
         iterator, predicate, new Set([SelfReferencingPromise(predication)]))

package/_internal/mapFilter.js

@@ -30,15 +30,15 @@ const promiseAll = require('./promiseAll')
 const mapFilter = function (map, predicate) {
   const result = new Map(),
     promises = []
-  for (const [key, item] of map) {
-    const predication = predicate(item, key, map)
+  for (const [key, element] of map) {
+    const predication = predicate(element, key, map)
     if (isPromise(predication)) {
       promises.push(predication.then(curry3(thunkConditional,
         __,
-        thunkify4(callPropBinary, result, 'set', key, item),
+        thunkify4(callPropBinary, result, 'set', key, element),
         noop)))
     } else if (predication) {
-      result.set(key, item)
+      result.set(key, element)
     }
   }
   return promises.length == 0 ? result

package/_internal/mapMap.d.ts

@@ -6,7 +6,7 @@ export = mapMap;
  * ```coffeescript [specscript]
  * mapMap(
  *   value Map,
- *   mapper (item any, key any, value)=>Promise|any
+ *   mapper (element any, key any, value)=>Promise|any
  * ) -> Promise|Map<any=>any>
  * ```
  *

package/_internal/mapMap.js

@@ -12,7 +12,7 @@ const callPropBinary = require('./callPropBinary')
  * ```coffeescript [specscript]
  * mapMap(
  *   value Map,
- *   mapper (item any, key any, value)=>Promise|any
+ *   mapper (element any, key any, value)=>Promise|any
  * ) -> Promise|Map<any=>any>
  * ```
  *
@@ -22,13 +22,13 @@ const callPropBinary = require('./callPropBinary')
 const mapMap = function (value, mapper) {
   const result = new Map(),
     promises = []
-  for (const [key, item] of value) {
-    const resultItem = mapper(item, key, value)
-    if (isPromise(resultItem)) {
-      promises.push(resultItem.then(
+  for (const [key, element] of value) {
+    const resultElement = mapper(element, key, value)
+    if (isPromise(resultElement)) {
+      promises.push(resultElement.then(
         curry4(callPropBinary, result, 'set', key, __)))
     } else {
-      result.set(key, resultItem)
+      result.set(key, resultElement)
     }
   }
   return promises.length == 0

package/_internal/mapMapPool.js

@@ -27,16 +27,16 @@ const _mapMapPoolAsync = async function (
       await promiseRace(promises)
     }
     const key = iteration.value[0]
-    const resultItem = f(iteration.value[1], key, m)
-    if (isPromise(resultItem)) {
-      result.set(key, resultItem)
-      const selfDeletingPromise = resultItem.then(resolvedValue => {
+    const resultElement = f(iteration.value[1], key, m)
+    if (isPromise(resultElement)) {
+      result.set(key, resultElement)
+      const selfDeletingPromise = resultElement.then(resolvedValue => {
         promises.delete(selfDeletingPromise)
         result.set(key, resolvedValue)
       })
       promises.add(selfDeletingPromise)
     } else {
-      result.set(key, resultItem)
+      result.set(key, resultElement)
     }
     iteration = iterator.next()
   }
@@ -60,18 +60,18 @@ const mapMapPool = function (m, concurrency, f) {
   let iteration = iterator.next()
   while (!iteration.done) {
     const key = iteration.value[0]
-    const resultItem = f(iteration.value[1], key, m)
-    if (isPromise(resultItem)) {
+    const resultElement = f(iteration.value[1], key, m)
+    if (isPromise(resultElement)) {
       const promises = new Set()
-      result.set(key, resultItem)
-      const selfDeletingPromise = resultItem.then(resolvedValue => {
+      result.set(key, resultElement)
+      const selfDeletingPromise = resultElement.then(resolvedValue => {
         promises.delete(selfDeletingPromise)
         result.set(key, resolvedValue)
       })
       promises.add(selfDeletingPromise)
       return _mapMapPoolAsync(m, iterator, concurrency, f, result, promises)
     }
-    result.set(key, resultItem)
+    result.set(key, resultElement)
     iteration = iterator.next()
   }
   return result

package/_internal/mapMapSeries.js

@@ -14,11 +14,11 @@ const symbolIterator = require('./symbolIterator')
 const _mapMapSeriesAsync = async function (iterator, f, result) {
   let iteration = iterator.next()
   while (!iteration.done) {
-    let resultItem = f(iteration.value[1])
-    if (isPromise(resultItem)) {
-      resultItem = await resultItem
+    let resultElement = f(iteration.value[1])
+    if (isPromise(resultElement)) {
+      resultElement = await resultElement
     }
-    result.set(iteration.value[0], resultItem)
+    result.set(iteration.value[0], resultElement)
     iteration = iterator.next()
   }
   return result
@@ -33,13 +33,13 @@ const _mapMapSeriesAsync = async function (iterator, f, result) {
  *   value any,
  *   key any,
  *   map Map
- * )=>(resultItem Promise|any)
+ * )=>(resultElement Promise|any)
  *
  * mapMapSeries(map Map, f MapMapper) -> Promise|Map
  * ```
  *
  * @description
- * Apply a mapper in series to each value of a Map, returning a new Map of mapped items. Mapper may be asynchronous.
+ * Apply a mapper in series to each value of a Map, returning a new Map of mapped elements. Mapper may be asynchronous.
  */
 const mapMapSeries = function (map, f) {
   const result = new Map()
@@ -47,14 +47,14 @@ const mapMapSeries = function (map, f) {
   let iteration = iterator.next()
   while (!iteration.done) {
     const key = iteration.value[0]
-    const resultItem = f(iteration.value[1])
-    if (isPromise(resultItem)) {
-      return resultItem.then(funcConcat(
+    const resultElement = f(iteration.value[1])
+    if (isPromise(resultElement)) {
+      return resultElement.then(funcConcat(
         curry3(mapSet, result, key, __),
         thunkify3(_mapMapSeriesAsync, iterator, f, result),
       ))
     }
-    result.set(key, resultItem)
+    result.set(key, resultElement)
     iteration = iterator.next()
   }
   return result

package/_internal/objectFilter.js

@@ -20,13 +20,13 @@ const objectFilter = function (object, predicate) {
   const result = {},
     promises = []
   for (const key in object) {
-    const item = object[key],
-      shouldIncludeItem = predicate(item, key, object)
-    if (isPromise(shouldIncludeItem)) {
-      promises.push(shouldIncludeItem.then(
+    const element = object[key],
+      shouldIncludeElement = predicate(element, key, object)
+    if (isPromise(shouldIncludeElement)) {
+      promises.push(shouldIncludeElement.then(
         curry4(objectSetIf, result, key, object[key], __)))
-    } else if (shouldIncludeItem) {
-      result[key] = item
+    } else if (shouldIncludeElement) {
+      result[key] = element
     }
   }
   return promises.length == 0

package/_internal/objectFlatMap.d.ts

@@ -19,7 +19,7 @@ export = objectFlatMap;
  * ```
  *
  * @description
- * Apply a flatMapper to each value of an object, assigning all items of all results into a new object.
+ * Apply a flatMapper to each value of an object, assigning all elements of all results into a new object.
  *
  * @TODO "deeply copies" after objectFlatten changes to deep assignment
  */

package/_internal/objectFlatMap.js

@@ -22,7 +22,7 @@ const objectFlatten = require('./objectFlatten')
  * ```
  *
  * @description
- * Apply a flatMapper to each value of an object, assigning all items of all results into a new object.
+ * Apply a flatMapper to each value of an object, assigning all elements of all results into a new object.
  *
  * @TODO "deeply copies" after objectFlatten changes to deep assignment
  */

package/_internal/objectFlatten.js

@@ -37,31 +37,31 @@ const objectFlatten = function (object) {
     getResult = () => result
 
   for (const key in object) {
-    const item = object[key]
-    if (item == null) {
+    const element = object[key]
+    if (element == null) {
       continue
-    } else if (typeof item[symbolIterator] == 'function') {
-      for (const monadItem of item) {
-        objectAssign(result, monadItem)
+    } else if (typeof element[symbolIterator] == 'function') {
+      for (const monadElement of element) {
+        objectAssign(result, monadElement)
       }
-    } else if (typeof item[symbolAsyncIterator] == 'function') {
+    } else if (typeof element[symbolAsyncIterator] == 'function') {
       promises.push(
-        asyncIteratorForEach(item[symbolAsyncIterator](), resultAssign))
-    } else if (typeof item.chain == 'function') {
-      const monadValue = item.chain(identity)
+        asyncIteratorForEach(element[symbolAsyncIterator](), resultAssign))
+    } else if (typeof element.chain == 'function') {
+      const monadValue = element.chain(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(resultAssign))
         : objectAssign(result, monadValue)
-    } else if (typeof item.flatMap == 'function') {
-      const monadValue = item.flatMap(identity)
+    } else if (typeof element.flatMap == 'function') {
+      const monadValue = element.flatMap(identity)
       isPromise(monadValue)
         ? promises.push(monadValue.then(resultAssign))
         : resultAssign(monadValue)
-    } else if (typeof item.reduce == 'function') {
-      const folded = item.reduce(resultAssignReducer, null)
+    } else if (typeof element.reduce == 'function') {
+      const folded = element.reduce(resultAssignReducer, null)
       isPromise(folded) && promises.push(folded)
     } else {
-      objectAssign(result, item)
+      objectAssign(result, element)
     }
   }
   return promises.length == 0

package/_internal/objectMap.js

@@ -20,11 +20,11 @@ const objectMap = function (object, mapper) {
   const result = {}
   let isAsync = false
   for (const key in object) {
-    const resultItem = mapper(object[key], key, object)
-    if (isPromise(resultItem)) {
+    const resultElement = mapper(object[key], key, object)
+    if (isPromise(resultElement)) {
       isAsync = true
     }
-    result[key] = resultItem
+    result[key] = resultElement
   }
   return isAsync ? promiseObjectAll(result) : result
 }

package/_internal/objectMapOwn.js

@@ -23,11 +23,11 @@ const objectMapOwn = function (object, mapper) {
   let isAsync = false
   for (const key in object) {
     if (hasOwn(object, key)) {
-      const resultItem = mapper(object[key])
-      if (isPromise(resultItem)) {
+      const resultElement = mapper(object[key])
+      if (isPromise(resultElement)) {
         isAsync = true
       }
-      result[key] = resultItem
+      result[key] = resultElement
     }
   }
   return isAsync ? promiseObjectAll(result) : result

package/_internal/objectMapPool.js

@@ -27,16 +27,16 @@ const _objectMapPoolAsync = async function (
     if (promises.size >= concurrency) {
       await promiseRace(promises)
     }
-    const resultItem = f(o[key], key, o)
-    if (isPromise(resultItem)) {
-      result[key] = resultItem
-      const selfDeletingPromise = resultItem.then(resolvedValue => {
+    const resultElement = f(o[key], key, o)
+    if (isPromise(resultElement)) {
+      result[key] = resultElement
+      const selfDeletingPromise = resultElement.then(resolvedValue => {
         promises.delete(selfDeletingPromise)
         result[key] = resolvedValue
       })
       promises.add(selfDeletingPromise)
     } else {
-      result[key] = resultItem
+      result[key] = resultElement
     }
   }
   if (promises.size > 0) {
@@ -58,18 +58,18 @@ const objectMapPool = function (o, concurrency, f) {
   const doneKeys = {}
   for (const key in o) {
     doneKeys[key] = true
-    const resultItem = f(o[key], key, o)
-    if (isPromise(resultItem)) {
+    const resultElement = f(o[key], key, o)
+    if (isPromise(resultElement)) {
       const promises = new Set()
-      result[key] = resultItem
-      const selfDeletingPromise = resultItem.then(resolvedValue => {
+      result[key] = resultElement
+      const selfDeletingPromise = resultElement.then(resolvedValue => {
         promises.delete(selfDeletingPromise)
         result[key] = resolvedValue
       })
       promises.add(selfDeletingPromise)
       return _objectMapPoolAsync(o, concurrency, f, result, doneKeys, promises)
     }
-    result[key] = resultItem
+    result[key] = resultElement
   }
   return result
 }

package/_internal/objectMapSeries.js

@@ -17,11 +17,11 @@ const _objectMapSeriesAsync = async function (object, f, result, doneKeys) {
     if (key in doneKeys) {
       continue
     }
-    let resultItem = f(object[key])
-    if (isPromise(resultItem)) {
-      resultItem = await resultItem
+    let resultElement = f(object[key])
+    if (isPromise(resultElement)) {
+      resultElement = await resultElement
     }
-    result[key] = resultItem
+    result[key] = resultElement
   }
   return result
 }
@@ -35,7 +35,7 @@ const _objectMapSeriesAsync = async function (object, f, result, doneKeys) {
  *   value any,
  *   key string,
  *   collection Object
- * )=>(resultItem Promise|any)
+ * )=>(resultElement Promise|any)
  *
  * objectMapSeries(object Object, f ObjectMapper) -> Promise|Object
  * ```
@@ -48,14 +48,14 @@ const objectMapSeries = function (object, f) {
   const doneKeys = {}
   for (const key in object) {
     doneKeys[key] = true
-    const resultItem = f(object[key], key, object)
-    if (isPromise(resultItem)) {
-      return resultItem.then(funcConcat(
+    const resultElement = f(object[key], key, object)
+    if (isPromise(resultElement)) {
+      return resultElement.then(funcConcat(
         curry3(objectSet, result, key, __),
         thunkify4(_objectMapSeriesAsync, object, f, result, doneKeys),
       ))
     }
-    result[key] = resultItem
+    result[key] = resultElement
   }
   return result
 }

package/_internal/objectReduce.d.ts

@@ -6,7 +6,7 @@ export = objectReduce;
  * ```coffeescript [specscript]
  * objectReduce(
  *   object Object,
- *   reducer (any, item any, key string, object)=>Promise|any,
+ *   reducer (any, element any, key string, object)=>Promise|any,
  *   result any,
  * ) -> Promise|result
  * ```

package/_internal/objectReduce.js

@@ -10,7 +10,7 @@ const objectKeys = require('./objectKeys')
  * ```coffeescript [specscript]
  * objectReduceAsync(
  *   object Object,
- *   reducer (any, item any, key string, object)=>Promise|any,
+ *   reducer (any, element any, key string, object)=>Promise|any,
  *   result any,
  * ) -> Promise<result>
  * ```
@@ -34,7 +34,7 @@ const objectReduceAsync = async function (object, reducer, result, keys, index)
  * ```coffeescript [specscript]
  * objectReduce(
  *   object Object,
- *   reducer (any, item any, key string, object)=>Promise|any,
+ *   reducer (any, element any, key string, object)=>Promise|any,
  *   result any,
  * ) -> Promise|result
  * ```

package/_internal/reducerAllSync.d.ts

@@ -4,7 +4,7 @@ export = reducerAllSync;
  *
  * @synopsis
  * ```coffeescript [specscript]
- * reducerAllSync(predicate any=> boolean, result boolean, item any) -> boolean
+ * reducerAllSync(predicate any=> boolean, result boolean, element any) -> boolean
  * ```
  */
-declare function reducerAllSync(predicate: any, result: any, item: any): any;
+declare function reducerAllSync(predicate: any, result: any, element: any): any;

package/_internal/reducerAllSync.js

@@ -3,9 +3,9 @@
  *
  * @synopsis
  * ```coffeescript [specscript]
- * reducerAllSync(predicate any=> boolean, result boolean, item any) -> boolean
+ * reducerAllSync(predicate any=> boolean, result boolean, element any) -> boolean
  * ```
  */
-const reducerAllSync = (predicate, result, item) => result ? predicate(item) : false
+const reducerAllSync = (predicate, result, element) => result ? predicate(element) : false
 
 module.exports = reducerAllSync

package/_internal/reducerAnySync.d.ts

@@ -7,4 +7,4 @@ export = reducerAnySync;
  * reducerAnySync(predicate T=>boolean) -> anyReducer (any, any)=>any
  * ```
  */
-declare function reducerAnySync(predicate: any): (result: any, item: any) => any;
+declare function reducerAnySync(predicate: any): (result: any, element: any) => any;

package/_internal/reducerAnySync.js

@@ -6,8 +6,8 @@
  * reducerAnySync(predicate T=>boolean) -> anyReducer (any, any)=>any
  * ```
  */
-const reducerAnySync = predicate => function anyReducer(result, item) {
-  return result ? true : predicate(item)
+const reducerAnySync = predicate => function anyReducer(result, element) {
+  return result ? true : predicate(element)
 }
 
 module.exports = reducerAnySync

package/_internal/reducerConcat.d.ts

@@ -12,4 +12,4 @@ export = reducerConcat;
  * >(reducerA, reducerB) -> pipedReducer (any, T)=>Promise|any
  * ```
  */
-declare function reducerConcat(reducerA: any, reducerB: any): (result: any, item: any) => any;
+declare function reducerConcat(reducerA: any, reducerB: any): (result: any, element: any) => any;

package/_internal/reducerConcat.js

@@ -17,11 +17,11 @@ const curry2 = require('./curry2')
  */
 const reducerConcat = (
   reducerA, reducerB,
-) => function pipedReducer(result, item) {
-  const intermediate = reducerA(result, item)
+) => function pipedReducer(result, element) {
+  const intermediate = reducerA(result, element)
   return isPromise(intermediate)
-    ? intermediate.then(curry2(reducerB, __, item))
-    : reducerB(intermediate, item)
+    ? intermediate.then(curry2(reducerB, __, element))
+    : reducerB(intermediate, element)
 }
 
 module.exports = reducerConcat

package/_internal/reducerConcatSync.js

@@ -9,8 +9,8 @@
  */
 const reducerConcatSync = (
   reducerA, reducerB,
-) => function pipedReducer(result, item) {
-  return reducerB(reducerA(result, item), item)
+) => function pipedReducer(result, element) {
+  return reducerB(reducerA(result, element), element)
 }
 
 module.exports = reducerConcatSync

package/_internal/reducerEvery.d.ts

@@ -6,7 +6,7 @@ export = reducerEvery;
  * ```coffeescript [specscript]
  * reducerEvery(
  *   predicate any=>boolean,
- * ) -> reducer(result boolean, item any)=>boolean
+ * ) -> reducer(result boolean, element any)=>boolean
  * ```
  */
-declare function reducerEvery(predicate: any): (result: any, item: any) => any;
+declare function reducerEvery(predicate: any): (result: any, element: any) => any;

package/_internal/reducerEvery.js

@@ -10,14 +10,14 @@ const reducerAllSync = require('./reducerAllSync')
  * ```coffeescript [specscript]
  * reducerEvery(
  *   predicate any=>boolean,
- * ) -> reducer(result boolean, item any)=>boolean
+ * ) -> reducer(result boolean, element any)=>boolean
  * ```
  */
-const reducerEvery = predicate => function allReducer(result, item) {
+const reducerEvery = predicate => function allReducer(result, element) {
   return result === false ? false
     : isPromise(result) ? result.then(
-      curry3(reducerAllSync, predicate, __, item))
-    : result ? predicate(item) : false
+      curry3(reducerAllSync, predicate, __, element))
+    : result ? predicate(element) : false
 }
 
 module.exports = reducerEvery