From e3992f3d0a9d1cebaaa6207c2199f45e2fbdd1e3 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Tue, 1 Jun 2021 01:12:51 +0300
Subject: [PATCH] docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 2626458..59494e7 100644
--- a/README.md
+++ b/README.md
@@ -85,6 +85,7 @@ Library of JavaScript type extensions, types and utilities.
       - [`<generator>.promise()`](#generatorpromise)
       - [`<generator>.then(..)` / `<generator>.catch(..)` / `<generator>.finally(..)`](#generatorthen--generatorcatch--generatorfinally)
       - [`<generator>.toArray()`](#generatortoarray)
+    - [Treating iterators the same as generators](#treating-iterators-the-same-as-generators)
     - [Generator constructor iteration](#generator-constructor-iteration)
       - [`<Generator>.at(..)` / `<Generator>.gat(..)`](#generatorat--generatorgat-1)
       - [`<Generator>.shift()` / `<Generator>.pop()` / `<Generator>.gshift()` / `<Generator>.gpop()`](#generatorshift--generatorpop--generatorgshift--generatorgpop-1)
@@ -1807,6 +1808,23 @@ Unwind a generator into an array
 This is equivalent to `[...<generator>]` but more suited for the concatenative style.
 
 
+### Treating iterators the same as generators
+
+Most _iterator_ methods of `Array`, `Set` and `Map` are extended with the same
+API supported by the [`<generator>`](#generator-instance-iteration), so 
+effectively most built-in iterator methods can be transparently treated as 
+generators.
+
+```javascript
+// this will generate: [1, 4, 9]
+var L = [ ...[1, 2, 3]
+    // Note that this is implemented as an iterator in JS and not a generator...
+    .values()
+    .map(function(e){
+        return e * e }) ]
+```
+
+
 ### Generator constructor iteration
 
 This API is essentially the same as [generator iteration](#generator-instance-iteration)