@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,896 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
- import type { FlowTracker } from "~";
3
- import { derivation, signal, state, subscribe } from "~";
4
-
5
- describe("flowDerivation", () => {
6
- describe("unit", () => {
7
- describe("initialization", () => {
8
- it("should support self-derivation function without previous value", async () => {
9
- const $state = state(1);
10
- const compute = (t: FlowTracker) => {
11
- return 2 * $state.get(t);
12
- };
13
- const $derivation = derivation(compute);
14
- const onData = vi.fn();
15
- $derivation.subscribe(onData);
16
-
17
- expect(await $derivation.pick()).toBe(2);
18
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
19
- expect(onData).toHaveBeenLastCalledWith(2);
20
-
21
- $state.set(2);
22
- expect(await $derivation.pick()).toBe(4);
23
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
24
- expect(onData).toHaveBeenLastCalledWith(4);
25
- });
26
-
27
- it("should support self-derivation function with previous value", async () => {
28
- const $state = state(1);
29
- const compute = (t: FlowTracker, previous?: number) => {
30
- const current = $state.get(t);
31
- return previous !== undefined ? previous + current : current;
32
- };
33
- const $derivation = derivation(compute);
34
- const onData = vi.fn();
35
- $derivation.subscribe(onData);
36
-
37
- expect(await $derivation.pick()).toBe(1);
38
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
39
- expect(onData).toHaveBeenLastCalledWith(1);
40
-
41
- $state.set(2);
42
- expect(await $derivation.pick()).toBe(3);
43
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
44
- expect(onData).toHaveBeenLastCalledWith(3);
45
- });
46
- });
47
-
48
- describe("reactive dependencies", () => {
49
- it("should recompute when state dependency changes", async () => {
50
- const $state = state(1);
51
- const computeFn = vi.fn((t) => $state.get(t) * 2);
52
- const $derivation = derivation(computeFn);
53
-
54
- expect(await $derivation.pick()).toBe(2);
55
- expect(computeFn).toHaveBeenCalledTimes(1);
56
-
57
- $state.set(2);
58
- expect(await $derivation.pick()).toBe(4);
59
- expect(computeFn).toHaveBeenCalledTimes(2);
60
- });
61
-
62
- it("should recompute when signal dependency is triggered", async () => {
63
- const $signal = signal();
64
- const $state = state(0);
65
- const computeFn = vi.fn((t) => {
66
- $signal.watch(t);
67
- return $state.get(t);
68
- });
69
- const $derivation = derivation(computeFn);
70
-
71
- expect(await $derivation.pick()).toBe(0);
72
- expect(computeFn).toHaveBeenCalledTimes(1);
73
-
74
- $state.set(1);
75
- $signal.trigger();
76
- expect(await $derivation.pick()).toBe(1);
77
- expect(computeFn).toHaveBeenCalledTimes(2);
78
- });
79
-
80
- it("should recompute when another derivation dependency changes", async () => {
81
- const $state = state(1);
82
- const $derivation1 = derivation((t) => $state.get(t) * 2);
83
- derivation((t) => $derivation1.get(t) * 2);
84
- const computeFn = vi.fn((t) => $derivation1.get(t) * 2);
85
- const $derivation2Spy = derivation(computeFn);
86
-
87
- expect(await $derivation2Spy.pick()).toBe(4);
88
- expect(computeFn).toHaveBeenCalledTimes(1);
89
-
90
- $state.set(2);
91
- expect(await $derivation2Spy.pick()).toBe(8);
92
- expect(computeFn).toHaveBeenCalledTimes(2);
93
- });
94
-
95
- it("should mark as dirty when dependency changes", async () => {
96
- const $state = state(1);
97
- const computeFn = vi.fn((t) => $state.get(t) * 2);
98
- const $derivation = derivation(computeFn);
99
-
100
- await $derivation.pick();
101
- expect(computeFn).toHaveBeenCalledTimes(1);
102
-
103
- $state.set(2);
104
- // Should be dirty but not recomputed yet
105
- expect(computeFn).toHaveBeenCalledTimes(1);
106
-
107
- // Next access triggers recomputation
108
- await $derivation.pick();
109
- expect(computeFn).toHaveBeenCalledTimes(2);
110
- });
111
-
112
- it("should recompute if value is identical after dependency change", async () => {
113
- const $state = state(2);
114
- const computeFn = vi.fn((t) => $state.get(t) * 0);
115
- const $derivation = derivation(computeFn);
116
- const onData = vi.fn();
117
-
118
- $derivation.subscribe(onData);
119
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
120
- expect(onData).toHaveBeenLastCalledWith(0);
121
-
122
- $state.set(5);
123
- // Value is still 0 (2*0 = 0, 5*0 = 0), but derivation is marked dirty
124
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
125
- expect(onData).toHaveBeenLastCalledWith(0);
126
- });
127
- });
128
-
129
- describe("get", () => {
130
- it("should recompute when dependency changes with tracking via subscribe", async () => {
131
- const $state = state(1);
132
- const computeFn = vi.fn((t) => $state.get(t) * 2);
133
- const $derivation = derivation(computeFn);
134
- const onData = vi.fn();
135
-
136
- $derivation.subscribe((value) => {
137
- onData(value);
138
- });
139
-
140
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
141
- expect(onData).toHaveBeenLastCalledWith(2);
142
- expect(computeFn).toHaveBeenCalledTimes(1);
143
-
144
- $state.set(2);
145
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
146
- expect(onData).toHaveBeenLastCalledWith(4);
147
- expect(computeFn).toHaveBeenCalledTimes(2);
148
- });
149
-
150
- it("should register dependencies automatically via tracker in subscribe", async () => {
151
- const $state1 = state(1);
152
- const $state2 = state(2);
153
- const computeFn = vi.fn((t) => {
154
- return $state1.get(t) + $state2.get(t);
155
- });
156
- const $derivation = derivation(computeFn);
157
- const onData = vi.fn();
158
-
159
- $derivation.subscribe((value) => {
160
- onData(value);
161
- });
162
-
163
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
164
- expect(onData).toHaveBeenLastCalledWith(3);
165
-
166
- $state1.set(3);
167
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
168
- expect(onData).toHaveBeenLastCalledWith(5);
169
-
170
- $state2.set(4);
171
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
172
- expect(onData).toHaveBeenLastCalledWith(7);
173
- });
174
-
175
- it("should propagate errors in compute function with dependencies", async () => {
176
- const $state = state(1);
177
- const error = new Error("Compute error");
178
- const $derivation = derivation((t) => {
179
- const value = $state.get(t);
180
- if (value > 1) {
181
- throw error;
182
- }
183
- return value;
184
- });
185
-
186
- await $derivation.pick();
187
-
188
- $state.set(2);
189
- await expect($derivation.pick()).rejects.toThrow(error);
190
- });
191
- });
192
-
193
- describe("watch", () => {
194
- it("should register dependency when watch is called in effect context", async () => {
195
- const $state = state(1);
196
- const $derivation = derivation((t) => $state.get(t) * 2);
197
- const onData = vi.fn();
198
-
199
- subscribe((t) => $derivation.watch(t), onData);
200
-
201
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
202
- });
203
-
204
- it("should recompute when dependency changes after watch", async () => {
205
- const $state = state(1);
206
- const computeFn = vi.fn((t) => $state.get(t) * 2);
207
- const $derivation = derivation(computeFn);
208
- const onData = vi.fn();
209
-
210
- subscribe((t) => $derivation.watch(t), onData);
211
-
212
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
213
- expect(computeFn).toHaveBeenCalledTimes(1);
214
-
215
- $state.set(2);
216
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
217
- expect(computeFn).toHaveBeenCalledTimes(2);
218
- });
219
- });
220
-
221
- describe("pick", () => {
222
- it("should recompute when dependency changes without tracking", async () => {
223
- const $state = state(1);
224
- const computeFn = vi.fn((t) => $state.get(t) * 2);
225
- const $derivation = derivation(computeFn);
226
-
227
- expect(await $derivation.pick()).toBe(2);
228
- expect(computeFn).toHaveBeenCalledTimes(1);
229
-
230
- $state.set(2);
231
- expect(await $derivation.pick()).toBe(4);
232
- expect(computeFn).toHaveBeenCalledTimes(2);
233
- });
234
- });
235
-
236
- describe("refresh", () => {
237
- it("should force recomputation even if not dirty", async () => {
238
- const $state = state(1);
239
- const computeFn = vi.fn((t) => $state.get(t) * 2);
240
- const $derivation = derivation(computeFn);
241
-
242
- await $derivation.pick();
243
- expect(computeFn).toHaveBeenCalledTimes(1);
244
-
245
- $derivation.refresh();
246
- await new Promise((resolve) => setTimeout(resolve, 10));
247
- expect(computeFn).toHaveBeenCalledTimes(2);
248
- });
249
-
250
- it("should notify only if value changes after refresh", async () => {
251
- let multiplier = 2;
252
- const $state = state(5);
253
- const $derivation = derivation((t) => $state.get(t) * multiplier);
254
- const onData = vi.fn();
255
-
256
- $derivation.subscribe(onData);
257
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
258
- expect(onData).toHaveBeenLastCalledWith(10);
259
-
260
- multiplier = 3;
261
- $derivation.refresh();
262
- // Refresh triggers notification asynchronously
263
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2), {
264
- timeout: 2000,
265
- });
266
- expect(onData).toHaveBeenLastCalledWith(15);
267
- });
268
-
269
- it("should not notify if value is identical after refresh", async () => {
270
- const $state = state(5);
271
- const $derivation = derivation((t) => $state.get(t) * 2);
272
- const onData = vi.fn();
273
-
274
- $derivation.subscribe(onData);
275
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
276
-
277
- $derivation.refresh();
278
- await new Promise((resolve) => setTimeout(resolve, 50));
279
- expect(onData).toHaveBeenCalledTimes(1);
280
- });
281
-
282
- it("should force recomputation even if dependencies have not changed", async () => {
283
- const $state = state(1);
284
- const computeFn = vi.fn((t) => $state.get(t) * 2);
285
- const $derivation = derivation(computeFn);
286
-
287
- await $derivation.pick();
288
- expect(computeFn).toHaveBeenCalledTimes(1);
289
-
290
- $derivation.refresh();
291
- await new Promise((resolve) => setTimeout(resolve, 10));
292
- expect(computeFn).toHaveBeenCalledTimes(2);
293
- });
294
- });
295
-
296
- describe("dynamic dependencies", () => {
297
- it("should handle dependencies that change between computations", async () => {
298
- const $state1 = state(1);
299
- const $state2 = state(10);
300
- const $cond = state(true);
301
- const computeFn = vi.fn((t) => {
302
- if ($cond.get(t)) {
303
- return $state1.get(t) * 2;
304
- }
305
- return $state2.get(t) * 2;
306
- });
307
- const $derivation = derivation(computeFn);
308
-
309
- expect(await $derivation.pick()).toBe(2);
310
- expect(computeFn).toHaveBeenCalledTimes(1);
311
-
312
- $state1.set(2);
313
- expect(await $derivation.pick()).toBe(4);
314
- expect(computeFn).toHaveBeenCalledTimes(2);
315
-
316
- $cond.set(false);
317
- expect(await $derivation.pick()).toBe(20);
318
- expect(computeFn).toHaveBeenCalledTimes(3);
319
-
320
- $state2.set(20);
321
- expect(await $derivation.pick()).toBe(40);
322
- expect(computeFn).toHaveBeenCalledTimes(4);
323
-
324
- $state1.set(100);
325
- expect(await $derivation.pick()).toBe(40);
326
- expect(computeFn).toHaveBeenCalledTimes(4);
327
- });
328
-
329
- it("should unregister dependencies that are no longer used", async () => {
330
- const $state1 = state(1);
331
- const $state2 = state(10);
332
- const $cond = state(true);
333
- const $derivation = derivation((t) => {
334
- if ($cond.get(t)) {
335
- return $state1.get(t);
336
- }
337
- return $state2.get(t);
338
- });
339
- const onData = vi.fn();
340
-
341
- $derivation.subscribe(onData);
342
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
343
-
344
- $cond.set(false);
345
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
346
-
347
- $state1.set(100);
348
- await new Promise((resolve) => setTimeout(resolve, 50));
349
- expect(onData).toHaveBeenCalledTimes(2);
350
- });
351
-
352
- it("should handle dependencies that appear and disappear", async () => {
353
- const $state1 = state(1);
354
- const $state2 = state(2);
355
- const $useState1 = state(true);
356
- const $derivation = derivation((t) => {
357
- if ($useState1.get(t)) {
358
- return $state1.get(t);
359
- }
360
- return $state2.get(t);
361
- });
362
- const onData = vi.fn();
363
-
364
- $derivation.subscribe(onData);
365
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
366
- expect(onData).toHaveBeenLastCalledWith(1);
367
-
368
- $useState1.set(false);
369
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
370
- expect(onData).toHaveBeenLastCalledWith(2);
371
-
372
- $useState1.set(true);
373
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
374
- expect(onData).toHaveBeenLastCalledWith(1);
375
- });
376
- });
377
-
378
- describe("nested derivations", () => {
379
- it("should handle derivation depending on another derivation", async () => {
380
- const $state = state(1);
381
- const $derivation1 = derivation((t) => $state.get(t) * 2);
382
- const $derivation2 = derivation((t) => $derivation1.get(t) * 2);
383
-
384
- expect(await $derivation2.pick()).toBe(4);
385
-
386
- $state.set(2);
387
- expect(await $derivation2.pick()).toBe(8);
388
- });
389
-
390
- it("should handle chain of derivations", async () => {
391
- const $state = state(1);
392
- const $derivationA = derivation((t) => $state.get(t) * 2);
393
- const $derivationB = derivation((t) => $derivationA.get(t) * 2);
394
- const $derivationC = derivation((t) => $derivationB.get(t) * 2);
395
-
396
- expect(await $derivationC.pick()).toBe(8);
397
-
398
- $state.set(2);
399
- expect(await $derivationC.pick()).toBe(16);
400
- });
401
-
402
- it("should recompute in cascade when dependency changes", async () => {
403
- const $state = state(1);
404
- const computeFnA = vi.fn((t) => $state.get(t) * 2);
405
- const computeFnB = vi.fn((t) => {
406
- const $a = derivation(computeFnA);
407
- return $a.get(t) * 2;
408
- });
409
- derivation(computeFnA);
410
- const $derivationB = derivation(computeFnB);
411
-
412
- await $derivationB.pick();
413
- expect(computeFnA).toHaveBeenCalled();
414
- expect(computeFnB).toHaveBeenCalled();
415
-
416
- $state.set(2);
417
- await $derivationB.pick();
418
- expect(computeFnA).toHaveBeenCalledTimes(2);
419
- expect(computeFnB).toHaveBeenCalledTimes(2);
420
- });
421
- });
422
-
423
- describe("error handling", () => {
424
- it("should propagate errors in compute function with dependencies", async () => {
425
- const $state = state(1);
426
- const error = new Error("Compute error");
427
- const $derivation = derivation((t) => {
428
- const value = $state.get(t);
429
- if (value > 1) {
430
- throw error;
431
- }
432
- return value;
433
- });
434
-
435
- expect(await $derivation.pick()).toBe(1);
436
-
437
- $state.set(2);
438
- await expect($derivation.pick()).rejects.toThrow("Compute error");
439
- });
440
- });
441
- });
442
-
443
- describe("with effect", () => {
444
- describe("reactive dependencies", () => {
445
- it("should re-execute effect when derivation dependency changes", async () => {
446
- const $state = state(1);
447
- const $derivation = derivation((t) => $state.get(t) * 2);
448
- const onData = vi.fn();
449
-
450
- subscribe((t) => $derivation.get(t), onData);
451
-
452
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
453
-
454
- $state.set(2);
455
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
456
- });
457
-
458
- it("should re-execute effect if derivation value is identical", async () => {
459
- const $state = state(2);
460
- const $derivation = derivation((t) => $state.get(t) * 0);
461
- const onData = vi.fn();
462
-
463
- subscribe((t) => $derivation.get(t), onData);
464
-
465
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
466
-
467
- $state.set(5);
468
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
469
- });
470
-
471
- it("should work with derivation depending on state", async () => {
472
- const $state = state(1);
473
- const $derivation = derivation((t) => $state.get(t) * 2);
474
- const onData = vi.fn();
475
-
476
- subscribe((t) => $derivation.get(t), onData);
477
-
478
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
479
- expect(onData).toHaveBeenLastCalledWith(2);
480
-
481
- $state.set(2);
482
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
483
- expect(onData).toHaveBeenLastCalledWith(4);
484
- });
485
-
486
- it("should work with derivation depending on signal", async () => {
487
- const $signal = signal();
488
- const $state = state(0);
489
- const $derivation = derivation((t) => {
490
- $signal.watch(t);
491
- return $state.get(t);
492
- });
493
- const onData = vi.fn();
494
-
495
- subscribe((t) => $derivation.get(t), onData);
496
-
497
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
498
- expect(onData).toHaveBeenLastCalledWith(0);
499
-
500
- $state.set(1);
501
- $signal.trigger();
502
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
503
- expect(onData).toHaveBeenLastCalledWith(1);
504
- });
505
-
506
- it("should work with derivation depending on another derivation", async () => {
507
- const $state = state(1);
508
- const $derivation1 = derivation((t) => $state.get(t) * 2);
509
- const $derivation2 = derivation((t) => $derivation1.get(t) * 2);
510
- const onData = vi.fn();
511
-
512
- subscribe((t) => $derivation2.get(t), onData);
513
-
514
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
515
- expect(onData).toHaveBeenLastCalledWith(4);
516
-
517
- $state.set(2);
518
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
519
- expect(onData).toHaveBeenLastCalledWith(8);
520
- });
521
- });
522
-
523
- describe("multiple dependencies", () => {
524
- it("should work with derivation depending on multiple states", async () => {
525
- const $stateA = state(5);
526
- const $stateB = state(10);
527
- const $derivation = derivation((t) => $stateA.get(t) + $stateB.get(t));
528
- const onData = vi.fn();
529
-
530
- subscribe((t) => $derivation.get(t), onData);
531
-
532
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
533
- expect(onData).toHaveBeenLastCalledWith(15);
534
-
535
- $stateA.set(6);
536
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
537
- expect(onData).toHaveBeenLastCalledWith(16);
538
-
539
- $stateB.set(11);
540
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
541
- expect(onData).toHaveBeenLastCalledWith(17);
542
- });
543
-
544
- it("should work with derivation depending on multiple signals", async () => {
545
- const $signal1 = signal();
546
- const $signal2 = signal();
547
- const $derivation = derivation((t) => {
548
- $signal1.watch(t);
549
- $signal2.watch(t);
550
- return 42;
551
- });
552
- const onData = vi.fn();
553
-
554
- subscribe((t) => $derivation.watch(t), onData);
555
-
556
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
557
-
558
- $signal1.trigger();
559
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
560
-
561
- $signal2.trigger();
562
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
563
- });
564
-
565
- it("should work with derivation depending on state and signal", async () => {
566
- const $signal = signal();
567
- const $state = state(1);
568
- const $derivation = derivation((t) => {
569
- $signal.watch(t);
570
- return $state.get(t) * 2;
571
- });
572
- const onData = vi.fn();
573
-
574
- subscribe((t) => $derivation.get(t), onData);
575
-
576
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
577
- expect(onData).toHaveBeenLastCalledWith(2);
578
-
579
- $signal.trigger();
580
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
581
- expect(onData).toHaveBeenLastCalledWith(2);
582
-
583
- $state.set(2);
584
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
585
- expect(onData).toHaveBeenLastCalledWith(4);
586
- });
587
-
588
- it("should work with derivation depending on state and another derivation", async () => {
589
- const $state = state(1);
590
- const $derivation1 = derivation((t) => $state.get(t) * 2);
591
- const $derivation2 = derivation((t) => $state.get(t) + $derivation1.get(t));
592
- const onData = vi.fn();
593
-
594
- subscribe((t) => $derivation2.get(t), onData);
595
-
596
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
597
- expect(onData).toHaveBeenLastCalledWith(3);
598
-
599
- $state.set(2);
600
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
601
- expect(onData).toHaveBeenLastCalledWith(6);
602
- });
603
- });
604
-
605
- describe("nested derivations", () => {
606
- it("should work with chained derivations", async () => {
607
- const $state = state(1);
608
- const $derivation1 = derivation((t) => $state.get(t) * 2);
609
- const $derivation2 = derivation((t) => $derivation1.get(t) * 2);
610
- const $derivation3 = derivation((t) => $derivation2.get(t) * 2);
611
- const onData = vi.fn();
612
-
613
- subscribe((t) => $derivation3.get(t), onData);
614
-
615
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
616
- expect(onData).toHaveBeenLastCalledWith(8);
617
-
618
- $state.set(2);
619
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
620
- expect(onData).toHaveBeenLastCalledWith(16);
621
- });
622
-
623
- it("should re-execute effect when distant dependency changes", async () => {
624
- const $state = state(1);
625
- const $derivation1 = derivation((t) => $state.get(t) * 2);
626
- const $derivation2 = derivation((t) => $derivation1.get(t) * 2);
627
- const onData = vi.fn();
628
-
629
- subscribe((t) => $derivation2.get(t), onData);
630
-
631
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
632
- expect(onData).toHaveBeenLastCalledWith(4);
633
-
634
- $state.set(2);
635
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
636
- expect(onData).toHaveBeenLastCalledWith(8);
637
- });
638
-
639
- it("should propagate changes correctly through the chain", async () => {
640
- const $state = state(1);
641
- const $derivation1 = derivation((t) => $state.get(t) * 2);
642
- const $derivation2 = derivation((t) => $derivation1.get(t) * 2);
643
- const onData1 = vi.fn();
644
- const onData2 = vi.fn();
645
-
646
- subscribe((t) => $derivation1.get(t), onData1);
647
- subscribe((t) => $derivation2.get(t), onData2);
648
-
649
- await vi.waitFor(() => {
650
- expect(onData1).toHaveBeenCalledTimes(1);
651
- expect(onData2).toHaveBeenCalledTimes(1);
652
- });
653
-
654
- $state.set(2);
655
- await vi.waitFor(() => {
656
- expect(onData1).toHaveBeenCalledTimes(2);
657
- expect(onData2).toHaveBeenCalledTimes(2);
658
- });
659
- });
660
- });
661
-
662
- describe("dynamic dependencies", () => {
663
- it("should work with derivation with conditional dependencies", async () => {
664
- const $state1 = state(1);
665
- const $state2 = state(10);
666
- const $cond = state(true);
667
- const $derivation = derivation((t) => {
668
- if ($cond.get(t)) {
669
- return $state1.get(t) * 2;
670
- }
671
- return $state2.get(t) * 2;
672
- });
673
- const onData = vi.fn();
674
-
675
- subscribe((t) => $derivation.get(t), onData);
676
-
677
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
678
- expect(onData).toHaveBeenLastCalledWith(2);
679
-
680
- $state1.set(2);
681
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
682
- expect(onData).toHaveBeenLastCalledWith(4);
683
-
684
- $cond.set(false);
685
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
686
- expect(onData).toHaveBeenLastCalledWith(20);
687
-
688
- $state2.set(20);
689
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
690
- expect(onData).toHaveBeenLastCalledWith(40);
691
- });
692
-
693
- it("should re-execute effect when dependencies change dynamically", async () => {
694
- const $state1 = state(1);
695
- const $state2 = state(2);
696
- const $useState1 = state(true);
697
- const $derivation = derivation((t) => {
698
- if ($useState1.get(t)) {
699
- return $state1.get(t);
700
- }
701
- return $state2.get(t);
702
- });
703
- const onData = vi.fn();
704
-
705
- subscribe((t) => $derivation.get(t), onData);
706
-
707
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
708
- expect(onData).toHaveBeenLastCalledWith(1);
709
-
710
- $useState1.set(false);
711
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
712
- expect(onData).toHaveBeenLastCalledWith(2);
713
-
714
- $state1.set(10);
715
- await new Promise((resolve) => setTimeout(resolve, 50));
716
- expect(onData).toHaveBeenCalledTimes(2);
717
-
718
- $state2.set(20);
719
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
720
- expect(onData).toHaveBeenLastCalledWith(20);
721
- });
722
-
723
- it("should unregister old dependencies correctly", async () => {
724
- const $state1 = state(1);
725
- const $state2 = state(10);
726
- const $cond = state(true);
727
- const $derivation = derivation((t) => {
728
- if ($cond.get(t)) {
729
- return $state1.get(t);
730
- }
731
- return $state2.get(t);
732
- });
733
- const onData = vi.fn();
734
-
735
- subscribe((t) => $derivation.get(t), onData);
736
-
737
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
738
-
739
- $cond.set(false);
740
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
741
-
742
- $state1.set(100);
743
- await new Promise((resolve) => setTimeout(resolve, 50));
744
- expect(onData).toHaveBeenCalledTimes(2);
745
- });
746
- });
747
-
748
- describe("complex patterns", () => {
749
- it("should handle diamond pattern", async () => {
750
- const $stateA = state(1);
751
- const $aMult3 = derivation((t) => $stateA.get(t) * 3);
752
- const $aMult2 = derivation((t) => $stateA.get(t) * 2);
753
- const $addAmult3Amult2 = derivation((t) => $aMult3.get(t) + $aMult2.get(t));
754
- const onData = vi.fn();
755
-
756
- subscribe((t) => $addAmult3Amult2.get(t), onData);
757
-
758
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
759
- expect(onData).toHaveBeenLastCalledWith(5);
760
-
761
- $stateA.set(2);
762
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
763
- expect(onData).toHaveBeenLastCalledWith(10);
764
-
765
- $stateA.set(3);
766
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
767
- expect(onData).toHaveBeenLastCalledWith(15);
768
- });
769
-
770
- it("should handle multi-diamond pattern", async () => {
771
- const $stateA = state(1);
772
- const $stateB = state(2);
773
- const $addAB = derivation((t) => {
774
- const a = $stateA.get(t);
775
- const b = $stateB.get(t);
776
- return a + b;
777
- });
778
- const $multiplyAB = derivation((t) => {
779
- const a = $stateA.get(t);
780
- const b = $stateB.get(t);
781
- return a * b;
782
- });
783
- const $addAndMultiply = derivation((t) => {
784
- const add = $addAB.get(t);
785
- const multiply = $multiplyAB.get(t);
786
- return add * multiply;
787
- });
788
- const onData = vi.fn();
789
-
790
- subscribe((t) => $addAndMultiply.get(t), onData);
791
-
792
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
793
- expect(onData).toHaveBeenLastCalledWith(6);
794
-
795
- $stateA.set(2);
796
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
797
- expect(onData).toHaveBeenLastCalledWith(16);
798
-
799
- $stateB.set(3);
800
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
801
- expect(onData).toHaveBeenLastCalledWith(30);
802
- });
803
- });
804
-
805
- describe("with refresh", () => {
806
- it("should re-execute effect when refresh forces recomputation", async () => {
807
- let multiplier = 2;
808
- const $state = state(5);
809
- const $derivation = derivation((t) => $state.get(t) * multiplier);
810
- const onData = vi.fn();
811
-
812
- subscribe((t) => $derivation.get(t), onData);
813
-
814
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
815
- expect(onData).toHaveBeenLastCalledWith(10);
816
-
817
- multiplier = 3;
818
- $derivation.refresh();
819
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
820
- expect(onData).toHaveBeenLastCalledWith(15);
821
- });
822
-
823
- it("should not re-execute effect if refresh returns same value", async () => {
824
- const $state = state(1);
825
- const computeFn = vi.fn((t) => $state.get(t) * 2);
826
- const $derivation = derivation(computeFn);
827
- const onData = vi.fn();
828
-
829
- subscribe((t) => $derivation.get(t), onData);
830
-
831
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
832
- expect(computeFn).toHaveBeenCalledTimes(1);
833
-
834
- $derivation.refresh();
835
- await new Promise((resolve) => setTimeout(resolve, 50));
836
- expect(onData).toHaveBeenCalledTimes(1);
837
- expect(computeFn).toHaveBeenCalledTimes(2);
838
- });
839
-
840
- it("should force recomputation even if dependencies have not changed", async () => {
841
- const $state = state(1);
842
- const computeFn = vi.fn((t) => $state.get(t) * 2);
843
- const $derivation = derivation(computeFn);
844
- const onData = vi.fn();
845
-
846
- subscribe((t) => $derivation.get(t), onData);
847
-
848
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
849
- expect(computeFn).toHaveBeenCalledTimes(1);
850
-
851
- $derivation.refresh();
852
- await new Promise((resolve) => setTimeout(resolve, 50));
853
- expect(computeFn).toHaveBeenCalledTimes(2);
854
- });
855
- });
856
-
857
- describe("error handling", () => {
858
- it("should propagate errors in compute function with dependencies in effect", async () => {
859
- const $state = state(1);
860
- const error = new Error("Effect compute error");
861
- const $derivation = derivation((t) => {
862
- const value = $state.get(t);
863
- if (value > 1) {
864
- throw error;
865
- }
866
- return value;
867
- });
868
-
869
- const onData = vi.fn();
870
- const onError = vi.fn();
871
- subscribe((t) => $derivation.get(t), onData, onError);
872
-
873
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
874
-
875
- $state.set(2);
876
- await vi.waitFor(() => expect(onError).toHaveBeenCalledTimes(1));
877
- expect(onError).toHaveBeenLastCalledWith(error);
878
- });
879
-
880
- it("should handle errors when dependency is disposed during computation", async () => {
881
- const $state = state(1);
882
- const $derivation = derivation((t) => $state.get(t) * 2);
883
- const onData = vi.fn();
884
-
885
- subscribe((t) => $derivation.get(t), onData);
886
-
887
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
888
-
889
- $state.dispose();
890
-
891
- await new Promise((resolve) => setTimeout(resolve, 50));
892
- expect(onData).toHaveBeenCalledTimes(1);
893
- });
894
- });
895
- });
896
- });