iter-fest 0.1.1-main.cfcce86 → 0.1.1-main.dd552c2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. package/README.md +126 -45
  2. package/dist/chunk-2DE3J4J7.mjs +35 -0
  3. package/dist/chunk-2DE3J4J7.mjs.map +1 -0
  4. package/dist/chunk-3S6LCGE6.mjs +10 -0
  5. package/dist/chunk-3S6LCGE6.mjs.map +1 -0
  6. package/dist/chunk-ANRVAYLW.mjs +35 -0
  7. package/dist/chunk-ANRVAYLW.mjs.map +1 -0
  8. package/dist/chunk-BWMXKULC.mjs +46 -0
  9. package/dist/chunk-BWMXKULC.mjs.map +1 -0
  10. package/dist/chunk-FBST4AUL.mjs +10 -0
  11. package/dist/chunk-FBST4AUL.mjs.map +1 -0
  12. package/dist/chunk-FMIHIL6A.mjs +10 -0
  13. package/dist/chunk-FMIHIL6A.mjs.map +1 -0
  14. package/dist/chunk-KYMTQJIJ.mjs +10 -0
  15. package/dist/chunk-KYMTQJIJ.mjs.map +1 -0
  16. package/dist/chunk-LIMQXDFK.mjs +10 -0
  17. package/dist/chunk-LIMQXDFK.mjs.map +1 -0
  18. package/dist/chunk-OWUGLCQB.mjs +10 -0
  19. package/dist/chunk-OWUGLCQB.mjs.map +1 -0
  20. package/dist/chunk-P4OSZLEH.mjs +15 -0
  21. package/dist/chunk-P4OSZLEH.mjs.map +1 -0
  22. package/dist/chunk-QX6EMOSQ.mjs +10 -0
  23. package/dist/chunk-QX6EMOSQ.mjs.map +1 -0
  24. package/dist/chunk-R6SXIXMH.mjs +10 -0
  25. package/dist/chunk-R6SXIXMH.mjs.map +1 -0
  26. package/dist/chunk-TDHR35S7.mjs +10 -0
  27. package/dist/chunk-TDHR35S7.mjs.map +1 -0
  28. package/dist/chunk-VCKLUCOT.mjs +10 -0
  29. package/dist/chunk-VCKLUCOT.mjs.map +1 -0
  30. package/dist/chunk-XQDGXAAF.mjs +10 -0
  31. package/dist/chunk-XQDGXAAF.mjs.map +1 -0
  32. package/dist/{chunk-MOBXUTO5.mjs → chunk-YJSIVBF7.mjs} +5 -5
  33. package/dist/chunk-YJSIVBF7.mjs.map +1 -0
  34. package/dist/chunk-YLERARWI.mjs +10 -0
  35. package/dist/chunk-YLERARWI.mjs.map +1 -0
  36. package/dist/iter-fest.asyncGeneratorWithLastValue.d.mts +6 -0
  37. package/dist/iter-fest.asyncGeneratorWithLastValue.d.ts +6 -0
  38. package/dist/iter-fest.asyncGeneratorWithLastValue.js +59 -0
  39. package/dist/iter-fest.asyncGeneratorWithLastValue.js.map +1 -0
  40. package/dist/iter-fest.asyncGeneratorWithLastValue.mjs +7 -0
  41. package/dist/iter-fest.asyncIteratorToAsyncIterable.d.mts +3 -0
  42. package/dist/iter-fest.asyncIteratorToAsyncIterable.d.ts +3 -0
  43. package/dist/{iter-fest.iterableForEach.js → iter-fest.asyncIteratorToAsyncIterable.js} +15 -16
  44. package/dist/iter-fest.asyncIteratorToAsyncIterable.js.map +1 -0
  45. package/dist/iter-fest.asyncIteratorToAsyncIterable.mjs +7 -0
  46. package/dist/iter-fest.d.mts +17 -9
  47. package/dist/iter-fest.d.ts +17 -9
  48. package/dist/iter-fest.generatorWithLastValue.d.mts +6 -0
  49. package/dist/iter-fest.generatorWithLastValue.d.ts +6 -0
  50. package/dist/iter-fest.generatorWithLastValue.js +59 -0
  51. package/dist/iter-fest.generatorWithLastValue.js.map +1 -0
  52. package/dist/iter-fest.generatorWithLastValue.mjs +7 -0
  53. package/dist/iter-fest.iterableWritableStream.d.mts +7 -0
  54. package/dist/iter-fest.iterableWritableStream.d.ts +7 -0
  55. package/dist/{iter-fest.pushAsyncIterableIterator.js → iter-fest.iterableWritableStream.js} +39 -30
  56. package/dist/iter-fest.iterableWritableStream.js.map +1 -0
  57. package/dist/iter-fest.iterableWritableStream.mjs +7 -0
  58. package/dist/iter-fest.iteratorDrop.d.mts +12 -0
  59. package/dist/iter-fest.iteratorDrop.d.ts +12 -0
  60. package/dist/iter-fest.iteratorDrop.js +44 -0
  61. package/dist/iter-fest.iteratorDrop.js.map +1 -0
  62. package/dist/iter-fest.iteratorDrop.mjs +7 -0
  63. package/dist/iter-fest.iteratorEvery.d.mts +25 -0
  64. package/dist/iter-fest.iteratorEvery.d.ts +25 -0
  65. package/dist/iter-fest.iteratorEvery.js +44 -0
  66. package/dist/iter-fest.iteratorEvery.js.map +1 -0
  67. package/dist/iter-fest.iteratorEvery.mjs +7 -0
  68. package/dist/iter-fest.iteratorFilter.d.mts +18 -0
  69. package/dist/iter-fest.iteratorFilter.d.ts +18 -0
  70. package/dist/iter-fest.iteratorFilter.js +44 -0
  71. package/dist/iter-fest.iteratorFilter.js.map +1 -0
  72. package/dist/iter-fest.iteratorFilter.mjs +7 -0
  73. package/dist/iter-fest.iteratorFind.d.mts +14 -0
  74. package/dist/iter-fest.iteratorFind.d.ts +14 -0
  75. package/dist/iter-fest.iteratorFind.js +44 -0
  76. package/dist/iter-fest.iteratorFind.js.map +1 -0
  77. package/dist/iter-fest.iteratorFind.mjs +7 -0
  78. package/dist/iter-fest.iteratorFlatMap.d.mts +12 -0
  79. package/dist/iter-fest.iteratorFlatMap.d.ts +12 -0
  80. package/dist/iter-fest.iteratorFlatMap.js +44 -0
  81. package/dist/iter-fest.iteratorFlatMap.js.map +1 -0
  82. package/dist/iter-fest.iteratorFlatMap.mjs +7 -0
  83. package/dist/iter-fest.iteratorForEach.d.mts +10 -0
  84. package/dist/iter-fest.iteratorForEach.d.ts +10 -0
  85. package/dist/iter-fest.iteratorForEach.js +44 -0
  86. package/dist/iter-fest.iteratorForEach.js.map +1 -0
  87. package/dist/iter-fest.iteratorForEach.mjs +7 -0
  88. package/dist/iter-fest.iteratorForEach.mjs.map +1 -0
  89. package/dist/iter-fest.iteratorFrom.d.mts +12 -0
  90. package/dist/iter-fest.iteratorFrom.d.ts +12 -0
  91. package/dist/iter-fest.iteratorFrom.js +44 -0
  92. package/dist/iter-fest.iteratorFrom.js.map +1 -0
  93. package/dist/iter-fest.iteratorFrom.mjs +7 -0
  94. package/dist/iter-fest.iteratorFrom.mjs.map +1 -0
  95. package/dist/iter-fest.iteratorMap.d.mts +10 -0
  96. package/dist/iter-fest.iteratorMap.d.ts +10 -0
  97. package/dist/iter-fest.iteratorMap.js +44 -0
  98. package/dist/iter-fest.iteratorMap.js.map +1 -0
  99. package/dist/iter-fest.iteratorMap.mjs +7 -0
  100. package/dist/iter-fest.iteratorMap.mjs.map +1 -0
  101. package/dist/{iter-fest.iterableReduce.d.mts → iter-fest.iteratorReduce.d.mts} +13 -9
  102. package/dist/{iter-fest.iterableReduce.d.ts → iter-fest.iteratorReduce.d.ts} +13 -9
  103. package/dist/iter-fest.iteratorReduce.js +44 -0
  104. package/dist/iter-fest.iteratorReduce.js.map +1 -0
  105. package/dist/iter-fest.iteratorReduce.mjs +7 -0
  106. package/dist/iter-fest.iteratorReduce.mjs.map +1 -0
  107. package/dist/iter-fest.iteratorSome.d.mts +10 -0
  108. package/dist/iter-fest.iteratorSome.d.ts +10 -0
  109. package/dist/iter-fest.iteratorSome.js +44 -0
  110. package/dist/iter-fest.iteratorSome.js.map +1 -0
  111. package/dist/iter-fest.iteratorSome.mjs +7 -0
  112. package/dist/iter-fest.iteratorSome.mjs.map +1 -0
  113. package/dist/iter-fest.iteratorTake.d.mts +12 -0
  114. package/dist/iter-fest.iteratorTake.d.ts +12 -0
  115. package/dist/iter-fest.iteratorTake.js +44 -0
  116. package/dist/iter-fest.iteratorTake.js.map +1 -0
  117. package/dist/iter-fest.iteratorTake.mjs +7 -0
  118. package/dist/iter-fest.iteratorTake.mjs.map +1 -0
  119. package/dist/iter-fest.iteratorToArray.d.mts +13 -0
  120. package/dist/iter-fest.iteratorToArray.d.ts +13 -0
  121. package/dist/iter-fest.iteratorToArray.js +44 -0
  122. package/dist/iter-fest.iteratorToArray.js.map +1 -0
  123. package/dist/iter-fest.iteratorToArray.mjs +7 -0
  124. package/dist/iter-fest.iteratorToArray.mjs.map +1 -0
  125. package/dist/iter-fest.js +239 -164
  126. package/dist/iter-fest.js.map +1 -1
  127. package/dist/iter-fest.mjs +70 -38
  128. package/dist/iter-fest.readableStreamFrom.d.mts +3 -0
  129. package/dist/iter-fest.readableStreamFrom.d.ts +3 -0
  130. package/dist/{iter-fest.iterableGetReadable.js → iter-fest.readableStreamFrom.js} +9 -9
  131. package/dist/iter-fest.readableStreamFrom.js.map +1 -0
  132. package/dist/iter-fest.readableStreamFrom.mjs +7 -0
  133. package/dist/iter-fest.readableStreamFrom.mjs.map +1 -0
  134. package/package.json +167 -87
  135. package/dist/chunk-5CRMPYKD.mjs +0 -19
  136. package/dist/chunk-5CRMPYKD.mjs.map +0 -1
  137. package/dist/chunk-6C3P4TNK.mjs +0 -19
  138. package/dist/chunk-6C3P4TNK.mjs.map +0 -1
  139. package/dist/chunk-EZC33HE6.mjs +0 -15
  140. package/dist/chunk-EZC33HE6.mjs.map +0 -1
  141. package/dist/chunk-JU353VSE.mjs +0 -16
  142. package/dist/chunk-JU353VSE.mjs.map +0 -1
  143. package/dist/chunk-MNLOWKTC.mjs +0 -19
  144. package/dist/chunk-MNLOWKTC.mjs.map +0 -1
  145. package/dist/chunk-MOBXUTO5.mjs.map +0 -1
  146. package/dist/chunk-O5SQJUKB.mjs +0 -37
  147. package/dist/chunk-O5SQJUKB.mjs.map +0 -1
  148. package/dist/chunk-XW34KZRY.mjs +0 -17
  149. package/dist/chunk-XW34KZRY.mjs.map +0 -1
  150. package/dist/chunk-ZUBHGSCW.mjs +0 -18
  151. package/dist/chunk-ZUBHGSCW.mjs.map +0 -1
  152. package/dist/iter-fest.iterableEvery.d.mts +0 -24
  153. package/dist/iter-fest.iterableEvery.d.ts +0 -24
  154. package/dist/iter-fest.iterableEvery.js +0 -43
  155. package/dist/iter-fest.iterableEvery.js.map +0 -1
  156. package/dist/iter-fest.iterableEvery.mjs +0 -7
  157. package/dist/iter-fest.iterableFilter.d.mts +0 -16
  158. package/dist/iter-fest.iterableFilter.d.ts +0 -16
  159. package/dist/iter-fest.iterableFilter.js +0 -42
  160. package/dist/iter-fest.iterableFilter.js.map +0 -1
  161. package/dist/iter-fest.iterableFilter.mjs +0 -7
  162. package/dist/iter-fest.iterableFind.d.mts +0 -15
  163. package/dist/iter-fest.iterableFind.d.ts +0 -15
  164. package/dist/iter-fest.iterableFind.js +0 -43
  165. package/dist/iter-fest.iterableFind.js.map +0 -1
  166. package/dist/iter-fest.iterableFind.mjs +0 -7
  167. package/dist/iter-fest.iterableForEach.d.mts +0 -10
  168. package/dist/iter-fest.iterableForEach.d.ts +0 -10
  169. package/dist/iter-fest.iterableForEach.js.map +0 -1
  170. package/dist/iter-fest.iterableForEach.mjs +0 -7
  171. package/dist/iter-fest.iterableGetReadable.d.mts +0 -3
  172. package/dist/iter-fest.iterableGetReadable.d.ts +0 -3
  173. package/dist/iter-fest.iterableGetReadable.js.map +0 -1
  174. package/dist/iter-fest.iterableGetReadable.mjs +0 -7
  175. package/dist/iter-fest.iterableMap.d.mts +0 -8
  176. package/dist/iter-fest.iterableMap.d.ts +0 -8
  177. package/dist/iter-fest.iterableMap.js +0 -39
  178. package/dist/iter-fest.iterableMap.js.map +0 -1
  179. package/dist/iter-fest.iterableMap.mjs +0 -7
  180. package/dist/iter-fest.iterableReduce.js +0 -41
  181. package/dist/iter-fest.iterableReduce.js.map +0 -1
  182. package/dist/iter-fest.iterableReduce.mjs +0 -7
  183. package/dist/iter-fest.iterableSome.d.mts +0 -12
  184. package/dist/iter-fest.iterableSome.d.ts +0 -12
  185. package/dist/iter-fest.iterableSome.js +0 -43
  186. package/dist/iter-fest.iterableSome.js.map +0 -1
  187. package/dist/iter-fest.iterableSome.mjs +0 -7
  188. package/dist/iter-fest.pushAsyncIterableIterator.d.mts +0 -9
  189. package/dist/iter-fest.pushAsyncIterableIterator.d.ts +0 -9
  190. package/dist/iter-fest.pushAsyncIterableIterator.js.map +0 -1
  191. package/dist/iter-fest.pushAsyncIterableIterator.mjs +0 -7
  192. /package/dist/{iter-fest.iterableEvery.mjs.map → iter-fest.asyncGeneratorWithLastValue.mjs.map} +0 -0
  193. /package/dist/{iter-fest.iterableFilter.mjs.map → iter-fest.asyncIteratorToAsyncIterable.mjs.map} +0 -0
  194. /package/dist/{iter-fest.iterableFind.mjs.map → iter-fest.generatorWithLastValue.mjs.map} +0 -0
  195. /package/dist/{iter-fest.iterableForEach.mjs.map → iter-fest.iterableWritableStream.mjs.map} +0 -0
  196. /package/dist/{iter-fest.iterableGetReadable.mjs.map → iter-fest.iteratorDrop.mjs.map} +0 -0
  197. /package/dist/{iter-fest.iterableMap.mjs.map → iter-fest.iteratorEvery.mjs.map} +0 -0
  198. /package/dist/{iter-fest.iterableReduce.mjs.map → iter-fest.iteratorFilter.mjs.map} +0 -0
  199. /package/dist/{iter-fest.iterableSome.mjs.map → iter-fest.iteratorFind.mjs.map} +0 -0
  200. /package/dist/{iter-fest.pushAsyncIterableIterator.mjs.map → iter-fest.iteratorFlatMap.mjs.map} +0 -0
package/README.md CHANGED
@@ -16,38 +16,22 @@ Iterables can contains infinite number of items, please use this package respons
16
16
  npm install iter-fest
17
17
  ```
18
18
 
19
- ### `Array.prototype` ports
20
-
21
- We ported majority of functions from `Array.prototype.*` to `iterable*`.
22
-
23
- ```ts
24
- import { iterableIncludes, iterableReduce } from 'iter-fest'; // Via default exports.
25
- import { iterableSome } from 'iter-fest/iterableSome'; // Via named exports.
26
-
27
- const iterable: Iterable<number> = [1, 2, 3, 4, 5].values();
28
-
29
- console.log(iterableIncludes(iterable, 3)); // Prints "true".
30
- console.log(iterableReduce(iterable, (sum, value) => sum + value, 0)); // Prints "15".
31
- console.log(iterableSome(iterable, value => value % 2)); // Prints "true".
32
- ```
33
-
34
- List of ported functions: [`at`](https://tc39.es/ecma262/#sec-array.prototype.at), [`concat`](https://tc39.es/ecma262/#sec-array.prototype.concat), [`entries`](https://tc39.es/ecma262/#sec-array.prototype.entries), [`every`](https://tc39.es/ecma262/#sec-array.prototype.every), [`filter`](https://tc39.es/ecma262/#sec-array.prototype.filter), [`find`](https://tc39.es/ecma262/#sec-array.prototype.find), [`findIndex`](https://tc39.es/ecma262/#sec-array.prototype.findindex), [`findLast`](https://tc39.es/ecma262/#sec-array.prototype.findlast), [`findLastIndex`](https://tc39.es/ecma262/#sec-array.prototype.findlastindex), [`forEach`](https://tc39.es/ecma262/#sec-array.prototype.foreach), [`includes`](https://tc39.es/ecma262/#sec-array.prototype.includes), [`indexOf`](https://tc39.es/ecma262/#sec-array.prototype.indexof), [`join`](https://tc39.es/ecma262/#sec-array.prototype.join), [`keys`](https://tc39.es/ecma262/#sec-array.prototype.keys), [`map`](https://tc39.es/ecma262/#sec-array.prototype.map), [`reduce`](https://tc39.es/ecma262/#sec-array.prototype.reduce), [`slice`](https://tc39.es/ecma262/#sec-array.prototype.slice), [`some`](https://tc39.es/ecma262/#sec-array.prototype.some), [`toSpliced`](https://tc39.es/ecma262/#sec-array.prototype.tospliced), and [`toString`](https://tc39.es/ecma262/#sec-array.prototype.tostring).
35
-
36
19
  ## Conversions
37
20
 
38
- | From | To | Function signature |
39
- | ----------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
40
- | `Iterator` | `IterableIterator` | [`iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>`](#converting-an-iterator-to-iterable) |
41
- | `Observable` | `ReadableStream` | [`observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>`](#converting-an-observable-to-readablestream) |
42
- | `ReadableStreamDefaultReader` | `AsyncIterableIterator` | [`readerValues`<T>(reader: ReadableStreamDefaultReader<T>): AsyncIterableIterator<T>`](#iterating-readablestreamdefaultreader) |
43
- | `AsyncIterable` | `Observable` | [`observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>`](#converting-an-asynciterable-to-observable) |
44
- | `AsyncIterable`/`Iterable` | `ReadableStream` | [`iterableGetReadable<T>(iterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>`](#converting-an-asynciterableiterable-to-readablestream) |
21
+ | From | To | Function signature |
22
+ | ----------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
23
+ | `Iterator` | `IterableIterator` | [`iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>`](#converting-an-iterator-to-iterable) |
24
+ | `AsyncIterator` | `AsyncIterableIterator` | [`asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>`](#converting-an-iterator-to-iterable) |
25
+ | `Observable` | `ReadableStream` | [`observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>`](#converting-an-observable-to-readablestream) |
26
+ | `ReadableStreamDefaultReader` | `AsyncIterableIterator` | [`readerValues`<T>(reader: ReadableStreamDefaultReader<T>): AsyncIterableIterator<T>`](#converting-a-readablestreamdefaultreader-to-asynciterableiterator) |
27
+ | `AsyncIterable` | `Observable` | [`observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>`](#converting-an-asynciterable-to-observable) |
28
+ | `AsyncIterable`/`Iterable` | `ReadableStream` | [`readableStreamFrom<T>(anyIterable: AsyncIterable<T> \| Iterable<T>): ReadableStream<T>`](#converting-an-asynciterableiterable-to-readablestream) |
45
29
 
46
30
  To convert `Observable` to `AsyncIterableIterator`, [use `ReadableStream` as intermediate format](#converting-an-observable-to-asynciterableiterator).
47
31
 
48
32
  ### Converting an iterator to iterable
49
33
 
50
- `iteratorToIterable` enable a [pure iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator) to be iterable using a for-loop statement.
34
+ `iteratorToIterable` and `asyncIteratorToAsyncIterable` enable a [pure iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator) to be iterable using a for-loop statement.
51
35
 
52
36
  ```ts
53
37
  const iterate = (): Iterator<number> => {
@@ -59,7 +43,7 @@ const iterate = (): Iterator<number> => {
59
43
  return { value };
60
44
  }
61
45
 
62
- return { done: true, value: undefined };
46
+ return { done: true, value: undefined } satisfies IteratorResult<number>;
63
47
  }
64
48
  };
65
49
  };
@@ -69,26 +53,31 @@ for (const value of iteratorToIterable(iterate())) {
69
53
  }
70
54
  ```
71
55
 
56
+ Note: calling `[Symbol.iterator]()` or `[Symbol.asyncIterator]()` will not restart the iteration. This is because iterator is an instance of iteration and is not restartable.
57
+
72
58
  ### Converting an `Observable` to `AsyncIterableIterator`
73
59
 
74
- `ReadableStream` can be used to when converting an `Observable` to `AsyncIterableIterator`.
60
+ `ReadableStream` can be used as an intermediate format when converting an `Observable` to `AsyncIterableIterator`.
75
61
 
76
62
  Note: `Observable` is push-based and it does not support flow control. When converting to `AsyncIterableIteratorrr`, the internal buffer of `ReadableStream` could build up quickly.
77
63
 
78
64
  ```ts
79
65
  const observable = Observable.from([1, 2, 3]);
80
66
  const readable = observableSubscribeAsReadable(observable);
67
+ const iterable = readerValues(readable.getReader());
81
68
 
82
- for await (const value of readerValues(readable.getReader())) {
69
+ for await (const value of iterable) {
83
70
  console.log(value); // Prints "1", "2", "3".
84
71
  }
85
72
  ```
86
73
 
74
+ Note: calling `[Symbol.asyncIterator]()` will not resubscribe and read from the start of the observable. This is because the intermediate format does not support restart.
75
+
87
76
  ### Converting an `AsyncIterable` to `Observable`
88
77
 
89
78
  `Observable.from` converts `Iterable` into `Observable`. However, it does not convert `AsyncIterable`.
90
79
 
91
- `observableFromAsync` will convert `AsyncIterable` into `Observable`.
80
+ `observableFromAsync` will convert `AsyncIterable` into `Observable`. It will try to restart the iteration by calling `[Symbol.asyncIterator]()`.
92
81
 
93
82
  ```ts
94
83
  async function* generate() {
@@ -103,7 +92,11 @@ const next = value => console.log(value);
103
92
  observable.subscribe({ next }); // Prints "1", "2", "3".
104
93
  ```
105
94
 
106
- ## Converting an `Observable` to `ReadableStream`
95
+ Note: `observableFromAsync` will call `[Symbol.asyncIterator]()` initially to restart the iteration where possible.
96
+
97
+ Note: It is not recommended to convert `AsyncGenerator` to an `Observable`. `AsyncGenerator` has more functionalities and `Observable` does not support many of them.
98
+
99
+ ### Converting an `Observable` to `ReadableStream`
107
100
 
108
101
  `ReadableStream` is powerful for transforming and piping stream of data. It can be formed using data from both push-based and pull-based source with backpressuree.
109
102
 
@@ -112,12 +105,11 @@ Note: `Observable` is push-based and it does not support flow control. When conv
112
105
  ```ts
113
106
  const observable = Observable.from([1, 2, 3]);
114
107
  const readable = observableSubscribeAsReadable(observable);
115
- const reader = readable.getReader();
116
108
 
117
109
  readable.pipeTo(stream.writable); // Will write 1, 2, 3.
118
110
  ```
119
111
 
120
- ### Iterating `ReadableStreamDefaultReader`
112
+ ### Converting a `ReadableStreamDefaultReader` to `AsyncIterableIterator`
121
113
 
122
114
  `readerValues` will convert default reader of `ReadableStream` into an `AsyncIterableIterator` to use in for-loop.
123
115
 
@@ -133,20 +125,28 @@ const readableStream = new ReadableStream({
133
125
  }
134
126
  });
135
127
 
136
- for await (const value of readerValues(readableStream.getReader())) {
128
+ const iterable = readerValues(readableStream.getReader());
129
+
130
+ for await (const value of iterable) {
137
131
  console.log(value); // Prints "1", "2", "3".
138
132
  }
139
133
  ```
140
134
 
141
- ## Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
135
+ Note: `[Symbol.asyncIterator]()` will not restart the reader and read from start of the stream. Reader is not restartable and streams are not seekable.
136
+
137
+ ### Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
138
+
139
+ > Notes: this feature is part of [Streams Standard](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/from_static).
142
140
 
143
141
  ```ts
144
142
  const iterable = [1, 2, 3].values();
145
- const readable = iterableGetReadable(iterable);
143
+ const readable = readableStreamFrom(iterable);
146
144
 
147
145
  readable.pipeTo(stream.writable); // Will write 1, 2, 3.
148
146
  ```
149
147
 
148
+ Note: `readableStreamFrom()` will call `[Symbol.iterator]()` initially to restart the iteration where possible.
149
+
150
150
  ## Others
151
151
 
152
152
  ### Typed `Observable`
@@ -155,14 +155,18 @@ readable.pipeTo(stream.writable); // Will write 1, 2, 3.
155
155
 
156
156
  ### Producer-consumer queue
157
157
 
158
- `PushAsyncIterableIterator` is a simple push-based producer-consumer queue and designed to decouple the flow between a producer and consumer. The producer can push a new job at anytime. The consumer can pull a job at its own convenience.
158
+ `IterableWritableStream` is a push-based producer-consumer queue designed to decouple the flow between a producer and multiple consumers. The producer can push a new job at anytime. The consumer can pull a job at its own convenience via for-loop.
159
+
160
+ `IterableWritableStream` supports multiple consumers and continuation:
159
161
 
160
- Compare to pull-based queue, a push-based queue is easier to use. However, pull-based queue offers better flow control as it will produce a job only if there is a consumer ready to consume.
162
+ - Multiple consumers: when 2 or more consumers are active at the same time, jobs will be distributed across all consumers in a round robin fashion when possible
163
+ - Continuation: when the last consumer disconnected while producer keep pushing new jobs, the next consumer will pick up where the last consumer left
161
164
 
162
- For a full-featured producer-consumer queue that supports flow control, use `ReadableStream` instead.
165
+ Compare to pull-based queue, a push-based queue is easy to use. However, pull-based queue offers better flow control as it will produce a job only if there is a consumer ready to consume.
163
166
 
164
167
  ```ts
165
- const iterable = new PushAsyncIterableIterator();
168
+ const iterable = new IterableWritableStream();
169
+ const writer = iterable.getWriter();
166
170
 
167
171
  (async function consumer() {
168
172
  for await (const value of iterable) {
@@ -173,15 +177,89 @@ const iterable = new PushAsyncIterableIterator();
173
177
  })();
174
178
 
175
179
  (async function producer() {
176
- iterable.push(1);
177
- iterable.push(2);
178
- iterable.push(3);
179
- iterable.close();
180
+ writer.write(1);
181
+ writer.write(2);
182
+ writer.write(3);
183
+ writer.close();
180
184
  })();
181
185
 
182
186
  // Prints "1", "2", "3", "Done".
183
187
  ```
184
188
 
189
+ ### Using for-loop with generator
190
+
191
+ Compare to `Iterator`, `Generator` offers advanced capability.
192
+
193
+ When using for-loop with generator, the last value return from the generator is lost.
194
+
195
+ The `generatorWithLastValue()` and `asyncGeneratorWithLastValue()` helps bridge the for-loop usage by capturing the value returned as `{ done: true }` and make it accessible via `lastValue()`.
196
+
197
+ ```ts
198
+ const generator = generatorWithLastValue(
199
+ (function* () {
200
+ yield 1; // { done: false, value: 1 }
201
+ yield 2; // { done: false, value: 2 }
202
+ yield 3; // { done: false, value: 3 }
203
+
204
+ return 'end'; // { done: true, value: 'end' }
205
+ })()
206
+ );
207
+
208
+ for (const value of generator) {
209
+ console.log(value); // Prints "1", "2", "3".
210
+ }
211
+
212
+ console.log(generator.lastValue()); // Prints "end".
213
+ ```
214
+
215
+ Note: `lastValue()` will throw if it is being called before end of iteration. Also, excessive calls to `next()` will return `{ done: true, value: undefined }`, thus, `lastValue()` could become `undefined` if `next()` is called after the end of iteration.
216
+
217
+ The value returned from `generatorWithLastValue()`/`asyncGeneratorWithLastValue()` will passthrough all function calls to original `Generator` with a minor difference. Calling `[Symbol.iterator]()`/`[Symbol.asyncIterator]()` on the returned generator will not start a fresh iteration. If a fresh iteration is required, create a new one before passing it to `generatorWithLastValue()`/`asyncGeneratorWithLastValue()`.
218
+
219
+ ```ts
220
+ const generator = generatorWithLastValue(
221
+ (function* () {
222
+ // ...
223
+ })()[Symbol.iterator]() // Creates a fresh iteration.
224
+ );
225
+ ```
226
+
227
+ ## Adding types to `core-js-pure`
228
+
229
+ We added types to implementation from `core-js-pure`:
230
+
231
+ - [`Iterator.drop`](https://tc39.es/ecma262/#sec-array.prototype.drop)
232
+ - [`Iterator.every`](https://tc39.es/ecma262/#sec-array.prototype.every)
233
+ - [`Iterator.filter`](https://tc39.es/ecma262/#sec-array.prototype.filter)
234
+ - [`Iterator.find`](https://tc39.es/ecma262/#sec-array.prototype.find)
235
+ - [`Iterator.flatMap`](https://tc39.es/ecma262/#sec-array.prototype.flatmap)
236
+ - [`Iterator.forEach`](https://tc39.es/ecma262/#sec-array.prototype.foreach)
237
+ - [`Iterator.from`](https://tc39.es/ecma262/#sec-array.prototype.from)
238
+ - [`Iterator.map`](https://tc39.es/ecma262/#sec-array.prototype.map)
239
+ - [`Iterator.reduce`](https://tc39.es/ecma262/#sec-array.prototype.reduce)
240
+ - [`Iterator.some`](https://tc39.es/ecma262/#sec-array.prototype.some)
241
+ - [`Iterator.take`](https://tc39.es/ecma262/#sec-array.prototype.take)
242
+ - [`Iterator.toArray`](https://tc39.es/ecma262/#sec-array.prototype.toarray)
243
+
244
+ ## `Array.prototype` ports
245
+
246
+ > Note: we are working to move them from `iterable*` to `iterator*` to make them similar to TC39 proposals.
247
+
248
+ We ported majority of functions from `Array.prototype.*` to `iterable*`.
249
+
250
+ ```ts
251
+ import { iteratorIncludes, iteratorReduce } from 'iter-fest'; // Via default exports.
252
+ import { iteratorSome } from 'iter-fest/iteratorSome'; // Via named exports.
253
+
254
+ const iterator: iterator<number> = [1, 2, 3, 4, 5].values();
255
+
256
+ console.log(iteratorIncludes(iterator, 3)); // Prints "true".
257
+ console.log(iteratorReduce(iterator, (sum, value) => sum + value, 0)); // Prints "15".
258
+ console.log(iteratorSome(iterator, value => value % 2)); // Prints "true".
259
+ ```
260
+
261
+ List of ported functions: [`at`](https://tc39.es/ecma262/#sec-array.prototype.at), [`concat`](https://tc39.es/ecma262/#sec-array.prototype.concat), [`entries`](https://tc39.es/ecma262/#sec-array.prototype.entries), [`findIndex`](https://tc39.es/ecma262/#sec-array.prototype.findindex), [`findLast`](https://tc39.es/ecma262/#sec-array.prototype.findlast), [`findLastIndex`](https://tc39.es/ecma262/#sec-array.prototype.findlastindex), [`includes`](https://tc39.es/ecma262/#sec-array.prototype.includes), [`indexOf`](https://tc39.es/ecma262/#sec-array.prototype.indexof), [`join`](https://tc39.es/ecma262/#sec-array.prototype.join), [`keys`](https://tc39.es/ecma262/#sec-array.prototype.keys), [`slice`](https://tc39.es/ecma262/#sec-array.prototype.slice), [`toSpliced`](https://tc39.es/ecma262/#sec-array.prototype.tospliced), and [`toString`](https://tc39.es/ecma262/#sec-array.prototype.tostring).
262
+
185
263
  ## Behaviors
186
264
 
187
265
  ### How this compares to the TC39 proposals?
@@ -230,18 +308,21 @@ Generator has more functionalities than iterator and array. It is not recommende
230
308
  - Generator can define the return value
231
309
  - `return { done: true, value: 'the very last value' }`
232
310
  - Iterating generator using for-loop will not get any values from `{ done: true }`
311
+ - The `generatorWithLastValue()` will help capturing and retrieving the last return value
233
312
  - Generator can receive feedback values from its iterator
234
313
  - `generator.next('something')`, the feedback can be assigned to variable via `const feedback = yield;`
235
314
  - For-loop cannot send feedbacks to generator
236
315
 
237
316
  ### When should I use `Iterable`, `IterableIterator` and `Iterator`?
238
317
 
239
- For best compatibility, you should generally follow this API signature: use `Iterable` for inputs, and use `IterableIterator` for outputs. You should avoid exporting pure `Iterator`.
318
+ For best compatibility, you should generally follow this API signature: use `Iterable` for inputs, and use `IterableIterator` for outputs. You should avoid exporting pure `Iterator`. Sample function signature should looks below.
240
319
 
241
320
  ```ts
242
- function transform<T>(iterable: Iterable<T>): IterableIterator<T>;
321
+ function myFunction<T>(input: Iterable<T>): IterableIterator<T>;
243
322
  ```
244
323
 
324
+ `IterableIterator` may opt to support restarting the iteration through `[Symbol.iterator]()`. When consuming an `IterableIterator`, you should call `[Symbol.iterator]()` to obtain a fresh iteration or use for-loop statement if possible. However, `[Symbol.iterator]()` is an opt-in feature and does not always guarantee a fresh iteration.
325
+
245
326
  ### What is on the roadmap?
246
327
 
247
328
  We are planning to bring iterables and its siblings together, including:
@@ -0,0 +1,35 @@
1
+ // src/generatorWithLastValue.ts
2
+ var STILL_ITERATING = Symbol();
3
+ function generatorWithLastValue(generator) {
4
+ let lastValue = STILL_ITERATING;
5
+ const generatorWithLastValue2 = {
6
+ [Symbol.iterator]() {
7
+ return generatorWithLastValue2;
8
+ },
9
+ lastValue() {
10
+ if (lastValue === STILL_ITERATING) {
11
+ throw new Error("Iteration has not complete yet, cannot get last value.");
12
+ }
13
+ return lastValue;
14
+ },
15
+ next(next) {
16
+ const result = generator.next(next);
17
+ if (result.done) {
18
+ lastValue = result.value;
19
+ }
20
+ return result;
21
+ },
22
+ return(value) {
23
+ return generator.return(value);
24
+ },
25
+ throw(error) {
26
+ return generator.throw(error);
27
+ }
28
+ };
29
+ return generatorWithLastValue2;
30
+ }
31
+
32
+ export {
33
+ generatorWithLastValue
34
+ };
35
+ //# sourceMappingURL=chunk-2DE3J4J7.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/generatorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type GeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = Generator<T, TReturn, TNext> & {\n lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function generatorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n generator: Generator<T, TReturn, TNext>\n): GeneratorWithLastValue<T, TReturn, TNext> {\n let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n const generatorWithLastValue = {\n [Symbol.iterator]() {\n return generatorWithLastValue;\n },\n lastValue(): TReturn {\n if (lastValue === STILL_ITERATING) {\n throw new Error('Iteration has not complete yet, cannot get last value.');\n }\n\n return lastValue;\n },\n next(next: TNext) {\n const result = generator.next(next);\n\n if (result.done) {\n lastValue = result.value;\n }\n\n return result;\n },\n return(value: TReturn) {\n return generator.return(value);\n },\n throw(error: unknown) {\n return generator.throw(error);\n }\n };\n\n return generatorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAQxB,SAAS,uBACd,WAC2C;AAC3C,MAAI,YAA8C;AAElD,QAAMA,0BAAyB;AAAA,IAC7B,CAAC,OAAO,QAAQ,IAAI;AAClB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,KAAK,MAAa;AAChB,YAAM,SAAS,UAAU,KAAK,IAAI;AAElC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["generatorWithLastValue"]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorSome.ts
2
+ import some from "core-js-pure/full/iterator/some";
3
+ function iteratorSome(iterator, predicate) {
4
+ return some(iterator, predicate);
5
+ }
6
+
7
+ export {
8
+ iteratorSome
9
+ };
10
+ //# sourceMappingURL=chunk-3S6LCGE6.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorSome.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport some from 'core-js-pure/full/iterator/some';\n\n/**\n * Determines whether the specified callback function returns true for any element of an iterable.\n *\n * @param predicate A function that accepts up to three arguments. The some method calls the predicate function for each element in the iterable until the predicate returns a value which is coercible to the Boolean value true, or until the end of the iterable.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorSome<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean {\n return some(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,UAAU;AASV,SAAS,aAAgB,UAAuB,WAA0D;AAC/G,SAAO,KAAK,UAAU,SAAS;AACjC;","names":[]}
@@ -0,0 +1,35 @@
1
+ // src/asyncGeneratorWithLastValue.ts
2
+ var STILL_ITERATING = Symbol();
3
+ function asyncGeneratorWithLastValue(generator) {
4
+ let lastValue = STILL_ITERATING;
5
+ const asyncGeneratorWithLastValue2 = {
6
+ [Symbol.asyncIterator]() {
7
+ return asyncGeneratorWithLastValue2;
8
+ },
9
+ lastValue() {
10
+ if (lastValue === STILL_ITERATING) {
11
+ throw new Error("Iteration has not complete yet, cannot get last value.");
12
+ }
13
+ return lastValue;
14
+ },
15
+ async next(next) {
16
+ const result = await generator.next(next);
17
+ if (result.done) {
18
+ lastValue = result.value;
19
+ }
20
+ return result;
21
+ },
22
+ return(value) {
23
+ return generator.return(value);
24
+ },
25
+ throw(error) {
26
+ return generator.throw(error);
27
+ }
28
+ };
29
+ return asyncGeneratorWithLastValue2;
30
+ }
31
+
32
+ export {
33
+ asyncGeneratorWithLastValue
34
+ };
35
+ //# sourceMappingURL=chunk-ANRVAYLW.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/asyncGeneratorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<\n T,\n TReturn,\n TNext\n> & {\n lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n generator: AsyncGenerator<T, TReturn, TNext>\n): AsyncGeneratorWithLastValue<T, TReturn, TNext> {\n let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n const asyncGeneratorWithLastValue = {\n [Symbol.asyncIterator]() {\n return asyncGeneratorWithLastValue;\n },\n lastValue(): TReturn {\n if (lastValue === STILL_ITERATING) {\n throw new Error('Iteration has not complete yet, cannot get last value.');\n }\n\n return lastValue;\n },\n async next(next: TNext) {\n const result = await generator.next(next);\n\n if (result.done) {\n lastValue = result.value;\n }\n\n return result;\n },\n return(value: TReturn) {\n return generator.return(value);\n },\n throw(error: unknown) {\n return generator.throw(error);\n }\n };\n\n return asyncGeneratorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAYxB,SAAS,4BACd,WACgD;AAChD,MAAI,YAA8C;AAElD,QAAMA,+BAA8B;AAAA,IAClC,CAAC,OAAO,aAAa,IAAI;AACvB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,KAAK,MAAa;AACtB,YAAM,SAAS,MAAM,UAAU,KAAK,IAAI;AAExC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["asyncGeneratorWithLastValue"]}
@@ -0,0 +1,46 @@
1
+ // src/private/withResolvers.ts
2
+ import coreJSPromiseWithResolvers from "core-js-pure/full/promise/with-resolvers";
3
+ function withResolvers() {
4
+ return coreJSPromiseWithResolvers();
5
+ }
6
+
7
+ // src/iterableWritableStream.ts
8
+ var CLOSE = Symbol();
9
+ var IterableWritableStream = class extends WritableStream {
10
+ constructor() {
11
+ super({
12
+ close: () => {
13
+ this.#buffer.push(CLOSE);
14
+ this.#writeResolvers.resolve();
15
+ },
16
+ write: (chunk) => {
17
+ this.#buffer.push(chunk);
18
+ this.#writeResolvers.resolve();
19
+ this.#writeResolvers = withResolvers();
20
+ }
21
+ });
22
+ }
23
+ #buffer = [];
24
+ #writeResolvers = withResolvers();
25
+ [Symbol.asyncIterator]() {
26
+ return {
27
+ next: async () => {
28
+ while (!this.#buffer.length) {
29
+ await this.#writeResolvers.promise;
30
+ }
31
+ const value = this.#buffer[0];
32
+ if (value === CLOSE) {
33
+ return { done: true, value: void 0 };
34
+ }
35
+ this.#buffer.shift();
36
+ await void 0;
37
+ return { done: false, value };
38
+ }
39
+ };
40
+ }
41
+ };
42
+
43
+ export {
44
+ IterableWritableStream
45
+ };
46
+ //# sourceMappingURL=chunk-BWMXKULC.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/private/withResolvers.ts","../src/iterableWritableStream.ts"],"sourcesContent":["// @ts-expect-error \"core-js\" is not typed.\nimport coreJSPromiseWithResolvers from 'core-js-pure/full/promise/with-resolvers';\n\nexport default function withResolvers<T>(): PromiseWithResolvers<T> {\n return coreJSPromiseWithResolvers();\n}\n","import withResolvers from './private/withResolvers';\n\nconst CLOSE = Symbol();\n\nexport class IterableWritableStream<T> extends WritableStream<T> {\n constructor() {\n super({\n close: () => {\n this.#buffer.push(CLOSE);\n this.#writeResolvers.resolve();\n },\n write: (chunk: T) => {\n this.#buffer.push(chunk);\n this.#writeResolvers.resolve();\n this.#writeResolvers = withResolvers();\n }\n });\n }\n\n #buffer: (T | typeof CLOSE)[] = [];\n #writeResolvers: PromiseWithResolvers<void> = withResolvers();\n\n [Symbol.asyncIterator](): AsyncIterator<T> {\n return {\n next: async () => {\n while (!this.#buffer.length) {\n await this.#writeResolvers.promise;\n }\n\n const value = this.#buffer[0] as T | typeof CLOSE;\n\n if (value === CLOSE) {\n return { done: true, value: undefined };\n }\n\n // If it is not CLOSE, remove it from the queue.\n this.#buffer.shift();\n\n // Idle here so concurrent iteration has a chance to pick up the next value in a round robin fashion.\n await undefined;\n\n return { done: false, value };\n }\n };\n }\n}\n"],"mappings":";AACA,OAAO,gCAAgC;AAExB,SAAR,gBAA6D;AAClE,SAAO,2BAA2B;AACpC;;;ACHA,IAAM,QAAQ,OAAO;AAEd,IAAM,yBAAN,cAAwC,eAAkB;AAAA,EAC/D,cAAc;AACZ,UAAM;AAAA,MACJ,OAAO,MAAM;AACX,aAAK,QAAQ,KAAK,KAAK;AACvB,aAAK,gBAAgB,QAAQ;AAAA,MAC/B;AAAA,MACA,OAAO,CAAC,UAAa;AACnB,aAAK,QAAQ,KAAK,KAAK;AACvB,aAAK,gBAAgB,QAAQ;AAC7B,aAAK,kBAAkB,cAAc;AAAA,MACvC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,UAAgC,CAAC;AAAA,EACjC,kBAA8C,cAAc;AAAA,EAE5D,CAAC,OAAO,aAAa,IAAsB;AACzC,WAAO;AAAA,MACL,MAAM,YAAY;AAChB,eAAO,CAAC,KAAK,QAAQ,QAAQ;AAC3B,gBAAM,KAAK,gBAAgB;AAAA,QAC7B;AAEA,cAAM,QAAQ,KAAK,QAAQ,CAAC;AAE5B,YAAI,UAAU,OAAO;AACnB,iBAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,QACxC;AAGA,aAAK,QAAQ,MAAM;AAGnB,cAAM;AAEN,eAAO,EAAE,MAAM,OAAO,MAAM;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorFind.ts
2
+ import find from "core-js-pure/full/iterator/find";
3
+ function iteratorFind(iterator, predicate) {
4
+ return find(iterator, predicate);
5
+ }
6
+
7
+ export {
8
+ iteratorFind
9
+ };
10
+ //# sourceMappingURL=chunk-FBST4AUL.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorFind.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport find from 'core-js-pure/full/iterator/find';\n\n/**\n * Returns the value of the first element in the iterator where predicate is true, and undefined\n * otherwise.\n *\n * @param predicate find calls predicate once for each element of the iterator, in ascending\n * order, until it finds one where predicate returns true. If such an element is found, find\n * immediately returns that element value. Otherwise, find returns undefined.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFind<T, S extends T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => value is S\n): S | undefined;\n\nexport function iteratorFind<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): T | undefined;\n\nexport function iteratorFind<T, S extends T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => unknown\n): S | undefined {\n return find(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAmBV,SAAS,aACd,UACA,WACe;AACf,SAAO,KAAK,UAAU,SAAS;AACjC;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorForEach.ts
2
+ import forEach from "core-js-pure/full/iterator/for-each";
3
+ function iteratorForEach(iterator, callbackfn) {
4
+ forEach(iterator, callbackfn);
5
+ }
6
+
7
+ export {
8
+ iteratorForEach
9
+ };
10
+ //# sourceMappingURL=chunk-FMIHIL6A.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorForEach.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport forEach from 'core-js-pure/full/iterator/for-each';\n\n/**\n * Performs the specified action for each element in an iterator.\n *\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorForEach<T>(iterator: Iterator<T>, callbackfn: (value: T, index: number) => void): void {\n forEach(iterator, callbackfn);\n}\n"],"mappings":";AACA,OAAO,aAAa;AASb,SAAS,gBAAmB,UAAuB,YAAqD;AAC7G,UAAQ,UAAU,UAAU;AAC9B;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorFrom.ts
2
+ import from from "core-js-pure/full/iterator/from";
3
+ function iteratorFrom(iteratorLike) {
4
+ return from(iteratorLike);
5
+ }
6
+
7
+ export {
8
+ iteratorFrom
9
+ };
10
+ //# sourceMappingURL=chunk-KYMTQJIJ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorFrom.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport from from 'core-js-pure/full/iterator/from';\n\n/**\n * `.from` is a static method (unlike the others listed above) which takes an object as an argument. This method allows wrapping \"iterator-like\" objects with an iterator.\n *\n * @param limit\n *\n * @return Returns the object if it is already an iterator, returns a wrapping iterator if the passed object implements a callable @@iterator property.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFrom<T>(iteratorLike: Iterator<T>): Iterator<T> {\n return from(iteratorLike);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAWV,SAAS,aAAgB,cAAwC;AACtE,SAAO,KAAK,YAAY;AAC1B;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorReduce.ts
2
+ import reduce from "core-js-pure/full/iterator/reduce";
3
+ function iteratorReduce(iterator, callbackfn, initialValue) {
4
+ return reduce(iterator, callbackfn, initialValue);
5
+ }
6
+
7
+ export {
8
+ iteratorReduce
9
+ };
10
+ //# sourceMappingURL=chunk-LIMQXDFK.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorReduce.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport reduce from 'core-js-pure/full/iterator/reduce';\n\n/**\n * Calls the specified callback function for all the elements in an iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n *\n * @param callbackfn A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the iterator.\n *\n * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an iterator value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorReduce<T>(\n iterator: Iterator<T>,\n callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T\n): T;\n\nexport function iteratorReduce<T>(\n iterator: Iterator<T>,\n callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T,\n initialValue: T\n): T;\n\n/**\n * Calls the specified callback function for all the elements in an iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n *\n * @param callbackfn A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the iterator.\n *\n * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorReduce<T, U>(\n iterator: Iterator<T>,\n callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U,\n initialValue: U\n): U;\n\nexport function iteratorReduce<T, U = undefined>(\n iterator: Iterator<T>,\n callbackfn: (previousValue: U | undefined, currentValue: T, currentIndex: number) => U,\n initialValue?: U\n): U | undefined {\n return reduce(iterator, callbackfn, initialValue);\n}\n"],"mappings":";AACA,OAAO,YAAY;AAqCZ,SAAS,eACd,UACA,YACA,cACe;AACf,SAAO,OAAO,UAAU,YAAY,YAAY;AAClD;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorEvery.ts
2
+ import every from "core-js-pure/full/iterator/every";
3
+ function iteratorEvery(iterator, predicate) {
4
+ return every(iterator, predicate);
5
+ }
6
+
7
+ export {
8
+ iteratorEvery
9
+ };
10
+ //# sourceMappingURL=chunk-OWUGLCQB.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorEvery.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport every from 'core-js-pure/full/iterator/every';\n\n/**\n * Determines whether all the members of an iterator satisfy the specified test.\n *\n * @param predicate A function that accepts up to three arguments. The every method calls\n * the predicate function for each element in the iterator until the predicate returns a value\n * which is coercible to the Boolean value false, or until the end of the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorEvery<T, S extends T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => value is S\n): iterator is Iterator<S>;\n\n/**\n * Determines whether all the members of an iterator satisfy the specified test.\n *\n * @param predicate A function that accepts up to three arguments. The every method calls\n * the predicate function for each element in the iterator until the predicate returns a value\n * which is coercible to the Boolean value false, or until the end of the iterator.\n *\n * @param thisArg An object to which the this keyword can refer in the predicate function.\n * If thisArg is omitted, undefined is used as the this value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorEvery<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean;\n\nexport function iteratorEvery<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean {\n return every(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,WAAW;AA8BX,SAAS,cAAiB,UAAuB,WAA0D;AAChH,SAAO,MAAM,UAAU,SAAS;AAClC;","names":[]}
@@ -0,0 +1,15 @@
1
+ // src/asyncIteratorToAsyncIterable.ts
2
+ function asyncIteratorToAsyncIterable(asyncIterator) {
3
+ const asyncIterableIterator = {
4
+ [Symbol.asyncIterator]: () => asyncIterableIterator,
5
+ next: asyncIterator.next.bind(asyncIterator),
6
+ ...asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {},
7
+ ...asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {}
8
+ };
9
+ return asyncIterableIterator;
10
+ }
11
+
12
+ export {
13
+ asyncIteratorToAsyncIterable
14
+ };
15
+ //# sourceMappingURL=chunk-P4OSZLEH.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/asyncIteratorToAsyncIterable.ts"],"sourcesContent":["export function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T> {\n const asyncIterableIterator: AsyncIterableIterator<T> = {\n [Symbol.asyncIterator]: () => asyncIterableIterator,\n next: asyncIterator.next.bind(asyncIterator),\n ...(asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {}),\n ...(asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {})\n };\n\n return asyncIterableIterator;\n}\n"],"mappings":";AAAO,SAAS,6BAAgC,eAA2D;AACzG,QAAM,wBAAkD;AAAA,IACtD,CAAC,OAAO,aAAa,GAAG,MAAM;AAAA,IAC9B,MAAM,cAAc,KAAK,KAAK,aAAa;AAAA,IAC3C,GAAI,cAAc,SAAS,EAAE,QAAQ,cAAc,OAAO,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,IACnF,GAAI,cAAc,QAAQ,EAAE,OAAO,cAAc,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,EAClF;AAEA,SAAO;AACT;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorFlatMap.ts
2
+ import flatMap from "core-js-pure/full/iterator/flat-map";
3
+ function iteratorFlatMap(iterable, mapperFn) {
4
+ return flatMap(iterable, mapperFn);
5
+ }
6
+
7
+ export {
8
+ iteratorFlatMap
9
+ };
10
+ //# sourceMappingURL=chunk-QX6EMOSQ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorFlatMap.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport flatMap from 'core-js-pure/full/iterator/flat-map';\n\n/**\n * `.flatMap` takes a mapping function as an argument. It returns an iterator that produces all elements of the iterators produced by applying the mapping function to the elements produced by the underlying iterator.\n *\n * @param mapperFn\n *\n * @return Returns an iterator of flat values.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFlatMap<T, U>(iterable: Iterable<T>, mapperFn: (value: T, index: number) => U): Iterator<T> {\n return flatMap(iterable, mapperFn);\n}\n"],"mappings":";AACA,OAAO,aAAa;AAWb,SAAS,gBAAsB,UAAuB,UAAuD;AAClH,SAAO,QAAQ,UAAU,QAAQ;AACnC;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorDrop.ts
2
+ import drop from "core-js-pure/full/iterator/drop";
3
+ function iteratorDrop(iterator, limit) {
4
+ return drop(iterator, limit);
5
+ }
6
+
7
+ export {
8
+ iteratorDrop
9
+ };
10
+ //# sourceMappingURL=chunk-R6SXIXMH.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorDrop.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport drop from 'core-js-pure/full/iterator/drop';\n\n/**\n * `drop` takes an integer as an argument. It skips the given number of elements produced by the underlying iterator before itself producing any remaining elements.\n *\n * @param limit\n *\n * @return Returns an iterator of items after the limit.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorDrop<T>(iterator: Iterator<T>, limit: number): Iterator<T> {\n return drop(iterator, limit);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAWV,SAAS,aAAgB,UAAuB,OAA4B;AACjF,SAAO,KAAK,UAAU,KAAK;AAC7B;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorFilter.ts
2
+ import filter from "core-js-pure/full/iterator/filter";
3
+ function iteratorFilter(iterator, predicate) {
4
+ return filter(iterator, predicate);
5
+ }
6
+
7
+ export {
8
+ iteratorFilter
9
+ };
10
+ //# sourceMappingURL=chunk-TDHR35S7.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorFilter.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport filter from 'core-js-pure/full/iterator/filter';\n\n/**\n * Returns the elements of an iterator that meet the condition specified in a callback function.\n *\n * @param predicate A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFilter<T, S extends T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => value is S\n): IterableIterator<S>;\n\n/**\n * Returns the elements of an iterator that meet the condition specified in a callback function.\n *\n * @param predicate A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFilter<T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => unknown\n): IterableIterator<T>;\n\nexport function iteratorFilter<T, S extends T>(\n iterator: Iterator<T>,\n predicate: (value: T, index: number) => unknown\n): IterableIterator<S> {\n return filter(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,YAAY;AA0BZ,SAAS,eACd,UACA,WACqB;AACrB,SAAO,OAAO,UAAU,SAAS;AACnC;","names":[]}
@@ -0,0 +1,10 @@
1
+ // src/iteratorTake.ts
2
+ import take from "core-js-pure/full/iterator/take";
3
+ function iteratorTake(iterator, limit) {
4
+ return take(iterator, limit);
5
+ }
6
+
7
+ export {
8
+ iteratorTake
9
+ };
10
+ //# sourceMappingURL=chunk-VCKLUCOT.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/iteratorTake.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport take from 'core-js-pure/full/iterator/take';\n\n/**\n * `take` takes an integer as an argument. It returns an iterator that produces, at most, the given number of elements produced by the underlying iterator.\n *\n * @param limit\n *\n * @return Returns an iterator with items from the original iterator from 0 until the limit.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorTake<T>(iterator: Iterator<T>, limit: number): Iterator<T> {\n return take(iterator, limit);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAWV,SAAS,aAAgB,UAAuB,OAA4B;AACjF,SAAO,KAAK,UAAU,KAAK;AAC7B;","names":[]}