rubico 2.7.3 → 2.7.4

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

package/_internal/reducerFilter.d.ts

@@ -12,8 +12,8 @@ export = reducerFilter;
  * ```
  *
  * @description
- * Filter items from a reducer's operation by predicate. `predicate` may be asynchronous.
+ * Filter elements from a reducer's operation by predicate. `predicate` may be asynchronous.
  *
  * Note: If the predicate is asynchronous, the implementation of reduce that consumes the filtering reducer must resolve promises
  */
-declare function reducerFilter(reducer: any, predicate: any): (result: any, item: any) => any;
+declare function reducerFilter(reducer: any, predicate: any): (result: any, element: any) => any;

package/_internal/reducerFilter.js

@@ -18,21 +18,21 @@ const always = require('./always')
  * ```
  *
  * @description
- * Filter items from a reducer's operation by predicate. `predicate` may be asynchronous.
+ * Filter elements from a reducer's operation by predicate. `predicate` may be asynchronous.
  *
  * Note: If the predicate is asynchronous, the implementation of reduce that consumes the filtering reducer must resolve promises
  */
 const reducerFilter = (
   reducer, predicate,
-) => function filteringReducer(result, item) {
-  const shouldInclude = predicate(item)
+) => function filteringReducer(result, element) {
+  const shouldInclude = predicate(element)
   return isPromise(shouldInclude)
     ? shouldInclude.then(curry3(
       thunkConditional,
       __,
-      thunkify2(reducer, result, item),
+      thunkify2(reducer, result, element),
       always(result)))
-    : shouldInclude ? reducer(result, item) : result
+    : shouldInclude ? reducer(result, element) : result
 }
 
 module.exports = reducerFilter

package/_internal/reducerFlatten.js

@@ -18,15 +18,15 @@ const genericReduce = require('./genericReduce')
  * ```
  *
  * @description
- * Create a flattening reducer - a reducer that flattens all items of a reducing operation into the result.
+ * Create a flattening reducer - a reducer that flattens all elements of a reducing operation into the result.
  *
  * @previously
  * flatteningTransducer
  */
 const reducerFlatten = reducer => function flatteningReducer(
-  result, reducerItem,
+  result, reducerElement,
 ) {
-  return genericReduce(reducerItem, reducer, result)
+  return genericReduce(reducerElement, reducer, result)
 }
 
 module.exports = reducerFlatten

package/_internal/reducerForEach.d.ts

@@ -13,6 +13,6 @@ export = reducerForEach;
  * ```
  *
  * @description
- * Create a reducer that additionally executes a callback for each item of its reducing operation.
+ * Create a reducer that additionally executes a callback for each element of its reducing operation.
  */
-declare function reducerForEach(reducer: any, callback: any): (result: any, item: any) => any;
+declare function reducerForEach(reducer: any, callback: any): (result: any, element: any) => any;

package/_internal/reducerForEach.js

@@ -15,16 +15,16 @@ const thunkify2 = require('./thunkify2')
  * ```
  *
  * @description
- * Create a reducer that additionally executes a callback for each item of its reducing operation.
+ * Create a reducer that additionally executes a callback for each element of its reducing operation.
  */
 const reducerForEach = (
   reducer, callback,
-) => function executingForEach(result, item) {
-  const operation = callback(item)
+) => function executingForEach(result, element) {
+  const operation = callback(element)
   if (isPromise(operation)) {
-    return operation.then(thunkify2(reducer, result, item))
+    return operation.then(thunkify2(reducer, result, element))
   }
-  return reducer(result, item)
+  return reducer(result, element)
 }
 
 module.exports = reducerForEach

package/_internal/reducerMap.d.ts

@@ -16,4 +16,4 @@ export = reducerMap;
  *
  * Note: If the mapper is asynchronous, the implementation of reduce that consumes the mapping reducer must resolve promises
  */
-declare function reducerMap(reducer: any, mapper: any): (result: any, reducerItem: any) => any;
+declare function reducerMap(reducer: any, mapper: any): (result: any, reducerElement: any) => any;