@ersbeth/picoflow 2.0.2 → 2.0.3

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 (152) hide show
  1. package/README.md +10 -0
  2. package/SKILL.md +106 -0
  3. package/package.json +5 -1
  4. package/.gitlab-ci.yml +0 -24
  5. package/.vscode/settings.json +0 -5
  6. package/CHANGELOG.md +0 -94
  7. package/biome.json +0 -47
  8. package/docs/.vitepress/config.mts +0 -145
  9. package/docs/api/functions/array.md +0 -35
  10. package/docs/api/functions/constant.md +0 -33
  11. package/docs/api/functions/constantAsync.md +0 -69
  12. package/docs/api/functions/derivation.md +0 -34
  13. package/docs/api/functions/derivationAsync.md +0 -34
  14. package/docs/api/functions/from.md +0 -129
  15. package/docs/api/functions/isDisposable.md +0 -27
  16. package/docs/api/functions/map.md +0 -36
  17. package/docs/api/functions/signal.md +0 -21
  18. package/docs/api/functions/state.md +0 -67
  19. package/docs/api/functions/stateAsync.md +0 -69
  20. package/docs/api/functions/subscribe.md +0 -40
  21. package/docs/api/functions/writableDerivation.md +0 -33
  22. package/docs/api/functions/writableDerivationAsync.md +0 -34
  23. package/docs/api/index.md +0 -61
  24. package/docs/api/interfaces/FlowArray.md +0 -439
  25. package/docs/api/interfaces/FlowConstant.md +0 -220
  26. package/docs/api/interfaces/FlowConstantAsync.md +0 -221
  27. package/docs/api/interfaces/FlowDerivation.md +0 -241
  28. package/docs/api/interfaces/FlowDerivationAsync.md +0 -242
  29. package/docs/api/interfaces/FlowDisposable.md +0 -59
  30. package/docs/api/interfaces/FlowEffect.md +0 -64
  31. package/docs/api/interfaces/FlowMap.md +0 -374
  32. package/docs/api/interfaces/FlowObservable.md +0 -155
  33. package/docs/api/interfaces/FlowSignal.md +0 -156
  34. package/docs/api/interfaces/FlowState.md +0 -269
  35. package/docs/api/interfaces/FlowStateAsync.md +0 -268
  36. package/docs/api/interfaces/FlowSubscribable.md +0 -55
  37. package/docs/api/interfaces/FlowTracker.md +0 -61
  38. package/docs/api/interfaces/FlowValue.md +0 -222
  39. package/docs/api/interfaces/FlowWritableDerivation.md +0 -292
  40. package/docs/api/interfaces/FlowWritableDerivationAsync.md +0 -293
  41. package/docs/api/type-aliases/DerivationFunction.md +0 -28
  42. package/docs/api/type-aliases/DerivationFunctionAsync.md +0 -28
  43. package/docs/api/type-aliases/FlowArrayAction.md +0 -60
  44. package/docs/api/type-aliases/FlowDataTracker.md +0 -33
  45. package/docs/api/type-aliases/FlowMapAction.md +0 -48
  46. package/docs/api/type-aliases/FlowOnDataListener.md +0 -33
  47. package/docs/api/type-aliases/FlowOnErrorListener.md +0 -27
  48. package/docs/api/type-aliases/FlowOnPendingListener.md +0 -21
  49. package/docs/api/type-aliases/FlowReadonly.md +0 -22
  50. package/docs/api/type-aliases/InitFunction.md +0 -21
  51. package/docs/api/type-aliases/InitFunctionAsync.md +0 -21
  52. package/docs/api/type-aliases/NotPromise.md +0 -21
  53. package/docs/api/type-aliases/UpdateFunction.md +0 -27
  54. package/docs/api/type-aliases/UpdateFunctionAsync.md +0 -27
  55. package/docs/api/typedoc-sidebar.json +0 -65
  56. package/docs/examples/examples.md +0 -2311
  57. package/docs/examples/patterns.md +0 -649
  58. package/docs/guide/advanced/architecture.md +0 -1234
  59. package/docs/guide/advanced/disposal.md +0 -426
  60. package/docs/guide/advanced/migration-v1.md +0 -464
  61. package/docs/guide/advanced/migration-v2.md +0 -204
  62. package/docs/guide/advanced/solidjs.md +0 -135
  63. package/docs/guide/introduction/concepts.md +0 -57
  64. package/docs/guide/introduction/conventions.md +0 -30
  65. package/docs/guide/introduction/getting-started.md +0 -139
  66. package/docs/guide/introduction/lifecycle.md +0 -368
  67. package/docs/guide/primitives/array.md +0 -286
  68. package/docs/guide/primitives/constant.md +0 -207
  69. package/docs/guide/primitives/derivations.md +0 -281
  70. package/docs/guide/primitives/effects.md +0 -372
  71. package/docs/guide/primitives/map.md +0 -265
  72. package/docs/guide/primitives/overview.md +0 -92
  73. package/docs/guide/primitives/signal.md +0 -222
  74. package/docs/guide/primitives/state.md +0 -272
  75. package/docs/index.md +0 -47
  76. package/docs/public/logo.svg +0 -1
  77. package/src/api/base/flowDisposable.ts +0 -44
  78. package/src/api/base/flowObservable.ts +0 -28
  79. package/src/api/base/flowSubscribable.ts +0 -87
  80. package/src/api/base/flowTracker.ts +0 -7
  81. package/src/api/base/index.ts +0 -4
  82. package/src/api/index.ts +0 -2
  83. package/src/api/nodes/async/flowConstantAsync.ts +0 -36
  84. package/src/api/nodes/async/flowDerivationAsync.ts +0 -42
  85. package/src/api/nodes/async/flowStateAsync.ts +0 -47
  86. package/src/api/nodes/async/flowWritableDerivationAsync.ts +0 -33
  87. package/src/api/nodes/async/index.ts +0 -4
  88. package/src/api/nodes/collections/flowArray.ts +0 -155
  89. package/src/api/nodes/collections/flowMap.ts +0 -115
  90. package/src/api/nodes/collections/index.ts +0 -2
  91. package/src/api/nodes/flowEffect.ts +0 -42
  92. package/src/api/nodes/flowSignal.ts +0 -28
  93. package/src/api/nodes/flowValue.ts +0 -37
  94. package/src/api/nodes/index.ts +0 -7
  95. package/src/api/nodes/sync/flowConstant.ts +0 -33
  96. package/src/api/nodes/sync/flowDerivation.ts +0 -41
  97. package/src/api/nodes/sync/flowState.ts +0 -45
  98. package/src/api/nodes/sync/flowWritableDerivation.ts +0 -31
  99. package/src/api/nodes/sync/index.ts +0 -4
  100. package/src/api/nodes/utils.ts +0 -24
  101. package/src/base/disposable.ts +0 -18
  102. package/src/base/executionStack.ts +0 -42
  103. package/src/base/index.ts +0 -5
  104. package/src/base/node.ts +0 -98
  105. package/src/base/observable.ts +0 -92
  106. package/src/base/observer.ts +0 -51
  107. package/src/converters/index.ts +0 -1
  108. package/src/converters/solid.ts +0 -109
  109. package/src/index.ts +0 -2
  110. package/src/nodes/arrayNode.ts +0 -180
  111. package/src/nodes/effectNode.ts +0 -58
  112. package/src/nodes/index.ts +0 -7
  113. package/src/nodes/mapNode.ts +0 -125
  114. package/src/nodes/signalNode.ts +0 -19
  115. package/src/nodes/valueAsyncNode.ts +0 -85
  116. package/src/nodes/valueNode.ts +0 -148
  117. package/src/nodes/valueSyncNode.ts +0 -125
  118. package/src/schedulers/asyncResolver.ts +0 -78
  119. package/src/schedulers/asyncScheduler.ts +0 -66
  120. package/src/schedulers/index.ts +0 -4
  121. package/src/schedulers/pendingError.ts +0 -13
  122. package/src/schedulers/scheduler.ts +0 -9
  123. package/src/schedulers/syncResolver.ts +0 -69
  124. package/src/schedulers/syncScheduler.ts +0 -55
  125. package/test/base/pendingError.test.ts +0 -67
  126. package/test/converters/solid.derivation.browser.test.tsx +0 -69
  127. package/test/converters/solid.node.test.ts +0 -654
  128. package/test/converters/solid.state.browser.test.tsx +0 -1592
  129. package/test/reactivity/flowSignal.test.ts +0 -226
  130. package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +0 -593
  131. package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +0 -317
  132. package/test/reactivity/nodes/async/flowConstantAsync.test.ts +0 -652
  133. package/test/reactivity/nodes/async/flowDerivation.test.ts +0 -898
  134. package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +0 -1716
  135. package/test/reactivity/nodes/async/flowStateAsync.test.ts +0 -708
  136. package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +0 -614
  137. package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +0 -1289
  138. package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +0 -961
  139. package/test/reactivity/nodes/collections/flowArray.states.test.ts +0 -1035
  140. package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +0 -960
  141. package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +0 -775
  142. package/test/reactivity/nodes/collections/flowMap.states.test.ts +0 -958
  143. package/test/reactivity/nodes/sync/flowConstant.test.ts +0 -377
  144. package/test/reactivity/nodes/sync/flowDerivation.test.ts +0 -896
  145. package/test/reactivity/nodes/sync/flowState.test.ts +0 -341
  146. package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +0 -603
  147. package/test/vitest.d.ts +0 -10
  148. package/tsconfig.json +0 -37
  149. package/typedoc.json +0 -37
  150. package/vite.config.ts +0 -31
  151. package/vitest.browser.config.ts +0 -21
  152. 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
- });