@ersbeth/picoflow 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/.cursor/plans/unifier-flowresource-avec-flowderivation-c9506e24.plan.md +372 -0
  2. package/README.md +25 -171
  3. package/biome.json +4 -1
  4. package/dist/picoflow.js +1129 -661
  5. package/dist/types/flow/base/flowDisposable.d.ts +67 -0
  6. package/dist/types/flow/base/flowDisposable.d.ts.map +1 -0
  7. package/dist/types/flow/base/flowEffect.d.ts +127 -0
  8. package/dist/types/flow/base/flowEffect.d.ts.map +1 -0
  9. package/dist/types/flow/base/flowGraph.d.ts +97 -0
  10. package/dist/types/flow/base/flowGraph.d.ts.map +1 -0
  11. package/dist/types/flow/base/flowSignal.d.ts +134 -0
  12. package/dist/types/flow/base/flowSignal.d.ts.map +1 -0
  13. package/dist/types/flow/base/flowTracker.d.ts +15 -0
  14. package/dist/types/flow/base/flowTracker.d.ts.map +1 -0
  15. package/dist/types/flow/base/index.d.ts +7 -0
  16. package/dist/types/flow/base/index.d.ts.map +1 -0
  17. package/dist/types/flow/base/utils.d.ts +20 -0
  18. package/dist/types/flow/base/utils.d.ts.map +1 -0
  19. package/dist/types/{advanced/array.d.ts → flow/collections/flowArray.d.ts} +50 -12
  20. package/dist/types/flow/collections/flowArray.d.ts.map +1 -0
  21. package/dist/types/flow/collections/flowMap.d.ts +224 -0
  22. package/dist/types/flow/collections/flowMap.d.ts.map +1 -0
  23. package/dist/types/flow/collections/index.d.ts +3 -0
  24. package/dist/types/flow/collections/index.d.ts.map +1 -0
  25. package/dist/types/flow/index.d.ts +4 -0
  26. package/dist/types/flow/index.d.ts.map +1 -0
  27. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts +137 -0
  28. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts.map +1 -0
  29. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts +137 -0
  30. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts.map +1 -0
  31. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts +343 -0
  32. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts.map +1 -0
  33. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts +81 -0
  34. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts.map +1 -0
  35. package/dist/types/flow/nodes/async/flowStateAsync.d.ts +111 -0
  36. package/dist/types/flow/nodes/async/flowStateAsync.d.ts.map +1 -0
  37. package/dist/types/flow/nodes/async/index.d.ts +6 -0
  38. package/dist/types/flow/nodes/async/index.d.ts.map +1 -0
  39. package/dist/types/flow/nodes/index.d.ts +3 -0
  40. package/dist/types/flow/nodes/index.d.ts.map +1 -0
  41. package/dist/types/flow/nodes/sync/flowConstant.d.ts +108 -0
  42. package/dist/types/flow/nodes/sync/flowConstant.d.ts.map +1 -0
  43. package/dist/types/flow/nodes/sync/flowDerivation.d.ts +100 -0
  44. package/dist/types/flow/nodes/sync/flowDerivation.d.ts.map +1 -0
  45. package/dist/types/flow/nodes/sync/flowNode.d.ts +314 -0
  46. package/dist/types/flow/nodes/sync/flowNode.d.ts.map +1 -0
  47. package/dist/types/flow/nodes/sync/flowReadonly.d.ts +57 -0
  48. package/dist/types/flow/nodes/sync/flowReadonly.d.ts.map +1 -0
  49. package/dist/types/flow/nodes/sync/flowState.d.ts +96 -0
  50. package/dist/types/flow/nodes/sync/flowState.d.ts.map +1 -0
  51. package/dist/types/flow/nodes/sync/index.d.ts +6 -0
  52. package/dist/types/flow/nodes/sync/index.d.ts.map +1 -0
  53. package/dist/types/index.d.ts +1 -4
  54. package/dist/types/index.d.ts.map +1 -1
  55. package/dist/types/solid/converters.d.ts +34 -44
  56. package/dist/types/solid/converters.d.ts.map +1 -1
  57. package/dist/types/solid/primitives.d.ts +1 -0
  58. package/dist/types/solid/primitives.d.ts.map +1 -1
  59. package/docs/.vitepress/config.mts +1 -1
  60. package/docs/api/typedoc-sidebar.json +81 -1
  61. package/package.json +60 -58
  62. package/src/flow/base/flowDisposable.ts +71 -0
  63. package/src/flow/base/flowEffect.ts +171 -0
  64. package/src/flow/base/flowGraph.ts +288 -0
  65. package/src/flow/base/flowSignal.ts +207 -0
  66. package/src/flow/base/flowTracker.ts +17 -0
  67. package/src/flow/base/index.ts +6 -0
  68. package/src/flow/base/utils.ts +19 -0
  69. package/src/flow/collections/flowArray.ts +409 -0
  70. package/src/flow/collections/flowMap.ts +398 -0
  71. package/src/flow/collections/index.ts +2 -0
  72. package/src/flow/index.ts +3 -0
  73. package/src/flow/nodes/async/flowConstantAsync.ts +142 -0
  74. package/src/flow/nodes/async/flowDerivationAsync.ts +143 -0
  75. package/src/flow/nodes/async/flowNodeAsync.ts +474 -0
  76. package/src/flow/nodes/async/flowReadonlyAsync.ts +81 -0
  77. package/src/flow/nodes/async/flowStateAsync.ts +116 -0
  78. package/src/flow/nodes/async/index.ts +5 -0
  79. package/src/flow/nodes/await/advanced/index.ts +5 -0
  80. package/src/{advanced → flow/nodes/await/advanced}/resource.ts +37 -3
  81. package/src/{advanced → flow/nodes/await/advanced}/resourceAsync.ts +35 -3
  82. package/src/{advanced → flow/nodes/await/advanced}/stream.ts +40 -2
  83. package/src/{advanced → flow/nodes/await/advanced}/streamAsync.ts +38 -3
  84. package/src/flow/nodes/await/flowConstantAwait.ts +154 -0
  85. package/src/flow/nodes/await/flowDerivationAwait.ts +154 -0
  86. package/src/flow/nodes/await/flowNodeAwait.ts +508 -0
  87. package/src/flow/nodes/await/flowReadonlyAwait.ts +89 -0
  88. package/src/flow/nodes/await/flowStateAwait.ts +130 -0
  89. package/src/flow/nodes/await/index.ts +5 -0
  90. package/src/flow/nodes/index.ts +3 -0
  91. package/src/flow/nodes/sync/flowConstant.ts +111 -0
  92. package/src/flow/nodes/sync/flowDerivation.ts +105 -0
  93. package/src/flow/nodes/sync/flowNode.ts +439 -0
  94. package/src/flow/nodes/sync/flowReadonly.ts +57 -0
  95. package/src/flow/nodes/sync/flowState.ts +101 -0
  96. package/src/flow/nodes/sync/index.ts +5 -0
  97. package/src/index.ts +1 -47
  98. package/src/solid/converters.ts +59 -198
  99. package/src/solid/primitives.ts +4 -0
  100. package/test/base/flowEffect.test.ts +108 -0
  101. package/test/base/flowGraph.test.ts +485 -0
  102. package/test/base/flowSignal.test.ts +372 -0
  103. package/test/collections/flowArray.asyncStates.test.ts +1553 -0
  104. package/test/collections/flowArray.scalars.test.ts +1129 -0
  105. package/test/collections/flowArray.states.test.ts +1365 -0
  106. package/test/collections/flowMap.asyncStates.test.ts +1105 -0
  107. package/test/collections/flowMap.scalars.test.ts +877 -0
  108. package/test/collections/flowMap.states.test.ts +1097 -0
  109. package/test/nodes/async/flowConstantAsync.test.ts +860 -0
  110. package/test/nodes/async/flowDerivationAsync.test.ts +1517 -0
  111. package/test/nodes/async/flowStateAsync.test.ts +1387 -0
  112. package/test/{resource.test.ts → nodes/await/advanced/resource.test.ts} +21 -19
  113. package/test/{resourceAsync.test.ts → nodes/await/advanced/resourceAsync.test.ts} +3 -1
  114. package/test/{stream.test.ts → nodes/await/advanced/stream.test.ts} +30 -28
  115. package/test/{streamAsync.test.ts → nodes/await/advanced/streamAsync.test.ts} +16 -14
  116. package/test/nodes/await/flowConstantAwait.test.ts +643 -0
  117. package/test/nodes/await/flowDerivationAwait.test.ts +1583 -0
  118. package/test/nodes/await/flowStateAwait.test.ts +999 -0
  119. package/test/nodes/mixed/derivation.test.ts +1527 -0
  120. package/test/nodes/sync/flowConstant.test.ts +620 -0
  121. package/test/nodes/sync/flowDerivation.test.ts +1373 -0
  122. package/test/nodes/sync/flowState.test.ts +945 -0
  123. package/test/solid/converters.test.ts +721 -0
  124. package/test/solid/primitives.test.ts +1031 -0
  125. package/tsconfig.json +2 -1
  126. package/vitest.config.ts +7 -1
  127. package/IMPLEMENTATION_GUIDE.md +0 -1578
  128. package/dist/types/advanced/array.d.ts.map +0 -1
  129. package/dist/types/advanced/index.d.ts +0 -9
  130. package/dist/types/advanced/index.d.ts.map +0 -1
  131. package/dist/types/advanced/map.d.ts +0 -166
  132. package/dist/types/advanced/map.d.ts.map +0 -1
  133. package/dist/types/advanced/resource.d.ts +0 -78
  134. package/dist/types/advanced/resource.d.ts.map +0 -1
  135. package/dist/types/advanced/resourceAsync.d.ts +0 -56
  136. package/dist/types/advanced/resourceAsync.d.ts.map +0 -1
  137. package/dist/types/advanced/stream.d.ts +0 -117
  138. package/dist/types/advanced/stream.d.ts.map +0 -1
  139. package/dist/types/advanced/streamAsync.d.ts +0 -97
  140. package/dist/types/advanced/streamAsync.d.ts.map +0 -1
  141. package/dist/types/basic/constant.d.ts +0 -60
  142. package/dist/types/basic/constant.d.ts.map +0 -1
  143. package/dist/types/basic/derivation.d.ts +0 -89
  144. package/dist/types/basic/derivation.d.ts.map +0 -1
  145. package/dist/types/basic/disposable.d.ts +0 -82
  146. package/dist/types/basic/disposable.d.ts.map +0 -1
  147. package/dist/types/basic/effect.d.ts +0 -67
  148. package/dist/types/basic/effect.d.ts.map +0 -1
  149. package/dist/types/basic/index.d.ts +0 -10
  150. package/dist/types/basic/index.d.ts.map +0 -1
  151. package/dist/types/basic/observable.d.ts +0 -83
  152. package/dist/types/basic/observable.d.ts.map +0 -1
  153. package/dist/types/basic/signal.d.ts +0 -69
  154. package/dist/types/basic/signal.d.ts.map +0 -1
  155. package/dist/types/basic/state.d.ts +0 -47
  156. package/dist/types/basic/state.d.ts.map +0 -1
  157. package/dist/types/basic/trackingContext.d.ts +0 -33
  158. package/dist/types/basic/trackingContext.d.ts.map +0 -1
  159. package/dist/types/creators.d.ts +0 -340
  160. package/dist/types/creators.d.ts.map +0 -1
  161. package/src/advanced/array.ts +0 -222
  162. package/src/advanced/index.ts +0 -12
  163. package/src/advanced/map.ts +0 -193
  164. package/src/basic/constant.ts +0 -97
  165. package/src/basic/derivation.ts +0 -147
  166. package/src/basic/disposable.ts +0 -86
  167. package/src/basic/effect.ts +0 -104
  168. package/src/basic/index.ts +0 -9
  169. package/src/basic/observable.ts +0 -109
  170. package/src/basic/signal.ts +0 -145
  171. package/src/basic/state.ts +0 -60
  172. package/src/basic/trackingContext.ts +0 -45
  173. package/src/creators.ts +0 -395
  174. package/test/array.test.ts +0 -600
  175. package/test/constant.test.ts +0 -44
  176. package/test/derivation.test.ts +0 -539
  177. package/test/effect.test.ts +0 -29
  178. package/test/map.test.ts +0 -240
  179. package/test/signal.test.ts +0 -72
  180. package/test/state.test.ts +0 -212
@@ -0,0 +1,1031 @@
1
+ import { createEffect, createMemo, createRoot, createSignal } from "solid-js";
2
+ import { describe, expect, it, vi } from "vitest";
3
+ import {
4
+ SolidDerivation,
5
+ SolidResource,
6
+ SolidState,
7
+ } from "../../src/solid/primitives";
8
+
9
+ describe("solidPrimitives", () => {
10
+ describe("SolidState", () => {
11
+ describe("unit", () => {
12
+ describe("initialization", () => {
13
+ it("should initialize with direct value", () => {
14
+ const state = new SolidState(42);
15
+ expect(state.get()).toBe(42);
16
+ });
17
+
18
+ it("should create instance with initial value", () => {
19
+ const state = new SolidState("hello");
20
+ expect(state).toBeInstanceOf(SolidState);
21
+ expect(state.get()).toBe("hello");
22
+ });
23
+
24
+ it("should handle number values", () => {
25
+ const state = new SolidState(42);
26
+ expect(state.get()).toBe(42);
27
+ });
28
+
29
+ it("should handle string values", () => {
30
+ const state = new SolidState("hello");
31
+ expect(state.get()).toBe("hello");
32
+ });
33
+
34
+ it("should handle object values", () => {
35
+ const obj = { a: 1, b: 2 };
36
+ const state = new SolidState(obj);
37
+ expect(state.get()).toBe(obj);
38
+ expect(state.get()).toEqual({ a: 1, b: 2 });
39
+ });
40
+
41
+ it("should handle array values", () => {
42
+ const arr = [1, 2, 3];
43
+ const state = new SolidState(arr);
44
+ expect(state.get()).toBe(arr);
45
+ expect(state.get()).toEqual([1, 2, 3]);
46
+ });
47
+
48
+ it("should handle null values", () => {
49
+ const state = new SolidState(null);
50
+ expect(state.get()).toBeNull();
51
+ });
52
+
53
+ it("should handle undefined values", () => {
54
+ const state = new SolidState(undefined);
55
+ expect(state.get()).toBeUndefined();
56
+ });
57
+ });
58
+
59
+ describe("get", () => {
60
+ it("should return initial value", () => {
61
+ const state = new SolidState(5);
62
+ expect(state.get()).toBe(5);
63
+ });
64
+
65
+ it("should return updated value after set", () => {
66
+ const state = new SolidState(5);
67
+ state.set(10);
68
+ expect(state.get()).toBe(10);
69
+ });
70
+
71
+ it("should be reactive within createRoot", async () => {
72
+ await createRoot(async (dispose) => {
73
+ const state = new SolidState(0);
74
+ const fn = vi.fn();
75
+
76
+ createEffect(() => {
77
+ fn(state.get());
78
+ });
79
+
80
+ await vi.waitFor(() => expect(fn).toHaveBeenCalledTimes(1));
81
+ expect(fn).toHaveBeenLastCalledWith(0);
82
+ expect(state.get()).toBe(0);
83
+
84
+ state.set(1);
85
+ await vi.waitFor(() => expect(fn).toHaveBeenCalledTimes(2));
86
+ expect(fn).toHaveBeenLastCalledWith(1);
87
+ expect(state.get()).toBe(1);
88
+
89
+ state.set(2);
90
+ await vi.waitFor(() => expect(fn).toHaveBeenCalledTimes(3));
91
+ expect(fn).toHaveBeenLastCalledWith(2);
92
+ expect(state.get()).toBe(2);
93
+
94
+ dispose();
95
+ });
96
+ });
97
+ });
98
+
99
+ describe("set", () => {
100
+ it("should update value with direct value", () => {
101
+ const state = new SolidState(1);
102
+ expect(state.get()).toBe(1);
103
+
104
+ state.set(2);
105
+ expect(state.get()).toBe(2);
106
+ });
107
+
108
+ it("should update value with updater function", () => {
109
+ const state = new SolidState(1);
110
+ expect(state.get()).toBe(1);
111
+
112
+ state.set((prev) => prev + 1);
113
+ expect(state.get()).toBe(2);
114
+
115
+ state.set((prev) => prev * 2);
116
+ expect(state.get()).toBe(4);
117
+ });
118
+
119
+ it("should handle number values", () => {
120
+ const state = new SolidState(0);
121
+ state.set(42);
122
+ expect(state.get()).toBe(42);
123
+ });
124
+
125
+ it("should handle string values", () => {
126
+ const state = new SolidState("hello");
127
+ state.set("world");
128
+ expect(state.get()).toBe("world");
129
+ });
130
+
131
+ it("should handle object values", () => {
132
+ const state = new SolidState({ a: 1 });
133
+ // @ts-expect-error - we want to test the behavior of the state
134
+ state.set({ a: 2, b: 3 });
135
+ expect(state.get()).toEqual({ a: 2, b: 3 });
136
+ });
137
+
138
+ it("should handle array values", () => {
139
+ const state = new SolidState([1, 2]);
140
+ state.set([3, 4, 5]);
141
+ expect(state.get()).toEqual([3, 4, 5]);
142
+ });
143
+
144
+ it("should handle null values", () => {
145
+ const state = new SolidState(1);
146
+ // @ts-expect-error - we want to test the behavior of the state
147
+ state.set(null);
148
+ expect(state.get()).toBeNull();
149
+ });
150
+
151
+ it("should handle undefined values", () => {
152
+ const state = new SolidState(1);
153
+ // @ts-expect-error - we want to test the behavior of the state
154
+ state.set(undefined);
155
+ expect(state.get()).toBeUndefined();
156
+ });
157
+ });
158
+ });
159
+ });
160
+
161
+ describe("SolidDerivation", () => {
162
+ describe("unit", () => {
163
+ describe("initialization", () => {
164
+ it("should initialize with getter function", () => {
165
+ const derivation = new SolidDerivation(() => 42);
166
+ expect(derivation).toBeInstanceOf(SolidDerivation);
167
+ });
168
+
169
+ it("should initialize with direct value", () => {
170
+ createRoot(() => {
171
+ const derivation = new SolidDerivation(() => 42);
172
+ expect(derivation.get()).toBe(42);
173
+ });
174
+ });
175
+
176
+ it("should compute lazily on first access", () => {
177
+ createRoot(() => {
178
+ const computeFn = vi.fn(() => {
179
+ return 42;
180
+ });
181
+ const derivation = new SolidDerivation(computeFn);
182
+ // createMemo may call immediately, but we verify it works
183
+ const value = derivation.get();
184
+ expect(value).toBe(42);
185
+ expect(computeFn).toHaveBeenCalled();
186
+ });
187
+ });
188
+ });
189
+
190
+ describe("get", () => {
191
+ it("should return computed value", () => {
192
+ createRoot(() => {
193
+ const state = new SolidState(5);
194
+ const derivation = new SolidDerivation(() => state.get() * 2);
195
+ expect(derivation.get()).toBe(10);
196
+ });
197
+ });
198
+
199
+ it("should track dependencies reactively", async () => {
200
+ await createRoot(async (dispose) => {
201
+ const state = new SolidState(5);
202
+ const derivation = new SolidDerivation(() => state.get() * 2);
203
+ expect(derivation.get()).toBe(10);
204
+
205
+ state.set(6);
206
+ await vi.waitFor(() => expect(derivation.get()).toBe(12));
207
+
208
+ dispose();
209
+ });
210
+ });
211
+
212
+ function tick(): Promise<undefined> {
213
+ return new Promise((resolve) => {
214
+ queueMicrotask(resolve as VoidFunction);
215
+ });
216
+ }
217
+
218
+ it("memo", async () => {
219
+ await createRoot(async () => {
220
+ const [signal, setSignal] = createSignal(false);
221
+ const memo = createMemo(() => signal());
222
+ expect(memo()).eq(false);
223
+ setSignal(true);
224
+ await tick();
225
+ expect(memo()).eq(true);
226
+ });
227
+ });
228
+
229
+ it("should recompute when dependency changes", () => {
230
+ return new Promise<void>((resolve) => {
231
+ createRoot(() => {
232
+ const state = new SolidState(1);
233
+ const derivation = new SolidDerivation(() => state.get() * 2);
234
+
235
+ expect(derivation.get()).toBe(2);
236
+
237
+ state.set(2);
238
+ queueMicrotask(() => {
239
+ expect(derivation.get()).toBe(4);
240
+
241
+ state.set(3);
242
+ queueMicrotask(() => {
243
+ expect(derivation.get()).toBe(6);
244
+ resolve();
245
+ });
246
+ });
247
+ });
248
+ });
249
+ });
250
+
251
+ it("should memoize computed value", () => {
252
+ return new Promise<void>((resolve) => {
253
+ let computeCount = 0;
254
+
255
+ createRoot(() => {
256
+ const state = new SolidState(5);
257
+ const derivation = new SolidDerivation(() => {
258
+ computeCount++;
259
+ return state.get() * 2;
260
+ });
261
+
262
+ // First access
263
+ expect(derivation.get()).toBe(10);
264
+ expect(computeCount).toBe(1);
265
+
266
+ // Second access without change
267
+ expect(derivation.get()).toBe(10);
268
+ expect(computeCount).toBe(1); // Should not recompute
269
+
270
+ // Change dependency
271
+ state.set(6);
272
+ queueMicrotask(() => {
273
+ expect(derivation.get()).toBe(12);
274
+ expect(computeCount).toBe(2);
275
+ resolve();
276
+ });
277
+ });
278
+ });
279
+ });
280
+
281
+ it("should handle multiple dependencies", () => {
282
+ return new Promise<void>((resolve) => {
283
+ createRoot(() => {
284
+ const firstName = new SolidState("John");
285
+ const lastName = new SolidState("Doe");
286
+ const fullName = new SolidDerivation(
287
+ () => `${firstName.get()} ${lastName.get()}`,
288
+ );
289
+
290
+ expect(fullName.get()).toBe("John Doe");
291
+
292
+ firstName.set("Jane");
293
+ queueMicrotask(() => {
294
+ expect(fullName.get()).toBe("Jane Doe");
295
+
296
+ lastName.set("Smith");
297
+ queueMicrotask(() => {
298
+ expect(fullName.get()).toBe("Jane Smith");
299
+ resolve();
300
+ });
301
+ });
302
+ });
303
+ });
304
+ });
305
+
306
+ it("should handle nested derivations", () => {
307
+ return new Promise<void>((resolve) => {
308
+ createRoot(() => {
309
+ const base = new SolidState(2);
310
+ const doubled = new SolidDerivation(() => base.get() * 2);
311
+ const quadrupled = new SolidDerivation(() => doubled.get() * 2);
312
+
313
+ expect(quadrupled.get()).toBe(8);
314
+
315
+ base.set(3);
316
+ queueMicrotask(() => {
317
+ expect(quadrupled.get()).toBe(12);
318
+ resolve();
319
+ });
320
+ });
321
+ });
322
+ });
323
+
324
+ it("should handle number return values", () => {
325
+ createRoot(() => {
326
+ const state = new SolidState(5);
327
+ const derivation = new SolidDerivation(() => state.get() * 2);
328
+ expect(derivation.get()).toBe(10);
329
+ });
330
+ });
331
+
332
+ it("should handle string return values", () => {
333
+ createRoot(() => {
334
+ const state = new SolidState("hello");
335
+ const derivation = new SolidDerivation(() =>
336
+ state.get().toUpperCase(),
337
+ );
338
+ expect(derivation.get()).toBe("HELLO");
339
+ });
340
+ });
341
+
342
+ it("should handle object return values", () => {
343
+ createRoot(() => {
344
+ const state = new SolidState({ a: 1 });
345
+ const derivation = new SolidDerivation(() => ({
346
+ ...state.get(),
347
+ b: 2,
348
+ }));
349
+ expect(derivation.get()).toEqual({ a: 1, b: 2 });
350
+ });
351
+ });
352
+
353
+ it("should handle array return values", () => {
354
+ createRoot(() => {
355
+ const state = new SolidState([1, 2]);
356
+ const derivation = new SolidDerivation(() => [...state.get(), 3]);
357
+ expect(derivation.get()).toEqual([1, 2, 3]);
358
+ });
359
+ });
360
+
361
+ it("should handle null return values", () => {
362
+ createRoot(() => {
363
+ const state = new SolidState(true);
364
+ const derivation = new SolidDerivation(() =>
365
+ state.get() ? null : "not null",
366
+ );
367
+ expect(derivation.get()).toBeNull();
368
+ });
369
+ });
370
+
371
+ it("should handle undefined return values", () => {
372
+ createRoot(() => {
373
+ const state = new SolidState(true);
374
+ const derivation = new SolidDerivation(() =>
375
+ state.get() ? undefined : "defined",
376
+ );
377
+ expect(derivation.get()).toBeUndefined();
378
+ });
379
+ });
380
+ });
381
+ });
382
+ });
383
+
384
+ describe("SolidResource", () => {
385
+ describe("unit", () => {
386
+ describe("initialization", () => {
387
+ it("should initialize with fetcher function", () => {
388
+ createRoot(() => {
389
+ const fetcher = vi.fn(async () => 42);
390
+ const resource = new SolidResource(fetcher);
391
+ expect(resource).toBeInstanceOf(SolidResource);
392
+ });
393
+ });
394
+
395
+ it("should start in unresolved state", () => {
396
+ createRoot(() => {
397
+ const fetcher = vi.fn(async () => 42);
398
+ const resource = new SolidResource(fetcher);
399
+ expect(resource.state()).toBe("pending");
400
+ });
401
+ });
402
+ });
403
+
404
+ describe("get", () => {
405
+ it("should return undefined initially", () => {
406
+ const fetcher = vi.fn(async () => 42);
407
+ const resource = new SolidResource(fetcher);
408
+
409
+ createRoot(() => {
410
+ expect(resource.get()).toBeUndefined();
411
+ });
412
+ });
413
+
414
+ it("should return value after fetch completes", async () => {
415
+ const fetcher = vi.fn(async () => 42);
416
+ let value: number | undefined;
417
+
418
+ await createRoot(async (dispose) => {
419
+ const resource = new SolidResource(fetcher);
420
+
421
+ // Wait for resource to load
422
+ await new Promise((resolve) => {
423
+ createEffect(() => {
424
+ if (resource.state() === "ready") {
425
+ value = resource.get();
426
+ resolve(undefined);
427
+ }
428
+ });
429
+ });
430
+
431
+ dispose();
432
+ });
433
+
434
+ expect(value).toBe(42);
435
+ });
436
+
437
+ it("should be reactive within createRoot", async () => {
438
+ let effectCount = 0;
439
+
440
+ await createRoot(async (dispose) => {
441
+ let counter = 0;
442
+ const fetcher = vi.fn(async () => {
443
+ counter++;
444
+ return counter;
445
+ });
446
+
447
+ const resource = new SolidResource(fetcher);
448
+
449
+ createEffect(() => {
450
+ effectCount++;
451
+ resource.get();
452
+ });
453
+
454
+ // Wait for initial load
455
+ await new Promise((resolve) => {
456
+ const check = () => {
457
+ if (resource.state() === "ready") {
458
+ resolve(undefined);
459
+ } else {
460
+ setTimeout(check, 10);
461
+ }
462
+ };
463
+ check();
464
+ });
465
+
466
+ expect(effectCount).toBeGreaterThan(0);
467
+
468
+ // Trigger refetch
469
+ resource.refetch();
470
+
471
+ // Wait for refetch
472
+ await new Promise((resolve) => {
473
+ const check = () => {
474
+ if (resource.state() === "ready") {
475
+ resolve(undefined);
476
+ } else {
477
+ setTimeout(check, 10);
478
+ }
479
+ };
480
+ check();
481
+ });
482
+
483
+ dispose();
484
+ });
485
+
486
+ expect(effectCount).toBeGreaterThan(1);
487
+ });
488
+ });
489
+
490
+ describe("state", () => {
491
+ it("should return 'unresolved' initially", () => {
492
+ const fetcher = vi.fn(async () => 42);
493
+ const resource = new SolidResource(fetcher);
494
+
495
+ createRoot(() => {
496
+ expect(resource.state()).toBe("pending");
497
+ });
498
+ });
499
+
500
+ it("should return 'pending' during fetch", async () => {
501
+ let stateDuringFetch: string | undefined;
502
+
503
+ await createRoot(async (dispose) => {
504
+ const fetcher = vi.fn(async () => {
505
+ await new Promise((resolve) => setTimeout(resolve, 50));
506
+ return 42;
507
+ });
508
+
509
+ const resource = new SolidResource(fetcher);
510
+
511
+ // Access get() to trigger fetch
512
+ resource.get();
513
+
514
+ // Check state immediately
515
+ stateDuringFetch = resource.state();
516
+
517
+ // Wait for completion
518
+ await new Promise((resolve) => {
519
+ const check = () => {
520
+ if (resource.state() === "ready") {
521
+ resolve(undefined);
522
+ } else {
523
+ setTimeout(check, 10);
524
+ }
525
+ };
526
+ check();
527
+ });
528
+
529
+ dispose();
530
+ });
531
+
532
+ expect(stateDuringFetch).toBe("pending");
533
+ });
534
+
535
+ it("should return 'ready' after successful fetch", async () => {
536
+ await createRoot(async (dispose) => {
537
+ const fetcher = vi.fn(async () => 42);
538
+ const resource = new SolidResource(fetcher);
539
+
540
+ // Access get() to trigger fetch
541
+ resource.get();
542
+
543
+ // Wait for completion
544
+ await new Promise((resolve) => {
545
+ const check = () => {
546
+ if (resource.state() === "ready") {
547
+ resolve(undefined);
548
+ } else {
549
+ setTimeout(check, 10);
550
+ }
551
+ };
552
+ check();
553
+ });
554
+
555
+ expect(resource.state()).toBe("ready");
556
+ dispose();
557
+ });
558
+ });
559
+
560
+ it("should return 'errored' after failed fetch", async () => {
561
+ await createRoot(async (dispose) => {
562
+ const fetcher = vi.fn(async () => {
563
+ throw new Error("Fetch failed");
564
+ });
565
+
566
+ const resource = new SolidResource(fetcher);
567
+
568
+ // Access get() to trigger fetch
569
+ resource.get();
570
+
571
+ // Wait for error
572
+ await new Promise((resolve) => {
573
+ const check = () => {
574
+ if (resource.state() === "errored") {
575
+ resolve(undefined);
576
+ } else {
577
+ setTimeout(check, 10);
578
+ }
579
+ };
580
+ check();
581
+ });
582
+
583
+ expect(resource.state()).toBe("errored");
584
+ dispose();
585
+ });
586
+ });
587
+
588
+ it("should return 'refreshing' during refetch", async () => {
589
+ let stateDuringRefetch: string | undefined;
590
+
591
+ await createRoot(async (dispose) => {
592
+ let callCount = 0;
593
+ const fetcher = vi.fn(async () => {
594
+ callCount++;
595
+ await new Promise((resolve) => setTimeout(resolve, 50));
596
+ return callCount;
597
+ });
598
+
599
+ const resource = new SolidResource(fetcher);
600
+
601
+ // Initial fetch
602
+ resource.get();
603
+ await new Promise((resolve) => {
604
+ const check = () => {
605
+ if (resource.state() === "ready") {
606
+ resolve(undefined);
607
+ } else {
608
+ setTimeout(check, 10);
609
+ }
610
+ };
611
+ check();
612
+ });
613
+
614
+ // Trigger refetch
615
+ resource.refetch();
616
+
617
+ // Check state immediately
618
+ stateDuringRefetch = resource.state();
619
+
620
+ // Wait for completion
621
+ await new Promise((resolve) => {
622
+ const check = () => {
623
+ if (resource.state() === "ready") {
624
+ resolve(undefined);
625
+ } else {
626
+ setTimeout(check, 10);
627
+ }
628
+ };
629
+ check();
630
+ });
631
+
632
+ dispose();
633
+ });
634
+
635
+ expect(stateDuringRefetch).toBe("refreshing");
636
+ });
637
+ });
638
+
639
+ describe("latest", () => {
640
+ it("should return undefined initially", () => {
641
+ const fetcher = vi.fn(async () => 42);
642
+ const resource = new SolidResource(fetcher);
643
+
644
+ createRoot(() => {
645
+ expect(resource.latest()).toBeUndefined();
646
+ });
647
+ });
648
+
649
+ it("should return last successful value", async () => {
650
+ await createRoot(async (dispose) => {
651
+ const fetcher = vi.fn(async () => 42);
652
+ const resource = new SolidResource(fetcher);
653
+
654
+ // Access get() to trigger fetch
655
+ resource.get();
656
+
657
+ // Wait for completion
658
+ await new Promise((resolve) => {
659
+ const check = () => {
660
+ if (resource.state() === "ready") {
661
+ resolve(undefined);
662
+ } else {
663
+ setTimeout(check, 10);
664
+ }
665
+ };
666
+ check();
667
+ });
668
+
669
+ expect(resource.latest()).toBe(42);
670
+ dispose();
671
+ });
672
+ });
673
+
674
+ it("should return previous value during refetch", async () => {
675
+ await createRoot(async (dispose) => {
676
+ let callCount = 0;
677
+ const fetcher = vi.fn(async () => {
678
+ callCount++;
679
+ await new Promise((resolve) => setTimeout(resolve, 50));
680
+ return callCount;
681
+ });
682
+
683
+ const resource = new SolidResource(fetcher);
684
+
685
+ // Initial fetch
686
+ resource.get();
687
+ await new Promise((resolve) => {
688
+ const check = () => {
689
+ if (resource.state() === "ready") {
690
+ resolve(undefined);
691
+ } else {
692
+ setTimeout(check, 10);
693
+ }
694
+ };
695
+ check();
696
+ });
697
+
698
+ expect(resource.latest()).toBe(1);
699
+
700
+ // Trigger refetch
701
+ resource.refetch();
702
+
703
+ // Latest should still be previous value during refetch
704
+ expect(resource.latest()).toBe(1);
705
+
706
+ // Wait for refetch completion
707
+ await new Promise((resolve) => {
708
+ const check = () => {
709
+ if (resource.state() === "ready") {
710
+ resolve(undefined);
711
+ } else {
712
+ setTimeout(check, 10);
713
+ }
714
+ };
715
+ check();
716
+ });
717
+
718
+ expect(resource.latest()).toBe(2);
719
+ dispose();
720
+ });
721
+ });
722
+
723
+ it("should return previous value even after error", async () => {
724
+ await createRoot(async (dispose) => {
725
+ let shouldFail = false;
726
+ const fetcher = vi.fn(async () => {
727
+ if (shouldFail) {
728
+ throw new Error("Fetch failed");
729
+ }
730
+ return 42;
731
+ });
732
+
733
+ const resource = new SolidResource(fetcher);
734
+
735
+ // Initial successful fetch
736
+ await vi.waitFor(() => expect(resource.latest()).toBe(42));
737
+
738
+ // Trigger failed fetch
739
+ shouldFail = true;
740
+ resource.refetch();
741
+ await vi.waitFor(() => expect(resource.state()).toBe("errored"));
742
+
743
+ dispose();
744
+ });
745
+ });
746
+ });
747
+
748
+ describe("refetch", () => {
749
+ it("should trigger new fetch", async () => {
750
+ let callCount = 0;
751
+ const fetcher = vi.fn(async () => {
752
+ callCount++;
753
+ return callCount;
754
+ });
755
+
756
+ await createRoot(async (dispose) => {
757
+ const resource = new SolidResource(fetcher);
758
+
759
+ // Initial fetch
760
+ resource.get();
761
+ await new Promise((resolve) => {
762
+ const check = () => {
763
+ if (resource.state() === "ready") {
764
+ resolve(undefined);
765
+ } else {
766
+ setTimeout(check, 10);
767
+ }
768
+ };
769
+ check();
770
+ });
771
+
772
+ expect(callCount).toBe(1);
773
+ expect(resource.get()).toBe(1);
774
+
775
+ // Refetch
776
+ resource.refetch();
777
+ await new Promise((resolve) => {
778
+ const check = () => {
779
+ if (resource.state() === "ready") {
780
+ resolve(undefined);
781
+ } else {
782
+ setTimeout(check, 10);
783
+ }
784
+ };
785
+ check();
786
+ });
787
+
788
+ expect(callCount).toBe(2);
789
+ expect(resource.get()).toBe(2);
790
+ dispose();
791
+ });
792
+ });
793
+
794
+ it("should update value after refetch", async () => {
795
+ let counter = 0;
796
+ const fetcher = vi.fn(async () => {
797
+ counter++;
798
+ return counter;
799
+ });
800
+
801
+ await createRoot(async (dispose) => {
802
+ const resource = new SolidResource(fetcher);
803
+
804
+ // Initial fetch
805
+ resource.get();
806
+ await new Promise((resolve) => {
807
+ const check = () => {
808
+ if (resource.state() === "ready") {
809
+ resolve(undefined);
810
+ } else {
811
+ setTimeout(check, 10);
812
+ }
813
+ };
814
+ check();
815
+ });
816
+
817
+ expect(resource.get()).toBe(1);
818
+
819
+ // Refetch
820
+ resource.refetch();
821
+ await new Promise((resolve) => {
822
+ const check = () => {
823
+ if (resource.state() === "ready") {
824
+ resolve(undefined);
825
+ } else {
826
+ setTimeout(check, 10);
827
+ }
828
+ };
829
+ check();
830
+ });
831
+
832
+ expect(resource.get()).toBe(2);
833
+ dispose();
834
+ });
835
+ });
836
+
837
+ it("should set state to 'refreshing' during refetch", async () => {
838
+ let stateDuringRefetch: string | undefined;
839
+
840
+ await createRoot(async (dispose) => {
841
+ let callCount = 0;
842
+ const fetcher = vi.fn(async () => {
843
+ callCount++;
844
+ await new Promise((resolve) => setTimeout(resolve, 50));
845
+ return callCount;
846
+ });
847
+
848
+ const resource = new SolidResource(fetcher);
849
+
850
+ // Initial fetch
851
+ resource.get();
852
+ await new Promise((resolve) => {
853
+ const check = () => {
854
+ if (resource.state() === "ready") {
855
+ resolve(undefined);
856
+ } else {
857
+ setTimeout(check, 10);
858
+ }
859
+ };
860
+ check();
861
+ });
862
+
863
+ // Trigger refetch
864
+ resource.refetch();
865
+
866
+ // Check state immediately
867
+ stateDuringRefetch = resource.state();
868
+
869
+ // Wait for completion
870
+ await new Promise((resolve) => {
871
+ const check = () => {
872
+ if (resource.state() === "ready") {
873
+ resolve(undefined);
874
+ } else {
875
+ setTimeout(check, 10);
876
+ }
877
+ };
878
+ check();
879
+ });
880
+
881
+ dispose();
882
+ });
883
+
884
+ expect(stateDuringRefetch).toBe("refreshing");
885
+ });
886
+ });
887
+
888
+ describe("set", () => {
889
+ it("should update value with direct value", async () => {
890
+ await createRoot(async (dispose) => {
891
+ const fetcher = vi.fn(async () => 42);
892
+ const resource = new SolidResource(fetcher);
893
+
894
+ // Initial fetch
895
+ resource.get();
896
+ await new Promise((resolve) => {
897
+ const check = () => {
898
+ if (resource.state() === "ready") {
899
+ resolve(undefined);
900
+ } else {
901
+ setTimeout(check, 10);
902
+ }
903
+ };
904
+ check();
905
+ });
906
+
907
+ expect(resource.get()).toBe(42);
908
+
909
+ // Mutate value
910
+ resource.set(100);
911
+ expect(resource.get()).toBe(100);
912
+ dispose();
913
+ });
914
+ });
915
+
916
+ it("should update value with updater function", async () => {
917
+ await createRoot(async (dispose) => {
918
+ const fetcher = vi.fn(async () => 42);
919
+ const resource = new SolidResource(fetcher);
920
+
921
+ // Initial fetch
922
+ resource.get();
923
+ await new Promise((resolve) => {
924
+ const check = () => {
925
+ if (resource.state() === "ready") {
926
+ resolve(undefined);
927
+ } else {
928
+ setTimeout(check, 10);
929
+ }
930
+ };
931
+ check();
932
+ });
933
+
934
+ expect(resource.get()).toBe(42);
935
+
936
+ // Mutate with updater
937
+ resource.set((prev) => (prev ?? 0) * 2);
938
+ expect(resource.get()).toBe(84);
939
+ dispose();
940
+ });
941
+ });
942
+
943
+ it("should mutate resource value", async () => {
944
+ await createRoot(async (dispose) => {
945
+ const fetcher = vi.fn(async () => ({ count: 1 }));
946
+ const resource = new SolidResource(fetcher);
947
+
948
+ // Initial fetch
949
+ resource.get();
950
+ await new Promise((resolve) => {
951
+ const check = () => {
952
+ if (resource.state() === "ready") {
953
+ resolve(undefined);
954
+ } else {
955
+ setTimeout(check, 10);
956
+ }
957
+ };
958
+ check();
959
+ });
960
+
961
+ const initialValue = resource.get();
962
+ expect(initialValue).toEqual({ count: 1 });
963
+
964
+ // Mutate
965
+ resource.set({ count: 2 });
966
+ expect(resource.get()).toEqual({ count: 2 });
967
+ dispose();
968
+ });
969
+ });
970
+ });
971
+
972
+ describe("error handling", () => {
973
+ it("should handle fetch errors", async () => {
974
+ await createRoot(async (dispose) => {
975
+ const fetcher = vi.fn(async () => {
976
+ throw new Error("Fetch failed");
977
+ });
978
+
979
+ const resource = new SolidResource(fetcher);
980
+
981
+ // Access get() to trigger fetch
982
+ resource.get();
983
+
984
+ // Wait for error
985
+ await new Promise((resolve) => {
986
+ const check = () => {
987
+ if (resource.state() === "errored") {
988
+ resolve(undefined);
989
+ } else {
990
+ setTimeout(check, 10);
991
+ }
992
+ };
993
+ check();
994
+ });
995
+
996
+ expect(resource.state()).toBe("errored");
997
+ dispose();
998
+ });
999
+ });
1000
+
1001
+ it("should set state to 'errored' on fetch failure", async () => {
1002
+ await createRoot(async (dispose) => {
1003
+ const fetcher = vi.fn(async () => {
1004
+ throw new Error("Network error");
1005
+ });
1006
+
1007
+ const resource = new SolidResource(fetcher);
1008
+
1009
+ // Access get() to trigger fetch
1010
+ resource.get();
1011
+
1012
+ // Wait for error
1013
+ await new Promise((resolve) => {
1014
+ const check = () => {
1015
+ if (resource.state() === "errored") {
1016
+ resolve(undefined);
1017
+ } else {
1018
+ setTimeout(check, 10);
1019
+ }
1020
+ };
1021
+ check();
1022
+ });
1023
+
1024
+ expect(resource.state()).toBe("errored");
1025
+ dispose();
1026
+ });
1027
+ });
1028
+ });
1029
+ });
1030
+ });
1031
+ });