@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
@@ -0,0 +1,614 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { derivationAsync, signal, stateAsync, subscribe, writableDerivationAsync } from "~";
3
+
4
+ describe("flowWritableDerivationAsync", () => {
5
+ describe("unit", () => {
6
+ describe("set on derivation", () => {
7
+ it("should override computed value when set is called", async () => {
8
+ const $state = stateAsync(Promise.resolve(1));
9
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
10
+
11
+ expect(await $writableDerivation.pick()).toBe(2);
12
+
13
+ $writableDerivation.set(Promise.resolve(100));
14
+ expect(await $writableDerivation.pick()).toBe(100);
15
+ });
16
+
17
+ it("should notify dependents when set overrides computed value", async () => {
18
+ const $state = stateAsync(Promise.resolve(1));
19
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
20
+ const onData = vi.fn();
21
+
22
+ $writableDerivation.subscribe((value) => onData(value));
23
+
24
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
25
+ expect(onData).toHaveBeenLastCalledWith(2);
26
+
27
+ $writableDerivation.set(Promise.resolve(100));
28
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
29
+ expect(onData).toHaveBeenLastCalledWith(100);
30
+ });
31
+
32
+ it("should work with updater function on writableDerivation with dependencies", async () => {
33
+ const $state = stateAsync(Promise.resolve(5));
34
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
35
+ const onData = vi.fn();
36
+
37
+ $writableDerivation.subscribe((value) => onData(value));
38
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
39
+ expect(onData).toHaveBeenLastCalledWith(10);
40
+
41
+ $writableDerivation.set(async (current) => Promise.resolve((current ?? 0) + 5));
42
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
43
+ expect(onData).toHaveBeenLastCalledWith(15);
44
+ });
45
+
46
+ it("should not notify when set with same value on writableDerivation", async () => {
47
+ const $state = stateAsync(Promise.resolve(1));
48
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
49
+ const onData = vi.fn();
50
+
51
+ $writableDerivation.subscribe((value) => onData(value));
52
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
53
+ expect(onData).toHaveBeenLastCalledWith(2);
54
+
55
+ $writableDerivation.set(Promise.resolve(2));
56
+ await new Promise((resolve) => setTimeout(resolve, 50));
57
+ expect(onData).toHaveBeenCalledTimes(3);
58
+ expect(onData).toHaveBeenLastCalledWith(2);
59
+ });
60
+ });
61
+
62
+ describe("set and reactive dependencies", () => {
63
+ it("should recompute when dependency changes after set", async () => {
64
+ const $state = stateAsync(Promise.resolve(1));
65
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
66
+
67
+ expect(await $writableDerivation.pick()).toBe(2);
68
+
69
+ $writableDerivation.set(Promise.resolve(100));
70
+ expect(await $writableDerivation.pick()).toBe(100);
71
+
72
+ $state.set(Promise.resolve(5));
73
+ // When dependency changes, derivation is marked dirty and recomputes on access
74
+ expect(await $writableDerivation.pick()).toBe(10);
75
+ });
76
+
77
+ it("should override set value when dependency changes and derivation is accessed", async () => {
78
+ const $state = stateAsync(Promise.resolve(1));
79
+ const computeFn = vi.fn(async (t) => (await $state.get(t)) * 2);
80
+ const $writableDerivation = writableDerivationAsync(computeFn);
81
+
82
+ expect(await $writableDerivation.pick()).toBe(2);
83
+ expect(computeFn).toHaveBeenCalledTimes(2);
84
+
85
+ $writableDerivation.set(Promise.resolve(100));
86
+ expect(await $writableDerivation.pick()).toBe(100);
87
+ expect(computeFn).toHaveBeenCalledTimes(2);
88
+
89
+ $state.set(Promise.resolve(5));
90
+ // When accessed, it should recompute because dependency changed
91
+ expect(await $writableDerivation.pick()).toBe(10);
92
+ expect(computeFn).toHaveBeenCalledTimes(4);
93
+ });
94
+
95
+ it("should handle set after dependency change", async () => {
96
+ const $state = stateAsync(Promise.resolve(1));
97
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
98
+ const onData = vi.fn();
99
+
100
+ $writableDerivation.subscribe((value) => onData(value));
101
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
102
+ expect(onData).toHaveBeenLastCalledWith(2);
103
+
104
+ $state.set(Promise.resolve(5));
105
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
106
+ expect(onData).toHaveBeenLastCalledWith(10);
107
+
108
+ $writableDerivation.set(Promise.resolve(200));
109
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
110
+ expect(onData).toHaveBeenLastCalledWith(200);
111
+ });
112
+
113
+ it("should handle set then dependency change then refresh", async () => {
114
+ const $state = stateAsync(Promise.resolve(1));
115
+ const computeFn = vi.fn(async (t) => $state.get(t) * 2);
116
+ const $writableDerivation = writableDerivationAsync(computeFn);
117
+
118
+ expect(await $writableDerivation.pick()).toBe(2);
119
+ expect(computeFn).toHaveBeenCalledTimes(2);
120
+
121
+ $writableDerivation.set(Promise.resolve(100));
122
+ expect(await $writableDerivation.pick()).toBe(100);
123
+ expect(computeFn).toHaveBeenCalledTimes(2);
124
+
125
+ $state.set(Promise.resolve(5));
126
+ $writableDerivation.refresh();
127
+ await new Promise((resolve) => setTimeout(resolve, 10));
128
+ expect(computeFn).toHaveBeenCalledTimes(4);
129
+ expect(await $writableDerivation.pick()).toBe(10);
130
+ });
131
+ });
132
+
133
+ describe("set with different statuses", () => {
134
+ it("should work when set is called on dirty derivation", async () => {
135
+ const $state = stateAsync(Promise.resolve(1));
136
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
137
+
138
+ await $writableDerivation.pick();
139
+ $state.set(Promise.resolve(5));
140
+ // Now derivation is dirty
141
+
142
+ $writableDerivation.set(Promise.resolve(100));
143
+ expect(await $writableDerivation.pick()).toBe(100);
144
+ });
145
+
146
+ it("should work when set is called on pending derivation", async () => {
147
+ const $state = stateAsync(Promise.resolve(1));
148
+ const promise = Promise.resolve(2);
149
+ const $writableDerivation = writableDerivationAsync(async (t) => {
150
+ const value = await $state.get(t);
151
+ if (value === 2) {
152
+ throw promise;
153
+ }
154
+ return value * 2;
155
+ });
156
+
157
+ expect(await $writableDerivation.pick()).toBe(2);
158
+
159
+ $state.set(Promise.resolve(2));
160
+ // Now derivation is pending
161
+
162
+ $writableDerivation.set(Promise.resolve(100));
163
+ expect(await $writableDerivation.pick()).toBe(100);
164
+ });
165
+
166
+ it("should work when set is called on error derivation", async () => {
167
+ const $state = stateAsync(Promise.resolve(1));
168
+ const error = new Error("Compute error");
169
+ const $writableDerivation = writableDerivationAsync(async (t) => {
170
+ const value = await $state.get(t);
171
+ if (value > 1) {
172
+ throw error;
173
+ }
174
+ return value * 2;
175
+ });
176
+
177
+ expect(await $writableDerivation.pick()).toBe(2);
178
+
179
+ $state.set(Promise.resolve(2));
180
+ // Now derivation is in error state
181
+
182
+ $writableDerivation.set(Promise.resolve(100));
183
+ expect(await $writableDerivation.pick()).toBe(100);
184
+ });
185
+
186
+ it("should work when set is called on resolved derivation with dependencies", async () => {
187
+ const $state = stateAsync(Promise.resolve(1));
188
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
189
+
190
+ await $writableDerivation.pick();
191
+ // Now derivation is resolved
192
+
193
+ $writableDerivation.set(Promise.resolve(100));
194
+ expect(await $writableDerivation.pick()).toBe(100);
195
+ });
196
+ });
197
+
198
+ describe("set and refresh interaction", () => {
199
+ it("should override set value when refresh is called", async () => {
200
+ const $state = stateAsync(Promise.resolve(5));
201
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
202
+ const onData = vi.fn();
203
+
204
+ $writableDerivation.subscribe((value) => onData(value));
205
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
206
+ expect(onData).toHaveBeenLastCalledWith(10);
207
+
208
+ $writableDerivation.set(Promise.resolve(100));
209
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
210
+ expect(onData).toHaveBeenLastCalledWith(100);
211
+
212
+ $writableDerivation.refresh();
213
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
214
+ expect(onData).toHaveBeenLastCalledWith(10);
215
+ });
216
+
217
+ it("should override refresh value when set is called after refresh", async () => {
218
+ const $state = stateAsync(Promise.resolve(5));
219
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
220
+ const onData = vi.fn();
221
+
222
+ $writableDerivation.subscribe((value) => onData(value));
223
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
224
+ expect(onData).toHaveBeenLastCalledWith(10);
225
+
226
+ $writableDerivation.refresh();
227
+ await new Promise((resolve) => setTimeout(resolve, 10));
228
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
229
+ expect(onData).toHaveBeenLastCalledWith(10);
230
+
231
+ $writableDerivation.set(Promise.resolve(200));
232
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
233
+ expect(onData).toHaveBeenLastCalledWith(200);
234
+ });
235
+
236
+ it("should handle set then refresh then dependency change", async () => {
237
+ const $state = stateAsync(Promise.resolve(1));
238
+ const computeFn = vi.fn(async (t) => (await $state.get(t)) * 2);
239
+ const $writableDerivation = writableDerivationAsync(computeFn);
240
+
241
+ expect(await $writableDerivation.pick()).toBe(2);
242
+ expect(computeFn).toHaveBeenCalledTimes(2);
243
+
244
+ $writableDerivation.set(Promise.resolve(100));
245
+ expect(await $writableDerivation.pick()).toBe(100);
246
+ expect(computeFn).toHaveBeenCalledTimes(2);
247
+
248
+ $writableDerivation.refresh();
249
+ await new Promise((resolve) => setTimeout(resolve, 10));
250
+ expect(computeFn).toHaveBeenCalledTimes(3);
251
+ expect(await $writableDerivation.pick()).toBe(2);
252
+
253
+ $state.set(Promise.resolve(5));
254
+ expect(await $writableDerivation.pick()).toBe(10);
255
+ expect(computeFn).toHaveBeenCalledTimes(5);
256
+ });
257
+ });
258
+
259
+ describe("set with computed dependencies", () => {
260
+ it("should work with set on writableDerivation depending on another derivation", async () => {
261
+ const $state = stateAsync(Promise.resolve(1));
262
+ const $derivation1 = derivationAsync(async (t) => $state.get(t) * 2);
263
+ const $writableDerivation = writableDerivationAsync(async (t) => $derivation1.get(t) * 2);
264
+ const onData = vi.fn();
265
+
266
+ $writableDerivation.subscribe((value) => onData(value));
267
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
268
+ expect(onData).toHaveBeenLastCalledWith(4);
269
+
270
+ $writableDerivation.set(Promise.resolve(100));
271
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
272
+ expect(onData).toHaveBeenLastCalledWith(100);
273
+ });
274
+
275
+ it("should work with set on writableDerivation depending on state", async () => {
276
+ const $state = stateAsync(Promise.resolve(1));
277
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
278
+ const onData = vi.fn();
279
+
280
+ $writableDerivation.subscribe((value) => onData(value));
281
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
282
+ expect(onData).toHaveBeenLastCalledWith(2);
283
+
284
+ $writableDerivation.set(Promise.resolve(50));
285
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
286
+ expect(onData).toHaveBeenLastCalledWith(50);
287
+ });
288
+
289
+ it("should work with set on writableDerivation depending on signal", async () => {
290
+ const $signal = signal();
291
+ const $state = stateAsync(Promise.resolve(0));
292
+ const $writableDerivation = writableDerivationAsync(async (t) => {
293
+ await Promise.resolve();
294
+ $signal.watch(t);
295
+ return $state.get(t);
296
+ });
297
+ const onData = vi.fn();
298
+
299
+ $writableDerivation.subscribe((value) => onData(value));
300
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
301
+ expect(onData).toHaveBeenLastCalledWith(0);
302
+
303
+ $writableDerivation.set(Promise.resolve(99));
304
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
305
+ expect(onData).toHaveBeenLastCalledWith(99);
306
+ });
307
+
308
+ it("should work with set on writableDerivation with multiple dependencies", async () => {
309
+ const $state1 = stateAsync(Promise.resolve(1));
310
+ const $state2 = stateAsync(Promise.resolve(2));
311
+ const $writableDerivation = writableDerivationAsync(async (t) => $state1.get(t) + $state2.get(t));
312
+ const onData = vi.fn();
313
+
314
+ $writableDerivation.subscribe((value) => onData(value));
315
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
316
+ expect(onData).toHaveBeenLastCalledWith(3);
317
+
318
+ $writableDerivation.set(Promise.resolve(999));
319
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
320
+ expect(onData).toHaveBeenLastCalledWith(999);
321
+ });
322
+ });
323
+ });
324
+
325
+ describe("with effect", () => {
326
+ describe("set in reactive context", () => {
327
+ it("should work when effect does set on writableDerivation with dependencies", async () => {
328
+ const $state = stateAsync(Promise.resolve(1));
329
+ const $writableDerivation = writableDerivationAsync(async (t) => $state.get(t) * 2);
330
+ const onData = vi.fn();
331
+
332
+ subscribe(
333
+ (t) => $writableDerivation.get(t),
334
+ (value) => {
335
+ if (value === 2) {
336
+ $writableDerivation.set(Promise.resolve(100));
337
+ }
338
+ onData(value);
339
+ },
340
+ );
341
+
342
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
343
+ expect(onData).toHaveBeenNthCalledWith(1, 2);
344
+ expect(onData).toHaveBeenNthCalledWith(2, 100);
345
+ });
346
+
347
+ // TODO: should we do this ?
348
+ // it("should work when one effect observes and another effect does set", async () => {
349
+ // const $state = stateAsync(Promise.resolve(1));
350
+ // const $writableDerivation = writableDerivationAsync(
351
+ // async (t) => $state.get(t) * 2,
352
+ // );
353
+ // const observerFn = vi.fn();
354
+ // const setterFn = vi.fn();
355
+
356
+ // subscribe(
357
+ // (t) => $writableDerivation.get(t),
358
+ // (value) => observerFn(value),
359
+ // );
360
+
361
+ // subscribe(
362
+ // () => undefined,
363
+ // () => {
364
+ // $writableDerivation.set(Promise.resolve(200));
365
+ // setterFn();
366
+ // },
367
+ // );
368
+
369
+ // await vi.waitFor(() => expect(observerFn).toHaveBeenCalledTimes(1));
370
+ // expect(observerFn).toHaveBeenLastCalledWith(200);
371
+ // expect(setterFn).toHaveBeenCalledTimes(1);
372
+ // });
373
+
374
+ // TODO: should we do this ?
375
+ // it("should work when dependency changes then set is done", async () => {
376
+ // const $state = stateAsync(Promise.resolve(1));
377
+ // const $writableDerivation = writableDerivationAsync(
378
+ // async (t) => (await $state.get(t)) * 2,
379
+ // );
380
+ // const onData = vi.fn();
381
+
382
+ // subscribe(
383
+ // (t) => $writableDerivation.get(t),
384
+ // (value) => {
385
+ // if (value === 4) {
386
+ // $writableDerivation.set(Promise.resolve(300));
387
+ // }
388
+ // onData(value);
389
+ // },
390
+ // );
391
+
392
+ // await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
393
+ // expect(onData).toHaveBeenLastCalledWith(2);
394
+
395
+ // $state.set(Promise.resolve(2));
396
+ // // Effect runs when dependency changes (value 4), set(300) is called in the effect
397
+ // // The set may not trigger another effect run in the same execution cycle
398
+ // await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
399
+ // expect(onData).toHaveBeenLastCalledWith(300);
400
+ // // Verify that set was applied
401
+ // expect(await $writableDerivation.pick()).toBe(300);
402
+ // });
403
+ });
404
+
405
+ describe("set and dependency changes", () => {
406
+ it("should handle dependency change then set", async () => {
407
+ const $state = stateAsync(Promise.resolve(1));
408
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
409
+ const onData = vi.fn();
410
+
411
+ subscribe((t) => $writableDerivation.get(t), onData);
412
+
413
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
414
+ expect(onData).toHaveBeenLastCalledWith(2);
415
+
416
+ $state.set(Promise.resolve(5));
417
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
418
+ expect(onData).toHaveBeenLastCalledWith(10);
419
+
420
+ $writableDerivation.set(Promise.resolve(400));
421
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
422
+ expect(onData).toHaveBeenLastCalledWith(400);
423
+ });
424
+
425
+ it("should handle set then dependency change", async () => {
426
+ const $state = stateAsync(Promise.resolve(1));
427
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
428
+ const onData = vi.fn();
429
+
430
+ subscribe((t) => $writableDerivation.get(t), onData);
431
+
432
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
433
+ expect(onData).toHaveBeenLastCalledWith(2);
434
+
435
+ $writableDerivation.set(Promise.resolve(500));
436
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
437
+ expect(onData).toHaveBeenLastCalledWith(500);
438
+
439
+ $state.set(Promise.resolve(10));
440
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
441
+ expect(onData).toHaveBeenLastCalledWith(20);
442
+ });
443
+
444
+ it("should handle set then dependency change then refresh", async () => {
445
+ const $state = stateAsync(Promise.resolve(1));
446
+ const $writableDerivation = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
447
+ const onData = vi.fn();
448
+
449
+ subscribe((t) => $writableDerivation.get(t), onData);
450
+
451
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
452
+ expect(onData).toHaveBeenLastCalledWith(2);
453
+
454
+ $writableDerivation.set(Promise.resolve(600));
455
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
456
+ expect(onData).toHaveBeenLastCalledWith(600);
457
+
458
+ $state.set(Promise.resolve(20));
459
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
460
+ expect(onData).toHaveBeenLastCalledWith(40);
461
+
462
+ $writableDerivation.refresh();
463
+ // Refresh may not trigger notification if value is same
464
+ await new Promise((resolve) => setTimeout(resolve, 50));
465
+ // Value should still be 40 after refresh
466
+ expect(await $writableDerivation.pick()).toBe(40);
467
+ });
468
+ });
469
+
470
+ describe("nested writable derivations", () => {
471
+ it("should work with writableDerivation depending on another writableDerivation", async () => {
472
+ const $state = stateAsync(Promise.resolve(1));
473
+ const $writableDerivation1 = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
474
+ const $writableDerivation2 = writableDerivationAsync(
475
+ async (t) => (await $writableDerivation1.get(t)) * 2,
476
+ );
477
+ const onData = vi.fn();
478
+
479
+ subscribe((t) => $writableDerivation2.get(t), onData);
480
+
481
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
482
+ expect(onData).toHaveBeenLastCalledWith(4);
483
+
484
+ $writableDerivation1.set(Promise.resolve(10));
485
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
486
+ expect(onData).toHaveBeenLastCalledWith(20);
487
+ });
488
+
489
+ it("should work with set on parent writableDerivation", async () => {
490
+ const $state = stateAsync(Promise.resolve(1));
491
+ const $writableDerivation1 = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
492
+ const $writableDerivation2 = writableDerivationAsync(
493
+ async (t) => (await $writableDerivation1.get(t)) * 2,
494
+ );
495
+ const onData = vi.fn();
496
+
497
+ subscribe((t) => $writableDerivation2.get(t), onData);
498
+
499
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
500
+ expect(onData).toHaveBeenLastCalledWith(4);
501
+
502
+ $writableDerivation1.set(Promise.resolve(50));
503
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
504
+ expect(onData).toHaveBeenLastCalledWith(100);
505
+ });
506
+
507
+ it("should work with set on child writableDerivation", async () => {
508
+ const $state = stateAsync(Promise.resolve(1));
509
+ const $writableDerivation1 = writableDerivationAsync(async (t) => (await $state.get(t)) * 2);
510
+ const $writableDerivation2 = writableDerivationAsync(
511
+ async (t) => (await $writableDerivation1.get(t)) * 2,
512
+ );
513
+ const onData1 = vi.fn();
514
+ const onData2 = vi.fn();
515
+
516
+ subscribe((t) => $writableDerivation1.get(t), onData1);
517
+ subscribe((t) => $writableDerivation2.get(t), onData2);
518
+
519
+ await vi.waitFor(() => {
520
+ expect(onData1).toHaveBeenCalledTimes(1);
521
+ expect(onData2).toHaveBeenCalledTimes(1);
522
+ });
523
+ expect(onData1).toHaveBeenLastCalledWith(2);
524
+ expect(onData2).toHaveBeenLastCalledWith(4);
525
+
526
+ $writableDerivation2.set(Promise.resolve(999));
527
+ await vi.waitFor(() => {
528
+ expect(onData1).toHaveBeenCalledTimes(1);
529
+ expect(onData2).toHaveBeenCalledTimes(3);
530
+ });
531
+ expect(onData2).toHaveBeenLastCalledWith(999);
532
+ });
533
+ });
534
+
535
+ describe("complex patterns with set", () => {
536
+ it("should handle diamond pattern with writableDerivations and set", async () => {
537
+ const $stateA = stateAsync(Promise.resolve(1));
538
+ const $aMult3 = writableDerivationAsync(async (t) => $stateA.get(t) * 3);
539
+ const $aMult2 = writableDerivationAsync(async (t) => $stateA.get(t) * 2);
540
+ const $addAmult3Amult2 = writableDerivationAsync(async (t) => $aMult3.get(t) + $aMult2.get(t));
541
+ const onData = vi.fn();
542
+
543
+ subscribe((t) => $addAmult3Amult2.get(t), onData);
544
+
545
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
546
+ expect(onData).toHaveBeenLastCalledWith(5);
547
+
548
+ $aMult3.set(Promise.resolve(100));
549
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
550
+ expect(onData).toHaveBeenLastCalledWith(102);
551
+ });
552
+
553
+ it("should handle writableDerivation with conditional dependencies and set", async () => {
554
+ const $state1 = stateAsync(Promise.resolve(1));
555
+ const $state2 = stateAsync(Promise.resolve(10));
556
+ const $cond = stateAsync(Promise.resolve(true));
557
+ const $writableDerivation = writableDerivationAsync(async (t) => {
558
+ await Promise.resolve();
559
+ if ($cond.get(t)) {
560
+ return $state1.get(t) * 2;
561
+ }
562
+ return $state2.get(t) * 2;
563
+ });
564
+ const onData = vi.fn();
565
+
566
+ subscribe((t) => $writableDerivation.get(t), onData);
567
+
568
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
569
+ expect(onData).toHaveBeenLastCalledWith(2);
570
+
571
+ $writableDerivation.set(Promise.resolve(777));
572
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
573
+ expect(onData).toHaveBeenLastCalledWith(777);
574
+
575
+ $cond.set(Promise.resolve(false));
576
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(4));
577
+ expect(onData).toHaveBeenLastCalledWith(20);
578
+ });
579
+
580
+ it("should handle set on writableDerivation in complex pattern", async () => {
581
+ const $stateA = stateAsync(Promise.resolve(1));
582
+ const $stateB = stateAsync(Promise.resolve(2));
583
+ const $addAB = writableDerivationAsync(async (t) => {
584
+ await Promise.resolve();
585
+ const a = $stateA.get(t);
586
+ const b = $stateB.get(t);
587
+ return a + b;
588
+ });
589
+ const $multiplyAB = writableDerivationAsync(async (t) => {
590
+ await Promise.resolve();
591
+ const a = $stateA.get(t);
592
+ const b = $stateB.get(t);
593
+ return a * b;
594
+ });
595
+ const $addAndMultiply = writableDerivationAsync(async (t) => {
596
+ await Promise.resolve();
597
+ const add = $addAB.get(t);
598
+ const multiply = $multiplyAB.get(t);
599
+ return add * multiply;
600
+ });
601
+ const onData = vi.fn();
602
+
603
+ subscribe((t) => $addAndMultiply.get(t), onData);
604
+
605
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
606
+ expect(onData).toHaveBeenLastCalledWith(6);
607
+
608
+ $addAB.set(Promise.resolve(100));
609
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
610
+ expect(onData).toHaveBeenLastCalledWith(200);
611
+ });
612
+ });
613
+ });
614
+ });