synstate 0.1.1 → 1.0.0

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 (309) hide show
  1. package/README.md +317 -298
  2. package/dist/core/class/child-observable-class.d.mts.map +1 -1
  3. package/dist/core/class/child-observable-class.mjs +43 -10
  4. package/dist/core/class/child-observable-class.mjs.map +1 -1
  5. package/dist/core/class/observable-base-class.d.mts +4 -4
  6. package/dist/core/class/observable-base-class.d.mts.map +1 -1
  7. package/dist/core/class/observable-base-class.mjs +8 -8
  8. package/dist/core/class/observable-base-class.mjs.map +1 -1
  9. package/dist/core/class/root-observable-class.d.mts +1 -1
  10. package/dist/core/class/root-observable-class.d.mts.map +1 -1
  11. package/dist/core/class/root-observable-class.mjs +9 -9
  12. package/dist/core/class/root-observable-class.mjs.map +1 -1
  13. package/dist/core/combine/combine.d.mts +7 -7
  14. package/dist/core/combine/combine.mjs +13 -14
  15. package/dist/core/combine/combine.mjs.map +1 -1
  16. package/dist/core/combine/merge.d.mts +6 -6
  17. package/dist/core/combine/merge.mjs +9 -9
  18. package/dist/core/combine/merge.mjs.map +1 -1
  19. package/dist/core/combine/zip.d.mts +20 -19
  20. package/dist/core/combine/zip.d.mts.map +1 -1
  21. package/dist/core/combine/zip.mjs +22 -21
  22. package/dist/core/combine/zip.mjs.map +1 -1
  23. package/dist/core/create/{interval.d.mts → counter.d.mts} +14 -12
  24. package/dist/core/create/counter.d.mts.map +1 -0
  25. package/dist/core/create/{interval.mjs → counter.mjs} +21 -23
  26. package/dist/core/create/counter.mjs.map +1 -0
  27. package/dist/core/create/from-abortable-promise.d.mts +29 -0
  28. package/dist/core/create/from-abortable-promise.d.mts.map +1 -0
  29. package/dist/core/create/from-abortable-promise.mjs +70 -0
  30. package/dist/core/create/from-abortable-promise.mjs.map +1 -0
  31. package/dist/core/create/from-promise.d.mts +9 -6
  32. package/dist/core/create/from-promise.d.mts.map +1 -1
  33. package/dist/core/create/from-promise.mjs +8 -5
  34. package/dist/core/create/from-promise.mjs.map +1 -1
  35. package/dist/core/create/from-subscribable.d.mts +4 -4
  36. package/dist/core/create/from-subscribable.mjs +4 -4
  37. package/dist/core/create/index.d.mts +3 -3
  38. package/dist/core/create/index.d.mts.map +1 -1
  39. package/dist/core/create/index.mjs +4 -4
  40. package/dist/core/create/just.d.mts +32 -0
  41. package/dist/core/create/just.d.mts.map +1 -0
  42. package/dist/core/create/just.mjs +44 -0
  43. package/dist/core/create/just.mjs.map +1 -0
  44. package/dist/core/create/source.d.mts +7 -12
  45. package/dist/core/create/source.d.mts.map +1 -1
  46. package/dist/core/create/source.mjs +1 -6
  47. package/dist/core/create/source.mjs.map +1 -1
  48. package/dist/core/create/timer.d.mts +6 -4
  49. package/dist/core/create/timer.d.mts.map +1 -1
  50. package/dist/core/create/timer.mjs +6 -7
  51. package/dist/core/create/timer.mjs.map +1 -1
  52. package/dist/core/index.d.mts +1 -1
  53. package/dist/core/index.d.mts.map +1 -1
  54. package/dist/core/index.mjs +21 -14
  55. package/dist/core/index.mjs.map +1 -1
  56. package/dist/core/operators/audit.d.mts +97 -0
  57. package/dist/core/operators/audit.d.mts.map +1 -0
  58. package/dist/core/operators/audit.mjs +144 -0
  59. package/dist/core/operators/audit.mjs.map +1 -0
  60. package/dist/core/operators/debounce.d.mts +88 -0
  61. package/dist/core/operators/debounce.d.mts.map +1 -0
  62. package/dist/core/operators/debounce.mjs +130 -0
  63. package/dist/core/operators/debounce.mjs.map +1 -0
  64. package/dist/core/operators/filter.d.mts +5 -5
  65. package/dist/core/operators/filter.mjs +3 -3
  66. package/dist/core/operators/filter.mjs.map +1 -1
  67. package/dist/core/operators/index.d.mts +4 -4
  68. package/dist/core/operators/index.d.mts.map +1 -1
  69. package/dist/core/operators/index.mjs +6 -6
  70. package/dist/core/operators/map.d.mts +41 -0
  71. package/dist/core/operators/map.d.mts.map +1 -0
  72. package/dist/core/operators/map.mjs +71 -0
  73. package/dist/core/operators/map.mjs.map +1 -0
  74. package/dist/core/operators/merge-map.d.mts +57 -30
  75. package/dist/core/operators/merge-map.d.mts.map +1 -1
  76. package/dist/core/operators/merge-map.mjs +59 -32
  77. package/dist/core/operators/merge-map.mjs.map +1 -1
  78. package/dist/core/operators/pairwise.d.mts +6 -6
  79. package/dist/core/operators/pairwise.mjs +9 -9
  80. package/dist/core/operators/pairwise.mjs.map +1 -1
  81. package/dist/core/operators/scan.d.mts +6 -6
  82. package/dist/core/operators/scan.mjs +9 -9
  83. package/dist/core/operators/scan.mjs.map +1 -1
  84. package/dist/core/operators/skip-if-no-change.d.mts +21 -9
  85. package/dist/core/operators/skip-if-no-change.d.mts.map +1 -1
  86. package/dist/core/operators/skip-if-no-change.mjs +25 -13
  87. package/dist/core/operators/skip-if-no-change.mjs.map +1 -1
  88. package/dist/core/operators/skip-until.d.mts +5 -5
  89. package/dist/core/operators/skip-until.mjs +8 -8
  90. package/dist/core/operators/skip-until.mjs.map +1 -1
  91. package/dist/core/operators/skip-while.d.mts +18 -9
  92. package/dist/core/operators/skip-while.d.mts.map +1 -1
  93. package/dist/core/operators/skip-while.mjs +28 -16
  94. package/dist/core/operators/skip-while.mjs.map +1 -1
  95. package/dist/core/operators/switch-map.d.mts +57 -26
  96. package/dist/core/operators/switch-map.d.mts.map +1 -1
  97. package/dist/core/operators/switch-map.mjs +59 -28
  98. package/dist/core/operators/switch-map.mjs.map +1 -1
  99. package/dist/core/operators/take-until.d.mts +5 -5
  100. package/dist/core/operators/take-until.mjs +8 -8
  101. package/dist/core/operators/take-until.mjs.map +1 -1
  102. package/dist/core/operators/take-while.d.mts +15 -8
  103. package/dist/core/operators/take-while.d.mts.map +1 -1
  104. package/dist/core/operators/take-while.mjs +19 -13
  105. package/dist/core/operators/take-while.mjs.map +1 -1
  106. package/dist/core/operators/throttle.d.mts +81 -0
  107. package/dist/core/operators/throttle.d.mts.map +1 -0
  108. package/dist/core/operators/throttle.mjs +126 -0
  109. package/dist/core/operators/throttle.mjs.map +1 -0
  110. package/dist/core/operators/with-buffered-from.d.mts +13 -9
  111. package/dist/core/operators/with-buffered-from.d.mts.map +1 -1
  112. package/dist/core/operators/with-buffered-from.mjs +17 -13
  113. package/dist/core/operators/with-buffered-from.mjs.map +1 -1
  114. package/dist/core/operators/with-current-value-from.d.mts +14 -9
  115. package/dist/core/operators/with-current-value-from.d.mts.map +1 -1
  116. package/dist/core/operators/with-current-value-from.mjs +18 -13
  117. package/dist/core/operators/with-current-value-from.mjs.map +1 -1
  118. package/dist/core/operators/with-initial-value.d.mts +5 -5
  119. package/dist/core/operators/with-initial-value.mjs +8 -8
  120. package/dist/core/operators/with-initial-value.mjs.map +1 -1
  121. package/dist/core/predefined/index.d.mts +2 -0
  122. package/dist/core/predefined/index.d.mts.map +1 -0
  123. package/dist/core/predefined/index.mjs +12 -0
  124. package/dist/core/predefined/index.mjs.map +1 -0
  125. package/dist/core/predefined/operators/attach-index.d.mts +57 -0
  126. package/dist/core/predefined/operators/attach-index.d.mts.map +1 -0
  127. package/dist/core/predefined/operators/attach-index.mjs +62 -0
  128. package/dist/core/predefined/operators/attach-index.mjs.map +1 -0
  129. package/dist/core/predefined/operators/index.d.mts +12 -0
  130. package/dist/core/predefined/operators/index.d.mts.map +1 -0
  131. package/dist/core/predefined/operators/index.mjs +12 -0
  132. package/dist/core/predefined/operators/index.mjs.map +1 -0
  133. package/dist/core/predefined/operators/map-optional.d.mts +51 -0
  134. package/dist/core/predefined/operators/map-optional.d.mts.map +1 -0
  135. package/dist/core/predefined/operators/map-optional.mjs +55 -0
  136. package/dist/core/predefined/operators/map-optional.mjs.map +1 -0
  137. package/dist/core/predefined/operators/map-result-err.d.mts +51 -0
  138. package/dist/core/predefined/operators/map-result-err.d.mts.map +1 -0
  139. package/dist/core/predefined/operators/map-result-err.mjs +55 -0
  140. package/dist/core/predefined/operators/map-result-err.mjs.map +1 -0
  141. package/dist/core/predefined/operators/map-result-ok.d.mts +51 -0
  142. package/dist/core/predefined/operators/map-result-ok.d.mts.map +1 -0
  143. package/dist/core/predefined/operators/map-result-ok.mjs +55 -0
  144. package/dist/core/predefined/operators/map-result-ok.mjs.map +1 -0
  145. package/dist/core/predefined/operators/map-to.d.mts +43 -0
  146. package/dist/core/predefined/operators/map-to.d.mts.map +1 -0
  147. package/dist/core/predefined/operators/map-to.mjs +48 -0
  148. package/dist/core/predefined/operators/map-to.mjs.map +1 -0
  149. package/dist/core/predefined/operators/pluck.d.mts +47 -0
  150. package/dist/core/predefined/operators/pluck.d.mts.map +1 -0
  151. package/dist/core/predefined/operators/pluck.mjs +52 -0
  152. package/dist/core/predefined/operators/pluck.mjs.map +1 -0
  153. package/dist/core/predefined/operators/skip.d.mts +50 -0
  154. package/dist/core/predefined/operators/skip.d.mts.map +1 -0
  155. package/dist/core/predefined/operators/skip.mjs +56 -0
  156. package/dist/core/predefined/operators/skip.mjs.map +1 -0
  157. package/dist/core/predefined/operators/take.d.mts +44 -0
  158. package/dist/core/predefined/operators/take.d.mts.map +1 -0
  159. package/dist/core/predefined/operators/take.mjs +49 -0
  160. package/dist/core/predefined/operators/take.mjs.map +1 -0
  161. package/dist/core/predefined/operators/unwrap-optional.d.mts +44 -0
  162. package/dist/core/predefined/operators/unwrap-optional.d.mts.map +1 -0
  163. package/dist/core/predefined/operators/unwrap-optional.mjs +50 -0
  164. package/dist/core/predefined/operators/unwrap-optional.mjs.map +1 -0
  165. package/dist/core/predefined/operators/unwrap-result-err.d.mts +44 -0
  166. package/dist/core/predefined/operators/unwrap-result-err.d.mts.map +1 -0
  167. package/dist/core/predefined/operators/unwrap-result-err.mjs +48 -0
  168. package/dist/core/predefined/operators/unwrap-result-err.mjs.map +1 -0
  169. package/dist/core/predefined/operators/unwrap-result-ok.d.mts +44 -0
  170. package/dist/core/predefined/operators/unwrap-result-ok.d.mts.map +1 -0
  171. package/dist/core/predefined/operators/unwrap-result-ok.mjs +50 -0
  172. package/dist/core/predefined/operators/unwrap-result-ok.mjs.map +1 -0
  173. package/dist/core/types/id.d.mts +1 -1
  174. package/dist/core/types/id.d.mts.map +1 -1
  175. package/dist/core/types/index.d.mts +1 -0
  176. package/dist/core/types/index.d.mts.map +1 -1
  177. package/dist/core/types/observable-family.d.mts +8 -14
  178. package/dist/core/types/observable-family.d.mts.map +1 -1
  179. package/dist/core/types/observable.d.mts +3 -3
  180. package/dist/core/types/observable.d.mts.map +1 -1
  181. package/dist/core/types/timer.d.mts +2 -0
  182. package/dist/core/types/timer.d.mts.map +1 -0
  183. package/dist/core/types/timer.mjs +2 -0
  184. package/dist/core/types/timer.mjs.map +1 -0
  185. package/dist/core/utils/id-maker.d.mts +2 -2
  186. package/dist/core/utils/id-maker.d.mts.map +1 -1
  187. package/dist/core/utils/id-maker.mjs +3 -3
  188. package/dist/core/utils/id-maker.mjs.map +1 -1
  189. package/dist/core/utils/index.mjs +1 -1
  190. package/dist/entry-point.mjs +24 -15
  191. package/dist/entry-point.mjs.map +1 -1
  192. package/dist/globals.d.mts +0 -3
  193. package/dist/index.mjs +24 -15
  194. package/dist/index.mjs.map +1 -1
  195. package/dist/utils/collect-to-array.d.mts +3 -0
  196. package/dist/utils/collect-to-array.d.mts.map +1 -0
  197. package/dist/utils/collect-to-array.mjs +11 -0
  198. package/dist/utils/collect-to-array.mjs.map +1 -0
  199. package/dist/utils/create-boolean-state.d.mts +40 -0
  200. package/dist/utils/create-boolean-state.d.mts.map +1 -0
  201. package/dist/utils/create-boolean-state.mjs +53 -0
  202. package/dist/utils/create-boolean-state.mjs.map +1 -0
  203. package/dist/utils/create-event-emitter.d.mts +4 -4
  204. package/dist/utils/create-event-emitter.mjs +4 -4
  205. package/dist/utils/create-reducer.d.mts +10 -7
  206. package/dist/utils/create-reducer.d.mts.map +1 -1
  207. package/dist/utils/create-reducer.mjs +7 -7
  208. package/dist/utils/create-reducer.mjs.map +1 -1
  209. package/dist/utils/create-state.d.mts +8 -48
  210. package/dist/utils/create-state.d.mts.map +1 -1
  211. package/dist/utils/create-state.mjs +10 -60
  212. package/dist/utils/create-state.mjs.map +1 -1
  213. package/dist/utils/index.d.mts +2 -0
  214. package/dist/utils/index.d.mts.map +1 -1
  215. package/dist/utils/index.mjs +3 -1
  216. package/dist/utils/index.mjs.map +1 -1
  217. package/package.json +17 -11
  218. package/src/core/class/child-observable-class.mts +65 -9
  219. package/src/core/class/circular-dependency-comparison.test.mts +142 -0
  220. package/src/core/class/circular-dependency.test.mts +251 -0
  221. package/src/core/class/observable-base-class.mts +9 -9
  222. package/src/core/class/root-observable-class.mts +14 -10
  223. package/src/core/combine/combine.mts +15 -15
  224. package/src/core/combine/merge.mts +13 -14
  225. package/src/core/combine/zip.mts +26 -25
  226. package/src/core/create/{interval.mts → counter.mts} +32 -30
  227. package/src/core/create/from-abortable-promise.mts +83 -0
  228. package/src/core/create/from-promise.mts +10 -7
  229. package/src/core/create/from-subscribable.mts +4 -4
  230. package/src/core/create/index.mts +3 -3
  231. package/src/core/create/just.mts +43 -0
  232. package/src/core/create/source.mts +10 -14
  233. package/src/core/create/timer.mts +12 -11
  234. package/src/core/index.mts +1 -1
  235. package/src/core/operators/audit.mts +172 -0
  236. package/src/core/operators/debounce.mts +154 -0
  237. package/src/core/operators/filter.mts +9 -9
  238. package/src/core/operators/index.mts +4 -4
  239. package/src/core/operators/map.mts +124 -0
  240. package/src/core/operators/merge-map.mts +60 -33
  241. package/src/core/operators/pairwise.mts +10 -10
  242. package/src/core/operators/scan.mts +10 -10
  243. package/src/core/operators/skip-if-no-change.mts +26 -14
  244. package/src/core/operators/skip-until.mts +9 -9
  245. package/src/core/operators/skip-while.mts +30 -28
  246. package/src/core/operators/switch-map.mts +60 -29
  247. package/src/core/operators/take-until.mts +9 -9
  248. package/src/core/operators/take-while.mts +21 -19
  249. package/src/core/operators/{throttle-time.mts → throttle.mts} +58 -38
  250. package/src/core/operators/with-buffered-from.mts +18 -14
  251. package/src/core/operators/with-current-value-from.mts +19 -14
  252. package/src/core/operators/with-initial-value.mts +9 -9
  253. package/src/core/predefined/index.mts +1 -0
  254. package/src/core/predefined/operators/attach-index.mts +62 -0
  255. package/src/core/predefined/operators/index.mts +11 -0
  256. package/src/core/predefined/operators/map-optional.mts +55 -0
  257. package/src/core/predefined/operators/map-result-err.mts +55 -0
  258. package/src/core/predefined/operators/map-result-ok.mts +55 -0
  259. package/src/core/predefined/operators/map-to.mts +45 -0
  260. package/src/core/predefined/operators/pluck.mts +51 -0
  261. package/src/core/predefined/operators/skip.mts +57 -0
  262. package/src/core/predefined/operators/take.mts +47 -0
  263. package/src/core/predefined/operators/unwrap-optional.mts +49 -0
  264. package/src/core/predefined/operators/unwrap-result-err.mts +48 -0
  265. package/src/core/predefined/operators/unwrap-result-ok.mts +49 -0
  266. package/src/core/types/id.mts +1 -1
  267. package/src/core/types/index.mts +1 -0
  268. package/src/core/types/observable-family.mts +8 -24
  269. package/src/core/types/observable.mts +3 -3
  270. package/src/core/types/timer.mts +2 -0
  271. package/src/core/utils/id-maker.mts +4 -4
  272. package/src/globals.d.mts +0 -3
  273. package/src/utils/collect-to-array.mts +17 -0
  274. package/src/utils/create-boolean-state.mts +68 -0
  275. package/src/utils/create-event-emitter.mts +4 -4
  276. package/src/utils/create-reducer.mts +11 -8
  277. package/src/utils/create-state.mts +10 -75
  278. package/src/utils/index.mts +2 -0
  279. package/dist/core/create/from-array.d.mts +0 -39
  280. package/dist/core/create/from-array.d.mts.map +0 -1
  281. package/dist/core/create/from-array.mjs +0 -65
  282. package/dist/core/create/from-array.mjs.map +0 -1
  283. package/dist/core/create/interval.d.mts.map +0 -1
  284. package/dist/core/create/interval.mjs.map +0 -1
  285. package/dist/core/create/of.d.mts +0 -39
  286. package/dist/core/create/of.d.mts.map +0 -1
  287. package/dist/core/create/of.mjs +0 -63
  288. package/dist/core/create/of.mjs.map +0 -1
  289. package/dist/core/operators/audit-time.d.mts +0 -62
  290. package/dist/core/operators/audit-time.d.mts.map +0 -1
  291. package/dist/core/operators/audit-time.mjs +0 -109
  292. package/dist/core/operators/audit-time.mjs.map +0 -1
  293. package/dist/core/operators/debounce-time.d.mts +0 -51
  294. package/dist/core/operators/debounce-time.d.mts.map +0 -1
  295. package/dist/core/operators/debounce-time.mjs +0 -93
  296. package/dist/core/operators/debounce-time.mjs.map +0 -1
  297. package/dist/core/operators/map-with-index.d.mts +0 -54
  298. package/dist/core/operators/map-with-index.d.mts.map +0 -1
  299. package/dist/core/operators/map-with-index.mjs +0 -88
  300. package/dist/core/operators/map-with-index.mjs.map +0 -1
  301. package/dist/core/operators/throttle-time.d.mts +0 -62
  302. package/dist/core/operators/throttle-time.d.mts.map +0 -1
  303. package/dist/core/operators/throttle-time.mjs +0 -107
  304. package/dist/core/operators/throttle-time.mjs.map +0 -1
  305. package/src/core/create/from-array.mts +0 -76
  306. package/src/core/create/of.mts +0 -73
  307. package/src/core/operators/audit-time.mts +0 -136
  308. package/src/core/operators/debounce-time.mts +0 -116
  309. package/src/core/operators/map-with-index.mts +0 -183
@@ -0,0 +1,126 @@
1
+ import { Optional } from 'ts-data-forge';
2
+ import { SyncChildObservableClass } from '../class/child-observable-class.mjs';
3
+ import '../utils/id-maker.mjs';
4
+
5
+ /**
6
+ * Emits the first value, then ignores subsequent values for a specified duration.
7
+ * After the duration, the next emission is allowed through.
8
+ *
9
+ * @template A - The type of values from the source
10
+ * @param milliSeconds - The throttle duration in milliseconds
11
+ * @returns An operator that throttles emissions
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * // Timeline (250ms throttle):
16
+ * //
17
+ * // Time(x50ms) 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
18
+ * //
19
+ * // input$ 0 2 3 9 10 11 12 13 14
20
+ * // |- 250ms -> |- 250ms -> |- 250ms -> |- 250ms ->
21
+ * // throttled$ 0 3 9 12 (emitted at start of window)
22
+ * //
23
+ * // Explanation:
24
+ * // - throttle emits the FIRST value received, then ignores subsequent values
25
+ * // for the specified duration (250ms)
26
+ * // - Unlike audit (which emits the LAST value), throttle emits the FIRST
27
+ * // - Useful for rate-limiting scroll/resize events
28
+ *
29
+ * const input$ = source<number>();
30
+ *
31
+ * const throttled$ = input$.pipe(throttle(250));
32
+ *
33
+ * const valueHistory: number[] = [];
34
+ *
35
+ * throttled$.subscribe((value) => {
36
+ * valueHistory.push(value);
37
+ * });
38
+ *
39
+ * const sleep = (ms: number): Promise<void> =>
40
+ * new Promise((resolve) => {
41
+ * setTimeout(resolve, ms);
42
+ * });
43
+ *
44
+ * input$.next(0);
45
+ *
46
+ * assert.deepStrictEqual(valueHistory, [0]);
47
+ *
48
+ * await sleep(200);
49
+ *
50
+ * input$.next(2);
51
+ *
52
+ * assert.deepStrictEqual(valueHistory, [0]);
53
+ *
54
+ * await sleep(100);
55
+ *
56
+ * input$.next(3);
57
+ *
58
+ * assert.deepStrictEqual(valueHistory, [0, 3]);
59
+ *
60
+ * await sleep(300);
61
+ *
62
+ * input$.next(9);
63
+ *
64
+ * assert.deepStrictEqual(valueHistory, [0, 3, 9]);
65
+ *
66
+ * await sleep(100);
67
+ *
68
+ * input$.next(10);
69
+ *
70
+ * await sleep(100);
71
+ *
72
+ * input$.next(11);
73
+ *
74
+ * assert.deepStrictEqual(valueHistory, [0, 3, 9]);
75
+ *
76
+ * await sleep(100);
77
+ *
78
+ * input$.next(12);
79
+ *
80
+ * assert.deepStrictEqual(valueHistory, [0, 3, 9, 12]);
81
+ * ```
82
+ */
83
+ const throttle = (milliSeconds) =>
84
+ // eslint-disable-next-line total-functions/no-unsafe-type-assertion
85
+ ((parentObservable) => new ThrottleObservableClass(parentObservable, milliSeconds));
86
+ class ThrottleObservableClass extends SyncChildObservableClass {
87
+ #milliSeconds;
88
+ #mut_timerId;
89
+ #mut_isSkipping;
90
+ constructor(parentObservable, milliSeconds) {
91
+ super({
92
+ parents: [parentObservable],
93
+ initialValue: parentObservable.getSnapshot(),
94
+ });
95
+ this.#mut_timerId = undefined;
96
+ this.#mut_isSkipping = false;
97
+ this.#milliSeconds = milliSeconds;
98
+ }
99
+ tryUpdate(updateToken) {
100
+ const par = this.parents[0];
101
+ const sn = par.getSnapshot();
102
+ if (par.updateToken !== updateToken ||
103
+ Optional.isNone(sn) ||
104
+ this.#mut_isSkipping) {
105
+ return; // skip update
106
+ }
107
+ this.setNext(sn.value, updateToken);
108
+ this.#mut_isSkipping = true;
109
+ // set timer
110
+ this.#mut_timerId = setTimeout(() => {
111
+ this.#mut_isSkipping = false;
112
+ }, this.#milliSeconds);
113
+ }
114
+ #resetTimer() {
115
+ if (this.#mut_timerId !== undefined) {
116
+ clearTimeout(this.#mut_timerId);
117
+ }
118
+ }
119
+ complete() {
120
+ this.#resetTimer();
121
+ super.complete();
122
+ }
123
+ }
124
+
125
+ export { throttle };
126
+ //# sourceMappingURL=throttle.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"throttle.mjs","sources":["../../../src/core/operators/throttle.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EG;AACI,MAAM,QAAQ,GAAG,CACtB,YAAoB;AAEpB;AACA,CAAC,CAAC,gBAAgB,KAChB,IAAI,uBAAuB,CACzB,gBAAgB,EAChB,YAAY,CACb;AAEL,MAAM,uBACJ,SAAQ,wBAAyC,CAAA;AAGxC,IAAA,aAAa;AACtB,IAAA,YAAY;AACZ,IAAA,eAAe;IAEf,WAAA,CAAY,gBAA+B,EAAE,YAAoB,EAAA;AAC/D,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;AAC3B,YAAA,YAAY,EAAE,gBAAgB,CAAC,WAAW,EAAE;AAC7C,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,YAAY,GAAG,SAAS;AAE7B,QAAA,IAAI,CAAC,eAAe,GAAG,KAAK;AAE5B,QAAA,IAAI,CAAC,aAAa,GAAG,YAAY;IACnC;AAES,IAAA,SAAS,CAAC,WAAwB,EAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IACE,GAAG,CAAC,WAAW,KAAK,WAAW;AAC/B,YAAA,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,eAAe,EACpB;AACA,YAAA,OAAO;QACT;QAEA,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC;AAEnC,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI;;AAG3B,QAAA,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,MAAK;AAClC,YAAA,IAAI,CAAC,eAAe,GAAG,KAAK;AAC9B,QAAA,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC;IACxB;IAEA,WAAW,GAAA;AACT,QAAA,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE;AACnC,YAAA,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QACjC;IACF;IAES,QAAQ,GAAA;QACf,IAAI,CAAC,WAAW,EAAE;QAElB,KAAK,CAAC,QAAQ,EAAE;IAClB;AACD;;;;"}
@@ -28,30 +28,34 @@ import { type KeepInitialValueOperator, type Observable } from '../types/index.m
28
28
  *
29
29
  * const result$ = trigger$.pipe(withBufferedFrom(data$));
30
30
  *
31
- * const mut_history: (readonly [number, readonly string[]])[] = [];
31
+ * const valueHistory: (readonly [number, readonly string[]])[] = [];
32
32
  *
33
33
  * result$.subscribe(([triggerValue, bufferedData]) => {
34
- * mut_history.push([triggerValue, bufferedData]);
34
+ * valueHistory.push([triggerValue, bufferedData]);
35
35
  * });
36
36
  *
37
- * data$.next('a');
37
+ * data$.next('A');
38
38
  *
39
- * data$.next('b');
39
+ * data$.next('B');
40
40
  *
41
41
  * trigger$.next(1);
42
42
  *
43
- * assert.deepStrictEqual(mut_history, [[1, ['a', 'b']]]);
43
+ * assert.deepStrictEqual(valueHistory, [[1, ['A', 'B']]]);
44
44
  *
45
- * data$.next('c');
45
+ * data$.next('C');
46
46
  *
47
47
  * trigger$.next(2);
48
48
  *
49
- * assert.deepStrictEqual(mut_history, [
50
- * [1, ['a', 'b']],
51
- * [2, ['c']],
49
+ * assert.deepStrictEqual(valueHistory, [
50
+ * [1, ['A', 'B']],
51
+ * [2, ['C']],
52
52
  * ]);
53
53
  * ```
54
54
  */
55
55
  export declare const withBufferedFrom: <A, B>(observable: Observable<B>) => KeepInitialValueOperator<A, readonly [A, readonly B[]]>;
56
+ /**
57
+ * Alias for `withBufferedFrom`.
58
+ * @see withBufferedFrom
59
+ */
56
60
  export declare const withBuffered: <A, B>(observable: Observable<B>) => KeepInitialValueOperator<A, readonly [A, readonly B[]]>;
57
61
  //# sourceMappingURL=with-buffered-from.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"with-buffered-from.d.mts","sourceRoot":"","sources":["../../../src/core/operators/with-buffered-from.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,EACnC,YAAY,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAMQ,CAAC;AAElE,eAAO,MAAM,YAAY,GAVQ,CAAC,EAAE,CAAC,cACvB,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAQb,CAAC"}
1
+ {"version":3,"file":"with-buffered-from.d.mts","sourceRoot":"","sources":["../../../src/core/operators/with-buffered-from.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,EACnC,YAAY,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAMQ,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAdQ,CAAC,EAAE,CAAC,cACvB,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAYb,CAAC"}
@@ -32,34 +32,38 @@ import { maxDepth } from '../utils/max-depth.mjs';
32
32
  *
33
33
  * const result$ = trigger$.pipe(withBufferedFrom(data$));
34
34
  *
35
- * const mut_history: (readonly [number, readonly string[]])[] = [];
35
+ * const valueHistory: (readonly [number, readonly string[]])[] = [];
36
36
  *
37
37
  * result$.subscribe(([triggerValue, bufferedData]) => {
38
- * mut_history.push([triggerValue, bufferedData]);
38
+ * valueHistory.push([triggerValue, bufferedData]);
39
39
  * });
40
40
  *
41
- * data$.next('a');
41
+ * data$.next('A');
42
42
  *
43
- * data$.next('b');
43
+ * data$.next('B');
44
44
  *
45
45
  * trigger$.next(1);
46
46
  *
47
- * assert.deepStrictEqual(mut_history, [[1, ['a', 'b']]]);
47
+ * assert.deepStrictEqual(valueHistory, [[1, ['A', 'B']]]);
48
48
  *
49
- * data$.next('c');
49
+ * data$.next('C');
50
50
  *
51
51
  * trigger$.next(2);
52
52
  *
53
- * assert.deepStrictEqual(mut_history, [
54
- * [1, ['a', 'b']],
55
- * [2, ['c']],
53
+ * assert.deepStrictEqual(valueHistory, [
54
+ * [1, ['A', 'B']],
55
+ * [2, ['C']],
56
56
  * ]);
57
57
  * ```
58
58
  */
59
59
  const withBufferedFrom = (observable) =>
60
60
  // eslint-disable-next-line total-functions/no-unsafe-type-assertion
61
61
  ((parentObservable) => new WithBufferedFromObservableClass(parentObservable, observable));
62
- const withBuffered = withBufferedFrom; // alias
62
+ /**
63
+ * Alias for `withBufferedFrom`.
64
+ * @see withBufferedFrom
65
+ */
66
+ const withBuffered = withBufferedFrom;
63
67
  class WithBufferedFromObservableClass extends SyncChildObservableClass {
64
68
  #mut_bufferedValues = [];
65
69
  constructor(parentObservable, observable) {
@@ -80,13 +84,13 @@ class WithBufferedFromObservableClass extends SyncChildObservableClass {
80
84
  this.#mut_bufferedValues = Arr.toPushed(this.#mut_bufferedValues, value);
81
85
  });
82
86
  }
83
- tryUpdate(updaterSymbol) {
87
+ tryUpdate(updateToken) {
84
88
  const par = this.parents[0];
85
89
  const sn = par.getSnapshot();
86
- if (par.updaterSymbol !== updaterSymbol || Optional.isNone(sn)) {
90
+ if (par.updateToken !== updateToken || Optional.isNone(sn)) {
87
91
  return; // skip update
88
92
  }
89
- this.setNext([sn.value, this.#mut_bufferedValues], updaterSymbol);
93
+ this.setNext([sn.value, this.#mut_bufferedValues], updateToken);
90
94
  this.#clearBuffer();
91
95
  }
92
96
  #clearBuffer() {
@@ -1 +1 @@
1
- {"version":3,"file":"with-buffered-from.mjs","sources":["../../../src/core/operators/with-buffered-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDG;AACI,MAAM,gBAAgB,GAAG,CAC9B,UAAyB;AAEzB;AACA,CAAC,CAAC,gBAAgB,KAChB,IAAI,+BAA+B,CACjC,gBAAgB,EAChB,UAAU,CACX;AAEE,MAAM,YAAY,GAAG,iBAAiB;AAE7C,MAAM,+BACJ,SAAQ,wBAAkE,CAAA;IAG1E,mBAAmB,GAAiB,EAAE;IAEtC,WAAA,CAAY,gBAA+B,EAAE,UAAyB,EAAA;AACpE,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;YAC3B,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC;AACjB,gBAAA,GAAG,EAAE,gBAAgB,CAAC,WAAW,EAAE;AACnC,gBAAA,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE;AAC7B,aAAA,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KACjB,QAAQ,CAAC,MAAM,CAAC,GAAG;kBACf,QAAQ,CAAC;AACX,kBAAE,QAAQ,CAAC,IAAI,CAAC;AACZ,oBAAA,GAAG,CAAC,KAAK;AACT,oBAAA,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;iBAC7B,CAAC,CAChB,CAAC,KAAK;AACR,SAAA,CAAC;AAEF,QAAA,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,KAAI;AAC7B,YAAA,IAAI,CAAC,mBAAmB,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC;AAC1E,QAAA,CAAC,CAAC;IACJ;AAES,IAAA,SAAS,CAAC,aAA4B,EAAA;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC9D,YAAA,OAAO;QACT;AAEA,QAAA,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC;QAEjE,IAAI,CAAC,YAAY,EAAE;IACrB;IAEA,YAAY,GAAA;AACV,QAAA,IAAI,CAAC,mBAAmB,GAAG,EAAE;IAC/B;AACD;;;;"}
1
+ {"version":3,"file":"with-buffered-from.mjs","sources":["../../../src/core/operators/with-buffered-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDG;AACI,MAAM,gBAAgB,GAAG,CAC9B,UAAyB;AAEzB;AACA,CAAC,CAAC,gBAAgB,KAChB,IAAI,+BAA+B,CACjC,gBAAgB,EAChB,UAAU,CACX;AAEL;;;AAGG;AACI,MAAM,YAAY,GAAG;AAE5B,MAAM,+BACJ,SAAQ,wBAAkE,CAAA;IAG1E,mBAAmB,GAAiB,EAAE;IAEtC,WAAA,CAAY,gBAA+B,EAAE,UAAyB,EAAA;AACpE,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;YAC3B,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC;AACjB,gBAAA,GAAG,EAAE,gBAAgB,CAAC,WAAW,EAAE;AACnC,gBAAA,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE;AAC7B,aAAA,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KACjB,QAAQ,CAAC,MAAM,CAAC,GAAG;kBACf,QAAQ,CAAC;AACX,kBAAE,QAAQ,CAAC,IAAI,CAAC;AACZ,oBAAA,GAAG,CAAC,KAAK;AACT,oBAAA,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;iBAC7B,CAAC,CAChB,CAAC,KAAK;AACR,SAAA,CAAC;AAEF,QAAA,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,KAAI;AAC7B,YAAA,IAAI,CAAC,mBAAmB,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC;AAC1E,QAAA,CAAC,CAAC;IACJ;AAES,IAAA,SAAS,CAAC,WAAwB,EAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC1D,YAAA,OAAO;QACT;AAEA,QAAA,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC;QAE/D,IAAI,CAAC,YAAY,EAAE;IACrB;IAEA,YAAY,GAAA;AACV,QAAA,IAAI,CAAC,mBAAmB,GAAG,EAAE;IAC/B;AACD;;;;"}
@@ -13,14 +13,15 @@ import { type DropInitialValueOperator, type Observable } from '../types/index.m
13
13
  * // Timeline:
14
14
  * //
15
15
  * // name$ "Alice" "Bob" "Charlie"
16
- * // age$ 25 30 35 40
17
- * // result$ ["Alice",25] ["Bob",30] ["Bob",35] ["Charlie",40]
16
+ * // age$ 25 30
17
+ * // result$ (skip) ["Bob",25] ["Charlie",30]
18
18
  * //
19
19
  * // Explanation:
20
20
  * // - withCurrentValueFrom samples the current value from another observable
21
- * // - Emits a tuple [sourceValue, sampledValue] each time the source emits
21
+ * // - Emits a tuple [sourceValue, sampledValue] each time the SOURCE emits
22
+ * // - Does NOT emit when the sampled observable (age$) emits
22
23
  * // - Does not emit until both observables have emitted at least once
23
- * // - Similar to combine, but only emits when the source (not the sampled) emits
24
+ * // - "Alice" is skipped because age$ hasn't emitted yet
24
25
  *
25
26
  * const name$ = source<string>();
26
27
  *
@@ -28,32 +29,36 @@ import { type DropInitialValueOperator, type Observable } from '../types/index.m
28
29
  *
29
30
  * const result$ = name$.pipe(withCurrentValueFrom(age$));
30
31
  *
31
- * const mut_history: (readonly [string, number])[] = [];
32
+ * const valueHistory: (readonly [string, number])[] = [];
32
33
  *
33
34
  * result$.subscribe(([name_, currentAge]) => {
34
- * mut_history.push([name_, currentAge]);
35
+ * valueHistory.push([name_, currentAge]);
35
36
  * });
36
37
  *
37
38
  * name$.next('Alice'); // nothing logged (age$ hasn't emitted)
38
39
  *
39
- * assert.deepStrictEqual(mut_history, []);
40
+ * assert.deepStrictEqual(valueHistory, []);
40
41
  *
41
42
  * age$.next(25);
42
43
  *
43
44
  * name$.next('Bob'); // logs: Bob is 25 years old
44
45
  *
45
- * assert.deepStrictEqual(mut_history, [['Bob', 25]]);
46
+ * assert.deepStrictEqual(valueHistory, [['Bob', 25]]);
46
47
  *
47
48
  * age$.next(30);
48
49
  *
49
50
  * name$.next('Charlie'); // logs: Charlie is 30 years old
50
51
  *
51
- * assert.deepStrictEqual(mut_history, [
52
+ * assert.deepStrictEqual(valueHistory, [
52
53
  * ['Bob', 25],
53
54
  * ['Charlie', 30],
54
55
  * ]);
55
56
  * ```
56
57
  */
57
58
  export declare const withCurrentValueFrom: <A, B>(observable: Observable<B>) => DropInitialValueOperator<A, readonly [A, B]>;
59
+ /**
60
+ * Alias for `withCurrentValueFrom`.
61
+ * @see withCurrentValueFrom
62
+ */
58
63
  export declare const withLatestFrom: <A, B>(observable: Observable<B>) => DropInitialValueOperator<A, readonly [A, B]>;
59
64
  //# sourceMappingURL=with-current-value-from.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"with-current-value-from.d.mts","sourceRoot":"","sources":["../../../src/core/operators/with-current-value-from.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,oBAAoB,GAC9B,CAAC,EAAE,CAAC,EACH,YAAY,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAEyB,CAAC;AAE1E,eAAO,MAAM,cAAc,GANxB,CAAC,EAAE,CAAC,cACS,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAIE,CAAC"}
1
+ {"version":3,"file":"with-current-value-from.d.mts","sourceRoot":"","sources":["../../../src/core/operators/with-current-value-from.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,oBAAoB,GAC9B,CAAC,EAAE,CAAC,EACH,YAAY,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAEyB,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,cAAc,GAVxB,CAAC,EAAE,CAAC,cACS,UAAU,CAAC,CAAC,CAAC,KACxB,wBAAwB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAQE,CAAC"}
@@ -17,14 +17,15 @@ import { maxDepth } from '../utils/max-depth.mjs';
17
17
  * // Timeline:
18
18
  * //
19
19
  * // name$ "Alice" "Bob" "Charlie"
20
- * // age$ 25 30 35 40
21
- * // result$ ["Alice",25] ["Bob",30] ["Bob",35] ["Charlie",40]
20
+ * // age$ 25 30
21
+ * // result$ (skip) ["Bob",25] ["Charlie",30]
22
22
  * //
23
23
  * // Explanation:
24
24
  * // - withCurrentValueFrom samples the current value from another observable
25
- * // - Emits a tuple [sourceValue, sampledValue] each time the source emits
25
+ * // - Emits a tuple [sourceValue, sampledValue] each time the SOURCE emits
26
+ * // - Does NOT emit when the sampled observable (age$) emits
26
27
  * // - Does not emit until both observables have emitted at least once
27
- * // - Similar to combine, but only emits when the source (not the sampled) emits
28
+ * // - "Alice" is skipped because age$ hasn't emitted yet
28
29
  *
29
30
  * const name$ = source<string>();
30
31
  *
@@ -32,34 +33,38 @@ import { maxDepth } from '../utils/max-depth.mjs';
32
33
  *
33
34
  * const result$ = name$.pipe(withCurrentValueFrom(age$));
34
35
  *
35
- * const mut_history: (readonly [string, number])[] = [];
36
+ * const valueHistory: (readonly [string, number])[] = [];
36
37
  *
37
38
  * result$.subscribe(([name_, currentAge]) => {
38
- * mut_history.push([name_, currentAge]);
39
+ * valueHistory.push([name_, currentAge]);
39
40
  * });
40
41
  *
41
42
  * name$.next('Alice'); // nothing logged (age$ hasn't emitted)
42
43
  *
43
- * assert.deepStrictEqual(mut_history, []);
44
+ * assert.deepStrictEqual(valueHistory, []);
44
45
  *
45
46
  * age$.next(25);
46
47
  *
47
48
  * name$.next('Bob'); // logs: Bob is 25 years old
48
49
  *
49
- * assert.deepStrictEqual(mut_history, [['Bob', 25]]);
50
+ * assert.deepStrictEqual(valueHistory, [['Bob', 25]]);
50
51
  *
51
52
  * age$.next(30);
52
53
  *
53
54
  * name$.next('Charlie'); // logs: Charlie is 30 years old
54
55
  *
55
- * assert.deepStrictEqual(mut_history, [
56
+ * assert.deepStrictEqual(valueHistory, [
56
57
  * ['Bob', 25],
57
58
  * ['Charlie', 30],
58
59
  * ]);
59
60
  * ```
60
61
  */
61
62
  const withCurrentValueFrom = (observable) => (parentObservable) => new WithCurrentValueFromObservableClass(parentObservable, observable);
62
- const withLatestFrom = withCurrentValueFrom; // alias
63
+ /**
64
+ * Alias for `withCurrentValueFrom`.
65
+ * @see withCurrentValueFrom
66
+ */
67
+ const withLatestFrom = withCurrentValueFrom;
63
68
  class WithCurrentValueFromObservableClass extends SyncChildObservableClass {
64
69
  #observable;
65
70
  constructor(parentObservable, observable) {
@@ -75,16 +80,16 @@ class WithCurrentValueFromObservableClass extends SyncChildObservableClass {
75
80
  });
76
81
  this.#observable = observable;
77
82
  }
78
- tryUpdate(updaterSymbol) {
83
+ tryUpdate(updateToken) {
79
84
  const par = this.parents[0];
80
85
  const ps = par.getSnapshot();
81
- if (par.updaterSymbol !== updaterSymbol || Optional.isNone(ps)) {
86
+ if (par.updateToken !== updateToken || Optional.isNone(ps)) {
82
87
  return; // skip update
83
88
  }
84
89
  const curr = this.#observable.getSnapshot();
85
90
  if (Optional.isNone(curr))
86
91
  return; // skip update
87
- this.setNext([ps.value, curr.value], updaterSymbol);
92
+ this.setNext([ps.value, curr.value], updateToken);
88
93
  }
89
94
  }
90
95
 
@@ -1 +1 @@
1
- {"version":3,"file":"with-current-value-from.mjs","sources":["../../../src/core/operators/with-current-value-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDG;MACU,oBAAoB,GAC/B,CACE,UAAyB,KAE3B,CAAC,gBAAgB,KACf,IAAI,mCAAmC,CAAC,gBAAgB,EAAE,UAAU;AAEjE,MAAM,cAAc,GAAG,qBAAqB;AAEnD,MAAM,mCACJ,SAAQ,wBAAuD,CAAA;AAGtD,IAAA,WAAW;IAEpB,WAAA,CAAY,gBAA+B,EAAE,UAAyB,EAAA;AACpE,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;YAC3B,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC;AACjB,gBAAA,GAAG,EAAE,gBAAgB,CAAC,WAAW,EAAE;AACnC,gBAAA,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KACjB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE;kBACtC,QAAQ,CAAC;AACX,kBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAU,CAAC,CAClD,CAAC,KAAK;AACR,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,WAAW,GAAG,UAAU;IAC/B;AAES,IAAA,SAAS,CAAC,aAA4B,EAAA;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC9D,YAAA,OAAO;QACT;QAEA,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE;AAE3C,QAAA,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;AAAE,YAAA,OAAO;AAElC,QAAA,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IACrD;AACD;;;;"}
1
+ {"version":3,"file":"with-current-value-from.mjs","sources":["../../../src/core/operators/with-current-value-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDG;MACU,oBAAoB,GAC/B,CACE,UAAyB,KAE3B,CAAC,gBAAgB,KACf,IAAI,mCAAmC,CAAC,gBAAgB,EAAE,UAAU;AAExE;;;AAGG;AACI,MAAM,cAAc,GAAG;AAE9B,MAAM,mCACJ,SAAQ,wBAAuD,CAAA;AAGtD,IAAA,WAAW;IAEpB,WAAA,CAAY,gBAA+B,EAAE,UAAyB,EAAA;AACpE,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;YAC3B,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC;AACjB,gBAAA,GAAG,EAAE,gBAAgB,CAAC,WAAW,EAAE;AACnC,gBAAA,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KACjB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE;kBACtC,QAAQ,CAAC;AACX,kBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAU,CAAC,CAClD,CAAC,KAAK;AACR,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,WAAW,GAAG,UAAU;IAC/B;AAES,IAAA,SAAS,CAAC,WAAwB,EAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC1D,YAAA,OAAO;QACT;QAEA,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE;AAE3C,QAAA,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;AAAE,YAAA,OAAO;AAElC,QAAA,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IACnD;AACD;;;;"}
@@ -27,21 +27,21 @@ import { type WithInitialValueOperator } from '../types/index.mjs';
27
27
  *
28
28
  * const initialized$ = num$.pipe(withInitialValue(0));
29
29
  *
30
- * const mut_history: number[] = [];
30
+ * const valueHistory: number[] = [];
31
31
  *
32
32
  * initialized$.subscribe((x) => {
33
- * mut_history.push(x);
33
+ * valueHistory.push(x);
34
34
  * });
35
35
  *
36
- * assert.deepStrictEqual(mut_history, [0]);
36
+ * assert.deepStrictEqual(valueHistory, [0]);
37
37
  *
38
38
  * num$.next(1); // logs: 1
39
39
  *
40
- * assert.deepStrictEqual(mut_history, [0, 1]);
40
+ * assert.deepStrictEqual(valueHistory, [0, 1]);
41
41
  *
42
42
  * num$.next(2); // logs: 2
43
43
  *
44
- * assert.deepStrictEqual(mut_history, [0, 1, 2]);
44
+ * assert.deepStrictEqual(valueHistory, [0, 1, 2]);
45
45
  * ```
46
46
  */
47
47
  export declare const withInitialValue: <A, I = A>(initialValue: I) => WithInitialValueOperator<A, A | I>;
@@ -30,21 +30,21 @@ import '../utils/id-maker.mjs';
30
30
  *
31
31
  * const initialized$ = num$.pipe(withInitialValue(0));
32
32
  *
33
- * const mut_history: number[] = [];
33
+ * const valueHistory: number[] = [];
34
34
  *
35
35
  * initialized$.subscribe((x) => {
36
- * mut_history.push(x);
36
+ * valueHistory.push(x);
37
37
  * });
38
38
  *
39
- * assert.deepStrictEqual(mut_history, [0]);
39
+ * assert.deepStrictEqual(valueHistory, [0]);
40
40
  *
41
41
  * num$.next(1); // logs: 1
42
42
  *
43
- * assert.deepStrictEqual(mut_history, [0, 1]);
43
+ * assert.deepStrictEqual(valueHistory, [0, 1]);
44
44
  *
45
45
  * num$.next(2); // logs: 2
46
46
  *
47
- * assert.deepStrictEqual(mut_history, [0, 1, 2]);
47
+ * assert.deepStrictEqual(valueHistory, [0, 1, 2]);
48
48
  * ```
49
49
  */
50
50
  const withInitialValue = (initialValue) => (parentObservable) => new WithInitialValueObservableClass(parentObservable, initialValue);
@@ -55,13 +55,13 @@ class WithInitialValueObservableClass extends InitializedSyncChildObservableClas
55
55
  initialValue: Optional.some(initialValue),
56
56
  });
57
57
  }
58
- tryUpdate(updaterSymbol) {
58
+ tryUpdate(updateToken) {
59
59
  const par = this.parents[0];
60
60
  const sn = par.getSnapshot();
61
- if (par.updaterSymbol !== updaterSymbol || Optional.isNone(sn)) {
61
+ if (par.updateToken !== updateToken || Optional.isNone(sn)) {
62
62
  return; // skip update
63
63
  }
64
- this.setNext(sn.value, updaterSymbol);
64
+ this.setNext(sn.value, updateToken);
65
65
  }
66
66
  }
67
67
 
@@ -1 +1 @@
1
- {"version":3,"file":"with-initial-value.mjs","sources":["../../../src/core/operators/with-initial-value.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CG;AACI,MAAM,gBAAgB,GAC3B,CAAW,YAAe,KAC1B,CAAC,gBAAgB,KACf,IAAI,+BAA+B,CAAC,gBAAgB,EAAE,YAAY;AAEtE,MAAM,+BACJ,SAAQ,mCAAwD,CAAA;IAGhE,WAAA,CAAY,gBAA+B,EAAE,YAAe,EAAA;AAC1D,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;AAC3B,YAAA,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;AAC1C,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,aAA4B,EAAA;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC9D,YAAA,OAAO;;QAGT,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC;;AAExC;;;;"}
1
+ {"version":3,"file":"with-initial-value.mjs","sources":["../../../src/core/operators/with-initial-value.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CG;AACI,MAAM,gBAAgB,GAC3B,CAAW,YAAe,KAC1B,CAAC,gBAAgB,KACf,IAAI,+BAA+B,CAAC,gBAAgB,EAAE,YAAY;AAEtE,MAAM,+BACJ,SAAQ,mCAAwD,CAAA;IAGhE,WAAA,CAAY,gBAA+B,EAAE,YAAe,EAAA;AAC1D,QAAA,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;AAC3B,YAAA,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;AAC1C,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,WAAwB,EAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3B,QAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,QAAA,IAAI,GAAG,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;AAC1D,YAAA,OAAO;;QAGT,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC;;AAEtC;;;;"}
@@ -0,0 +1,2 @@
1
+ export * from './operators/index.mjs';
2
+ //# sourceMappingURL=index.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/predefined/index.mts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}
@@ -0,0 +1,12 @@
1
+ export { attachIndex, withIndex } from './operators/attach-index.mjs';
2
+ export { mapOptional } from './operators/map-optional.mjs';
3
+ export { mapResultErr } from './operators/map-result-err.mjs';
4
+ export { mapResultOk } from './operators/map-result-ok.mjs';
5
+ export { mapTo } from './operators/map-to.mjs';
6
+ export { getKey, pluck } from './operators/pluck.mjs';
7
+ export { skip } from './operators/skip.mjs';
8
+ export { take } from './operators/take.mjs';
9
+ export { unwrapOptional } from './operators/unwrap-optional.mjs';
10
+ export { unwrapResultErr } from './operators/unwrap-result-err.mjs';
11
+ export { unwrapResultOk } from './operators/unwrap-result-ok.mjs';
12
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
@@ -0,0 +1,57 @@
1
+ import { type KeepInitialValueOperator } from '../../types/index.mjs';
2
+ /**
3
+ * Attaches a sequential index to each emitted value, producing `[index, value]` tuples.
4
+ * Index starts at 0 and increments with each emission.
5
+ *
6
+ * @template A - The type of values from the source
7
+ * @returns An operator that emits `[index, value]` tuples
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * // Timeline:
12
+ * //
13
+ * // letter$ "A" "B" "C"
14
+ * // indexed$ [0,"A"] [1,"B"] [2,"C"]
15
+ * //
16
+ * // Explanation:
17
+ * // - attachIndex attaches a sequential index to each emitted value
18
+ * // - Produces [index, value] tuples
19
+ * // - Index starts at 0 and increments with each emission
20
+ *
21
+ * const letter$ = source<string>();
22
+ *
23
+ * const indexed$ = letter$.pipe(attachIndex());
24
+ *
25
+ * const valueHistory: (readonly [number, string])[] = [];
26
+ *
27
+ * indexed$.subscribe(([i, letter]) => {
28
+ * valueHistory.push([i, letter]);
29
+ * });
30
+ *
31
+ * letter$.next('A');
32
+ *
33
+ * assert.deepStrictEqual(valueHistory, [[0, 'A']]);
34
+ *
35
+ * letter$.next('B');
36
+ *
37
+ * assert.deepStrictEqual(valueHistory, [
38
+ * [0, 'A'],
39
+ * [1, 'B'],
40
+ * ]);
41
+ *
42
+ * letter$.next('C');
43
+ *
44
+ * assert.deepStrictEqual(valueHistory, [
45
+ * [0, 'A'],
46
+ * [1, 'B'],
47
+ * [2, 'C'],
48
+ * ]);
49
+ * ```
50
+ */
51
+ export declare const withIndex: <A>() => KeepInitialValueOperator<A, readonly [SafeUint | -1, A]>;
52
+ /**
53
+ * Alias for `withIndex`.
54
+ * @see withIndex
55
+ */
56
+ export declare const attachIndex: <A>() => KeepInitialValueOperator<A, readonly [SafeUint | -1, A]>;
57
+ //# sourceMappingURL=attach-index.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attach-index.d.mts","sourceRoot":"","sources":["../../../../src/core/predefined/operators/attach-index.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,OAAM,wBAAwB,CACvD,CAAC,EACD,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CACM,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,WAAW,GATE,CAAC,OAAM,wBAAwB,CACvD,CAAC,EACD,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAOO,CAAC"}
@@ -0,0 +1,62 @@
1
+ import 'ts-data-forge';
2
+ import '../../utils/id-maker.mjs';
3
+ import { map } from '../../operators/map.mjs';
4
+
5
+ /**
6
+ * Attaches a sequential index to each emitted value, producing `[index, value]` tuples.
7
+ * Index starts at 0 and increments with each emission.
8
+ *
9
+ * @template A - The type of values from the source
10
+ * @returns An operator that emits `[index, value]` tuples
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * // Timeline:
15
+ * //
16
+ * // letter$ "A" "B" "C"
17
+ * // indexed$ [0,"A"] [1,"B"] [2,"C"]
18
+ * //
19
+ * // Explanation:
20
+ * // - attachIndex attaches a sequential index to each emitted value
21
+ * // - Produces [index, value] tuples
22
+ * // - Index starts at 0 and increments with each emission
23
+ *
24
+ * const letter$ = source<string>();
25
+ *
26
+ * const indexed$ = letter$.pipe(attachIndex());
27
+ *
28
+ * const valueHistory: (readonly [number, string])[] = [];
29
+ *
30
+ * indexed$.subscribe(([i, letter]) => {
31
+ * valueHistory.push([i, letter]);
32
+ * });
33
+ *
34
+ * letter$.next('A');
35
+ *
36
+ * assert.deepStrictEqual(valueHistory, [[0, 'A']]);
37
+ *
38
+ * letter$.next('B');
39
+ *
40
+ * assert.deepStrictEqual(valueHistory, [
41
+ * [0, 'A'],
42
+ * [1, 'B'],
43
+ * ]);
44
+ *
45
+ * letter$.next('C');
46
+ *
47
+ * assert.deepStrictEqual(valueHistory, [
48
+ * [0, 'A'],
49
+ * [1, 'B'],
50
+ * [2, 'C'],
51
+ * ]);
52
+ * ```
53
+ */
54
+ const withIndex = () => map((a, i) => [i, a]);
55
+ /**
56
+ * Alias for `withIndex`.
57
+ * @see withIndex
58
+ */
59
+ const attachIndex = withIndex;
60
+
61
+ export { attachIndex, withIndex };
62
+ //# sourceMappingURL=attach-index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attach-index.mjs","sources":["../../../../src/core/predefined/operators/attach-index.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDG;MACU,SAAS,GAAG,MAGpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAU;AAElC;;;AAGG;AACI,MAAM,WAAW,GAAG;;;;"}