@ersbeth/picoflow 1.1.1 → 2.0.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 (383) hide show
  1. package/.vscode/settings.json +3 -3
  2. package/CHANGELOG.md +43 -0
  3. package/README.md +2 -18
  4. package/biome.json +45 -35
  5. package/dist/picoflow.js +857 -1528
  6. package/dist/types/api/base/flowDisposable.d.ts +41 -0
  7. package/dist/types/api/base/flowDisposable.d.ts.map +1 -0
  8. package/dist/types/api/base/flowObservable.d.ts +27 -0
  9. package/dist/types/api/base/flowObservable.d.ts.map +1 -0
  10. package/dist/types/api/base/flowSubscribable.d.ts +79 -0
  11. package/dist/types/api/base/flowSubscribable.d.ts.map +1 -0
  12. package/dist/types/api/base/flowTracker.d.ts +8 -0
  13. package/dist/types/api/base/flowTracker.d.ts.map +1 -0
  14. package/dist/types/api/base/index.d.ts +5 -0
  15. package/dist/types/api/base/index.d.ts.map +1 -0
  16. package/dist/types/api/index.d.ts +3 -0
  17. package/dist/types/api/index.d.ts.map +1 -0
  18. package/dist/types/api/nodes/async/flowConstantAsync.d.ts +31 -0
  19. package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map +1 -0
  20. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts +37 -0
  21. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map +1 -0
  22. package/dist/types/api/nodes/async/flowStateAsync.d.ts +41 -0
  23. package/dist/types/api/nodes/async/flowStateAsync.d.ts.map +1 -0
  24. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts +30 -0
  25. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts.map +1 -0
  26. package/dist/types/{flow → api}/nodes/async/index.d.ts +1 -2
  27. package/dist/types/api/nodes/async/index.d.ts.map +1 -0
  28. package/dist/types/api/nodes/collections/flowArray.d.ts +134 -0
  29. package/dist/types/api/nodes/collections/flowArray.d.ts.map +1 -0
  30. package/dist/types/api/nodes/collections/flowMap.d.ts +98 -0
  31. package/dist/types/api/nodes/collections/flowMap.d.ts.map +1 -0
  32. package/dist/types/api/nodes/collections/index.d.ts.map +1 -0
  33. package/dist/types/api/nodes/flowEffect.d.ts +28 -0
  34. package/dist/types/api/nodes/flowEffect.d.ts.map +1 -0
  35. package/dist/types/api/nodes/flowSignal.d.ts +25 -0
  36. package/dist/types/api/nodes/flowSignal.d.ts.map +1 -0
  37. package/dist/types/api/nodes/flowValue.d.ts +35 -0
  38. package/dist/types/api/nodes/flowValue.d.ts.map +1 -0
  39. package/dist/types/api/nodes/index.d.ts +8 -0
  40. package/dist/types/api/nodes/index.d.ts.map +1 -0
  41. package/dist/types/api/nodes/sync/flowConstant.d.ts +29 -0
  42. package/dist/types/api/nodes/sync/flowConstant.d.ts.map +1 -0
  43. package/dist/types/api/nodes/sync/flowDerivation.d.ts +36 -0
  44. package/dist/types/api/nodes/sync/flowDerivation.d.ts.map +1 -0
  45. package/dist/types/api/nodes/sync/flowState.d.ts +39 -0
  46. package/dist/types/api/nodes/sync/flowState.d.ts.map +1 -0
  47. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts +28 -0
  48. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts.map +1 -0
  49. package/dist/types/{flow → api}/nodes/sync/index.d.ts +1 -2
  50. package/dist/types/api/nodes/sync/index.d.ts.map +1 -0
  51. package/dist/types/api/nodes/utils.d.ts +22 -0
  52. package/dist/types/api/nodes/utils.d.ts.map +1 -0
  53. package/dist/types/base/disposable.d.ts +11 -0
  54. package/dist/types/base/disposable.d.ts.map +1 -0
  55. package/dist/types/base/executionStack.d.ts +14 -0
  56. package/dist/types/base/executionStack.d.ts.map +1 -0
  57. package/dist/types/base/index.d.ts +6 -0
  58. package/dist/types/base/index.d.ts.map +1 -0
  59. package/dist/types/base/node.d.ts +27 -0
  60. package/dist/types/base/node.d.ts.map +1 -0
  61. package/dist/types/base/observable.d.ts +37 -0
  62. package/dist/types/base/observable.d.ts.map +1 -0
  63. package/dist/types/base/observer.d.ts +25 -0
  64. package/dist/types/base/observer.d.ts.map +1 -0
  65. package/dist/types/converters/index.d.ts +2 -0
  66. package/dist/types/converters/index.d.ts.map +1 -0
  67. package/dist/types/converters/solid.d.ts +46 -0
  68. package/dist/types/converters/solid.d.ts.map +1 -0
  69. package/dist/types/index.d.ts +2 -63
  70. package/dist/types/index.d.ts.map +1 -1
  71. package/dist/types/nodes/arrayNode.d.ts +2 -0
  72. package/dist/types/nodes/arrayNode.d.ts.map +1 -0
  73. package/dist/types/nodes/effectNode.d.ts +2 -0
  74. package/dist/types/nodes/effectNode.d.ts.map +1 -0
  75. package/dist/types/nodes/index.d.ts +9 -0
  76. package/dist/types/nodes/index.d.ts.map +1 -0
  77. package/dist/types/nodes/mapNode.d.ts +2 -0
  78. package/dist/types/nodes/mapNode.d.ts.map +1 -0
  79. package/dist/types/nodes/signalNode.d.ts +2 -0
  80. package/dist/types/nodes/signalNode.d.ts.map +1 -0
  81. package/dist/types/nodes/valueAsyncNode.d.ts +2 -0
  82. package/dist/types/nodes/valueAsyncNode.d.ts.map +1 -0
  83. package/dist/types/nodes/valueNode.d.ts +2 -0
  84. package/dist/types/nodes/valueNode.d.ts.map +1 -0
  85. package/dist/types/nodes/valueSyncNode.d.ts +2 -0
  86. package/dist/types/nodes/valueSyncNode.d.ts.map +1 -0
  87. package/dist/types/schedulers/asyncResolver.d.ts +2 -0
  88. package/dist/types/schedulers/asyncResolver.d.ts.map +1 -0
  89. package/dist/types/schedulers/asyncScheduler.d.ts +2 -0
  90. package/dist/types/schedulers/asyncScheduler.d.ts.map +1 -0
  91. package/dist/types/schedulers/index.d.ts +5 -0
  92. package/dist/types/schedulers/index.d.ts.map +1 -0
  93. package/dist/types/schedulers/pendingError.d.ts +2 -0
  94. package/dist/types/schedulers/pendingError.d.ts.map +1 -0
  95. package/dist/types/schedulers/scheduler.d.ts +2 -0
  96. package/dist/types/schedulers/scheduler.d.ts.map +1 -0
  97. package/dist/types/schedulers/syncResolver.d.ts +2 -0
  98. package/dist/types/schedulers/syncResolver.d.ts.map +1 -0
  99. package/dist/types/schedulers/syncScheduler.d.ts +2 -0
  100. package/dist/types/schedulers/syncScheduler.d.ts.map +1 -0
  101. package/docs/.vitepress/config.mts +128 -93
  102. package/docs/api/functions/array.md +14 -37
  103. package/docs/api/functions/constant.md +13 -25
  104. package/docs/api/functions/constantAsync.md +69 -0
  105. package/docs/api/functions/derivation.md +14 -33
  106. package/docs/api/functions/derivationAsync.md +34 -0
  107. package/docs/api/functions/from.md +62 -153
  108. package/docs/api/functions/isDisposable.md +8 -30
  109. package/docs/api/functions/map.md +15 -36
  110. package/docs/api/functions/signal.md +8 -23
  111. package/docs/api/functions/state.md +43 -23
  112. package/docs/api/functions/stateAsync.md +69 -0
  113. package/docs/api/functions/subscribe.md +40 -0
  114. package/docs/api/functions/writableDerivation.md +33 -0
  115. package/docs/api/functions/writableDerivationAsync.md +34 -0
  116. package/docs/api/index.md +45 -102
  117. package/docs/api/interfaces/FlowArray.md +439 -0
  118. package/docs/api/interfaces/FlowConstant.md +220 -0
  119. package/docs/api/interfaces/FlowConstantAsync.md +221 -0
  120. package/docs/api/interfaces/FlowDerivation.md +241 -0
  121. package/docs/api/interfaces/FlowDerivationAsync.md +242 -0
  122. package/docs/api/interfaces/FlowDisposable.md +32 -38
  123. package/docs/api/interfaces/FlowEffect.md +64 -0
  124. package/docs/api/interfaces/FlowMap.md +374 -0
  125. package/docs/api/interfaces/FlowObservable.md +155 -0
  126. package/docs/api/interfaces/FlowSignal.md +156 -0
  127. package/docs/api/interfaces/FlowState.md +269 -0
  128. package/docs/api/interfaces/FlowStateAsync.md +268 -0
  129. package/docs/api/interfaces/FlowSubscribable.md +55 -0
  130. package/docs/api/interfaces/FlowTracker.md +61 -0
  131. package/docs/api/interfaces/FlowValue.md +222 -0
  132. package/docs/api/interfaces/FlowWritableDerivation.md +292 -0
  133. package/docs/api/interfaces/FlowWritableDerivationAsync.md +293 -0
  134. package/docs/api/type-aliases/DerivationFunction.md +28 -0
  135. package/docs/api/type-aliases/DerivationFunctionAsync.md +28 -0
  136. package/docs/api/type-aliases/FlowArrayAction.md +19 -8
  137. package/docs/api/type-aliases/FlowDataTracker.md +33 -0
  138. package/docs/api/type-aliases/FlowMapAction.md +48 -0
  139. package/docs/api/type-aliases/FlowOnDataListener.md +33 -0
  140. package/docs/api/type-aliases/FlowOnErrorListener.md +27 -0
  141. package/docs/api/type-aliases/FlowOnPendingListener.md +21 -0
  142. package/docs/api/type-aliases/FlowReadonly.md +22 -0
  143. package/docs/api/type-aliases/InitFunction.md +21 -0
  144. package/docs/api/type-aliases/InitFunctionAsync.md +21 -0
  145. package/docs/api/type-aliases/NotPromise.md +6 -3
  146. package/docs/api/type-aliases/UpdateFunction.md +27 -0
  147. package/docs/api/type-aliases/UpdateFunctionAsync.md +27 -0
  148. package/docs/api/typedoc-sidebar.json +1 -81
  149. package/docs/examples/examples.md +0 -2
  150. package/docs/guide/advanced/architecture.md +1234 -0
  151. package/docs/guide/advanced/migration-v2.md +204 -0
  152. package/docs/guide/advanced/solidjs.md +2 -88
  153. package/docs/guide/introduction/concepts.md +4 -3
  154. package/docs/guide/introduction/conventions.md +2 -33
  155. package/docs/guide/introduction/getting-started.md +28 -23
  156. package/docs/guide/introduction/lifecycle.md +16 -19
  157. package/docs/guide/primitives/array.md +102 -216
  158. package/docs/guide/primitives/constant.md +39 -212
  159. package/docs/guide/primitives/derivations.md +55 -122
  160. package/docs/guide/primitives/effects.md +155 -241
  161. package/docs/guide/primitives/map.md +64 -186
  162. package/docs/guide/primitives/overview.md +45 -128
  163. package/docs/guide/primitives/signal.md +51 -88
  164. package/docs/guide/primitives/state.md +34 -130
  165. package/package.json +56 -60
  166. package/src/api/base/flowDisposable.ts +44 -0
  167. package/src/api/base/flowObservable.ts +28 -0
  168. package/src/api/base/flowSubscribable.ts +87 -0
  169. package/src/api/base/flowTracker.ts +7 -0
  170. package/src/api/base/index.ts +4 -0
  171. package/src/{flow → api}/index.ts +0 -1
  172. package/src/api/nodes/async/flowConstantAsync.ts +36 -0
  173. package/src/api/nodes/async/flowDerivationAsync.ts +42 -0
  174. package/src/api/nodes/async/flowStateAsync.ts +47 -0
  175. package/src/api/nodes/async/flowWritableDerivationAsync.ts +33 -0
  176. package/src/{flow → api}/nodes/async/index.ts +1 -2
  177. package/src/api/nodes/collections/flowArray.ts +155 -0
  178. package/src/api/nodes/collections/flowMap.ts +115 -0
  179. package/src/api/nodes/flowEffect.ts +42 -0
  180. package/src/api/nodes/flowSignal.ts +28 -0
  181. package/src/api/nodes/flowValue.ts +36 -0
  182. package/src/api/nodes/index.ts +7 -0
  183. package/src/api/nodes/sync/flowConstant.ts +33 -0
  184. package/src/api/nodes/sync/flowDerivation.ts +41 -0
  185. package/src/api/nodes/sync/flowState.ts +45 -0
  186. package/src/api/nodes/sync/flowWritableDerivation.ts +31 -0
  187. package/src/{flow → api}/nodes/sync/index.ts +1 -2
  188. package/src/api/nodes/utils.ts +22 -0
  189. package/src/base/disposable.ts +18 -0
  190. package/src/base/executionStack.ts +42 -0
  191. package/src/base/index.ts +5 -0
  192. package/src/base/node.ts +98 -0
  193. package/src/base/observable.ts +87 -0
  194. package/src/base/observer.ts +51 -0
  195. package/src/converters/index.ts +1 -0
  196. package/src/converters/solid.ts +109 -0
  197. package/src/index.ts +2 -64
  198. package/src/nodes/arrayNode.ts +172 -0
  199. package/src/nodes/effectNode.ts +59 -0
  200. package/src/nodes/index.ts +8 -0
  201. package/src/nodes/mapNode.ts +127 -0
  202. package/src/nodes/signalNode.ts +21 -0
  203. package/src/nodes/valueAsyncNode.ts +88 -0
  204. package/src/nodes/valueNode.ts +144 -0
  205. package/src/nodes/valueSyncNode.ts +128 -0
  206. package/src/schedulers/asyncResolver.ts +78 -0
  207. package/src/schedulers/asyncScheduler.ts +66 -0
  208. package/src/schedulers/index.ts +4 -0
  209. package/src/schedulers/pendingError.ts +13 -0
  210. package/src/schedulers/scheduler.ts +9 -0
  211. package/src/schedulers/syncResolver.ts +69 -0
  212. package/src/schedulers/syncScheduler.ts +55 -0
  213. package/test/base/pendingError.test.ts +67 -0
  214. package/test/converters/solid.derivation.browser.test.tsx +69 -0
  215. package/test/converters/solid.node.test.ts +654 -0
  216. package/test/converters/solid.state.browser.test.tsx +1592 -0
  217. package/test/reactivity/flowSignal.test.ts +226 -0
  218. package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +593 -0
  219. package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +317 -0
  220. package/test/reactivity/nodes/async/flowConstantAsync.test.ts +652 -0
  221. package/test/reactivity/nodes/async/flowDerivation.test.ts +898 -0
  222. package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +1716 -0
  223. package/test/reactivity/nodes/async/flowStateAsync.test.ts +708 -0
  224. package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +614 -0
  225. package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +1289 -0
  226. package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +961 -0
  227. package/test/reactivity/nodes/collections/flowArray.states.test.ts +1035 -0
  228. package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +960 -0
  229. package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +775 -0
  230. package/test/reactivity/nodes/collections/flowMap.states.test.ts +958 -0
  231. package/test/reactivity/nodes/sync/flowConstant.test.ts +377 -0
  232. package/test/reactivity/nodes/sync/flowDerivation.test.ts +896 -0
  233. package/test/reactivity/nodes/sync/flowState.test.ts +341 -0
  234. package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +603 -0
  235. package/test/vitest.d.ts +10 -0
  236. package/tsconfig.json +31 -20
  237. package/typedoc.json +35 -35
  238. package/vite.config.ts +25 -23
  239. package/vitest.browser.config.ts +21 -0
  240. package/vitest.config.ts +12 -12
  241. package/.cursor/plans/unifier-flowresource-avec-flowderivation-c9506e24.plan.md +0 -372
  242. package/.cursor/plans/update-js-e795d61b.plan.md +0 -567
  243. package/dist/types/flow/base/flowDisposable.d.ts +0 -67
  244. package/dist/types/flow/base/flowDisposable.d.ts.map +0 -1
  245. package/dist/types/flow/base/flowEffect.d.ts +0 -127
  246. package/dist/types/flow/base/flowEffect.d.ts.map +0 -1
  247. package/dist/types/flow/base/flowGraph.d.ts +0 -97
  248. package/dist/types/flow/base/flowGraph.d.ts.map +0 -1
  249. package/dist/types/flow/base/flowSignal.d.ts +0 -134
  250. package/dist/types/flow/base/flowSignal.d.ts.map +0 -1
  251. package/dist/types/flow/base/flowTracker.d.ts +0 -15
  252. package/dist/types/flow/base/flowTracker.d.ts.map +0 -1
  253. package/dist/types/flow/base/index.d.ts +0 -7
  254. package/dist/types/flow/base/index.d.ts.map +0 -1
  255. package/dist/types/flow/base/utils.d.ts +0 -20
  256. package/dist/types/flow/base/utils.d.ts.map +0 -1
  257. package/dist/types/flow/collections/flowArray.d.ts +0 -148
  258. package/dist/types/flow/collections/flowArray.d.ts.map +0 -1
  259. package/dist/types/flow/collections/flowMap.d.ts +0 -224
  260. package/dist/types/flow/collections/flowMap.d.ts.map +0 -1
  261. package/dist/types/flow/collections/index.d.ts.map +0 -1
  262. package/dist/types/flow/index.d.ts +0 -4
  263. package/dist/types/flow/index.d.ts.map +0 -1
  264. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts +0 -137
  265. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts.map +0 -1
  266. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts +0 -137
  267. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts.map +0 -1
  268. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts +0 -343
  269. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts.map +0 -1
  270. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts +0 -81
  271. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts.map +0 -1
  272. package/dist/types/flow/nodes/async/flowStateAsync.d.ts +0 -111
  273. package/dist/types/flow/nodes/async/flowStateAsync.d.ts.map +0 -1
  274. package/dist/types/flow/nodes/async/index.d.ts.map +0 -1
  275. package/dist/types/flow/nodes/index.d.ts +0 -3
  276. package/dist/types/flow/nodes/index.d.ts.map +0 -1
  277. package/dist/types/flow/nodes/sync/flowConstant.d.ts +0 -108
  278. package/dist/types/flow/nodes/sync/flowConstant.d.ts.map +0 -1
  279. package/dist/types/flow/nodes/sync/flowDerivation.d.ts +0 -100
  280. package/dist/types/flow/nodes/sync/flowDerivation.d.ts.map +0 -1
  281. package/dist/types/flow/nodes/sync/flowNode.d.ts +0 -314
  282. package/dist/types/flow/nodes/sync/flowNode.d.ts.map +0 -1
  283. package/dist/types/flow/nodes/sync/flowReadonly.d.ts +0 -57
  284. package/dist/types/flow/nodes/sync/flowReadonly.d.ts.map +0 -1
  285. package/dist/types/flow/nodes/sync/flowState.d.ts +0 -96
  286. package/dist/types/flow/nodes/sync/flowState.d.ts.map +0 -1
  287. package/dist/types/flow/nodes/sync/index.d.ts.map +0 -1
  288. package/dist/types/solid/converters.d.ts +0 -53
  289. package/dist/types/solid/converters.d.ts.map +0 -1
  290. package/dist/types/solid/index.d.ts +0 -3
  291. package/dist/types/solid/index.d.ts.map +0 -1
  292. package/dist/types/solid/primitives.d.ts +0 -181
  293. package/dist/types/solid/primitives.d.ts.map +0 -1
  294. package/docs/api/classes/FlowArray.md +0 -489
  295. package/docs/api/classes/FlowConstant.md +0 -350
  296. package/docs/api/classes/FlowDerivation.md +0 -334
  297. package/docs/api/classes/FlowEffect.md +0 -100
  298. package/docs/api/classes/FlowMap.md +0 -512
  299. package/docs/api/classes/FlowObservable.md +0 -306
  300. package/docs/api/classes/FlowResource.md +0 -380
  301. package/docs/api/classes/FlowResourceAsync.md +0 -362
  302. package/docs/api/classes/FlowSignal.md +0 -160
  303. package/docs/api/classes/FlowState.md +0 -368
  304. package/docs/api/classes/FlowStream.md +0 -367
  305. package/docs/api/classes/FlowStreamAsync.md +0 -364
  306. package/docs/api/classes/SolidDerivation.md +0 -75
  307. package/docs/api/classes/SolidResource.md +0 -91
  308. package/docs/api/classes/SolidState.md +0 -71
  309. package/docs/api/classes/TrackingContext.md +0 -33
  310. package/docs/api/functions/effect.md +0 -49
  311. package/docs/api/functions/resource.md +0 -52
  312. package/docs/api/functions/resourceAsync.md +0 -50
  313. package/docs/api/functions/stream.md +0 -53
  314. package/docs/api/functions/streamAsync.md +0 -50
  315. package/docs/api/interfaces/SolidObservable.md +0 -19
  316. package/docs/api/type-aliases/FlowStreamDisposer.md +0 -15
  317. package/docs/api/type-aliases/FlowStreamSetter.md +0 -27
  318. package/docs/api/type-aliases/FlowStreamUpdater.md +0 -32
  319. package/docs/api/type-aliases/SolidGetter.md +0 -17
  320. package/docs/guide/primitives/resources.md +0 -858
  321. package/docs/guide/primitives/streams.md +0 -931
  322. package/src/flow/base/flowDisposable.ts +0 -71
  323. package/src/flow/base/flowEffect.ts +0 -171
  324. package/src/flow/base/flowGraph.ts +0 -288
  325. package/src/flow/base/flowSignal.ts +0 -207
  326. package/src/flow/base/flowTracker.ts +0 -17
  327. package/src/flow/base/index.ts +0 -6
  328. package/src/flow/base/utils.ts +0 -19
  329. package/src/flow/collections/flowArray.ts +0 -409
  330. package/src/flow/collections/flowMap.ts +0 -398
  331. package/src/flow/nodes/async/flowConstantAsync.ts +0 -142
  332. package/src/flow/nodes/async/flowDerivationAsync.ts +0 -143
  333. package/src/flow/nodes/async/flowNodeAsync.ts +0 -474
  334. package/src/flow/nodes/async/flowReadonlyAsync.ts +0 -81
  335. package/src/flow/nodes/async/flowStateAsync.ts +0 -116
  336. package/src/flow/nodes/await/advanced/index.ts +0 -5
  337. package/src/flow/nodes/await/advanced/resource.ts +0 -134
  338. package/src/flow/nodes/await/advanced/resourceAsync.ts +0 -109
  339. package/src/flow/nodes/await/advanced/stream.ts +0 -188
  340. package/src/flow/nodes/await/advanced/streamAsync.ts +0 -176
  341. package/src/flow/nodes/await/flowConstantAwait.ts +0 -154
  342. package/src/flow/nodes/await/flowDerivationAwait.ts +0 -154
  343. package/src/flow/nodes/await/flowNodeAwait.ts +0 -508
  344. package/src/flow/nodes/await/flowReadonlyAwait.ts +0 -89
  345. package/src/flow/nodes/await/flowStateAwait.ts +0 -130
  346. package/src/flow/nodes/await/index.ts +0 -5
  347. package/src/flow/nodes/index.ts +0 -3
  348. package/src/flow/nodes/sync/flowConstant.ts +0 -111
  349. package/src/flow/nodes/sync/flowDerivation.ts +0 -105
  350. package/src/flow/nodes/sync/flowNode.ts +0 -439
  351. package/src/flow/nodes/sync/flowReadonly.ts +0 -57
  352. package/src/flow/nodes/sync/flowState.ts +0 -101
  353. package/src/solid/converters.ts +0 -139
  354. package/src/solid/index.ts +0 -2
  355. package/src/solid/primitives.ts +0 -215
  356. package/test/base/flowEffect.test.ts +0 -108
  357. package/test/base/flowGraph.test.ts +0 -485
  358. package/test/base/flowSignal.test.ts +0 -372
  359. package/test/collections/flowArray.asyncStates.test.ts +0 -1553
  360. package/test/collections/flowArray.scalars.test.ts +0 -1129
  361. package/test/collections/flowArray.states.test.ts +0 -1365
  362. package/test/collections/flowMap.asyncStates.test.ts +0 -1105
  363. package/test/collections/flowMap.scalars.test.ts +0 -877
  364. package/test/collections/flowMap.states.test.ts +0 -1097
  365. package/test/nodes/async/flowConstantAsync.test.ts +0 -860
  366. package/test/nodes/async/flowDerivationAsync.test.ts +0 -1517
  367. package/test/nodes/async/flowStateAsync.test.ts +0 -1387
  368. package/test/nodes/await/advanced/resource.test.ts +0 -129
  369. package/test/nodes/await/advanced/resourceAsync.test.ts +0 -108
  370. package/test/nodes/await/advanced/stream.test.ts +0 -198
  371. package/test/nodes/await/advanced/streamAsync.test.ts +0 -196
  372. package/test/nodes/await/flowConstantAwait.test.ts +0 -643
  373. package/test/nodes/await/flowDerivationAwait.test.ts +0 -1583
  374. package/test/nodes/await/flowStateAwait.test.ts +0 -999
  375. package/test/nodes/mixed/derivation.test.ts +0 -1527
  376. package/test/nodes/sync/flowConstant.test.ts +0 -620
  377. package/test/nodes/sync/flowDerivation.test.ts +0 -1373
  378. package/test/nodes/sync/flowState.test.ts +0 -945
  379. package/test/solid/converters.test.ts +0 -721
  380. package/test/solid/primitives.test.ts +0 -1031
  381. /package/dist/types/{flow → api/nodes}/collections/index.d.ts +0 -0
  382. /package/docs/guide/advanced/{upgrading.md → migration-v1.md} +0 -0
  383. /package/src/{flow → api/nodes}/collections/index.ts +0 -0
@@ -1,1031 +0,0 @@
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
- });