@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,341 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { state, subscribe } from "~";
3
+
4
+ describe("flowState", () => {
5
+ describe("unit", () => {
6
+ describe("initialization", () => {
7
+ it("should initialize with direct value", async () => {
8
+ const $state = state(1);
9
+ expect(await $state.pick()).toBe(1);
10
+ });
11
+ });
12
+
13
+ describe("set", () => {
14
+ it("should update value with direct value", async () => {
15
+ const $state = state(1);
16
+ expect(await $state.pick()).toBe(1);
17
+
18
+ $state.set(2);
19
+ expect(await $state.pick()).toBe(2);
20
+ });
21
+
22
+ it("should update value with updater function", async () => {
23
+ const $state = state(1);
24
+ expect(await $state.pick()).toBe(1);
25
+
26
+ $state.set((current) => (current !== undefined ? current + 1 : 0));
27
+ expect(await $state.pick()).toBe(2);
28
+ });
29
+
30
+ it("should not notify when set with same value", async () => {
31
+ const $state = state(1);
32
+ const onData = vi.fn();
33
+ $state.subscribe(onData);
34
+
35
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
36
+
37
+ $state.set(1);
38
+
39
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
40
+ });
41
+
42
+ it("should notify when set with different value", async () => {
43
+ const $state = state(1);
44
+ const onData = vi.fn();
45
+ $state.subscribe(onData);
46
+
47
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
48
+ expect(onData).toHaveBeenLastCalledWith(1);
49
+ $state.set(2);
50
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
51
+ expect(onData).toHaveBeenLastCalledWith(2);
52
+ });
53
+
54
+ it("should not notify when updater returns same value", async () => {
55
+ const $state = state(5);
56
+ const onData = vi.fn();
57
+ $state.subscribe(onData);
58
+
59
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
60
+
61
+ $state.set((current) => current ?? 0);
62
+
63
+ // Wait to ensure no additional calls
64
+ await new Promise((resolve) => setTimeout(resolve, 50));
65
+ expect(onData).toHaveBeenCalledTimes(1);
66
+ });
67
+
68
+ it("should notify when updater returns different value", async () => {
69
+ const $state = state(5);
70
+ const onData = vi.fn();
71
+ $state.subscribe(onData);
72
+
73
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
74
+
75
+ await $state.set((current) => (current ? current + 1 : 0));
76
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
77
+ expect(onData).toHaveBeenLastCalledWith(6);
78
+ });
79
+ });
80
+
81
+ describe("subscribe", () => {
82
+ it("should call onData immediately with current value", async () => {
83
+ const $state = state(55);
84
+ const onData = vi.fn();
85
+
86
+ $state.subscribe(onData);
87
+
88
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
89
+ expect(onData).toHaveBeenLastCalledWith(55);
90
+ });
91
+
92
+ it("should call onData when value is updated", async () => {
93
+ const $state = state(65);
94
+ const onData = vi.fn();
95
+
96
+ $state.subscribe(onData);
97
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
98
+
99
+ $state.set(70);
100
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
101
+ expect(onData).toHaveBeenLastCalledWith(70);
102
+ });
103
+
104
+ it("should not call onData when updated with same value", async () => {
105
+ const $state = state(75);
106
+ const onData = vi.fn();
107
+
108
+ $state.subscribe(onData);
109
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
110
+
111
+ $state.set(80);
112
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
113
+
114
+ $state.set(80);
115
+ await new Promise((resolve) => setTimeout(resolve, 50));
116
+ expect(onData).toHaveBeenCalledTimes(2);
117
+ });
118
+ });
119
+
120
+ describe("nesting", () => {
121
+ it("should handle nested states", async () => {
122
+ const $stateA = state(1);
123
+ const $stateB = state(2);
124
+ const $stateC = state({
125
+ a: $stateA,
126
+ b: $stateB,
127
+ });
128
+
129
+ const value = await $stateC.pick();
130
+ expect(value.a).toBe($stateA);
131
+ expect(value.b).toBe($stateB);
132
+ });
133
+
134
+ it("should handle state with complex object values", async () => {
135
+ const complexObj = {
136
+ nested: { deep: { value: 42 } },
137
+ array: [1, 2, 3],
138
+ };
139
+ const $state = state(complexObj);
140
+ const value = await $state.pick();
141
+ expect(value).toBe(complexObj);
142
+ expect(value.nested.deep.value).toBe(42);
143
+ expect(value.array).toEqual([1, 2, 3]);
144
+ });
145
+ });
146
+
147
+ describe("error handling", () => {
148
+ describe("disposed state", () => {
149
+ it("should throw error when set is called after disposal", async () => {
150
+ const $state = state(1);
151
+
152
+ await $state.pick();
153
+ await $state.set(2);
154
+ $state.dispose();
155
+
156
+ expect(() => $state.set(3)).toThrow("[PicoFlow] Primitive is disposed");
157
+ });
158
+
159
+ it("should throw error when trigger is called after disposal", () => {
160
+ const $state = state(1);
161
+ $state.dispose();
162
+ expect(() => $state.trigger()).toThrow("[PicoFlow] Primitive is disposed");
163
+ });
164
+ });
165
+ });
166
+ });
167
+
168
+ describe("with effect", () => {
169
+ describe("get", () => {
170
+ it("should call effect with initial value", async () => {
171
+ const $state = state(1);
172
+ const onData = vi.fn();
173
+ subscribe((t) => $state.get(t), onData);
174
+
175
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
176
+ expect(onData).toHaveBeenLastCalledWith(1);
177
+ });
178
+
179
+ it("should call effect when value is updated", async () => {
180
+ const $state = state(1);
181
+ const onData = vi.fn();
182
+ subscribe((t) => $state.get(t), onData);
183
+
184
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
185
+ expect(onData).toHaveBeenLastCalledWith(1);
186
+
187
+ $state.set(2);
188
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
189
+ expect(onData).toHaveBeenLastCalledWith(2);
190
+ });
191
+
192
+ it("should not call effect when updated with same value", async () => {
193
+ const $state = state(1);
194
+ const onData = vi.fn();
195
+ subscribe((t) => $state.get(t), onData);
196
+
197
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
198
+
199
+ $state.set(2);
200
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
201
+ expect(onData).toHaveBeenLastCalledWith(2);
202
+
203
+ $state.set(2);
204
+ await new Promise((resolve) => setTimeout(resolve, 50));
205
+ expect(onData).toHaveBeenCalledTimes(2);
206
+ });
207
+
208
+ it("should not call effect after effect is disposed", async () => {
209
+ const $state = state(1);
210
+ const onData = vi.fn();
211
+ const $effect = subscribe((t) => $state.get(t), onData);
212
+
213
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
214
+ expect(onData).toHaveBeenLastCalledWith(1);
215
+
216
+ $state.set(2);
217
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
218
+ expect(onData).toHaveBeenLastCalledWith(2);
219
+
220
+ $effect.dispose();
221
+
222
+ $state.set(3);
223
+ await new Promise((resolve) => setTimeout(resolve, 50));
224
+ expect(onData).toHaveBeenCalledTimes(2);
225
+ });
226
+
227
+ it("should support effect depending on multiple states", async () => {
228
+ const $stateA = state(5);
229
+ const $stateB = state(10);
230
+ const onData = vi.fn();
231
+
232
+ subscribe(
233
+ (t) => ({ a: $stateA.get(t), b: $stateB.get(t) }),
234
+ (data) => onData(data.a, data.b),
235
+ );
236
+
237
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
238
+ expect(onData).toHaveBeenLastCalledWith(5, 10);
239
+
240
+ $stateA.set(6);
241
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
242
+ expect(onData).toHaveBeenLastCalledWith(6, 10);
243
+
244
+ $stateB.set(11);
245
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
246
+ expect(onData).toHaveBeenLastCalledWith(6, 11);
247
+ });
248
+ });
249
+
250
+ describe("watch", () => {
251
+ it("should register dependency when watch is used in effect", async () => {
252
+ const $state = state(400);
253
+ const onData = vi.fn();
254
+
255
+ subscribe((t) => $state.watch(t), onData);
256
+
257
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
258
+ });
259
+
260
+ it("should trigger re-runs when state changes after watch", async () => {
261
+ const $state = state(500);
262
+ const onData = vi.fn();
263
+
264
+ subscribe((t) => $state.watch(t), onData);
265
+
266
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
267
+
268
+ await $state.set(600);
269
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
270
+ });
271
+ });
272
+
273
+ describe("error handling", () => {
274
+ describe("disposed state", () => {
275
+ it("should throw error when triggering a disposed state", () => {
276
+ const $state = state(1);
277
+
278
+ $state.dispose();
279
+
280
+ expect(() => $state.trigger()).toThrow("[PicoFlow] Primitive is disposed");
281
+ });
282
+
283
+ it("should throw error when setting a disposed state", () => {
284
+ const $state = state(1);
285
+
286
+ $state.dispose();
287
+
288
+ expect(() => $state.set(2)).toThrow("[PicoFlow] Primitive is disposed");
289
+ });
290
+ });
291
+ });
292
+
293
+ describe("complex cases", () => {
294
+ it("should handle nested states in effects", async () => {
295
+ const $stateA = state(1);
296
+ const $stateB = state(2);
297
+ const $stateC = state({
298
+ a: $stateA,
299
+ b: $stateB,
300
+ });
301
+
302
+ const onData = vi.fn();
303
+ subscribe((t) => $stateC.get(t).a.get(t), onData);
304
+
305
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
306
+ expect(onData).toHaveBeenLastCalledWith(1);
307
+
308
+ await $stateA.set(3);
309
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
310
+ expect(onData).toHaveBeenLastCalledWith(3);
311
+ });
312
+
313
+ it("should handle effect depending on multiple states", async () => {
314
+ const $stateA = state(10);
315
+ const $stateB = state(20);
316
+ const $stateC = state(30);
317
+ const onData = vi.fn();
318
+
319
+ subscribe(
320
+ (t) => ({
321
+ a: $stateA.get(t),
322
+ b: $stateB.get(t),
323
+ c: $stateC.get(t),
324
+ }),
325
+ (data) => onData(data.a, data.b, data.c),
326
+ );
327
+
328
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
329
+ expect(onData).toHaveBeenLastCalledWith(10, 20, 30);
330
+
331
+ $stateA.set(11);
332
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(2));
333
+ expect(onData).toHaveBeenLastCalledWith(11, 20, 30);
334
+
335
+ $stateB.set(21);
336
+ await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(3));
337
+ expect(onData).toHaveBeenLastCalledWith(11, 21, 30);
338
+ });
339
+ });
340
+ });
341
+ });