@ersbeth/picoflow 2.0.2 → 2.1.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 (244) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +25 -0
  3. package/SKILL.md +106 -0
  4. package/dist/picoflow.js +204 -60
  5. package/dist/types/api/base/flowObservable.d.ts +3 -3
  6. package/dist/types/api/base/flowObservable.d.ts.map +1 -1
  7. package/dist/types/api/base/flowSubscribable.d.ts +2 -2
  8. package/dist/types/api/base/flowSubscribable.d.ts.map +1 -1
  9. package/dist/types/api/base/flowTracker.d.ts +1 -1
  10. package/dist/types/api/base/flowTracker.d.ts.map +1 -1
  11. package/dist/types/api/base/index.d.ts +4 -4
  12. package/dist/types/api/base/index.d.ts.map +1 -1
  13. package/dist/types/api/index.d.ts +2 -2
  14. package/dist/types/api/index.d.ts.map +1 -1
  15. package/dist/types/api/nodes/async/flowConstantAsync.d.ts +1 -1
  16. package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map +1 -1
  17. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts +3 -3
  18. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map +1 -1
  19. package/dist/types/api/nodes/async/flowStateAsync.d.ts +3 -3
  20. package/dist/types/api/nodes/async/flowStateAsync.d.ts.map +1 -1
  21. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts +2 -2
  22. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts.map +1 -1
  23. package/dist/types/api/nodes/async/index.d.ts +4 -4
  24. package/dist/types/api/nodes/async/index.d.ts.map +1 -1
  25. package/dist/types/api/nodes/collections/flowArray.d.ts +7 -4
  26. package/dist/types/api/nodes/collections/flowArray.d.ts.map +1 -1
  27. package/dist/types/api/nodes/collections/flowMap.d.ts +3 -2
  28. package/dist/types/api/nodes/collections/flowMap.d.ts.map +1 -1
  29. package/dist/types/api/nodes/collections/index.d.ts +2 -2
  30. package/dist/types/api/nodes/collections/index.d.ts.map +1 -1
  31. package/dist/types/api/nodes/flowEffect.d.ts +2 -2
  32. package/dist/types/api/nodes/flowEffect.d.ts.map +1 -1
  33. package/dist/types/api/nodes/flowSignal.d.ts +1 -1
  34. package/dist/types/api/nodes/flowSignal.d.ts.map +1 -1
  35. package/dist/types/api/nodes/flowValue.d.ts +2 -2
  36. package/dist/types/api/nodes/flowValue.d.ts.map +1 -1
  37. package/dist/types/api/nodes/index.d.ts +7 -7
  38. package/dist/types/api/nodes/index.d.ts.map +1 -1
  39. package/dist/types/api/nodes/sync/flowConstant.d.ts +2 -2
  40. package/dist/types/api/nodes/sync/flowConstant.d.ts.map +1 -1
  41. package/dist/types/api/nodes/sync/flowDerivation.d.ts +3 -3
  42. package/dist/types/api/nodes/sync/flowDerivation.d.ts.map +1 -1
  43. package/dist/types/api/nodes/sync/flowState.d.ts +3 -3
  44. package/dist/types/api/nodes/sync/flowState.d.ts.map +1 -1
  45. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts +2 -2
  46. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts.map +1 -1
  47. package/dist/types/api/nodes/sync/index.d.ts +4 -4
  48. package/dist/types/api/nodes/sync/index.d.ts.map +1 -1
  49. package/dist/types/api/nodes/utils.d.ts +1 -1
  50. package/dist/types/api/nodes/utils.d.ts.map +1 -1
  51. package/dist/types/base/disposable.d.ts +1 -1
  52. package/dist/types/base/disposable.d.ts.map +1 -1
  53. package/dist/types/base/executionStack.d.ts +22 -1
  54. package/dist/types/base/executionStack.d.ts.map +1 -1
  55. package/dist/types/base/index.d.ts +5 -5
  56. package/dist/types/base/index.d.ts.map +1 -1
  57. package/dist/types/base/node.d.ts +4 -4
  58. package/dist/types/base/node.d.ts.map +1 -1
  59. package/dist/types/base/observable.d.ts +3 -3
  60. package/dist/types/base/observable.d.ts.map +1 -1
  61. package/dist/types/base/observer.d.ts +2 -2
  62. package/dist/types/base/observer.d.ts.map +1 -1
  63. package/dist/types/converters/index.d.ts +1 -1
  64. package/dist/types/converters/index.d.ts.map +1 -1
  65. package/dist/types/converters/solid.d.ts +12 -8
  66. package/dist/types/converters/solid.d.ts.map +1 -1
  67. package/dist/types/index.d.ts +2 -2
  68. package/dist/types/index.d.ts.map +1 -1
  69. package/dist/types/nodes/actionNode.d.ts +23 -0
  70. package/dist/types/nodes/actionNode.d.ts.map +1 -0
  71. package/dist/types/nodes/arrayNode.d.ts +4 -3
  72. package/dist/types/nodes/arrayNode.d.ts.map +1 -1
  73. package/dist/types/nodes/effectNode.d.ts +18 -2
  74. package/dist/types/nodes/effectNode.d.ts.map +1 -1
  75. package/dist/types/nodes/index.d.ts +8 -7
  76. package/dist/types/nodes/index.d.ts.map +1 -1
  77. package/dist/types/nodes/mapNode.d.ts +4 -3
  78. package/dist/types/nodes/mapNode.d.ts.map +1 -1
  79. package/dist/types/nodes/signalNode.d.ts +2 -2
  80. package/dist/types/nodes/signalNode.d.ts.map +1 -1
  81. package/dist/types/nodes/valueAsyncNode.d.ts +3 -3
  82. package/dist/types/nodes/valueAsyncNode.d.ts.map +1 -1
  83. package/dist/types/nodes/valueNode.d.ts +3 -3
  84. package/dist/types/nodes/valueNode.d.ts.map +1 -1
  85. package/dist/types/nodes/valueSyncNode.d.ts +3 -3
  86. package/dist/types/nodes/valueSyncNode.d.ts.map +1 -1
  87. package/dist/types/schedulers/asyncScheduler.d.ts +2 -1
  88. package/dist/types/schedulers/asyncScheduler.d.ts.map +1 -1
  89. package/dist/types/schedulers/index.d.ts +4 -4
  90. package/dist/types/schedulers/index.d.ts.map +1 -1
  91. package/dist/types/schedulers/syncResolver.d.ts +1 -2
  92. package/dist/types/schedulers/syncResolver.d.ts.map +1 -1
  93. package/dist/types/schedulers/syncScheduler.d.ts +1 -1
  94. package/dist/types/schedulers/syncScheduler.d.ts.map +1 -1
  95. package/package.json +24 -1
  96. package/.gitlab-ci.yml +0 -24
  97. package/.vscode/settings.json +0 -5
  98. package/CHANGELOG.md +0 -94
  99. package/biome.json +0 -47
  100. package/docs/.vitepress/config.mts +0 -145
  101. package/docs/api/functions/array.md +0 -35
  102. package/docs/api/functions/constant.md +0 -33
  103. package/docs/api/functions/constantAsync.md +0 -69
  104. package/docs/api/functions/derivation.md +0 -34
  105. package/docs/api/functions/derivationAsync.md +0 -34
  106. package/docs/api/functions/from.md +0 -129
  107. package/docs/api/functions/isDisposable.md +0 -27
  108. package/docs/api/functions/map.md +0 -36
  109. package/docs/api/functions/signal.md +0 -21
  110. package/docs/api/functions/state.md +0 -67
  111. package/docs/api/functions/stateAsync.md +0 -69
  112. package/docs/api/functions/subscribe.md +0 -40
  113. package/docs/api/functions/writableDerivation.md +0 -33
  114. package/docs/api/functions/writableDerivationAsync.md +0 -34
  115. package/docs/api/index.md +0 -61
  116. package/docs/api/interfaces/FlowArray.md +0 -439
  117. package/docs/api/interfaces/FlowConstant.md +0 -220
  118. package/docs/api/interfaces/FlowConstantAsync.md +0 -221
  119. package/docs/api/interfaces/FlowDerivation.md +0 -241
  120. package/docs/api/interfaces/FlowDerivationAsync.md +0 -242
  121. package/docs/api/interfaces/FlowDisposable.md +0 -59
  122. package/docs/api/interfaces/FlowEffect.md +0 -64
  123. package/docs/api/interfaces/FlowMap.md +0 -374
  124. package/docs/api/interfaces/FlowObservable.md +0 -155
  125. package/docs/api/interfaces/FlowSignal.md +0 -156
  126. package/docs/api/interfaces/FlowState.md +0 -269
  127. package/docs/api/interfaces/FlowStateAsync.md +0 -268
  128. package/docs/api/interfaces/FlowSubscribable.md +0 -55
  129. package/docs/api/interfaces/FlowTracker.md +0 -61
  130. package/docs/api/interfaces/FlowValue.md +0 -222
  131. package/docs/api/interfaces/FlowWritableDerivation.md +0 -292
  132. package/docs/api/interfaces/FlowWritableDerivationAsync.md +0 -293
  133. package/docs/api/type-aliases/DerivationFunction.md +0 -28
  134. package/docs/api/type-aliases/DerivationFunctionAsync.md +0 -28
  135. package/docs/api/type-aliases/FlowArrayAction.md +0 -60
  136. package/docs/api/type-aliases/FlowDataTracker.md +0 -33
  137. package/docs/api/type-aliases/FlowMapAction.md +0 -48
  138. package/docs/api/type-aliases/FlowOnDataListener.md +0 -33
  139. package/docs/api/type-aliases/FlowOnErrorListener.md +0 -27
  140. package/docs/api/type-aliases/FlowOnPendingListener.md +0 -21
  141. package/docs/api/type-aliases/FlowReadonly.md +0 -22
  142. package/docs/api/type-aliases/InitFunction.md +0 -21
  143. package/docs/api/type-aliases/InitFunctionAsync.md +0 -21
  144. package/docs/api/type-aliases/NotPromise.md +0 -21
  145. package/docs/api/type-aliases/UpdateFunction.md +0 -27
  146. package/docs/api/type-aliases/UpdateFunctionAsync.md +0 -27
  147. package/docs/api/typedoc-sidebar.json +0 -65
  148. package/docs/examples/examples.md +0 -2311
  149. package/docs/examples/patterns.md +0 -649
  150. package/docs/guide/advanced/architecture.md +0 -1234
  151. package/docs/guide/advanced/disposal.md +0 -426
  152. package/docs/guide/advanced/migration-v1.md +0 -464
  153. package/docs/guide/advanced/migration-v2.md +0 -204
  154. package/docs/guide/advanced/solidjs.md +0 -135
  155. package/docs/guide/introduction/concepts.md +0 -57
  156. package/docs/guide/introduction/conventions.md +0 -30
  157. package/docs/guide/introduction/getting-started.md +0 -139
  158. package/docs/guide/introduction/lifecycle.md +0 -368
  159. package/docs/guide/primitives/array.md +0 -286
  160. package/docs/guide/primitives/constant.md +0 -207
  161. package/docs/guide/primitives/derivations.md +0 -281
  162. package/docs/guide/primitives/effects.md +0 -372
  163. package/docs/guide/primitives/map.md +0 -265
  164. package/docs/guide/primitives/overview.md +0 -92
  165. package/docs/guide/primitives/signal.md +0 -222
  166. package/docs/guide/primitives/state.md +0 -272
  167. package/docs/index.md +0 -47
  168. package/docs/public/logo.svg +0 -1
  169. package/src/api/base/flowDisposable.ts +0 -44
  170. package/src/api/base/flowObservable.ts +0 -28
  171. package/src/api/base/flowSubscribable.ts +0 -87
  172. package/src/api/base/flowTracker.ts +0 -7
  173. package/src/api/base/index.ts +0 -4
  174. package/src/api/index.ts +0 -2
  175. package/src/api/nodes/async/flowConstantAsync.ts +0 -36
  176. package/src/api/nodes/async/flowDerivationAsync.ts +0 -42
  177. package/src/api/nodes/async/flowStateAsync.ts +0 -47
  178. package/src/api/nodes/async/flowWritableDerivationAsync.ts +0 -33
  179. package/src/api/nodes/async/index.ts +0 -4
  180. package/src/api/nodes/collections/flowArray.ts +0 -155
  181. package/src/api/nodes/collections/flowMap.ts +0 -115
  182. package/src/api/nodes/collections/index.ts +0 -2
  183. package/src/api/nodes/flowEffect.ts +0 -42
  184. package/src/api/nodes/flowSignal.ts +0 -28
  185. package/src/api/nodes/flowValue.ts +0 -37
  186. package/src/api/nodes/index.ts +0 -7
  187. package/src/api/nodes/sync/flowConstant.ts +0 -33
  188. package/src/api/nodes/sync/flowDerivation.ts +0 -41
  189. package/src/api/nodes/sync/flowState.ts +0 -45
  190. package/src/api/nodes/sync/flowWritableDerivation.ts +0 -31
  191. package/src/api/nodes/sync/index.ts +0 -4
  192. package/src/api/nodes/utils.ts +0 -24
  193. package/src/base/disposable.ts +0 -18
  194. package/src/base/executionStack.ts +0 -42
  195. package/src/base/index.ts +0 -5
  196. package/src/base/node.ts +0 -98
  197. package/src/base/observable.ts +0 -92
  198. package/src/base/observer.ts +0 -51
  199. package/src/converters/index.ts +0 -1
  200. package/src/converters/solid.ts +0 -109
  201. package/src/index.ts +0 -2
  202. package/src/nodes/arrayNode.ts +0 -180
  203. package/src/nodes/effectNode.ts +0 -58
  204. package/src/nodes/index.ts +0 -7
  205. package/src/nodes/mapNode.ts +0 -125
  206. package/src/nodes/signalNode.ts +0 -19
  207. package/src/nodes/valueAsyncNode.ts +0 -85
  208. package/src/nodes/valueNode.ts +0 -148
  209. package/src/nodes/valueSyncNode.ts +0 -125
  210. package/src/schedulers/asyncResolver.ts +0 -78
  211. package/src/schedulers/asyncScheduler.ts +0 -66
  212. package/src/schedulers/index.ts +0 -4
  213. package/src/schedulers/pendingError.ts +0 -13
  214. package/src/schedulers/scheduler.ts +0 -9
  215. package/src/schedulers/syncResolver.ts +0 -69
  216. package/src/schedulers/syncScheduler.ts +0 -55
  217. package/test/base/pendingError.test.ts +0 -67
  218. package/test/converters/solid.derivation.browser.test.tsx +0 -69
  219. package/test/converters/solid.node.test.ts +0 -654
  220. package/test/converters/solid.state.browser.test.tsx +0 -1592
  221. package/test/reactivity/flowSignal.test.ts +0 -226
  222. package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +0 -593
  223. package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +0 -317
  224. package/test/reactivity/nodes/async/flowConstantAsync.test.ts +0 -652
  225. package/test/reactivity/nodes/async/flowDerivation.test.ts +0 -898
  226. package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +0 -1716
  227. package/test/reactivity/nodes/async/flowStateAsync.test.ts +0 -708
  228. package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +0 -614
  229. package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +0 -1289
  230. package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +0 -961
  231. package/test/reactivity/nodes/collections/flowArray.states.test.ts +0 -1035
  232. package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +0 -960
  233. package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +0 -775
  234. package/test/reactivity/nodes/collections/flowMap.states.test.ts +0 -958
  235. package/test/reactivity/nodes/sync/flowConstant.test.ts +0 -377
  236. package/test/reactivity/nodes/sync/flowDerivation.test.ts +0 -896
  237. package/test/reactivity/nodes/sync/flowState.test.ts +0 -341
  238. package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +0 -603
  239. package/test/vitest.d.ts +0 -10
  240. package/tsconfig.json +0 -37
  241. package/typedoc.json +0 -37
  242. package/vite.config.ts +0 -31
  243. package/vitest.browser.config.ts +0 -21
  244. package/vitest.config.ts +0 -17
@@ -1,593 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
- import { PendingError } from "~/schedulers";
3
- import { AsyncResolver } from "~/schedulers/asyncResolver";
4
-
5
- describe("PendingResolver", () => {
6
- describe("initialization", () => {
7
- it("should create instance with compute function", () => {
8
- const compute = vi.fn(() => Promise.resolve(42));
9
- const resolver = new AsyncResolver(compute);
10
-
11
- expect(resolver).toBeInstanceOf(AsyncResolver);
12
- });
13
-
14
- it("should not execute compute function on construction", () => {
15
- const compute = vi.fn(() => Promise.resolve(42));
16
- new AsyncResolver(compute);
17
-
18
- expect(compute).not.toHaveBeenCalled();
19
- });
20
-
21
- it("should return a promise from settled getter", () => {
22
- const compute = vi.fn(() => Promise.resolve(42));
23
- const resolver = new AsyncResolver(compute);
24
-
25
- expect(resolver.computed).toBeInstanceOf(Promise);
26
- });
27
- });
28
-
29
- describe("restart() method", () => {
30
- it("should execute compute function when restart is called", () => {
31
- const compute = vi.fn(() => Promise.resolve(42));
32
- const resolver = new AsyncResolver(compute);
33
-
34
- resolver.compute();
35
-
36
- expect(compute).toHaveBeenCalledTimes(1);
37
- });
38
-
39
- it("should resolve settled promise with computation result", async () => {
40
- const compute = vi.fn(() => Promise.resolve(100));
41
- const resolver = new AsyncResolver(compute);
42
- const promise = resolver.computed;
43
-
44
- resolver.compute();
45
-
46
- expect(await promise).toBe(100);
47
- expect(await resolver.computed).toBe(100);
48
- });
49
-
50
- it("should ignore results from previous iterations when restarted multiple times", async () => {
51
- vi.useFakeTimers();
52
- let callCount = 0;
53
- const compute = vi.fn(() => {
54
- return new Promise<number>((resolve) => {
55
- setTimeout(() => {
56
- callCount++;
57
- resolve(callCount);
58
- }, 100);
59
- });
60
- });
61
-
62
- const resolver = new AsyncResolver(compute);
63
- const promise = resolver.computed;
64
-
65
- // Start first computation
66
- resolver.compute();
67
-
68
- // Restart before first completes
69
- vi.advanceTimersByTime(50);
70
- resolver.compute();
71
-
72
- // Complete both
73
- vi.advanceTimersByTime(100);
74
-
75
- expect(await promise).toEqual(2);
76
- expect(await resolver.computed).toEqual(2);
77
- vi.useRealTimers();
78
- });
79
-
80
- it("should handle computation errors by rejecting settled promise", async () => {
81
- const error = new Error("computation failed");
82
- const compute = vi.fn(() => Promise.reject(error));
83
- const resolver = new AsyncResolver(compute);
84
-
85
- resolver.compute();
86
-
87
- await expect(resolver.computed).rejects.toThrow("computation failed");
88
- });
89
-
90
- it("should handle PendingError by waiting for pending promise then restarting", async () => {
91
- vi.useFakeTimers();
92
- let callCount = 0;
93
- const compute = vi.fn(() => {
94
- callCount++;
95
- if (callCount === 1) {
96
- // First call throws PendingError
97
- return Promise.reject(
98
- new PendingError(
99
- new Promise<number>((resolve) => {
100
- setTimeout(() => resolve(42), 100);
101
- }),
102
- ),
103
- );
104
- }
105
- // Second call (after restart) succeeds
106
- return Promise.resolve(100);
107
- });
108
-
109
- const resolver = new AsyncResolver(compute);
110
- const promise = resolver.computed;
111
-
112
- resolver.compute();
113
- resolver.compute();
114
-
115
- expect(await resolver.computed).toBe(100);
116
- expect(await promise).toBe(100);
117
- vi.useRealTimers();
118
- });
119
-
120
- it("should not restart if aborted before pending promise settles", () => {
121
- vi.useFakeTimers();
122
- let callCount = 0;
123
- const compute = vi.fn(() => {
124
- callCount++;
125
- if (callCount === 1) {
126
- return Promise.reject(
127
- new PendingError(
128
- new Promise<number>((resolve) => {
129
- setTimeout(() => resolve(42), 100);
130
- }),
131
- ),
132
- );
133
- }
134
- return Promise.resolve(100);
135
- });
136
- const onResolve = vi.fn();
137
- const onReject = vi.fn();
138
-
139
- const resolver = new AsyncResolver(compute);
140
- const promise = resolver.computed;
141
- promise.then(onResolve).catch(onReject);
142
-
143
- expect(compute).toHaveBeenCalledTimes(0);
144
- resolver.compute();
145
-
146
- // Abort before pending promise settles
147
- vi.advanceTimersByTime(50);
148
- resolver.abort();
149
-
150
- // Advance time - should not restart
151
- vi.advanceTimersByTime(100);
152
-
153
- expect(compute).toHaveBeenCalledTimes(1);
154
- expect(onResolve).not.toHaveBeenCalled();
155
- expect(onReject).not.toHaveBeenCalled();
156
-
157
- // await expect(resolver.computed).rejects.toThrow(AbortError);
158
- // await expect(promise).rejects.toThrow(AbortError);
159
- vi.useRealTimers();
160
- });
161
-
162
- it("should ignore stale results when iteration changes during computation", async () => {
163
- vi.useFakeTimers();
164
- let callCount = 0;
165
- const compute = vi.fn(() => {
166
- return new Promise<number>((resolve) => {
167
- setTimeout(() => {
168
- callCount++;
169
- resolve(callCount);
170
- }, 100);
171
- });
172
- });
173
-
174
- const resolver = new AsyncResolver(compute);
175
- const promise = resolver.computed;
176
-
177
- resolver.compute();
178
-
179
- // Restart before first completes
180
- vi.advanceTimersByTime(50);
181
- resolver.compute();
182
-
183
- // Restart before first completes
184
- vi.advanceTimersByTime(50);
185
- resolver.compute();
186
-
187
- vi.advanceTimersByTime(100);
188
-
189
- expect(await promise).toBe(3);
190
- expect(await resolver.computed).toBe(3);
191
- vi.useRealTimers();
192
- });
193
- });
194
-
195
- describe("overwrite() method", () => {
196
- it("should replace current computation with new promise", async () => {
197
- const compute = vi.fn(() => Promise.resolve(1));
198
- const resolver = new AsyncResolver(compute);
199
- const promise = resolver.computed;
200
- resolver.compute();
201
- const newPromise = Promise.resolve(42);
202
- resolver.overwrite(newPromise);
203
-
204
- expect(await promise).toBe(42);
205
- expect(await resolver.computed).toBe(42);
206
- });
207
-
208
- it("should resolve settled promise with overwrite promise result", async () => {
209
- const compute = vi.fn(() => Promise.resolve(1));
210
- const resolver = new AsyncResolver(compute);
211
-
212
- resolver.compute();
213
- resolver.overwrite(Promise.resolve(100));
214
-
215
- const result = await resolver.computed;
216
- expect(result).toBe(100);
217
- });
218
-
219
- it("should reject settled promise if overwrite promise rejects", async () => {
220
- const compute = vi.fn(() => Promise.resolve(1));
221
- const resolver = new AsyncResolver(compute);
222
- const promise = resolver.computed;
223
-
224
- resolver.compute();
225
- const error = new Error("overwrite failed");
226
- resolver.overwrite(Promise.reject(error));
227
-
228
- await expect(resolver.computed).rejects.toThrow("overwrite failed");
229
- await expect(promise).rejects.toThrow("overwrite failed");
230
- });
231
-
232
- it("should ignore results from previous computation after overwrite", async () => {
233
- vi.useFakeTimers();
234
- const compute = vi.fn(() => {
235
- return new Promise<number>((resolve) => {
236
- setTimeout(() => resolve(1), 100);
237
- });
238
- });
239
- const resolver = new AsyncResolver(compute);
240
- const promise = resolver.computed;
241
-
242
- resolver.compute();
243
- vi.advanceTimersByTime(50);
244
- resolver.overwrite(Promise.resolve(42));
245
- vi.advanceTimersByTime(100);
246
-
247
- expect(await promise).toBe(42);
248
- expect(await resolver.computed).toBe(42);
249
-
250
- vi.useRealTimers();
251
- });
252
-
253
- it("should ignore stale results when iteration changes", async () => {
254
- vi.useFakeTimers();
255
- const compute = vi.fn(() => Promise.resolve(1));
256
- const resolver = new AsyncResolver(compute);
257
- const promise = resolver.computed;
258
-
259
- resolver.compute();
260
- const promise1 = Promise.resolve(10);
261
- resolver.overwrite(promise1);
262
- const promise2 = Promise.resolve(20);
263
- resolver.overwrite(promise2);
264
-
265
- expect(await resolver.computed).toBe(20);
266
- expect(await promise).toBe(20);
267
- vi.useRealTimers();
268
- });
269
- });
270
-
271
- describe("abort() method", () => {
272
- it("should reject settled promise with PendingError containing AbortError", async () => {
273
- const compute = vi.fn(() => Promise.resolve(42));
274
- const onResolve = vi.fn();
275
- const onReject = vi.fn();
276
- const resolver = new AsyncResolver(compute);
277
- resolver.computed.then(onResolve).catch(onReject);
278
-
279
- resolver.compute();
280
- resolver.abort();
281
-
282
- expect(resolver.aborted).toBe(true);
283
- await new Promise((resolve) => setTimeout(resolve, 0));
284
-
285
- expect(resolver.finished).toBe(false);
286
- expect(onResolve).not.toHaveBeenCalled();
287
- expect(onReject).not.toHaveBeenCalled();
288
- });
289
-
290
- it("should mark resolver as aborted", () => {
291
- vi.useFakeTimers();
292
- const compute = vi.fn(() => {
293
- return new Promise<number>((resolve) => {
294
- setTimeout(() => resolve(42), 100);
295
- });
296
- });
297
- const onResolve = vi.fn();
298
- const onReject = vi.fn();
299
-
300
- const resolver = new AsyncResolver(compute);
301
- resolver.computed.then(onResolve).catch(onReject);
302
-
303
- resolver.compute();
304
- resolver.abort();
305
- vi.advanceTimersByTime(100);
306
-
307
- // Should not resolve even if computation completes
308
- expect(resolver.aborted).toBe(true);
309
- expect(resolver.finished).toBe(false);
310
- expect(onResolve).not.toHaveBeenCalled();
311
- expect(onReject).not.toHaveBeenCalled();
312
-
313
- vi.useRealTimers();
314
- });
315
-
316
- it("should ignore future computation results after abort", () => {
317
- vi.useFakeTimers();
318
- const compute = vi.fn(() => {
319
- return new Promise<number>((resolve) => {
320
- setTimeout(() => resolve(42), 100);
321
- });
322
- });
323
- const onResolve = vi.fn();
324
- const onReject = vi.fn();
325
- const resolver = new AsyncResolver(compute);
326
- resolver.computed.then(onResolve).catch(onReject);
327
-
328
- resolver.compute();
329
- resolver.abort();
330
- vi.advanceTimersByTime(100);
331
-
332
- expect(resolver.aborted).toBe(true);
333
- expect(resolver.finished).toBe(false);
334
- expect(onResolve).not.toHaveBeenCalled();
335
- expect(onReject).not.toHaveBeenCalled();
336
-
337
- vi.useRealTimers();
338
- });
339
-
340
- it("should prevent restart after abort", () => {
341
- vi.useFakeTimers();
342
- const compute = vi.fn(() => {
343
- return new Promise<number>((resolve) => {
344
- setTimeout(() => resolve(42), 100);
345
- });
346
- });
347
- const resolver = new AsyncResolver(compute);
348
-
349
- resolver.compute();
350
- resolver.abort();
351
-
352
- expect(() => resolver.compute()).toThrow();
353
-
354
- vi.useRealTimers();
355
- });
356
- });
357
-
358
- describe("race condition scenarios", () => {
359
- beforeEach(() => {
360
- vi.useFakeTimers();
361
- });
362
-
363
- afterEach(() => {
364
- vi.useRealTimers();
365
- });
366
-
367
- it("should handle rapid successive restarts correctly", async () => {
368
- let callCount = 0;
369
- const compute = vi.fn(() => {
370
- callCount++;
371
- return new Promise<number>((resolve) => {
372
- setTimeout(() => resolve(callCount * 10), 100);
373
- });
374
- });
375
- const resolver = new AsyncResolver(compute);
376
-
377
- resolver.compute();
378
- vi.advanceTimersByTime(10);
379
- resolver.compute();
380
- vi.advanceTimersByTime(10);
381
- resolver.compute();
382
- vi.advanceTimersByTime(100);
383
-
384
- const result = await resolver.computed;
385
- expect(result).toBe(30); // Only last iteration
386
- });
387
-
388
- it("should handle restart during ongoing computation", async () => {
389
- const compute = vi.fn(() => {
390
- return new Promise<number>((resolve) => {
391
- setTimeout(() => resolve(1), 100);
392
- });
393
- });
394
- const resolver = new AsyncResolver(compute);
395
-
396
- resolver.compute();
397
- vi.advanceTimersByTime(50);
398
- resolver.compute();
399
- vi.advanceTimersByTime(100);
400
-
401
- const result = await resolver.computed;
402
- expect(result).toBe(1);
403
- });
404
-
405
- it("should handle overwrite during ongoing computation", async () => {
406
- const compute = vi.fn(() => {
407
- return new Promise<number>((resolve) => {
408
- setTimeout(() => resolve(1), 100);
409
- });
410
- });
411
- const resolver = new AsyncResolver(compute);
412
-
413
- resolver.compute();
414
- vi.advanceTimersByTime(50);
415
- resolver.overwrite(Promise.resolve(42));
416
- vi.advanceTimersByTime(100);
417
-
418
- const result = await resolver.computed;
419
- expect(result).toBe(42);
420
- });
421
-
422
- it("should handle abort during ongoing computation", () => {
423
- vi.useFakeTimers();
424
- const compute = vi.fn(() => {
425
- return new Promise<number>((resolve) => {
426
- setTimeout(() => resolve(1), 100);
427
- });
428
- });
429
- const onResolve = vi.fn();
430
- const onReject = vi.fn();
431
- const resolver = new AsyncResolver(compute);
432
- resolver.computed.then(onResolve).catch(onReject);
433
-
434
- resolver.compute();
435
- vi.advanceTimersByTime(50);
436
- resolver.abort();
437
- vi.advanceTimersByTime(100);
438
-
439
- expect(resolver.aborted).toBe(true);
440
- expect(resolver.finished).toBe(false);
441
- expect(onResolve).not.toHaveBeenCalled();
442
- expect(onReject).not.toHaveBeenCalled();
443
-
444
- vi.useRealTimers();
445
- });
446
-
447
- it("should only resolve/reject with latest iteration result", async () => {
448
- let callCount = 0;
449
- const compute = vi.fn(() => {
450
- callCount++;
451
- return new Promise<number>((resolve) => {
452
- setTimeout(() => resolve(callCount), 100);
453
- });
454
- });
455
- const resolver = new AsyncResolver(compute);
456
-
457
- resolver.compute();
458
- vi.advanceTimersByTime(10);
459
- resolver.compute();
460
- vi.advanceTimersByTime(10);
461
- resolver.compute();
462
- vi.advanceTimersByTime(100);
463
-
464
- const result = await resolver.computed;
465
- expect(result).toBe(3);
466
- });
467
- });
468
-
469
- describe("PendingError handling", () => {
470
- beforeEach(() => {
471
- vi.useFakeTimers();
472
- });
473
-
474
- afterEach(() => {
475
- vi.useRealTimers();
476
- });
477
-
478
- it("should automatically restart after PendingError's promise settles", async () => {
479
- let callCount = 0;
480
- const compute = vi.fn(() => {
481
- callCount++;
482
- if (callCount === 1) {
483
- return Promise.reject(
484
- new PendingError(
485
- new Promise<number>((resolve) => {
486
- setTimeout(() => resolve(42), 100);
487
- }),
488
- ),
489
- );
490
- }
491
- return Promise.resolve(100);
492
- });
493
- const resolver = new AsyncResolver(compute);
494
- const promise = resolver.computed;
495
-
496
- resolver.compute();
497
- resolver.compute();
498
-
499
- const result = await promise;
500
- expect(result).toBe(100);
501
- });
502
-
503
- it("should not restart if iteration changed while waiting for pending promise", async () => {
504
- let callCount = 0;
505
- const compute = vi.fn(() => {
506
- callCount++;
507
- if (callCount === 1) {
508
- return Promise.reject(
509
- new PendingError(
510
- new Promise<number>((resolve) => {
511
- setTimeout(() => resolve(42), 100);
512
- }),
513
- ),
514
- );
515
- }
516
- return Promise.resolve(100);
517
- });
518
- const resolver = new AsyncResolver(compute);
519
-
520
- resolver.compute();
521
- vi.advanceTimersByTime(50);
522
- // Change iteration by restarting
523
- resolver.compute();
524
- vi.advanceTimersByTime(100);
525
-
526
- // Should not have restarted automatically
527
- await vi.waitFor(() => expect(compute).toHaveBeenCalledTimes(2));
528
- const result = await resolver.computed;
529
- expect(result).toBe(100);
530
- });
531
-
532
- it("should not restart if aborted while waiting for pending promise", () => {
533
- vi.useFakeTimers();
534
- let callCount = 0;
535
- const compute = vi.fn(() => {
536
- callCount++;
537
- if (callCount === 1) {
538
- return Promise.reject(
539
- new PendingError(
540
- new Promise<number>((resolve) => {
541
- setTimeout(() => resolve(42), 100);
542
- }),
543
- ),
544
- );
545
- }
546
- return Promise.resolve(100);
547
- });
548
- const onResolve = vi.fn();
549
- const onReject = vi.fn();
550
- const resolver = new AsyncResolver(compute);
551
- resolver.computed.then(onResolve).catch(onReject);
552
-
553
- resolver.compute();
554
- vi.advanceTimersByTime(50);
555
- resolver.abort();
556
- vi.advanceTimersByTime(100);
557
-
558
- // Should not have restarted automatically
559
- expect(resolver.aborted).toBe(true);
560
- expect(resolver.finished).toBe(false);
561
- expect(onResolve).not.toHaveBeenCalled();
562
- expect(onReject).not.toHaveBeenCalled();
563
-
564
- vi.useRealTimers();
565
- });
566
-
567
- it("should handle multiple PendingErrors in sequence", async () => {
568
- let callCount = 0;
569
- const compute = vi.fn(() => {
570
- callCount++;
571
- if (callCount === 1 || callCount === 2) {
572
- return Promise.reject(
573
- new PendingError(
574
- new Promise<number>((resolve) => {
575
- setTimeout(() => resolve(42), 50);
576
- }),
577
- ),
578
- );
579
- }
580
- return Promise.resolve(100);
581
- });
582
- const resolver = new AsyncResolver(compute);
583
- const promise = resolver.computed;
584
-
585
- resolver.compute();
586
- resolver.compute();
587
- resolver.compute();
588
-
589
- const result = await promise;
590
- expect(result).toBe(100);
591
- });
592
- });
593
- });