@ersbeth/picoflow 1.1.2 → 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 +856 -1530
  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 -57
  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 -148
  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,860 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
- import { constantAsync, effect, state } from "#package";
3
-
4
- describe("flowConstantAsync", () => {
5
- describe("unit", () => {
6
- describe("initialization", () => {
7
- it("should initialize with direct Promise", async () => {
8
- const $constant = constantAsync(Promise.resolve(1));
9
- expect(await $constant.pick()).toBe(1);
10
- });
11
-
12
- it("should initialize lazily with function", async () => {
13
- const initFn = vi.fn(() => Promise.resolve(42));
14
- const $constant = constantAsync(initFn);
15
-
16
- // Function should not be called yet
17
- expect(initFn).not.toHaveBeenCalled();
18
-
19
- // First access triggers initialization
20
- const value = await $constant.pick();
21
- expect(value).toBe(42);
22
- expect(initFn).toHaveBeenCalledTimes(1);
23
- });
24
-
25
- it("should not call lazy function on creation", () => {
26
- const initFn = vi.fn(() => Promise.resolve(100));
27
- constantAsync(initFn);
28
-
29
- expect(initFn).not.toHaveBeenCalled();
30
- });
31
-
32
- it("should call lazy function on first access", async () => {
33
- const initFn = vi.fn(() => Promise.resolve(200));
34
- const $constant = constantAsync(initFn);
35
-
36
- expect(initFn).not.toHaveBeenCalled();
37
- await $constant.pick();
38
- expect(initFn).toHaveBeenCalledTimes(1);
39
- });
40
-
41
- it("should call lazy function only once", async () => {
42
- const initFn = vi.fn(() => Promise.resolve(300));
43
- const $constant = constantAsync(initFn);
44
-
45
- // Multiple accesses should only call init once
46
- await $constant.pick();
47
- await $constant.pick();
48
- await $constant.pick();
49
-
50
- expect(initFn).toHaveBeenCalledTimes(1);
51
- });
52
-
53
- it("should call lazy function only once", async () => {
54
- const initFn = vi.fn(() => Promise.resolve(300));
55
- const $constant = constantAsync(initFn);
56
-
57
- // Multiple accesses should only call init once
58
- $constant.pick();
59
- $constant.pick();
60
- $constant.pick();
61
-
62
- await vi.waitFor(() => expect(initFn).toHaveBeenCalledTimes(1));
63
- });
64
-
65
- it("should cache Promise after lazy initialization", async () => {
66
- const initFn = vi.fn(() => Promise.resolve("cached"));
67
- const $constant = constantAsync(initFn);
68
-
69
- const value1 = await $constant.pick();
70
- const value2 = await $constant.pick();
71
- const value3 = await $constant.pick();
72
-
73
- expect(value1).toBe("cached");
74
- expect(value2).toBe("cached");
75
- expect(value3).toBe("cached");
76
- expect(initFn).toHaveBeenCalledTimes(1);
77
- });
78
-
79
- it("should handle number values", async () => {
80
- const $constant = constantAsync(Promise.resolve(42));
81
- expect(await $constant.pick()).toBe(42);
82
- });
83
-
84
- it("should handle string values", async () => {
85
- const $constant = constantAsync(Promise.resolve("hello"));
86
- expect(await $constant.pick()).toBe("hello");
87
- });
88
-
89
- it("should handle object values", async () => {
90
- const obj = { a: 1, b: 2 };
91
- const $constant = constantAsync(Promise.resolve(obj));
92
- const value = await $constant.pick();
93
- expect(value).toBe(obj);
94
- expect(value).toEqual({ a: 1, b: 2 });
95
- });
96
-
97
- it("should handle array values", async () => {
98
- const arr = [1, 2, 3];
99
- const $constant = constantAsync(Promise.resolve(arr));
100
- const value = await $constant.pick();
101
- expect(value).toBe(arr);
102
- expect(value).toEqual([1, 2, 3]);
103
- });
104
-
105
- it("should handle null values", async () => {
106
- const $constant = constantAsync(Promise.resolve(null));
107
- const value = await $constant.pick();
108
- expect(value).toBeNull();
109
- });
110
-
111
- it("should handle undefined values", async () => {
112
- const $constant = constantAsync(Promise.resolve(undefined));
113
- const value = await $constant.pick();
114
- expect(value).toBeUndefined();
115
- });
116
- });
117
-
118
- describe("get", () => {
119
- it("should return Promise with tracking context", async () => {
120
- const $constant = constantAsync(Promise.resolve(5));
121
- const $tracker = state(0); // Use state as FlowTracker
122
- const promise = $constant.get($tracker);
123
-
124
- expect(promise).toBeInstanceOf(Promise);
125
- const value = await promise;
126
- expect(value).toBe(5);
127
- });
128
-
129
- it("should compute lazy value on first get call", async () => {
130
- const initFn = vi.fn(() => Promise.resolve(10));
131
- const $constant = constantAsync(initFn);
132
- const $tracker = state(0);
133
-
134
- expect(initFn).not.toHaveBeenCalled();
135
- const promise = $constant.get($tracker);
136
- expect(promise).toBeInstanceOf(Promise);
137
- const value = await promise;
138
- expect(value).toBe(10);
139
- expect(initFn).toHaveBeenCalledTimes(1);
140
- });
141
-
142
- it("should return cached Promise on subsequent get calls", async () => {
143
- const initFn = vi.fn(() => Promise.resolve(20));
144
- const $constant = constantAsync(initFn);
145
- const $tracker = state(0);
146
-
147
- const promise1 = $constant.get($tracker);
148
- const promise2 = $constant.get($tracker);
149
- const promise3 = $constant.get($tracker);
150
-
151
- // All should be the same Promise instance (cached)
152
- // expect(promise 1).toBe(promise2);
153
- // expect(promise2).toBe(promise3);
154
-
155
- const value1 = await promise1;
156
- const value2 = await promise2;
157
- const value3 = await promise3;
158
-
159
- expect(value1).toBe(20);
160
- expect(value2).toBe(20);
161
- expect(value3).toBe(20);
162
- expect(initFn).toHaveBeenCalledTimes(1);
163
- });
164
-
165
- it("should await Promise to get value", async () => {
166
- const $constant = constantAsync(Promise.resolve(25));
167
- const $tracker = state(0);
168
-
169
- const promise = $constant.get($tracker);
170
- const value = await promise;
171
- expect(value).toBe(25);
172
- });
173
-
174
- it("should throw error when get is called after disposal", async () => {
175
- const $constant = constantAsync(Promise.resolve(1));
176
- const $tracker = state(0);
177
-
178
- await $constant.get($tracker);
179
- $constant.dispose();
180
-
181
- await expect($constant.get($tracker)).rejects.toThrow(
182
- "[PicoFlow] Primitive is disposed",
183
- );
184
- });
185
- });
186
-
187
- describe("pick", () => {
188
- it("should return Promise without tracking", async () => {
189
- const $constant = constantAsync(Promise.resolve(15));
190
- const promise = $constant.pick();
191
-
192
- expect(promise).toBeInstanceOf(Promise);
193
- const value = await promise;
194
- expect(value).toBe(15);
195
- });
196
-
197
- it("should compute lazy value on first pick call", async () => {
198
- const initFn = vi.fn(() => Promise.resolve(25));
199
- const $constant = constantAsync(initFn);
200
-
201
- expect(initFn).not.toHaveBeenCalled();
202
- const promise = $constant.pick();
203
- expect(promise).toBeInstanceOf(Promise);
204
- const value = await promise;
205
- expect(value).toBe(25);
206
- expect(initFn).toHaveBeenCalledTimes(1);
207
- });
208
-
209
- it("should return cached Promise on subsequent pick calls", async () => {
210
- const initFn = vi.fn(() => Promise.resolve(30));
211
- const $constant = constantAsync(initFn);
212
-
213
- const promise1 = $constant.pick();
214
- const promise2 = $constant.pick();
215
- const promise3 = $constant.pick();
216
-
217
- const value1 = await promise1;
218
- const value2 = await promise2;
219
- const value3 = await promise3;
220
-
221
- expect(value1).toBe(30);
222
- expect(value2).toBe(30);
223
- expect(value3).toBe(30);
224
- expect(initFn).toHaveBeenCalledTimes(1);
225
- });
226
-
227
- it("should await Promise to get value", async () => {
228
- const $constant = constantAsync(Promise.resolve(35));
229
- const value = await $constant.pick();
230
- expect(value).toBe(35);
231
- });
232
-
233
- it("should throw error when pick is called after disposal", async () => {
234
- const $constant = constantAsync(Promise.resolve(1));
235
-
236
- expect(await $constant.pick()).toBe(1);
237
-
238
- $constant.dispose();
239
-
240
- await expect($constant.pick()).rejects.toThrow(
241
- "[PicoFlow] Primitive is disposed",
242
- );
243
- });
244
- });
245
-
246
- describe("watch", () => {
247
- it("should register dependency when watch is called", () => {
248
- const $constant = constantAsync(Promise.resolve(35));
249
- const $tracker = state(0);
250
-
251
- expect(() => $constant.watch($tracker)).not.toThrow();
252
- });
253
-
254
- it("should compute lazy value when watch is called", async () => {
255
- const initFn = vi.fn(() => Promise.resolve(40));
256
- const $constant = constantAsync(initFn);
257
- const $tracker = state(0);
258
-
259
- expect(initFn).not.toHaveBeenCalled();
260
- $constant.watch($tracker);
261
- expect(initFn).toHaveBeenCalledTimes(1);
262
- });
263
-
264
- it("should throw error when watch is called after disposal", async () => {
265
- const $constant = constantAsync(Promise.resolve(1));
266
- const $tracker = state(0);
267
-
268
- await $constant.watch($tracker);
269
- $constant.dispose();
270
-
271
- await expect($constant.watch($tracker)).rejects.toThrow(
272
- "[PicoFlow] Primitive is disposed",
273
- );
274
- });
275
- });
276
-
277
- describe("subscribe", () => {
278
- it("should return a disposer function", () => {
279
- const $constant = constantAsync(Promise.resolve(50));
280
- const listener = vi.fn();
281
- const disposer = $constant.subscribe(listener);
282
-
283
- expect(typeof disposer).toBe("function");
284
- });
285
-
286
- it("should call listener immediately with Promise<T>", async () => {
287
- const $constant = constantAsync(Promise.resolve(55));
288
- const listener = vi.fn();
289
-
290
- $constant.subscribe(listener);
291
-
292
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
293
- expect(listener).toHaveBeenCalledTimes(1);
294
-
295
- // Listener receives Promise<T>, not T
296
- const receivedPromise = listener.mock.calls[0][0];
297
- expect(receivedPromise).toBeInstanceOf(Promise);
298
- const value = await receivedPromise;
299
- expect(value).toBe(55);
300
- });
301
-
302
- it("should require listener to await Promise to get value", async () => {
303
- const $constant = constantAsync(Promise.resolve(60));
304
- const listener = vi.fn(async (promise) => {
305
- const value = await promise;
306
- return value;
307
- });
308
-
309
- $constant.subscribe(listener);
310
-
311
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
312
- const result = await listener.mock.results[0].value;
313
- expect(result).toBe(60);
314
- });
315
-
316
- it("should not call listener after constant disposal", async () => {
317
- const $constant = constantAsync(Promise.resolve(65));
318
- const listener = vi.fn();
319
-
320
- $constant.subscribe(listener);
321
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
322
-
323
- $constant.dispose();
324
-
325
- // Wait to ensure listener is not called again
326
- await new Promise((resolve) => setTimeout(resolve, 50));
327
- expect(listener).toHaveBeenCalledTimes(1);
328
- });
329
-
330
- it("should not call listener after disposer is called", async () => {
331
- const $constant = constantAsync(Promise.resolve(70));
332
- const listener = vi.fn();
333
-
334
- const disposer = $constant.subscribe(listener);
335
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
336
-
337
- disposer();
338
-
339
- // Wait to ensure listener is not called again
340
- await new Promise((resolve) => setTimeout(resolve, 50));
341
- expect(listener).toHaveBeenCalledTimes(1);
342
- });
343
-
344
- it("should support multiple subscriptions", async () => {
345
- const $constant = constantAsync(Promise.resolve(75));
346
- const listener1 = vi.fn();
347
- const listener2 = vi.fn();
348
- const listener3 = vi.fn();
349
-
350
- $constant.subscribe(listener1);
351
- $constant.subscribe(listener2);
352
- $constant.subscribe(listener3);
353
-
354
- await vi.waitFor(() => {
355
- expect(listener1).toHaveBeenCalledTimes(1);
356
- expect(listener2).toHaveBeenCalledTimes(1);
357
- expect(listener3).toHaveBeenCalledTimes(1);
358
- });
359
-
360
- // All listeners receive the same Promise instance
361
- const promise1 = listener1.mock.calls[0][0];
362
- const promise2 = listener2.mock.calls[0][0];
363
- const promise3 = listener3.mock.calls[0][0];
364
-
365
- const value1 = await promise1;
366
- const value2 = await promise2;
367
- const value3 = await promise3;
368
- expect(value1).toBe(75);
369
- expect(value2).toBe(75);
370
- expect(value3).toBe(75);
371
- });
372
-
373
- it("should throw error when subscribe is called after disposal", () => {
374
- const $constant = constantAsync(Promise.resolve(1));
375
- const listener = vi.fn();
376
-
377
- $constant.dispose();
378
-
379
- expect(() => $constant.subscribe(listener)).toThrow(
380
- "[PicoFlow] Primitive is disposed",
381
- );
382
- });
383
- });
384
-
385
- describe("trigger", () => {
386
- it("should return a Promise", () => {
387
- const $constant = constantAsync(Promise.resolve(1));
388
- const result = $constant.trigger();
389
- expect(result).toBeInstanceOf(Promise);
390
- });
391
-
392
- it("should throw error when trigger is called after disposal", async () => {
393
- const $constant = constantAsync(Promise.resolve(1));
394
- $constant.dispose();
395
- await expect($constant.trigger()).rejects.toThrow(
396
- "[PicoFlow] Primitive is disposed",
397
- );
398
- });
399
-
400
- it("should allow multiple triggers", async () => {
401
- const $constant = constantAsync(Promise.resolve(1));
402
- const promise1 = $constant.trigger();
403
- const promise2 = $constant.trigger();
404
- const promise3 = $constant.trigger();
405
-
406
- expect(promise1).toBeInstanceOf(Promise);
407
- expect(promise2).toBeInstanceOf(Promise);
408
- expect(promise3).toBeInstanceOf(Promise);
409
-
410
- await Promise.all([promise1, promise2, promise3]);
411
- });
412
- });
413
-
414
- describe("disposal", () => {
415
- it("should have disposed property set to false initially", () => {
416
- const $constant = constantAsync(Promise.resolve(1));
417
- expect($constant.disposed).toBe(false);
418
- });
419
-
420
- it("should have disposed property set to true after disposal", () => {
421
- const $constant = constantAsync(Promise.resolve(1));
422
- $constant.dispose();
423
- expect($constant.disposed).toBe(true);
424
- });
425
-
426
- it("should throw error when disposed twice", () => {
427
- const $constant = constantAsync(Promise.resolve(1));
428
- $constant.dispose();
429
- expect(() => $constant.dispose()).toThrow(
430
- "[PicoFlow] Primitive is disposed",
431
- );
432
- });
433
-
434
- it("should accept self option without throwing", () => {
435
- const $constant = constantAsync(Promise.resolve(1));
436
- expect(() => $constant.dispose({ self: true })).not.toThrow();
437
- expect($constant.disposed).toBe(true);
438
- });
439
-
440
- it("should accept default options without throwing", () => {
441
- const $constant = constantAsync(Promise.resolve(1));
442
- expect(() => $constant.dispose()).not.toThrow();
443
- expect($constant.disposed).toBe(true);
444
- });
445
- });
446
-
447
- describe("special cases", () => {
448
- it("should handle lazy function using closure to capture values", async () => {
449
- let externalValue = 10;
450
- const $constant = constantAsync(() =>
451
- Promise.resolve(externalValue * 2),
452
- );
453
-
454
- const value1 = await $constant.pick();
455
- expect(value1).toBe(20);
456
-
457
- // Changing external value should not affect constant (it's cached)
458
- externalValue = 20;
459
- const value2 = await $constant.pick();
460
- expect(value2).toBe(20);
461
- });
462
-
463
- it("should handle Promise that rejects", async () => {
464
- const error = new Error("Promise rejected");
465
- const $constant = constantAsync(Promise.reject(error));
466
-
467
- await expect($constant.pick()).rejects.toThrow("Promise rejected");
468
- });
469
-
470
- it("should handle lazy function that rejects", async () => {
471
- const error = new Error("Lazy function rejected");
472
- const $constant = constantAsync(() => Promise.reject(error));
473
-
474
- await expect($constant.pick()).rejects.toThrow(
475
- "Lazy function rejected",
476
- );
477
- });
478
-
479
- it("should handle Promise that resolves to null", async () => {
480
- const $constant = constantAsync(Promise.resolve(null));
481
- const value = await $constant.pick();
482
- expect(value).toBeNull();
483
- });
484
-
485
- it("should handle Promise that resolves to undefined", async () => {
486
- const $constant = constantAsync(Promise.resolve(undefined));
487
- const value = await $constant.pick();
488
- expect(value).toBeUndefined();
489
- });
490
-
491
- it("should handle complex object values in Promise", async () => {
492
- const complexObj = {
493
- nested: { deep: { value: 42 } },
494
- array: [1, 2, 3],
495
- };
496
- const $constant = constantAsync(Promise.resolve(complexObj));
497
- const value = await $constant.pick();
498
- expect(value).toBe(complexObj);
499
- expect(value.nested.deep.value).toBe(42);
500
- expect(value.array).toEqual([1, 2, 3]);
501
- });
502
- });
503
-
504
- describe("error handling", () => {
505
- describe("compute function errors", () => {
506
- it("should propagate error when pick is called", async () => {
507
- const error = new Error("Compute error");
508
- const $constant = constantAsync(Promise.reject<never>(error));
509
-
510
- await expect($constant.pick()).rejects.toThrow("Compute error");
511
- });
512
-
513
- it("should propagate error when get is called with a rejecting Promise", async () => {
514
- const error = new Error("Get error");
515
- const $constant = constantAsync(Promise.reject<never>(error));
516
-
517
- await expect($constant.get(state(0))).rejects.toThrow("Get error");
518
- });
519
-
520
- it("should propagate error when get is called and lazy function rejects", async () => {
521
- const error = new Error("Lazy function rejected");
522
- const $constant = constantAsync(() => Promise.reject<never>(error));
523
-
524
- await expect($constant.get(state(0))).rejects.toThrow(
525
- "Lazy function rejected",
526
- );
527
- });
528
- });
529
-
530
- describe("disposed constant", () => {
531
- it("should throw error when pick is called after disposal", async () => {
532
- const $constant = constantAsync(Promise.resolve(1));
533
-
534
- $constant.dispose();
535
-
536
- await expect($constant.pick()).rejects.toThrow(
537
- "[PicoFlow] Primitive is disposed",
538
- );
539
- });
540
-
541
- it("should throw error when get is called after disposal", async () => {
542
- const $constant = constantAsync(Promise.resolve(1));
543
- const $tracker = state(0);
544
-
545
- await $constant.dispose();
546
-
547
- await expect($constant.get($tracker)).rejects.toThrow(
548
- "[PicoFlow] Primitive is disposed",
549
- );
550
- });
551
- });
552
- });
553
-
554
- describe("error handling", () => {
555
- describe("compute function errors", () => {
556
- it("should propagate error when used inside an async effect", async () => {
557
- const error = new Error("Effect compute error");
558
- const $constant = constantAsync(() => Promise.reject<never>(error));
559
-
560
- const $effect = effect(async (t) => {
561
- await $constant.get(t);
562
- });
563
-
564
- await expect($effect.settled).rejects.toThrow("Effect compute error");
565
- });
566
- });
567
-
568
- describe("disposed constant", () => {
569
- it("should throw error when creating an effect with a disposed async constant", async () => {
570
- const $constant = constantAsync(Promise.resolve(1));
571
-
572
- $constant.dispose();
573
-
574
- const $effect = effect(async (t) => {
575
- await $constant.get(t);
576
- });
577
-
578
- await expect($effect.settled).rejects.toThrow(
579
- "[PicoFlow] Primitive is disposed",
580
- );
581
- });
582
- });
583
- });
584
- });
585
-
586
- describe("with effect", () => {
587
- describe("get", () => {
588
- it("should create reactive dependency when get is used in effect", async () => {
589
- const $constant = constantAsync(Promise.resolve(100));
590
- const effectFn = vi.fn();
591
-
592
- effect(async (t) => {
593
- await $constant.get(t);
594
- effectFn();
595
- });
596
-
597
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
598
- });
599
-
600
- it("should call effect with initial value", async () => {
601
- const $constant = constantAsync(Promise.resolve(1));
602
- const effectFn = vi.fn();
603
- effect(async (t) => effectFn(await $constant.get(t)));
604
-
605
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
606
- expect(effectFn).toHaveBeenLastCalledWith(1);
607
- });
608
-
609
- it("should call effect with lazy init value", async () => {
610
- const $constant = constantAsync(() => Promise.resolve(1));
611
- const effectFn = vi.fn();
612
- effect(async (t) => effectFn(await $constant.get(t)));
613
-
614
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
615
- expect(effectFn).toHaveBeenLastCalledWith(1);
616
- });
617
-
618
- it("should await Promise returned by get() in effect", async () => {
619
- const $constant = constantAsync(Promise.resolve(200));
620
- const effectFn = vi.fn();
621
-
622
- effect(async (t) => {
623
- const promise = $constant.get(t);
624
- expect(promise).toBeInstanceOf(Promise);
625
- const value = await promise;
626
- effectFn(value);
627
- });
628
-
629
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
630
- expect(effectFn).toHaveBeenLastCalledWith(200);
631
- });
632
-
633
- it("should not re-execute effect when constant value does not change", async () => {
634
- const $constant = constantAsync(Promise.resolve(300));
635
- const effectFn = vi.fn();
636
-
637
- effect(async (t) => {
638
- await $constant.get(t);
639
- effectFn();
640
- });
641
-
642
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
643
-
644
- // Wait to ensure effect doesn't re-run (constant is immutable)
645
- await new Promise((resolve) => setTimeout(resolve, 50));
646
- expect(effectFn).toHaveBeenCalledTimes(1);
647
- });
648
-
649
- it("should not re-execute effect when async constant value is immutable (closure)", async () => {
650
- let capturedValue = 5;
651
- const $constant = constantAsync(() =>
652
- Promise.resolve(capturedValue * 3),
653
- );
654
-
655
- const effectFn = vi.fn();
656
- effect(async (t) => {
657
- const value = await $constant.get(t);
658
- effectFn(value);
659
- });
660
-
661
- // Initial execution with computed value (5 * 3 = 15)
662
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
663
- expect(effectFn).toHaveBeenLastCalledWith(15);
664
-
665
- // Change captured value - constant is cached, so effect should not re-run
666
- capturedValue = 10;
667
- await new Promise((resolve) => setTimeout(resolve, 50));
668
-
669
- // Effect should not re-run because constant is immutable and cached
670
- expect(effectFn).toHaveBeenCalledTimes(1);
671
- });
672
-
673
- it("should support multiple effects depending on same constant", async () => {
674
- const $constant = constantAsync(Promise.resolve(400));
675
- const effectFn1 = vi.fn();
676
- const effectFn2 = vi.fn();
677
- const effectFn3 = vi.fn();
678
-
679
- effect(async (t) => {
680
- await $constant.get(t);
681
- effectFn1();
682
- });
683
-
684
- effect(async (t) => {
685
- await $constant.get(t);
686
- effectFn2();
687
- });
688
-
689
- effect(async (t) => {
690
- await $constant.get(t);
691
- effectFn3();
692
- });
693
-
694
- await vi.waitFor(() => {
695
- expect(effectFn1).toHaveBeenCalledTimes(1);
696
- expect(effectFn2).toHaveBeenCalledTimes(1);
697
- expect(effectFn3).toHaveBeenCalledTimes(1);
698
- });
699
- });
700
-
701
- it("should support effect with tracked and untracked get mixed", async () => {
702
- const $constant1 = constantAsync(Promise.resolve(10));
703
- const $constant2 = constantAsync(Promise.resolve(20));
704
- const effectFn = vi.fn();
705
-
706
- effect(async (t) => {
707
- const tracked = await $constant1.get(t);
708
- const untracked = await $constant2.get(null);
709
- effectFn(tracked, untracked);
710
- });
711
-
712
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
713
- expect(effectFn).toHaveBeenLastCalledWith(10, 20);
714
- });
715
- });
716
-
717
- describe("watch", () => {
718
- it("should register dependency when watch is used in effect", async () => {
719
- const $constant = constantAsync(Promise.resolve(500));
720
- const effectFn = vi.fn();
721
-
722
- effect(async (t) => {
723
- $constant.watch(t);
724
- effectFn();
725
- });
726
-
727
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
728
- });
729
-
730
- it("should not trigger re-runs when constant is watched (immutable)", async () => {
731
- const $constant = constantAsync(Promise.resolve(600));
732
- const effectFn = vi.fn();
733
-
734
- effect(async (t) => {
735
- $constant.watch(t);
736
- effectFn();
737
- });
738
-
739
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
740
-
741
- // Wait to ensure effect doesn't re-run
742
- await new Promise((resolve) => setTimeout(resolve, 50));
743
- expect(effectFn).toHaveBeenCalledTimes(1);
744
- });
745
- });
746
-
747
- describe("subscribe", () => {
748
- it("should create effect internally when subscribe is used", async () => {
749
- const $constant = constantAsync(Promise.resolve(700));
750
- const listener = vi.fn();
751
-
752
- $constant.subscribe(listener);
753
-
754
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
755
- expect(listener).toHaveBeenCalledTimes(1);
756
-
757
- // Listener receives Promise<T>
758
- const receivedPromise = listener.mock.calls[0][0];
759
- expect(receivedPromise).toBeInstanceOf(Promise);
760
- });
761
-
762
- it("should require listener to await Promise", async () => {
763
- const $constant = constantAsync(Promise.resolve(800));
764
- const listener = vi.fn(async (promise) => {
765
- const value = await promise;
766
- expect(value).toBe(800);
767
- });
768
-
769
- $constant.subscribe(listener);
770
-
771
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
772
- });
773
-
774
- it("should support multiple subscriptions with effects", async () => {
775
- const $constant = constantAsync(Promise.resolve(900));
776
- const listener1 = vi.fn();
777
- const listener2 = vi.fn();
778
-
779
- $constant.subscribe(listener1);
780
- $constant.subscribe(listener2);
781
-
782
- await vi.waitFor(() => {
783
- expect(listener1).toHaveBeenCalledTimes(1);
784
- expect(listener2).toHaveBeenCalledTimes(1);
785
- });
786
- });
787
-
788
- it("should dispose effect when disposer is called", async () => {
789
- const $constant = constantAsync(Promise.resolve(1000));
790
- const listener = vi.fn();
791
-
792
- const unsubscribe = $constant.subscribe(listener);
793
- await vi.waitFor(() => expect(listener).toHaveBeenCalledTimes(1));
794
-
795
- unsubscribe();
796
-
797
- // Wait to ensure listener is not called again
798
- await new Promise((resolve) => setTimeout(resolve, 50));
799
- expect(listener).toHaveBeenCalledTimes(1);
800
- });
801
- });
802
-
803
- describe("disposal", () => {
804
- it("should dispose effects when constant is disposed", async () => {
805
- const $constant = constantAsync(Promise.resolve(1100));
806
- const effectFn = vi.fn();
807
- const $effect = effect(async (t) => {
808
- await $constant.get(t);
809
- effectFn();
810
- });
811
-
812
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
813
- expect($effect.disposed).toBe(false);
814
-
815
- $constant.dispose();
816
-
817
- expect($effect.disposed).toBe(true);
818
- });
819
-
820
- it("should not dispose effects when constant is disposed with self option", async () => {
821
- const $constant = constantAsync(Promise.resolve(1200));
822
- const effectFn = vi.fn();
823
- const $effect = effect(async (t) => {
824
- await $constant.get(t);
825
- effectFn();
826
- });
827
-
828
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
829
- expect($effect.disposed).toBe(false);
830
-
831
- $constant.dispose({ self: true });
832
-
833
- expect($effect.disposed).toBe(false);
834
- expect($constant.disposed).toBe(true);
835
- });
836
-
837
- it("should unregister effects when constant is disposed with self option", async () => {
838
- const $constant = constantAsync(Promise.resolve(1300));
839
- const effectFn = vi.fn();
840
- const $effect = effect(async (t) => {
841
- await $constant.get(t);
842
- effectFn();
843
- });
844
-
845
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
846
-
847
- $constant.dispose({ self: true });
848
-
849
- // Effect should still be active but not notified
850
- expect($effect.disposed).toBe(false);
851
-
852
- // But constant is disposed so operations should fail
853
- const $tracker = state(0);
854
- await expect($constant.get($tracker)).rejects.toThrow(
855
- "[PicoFlow] Primitive is disposed",
856
- );
857
- });
858
- });
859
- });
860
- });