@ersbeth/picoflow 1.1.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/.vscode/settings.json +3 -3
  2. package/CHANGELOG.md +43 -0
  3. package/README.md +2 -18
  4. package/biome.json +45 -35
  5. package/dist/picoflow.js +857 -1528
  6. package/dist/types/api/base/flowDisposable.d.ts +41 -0
  7. package/dist/types/api/base/flowDisposable.d.ts.map +1 -0
  8. package/dist/types/api/base/flowObservable.d.ts +27 -0
  9. package/dist/types/api/base/flowObservable.d.ts.map +1 -0
  10. package/dist/types/api/base/flowSubscribable.d.ts +79 -0
  11. package/dist/types/api/base/flowSubscribable.d.ts.map +1 -0
  12. package/dist/types/api/base/flowTracker.d.ts +8 -0
  13. package/dist/types/api/base/flowTracker.d.ts.map +1 -0
  14. package/dist/types/api/base/index.d.ts +5 -0
  15. package/dist/types/api/base/index.d.ts.map +1 -0
  16. package/dist/types/api/index.d.ts +3 -0
  17. package/dist/types/api/index.d.ts.map +1 -0
  18. package/dist/types/api/nodes/async/flowConstantAsync.d.ts +31 -0
  19. package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map +1 -0
  20. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts +37 -0
  21. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map +1 -0
  22. package/dist/types/api/nodes/async/flowStateAsync.d.ts +41 -0
  23. package/dist/types/api/nodes/async/flowStateAsync.d.ts.map +1 -0
  24. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts +30 -0
  25. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts.map +1 -0
  26. package/dist/types/{flow → api}/nodes/async/index.d.ts +1 -2
  27. package/dist/types/api/nodes/async/index.d.ts.map +1 -0
  28. package/dist/types/api/nodes/collections/flowArray.d.ts +134 -0
  29. package/dist/types/api/nodes/collections/flowArray.d.ts.map +1 -0
  30. package/dist/types/api/nodes/collections/flowMap.d.ts +98 -0
  31. package/dist/types/api/nodes/collections/flowMap.d.ts.map +1 -0
  32. package/dist/types/api/nodes/collections/index.d.ts.map +1 -0
  33. package/dist/types/api/nodes/flowEffect.d.ts +28 -0
  34. package/dist/types/api/nodes/flowEffect.d.ts.map +1 -0
  35. package/dist/types/api/nodes/flowSignal.d.ts +25 -0
  36. package/dist/types/api/nodes/flowSignal.d.ts.map +1 -0
  37. package/dist/types/api/nodes/flowValue.d.ts +35 -0
  38. package/dist/types/api/nodes/flowValue.d.ts.map +1 -0
  39. package/dist/types/api/nodes/index.d.ts +8 -0
  40. package/dist/types/api/nodes/index.d.ts.map +1 -0
  41. package/dist/types/api/nodes/sync/flowConstant.d.ts +29 -0
  42. package/dist/types/api/nodes/sync/flowConstant.d.ts.map +1 -0
  43. package/dist/types/api/nodes/sync/flowDerivation.d.ts +36 -0
  44. package/dist/types/api/nodes/sync/flowDerivation.d.ts.map +1 -0
  45. package/dist/types/api/nodes/sync/flowState.d.ts +39 -0
  46. package/dist/types/api/nodes/sync/flowState.d.ts.map +1 -0
  47. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts +28 -0
  48. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts.map +1 -0
  49. package/dist/types/{flow → api}/nodes/sync/index.d.ts +1 -2
  50. package/dist/types/api/nodes/sync/index.d.ts.map +1 -0
  51. package/dist/types/api/nodes/utils.d.ts +22 -0
  52. package/dist/types/api/nodes/utils.d.ts.map +1 -0
  53. package/dist/types/base/disposable.d.ts +11 -0
  54. package/dist/types/base/disposable.d.ts.map +1 -0
  55. package/dist/types/base/executionStack.d.ts +14 -0
  56. package/dist/types/base/executionStack.d.ts.map +1 -0
  57. package/dist/types/base/index.d.ts +6 -0
  58. package/dist/types/base/index.d.ts.map +1 -0
  59. package/dist/types/base/node.d.ts +27 -0
  60. package/dist/types/base/node.d.ts.map +1 -0
  61. package/dist/types/base/observable.d.ts +37 -0
  62. package/dist/types/base/observable.d.ts.map +1 -0
  63. package/dist/types/base/observer.d.ts +25 -0
  64. package/dist/types/base/observer.d.ts.map +1 -0
  65. package/dist/types/converters/index.d.ts +2 -0
  66. package/dist/types/converters/index.d.ts.map +1 -0
  67. package/dist/types/converters/solid.d.ts +46 -0
  68. package/dist/types/converters/solid.d.ts.map +1 -0
  69. package/dist/types/index.d.ts +2 -63
  70. package/dist/types/index.d.ts.map +1 -1
  71. package/dist/types/nodes/arrayNode.d.ts +2 -0
  72. package/dist/types/nodes/arrayNode.d.ts.map +1 -0
  73. package/dist/types/nodes/effectNode.d.ts +2 -0
  74. package/dist/types/nodes/effectNode.d.ts.map +1 -0
  75. package/dist/types/nodes/index.d.ts +9 -0
  76. package/dist/types/nodes/index.d.ts.map +1 -0
  77. package/dist/types/nodes/mapNode.d.ts +2 -0
  78. package/dist/types/nodes/mapNode.d.ts.map +1 -0
  79. package/dist/types/nodes/signalNode.d.ts +2 -0
  80. package/dist/types/nodes/signalNode.d.ts.map +1 -0
  81. package/dist/types/nodes/valueAsyncNode.d.ts +2 -0
  82. package/dist/types/nodes/valueAsyncNode.d.ts.map +1 -0
  83. package/dist/types/nodes/valueNode.d.ts +2 -0
  84. package/dist/types/nodes/valueNode.d.ts.map +1 -0
  85. package/dist/types/nodes/valueSyncNode.d.ts +2 -0
  86. package/dist/types/nodes/valueSyncNode.d.ts.map +1 -0
  87. package/dist/types/schedulers/asyncResolver.d.ts +2 -0
  88. package/dist/types/schedulers/asyncResolver.d.ts.map +1 -0
  89. package/dist/types/schedulers/asyncScheduler.d.ts +2 -0
  90. package/dist/types/schedulers/asyncScheduler.d.ts.map +1 -0
  91. package/dist/types/schedulers/index.d.ts +5 -0
  92. package/dist/types/schedulers/index.d.ts.map +1 -0
  93. package/dist/types/schedulers/pendingError.d.ts +2 -0
  94. package/dist/types/schedulers/pendingError.d.ts.map +1 -0
  95. package/dist/types/schedulers/scheduler.d.ts +2 -0
  96. package/dist/types/schedulers/scheduler.d.ts.map +1 -0
  97. package/dist/types/schedulers/syncResolver.d.ts +2 -0
  98. package/dist/types/schedulers/syncResolver.d.ts.map +1 -0
  99. package/dist/types/schedulers/syncScheduler.d.ts +2 -0
  100. package/dist/types/schedulers/syncScheduler.d.ts.map +1 -0
  101. package/docs/.vitepress/config.mts +128 -93
  102. package/docs/api/functions/array.md +14 -37
  103. package/docs/api/functions/constant.md +13 -25
  104. package/docs/api/functions/constantAsync.md +69 -0
  105. package/docs/api/functions/derivation.md +14 -33
  106. package/docs/api/functions/derivationAsync.md +34 -0
  107. package/docs/api/functions/from.md +62 -153
  108. package/docs/api/functions/isDisposable.md +8 -30
  109. package/docs/api/functions/map.md +15 -36
  110. package/docs/api/functions/signal.md +8 -23
  111. package/docs/api/functions/state.md +43 -23
  112. package/docs/api/functions/stateAsync.md +69 -0
  113. package/docs/api/functions/subscribe.md +40 -0
  114. package/docs/api/functions/writableDerivation.md +33 -0
  115. package/docs/api/functions/writableDerivationAsync.md +34 -0
  116. package/docs/api/index.md +45 -102
  117. package/docs/api/interfaces/FlowArray.md +439 -0
  118. package/docs/api/interfaces/FlowConstant.md +220 -0
  119. package/docs/api/interfaces/FlowConstantAsync.md +221 -0
  120. package/docs/api/interfaces/FlowDerivation.md +241 -0
  121. package/docs/api/interfaces/FlowDerivationAsync.md +242 -0
  122. package/docs/api/interfaces/FlowDisposable.md +32 -38
  123. package/docs/api/interfaces/FlowEffect.md +64 -0
  124. package/docs/api/interfaces/FlowMap.md +374 -0
  125. package/docs/api/interfaces/FlowObservable.md +155 -0
  126. package/docs/api/interfaces/FlowSignal.md +156 -0
  127. package/docs/api/interfaces/FlowState.md +269 -0
  128. package/docs/api/interfaces/FlowStateAsync.md +268 -0
  129. package/docs/api/interfaces/FlowSubscribable.md +55 -0
  130. package/docs/api/interfaces/FlowTracker.md +61 -0
  131. package/docs/api/interfaces/FlowValue.md +222 -0
  132. package/docs/api/interfaces/FlowWritableDerivation.md +292 -0
  133. package/docs/api/interfaces/FlowWritableDerivationAsync.md +293 -0
  134. package/docs/api/type-aliases/DerivationFunction.md +28 -0
  135. package/docs/api/type-aliases/DerivationFunctionAsync.md +28 -0
  136. package/docs/api/type-aliases/FlowArrayAction.md +19 -8
  137. package/docs/api/type-aliases/FlowDataTracker.md +33 -0
  138. package/docs/api/type-aliases/FlowMapAction.md +48 -0
  139. package/docs/api/type-aliases/FlowOnDataListener.md +33 -0
  140. package/docs/api/type-aliases/FlowOnErrorListener.md +27 -0
  141. package/docs/api/type-aliases/FlowOnPendingListener.md +21 -0
  142. package/docs/api/type-aliases/FlowReadonly.md +22 -0
  143. package/docs/api/type-aliases/InitFunction.md +21 -0
  144. package/docs/api/type-aliases/InitFunctionAsync.md +21 -0
  145. package/docs/api/type-aliases/NotPromise.md +6 -3
  146. package/docs/api/type-aliases/UpdateFunction.md +27 -0
  147. package/docs/api/type-aliases/UpdateFunctionAsync.md +27 -0
  148. package/docs/api/typedoc-sidebar.json +1 -81
  149. package/docs/examples/examples.md +0 -2
  150. package/docs/guide/advanced/architecture.md +1234 -0
  151. package/docs/guide/advanced/migration-v2.md +204 -0
  152. package/docs/guide/advanced/solidjs.md +2 -88
  153. package/docs/guide/introduction/concepts.md +4 -3
  154. package/docs/guide/introduction/conventions.md +2 -33
  155. package/docs/guide/introduction/getting-started.md +28 -23
  156. package/docs/guide/introduction/lifecycle.md +16 -19
  157. package/docs/guide/primitives/array.md +102 -216
  158. package/docs/guide/primitives/constant.md +39 -212
  159. package/docs/guide/primitives/derivations.md +55 -122
  160. package/docs/guide/primitives/effects.md +155 -241
  161. package/docs/guide/primitives/map.md +64 -186
  162. package/docs/guide/primitives/overview.md +45 -128
  163. package/docs/guide/primitives/signal.md +51 -88
  164. package/docs/guide/primitives/state.md +34 -130
  165. package/package.json +56 -60
  166. package/src/api/base/flowDisposable.ts +44 -0
  167. package/src/api/base/flowObservable.ts +28 -0
  168. package/src/api/base/flowSubscribable.ts +87 -0
  169. package/src/api/base/flowTracker.ts +7 -0
  170. package/src/api/base/index.ts +4 -0
  171. package/src/{flow → api}/index.ts +0 -1
  172. package/src/api/nodes/async/flowConstantAsync.ts +36 -0
  173. package/src/api/nodes/async/flowDerivationAsync.ts +42 -0
  174. package/src/api/nodes/async/flowStateAsync.ts +47 -0
  175. package/src/api/nodes/async/flowWritableDerivationAsync.ts +33 -0
  176. package/src/{flow → api}/nodes/async/index.ts +1 -2
  177. package/src/api/nodes/collections/flowArray.ts +155 -0
  178. package/src/api/nodes/collections/flowMap.ts +115 -0
  179. package/src/api/nodes/flowEffect.ts +42 -0
  180. package/src/api/nodes/flowSignal.ts +28 -0
  181. package/src/api/nodes/flowValue.ts +36 -0
  182. package/src/api/nodes/index.ts +7 -0
  183. package/src/api/nodes/sync/flowConstant.ts +33 -0
  184. package/src/api/nodes/sync/flowDerivation.ts +41 -0
  185. package/src/api/nodes/sync/flowState.ts +45 -0
  186. package/src/api/nodes/sync/flowWritableDerivation.ts +31 -0
  187. package/src/{flow → api}/nodes/sync/index.ts +1 -2
  188. package/src/api/nodes/utils.ts +22 -0
  189. package/src/base/disposable.ts +18 -0
  190. package/src/base/executionStack.ts +42 -0
  191. package/src/base/index.ts +5 -0
  192. package/src/base/node.ts +98 -0
  193. package/src/base/observable.ts +87 -0
  194. package/src/base/observer.ts +51 -0
  195. package/src/converters/index.ts +1 -0
  196. package/src/converters/solid.ts +109 -0
  197. package/src/index.ts +2 -64
  198. package/src/nodes/arrayNode.ts +172 -0
  199. package/src/nodes/effectNode.ts +59 -0
  200. package/src/nodes/index.ts +8 -0
  201. package/src/nodes/mapNode.ts +127 -0
  202. package/src/nodes/signalNode.ts +21 -0
  203. package/src/nodes/valueAsyncNode.ts +88 -0
  204. package/src/nodes/valueNode.ts +144 -0
  205. package/src/nodes/valueSyncNode.ts +128 -0
  206. package/src/schedulers/asyncResolver.ts +78 -0
  207. package/src/schedulers/asyncScheduler.ts +66 -0
  208. package/src/schedulers/index.ts +4 -0
  209. package/src/schedulers/pendingError.ts +13 -0
  210. package/src/schedulers/scheduler.ts +9 -0
  211. package/src/schedulers/syncResolver.ts +69 -0
  212. package/src/schedulers/syncScheduler.ts +55 -0
  213. package/test/base/pendingError.test.ts +67 -0
  214. package/test/converters/solid.derivation.browser.test.tsx +69 -0
  215. package/test/converters/solid.node.test.ts +654 -0
  216. package/test/converters/solid.state.browser.test.tsx +1592 -0
  217. package/test/reactivity/flowSignal.test.ts +226 -0
  218. package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +593 -0
  219. package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +317 -0
  220. package/test/reactivity/nodes/async/flowConstantAsync.test.ts +652 -0
  221. package/test/reactivity/nodes/async/flowDerivation.test.ts +898 -0
  222. package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +1716 -0
  223. package/test/reactivity/nodes/async/flowStateAsync.test.ts +708 -0
  224. package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +614 -0
  225. package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +1289 -0
  226. package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +961 -0
  227. package/test/reactivity/nodes/collections/flowArray.states.test.ts +1035 -0
  228. package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +960 -0
  229. package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +775 -0
  230. package/test/reactivity/nodes/collections/flowMap.states.test.ts +958 -0
  231. package/test/reactivity/nodes/sync/flowConstant.test.ts +377 -0
  232. package/test/reactivity/nodes/sync/flowDerivation.test.ts +896 -0
  233. package/test/reactivity/nodes/sync/flowState.test.ts +341 -0
  234. package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +603 -0
  235. package/test/vitest.d.ts +10 -0
  236. package/tsconfig.json +31 -20
  237. package/typedoc.json +35 -35
  238. package/vite.config.ts +25 -23
  239. package/vitest.browser.config.ts +21 -0
  240. package/vitest.config.ts +12 -12
  241. package/.cursor/plans/unifier-flowresource-avec-flowderivation-c9506e24.plan.md +0 -372
  242. package/.cursor/plans/update-js-e795d61b.plan.md +0 -567
  243. package/dist/types/flow/base/flowDisposable.d.ts +0 -67
  244. package/dist/types/flow/base/flowDisposable.d.ts.map +0 -1
  245. package/dist/types/flow/base/flowEffect.d.ts +0 -127
  246. package/dist/types/flow/base/flowEffect.d.ts.map +0 -1
  247. package/dist/types/flow/base/flowGraph.d.ts +0 -97
  248. package/dist/types/flow/base/flowGraph.d.ts.map +0 -1
  249. package/dist/types/flow/base/flowSignal.d.ts +0 -134
  250. package/dist/types/flow/base/flowSignal.d.ts.map +0 -1
  251. package/dist/types/flow/base/flowTracker.d.ts +0 -15
  252. package/dist/types/flow/base/flowTracker.d.ts.map +0 -1
  253. package/dist/types/flow/base/index.d.ts +0 -7
  254. package/dist/types/flow/base/index.d.ts.map +0 -1
  255. package/dist/types/flow/base/utils.d.ts +0 -20
  256. package/dist/types/flow/base/utils.d.ts.map +0 -1
  257. package/dist/types/flow/collections/flowArray.d.ts +0 -148
  258. package/dist/types/flow/collections/flowArray.d.ts.map +0 -1
  259. package/dist/types/flow/collections/flowMap.d.ts +0 -224
  260. package/dist/types/flow/collections/flowMap.d.ts.map +0 -1
  261. package/dist/types/flow/collections/index.d.ts.map +0 -1
  262. package/dist/types/flow/index.d.ts +0 -4
  263. package/dist/types/flow/index.d.ts.map +0 -1
  264. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts +0 -137
  265. package/dist/types/flow/nodes/async/flowConstantAsync.d.ts.map +0 -1
  266. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts +0 -137
  267. package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts.map +0 -1
  268. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts +0 -343
  269. package/dist/types/flow/nodes/async/flowNodeAsync.d.ts.map +0 -1
  270. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts +0 -81
  271. package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts.map +0 -1
  272. package/dist/types/flow/nodes/async/flowStateAsync.d.ts +0 -111
  273. package/dist/types/flow/nodes/async/flowStateAsync.d.ts.map +0 -1
  274. package/dist/types/flow/nodes/async/index.d.ts.map +0 -1
  275. package/dist/types/flow/nodes/index.d.ts +0 -3
  276. package/dist/types/flow/nodes/index.d.ts.map +0 -1
  277. package/dist/types/flow/nodes/sync/flowConstant.d.ts +0 -108
  278. package/dist/types/flow/nodes/sync/flowConstant.d.ts.map +0 -1
  279. package/dist/types/flow/nodes/sync/flowDerivation.d.ts +0 -100
  280. package/dist/types/flow/nodes/sync/flowDerivation.d.ts.map +0 -1
  281. package/dist/types/flow/nodes/sync/flowNode.d.ts +0 -314
  282. package/dist/types/flow/nodes/sync/flowNode.d.ts.map +0 -1
  283. package/dist/types/flow/nodes/sync/flowReadonly.d.ts +0 -57
  284. package/dist/types/flow/nodes/sync/flowReadonly.d.ts.map +0 -1
  285. package/dist/types/flow/nodes/sync/flowState.d.ts +0 -96
  286. package/dist/types/flow/nodes/sync/flowState.d.ts.map +0 -1
  287. package/dist/types/flow/nodes/sync/index.d.ts.map +0 -1
  288. package/dist/types/solid/converters.d.ts +0 -53
  289. package/dist/types/solid/converters.d.ts.map +0 -1
  290. package/dist/types/solid/index.d.ts +0 -3
  291. package/dist/types/solid/index.d.ts.map +0 -1
  292. package/dist/types/solid/primitives.d.ts +0 -181
  293. package/dist/types/solid/primitives.d.ts.map +0 -1
  294. package/docs/api/classes/FlowArray.md +0 -489
  295. package/docs/api/classes/FlowConstant.md +0 -350
  296. package/docs/api/classes/FlowDerivation.md +0 -334
  297. package/docs/api/classes/FlowEffect.md +0 -100
  298. package/docs/api/classes/FlowMap.md +0 -512
  299. package/docs/api/classes/FlowObservable.md +0 -306
  300. package/docs/api/classes/FlowResource.md +0 -380
  301. package/docs/api/classes/FlowResourceAsync.md +0 -362
  302. package/docs/api/classes/FlowSignal.md +0 -160
  303. package/docs/api/classes/FlowState.md +0 -368
  304. package/docs/api/classes/FlowStream.md +0 -367
  305. package/docs/api/classes/FlowStreamAsync.md +0 -364
  306. package/docs/api/classes/SolidDerivation.md +0 -75
  307. package/docs/api/classes/SolidResource.md +0 -91
  308. package/docs/api/classes/SolidState.md +0 -71
  309. package/docs/api/classes/TrackingContext.md +0 -33
  310. package/docs/api/functions/effect.md +0 -49
  311. package/docs/api/functions/resource.md +0 -52
  312. package/docs/api/functions/resourceAsync.md +0 -50
  313. package/docs/api/functions/stream.md +0 -53
  314. package/docs/api/functions/streamAsync.md +0 -50
  315. package/docs/api/interfaces/SolidObservable.md +0 -19
  316. package/docs/api/type-aliases/FlowStreamDisposer.md +0 -15
  317. package/docs/api/type-aliases/FlowStreamSetter.md +0 -27
  318. package/docs/api/type-aliases/FlowStreamUpdater.md +0 -32
  319. package/docs/api/type-aliases/SolidGetter.md +0 -17
  320. package/docs/guide/primitives/resources.md +0 -858
  321. package/docs/guide/primitives/streams.md +0 -931
  322. package/src/flow/base/flowDisposable.ts +0 -71
  323. package/src/flow/base/flowEffect.ts +0 -171
  324. package/src/flow/base/flowGraph.ts +0 -288
  325. package/src/flow/base/flowSignal.ts +0 -207
  326. package/src/flow/base/flowTracker.ts +0 -17
  327. package/src/flow/base/index.ts +0 -6
  328. package/src/flow/base/utils.ts +0 -19
  329. package/src/flow/collections/flowArray.ts +0 -409
  330. package/src/flow/collections/flowMap.ts +0 -398
  331. package/src/flow/nodes/async/flowConstantAsync.ts +0 -142
  332. package/src/flow/nodes/async/flowDerivationAsync.ts +0 -143
  333. package/src/flow/nodes/async/flowNodeAsync.ts +0 -474
  334. package/src/flow/nodes/async/flowReadonlyAsync.ts +0 -81
  335. package/src/flow/nodes/async/flowStateAsync.ts +0 -116
  336. package/src/flow/nodes/await/advanced/index.ts +0 -5
  337. package/src/flow/nodes/await/advanced/resource.ts +0 -134
  338. package/src/flow/nodes/await/advanced/resourceAsync.ts +0 -109
  339. package/src/flow/nodes/await/advanced/stream.ts +0 -188
  340. package/src/flow/nodes/await/advanced/streamAsync.ts +0 -176
  341. package/src/flow/nodes/await/flowConstantAwait.ts +0 -154
  342. package/src/flow/nodes/await/flowDerivationAwait.ts +0 -154
  343. package/src/flow/nodes/await/flowNodeAwait.ts +0 -508
  344. package/src/flow/nodes/await/flowReadonlyAwait.ts +0 -89
  345. package/src/flow/nodes/await/flowStateAwait.ts +0 -130
  346. package/src/flow/nodes/await/index.ts +0 -5
  347. package/src/flow/nodes/index.ts +0 -3
  348. package/src/flow/nodes/sync/flowConstant.ts +0 -111
  349. package/src/flow/nodes/sync/flowDerivation.ts +0 -105
  350. package/src/flow/nodes/sync/flowNode.ts +0 -439
  351. package/src/flow/nodes/sync/flowReadonly.ts +0 -57
  352. package/src/flow/nodes/sync/flowState.ts +0 -101
  353. package/src/solid/converters.ts +0 -139
  354. package/src/solid/index.ts +0 -2
  355. package/src/solid/primitives.ts +0 -215
  356. package/test/base/flowEffect.test.ts +0 -108
  357. package/test/base/flowGraph.test.ts +0 -485
  358. package/test/base/flowSignal.test.ts +0 -372
  359. package/test/collections/flowArray.asyncStates.test.ts +0 -1553
  360. package/test/collections/flowArray.scalars.test.ts +0 -1129
  361. package/test/collections/flowArray.states.test.ts +0 -1365
  362. package/test/collections/flowMap.asyncStates.test.ts +0 -1105
  363. package/test/collections/flowMap.scalars.test.ts +0 -877
  364. package/test/collections/flowMap.states.test.ts +0 -1097
  365. package/test/nodes/async/flowConstantAsync.test.ts +0 -860
  366. package/test/nodes/async/flowDerivationAsync.test.ts +0 -1517
  367. package/test/nodes/async/flowStateAsync.test.ts +0 -1387
  368. package/test/nodes/await/advanced/resource.test.ts +0 -129
  369. package/test/nodes/await/advanced/resourceAsync.test.ts +0 -108
  370. package/test/nodes/await/advanced/stream.test.ts +0 -198
  371. package/test/nodes/await/advanced/streamAsync.test.ts +0 -196
  372. package/test/nodes/await/flowConstantAwait.test.ts +0 -643
  373. package/test/nodes/await/flowDerivationAwait.test.ts +0 -1583
  374. package/test/nodes/await/flowStateAwait.test.ts +0 -999
  375. package/test/nodes/mixed/derivation.test.ts +0 -1527
  376. package/test/nodes/sync/flowConstant.test.ts +0 -620
  377. package/test/nodes/sync/flowDerivation.test.ts +0 -1373
  378. package/test/nodes/sync/flowState.test.ts +0 -945
  379. package/test/solid/converters.test.ts +0 -721
  380. package/test/solid/primitives.test.ts +0 -1031
  381. /package/dist/types/{flow → api/nodes}/collections/index.d.ts +0 -0
  382. /package/docs/guide/advanced/{upgrading.md → migration-v1.md} +0 -0
  383. /package/src/{flow → api/nodes}/collections/index.ts +0 -0
@@ -1,372 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
- import { effect, signal } from "#package";
3
-
4
- describe("FlowSignal", () => {
5
- describe("unit", () => {
6
- describe("disposal", () => {
7
- it("should have disposed property set to false initially and true after disposal", () => {
8
- const $signal = signal();
9
- expect($signal.disposed).toBe(false);
10
- $signal.dispose();
11
- expect($signal.disposed).toBe(true);
12
- });
13
-
14
- it("should throw error when disposed twice", () => {
15
- const $signal = signal();
16
- $signal.dispose();
17
- expect(() => $signal.dispose()).toThrow(
18
- "[PicoFlow] Primitive is disposed",
19
- );
20
- });
21
-
22
- it("should dispose signal successfully", () => {
23
- const $signal = signal();
24
- expect(() => $signal.dispose()).not.toThrow();
25
- expect($signal.disposed).toBe(true);
26
- });
27
-
28
- it("should accept self option without throwing", () => {
29
- const $signal = signal();
30
- expect(() => $signal.dispose({ self: true })).not.toThrow();
31
- expect($signal.disposed).toBe(true);
32
- });
33
-
34
- it("should accept default options without throwing", () => {
35
- const $signal = signal();
36
- expect(() => $signal.dispose()).not.toThrow();
37
- expect($signal.disposed).toBe(true);
38
- });
39
- });
40
-
41
- describe("trigger", () => {
42
- it("should return a promise when triggered", () => {
43
- const $signal = signal();
44
- const result = $signal.trigger();
45
- expect(result).toBeInstanceOf(Promise);
46
- });
47
-
48
- it("should throw error when trigger is called after disposal", async () => {
49
- const $signal = signal();
50
- $signal.dispose();
51
- await expect($signal.trigger()).rejects.toThrow(
52
- "[PicoFlow] Primitive is disposed",
53
- );
54
- });
55
-
56
- it("should allow multiple triggers", async () => {
57
- const $signal = signal();
58
- const promise1 = $signal.trigger();
59
- const promise2 = $signal.trigger();
60
- const promise3 = $signal.trigger();
61
-
62
- expect(promise1).toBeInstanceOf(Promise);
63
- expect(promise2).toBeInstanceOf(Promise);
64
- expect(promise3).toBeInstanceOf(Promise);
65
-
66
- await Promise.all([promise1, promise2, promise3]);
67
- });
68
- });
69
-
70
- describe("watch", () => {
71
- it("should throw error when watch is called after disposal", () => {
72
- const $signal = signal();
73
- const $tracker = signal(); // Use another signal as FlowTracker
74
- $signal.dispose();
75
- expect(() => $signal.watch($tracker)).toThrow(
76
- "[PicoFlow] Primitive is disposed",
77
- );
78
- });
79
- });
80
- });
81
-
82
- describe("integration", () => {
83
- describe("with effects", () => {
84
- describe("watch", () => {
85
- it("should register effect when watch is called", async () => {
86
- const $signal = signal();
87
- const effectFn = vi.fn();
88
- effect((t) => {
89
- $signal.watch(t);
90
- effectFn();
91
- });
92
-
93
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
94
- expect(effectFn).toHaveBeenCalledTimes(1);
95
- });
96
-
97
- it("should throw error when watch is called after signal disposal", async () => {
98
- const $signal = signal();
99
- const effectFn = vi.fn();
100
- effect((t) => {
101
- $signal.watch(t);
102
- effectFn();
103
- });
104
-
105
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
106
-
107
- $signal.dispose();
108
-
109
- effect((t) => {
110
- expect(() => $signal.watch(t)).toThrow(
111
- "[PicoFlow] Primitive is disposed",
112
- );
113
- });
114
-
115
- await expect($signal.trigger()).rejects.toThrow(
116
- "[PicoFlow] Primitive is disposed",
117
- );
118
- });
119
- });
120
-
121
- describe("trigger", () => {
122
- it("should notify effects when triggered", async () => {
123
- const $signal = signal();
124
- const effectFn = vi.fn();
125
- effect((t) => {
126
- $signal.watch(t);
127
- effectFn();
128
- });
129
-
130
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
131
-
132
- $signal.trigger();
133
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
134
-
135
- $signal.trigger();
136
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
137
- });
138
-
139
- it("should notify multiple effects when triggered", async () => {
140
- const $signal = signal();
141
- const effectFn1 = vi.fn();
142
- const effectFn2 = vi.fn();
143
- const effectFn3 = vi.fn();
144
-
145
- effect((t) => {
146
- $signal.watch(t);
147
- effectFn1();
148
- });
149
-
150
- effect((t) => {
151
- $signal.watch(t);
152
- effectFn2();
153
- });
154
-
155
- effect((t) => {
156
- $signal.watch(t);
157
- effectFn3();
158
- });
159
-
160
- await vi.waitFor(() => {
161
- expect(effectFn1).toHaveBeenCalledTimes(1);
162
- expect(effectFn2).toHaveBeenCalledTimes(1);
163
- expect(effectFn3).toHaveBeenCalledTimes(1);
164
- });
165
-
166
- $signal.trigger();
167
- await vi.waitFor(() => {
168
- expect(effectFn1).toHaveBeenCalledTimes(2);
169
- expect(effectFn2).toHaveBeenCalledTimes(2);
170
- expect(effectFn3).toHaveBeenCalledTimes(2);
171
- });
172
- });
173
-
174
- it("should not notify effects after they are disposed", async () => {
175
- const $signal = signal();
176
- const effectFn = vi.fn();
177
- const $effect = effect((t) => {
178
- $signal.watch(t);
179
- effectFn();
180
- });
181
-
182
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
183
-
184
- $signal.trigger();
185
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
186
-
187
- $effect.dispose();
188
-
189
- $signal.trigger();
190
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
191
- });
192
-
193
- it("should notify effects multiple times on multiple triggers", async () => {
194
- const $signal = signal();
195
- const effectFn = vi.fn();
196
- effect((t) => {
197
- $signal.watch(t);
198
- effectFn();
199
- });
200
-
201
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
202
-
203
- $signal.trigger();
204
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
205
-
206
- $signal.trigger();
207
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
208
-
209
- $signal.trigger();
210
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(4));
211
- });
212
-
213
- it("should await trigger promise before effects complete", async () => {
214
- const $signal = signal();
215
- const executionOrder: string[] = [];
216
- const effectFn = vi.fn();
217
-
218
- effect((t) => {
219
- $signal.watch(t);
220
- executionOrder.push("effect-executed");
221
- effectFn();
222
- });
223
-
224
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
225
- executionOrder.push("after-initial-effect");
226
-
227
- const triggerPromise = $signal.trigger();
228
- executionOrder.push("trigger-called");
229
-
230
- await triggerPromise;
231
- executionOrder.push("trigger-resolved");
232
-
233
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
234
-
235
- expect(executionOrder).toEqual([
236
- "effect-executed",
237
- "after-initial-effect",
238
- "effect-executed",
239
- "trigger-called",
240
- "trigger-resolved",
241
- ]);
242
- });
243
- });
244
-
245
- describe("dispose", () => {
246
- it("should dispose effects when signal is disposed", async () => {
247
- const $signal = signal();
248
- const effectFn = vi.fn();
249
- const $effect = effect((t) => {
250
- $signal.watch(t);
251
- effectFn();
252
- });
253
-
254
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
255
- expect($effect.disposed).toBe(false);
256
-
257
- $signal.dispose();
258
-
259
- expect($effect.disposed).toBe(true);
260
-
261
- await expect($signal.trigger()).rejects.toThrow(
262
- "[PicoFlow] Primitive is disposed",
263
- );
264
- });
265
-
266
- it("should not dispose effects when signal is disposed with self option", async () => {
267
- const $signal = signal();
268
- const effectFn = vi.fn();
269
- const $effect = effect((t) => {
270
- $signal.watch(t);
271
- effectFn();
272
- });
273
-
274
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
275
- expect($effect.disposed).toBe(false);
276
-
277
- $signal.dispose({ self: true });
278
-
279
- expect($effect.disposed).toBe(false);
280
- expect($signal.disposed).toBe(true);
281
- });
282
-
283
- it("should unregister effects when signal is disposed with self option", async () => {
284
- const $signal = signal();
285
- const effectFn = vi.fn();
286
- const $effect = effect((t) => {
287
- $signal.watch(t);
288
- effectFn();
289
- });
290
-
291
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
292
-
293
- $signal.dispose({ self: true });
294
-
295
- // Effect should still be active but not notified
296
- expect($effect.disposed).toBe(false);
297
-
298
- // But signal is disposed so trigger will fail
299
- await expect($signal.trigger()).rejects.toThrow(
300
- "[PicoFlow] Primitive is disposed",
301
- );
302
- });
303
- });
304
- });
305
-
306
- describe("signal chaining", () => {
307
- it("should notify listener signals when triggered", async () => {
308
- const $signal1 = signal();
309
- const $signal2 = signal();
310
- const effectFn = vi.fn();
311
-
312
- // signal2 watches signal1
313
- effect((t) => {
314
- $signal1.watch(t);
315
- $signal2.trigger();
316
- });
317
-
318
- // effect watches signal2
319
- effect((t) => {
320
- $signal2.watch(t);
321
- effectFn();
322
- });
323
-
324
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
325
-
326
- $signal1.trigger();
327
- await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
328
- });
329
-
330
- // TODO: Fix this test
331
- it.skip("should notify chained signals in correct order", async () => {
332
- const $signal1 = signal();
333
- const $signal2 = signal();
334
- const $signal3 = signal();
335
- const executionOrder: string[] = [];
336
-
337
- effect((t) => {
338
- $signal1.watch(t);
339
- executionOrder.push("signal1-triggered");
340
- $signal2.trigger();
341
- });
342
-
343
- effect((t) => {
344
- $signal2.watch(t);
345
- executionOrder.push("signal2-triggered");
346
- $signal3.trigger();
347
- });
348
-
349
- effect((t) => {
350
- $signal3.watch(t);
351
- executionOrder.push("signal3-triggered");
352
- });
353
-
354
- await vi.waitFor(() =>
355
- expect(executionOrder.length).toBeGreaterThan(0),
356
- );
357
-
358
- executionOrder.length = 0; // Clear initial execution
359
-
360
- $signal1.trigger();
361
- await vi.waitFor(() => expect(executionOrder.length).toBe(5));
362
- console.log(executionOrder);
363
-
364
- expect(executionOrder).toEqual([
365
- "signal1-triggered",
366
- "signal2-triggered",
367
- "signal3-triggered",
368
- ]);
369
- });
370
- });
371
- });
372
- });