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