@ersbeth/picoflow 2.0.2 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +25 -0
  3. package/SKILL.md +106 -0
  4. package/dist/picoflow.js +204 -60
  5. package/dist/types/api/base/flowObservable.d.ts +3 -3
  6. package/dist/types/api/base/flowObservable.d.ts.map +1 -1
  7. package/dist/types/api/base/flowSubscribable.d.ts +2 -2
  8. package/dist/types/api/base/flowSubscribable.d.ts.map +1 -1
  9. package/dist/types/api/base/flowTracker.d.ts +1 -1
  10. package/dist/types/api/base/flowTracker.d.ts.map +1 -1
  11. package/dist/types/api/base/index.d.ts +4 -4
  12. package/dist/types/api/base/index.d.ts.map +1 -1
  13. package/dist/types/api/index.d.ts +2 -2
  14. package/dist/types/api/index.d.ts.map +1 -1
  15. package/dist/types/api/nodes/async/flowConstantAsync.d.ts +1 -1
  16. package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map +1 -1
  17. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts +3 -3
  18. package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map +1 -1
  19. package/dist/types/api/nodes/async/flowStateAsync.d.ts +3 -3
  20. package/dist/types/api/nodes/async/flowStateAsync.d.ts.map +1 -1
  21. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts +2 -2
  22. package/dist/types/api/nodes/async/flowWritableDerivationAsync.d.ts.map +1 -1
  23. package/dist/types/api/nodes/async/index.d.ts +4 -4
  24. package/dist/types/api/nodes/async/index.d.ts.map +1 -1
  25. package/dist/types/api/nodes/collections/flowArray.d.ts +7 -4
  26. package/dist/types/api/nodes/collections/flowArray.d.ts.map +1 -1
  27. package/dist/types/api/nodes/collections/flowMap.d.ts +3 -2
  28. package/dist/types/api/nodes/collections/flowMap.d.ts.map +1 -1
  29. package/dist/types/api/nodes/collections/index.d.ts +2 -2
  30. package/dist/types/api/nodes/collections/index.d.ts.map +1 -1
  31. package/dist/types/api/nodes/flowEffect.d.ts +2 -2
  32. package/dist/types/api/nodes/flowEffect.d.ts.map +1 -1
  33. package/dist/types/api/nodes/flowSignal.d.ts +1 -1
  34. package/dist/types/api/nodes/flowSignal.d.ts.map +1 -1
  35. package/dist/types/api/nodes/flowValue.d.ts +2 -2
  36. package/dist/types/api/nodes/flowValue.d.ts.map +1 -1
  37. package/dist/types/api/nodes/index.d.ts +7 -7
  38. package/dist/types/api/nodes/index.d.ts.map +1 -1
  39. package/dist/types/api/nodes/sync/flowConstant.d.ts +2 -2
  40. package/dist/types/api/nodes/sync/flowConstant.d.ts.map +1 -1
  41. package/dist/types/api/nodes/sync/flowDerivation.d.ts +3 -3
  42. package/dist/types/api/nodes/sync/flowDerivation.d.ts.map +1 -1
  43. package/dist/types/api/nodes/sync/flowState.d.ts +3 -3
  44. package/dist/types/api/nodes/sync/flowState.d.ts.map +1 -1
  45. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts +2 -2
  46. package/dist/types/api/nodes/sync/flowWritableDerivation.d.ts.map +1 -1
  47. package/dist/types/api/nodes/sync/index.d.ts +4 -4
  48. package/dist/types/api/nodes/sync/index.d.ts.map +1 -1
  49. package/dist/types/api/nodes/utils.d.ts +1 -1
  50. package/dist/types/api/nodes/utils.d.ts.map +1 -1
  51. package/dist/types/base/disposable.d.ts +1 -1
  52. package/dist/types/base/disposable.d.ts.map +1 -1
  53. package/dist/types/base/executionStack.d.ts +22 -1
  54. package/dist/types/base/executionStack.d.ts.map +1 -1
  55. package/dist/types/base/index.d.ts +5 -5
  56. package/dist/types/base/index.d.ts.map +1 -1
  57. package/dist/types/base/node.d.ts +4 -4
  58. package/dist/types/base/node.d.ts.map +1 -1
  59. package/dist/types/base/observable.d.ts +3 -3
  60. package/dist/types/base/observable.d.ts.map +1 -1
  61. package/dist/types/base/observer.d.ts +2 -2
  62. package/dist/types/base/observer.d.ts.map +1 -1
  63. package/dist/types/converters/index.d.ts +1 -1
  64. package/dist/types/converters/index.d.ts.map +1 -1
  65. package/dist/types/converters/solid.d.ts +12 -8
  66. package/dist/types/converters/solid.d.ts.map +1 -1
  67. package/dist/types/index.d.ts +2 -2
  68. package/dist/types/index.d.ts.map +1 -1
  69. package/dist/types/nodes/actionNode.d.ts +23 -0
  70. package/dist/types/nodes/actionNode.d.ts.map +1 -0
  71. package/dist/types/nodes/arrayNode.d.ts +4 -3
  72. package/dist/types/nodes/arrayNode.d.ts.map +1 -1
  73. package/dist/types/nodes/effectNode.d.ts +18 -2
  74. package/dist/types/nodes/effectNode.d.ts.map +1 -1
  75. package/dist/types/nodes/index.d.ts +8 -7
  76. package/dist/types/nodes/index.d.ts.map +1 -1
  77. package/dist/types/nodes/mapNode.d.ts +4 -3
  78. package/dist/types/nodes/mapNode.d.ts.map +1 -1
  79. package/dist/types/nodes/signalNode.d.ts +2 -2
  80. package/dist/types/nodes/signalNode.d.ts.map +1 -1
  81. package/dist/types/nodes/valueAsyncNode.d.ts +3 -3
  82. package/dist/types/nodes/valueAsyncNode.d.ts.map +1 -1
  83. package/dist/types/nodes/valueNode.d.ts +3 -3
  84. package/dist/types/nodes/valueNode.d.ts.map +1 -1
  85. package/dist/types/nodes/valueSyncNode.d.ts +3 -3
  86. package/dist/types/nodes/valueSyncNode.d.ts.map +1 -1
  87. package/dist/types/schedulers/asyncScheduler.d.ts +2 -1
  88. package/dist/types/schedulers/asyncScheduler.d.ts.map +1 -1
  89. package/dist/types/schedulers/index.d.ts +4 -4
  90. package/dist/types/schedulers/index.d.ts.map +1 -1
  91. package/dist/types/schedulers/syncResolver.d.ts +1 -2
  92. package/dist/types/schedulers/syncResolver.d.ts.map +1 -1
  93. package/dist/types/schedulers/syncScheduler.d.ts +1 -1
  94. package/dist/types/schedulers/syncScheduler.d.ts.map +1 -1
  95. package/package.json +24 -1
  96. package/.gitlab-ci.yml +0 -24
  97. package/.vscode/settings.json +0 -5
  98. package/CHANGELOG.md +0 -94
  99. package/biome.json +0 -47
  100. package/docs/.vitepress/config.mts +0 -145
  101. package/docs/api/functions/array.md +0 -35
  102. package/docs/api/functions/constant.md +0 -33
  103. package/docs/api/functions/constantAsync.md +0 -69
  104. package/docs/api/functions/derivation.md +0 -34
  105. package/docs/api/functions/derivationAsync.md +0 -34
  106. package/docs/api/functions/from.md +0 -129
  107. package/docs/api/functions/isDisposable.md +0 -27
  108. package/docs/api/functions/map.md +0 -36
  109. package/docs/api/functions/signal.md +0 -21
  110. package/docs/api/functions/state.md +0 -67
  111. package/docs/api/functions/stateAsync.md +0 -69
  112. package/docs/api/functions/subscribe.md +0 -40
  113. package/docs/api/functions/writableDerivation.md +0 -33
  114. package/docs/api/functions/writableDerivationAsync.md +0 -34
  115. package/docs/api/index.md +0 -61
  116. package/docs/api/interfaces/FlowArray.md +0 -439
  117. package/docs/api/interfaces/FlowConstant.md +0 -220
  118. package/docs/api/interfaces/FlowConstantAsync.md +0 -221
  119. package/docs/api/interfaces/FlowDerivation.md +0 -241
  120. package/docs/api/interfaces/FlowDerivationAsync.md +0 -242
  121. package/docs/api/interfaces/FlowDisposable.md +0 -59
  122. package/docs/api/interfaces/FlowEffect.md +0 -64
  123. package/docs/api/interfaces/FlowMap.md +0 -374
  124. package/docs/api/interfaces/FlowObservable.md +0 -155
  125. package/docs/api/interfaces/FlowSignal.md +0 -156
  126. package/docs/api/interfaces/FlowState.md +0 -269
  127. package/docs/api/interfaces/FlowStateAsync.md +0 -268
  128. package/docs/api/interfaces/FlowSubscribable.md +0 -55
  129. package/docs/api/interfaces/FlowTracker.md +0 -61
  130. package/docs/api/interfaces/FlowValue.md +0 -222
  131. package/docs/api/interfaces/FlowWritableDerivation.md +0 -292
  132. package/docs/api/interfaces/FlowWritableDerivationAsync.md +0 -293
  133. package/docs/api/type-aliases/DerivationFunction.md +0 -28
  134. package/docs/api/type-aliases/DerivationFunctionAsync.md +0 -28
  135. package/docs/api/type-aliases/FlowArrayAction.md +0 -60
  136. package/docs/api/type-aliases/FlowDataTracker.md +0 -33
  137. package/docs/api/type-aliases/FlowMapAction.md +0 -48
  138. package/docs/api/type-aliases/FlowOnDataListener.md +0 -33
  139. package/docs/api/type-aliases/FlowOnErrorListener.md +0 -27
  140. package/docs/api/type-aliases/FlowOnPendingListener.md +0 -21
  141. package/docs/api/type-aliases/FlowReadonly.md +0 -22
  142. package/docs/api/type-aliases/InitFunction.md +0 -21
  143. package/docs/api/type-aliases/InitFunctionAsync.md +0 -21
  144. package/docs/api/type-aliases/NotPromise.md +0 -21
  145. package/docs/api/type-aliases/UpdateFunction.md +0 -27
  146. package/docs/api/type-aliases/UpdateFunctionAsync.md +0 -27
  147. package/docs/api/typedoc-sidebar.json +0 -65
  148. package/docs/examples/examples.md +0 -2311
  149. package/docs/examples/patterns.md +0 -649
  150. package/docs/guide/advanced/architecture.md +0 -1234
  151. package/docs/guide/advanced/disposal.md +0 -426
  152. package/docs/guide/advanced/migration-v1.md +0 -464
  153. package/docs/guide/advanced/migration-v2.md +0 -204
  154. package/docs/guide/advanced/solidjs.md +0 -135
  155. package/docs/guide/introduction/concepts.md +0 -57
  156. package/docs/guide/introduction/conventions.md +0 -30
  157. package/docs/guide/introduction/getting-started.md +0 -139
  158. package/docs/guide/introduction/lifecycle.md +0 -368
  159. package/docs/guide/primitives/array.md +0 -286
  160. package/docs/guide/primitives/constant.md +0 -207
  161. package/docs/guide/primitives/derivations.md +0 -281
  162. package/docs/guide/primitives/effects.md +0 -372
  163. package/docs/guide/primitives/map.md +0 -265
  164. package/docs/guide/primitives/overview.md +0 -92
  165. package/docs/guide/primitives/signal.md +0 -222
  166. package/docs/guide/primitives/state.md +0 -272
  167. package/docs/index.md +0 -47
  168. package/docs/public/logo.svg +0 -1
  169. package/src/api/base/flowDisposable.ts +0 -44
  170. package/src/api/base/flowObservable.ts +0 -28
  171. package/src/api/base/flowSubscribable.ts +0 -87
  172. package/src/api/base/flowTracker.ts +0 -7
  173. package/src/api/base/index.ts +0 -4
  174. package/src/api/index.ts +0 -2
  175. package/src/api/nodes/async/flowConstantAsync.ts +0 -36
  176. package/src/api/nodes/async/flowDerivationAsync.ts +0 -42
  177. package/src/api/nodes/async/flowStateAsync.ts +0 -47
  178. package/src/api/nodes/async/flowWritableDerivationAsync.ts +0 -33
  179. package/src/api/nodes/async/index.ts +0 -4
  180. package/src/api/nodes/collections/flowArray.ts +0 -155
  181. package/src/api/nodes/collections/flowMap.ts +0 -115
  182. package/src/api/nodes/collections/index.ts +0 -2
  183. package/src/api/nodes/flowEffect.ts +0 -42
  184. package/src/api/nodes/flowSignal.ts +0 -28
  185. package/src/api/nodes/flowValue.ts +0 -37
  186. package/src/api/nodes/index.ts +0 -7
  187. package/src/api/nodes/sync/flowConstant.ts +0 -33
  188. package/src/api/nodes/sync/flowDerivation.ts +0 -41
  189. package/src/api/nodes/sync/flowState.ts +0 -45
  190. package/src/api/nodes/sync/flowWritableDerivation.ts +0 -31
  191. package/src/api/nodes/sync/index.ts +0 -4
  192. package/src/api/nodes/utils.ts +0 -24
  193. package/src/base/disposable.ts +0 -18
  194. package/src/base/executionStack.ts +0 -42
  195. package/src/base/index.ts +0 -5
  196. package/src/base/node.ts +0 -98
  197. package/src/base/observable.ts +0 -92
  198. package/src/base/observer.ts +0 -51
  199. package/src/converters/index.ts +0 -1
  200. package/src/converters/solid.ts +0 -109
  201. package/src/index.ts +0 -2
  202. package/src/nodes/arrayNode.ts +0 -180
  203. package/src/nodes/effectNode.ts +0 -58
  204. package/src/nodes/index.ts +0 -7
  205. package/src/nodes/mapNode.ts +0 -125
  206. package/src/nodes/signalNode.ts +0 -19
  207. package/src/nodes/valueAsyncNode.ts +0 -85
  208. package/src/nodes/valueNode.ts +0 -148
  209. package/src/nodes/valueSyncNode.ts +0 -125
  210. package/src/schedulers/asyncResolver.ts +0 -78
  211. package/src/schedulers/asyncScheduler.ts +0 -66
  212. package/src/schedulers/index.ts +0 -4
  213. package/src/schedulers/pendingError.ts +0 -13
  214. package/src/schedulers/scheduler.ts +0 -9
  215. package/src/schedulers/syncResolver.ts +0 -69
  216. package/src/schedulers/syncScheduler.ts +0 -55
  217. package/test/base/pendingError.test.ts +0 -67
  218. package/test/converters/solid.derivation.browser.test.tsx +0 -69
  219. package/test/converters/solid.node.test.ts +0 -654
  220. package/test/converters/solid.state.browser.test.tsx +0 -1592
  221. package/test/reactivity/flowSignal.test.ts +0 -226
  222. package/test/reactivity/nodes/async/asyncScheduler/asyncResolver.test.ts +0 -593
  223. package/test/reactivity/nodes/async/asyncScheduler/asyncScheduler.test.ts +0 -317
  224. package/test/reactivity/nodes/async/flowConstantAsync.test.ts +0 -652
  225. package/test/reactivity/nodes/async/flowDerivation.test.ts +0 -898
  226. package/test/reactivity/nodes/async/flowDerivationAsync.test.ts +0 -1716
  227. package/test/reactivity/nodes/async/flowStateAsync.test.ts +0 -708
  228. package/test/reactivity/nodes/async/flowWritableDerivationAsync.test.ts +0 -614
  229. package/test/reactivity/nodes/collections/flowArray.asyncStates.test.ts +0 -1289
  230. package/test/reactivity/nodes/collections/flowArray.scalars.test.ts +0 -961
  231. package/test/reactivity/nodes/collections/flowArray.states.test.ts +0 -1035
  232. package/test/reactivity/nodes/collections/flowMap.asyncStates.test.ts +0 -960
  233. package/test/reactivity/nodes/collections/flowMap.scalars.test.ts +0 -775
  234. package/test/reactivity/nodes/collections/flowMap.states.test.ts +0 -958
  235. package/test/reactivity/nodes/sync/flowConstant.test.ts +0 -377
  236. package/test/reactivity/nodes/sync/flowDerivation.test.ts +0 -896
  237. package/test/reactivity/nodes/sync/flowState.test.ts +0 -341
  238. package/test/reactivity/nodes/sync/flowWritableDerivation.test.ts +0 -603
  239. package/test/vitest.d.ts +0 -10
  240. package/tsconfig.json +0 -37
  241. package/typedoc.json +0 -37
  242. package/vite.config.ts +0 -31
  243. package/vitest.browser.config.ts +0 -21
  244. package/vitest.config.ts +0 -17
@@ -1,377 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
- import { constant, subscribe } from "~";
3
- import { EffectNode } from "~/nodes";
4
-
5
- describe("flowConstant", () => {
6
- describe("unit", () => {
7
- describe("initialization / pick", () => {
8
- it("should initialize with initializer function", async () => {
9
- const $constant = constant(() => 1);
10
- expect(await $constant.pick()).toBe(1);
11
- });
12
-
13
- it("should compute initial value lazily on first access", async () => {
14
- const computeFn = vi.fn(() => 42);
15
- const $constant = constant(computeFn);
16
-
17
- // Function should not be called yet
18
- expect(computeFn).not.toHaveBeenCalled();
19
-
20
- // First access triggers computation
21
- const value = await $constant.pick();
22
- expect(value).toBe(42);
23
- expect(computeFn).toHaveBeenCalledTimes(1);
24
- });
25
-
26
- it("should call initializer function only once", async () => {
27
- const computeFn = vi.fn(() => 100);
28
- const $constant = constant(computeFn);
29
-
30
- // Multiple accesses should only call compute once
31
- await $constant.pick();
32
- await $constant.pick();
33
- await $constant.pick();
34
-
35
- expect(computeFn).toHaveBeenCalledTimes(1);
36
- });
37
-
38
- it("should cache i value after initialization", async () => {
39
- const computeFn = vi.fn(() => "cached");
40
- const $constant = constant(computeFn);
41
-
42
- const value1 = await $constant.pick();
43
- const value2 = await $constant.pick();
44
- const value3 = await $constant.pick();
45
-
46
- expect(value1).toBe("cached");
47
- expect(value2).toBe("cached");
48
- expect(value3).toBe("cached");
49
- expect(computeFn).toHaveBeenCalledTimes(1);
50
- });
51
-
52
- it("should handle initializer function using closure to capture values", async () => {
53
- let externalValue = 10;
54
- const $constant = constant(() => {
55
- // Closure captures external value at computation time
56
- return externalValue * 2;
57
- });
58
-
59
- // Constant computes once with captured value
60
- expect(await $constant.pick()).toBe(20);
61
-
62
- // Changing external value should not affect constant (it's cached)
63
- externalValue = 20;
64
- expect(await $constant.pick()).toBe(20); // Still cached value
65
- });
66
-
67
- it("should handle number values", async () => {
68
- const $constant = constant(() => 42);
69
- expect(await $constant.pick()).toBe(42);
70
- });
71
-
72
- it("should handle string values", async () => {
73
- const $constant = constant(() => "hello");
74
- expect(await $constant.pick()).toBe("hello");
75
- });
76
-
77
- it("should handle object values", async () => {
78
- const obj = { a: 1, b: 2 };
79
- const $constant = constant(() => obj);
80
- const value = await $constant.pick();
81
- expect(value).toBe(obj);
82
- expect(value).toEqual({ a: 1, b: 2 });
83
- });
84
-
85
- it("should handle array values", async () => {
86
- const arr = [1, 2, 3];
87
- const $constant = constant(() => arr);
88
- const value = await $constant.pick();
89
- expect(value).toBe(arr);
90
- expect(value).toEqual([1, 2, 3]);
91
- });
92
-
93
- it("should handle undefined values", async () => {
94
- const $constant = constant(() => undefined);
95
- const value = await $constant.pick();
96
- expect(value).toBeUndefined();
97
- });
98
-
99
- it("should handle null values", async () => {
100
- const $constant = constant(() => null);
101
- const value = await $constant.pick();
102
- expect(value).toBeNull();
103
- });
104
-
105
- describe("error handling", () => {
106
- it("pick should throw error when pick is called after disposal", async () => {
107
- const $constant = constant(() => 1);
108
-
109
- expect(await $constant.pick()).toBe(1);
110
-
111
- $constant.dispose();
112
-
113
- await expect($constant.pick()).rejects.toThrow("[PicoFlow] Primitive is disposed");
114
- });
115
-
116
- it("should throw error when subscribe is called after disposal", () => {
117
- const $constant = constant(() => 1);
118
- const onData = vi.fn();
119
-
120
- $constant.dispose();
121
-
122
- expect(() => $constant.subscribe(onData)).toThrow("[PicoFlow] Primitive is disposed");
123
- });
124
-
125
- it("should propagate error when pick is called on throwing initializer function", async () => {
126
- const error = new Error("Compute error");
127
- const $constant = constant(() => {
128
- throw error;
129
- });
130
-
131
- await expect($constant.pick()).rejects.toThrow("Compute error");
132
- });
133
- });
134
- });
135
-
136
- describe("disposal", () => {
137
- it("should have disposed property set to false initially", () => {
138
- const $constant = constant(() => 1);
139
- expect($constant.disposed).toBe(false);
140
- });
141
-
142
- it("should have disposed property set to true after disposal", () => {
143
- const $constant = constant(() => 1);
144
- $constant.dispose();
145
- expect($constant.disposed).toBe(true);
146
- });
147
-
148
- describe("error handling", () => {
149
- it("should throw error when disposed twice", () => {
150
- const $constant = constant(() => 1);
151
- $constant.dispose();
152
- expect(() => $constant.dispose()).toThrow("[PicoFlow] Primitive is disposed");
153
- });
154
- });
155
- });
156
-
157
- describe("subscribe", () => {
158
- it("should return an effect", () => {
159
- const $constant = constant(() => 50);
160
- const onData = vi.fn();
161
- const effect = $constant.subscribe(onData);
162
-
163
- expect(effect).toBeInstanceOf(EffectNode);
164
- });
165
-
166
- it("should call onData immediately with lazy init value", async () => {
167
- const $constant = constant(() => 55);
168
- const onData = vi.fn();
169
-
170
- $constant.subscribe(onData);
171
-
172
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
173
- expect(onData).toHaveBeenLastCalledWith(55);
174
- });
175
-
176
- it("should not call onData after disposal of constant", async () => {
177
- const $constant = constant(() => 60);
178
- const onData = vi.fn();
179
-
180
- $constant.subscribe(onData);
181
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
182
-
183
- $constant.dispose();
184
-
185
- // Wait to ensure onData is not called again
186
- await new Promise((resolve) => setTimeout(resolve, 50));
187
- expect(onData).toHaveBeenCalledTimes(1);
188
- });
189
-
190
- it("should not call onData after disposer is called", async () => {
191
- const $constant = constant(() => 65);
192
- const onData = vi.fn();
193
-
194
- const effect = $constant.subscribe(onData);
195
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
196
-
197
- effect.dispose();
198
-
199
- // Wait to ensure onData is not called again
200
- await new Promise((resolve) => setTimeout(resolve, 50));
201
- expect(onData).toHaveBeenCalledTimes(1);
202
- });
203
-
204
- it("should support multiple subscriptions", async () => {
205
- const $constant = constant(() => 70);
206
- const onData1 = vi.fn();
207
- const onData2 = vi.fn();
208
- const onData3 = vi.fn();
209
-
210
- $constant.subscribe(onData1);
211
- $constant.subscribe(onData2);
212
- $constant.subscribe(onData3);
213
-
214
- await vi.waitFor(() => {
215
- expect(onData1).toHaveBeenCalledTimes(1);
216
- expect(onData2).toHaveBeenCalledTimes(1);
217
- expect(onData3).toHaveBeenCalledTimes(1);
218
- });
219
-
220
- expect(onData1).toHaveBeenLastCalledWith(70);
221
- expect(onData2).toHaveBeenLastCalledWith(70);
222
- expect(onData3).toHaveBeenLastCalledWith(70);
223
- });
224
-
225
- describe("error handling", () => {
226
- it("should throw error when subscribe is called after disposal", () => {
227
- const $constant = constant(() => 1);
228
- const onData = vi.fn();
229
-
230
- $constant.dispose();
231
-
232
- expect(() => $constant.subscribe(onData)).toThrow("[PicoFlow] Primitive is disposed");
233
- });
234
- });
235
- });
236
- });
237
-
238
- describe("with effect", () => {
239
- describe("get", () => {
240
- it("should call effect with lazy init value", async () => {
241
- const $constant = constant(() => 100);
242
- const onData = vi.fn();
243
-
244
- subscribe((t) => $constant.get(t), onData);
245
-
246
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
247
- expect(onData).toHaveBeenLastCalledWith(100);
248
- });
249
-
250
- it("should not re-execute effect when closure is mutated", async () => {
251
- let capturedValue = 5;
252
- const $constant = constant(() => capturedValue * 3);
253
-
254
- const onData = vi.fn();
255
- subscribe((t) => $constant.get(t), onData);
256
-
257
- // Initial execution with computed value (5 * 3 = 15)
258
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
259
- expect(onData).toHaveBeenLastCalledWith(15);
260
-
261
- // Change captured value - constant is cached, so effect should not re-run
262
- capturedValue = 10;
263
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
264
- expect(onData).toHaveBeenLastCalledWith(15);
265
- });
266
-
267
- it("should support multiple effects depending on same constant", async () => {
268
- const $constant = constant(() => 300);
269
- const onData1 = vi.fn();
270
- const onData2 = vi.fn();
271
- const onData3 = vi.fn();
272
-
273
- subscribe((t) => $constant.get(t), onData1);
274
- subscribe((t) => $constant.get(t), onData2);
275
- subscribe((t) => $constant.get(t), onData3);
276
-
277
- await vi.waitFor(() => {
278
- expect(onData1).toHaveBeenCalledTimes(1);
279
- expect(onData2).toHaveBeenCalledTimes(1);
280
- expect(onData3).toHaveBeenCalledTimes(1);
281
- });
282
-
283
- expect(onData1).toHaveBeenLastCalledWith(300);
284
- expect(onData2).toHaveBeenLastCalledWith(300);
285
- expect(onData3).toHaveBeenLastCalledWith(300);
286
- });
287
- });
288
-
289
- describe("watch", () => {
290
- it("should register dependency when watch is used in effect", async () => {
291
- const $constant = constant(() => 400);
292
- const onData = vi.fn();
293
-
294
- subscribe((t) => $constant.watch(t), onData);
295
-
296
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
297
- });
298
- });
299
-
300
- describe("disposal", () => {
301
- it("should not dispose effects when constant is disposed", async () => {
302
- const $constant = constant(() => 1000);
303
- const onData = vi.fn();
304
- const $effect = subscribe((t) => $constant.get(t), onData);
305
-
306
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
307
- expect($effect.disposed).toBe(false);
308
-
309
- $constant.dispose();
310
-
311
- expect($effect.disposed).toBe(false);
312
- expect($constant.disposed).toBe(true);
313
- });
314
-
315
- it("should unregister effects when constant is disposed", async () => {
316
- const $constant = constant(() => 1100);
317
- const onData = vi.fn();
318
- const $effect = subscribe((t) => $constant.get(t), onData);
319
-
320
- await vi.waitFor(() => expect(onData).toHaveBeenCalledTimes(1));
321
-
322
- $constant.dispose();
323
-
324
- // Effect should still be active but not notified
325
- expect($effect.disposed).toBe(false);
326
-
327
- // But constant is disposed so operations should fail
328
- await expect($constant.pick()).rejects.toThrow("[PicoFlow] Primitive is disposed");
329
- });
330
- });
331
-
332
- describe("error handling", () => {
333
- describe("compute function errors", () => {
334
- it("should propagate error when used inside an effect", async () => {
335
- const error = new Error("Effect compute error");
336
- const $constant = constant(() => {
337
- throw error;
338
- });
339
-
340
- const onData = vi.fn();
341
- const onError = vi.fn();
342
- subscribe((t) => $constant.get(t), onData, onError);
343
-
344
- await vi.waitFor(() => expect(onError).toHaveBeenCalledTimes(1));
345
- expect(onError).toHaveBeenLastCalledWith(error);
346
- });
347
- });
348
-
349
- describe("disposed constant", () => {
350
- it("should throw error when watching a disposed constant", async () => {
351
- const $constant = constant(() => 1);
352
- const onData = vi.fn();
353
- const onError = vi.fn();
354
-
355
- $constant.dispose();
356
-
357
- subscribe((t) => $constant.watch(t), onData, onError);
358
-
359
- await vi.waitFor(() => expect(onError).toHaveBeenCalledTimes(1));
360
- expect(onError).toHaveBeenLastCalledWith(expect.any(Error));
361
- });
362
-
363
- it("should throw error when getting a disposed constant", async () => {
364
- const $constant = constant(() => 1);
365
- const onData = vi.fn();
366
- const onError = vi.fn();
367
- $constant.dispose();
368
-
369
- subscribe((t) => $constant.get(t), onData, onError);
370
-
371
- await vi.waitFor(() => expect(onError).toHaveBeenCalledTimes(1));
372
- expect(onError).toHaveBeenLastCalledWith(expect.any(Error));
373
- });
374
- });
375
- });
376
- });
377
- });