rubico 2.2.3 → 2.3.1

package/AggregateReducer.d.ts

@@ -0,0 +1,10 @@
+export = AggregateReducer;
+/**
+ * @name AggregateReducer
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * AggregateReducer(reducers Array<reducer function>) -> aggregateReducer function
+ * ```
+ */
+declare function AggregateReducer(reducers: any): any;

package/README.md

@@ -6,7 +6,6 @@
 [![codecov](https://codecov.io/gh/a-synchronous/rubico/branch/master/graph/badge.svg)](https://codecov.io/gh/a-synchronous/rubico)
 [![npm version](https://img.shields.io/npm/v/rubico.svg?style=flat)](https://www.npmjs.com/package/rubico)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Gitter](https://badges.gitter.im/Join_Chat.svg)](https://gitter.im/a-synchronous/rubico)
 
 ### [a]synchronous functional programming
 

package/Transducer.d.ts

@@ -0,0 +1,231 @@
+/**
+ * @name Transducer.map
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.map(mapperFunc function) -> mappingTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates a mapping transducer. Items in the final reducing operation are transformed by the mapper function. It is possible to use an asynchronous mapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const square = number => number ** 2
+ *
+ * const concat = (array, item) => array.concat(item)
+ *
+ * const mapSquare = Transducer.map(square)
+ * // mapSquare is a transducer
+ *
+ * const squareConcatReducer = mapSquare(concat)
+ * // now mapSquare is passed the reducer function concat; squareConcatReducer
+ * // is a reducer with chained functionality square and concat
+ *
+ * console.log(
+ *   reduce([1, 2, 3, 4, 5], squareConcatReducer, [])
+ * ) // [1, 4, 9, 16, 25]
+ *
+ * // the same squareConcatReducer is consumable with vanilla JavaScript
+ * console.log(
+ *   [1, 2, 3, 4, 5].reduce(squareConcatReducer, [])
+ * ) // [1, 4, 9, 16, 25]
+ *
+ * // concat is implicit when transforming into arrays
+ * console.log(
+ *   transform([1, 2, 3, 4, 5], Transducer.map(square), [])
+ * ) // [1, 4, 9, 16, 25]
+ * ```
+ *
+ * Read more on transducers [here](/blog/transducers-crash-course-rubico-v2).
+ */
+export function map(mapper: any): (arg0: any) => any;
+/**
+ * @name Transducer.filter
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.filter(predicate function) -> filteringTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates a filtering transducer. A filtering reducer skips items of reducing operation if they test falsy by the predicate. It is possible to use an asynchronous predicate, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const isOdd = number => number % 2 == 1
+ *
+ * const concat = (array, item) => array.concat(item)
+ *
+ * const concatOddNumbers = filter(isOdd)(concat)
+ *
+ * console.log(
+ *   [1, 2, 3, 4, 5].reduce(concatOddNumbers, []),
+ * ) // [1, 3, 5]
+ * ```
+ */
+export function filter(predicate: any): (arg0: any) => any;
+/**
+ * @name Transducer.flatMap
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.flatMap(flatMapper) -> flatMappingTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates a flatMapping transducer. A flatMapping transducer applies the flatMapping function to each item of the reducing operation, concatenating the results of the flatMapper execution into the final result. It is possible to use an asynchronous flatMapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const powers = number => [number, number ** 2, number ** 3]
+ *
+ * const numbers = [1, 2, 3, 4, 5]
+ *
+ * console.log(
+ *   transform(numbers, Transducer.flatMap(powers), [])
+ * ) // [1, 1, 1, 2, 4, 8, 3, 9, 27, 4, 16, 64, 5, 25, 125]
+ * ```
+ *
+ * Read more on transducers [here](/blog/transducers-crash-course-rubico-v2).
+ */
+export function flatMap(flatMapper: any): (arg0: any) => any;
+/**
+ * @name Transducer.forEach
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.forEach(func function) -> forEachTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates an effectful pasthrough transducer. The effectful passthrough transducer applies the effectful function to each item of the reducing operation, leaving the reducing operation unchanged. It is possible to use an asynchronous effectful function, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const numbers = [1, 2, 3, 4, 5]
+ * transform(numbers, compose([
+ *   Transducer.map(number => number ** 2),
+ *   Transducer.forEach(console.log), // 1 4 9 16 25
+ * ]), null)
+ * ```
+ */
+export function forEach(func: any): (arg0: any) => any;
+/**
+ * @name Transducer.passthrough
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.passthrough(func function) -> passthroughTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates a pasthrough transducer. The passthrough transducer passes each item of the reducing operation through, leaving the reducing operation unchanged.
+ *
+ * ```javascript [playground]
+ * const createAsyncNumbers = async function* () {
+ *   let number = 0
+ *   while (number < 10) {
+ *     yield number
+ *     number += 1
+ *   }
+ * }
+ *
+ * transform(createAsyncNumbers(), Transducer.passthrough, [])
+ *   .then(console.log) // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+ * ```
+ */
+export function passthrough(reducer: any): any;
+/**
+ * @name Transducer.tryCatch
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * type Reducer = (
+ *   accumulator any,
+ *   item any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
+ * type Transducer = Reducer=>Reducer
+ *
+ * Transducer.tryCatch(
+ *   transducerTryer Transducer,
+ *   catcher (error Error, item any)=>Promise|any,
+ * ) -> tryCatchTransducer Transducer
+ * ```
+ *
+ * @description
+ * Creates an error handling transducer. The error handling transducer wraps a transducer and catches any errors thrown by the transducer with the catcher function. The catcher function is provided the error as well as the original item (before any processing by the transducer) for which the error was thrown. It is possible for either the transducer or the catcher to be asynchronous, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const db = new Map()
+ * db.set('a', { id: 'a', name: 'George' })
+ * db.set('b', { id: 'b', name: 'Jane' })
+ * db.set('c', { id: 'c', name: 'Jill' })
+ * db.set('e', { id: 'e', name: 'Jim' })
+ *
+ * const userIds = ['a', 'b', 'c', 'd', 'e']
+ *
+ * transform(userIds, Transducer.tryCatch(compose([
+ *   Transducer.map(async userId => {
+ *     if (db.has(userId)) {
+ *       return db.get(userId)
+ *     }
+ *     throw new Error(`user ${userId} not found`)
+ *   }),
+ *
+ *   Transducer.forEach(user => {
+ *     console.log('Found', user.name)
+ *   })
+ * ]), (error, userId) => {
+ *   console.error(error)
+ *   console.log('userId in catcher:', userId)
+ *   // original userId for which the error was thrown is provided
+ * }), null)
+ * ```
+
+ */
+export function tryCatch(transducerTryer: any, catcher: any): (arg0: any) => any;

package/Transducer.js

@@ -21,22 +21,20 @@ const Transducer = {}
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
  * Transducer.map(mapperFunc function) -> mappingTransducer Transducer
  * ```
  *
  * @description
- * Creates a mapping transducer with a provided reducer. A reducer is a variadic function that depicts a relationship between an accumulator and any number of arguments. A transducer is a function that accepts a reducer as an argument and returns another reducer.
- *
- * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
- *
- * type Transducer = Reducer=>Reducer
- * ```
- *
- * The transducer signature enables chaining functionality for reducers. `map` is core to this mechanism, and provides a way via transducers to transform the items of reducers.
+ * Creates a mapping transducer. Items in the final reducing operation are transformed by the mapper function. It is possible to use an asynchronous mapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const square = number => number ** 2
@@ -51,25 +49,21 @@ const Transducer = {}
  * // is a reducer with chained functionality square and concat
  *
  * console.log(
- *   [1, 2, 3, 4, 5].reduce(squareConcatReducer, []),
+ *   reduce([1, 2, 3, 4, 5], squareConcatReducer, [])
  * ) // [1, 4, 9, 16, 25]
  *
+ * // the same squareConcatReducer is consumable with vanilla JavaScript
  * console.log(
- *   [1, 2, 3, 4, 5].reduce(squareConcatReducer, ''),
- * ) // '1491625'
- * ```
- *
- * Create reducers with chained functionality by using the `Transducer.map` eager API.
- *
- * ```javascript [playground]
- * const square = number => number ** 2
- *
- * const concat = (array, item) => array.concat(item)
+ *   [1, 2, 3, 4, 5].reduce(squareConcatReducer, [])
+ * ) // [1, 4, 9, 16, 25]
  *
- * const squareConcatReducer = Transducer.map(concat, square)
- * // now mapSquare is passed the reducer function concat; squareConcatReducer
- * // is a reducer with chained functionality square and concat
+ * // concat is implicit when transforming into arrays
+ * console.log(
+ *   transform([1, 2, 3, 4, 5], Transducer.map(square), [])
+ * ) // [1, 4, 9, 16, 25]
  * ```
+ *
+ * Read more on transducers [here](/blog/transducers-crash-course-rubico-v2).
  */
 Transducer.map = function transducerMap(mapper) {
   return curry2(reducerMap, __, mapper)
@@ -80,14 +74,20 @@ Transducer.map = function transducerMap(mapper) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
  * Transducer.filter(predicate function) -> filteringTransducer Transducer
  * ```
  *
  * @description
- * A reducer in filterable position creates a filtering reducer - one that skips items of the reducer's reducing operation if they test falsy by the predicate. It is possible to use an asynchronous predicate when filtering a reducer, however the implementation of `reduce` must support asynchronous operations. This library provides such an implementation as `reduce`.
+ * Creates a filtering transducer. A filtering reducer skips items of reducing operation if they test falsy by the predicate. It is possible to use an asynchronous predicate, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
  * const isOdd = number => number % 2 == 1
@@ -110,33 +110,32 @@ Transducer.filter = function transducerFilter(predicate) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
  * Transducer.flatMap(flatMapper) -> flatMappingTransducer Transducer
  * ```
  *
  * @description
- * Additionally, `flatMap` is a powerful option when working with transducers. A flatMapping transducer applies a flatMapper to each item of a reducer's reducing operation, calling each item of each execution with the reducer.
+ * Creates a flatMapping transducer. A flatMapping transducer applies the flatMapping function to each item of the reducing operation, concatenating the results of the flatMapper execution into the final result. It is possible to use an asynchronous flatMapper, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
  *
  * ```javascript [playground]
- * const isOdd = number => number % 2 == 1
- *
  * const powers = number => [number, number ** 2, number ** 3]
  *
- * const oddPowers = pipe([
- *   filter(isOdd),
- *   flatMap(powers),
- * ])
- *
- * const arrayConcat = (array, value) => array.concat(value)
+ * const numbers = [1, 2, 3, 4, 5]
  *
  * console.log(
- *   reduce(oddPowers(arrayConcat), [])([1, 2, 3, 4, 5]),
- * ) // [1, 1, 1, 3, 9, 27, 5, 25, 125]
+ *   transform(numbers, Transducer.flatMap(powers), [])
+ * ) // [1, 1, 1, 2, 4, 8, 3, 9, 27, 4, 16, 64, 5, 25, 125]
  * ```
  *
- * In the case above, each item of the array of numbers returned by `powers` is called with the reducer `arrayConcat` for flattening into the final result.
+ * Read more on transducers [here](/blog/transducers-crash-course-rubico-v2).
  */
 Transducer.flatMap = function transducerFlatMap(flatMapper) {
   return curry2(reducerFlatMap, __, flatMapper)
@@ -147,11 +146,28 @@ Transducer.flatMap = function transducerFlatMap(flatMapper) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
  * Transducer.forEach(func function) -> forEachTransducer Transducer
  * ```
+ *
+ * @description
+ * Creates an effectful pasthrough transducer. The effectful passthrough transducer applies the effectful function to each item of the reducing operation, leaving the reducing operation unchanged. It is possible to use an asynchronous effectful function, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const numbers = [1, 2, 3, 4, 5]
+ * transform(numbers, compose([
+ *   Transducer.map(number => number ** 2),
+ *   Transducer.forEach(console.log), // 1 4 9 16 25
+ * ]), null)
+ * ```
  */
 Transducer.forEach = function transducerForEach(func) {
   return curry2(reducerForEach, __, func)
@@ -162,11 +178,33 @@ Transducer.forEach = function transducerForEach(func) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   value any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
  * Transducer.passthrough(func function) -> passthroughTransducer Transducer
  * ```
+ *
+ * @description
+ * Creates a pasthrough transducer. The passthrough transducer passes each item of the reducing operation through, leaving the reducing operation unchanged.
+ *
+ * ```javascript [playground]
+ * const createAsyncNumbers = async function* () {
+ *   let number = 0
+ *   while (number < 10) {
+ *     yield number
+ *     number += 1
+ *   }
+ * }
+ *
+ * transform(createAsyncNumbers(), Transducer.passthrough, [])
+ *   .then(console.log) // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+ * ```
  */
 Transducer.passthrough = function transducerPassthrough(reducer) {
   return reducer
@@ -177,11 +215,51 @@ Transducer.passthrough = function transducerPassthrough(reducer) {
  *
  * @synopsis
  * ```coffeescript [specscript]
- * type Reducer = (accumulator any, item any)=>(nextAccumulator Promise|any)
+ * type Reducer = (
+ *   accumulator any,
+ *   item any,
+ *   indexOrKey? number|string,
+ *   collection? Foldable,
+ * )=>(nextAccumulator Promise|any)
+ *
  * type Transducer = Reducer=>Reducer
  *
- * Transducer.tryCatch(func function) -> tryCatchTransducer Transducer
+ * Transducer.tryCatch(
+ *   transducerTryer Transducer,
+ *   catcher (error Error, item any)=>Promise|any,
+ * ) -> tryCatchTransducer Transducer
  * ```
+ *
+ * @description
+ * Creates an error handling transducer. The error handling transducer wraps a transducer and catches any errors thrown by the transducer with the catcher function. The catcher function is provided the error as well as the original item (before any processing by the transducer) for which the error was thrown. It is possible for either the transducer or the catcher to be asynchronous, however the reducing operation must support asynchronous execution. This library provides such implementations as [reduce](/docs/reduce) and [transform](/docs/transform).
+ *
+ * ```javascript [playground]
+ * const db = new Map()
+ * db.set('a', { id: 'a', name: 'George' })
+ * db.set('b', { id: 'b', name: 'Jane' })
+ * db.set('c', { id: 'c', name: 'Jill' })
+ * db.set('e', { id: 'e', name: 'Jim' })
+ *
+ * const userIds = ['a', 'b', 'c', 'd', 'e']
+ *
+ * transform(userIds, Transducer.tryCatch(compose([
+ *   Transducer.map(async userId => {
+ *     if (db.has(userId)) {
+ *       return db.get(userId)
+ *     }
+ *     throw new Error(`user ${userId} not found`)
+ *   }),
+ *
+ *   Transducer.forEach(user => {
+ *     console.log('Found', user.name)
+ *   })
+ * ]), (error, userId) => {
+ *   console.error(error)
+ *   console.log('userId in catcher:', userId)
+ *   // original userId for which the error was thrown is provided
+ * }), null)
+ * ```
+
  */
 Transducer.tryCatch = function transducerTryCatch(transducerTryer, catcher) {
   return curry3(reducerTryCatch, __, transducerTryer, catcher)

package/__.d.ts

@@ -0,0 +1,2 @@
+export = __;
+import __ = require("./_internal/placeholder");

package/_internal/ComparisonOperator.d.ts

@@ -0,0 +1,2 @@
+export = ComparisonOperator;
+declare function ComparisonOperator(comparator: any): (...args: any[]) => any;

package/_internal/EmptyMap.d.ts

@@ -0,0 +1,2 @@
+export = EmptyMap;
+declare function EmptyMap(): any;

package/_internal/FilteringAsyncIterator.d.ts

@@ -0,0 +1,29 @@
+export = FilteringAsyncIterator;
+/**
+ * @name FilteringAsyncIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * const filteringAsyncIterator = new FilteringAsyncIterator(
+ *   asyncIterator AsyncIterator<T>,
+ *   predicate T=>boolean,
+ * ) -> FilteringAsyncIterator<T>
+ *
+ * filteringAsyncIterator.next() -> { value: Promise, done: boolean }
+ * ```
+ */
+declare function FilteringAsyncIterator(asyncIterator: any, predicate: any): {
+    [x: number]: () => {
+        [x: number]: any;
+        isAsyncIteratorDone: boolean;
+        next(): Promise<{
+            value: any;
+            done: boolean;
+        }>;
+    };
+    isAsyncIteratorDone: boolean;
+    next(): Promise<{
+        value: any;
+        done: boolean;
+    }>;
+};

package/_internal/FilteringIterator.d.ts

@@ -0,0 +1,25 @@
+export = FilteringIterator;
+/**
+ * @name FilteringIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * FilteringIterator<
+ *   T any,
+ *   iterator Iterator<T>,
+ *   predicate T=>boolean, # no async
+ * >(iterator, predicate) -> filteringIterator Iterator<T>
+ *
+ * filteringIterator.next() -> { value: T, done: boolean }
+ * ```
+ *
+ * @description
+ * Creates a filtering iterator, i.e. an iterator that filteres a source iterator by predicate.
+ */
+declare function FilteringIterator(iterator: any, predicate: any): {
+    [x: number]: () => {
+        [x: number]: any;
+        next(): any;
+    };
+    next(): any;
+};

package/_internal/FlatMappingAsyncIterator.d.ts

@@ -0,0 +1,34 @@
+export = FlatMappingAsyncIterator;
+/**
+ * @name FlatMappingAsyncIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * new FlatMappingAsyncIterator(
+ *   asyncIterator AsyncIterator, flatMapper function,
+ * ) -> FlatMappingAsyncIterator AsyncIterator
+ * ```
+ *
+ * @execution concurrent
+ *
+ * @muxing
+ */
+declare function FlatMappingAsyncIterator(asyncIterator: any, flatMapper: any): {
+    [x: number]: () => any;
+    isAsyncIteratorDone: boolean;
+    toString(): string;
+    /**
+     * @name FlatMappingAsyncIterator.prototype.next
+     *
+     * @synopsis
+     * ```coffeescript [specscript]
+     * new FlatMappingAsyncIterator(
+     *   asyncIterator AsyncIterator, flatMapper function,
+     * ).next() -> Promise<{ value, done }>
+     * ```
+     */
+    next(): Promise<{
+        value: any;
+        done: boolean;
+    }>;
+};

package/_internal/FlatMappingIterator.d.ts

@@ -0,0 +1,15 @@
+export = FlatMappingIterator;
+/**
+ * @name FlatMappingIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * FlatMappingIterator(
+ *   iterator Iterator, flatMapper function,
+ * ) -> FlatMappingIterator { next, SymbolIterator }
+ * ```
+ */
+declare function FlatMappingIterator(iterator: any, flatMapper: any): {
+    [x: number]: () => any;
+    next(): any;
+};

package/_internal/MappingAsyncIterator.d.ts

@@ -0,0 +1,21 @@
+export = MappingAsyncIterator;
+/**
+ * @name MappingAsyncIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * mappingAsyncIterator = new MappingAsyncIterator(
+ *   asyncIter AsyncIterator<T>,
+ *   mapper T=>Promise|any,
+ * ) -> mappingAsyncIterator AsyncIterator
+ *
+ * mappingAsyncIterator.next() -> Promise<{ value: any, done: boolean }>
+ * ```
+ */
+declare function MappingAsyncIterator(asyncIterator: any, mapper: any): {
+    [x: number]: () => {
+        [x: number]: any;
+        next(): Promise<any>;
+    };
+    next(): Promise<any>;
+};

package/_internal/MappingIterator.d.ts

@@ -0,0 +1,29 @@
+export = MappingIterator;
+/**
+ * @name MappingIterator
+ *
+ * @synopsis
+ * ```coffeescript [specscript]
+ * MappingIterator<
+ *   T any,
+ *   iterator Iterator<T>,
+ *   mapper T=>any,
+ * >(iterator, mapper) -> mappingIterator Object
+ *
+ * mappingIterator.next() -> nextIteration { value: any, done: boolean }
+ * ```
+ *
+ * @description
+ * Creates a mapping iterator, i.e. an iterator that applies a mapper to each item of a source iterator.
+ *
+ * Note: consuming the mapping iterator also consumes the source iterator.
+ */
+declare function MappingIterator(iterator: any, mapper: any): {
+    [x: number]: () => {
+        [x: number]: any;
+        toString(): string;
+        next(): any;
+    };
+    toString(): string;
+    next(): any;
+};