@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,317 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
- import { AsyncScheduler } from "~/schedulers/";
3
-
4
- describe("PendingScheduler", () => {
5
- describe("initialization", () => {
6
- it("should create instance with compute function", () => {
7
- const compute = vi.fn(() => Promise.resolve(42));
8
- const scheduler = new AsyncScheduler(
9
- compute,
10
- () => {},
11
- () => {},
12
- );
13
-
14
- expect(scheduler).toBeInstanceOf(AsyncScheduler);
15
- });
16
-
17
- it("should create internal PendingResolver on construction", () => {
18
- const compute = vi.fn(() => Promise.resolve(42));
19
- const scheduler = new AsyncScheduler(
20
- compute,
21
- () => {},
22
- () => {},
23
- );
24
-
25
- // Should be able to get settled promise (indicates resolver exists)
26
- expect(scheduler.settled).toBeInstanceOf(Promise);
27
- });
28
-
29
- it("should return promise from settled getter", () => {
30
- const compute = vi.fn(() => Promise.resolve(42));
31
- const scheduler = new AsyncScheduler(
32
- compute,
33
- () => {},
34
- () => {},
35
- );
36
-
37
- expect(scheduler.settled).toBeInstanceOf(Promise);
38
- });
39
- });
40
-
41
- describe("reset() method", () => {
42
- it("should transfer current resolver", async () => {
43
- vi.useFakeTimers();
44
- const compute = vi.fn(() => {
45
- return new Promise<number>((resolve) => {
46
- setTimeout(() => resolve(42), 100);
47
- });
48
- });
49
- const onResolve = vi.fn();
50
- const onReject = vi.fn();
51
-
52
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
53
- const settled1 = scheduler.settled;
54
-
55
- scheduler.compute();
56
- vi.advanceTimersByTime(50);
57
-
58
- scheduler.compute();
59
- const settled2 = scheduler.settled;
60
-
61
- vi.advanceTimersByTime(100);
62
-
63
- await expect(settled1).resolves.toBe(undefined);
64
- await expect(settled2).resolves.toBe(undefined);
65
-
66
- expect(onResolve).toHaveBeenCalledTimes(1);
67
- expect(onResolve).toHaveBeenCalledWith(42);
68
- expect(onReject).not.toHaveBeenCalled();
69
-
70
- vi.useRealTimers();
71
- });
72
-
73
- it("should create new resolver instance when finished", async () => {
74
- const compute = vi.fn(() => Promise.resolve(42));
75
- const onResolve = vi.fn();
76
- const onReject = vi.fn();
77
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
78
-
79
- const firstSettled = scheduler.settled;
80
- scheduler.compute();
81
- await firstSettled;
82
- scheduler.compute();
83
- const secondSettled = scheduler.settled;
84
- await secondSettled;
85
-
86
- // Should be different promises (different resolver instances)
87
- expect(firstSettled).not.toBe(secondSettled);
88
- });
89
-
90
- it("should allow new computation to start after reset", async () => {
91
- const compute = vi.fn(() => Promise.resolve(100));
92
- const onResolve = vi.fn();
93
- const onReject = vi.fn();
94
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
95
-
96
- scheduler.compute();
97
- await scheduler.settled;
98
- scheduler.compute();
99
-
100
- await scheduler.settled;
101
- expect(onResolve).toHaveBeenCalledTimes(2);
102
- expect(onResolve).toHaveBeenNthCalledWith(1, 100);
103
- expect(onResolve).toHaveBeenNthCalledWith(2, 100);
104
- expect(onReject).not.toHaveBeenCalled();
105
- });
106
-
107
- it("should discard ongoing computation", async () => {
108
- vi.useFakeTimers();
109
- const onResolve = vi.fn();
110
- const onReject = vi.fn();
111
- const compute = vi.fn(() => {
112
- return new Promise<number>((resolve) => {
113
- setTimeout(() => resolve(42), 100);
114
- });
115
- });
116
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
117
- const settled1 = scheduler.settled;
118
-
119
- scheduler.compute();
120
- vi.advanceTimersByTime(50);
121
-
122
- scheduler.compute();
123
- const settled2 = scheduler.settled;
124
- vi.advanceTimersByTime(100);
125
-
126
- // Old computation should be discarded
127
- await settled1;
128
- await settled2;
129
- expect(onResolve).toHaveBeenCalledTimes(1);
130
- expect(onResolve).toHaveBeenCalledWith(42);
131
- expect(onReject).not.toHaveBeenCalled();
132
- vi.useRealTimers();
133
- });
134
- });
135
-
136
- describe("overwrite() method", () => {
137
- it("should delegate to resolver's overwrite method", async () => {
138
- const compute = vi.fn(() => Promise.resolve(1));
139
- const onResolve = vi.fn();
140
- const onReject = vi.fn();
141
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
142
-
143
- scheduler.compute();
144
- scheduler.overwrite(Promise.resolve(42));
145
-
146
- await scheduler.settled;
147
- expect(onResolve).toHaveBeenCalledTimes(1);
148
- expect(onResolve).toHaveBeenCalledWith(42);
149
- expect(onReject).not.toHaveBeenCalled();
150
- });
151
-
152
- it("should work correctly after reset", async () => {
153
- const compute = vi.fn(() => Promise.resolve(1));
154
- const onResolve = vi.fn();
155
- const onReject = vi.fn();
156
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
157
-
158
- scheduler.compute();
159
- scheduler.compute();
160
- scheduler.overwrite(Promise.resolve(100));
161
-
162
- await scheduler.settled;
163
- expect(onResolve).toHaveBeenCalledTimes(1);
164
- expect(onResolve).toHaveBeenCalledWith(100);
165
- expect(onReject).not.toHaveBeenCalled();
166
- });
167
- });
168
-
169
- describe("restart() method", () => {
170
- it("should delegate to resolver's restart method", async () => {
171
- const compute = vi.fn(() => Promise.resolve(42));
172
- const onResolve = vi.fn();
173
- const onReject = vi.fn();
174
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
175
-
176
- scheduler.compute();
177
-
178
- await scheduler.settled;
179
- expect(onResolve).toHaveBeenCalledTimes(1);
180
- expect(onResolve).toHaveBeenCalledWith(42);
181
- expect(onReject).not.toHaveBeenCalled();
182
- expect(compute).toHaveBeenCalledTimes(1);
183
- });
184
-
185
- it("should work correctly after reset", async () => {
186
- const compute = vi.fn(() => Promise.resolve(100));
187
- const onResolve = vi.fn();
188
- const onReject = vi.fn();
189
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
190
-
191
- scheduler.compute();
192
- await scheduler.settled;
193
- scheduler.compute();
194
-
195
- await scheduler.settled;
196
- expect(onResolve).toHaveBeenCalledTimes(2);
197
- expect(onResolve).toHaveBeenNthCalledWith(1, 100);
198
- expect(onResolve).toHaveBeenNthCalledWith(2, 100);
199
- expect(onReject).not.toHaveBeenCalled();
200
- expect(compute).toHaveBeenCalledTimes(2);
201
- });
202
- });
203
-
204
- describe("abort() method", () => {
205
- it("should delegate to resolver's abort method", async () => {
206
- const compute = vi.fn(() => Promise.resolve(42));
207
- const onResolve = vi.fn();
208
- const onReject = vi.fn();
209
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
210
-
211
- scheduler.compute();
212
- scheduler.dispose();
213
-
214
- await new Promise((resolve) => setTimeout(resolve, 0));
215
-
216
- expect(compute).toHaveBeenCalledTimes(1);
217
- expect(onReject).not.toHaveBeenCalled();
218
- expect(onResolve).not.toHaveBeenCalled();
219
- });
220
-
221
- it("should work correctly after reset", async () => {
222
- const compute = vi.fn(() => Promise.resolve(42));
223
- const onResolve = vi.fn();
224
- const onReject = vi.fn();
225
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
226
-
227
- scheduler.compute();
228
- scheduler.compute();
229
- scheduler.dispose();
230
-
231
- await new Promise((resolve) => setTimeout(resolve, 0));
232
-
233
- expect(compute).toHaveBeenCalledTimes(2);
234
- expect(onReject).not.toHaveBeenCalled();
235
- expect(onResolve).not.toHaveBeenCalled();
236
- });
237
- });
238
-
239
- describe("lifecycle management", () => {
240
- beforeEach(() => {
241
- vi.useFakeTimers();
242
- });
243
-
244
- afterEach(() => {
245
- vi.useRealTimers();
246
- });
247
-
248
- it("should maintain independent resolver instances after reset", async () => {
249
- const compute = vi.fn(() => {
250
- return new Promise<number>((resolve) => {
251
- setTimeout(() => resolve(42), 100);
252
- });
253
- });
254
- const onResolve = vi.fn();
255
- const onReject = vi.fn();
256
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
257
-
258
- scheduler.compute();
259
- const firstSettled = scheduler.settled;
260
- vi.advanceTimersByTime(50);
261
- scheduler.compute();
262
- const secondSettled = scheduler.settled;
263
- vi.advanceTimersByTime(100);
264
-
265
- // First should be aborted, second should resolve
266
- await firstSettled;
267
- await secondSettled;
268
- expect(onResolve).toHaveBeenCalledTimes(1);
269
- expect(onResolve).toHaveBeenCalledWith(42);
270
- expect(onReject).not.toHaveBeenCalled();
271
- });
272
-
273
- it("should allow multiple reset/restart cycles", async () => {
274
- const compute = vi.fn(() => Promise.resolve(42));
275
- const onResolve = vi.fn();
276
- const onReject = vi.fn();
277
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
278
-
279
- scheduler.compute();
280
- await scheduler.settled;
281
- scheduler.compute();
282
- await scheduler.settled;
283
- scheduler.compute();
284
- await scheduler.settled;
285
-
286
- expect(onResolve).toHaveBeenCalledTimes(3);
287
- expect(onResolve).toHaveBeenNthCalledWith(1, 42);
288
- expect(onResolve).toHaveBeenNthCalledWith(2, 42);
289
- expect(onResolve).toHaveBeenNthCalledWith(3, 42);
290
- expect(onReject).not.toHaveBeenCalled();
291
- expect(compute).toHaveBeenCalledTimes(3);
292
- });
293
-
294
- it("should handle operations after reset correctly", async () => {
295
- const compute = vi.fn(() => Promise.resolve(100));
296
- const onResolve = vi.fn();
297
- const onReject = vi.fn();
298
- const scheduler = new AsyncScheduler(compute, onResolve, onReject);
299
-
300
- scheduler.compute();
301
- await scheduler.settled;
302
- scheduler.compute();
303
- scheduler.overwrite(Promise.resolve(200));
304
- await scheduler.settled;
305
- expect(onResolve).toHaveBeenCalledTimes(2);
306
- expect(onResolve).toHaveBeenNthCalledWith(1, 100);
307
- expect(onResolve).toHaveBeenNthCalledWith(2, 200);
308
- expect(onReject).not.toHaveBeenCalled();
309
-
310
- scheduler.compute();
311
- await scheduler.settled;
312
- expect(onResolve).toHaveBeenCalledTimes(3);
313
- expect(onResolve).toHaveBeenNthCalledWith(3, 100);
314
- expect(onReject).not.toHaveBeenCalled();
315
- });
316
- });
317
- });