@ersbeth/picoflow 0.2.4 → 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 (248) hide show
  1. package/.cursor/plans/update-js-e795d61b.plan.md +567 -0
  2. package/.gitlab-ci.yml +24 -0
  3. package/.vscode/settings.json +3 -3
  4. package/CHANGELOG.md +51 -0
  5. package/IMPLEMENTATION_GUIDE.md +1578 -0
  6. package/README.md +62 -25
  7. package/biome.json +32 -32
  8. package/dist/picoflow.js +610 -436
  9. package/dist/types/advanced/array.d.ts +0 -6
  10. package/dist/types/advanced/array.d.ts.map +1 -1
  11. package/dist/types/advanced/index.d.ts +5 -5
  12. package/dist/types/advanced/index.d.ts.map +1 -1
  13. package/dist/types/advanced/map.d.ts +114 -23
  14. package/dist/types/advanced/map.d.ts.map +1 -1
  15. package/dist/types/advanced/resource.d.ts +51 -12
  16. package/dist/types/advanced/resource.d.ts.map +1 -1
  17. package/dist/types/advanced/resourceAsync.d.ts +28 -13
  18. package/dist/types/advanced/resourceAsync.d.ts.map +1 -1
  19. package/dist/types/advanced/stream.d.ts +74 -16
  20. package/dist/types/advanced/stream.d.ts.map +1 -1
  21. package/dist/types/advanced/streamAsync.d.ts +69 -15
  22. package/dist/types/advanced/streamAsync.d.ts.map +1 -1
  23. package/dist/types/basic/constant.d.ts +44 -16
  24. package/dist/types/basic/constant.d.ts.map +1 -1
  25. package/dist/types/basic/derivation.d.ts +73 -24
  26. package/dist/types/basic/derivation.d.ts.map +1 -1
  27. package/dist/types/basic/disposable.d.ts +65 -6
  28. package/dist/types/basic/disposable.d.ts.map +1 -1
  29. package/dist/types/basic/effect.d.ts +27 -16
  30. package/dist/types/basic/effect.d.ts.map +1 -1
  31. package/dist/types/basic/index.d.ts +7 -8
  32. package/dist/types/basic/index.d.ts.map +1 -1
  33. package/dist/types/basic/observable.d.ts +62 -13
  34. package/dist/types/basic/observable.d.ts.map +1 -1
  35. package/dist/types/basic/signal.d.ts +35 -6
  36. package/dist/types/basic/signal.d.ts.map +1 -1
  37. package/dist/types/basic/state.d.ts +25 -4
  38. package/dist/types/basic/state.d.ts.map +1 -1
  39. package/dist/types/basic/trackingContext.d.ts +33 -0
  40. package/dist/types/basic/trackingContext.d.ts.map +1 -0
  41. package/dist/types/creators.d.ts +271 -26
  42. package/dist/types/creators.d.ts.map +1 -1
  43. package/dist/types/index.d.ts +60 -7
  44. package/dist/types/index.d.ts.map +1 -1
  45. package/dist/types/solid/converters.d.ts +5 -5
  46. package/dist/types/solid/converters.d.ts.map +1 -1
  47. package/dist/types/solid/index.d.ts +2 -2
  48. package/dist/types/solid/index.d.ts.map +1 -1
  49. package/dist/types/solid/primitives.d.ts +96 -4
  50. package/dist/types/solid/primitives.d.ts.map +1 -1
  51. package/docs/.vitepress/config.mts +110 -0
  52. package/docs/api/classes/FlowArray.md +489 -0
  53. package/docs/api/classes/FlowConstant.md +350 -0
  54. package/docs/api/classes/FlowDerivation.md +334 -0
  55. package/docs/api/classes/FlowEffect.md +100 -0
  56. package/docs/api/classes/FlowMap.md +512 -0
  57. package/docs/api/classes/FlowObservable.md +306 -0
  58. package/docs/api/classes/FlowResource.md +380 -0
  59. package/docs/api/classes/FlowResourceAsync.md +362 -0
  60. package/docs/api/classes/FlowSignal.md +160 -0
  61. package/docs/api/classes/FlowState.md +368 -0
  62. package/docs/api/classes/FlowStream.md +367 -0
  63. package/docs/api/classes/FlowStreamAsync.md +364 -0
  64. package/docs/api/classes/SolidDerivation.md +75 -0
  65. package/docs/api/classes/SolidResource.md +91 -0
  66. package/docs/api/classes/SolidState.md +71 -0
  67. package/docs/api/classes/TrackingContext.md +33 -0
  68. package/docs/api/functions/array.md +58 -0
  69. package/docs/api/functions/constant.md +45 -0
  70. package/docs/api/functions/derivation.md +53 -0
  71. package/docs/api/functions/effect.md +49 -0
  72. package/docs/api/functions/from.md +220 -0
  73. package/docs/api/functions/isDisposable.md +49 -0
  74. package/docs/api/functions/map.md +57 -0
  75. package/docs/api/functions/resource.md +52 -0
  76. package/docs/api/functions/resourceAsync.md +50 -0
  77. package/docs/api/functions/signal.md +36 -0
  78. package/docs/api/functions/state.md +47 -0
  79. package/docs/api/functions/stream.md +53 -0
  80. package/docs/api/functions/streamAsync.md +50 -0
  81. package/docs/api/index.md +118 -0
  82. package/docs/api/interfaces/FlowDisposable.md +65 -0
  83. package/docs/api/interfaces/SolidObservable.md +19 -0
  84. package/docs/api/type-aliases/FlowArrayAction.md +49 -0
  85. package/docs/api/type-aliases/FlowStreamDisposer.md +15 -0
  86. package/docs/api/type-aliases/FlowStreamSetter.md +27 -0
  87. package/docs/api/type-aliases/FlowStreamUpdater.md +32 -0
  88. package/docs/api/type-aliases/NotPromise.md +18 -0
  89. package/docs/api/type-aliases/SolidGetter.md +17 -0
  90. package/docs/api/typedoc-sidebar.json +1 -0
  91. package/docs/examples/examples.md +2313 -0
  92. package/docs/examples/patterns.md +649 -0
  93. package/docs/guide/advanced/disposal.md +426 -0
  94. package/docs/guide/advanced/solidjs.md +221 -0
  95. package/docs/guide/advanced/upgrading.md +464 -0
  96. package/docs/guide/introduction/concepts.md +56 -0
  97. package/docs/guide/introduction/conventions.md +61 -0
  98. package/docs/guide/introduction/getting-started.md +134 -0
  99. package/docs/guide/introduction/lifecycle.md +371 -0
  100. package/docs/guide/primitives/array.md +400 -0
  101. package/docs/guide/primitives/constant.md +380 -0
  102. package/docs/guide/primitives/derivations.md +348 -0
  103. package/docs/guide/primitives/effects.md +458 -0
  104. package/docs/guide/primitives/map.md +387 -0
  105. package/docs/guide/primitives/overview.md +175 -0
  106. package/docs/guide/primitives/resources.md +858 -0
  107. package/docs/guide/primitives/signal.md +259 -0
  108. package/docs/guide/primitives/state.md +368 -0
  109. package/docs/guide/primitives/streams.md +931 -0
  110. package/docs/index.md +47 -0
  111. package/docs/public/logo.svg +1 -0
  112. package/package.json +57 -41
  113. package/src/advanced/array.ts +208 -210
  114. package/src/advanced/index.ts +7 -7
  115. package/src/advanced/map.ts +178 -68
  116. package/src/advanced/resource.ts +87 -43
  117. package/src/advanced/resourceAsync.ts +62 -42
  118. package/src/advanced/stream.ts +113 -50
  119. package/src/advanced/streamAsync.ts +120 -61
  120. package/src/basic/constant.ts +82 -49
  121. package/src/basic/derivation.ts +128 -84
  122. package/src/basic/disposable.ts +74 -15
  123. package/src/basic/effect.ts +85 -77
  124. package/src/basic/index.ts +7 -8
  125. package/src/basic/observable.ts +94 -36
  126. package/src/basic/signal.ts +133 -105
  127. package/src/basic/state.ts +46 -25
  128. package/src/basic/trackingContext.ts +45 -0
  129. package/src/creators.ts +297 -54
  130. package/src/index.ts +96 -43
  131. package/src/solid/converters.ts +186 -67
  132. package/src/solid/index.ts +8 -2
  133. package/src/solid/primitives.ts +167 -65
  134. package/test/array.test.ts +592 -612
  135. package/test/constant.test.ts +31 -33
  136. package/test/derivation.test.ts +531 -536
  137. package/test/effect.test.ts +21 -21
  138. package/test/map.test.ts +233 -137
  139. package/test/resource.test.ts +119 -121
  140. package/test/resourceAsync.test.ts +98 -100
  141. package/test/signal.test.ts +51 -55
  142. package/test/state.test.ts +186 -168
  143. package/test/stream.test.ts +189 -189
  144. package/test/streamAsync.test.ts +186 -186
  145. package/tsconfig.json +19 -18
  146. package/typedoc.json +37 -0
  147. package/vite.config.ts +23 -23
  148. package/vitest.config.ts +7 -7
  149. package/api/doc/index.md +0 -31
  150. package/api/doc/picoflow.array.md +0 -55
  151. package/api/doc/picoflow.constant.md +0 -55
  152. package/api/doc/picoflow.derivation.md +0 -55
  153. package/api/doc/picoflow.effect.md +0 -55
  154. package/api/doc/picoflow.flowarray._constructor_.md +0 -49
  155. package/api/doc/picoflow.flowarray._lastaction.md +0 -13
  156. package/api/doc/picoflow.flowarray.clear.md +0 -17
  157. package/api/doc/picoflow.flowarray.dispose.md +0 -55
  158. package/api/doc/picoflow.flowarray.get.md +0 -19
  159. package/api/doc/picoflow.flowarray.length.md +0 -13
  160. package/api/doc/picoflow.flowarray.md +0 -273
  161. package/api/doc/picoflow.flowarray.pop.md +0 -17
  162. package/api/doc/picoflow.flowarray.push.md +0 -53
  163. package/api/doc/picoflow.flowarray.set.md +0 -53
  164. package/api/doc/picoflow.flowarray.setitem.md +0 -69
  165. package/api/doc/picoflow.flowarray.shift.md +0 -17
  166. package/api/doc/picoflow.flowarray.splice.md +0 -85
  167. package/api/doc/picoflow.flowarray.unshift.md +0 -53
  168. package/api/doc/picoflow.flowarrayaction.md +0 -37
  169. package/api/doc/picoflow.flowconstant._constructor_.md +0 -49
  170. package/api/doc/picoflow.flowconstant.get.md +0 -25
  171. package/api/doc/picoflow.flowconstant.md +0 -88
  172. package/api/doc/picoflow.flowderivation._constructor_.md +0 -49
  173. package/api/doc/picoflow.flowderivation.get.md +0 -23
  174. package/api/doc/picoflow.flowderivation.md +0 -86
  175. package/api/doc/picoflow.flowdisposable.dispose.md +0 -55
  176. package/api/doc/picoflow.flowdisposable.md +0 -43
  177. package/api/doc/picoflow.floweffect._constructor_.md +0 -54
  178. package/api/doc/picoflow.floweffect.dispose.md +0 -21
  179. package/api/doc/picoflow.floweffect.disposed.md +0 -13
  180. package/api/doc/picoflow.floweffect.md +0 -131
  181. package/api/doc/picoflow.flowgetter.md +0 -15
  182. package/api/doc/picoflow.flowmap._lastdeleted.md +0 -21
  183. package/api/doc/picoflow.flowmap._lastset.md +0 -21
  184. package/api/doc/picoflow.flowmap.delete.md +0 -61
  185. package/api/doc/picoflow.flowmap.md +0 -133
  186. package/api/doc/picoflow.flowmap.setat.md +0 -77
  187. package/api/doc/picoflow.flowobservable.get.md +0 -19
  188. package/api/doc/picoflow.flowobservable.md +0 -68
  189. package/api/doc/picoflow.flowobservable.subscribe.md +0 -55
  190. package/api/doc/picoflow.flowresource._constructor_.md +0 -49
  191. package/api/doc/picoflow.flowresource.fetch.md +0 -27
  192. package/api/doc/picoflow.flowresource.get.md +0 -23
  193. package/api/doc/picoflow.flowresource.md +0 -100
  194. package/api/doc/picoflow.flowresourceasync._constructor_.md +0 -49
  195. package/api/doc/picoflow.flowresourceasync.fetch.md +0 -27
  196. package/api/doc/picoflow.flowresourceasync.get.md +0 -23
  197. package/api/doc/picoflow.flowresourceasync.md +0 -100
  198. package/api/doc/picoflow.flowsignal.dispose.md +0 -59
  199. package/api/doc/picoflow.flowsignal.disposed.md +0 -18
  200. package/api/doc/picoflow.flowsignal.md +0 -112
  201. package/api/doc/picoflow.flowsignal.trigger.md +0 -21
  202. package/api/doc/picoflow.flowstate.md +0 -52
  203. package/api/doc/picoflow.flowstate.set.md +0 -61
  204. package/api/doc/picoflow.flowstream._constructor_.md +0 -49
  205. package/api/doc/picoflow.flowstream.dispose.md +0 -21
  206. package/api/doc/picoflow.flowstream.get.md +0 -23
  207. package/api/doc/picoflow.flowstream.md +0 -100
  208. package/api/doc/picoflow.flowstreamasync._constructor_.md +0 -54
  209. package/api/doc/picoflow.flowstreamasync.dispose.md +0 -21
  210. package/api/doc/picoflow.flowstreamasync.get.md +0 -23
  211. package/api/doc/picoflow.flowstreamasync.md +0 -100
  212. package/api/doc/picoflow.flowstreamdisposer.md +0 -13
  213. package/api/doc/picoflow.flowstreamsetter.md +0 -13
  214. package/api/doc/picoflow.flowstreamupdater.md +0 -19
  215. package/api/doc/picoflow.flowwatcher.md +0 -15
  216. package/api/doc/picoflow.from.md +0 -55
  217. package/api/doc/picoflow.from_1.md +0 -55
  218. package/api/doc/picoflow.from_2.md +0 -55
  219. package/api/doc/picoflow.from_3.md +0 -55
  220. package/api/doc/picoflow.from_4.md +0 -55
  221. package/api/doc/picoflow.from_5.md +0 -55
  222. package/api/doc/picoflow.isdisposable.md +0 -55
  223. package/api/doc/picoflow.map.md +0 -59
  224. package/api/doc/picoflow.md +0 -544
  225. package/api/doc/picoflow.resource.md +0 -55
  226. package/api/doc/picoflow.resourceasync.md +0 -55
  227. package/api/doc/picoflow.signal.md +0 -19
  228. package/api/doc/picoflow.solidderivation._constructor_.md +0 -49
  229. package/api/doc/picoflow.solidderivation.get.md +0 -13
  230. package/api/doc/picoflow.solidderivation.md +0 -94
  231. package/api/doc/picoflow.solidgetter.md +0 -13
  232. package/api/doc/picoflow.solidobservable.get.md +0 -13
  233. package/api/doc/picoflow.solidobservable.md +0 -57
  234. package/api/doc/picoflow.solidresource._constructor_.md +0 -49
  235. package/api/doc/picoflow.solidresource.get.md +0 -13
  236. package/api/doc/picoflow.solidresource.latest.md +0 -13
  237. package/api/doc/picoflow.solidresource.md +0 -157
  238. package/api/doc/picoflow.solidresource.refetch.md +0 -13
  239. package/api/doc/picoflow.solidresource.state.md +0 -13
  240. package/api/doc/picoflow.solidstate._constructor_.md +0 -49
  241. package/api/doc/picoflow.solidstate.get.md +0 -13
  242. package/api/doc/picoflow.solidstate.md +0 -115
  243. package/api/doc/picoflow.solidstate.set.md +0 -13
  244. package/api/doc/picoflow.state.md +0 -55
  245. package/api/doc/picoflow.stream.md +0 -55
  246. package/api/doc/picoflow.streamasync.md +0 -55
  247. package/api/picoflow.public.api.md +0 -244
  248. package/api-extractor.json +0 -61
@@ -1,196 +1,196 @@
1
1
  import { describe, expect, test, vi } from "vitest";
2
- import { stream, effect } from "#package";
2
+ import { effect, stream } from "#package";
3
3
 
4
4
  describe("stream", () => {
5
- test("is updated (callback)", async () => {
6
- const counter = {
7
- count: 0,
8
- callback: undefined as ((value: number) => void) | undefined,
9
- increment() {
10
- this.count++;
11
- if (this.callback) {
12
- this.callback(this.count);
13
- }
14
- },
15
- };
16
-
17
- const $stream = stream((set) => {
18
- counter.callback = set;
19
- return () => {
20
- counter.callback = undefined;
21
- };
22
- });
23
-
24
- expect($stream.get()).toBe(undefined);
25
-
26
- counter.increment();
27
- expect($stream.get()).toBe(1);
28
-
29
- counter.increment();
30
- expect($stream.get()).toBe(2);
31
- });
32
-
33
- test("stream is updated (interval)", async () => {
34
- vi.useFakeTimers();
35
-
36
- const $stream = stream((set) => {
37
- let counter = 0;
38
- const interval = setInterval(() => {
39
- counter++;
40
- set(counter);
41
- }, 1000);
42
- return () => clearInterval(interval);
43
- });
44
-
45
- expect($stream.get()).toBe(undefined);
46
-
47
- vi.advanceTimersToNextTimer();
48
- expect($stream.get()).toBe(1);
49
-
50
- vi.advanceTimersToNextTimer();
51
- expect($stream.get()).toBe(2);
52
- });
53
-
54
- test("get throws when stream is disposed", async () => {
55
- vi.useFakeTimers();
56
-
57
- const $stream = stream((set) => {
58
- let counter = 0;
59
- const interval = setInterval(() => {
60
- counter++;
61
- set(counter);
62
- }, 1000);
63
- return () => clearInterval(interval);
64
- });
65
-
66
- expect($stream.get()).toBe(undefined);
67
-
68
- vi.advanceTimersToNextTimer();
69
- expect($stream.get()).toBe(1);
70
-
71
- vi.advanceTimersToNextTimer();
72
- expect($stream.get()).toBe(2);
73
-
74
- $stream.dispose();
75
- vi.advanceTimersToNextTimer();
76
- expect(() => $stream.get()).toThrow("[PicoFlow] Primitive is disposed");
77
- });
5
+ test("is updated (callback)", async () => {
6
+ const counter = {
7
+ count: 0,
8
+ callback: undefined as ((value: number) => void) | undefined,
9
+ increment() {
10
+ this.count++;
11
+ if (this.callback) {
12
+ this.callback(this.count);
13
+ }
14
+ },
15
+ };
16
+
17
+ const $stream = stream((set) => {
18
+ counter.callback = set;
19
+ return () => {
20
+ counter.callback = undefined;
21
+ };
22
+ });
23
+
24
+ expect($stream.pick()).toBe(undefined);
25
+
26
+ counter.increment();
27
+ expect($stream.pick()).toBe(1);
28
+
29
+ counter.increment();
30
+ expect($stream.pick()).toBe(2);
31
+ });
32
+
33
+ test("stream is updated (interval)", async () => {
34
+ vi.useFakeTimers();
35
+
36
+ const $stream = stream((set) => {
37
+ let counter = 0;
38
+ const interval = setInterval(() => {
39
+ counter++;
40
+ set(counter);
41
+ }, 1000);
42
+ return () => clearInterval(interval);
43
+ });
44
+
45
+ expect($stream.pick()).toBe(undefined);
46
+
47
+ vi.advanceTimersToNextTimer();
48
+ expect($stream.pick()).toBe(1);
49
+
50
+ vi.advanceTimersToNextTimer();
51
+ expect($stream.pick()).toBe(2);
52
+ });
53
+
54
+ test("get throws when stream is disposed", async () => {
55
+ vi.useFakeTimers();
56
+
57
+ const $stream = stream((set) => {
58
+ let counter = 0;
59
+ const interval = setInterval(() => {
60
+ counter++;
61
+ set(counter);
62
+ }, 1000);
63
+ return () => clearInterval(interval);
64
+ });
65
+
66
+ expect($stream.pick()).toBe(undefined);
67
+
68
+ vi.advanceTimersToNextTimer();
69
+ expect($stream.pick()).toBe(1);
70
+
71
+ vi.advanceTimersToNextTimer();
72
+ expect($stream.pick()).toBe(2);
73
+
74
+ $stream.dispose();
75
+ vi.advanceTimersToNextTimer();
76
+ expect(() => $stream.pick()).toThrow("[PicoFlow] Primitive is disposed");
77
+ });
78
78
  });
79
79
 
80
80
  describe("effect", () => {
81
- test("called when stream is updated", async () => {
82
- vi.useFakeTimers();
83
-
84
- const $stream = stream((set) => {
85
- let counter = 0;
86
- const interval = setInterval(() => {
87
- counter++;
88
- set(counter);
89
- }, 1000);
90
- return () => clearInterval(interval);
91
- });
92
-
93
- const effectFn = vi.fn();
94
- effect((get) => effectFn(get($stream)));
95
-
96
- expect(effectFn).toHaveBeenCalledTimes(1);
97
- expect(effectFn).toHaveBeenLastCalledWith(undefined);
98
-
99
- vi.advanceTimersToNextTimer();
100
- expect(effectFn).toHaveBeenCalledTimes(2);
101
- expect(effectFn).toHaveBeenLastCalledWith(1);
102
-
103
- vi.advanceTimersToNextTimer();
104
- expect(effectFn).toHaveBeenCalledTimes(3);
105
- expect(effectFn).toHaveBeenLastCalledWith(2);
106
- });
107
-
108
- test("NOT called when stream is updated with same value", async () => {
109
- vi.useFakeTimers();
110
-
111
- const $stream = stream((set) => {
112
- const interval = setInterval(() => {
113
- set(5);
114
- }, 1000);
115
- return () => clearInterval(interval);
116
- });
117
-
118
- const effectFn = vi.fn();
119
- effect((get) => effectFn(get($stream)));
120
-
121
- expect(effectFn).toHaveBeenCalledTimes(1);
122
- expect(effectFn).toHaveBeenLastCalledWith(undefined);
123
-
124
- vi.advanceTimersToNextTimer();
125
- expect(effectFn).toHaveBeenCalledTimes(2);
126
- expect(effectFn).toHaveBeenLastCalledWith(5);
127
-
128
- vi.advanceTimersToNextTimer();
129
- expect(effectFn).toHaveBeenCalledTimes(2);
130
- expect(effectFn).toHaveBeenLastCalledWith(5);
131
- });
132
-
133
- test("NOT called when disposed", async () => {
134
- vi.useFakeTimers();
135
-
136
- const $stream = stream((set) => {
137
- let counter = 0;
138
- const interval = setInterval(() => {
139
- counter++;
140
- set(counter);
141
- }, 1000);
142
- return () => clearInterval(interval);
143
- });
144
-
145
- const effectFn = vi.fn();
146
- const $effect = effect((get) => effectFn(get($stream)));
147
-
148
- expect(effectFn).toHaveBeenCalledTimes(1);
149
- expect(effectFn).toHaveBeenLastCalledWith(undefined);
150
-
151
- vi.advanceTimersToNextTimer();
152
- expect(effectFn).toHaveBeenCalledTimes(2);
153
- expect(effectFn).toHaveBeenLastCalledWith(1);
154
-
155
- vi.advanceTimersToNextTimer();
156
- expect(effectFn).toHaveBeenCalledTimes(3);
157
- expect(effectFn).toHaveBeenLastCalledWith(2);
158
-
159
- $effect.dispose();
160
- vi.advanceTimersToNextTimer();
161
- expect(effectFn).toHaveBeenCalledTimes(3);
162
- expect(effectFn).toHaveBeenLastCalledWith(2);
163
- });
164
-
165
- test("NOT called when stream is disposed", async () => {
166
- vi.useFakeTimers();
167
-
168
- const $stream = stream((set) => {
169
- let counter = 0;
170
- const interval = setInterval(() => {
171
- counter++;
172
- set(counter);
173
- }, 1000);
174
- return () => clearInterval(interval);
175
- });
176
-
177
- const effectFn = vi.fn();
178
- effect((get) => effectFn(get($stream)));
179
-
180
- expect(effectFn).toHaveBeenCalledTimes(1);
181
- expect(effectFn).toHaveBeenLastCalledWith(undefined);
182
-
183
- vi.advanceTimersToNextTimer();
184
- expect(effectFn).toHaveBeenCalledTimes(2);
185
- expect(effectFn).toHaveBeenLastCalledWith(1);
186
-
187
- vi.advanceTimersToNextTimer();
188
- expect(effectFn).toHaveBeenCalledTimes(3);
189
- expect(effectFn).toHaveBeenLastCalledWith(2);
190
-
191
- $stream.dispose();
192
- vi.advanceTimersToNextTimer();
193
- expect(effectFn).toHaveBeenCalledTimes(3);
194
- expect(effectFn).toHaveBeenLastCalledWith(2);
195
- });
81
+ test("called when stream is updated", async () => {
82
+ vi.useFakeTimers();
83
+
84
+ const $stream = stream((set) => {
85
+ let counter = 0;
86
+ const interval = setInterval(() => {
87
+ counter++;
88
+ set(counter);
89
+ }, 1000);
90
+ return () => clearInterval(interval);
91
+ });
92
+
93
+ const effectFn = vi.fn();
94
+ effect((t) => effectFn($stream.get(t)));
95
+
96
+ expect(effectFn).toHaveBeenCalledTimes(1);
97
+ expect(effectFn).toHaveBeenLastCalledWith(undefined);
98
+
99
+ vi.advanceTimersToNextTimer();
100
+ expect(effectFn).toHaveBeenCalledTimes(2);
101
+ expect(effectFn).toHaveBeenLastCalledWith(1);
102
+
103
+ vi.advanceTimersToNextTimer();
104
+ expect(effectFn).toHaveBeenCalledTimes(3);
105
+ expect(effectFn).toHaveBeenLastCalledWith(2);
106
+ });
107
+
108
+ test("NOT called when stream is updated with same value", async () => {
109
+ vi.useFakeTimers();
110
+
111
+ const $stream = stream((set) => {
112
+ const interval = setInterval(() => {
113
+ set(5);
114
+ }, 1000);
115
+ return () => clearInterval(interval);
116
+ });
117
+
118
+ const effectFn = vi.fn();
119
+ effect((t) => effectFn($stream.get(t)));
120
+
121
+ expect(effectFn).toHaveBeenCalledTimes(1);
122
+ expect(effectFn).toHaveBeenLastCalledWith(undefined);
123
+
124
+ vi.advanceTimersToNextTimer();
125
+ expect(effectFn).toHaveBeenCalledTimes(2);
126
+ expect(effectFn).toHaveBeenLastCalledWith(5);
127
+
128
+ vi.advanceTimersToNextTimer();
129
+ expect(effectFn).toHaveBeenCalledTimes(2);
130
+ expect(effectFn).toHaveBeenLastCalledWith(5);
131
+ });
132
+
133
+ test("NOT called when disposed", async () => {
134
+ vi.useFakeTimers();
135
+
136
+ const $stream = stream((set) => {
137
+ let counter = 0;
138
+ const interval = setInterval(() => {
139
+ counter++;
140
+ set(counter);
141
+ }, 1000);
142
+ return () => clearInterval(interval);
143
+ });
144
+
145
+ const effectFn = vi.fn();
146
+ const $effect = effect((t) => effectFn($stream.get(t)));
147
+
148
+ expect(effectFn).toHaveBeenCalledTimes(1);
149
+ expect(effectFn).toHaveBeenLastCalledWith(undefined);
150
+
151
+ vi.advanceTimersToNextTimer();
152
+ expect(effectFn).toHaveBeenCalledTimes(2);
153
+ expect(effectFn).toHaveBeenLastCalledWith(1);
154
+
155
+ vi.advanceTimersToNextTimer();
156
+ expect(effectFn).toHaveBeenCalledTimes(3);
157
+ expect(effectFn).toHaveBeenLastCalledWith(2);
158
+
159
+ $effect.dispose();
160
+ vi.advanceTimersToNextTimer();
161
+ expect(effectFn).toHaveBeenCalledTimes(3);
162
+ expect(effectFn).toHaveBeenLastCalledWith(2);
163
+ });
164
+
165
+ test("NOT called when stream is disposed", async () => {
166
+ vi.useFakeTimers();
167
+
168
+ const $stream = stream((set) => {
169
+ let counter = 0;
170
+ const interval = setInterval(() => {
171
+ counter++;
172
+ set(counter);
173
+ }, 1000);
174
+ return () => clearInterval(interval);
175
+ });
176
+
177
+ const effectFn = vi.fn();
178
+ effect((t) => effectFn($stream.get(t)));
179
+
180
+ expect(effectFn).toHaveBeenCalledTimes(1);
181
+ expect(effectFn).toHaveBeenLastCalledWith(undefined);
182
+
183
+ vi.advanceTimersToNextTimer();
184
+ expect(effectFn).toHaveBeenCalledTimes(2);
185
+ expect(effectFn).toHaveBeenLastCalledWith(1);
186
+
187
+ vi.advanceTimersToNextTimer();
188
+ expect(effectFn).toHaveBeenCalledTimes(3);
189
+ expect(effectFn).toHaveBeenLastCalledWith(2);
190
+
191
+ $stream.dispose();
192
+ vi.advanceTimersToNextTimer();
193
+ expect(effectFn).toHaveBeenCalledTimes(3);
194
+ expect(effectFn).toHaveBeenLastCalledWith(2);
195
+ });
196
196
  });