@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.
- package/.vscode/settings.json +3 -3
- package/CHANGELOG.md +43 -0
- package/README.md +2 -18
- package/biome.json +45 -35
- package/dist/picoflow.js +857 -1528
- package/dist/types/api/base/flowDisposable.d.ts +41 -0
- package/dist/types/api/base/flowDisposable.d.ts.map +1 -0
- package/dist/types/api/base/flowObservable.d.ts +27 -0
- package/dist/types/api/base/flowObservable.d.ts.map +1 -0
- package/dist/types/api/base/flowSubscribable.d.ts +79 -0
- package/dist/types/api/base/flowSubscribable.d.ts.map +1 -0
- package/dist/types/api/base/flowTracker.d.ts +8 -0
- package/dist/types/api/base/flowTracker.d.ts.map +1 -0
- package/dist/types/api/base/index.d.ts +5 -0
- package/dist/types/api/base/index.d.ts.map +1 -0
- package/dist/types/api/index.d.ts +3 -0
- package/dist/types/api/index.d.ts.map +1 -0
- package/dist/types/api/nodes/async/flowConstantAsync.d.ts +31 -0
- package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map +1 -0
- package/dist/types/api/nodes/async/flowDerivationAsync.d.ts +37 -0
- package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map +1 -0
- package/dist/types/api/nodes/async/flowStateAsync.d.ts +41 -0
- package/dist/types/api/nodes/async/flowStateAsync.d.ts.map +1 -0
- package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts +30 -0
- package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts.map +1 -0
- package/dist/types/{flow → api}/nodes/async/index.d.ts +1 -2
- package/dist/types/api/nodes/async/index.d.ts.map +1 -0
- package/dist/types/api/nodes/collections/flowArray.d.ts +134 -0
- package/dist/types/api/nodes/collections/flowArray.d.ts.map +1 -0
- package/dist/types/api/nodes/collections/flowMap.d.ts +98 -0
- package/dist/types/api/nodes/collections/flowMap.d.ts.map +1 -0
- package/dist/types/api/nodes/collections/index.d.ts.map +1 -0
- package/dist/types/api/nodes/flowEffect.d.ts +28 -0
- package/dist/types/api/nodes/flowEffect.d.ts.map +1 -0
- package/dist/types/api/nodes/flowSignal.d.ts +25 -0
- package/dist/types/api/nodes/flowSignal.d.ts.map +1 -0
- package/dist/types/api/nodes/flowValue.d.ts +35 -0
- package/dist/types/api/nodes/flowValue.d.ts.map +1 -0
- package/dist/types/api/nodes/index.d.ts +8 -0
- package/dist/types/api/nodes/index.d.ts.map +1 -0
- package/dist/types/api/nodes/sync/flowConstant.d.ts +29 -0
- package/dist/types/api/nodes/sync/flowConstant.d.ts.map +1 -0
- package/dist/types/api/nodes/sync/flowDerivation.d.ts +36 -0
- package/dist/types/api/nodes/sync/flowDerivation.d.ts.map +1 -0
- package/dist/types/api/nodes/sync/flowState.d.ts +39 -0
- package/dist/types/api/nodes/sync/flowState.d.ts.map +1 -0
- package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts +28 -0
- package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts.map +1 -0
- package/dist/types/{flow → api}/nodes/sync/index.d.ts +1 -2
- package/dist/types/api/nodes/sync/index.d.ts.map +1 -0
- package/dist/types/api/nodes/utils.d.ts +22 -0
- package/dist/types/api/nodes/utils.d.ts.map +1 -0
- package/dist/types/base/disposable.d.ts +11 -0
- package/dist/types/base/disposable.d.ts.map +1 -0
- package/dist/types/base/executionStack.d.ts +14 -0
- package/dist/types/base/executionStack.d.ts.map +1 -0
- package/dist/types/base/index.d.ts +6 -0
- package/dist/types/base/index.d.ts.map +1 -0
- package/dist/types/base/node.d.ts +27 -0
- package/dist/types/base/node.d.ts.map +1 -0
- package/dist/types/base/observable.d.ts +37 -0
- package/dist/types/base/observable.d.ts.map +1 -0
- package/dist/types/base/observer.d.ts +25 -0
- package/dist/types/base/observer.d.ts.map +1 -0
- package/dist/types/converters/index.d.ts +2 -0
- package/dist/types/converters/index.d.ts.map +1 -0
- package/dist/types/converters/solid.d.ts +46 -0
- package/dist/types/converters/solid.d.ts.map +1 -0
- package/dist/types/index.d.ts +2 -63
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/nodes/arrayNode.d.ts +2 -0
- package/dist/types/nodes/arrayNode.d.ts.map +1 -0
- package/dist/types/nodes/effectNode.d.ts +2 -0
- package/dist/types/nodes/effectNode.d.ts.map +1 -0
- package/dist/types/nodes/index.d.ts +9 -0
- package/dist/types/nodes/index.d.ts.map +1 -0
- package/dist/types/nodes/mapNode.d.ts +2 -0
- package/dist/types/nodes/mapNode.d.ts.map +1 -0
- package/dist/types/nodes/signalNode.d.ts +2 -0
- package/dist/types/nodes/signalNode.d.ts.map +1 -0
- package/dist/types/nodes/valueAsyncNode.d.ts +2 -0
- package/dist/types/nodes/valueAsyncNode.d.ts.map +1 -0
- package/dist/types/nodes/valueNode.d.ts +2 -0
- package/dist/types/nodes/valueNode.d.ts.map +1 -0
- package/dist/types/nodes/valueSyncNode.d.ts +2 -0
- package/dist/types/nodes/valueSyncNode.d.ts.map +1 -0
- package/dist/types/schedulers/asyncResolver.d.ts +2 -0
- package/dist/types/schedulers/asyncResolver.d.ts.map +1 -0
- package/dist/types/schedulers/asyncScheduler.d.ts +2 -0
- package/dist/types/schedulers/asyncScheduler.d.ts.map +1 -0
- package/dist/types/schedulers/index.d.ts +5 -0
- package/dist/types/schedulers/index.d.ts.map +1 -0
- package/dist/types/schedulers/pendingError.d.ts +2 -0
- package/dist/types/schedulers/pendingError.d.ts.map +1 -0
- package/dist/types/schedulers/scheduler.d.ts +2 -0
- package/dist/types/schedulers/scheduler.d.ts.map +1 -0
- package/dist/types/schedulers/syncResolver.d.ts +2 -0
- package/dist/types/schedulers/syncResolver.d.ts.map +1 -0
- package/dist/types/schedulers/syncScheduler.d.ts +2 -0
- package/dist/types/schedulers/syncScheduler.d.ts.map +1 -0
- package/docs/.vitepress/config.mts +128 -93
- package/docs/api/functions/array.md +14 -37
- package/docs/api/functions/constant.md +13 -25
- package/docs/api/functions/constantAsync.md +69 -0
- package/docs/api/functions/derivation.md +14 -33
- package/docs/api/functions/derivationAsync.md +34 -0
- package/docs/api/functions/from.md +62 -153
- package/docs/api/functions/isDisposable.md +8 -30
- package/docs/api/functions/map.md +15 -36
- package/docs/api/functions/signal.md +8 -23
- package/docs/api/functions/state.md +43 -23
- package/docs/api/functions/stateAsync.md +69 -0
- package/docs/api/functions/subscribe.md +40 -0
- package/docs/api/functions/writableDerivation.md +33 -0
- package/docs/api/functions/writableDerivationAsync.md +34 -0
- package/docs/api/index.md +45 -102
- package/docs/api/interfaces/FlowArray.md +439 -0
- package/docs/api/interfaces/FlowConstant.md +220 -0
- package/docs/api/interfaces/FlowConstantAsync.md +221 -0
- package/docs/api/interfaces/FlowDerivation.md +241 -0
- package/docs/api/interfaces/FlowDerivationAsync.md +242 -0
- package/docs/api/interfaces/FlowDisposable.md +32 -38
- package/docs/api/interfaces/FlowEffect.md +64 -0
- package/docs/api/interfaces/FlowMap.md +374 -0
- package/docs/api/interfaces/FlowObservable.md +155 -0
- package/docs/api/interfaces/FlowSignal.md +156 -0
- package/docs/api/interfaces/FlowState.md +269 -0
- package/docs/api/interfaces/FlowStateAsync.md +268 -0
- package/docs/api/interfaces/FlowSubscribable.md +55 -0
- package/docs/api/interfaces/FlowTracker.md +61 -0
- package/docs/api/interfaces/FlowValue.md +222 -0
- package/docs/api/interfaces/FlowWritableDerivation.md +292 -0
- package/docs/api/interfaces/FlowWritableDerivationAsync.md +293 -0
- package/docs/api/type-aliases/DerivationFunction.md +28 -0
- package/docs/api/type-aliases/DerivationFunctionAsync.md +28 -0
- package/docs/api/type-aliases/FlowArrayAction.md +19 -8
- package/docs/api/type-aliases/FlowDataTracker.md +33 -0
- package/docs/api/type-aliases/FlowMapAction.md +48 -0
- package/docs/api/type-aliases/FlowOnDataListener.md +33 -0
- package/docs/api/type-aliases/FlowOnErrorListener.md +27 -0
- package/docs/api/type-aliases/FlowOnPendingListener.md +21 -0
- package/docs/api/type-aliases/FlowReadonly.md +22 -0
- package/docs/api/type-aliases/InitFunction.md +21 -0
- package/docs/api/type-aliases/InitFunctionAsync.md +21 -0
- package/docs/api/type-aliases/NotPromise.md +6 -3
- package/docs/api/type-aliases/UpdateFunction.md +27 -0
- package/docs/api/type-aliases/UpdateFunctionAsync.md +27 -0
- package/docs/api/typedoc-sidebar.json +1 -81
- package/docs/examples/examples.md +0 -2
- package/docs/guide/advanced/architecture.md +1234 -0
- package/docs/guide/advanced/migration-v2.md +204 -0
- package/docs/guide/advanced/solidjs.md +2 -88
- package/docs/guide/introduction/concepts.md +4 -3
- package/docs/guide/introduction/conventions.md +2 -33
- package/docs/guide/introduction/getting-started.md +28 -23
- package/docs/guide/introduction/lifecycle.md +16 -19
- package/docs/guide/primitives/array.md +102 -216
- package/docs/guide/primitives/constant.md +39 -212
- package/docs/guide/primitives/derivations.md +55 -122
- package/docs/guide/primitives/effects.md +155 -241
- package/docs/guide/primitives/map.md +64 -186
- package/docs/guide/primitives/overview.md +45 -128
- package/docs/guide/primitives/signal.md +51 -88
- package/docs/guide/primitives/state.md +34 -130
- package/package.json +56 -60
- package/src/api/base/flowDisposable.ts +44 -0
- package/src/api/base/flowObservable.ts +28 -0
- package/src/api/base/flowSubscribable.ts +87 -0
- package/src/api/base/flowTracker.ts +7 -0
- package/src/api/base/index.ts +4 -0
- package/src/{flow → api}/index.ts +0 -1
- package/src/api/nodes/async/flowConstantAsync.ts +36 -0
- package/src/api/nodes/async/flowDerivationAsync.ts +42 -0
- package/src/api/nodes/async/flowStateAsync.ts +47 -0
- package/src/api/nodes/async/flowWritableDerivationAsync.ts +33 -0
- package/src/{flow → api}/nodes/async/index.ts +1 -2
- package/src/api/nodes/collections/flowArray.ts +155 -0
- package/src/api/nodes/collections/flowMap.ts +115 -0
- package/src/api/nodes/flowEffect.ts +42 -0
- package/src/api/nodes/flowSignal.ts +28 -0
- package/src/api/nodes/flowValue.ts +36 -0
- package/src/api/nodes/index.ts +7 -0
- package/src/api/nodes/sync/flowConstant.ts +33 -0
- package/src/api/nodes/sync/flowDerivation.ts +41 -0
- package/src/api/nodes/sync/flowState.ts +45 -0
- package/src/api/nodes/sync/flowWritableDerivation.ts +31 -0
- package/src/{flow → api}/nodes/sync/index.ts +1 -2
- package/src/api/nodes/utils.ts +22 -0
- package/src/base/disposable.ts +18 -0
- package/src/base/executionStack.ts +42 -0
- package/src/base/index.ts +5 -0
- package/src/base/node.ts +98 -0
- package/src/base/observable.ts +87 -0
- package/src/base/observer.ts +51 -0
- package/src/converters/index.ts +1 -0
- package/src/converters/solid.ts +109 -0
- package/src/index.ts +2 -64
- package/src/nodes/arrayNode.ts +172 -0
- package/src/nodes/effectNode.ts +59 -0
- package/src/nodes/index.ts +8 -0
- package/src/nodes/mapNode.ts +127 -0
- package/src/nodes/signalNode.ts +21 -0
- package/src/nodes/valueAsyncNode.ts +88 -0
- package/src/nodes/valueNode.ts +144 -0
- package/src/nodes/valueSyncNode.ts +128 -0
- package/src/schedulers/asyncResolver.ts +78 -0
- package/src/schedulers/asyncScheduler.ts +66 -0
- package/src/schedulers/index.ts +4 -0
- package/src/schedulers/pendingError.ts +13 -0
- package/src/schedulers/scheduler.ts +9 -0
- package/src/schedulers/syncResolver.ts +69 -0
- package/src/schedulers/syncScheduler.ts +55 -0
- package/test/base/pendingError.test.ts +67 -0
- package/test/converters/solid.derivation.browser.test.tsx +69 -0
- package/test/converters/solid.node.test.ts +654 -0
- package/test/converters/solid.state.browser.test.tsx +1592 -0
- package/test/reactivity/flowSignal.test.ts +226 -0
- package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +593 -0
- package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +317 -0
- package/test/reactivity/nodes/async/flowConstantAsync.test.ts +652 -0
- package/test/reactivity/nodes/async/flowDerivation.test.ts +898 -0
- package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +1716 -0
- package/test/reactivity/nodes/async/flowStateAsync.test.ts +708 -0
- package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +614 -0
- package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +1289 -0
- package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +961 -0
- package/test/reactivity/nodes/collections/flowArray.states.test.ts +1035 -0
- package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +960 -0
- package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +775 -0
- package/test/reactivity/nodes/collections/flowMap.states.test.ts +958 -0
- package/test/reactivity/nodes/sync/flowConstant.test.ts +377 -0
- package/test/reactivity/nodes/sync/flowDerivation.test.ts +896 -0
- package/test/reactivity/nodes/sync/flowState.test.ts +341 -0
- package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +603 -0
- package/test/vitest.d.ts +10 -0
- package/tsconfig.json +31 -20
- package/typedoc.json +35 -35
- package/vite.config.ts +25 -23
- package/vitest.browser.config.ts +21 -0
- package/vitest.config.ts +12 -12
- package/.cursor/plans/unifier-flowresource-avec-flowderivation-c9506e24.plan.md +0 -372
- package/.cursor/plans/update-js-e795d61b.plan.md +0 -567
- package/dist/types/flow/base/flowDisposable.d.ts +0 -67
- package/dist/types/flow/base/flowDisposable.d.ts.map +0 -1
- package/dist/types/flow/base/flowEffect.d.ts +0 -127
- package/dist/types/flow/base/flowEffect.d.ts.map +0 -1
- package/dist/types/flow/base/flowGraph.d.ts +0 -97
- package/dist/types/flow/base/flowGraph.d.ts.map +0 -1
- package/dist/types/flow/base/flowSignal.d.ts +0 -134
- package/dist/types/flow/base/flowSignal.d.ts.map +0 -1
- package/dist/types/flow/base/flowTracker.d.ts +0 -15
- package/dist/types/flow/base/flowTracker.d.ts.map +0 -1
- package/dist/types/flow/base/index.d.ts +0 -7
- package/dist/types/flow/base/index.d.ts.map +0 -1
- package/dist/types/flow/base/utils.d.ts +0 -20
- package/dist/types/flow/base/utils.d.ts.map +0 -1
- package/dist/types/flow/collections/flowArray.d.ts +0 -148
- package/dist/types/flow/collections/flowArray.d.ts.map +0 -1
- package/dist/types/flow/collections/flowMap.d.ts +0 -224
- package/dist/types/flow/collections/flowMap.d.ts.map +0 -1
- package/dist/types/flow/collections/index.d.ts.map +0 -1
- package/dist/types/flow/index.d.ts +0 -4
- package/dist/types/flow/index.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/flowConstantAsync.d.ts +0 -137
- package/dist/types/flow/nodes/async/flowConstantAsync.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts +0 -137
- package/dist/types/flow/nodes/async/flowDerivationAsync.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/flowNodeAsync.d.ts +0 -343
- package/dist/types/flow/nodes/async/flowNodeAsync.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts +0 -81
- package/dist/types/flow/nodes/async/flowReadonlyAsync.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/flowStateAsync.d.ts +0 -111
- package/dist/types/flow/nodes/async/flowStateAsync.d.ts.map +0 -1
- package/dist/types/flow/nodes/async/index.d.ts.map +0 -1
- package/dist/types/flow/nodes/index.d.ts +0 -3
- package/dist/types/flow/nodes/index.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/flowConstant.d.ts +0 -108
- package/dist/types/flow/nodes/sync/flowConstant.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/flowDerivation.d.ts +0 -100
- package/dist/types/flow/nodes/sync/flowDerivation.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/flowNode.d.ts +0 -314
- package/dist/types/flow/nodes/sync/flowNode.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/flowReadonly.d.ts +0 -57
- package/dist/types/flow/nodes/sync/flowReadonly.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/flowState.d.ts +0 -96
- package/dist/types/flow/nodes/sync/flowState.d.ts.map +0 -1
- package/dist/types/flow/nodes/sync/index.d.ts.map +0 -1
- package/dist/types/solid/converters.d.ts +0 -53
- package/dist/types/solid/converters.d.ts.map +0 -1
- package/dist/types/solid/index.d.ts +0 -3
- package/dist/types/solid/index.d.ts.map +0 -1
- package/dist/types/solid/primitives.d.ts +0 -181
- package/dist/types/solid/primitives.d.ts.map +0 -1
- package/docs/api/classes/FlowArray.md +0 -489
- package/docs/api/classes/FlowConstant.md +0 -350
- package/docs/api/classes/FlowDerivation.md +0 -334
- package/docs/api/classes/FlowEffect.md +0 -100
- package/docs/api/classes/FlowMap.md +0 -512
- package/docs/api/classes/FlowObservable.md +0 -306
- package/docs/api/classes/FlowResource.md +0 -380
- package/docs/api/classes/FlowResourceAsync.md +0 -362
- package/docs/api/classes/FlowSignal.md +0 -160
- package/docs/api/classes/FlowState.md +0 -368
- package/docs/api/classes/FlowStream.md +0 -367
- package/docs/api/classes/FlowStreamAsync.md +0 -364
- package/docs/api/classes/SolidDerivation.md +0 -75
- package/docs/api/classes/SolidResource.md +0 -91
- package/docs/api/classes/SolidState.md +0 -71
- package/docs/api/classes/TrackingContext.md +0 -33
- package/docs/api/functions/effect.md +0 -49
- package/docs/api/functions/resource.md +0 -52
- package/docs/api/functions/resourceAsync.md +0 -50
- package/docs/api/functions/stream.md +0 -53
- package/docs/api/functions/streamAsync.md +0 -50
- package/docs/api/interfaces/SolidObservable.md +0 -19
- package/docs/api/type-aliases/FlowStreamDisposer.md +0 -15
- package/docs/api/type-aliases/FlowStreamSetter.md +0 -27
- package/docs/api/type-aliases/FlowStreamUpdater.md +0 -32
- package/docs/api/type-aliases/SolidGetter.md +0 -17
- package/docs/guide/primitives/resources.md +0 -858
- package/docs/guide/primitives/streams.md +0 -931
- package/src/flow/base/flowDisposable.ts +0 -71
- package/src/flow/base/flowEffect.ts +0 -171
- package/src/flow/base/flowGraph.ts +0 -288
- package/src/flow/base/flowSignal.ts +0 -207
- package/src/flow/base/flowTracker.ts +0 -17
- package/src/flow/base/index.ts +0 -6
- package/src/flow/base/utils.ts +0 -19
- package/src/flow/collections/flowArray.ts +0 -409
- package/src/flow/collections/flowMap.ts +0 -398
- package/src/flow/nodes/async/flowConstantAsync.ts +0 -142
- package/src/flow/nodes/async/flowDerivationAsync.ts +0 -143
- package/src/flow/nodes/async/flowNodeAsync.ts +0 -474
- package/src/flow/nodes/async/flowReadonlyAsync.ts +0 -81
- package/src/flow/nodes/async/flowStateAsync.ts +0 -116
- package/src/flow/nodes/await/advanced/index.ts +0 -5
- package/src/flow/nodes/await/advanced/resource.ts +0 -134
- package/src/flow/nodes/await/advanced/resourceAsync.ts +0 -109
- package/src/flow/nodes/await/advanced/stream.ts +0 -188
- package/src/flow/nodes/await/advanced/streamAsync.ts +0 -176
- package/src/flow/nodes/await/flowConstantAwait.ts +0 -154
- package/src/flow/nodes/await/flowDerivationAwait.ts +0 -154
- package/src/flow/nodes/await/flowNodeAwait.ts +0 -508
- package/src/flow/nodes/await/flowReadonlyAwait.ts +0 -89
- package/src/flow/nodes/await/flowStateAwait.ts +0 -130
- package/src/flow/nodes/await/index.ts +0 -5
- package/src/flow/nodes/index.ts +0 -3
- package/src/flow/nodes/sync/flowConstant.ts +0 -111
- package/src/flow/nodes/sync/flowDerivation.ts +0 -105
- package/src/flow/nodes/sync/flowNode.ts +0 -439
- package/src/flow/nodes/sync/flowReadonly.ts +0 -57
- package/src/flow/nodes/sync/flowState.ts +0 -101
- package/src/solid/converters.ts +0 -139
- package/src/solid/index.ts +0 -2
- package/src/solid/primitives.ts +0 -215
- package/test/base/flowEffect.test.ts +0 -108
- package/test/base/flowGraph.test.ts +0 -485
- package/test/base/flowSignal.test.ts +0 -372
- package/test/collections/flowArray.asyncStates.test.ts +0 -1553
- package/test/collections/flowArray.scalars.test.ts +0 -1129
- package/test/collections/flowArray.states.test.ts +0 -1365
- package/test/collections/flowMap.asyncStates.test.ts +0 -1105
- package/test/collections/flowMap.scalars.test.ts +0 -877
- package/test/collections/flowMap.states.test.ts +0 -1097
- package/test/nodes/async/flowConstantAsync.test.ts +0 -860
- package/test/nodes/async/flowDerivationAsync.test.ts +0 -1517
- package/test/nodes/async/flowStateAsync.test.ts +0 -1387
- package/test/nodes/await/advanced/resource.test.ts +0 -129
- package/test/nodes/await/advanced/resourceAsync.test.ts +0 -108
- package/test/nodes/await/advanced/stream.test.ts +0 -198
- package/test/nodes/await/advanced/streamAsync.test.ts +0 -196
- package/test/nodes/await/flowConstantAwait.test.ts +0 -643
- package/test/nodes/await/flowDerivationAwait.test.ts +0 -1583
- package/test/nodes/await/flowStateAwait.test.ts +0 -999
- package/test/nodes/mixed/derivation.test.ts +0 -1527
- package/test/nodes/sync/flowConstant.test.ts +0 -620
- package/test/nodes/sync/flowDerivation.test.ts +0 -1373
- package/test/nodes/sync/flowState.test.ts +0 -945
- package/test/solid/converters.test.ts +0 -721
- package/test/solid/primitives.test.ts +0 -1031
- /package/dist/types/{flow → api/nodes}/collections/index.d.ts +0 -0
- /package/docs/guide/advanced/{upgrading.md → migration-v1.md} +0 -0
- /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
|
-
});
|