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