@ersbeth/picoflow 0.2.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/.cursor/plans/update-js-e795d61b.plan.md +567 -0
  2. package/.gitlab-ci.yml +24 -0
  3. package/.vscode/settings.json +3 -3
  4. package/CHANGELOG.md +51 -0
  5. package/IMPLEMENTATION_GUIDE.md +1578 -0
  6. package/README.md +62 -25
  7. package/biome.json +32 -32
  8. package/dist/picoflow.js +557 -1099
  9. package/dist/types/advanced/array.d.ts +0 -6
  10. package/dist/types/advanced/array.d.ts.map +1 -1
  11. package/dist/types/advanced/index.d.ts +5 -5
  12. package/dist/types/advanced/index.d.ts.map +1 -1
  13. package/dist/types/advanced/map.d.ts +114 -23
  14. package/dist/types/advanced/map.d.ts.map +1 -1
  15. package/dist/types/advanced/resource.d.ts +51 -12
  16. package/dist/types/advanced/resource.d.ts.map +1 -1
  17. package/dist/types/advanced/resourceAsync.d.ts +28 -13
  18. package/dist/types/advanced/resourceAsync.d.ts.map +1 -1
  19. package/dist/types/advanced/stream.d.ts +74 -16
  20. package/dist/types/advanced/stream.d.ts.map +1 -1
  21. package/dist/types/advanced/streamAsync.d.ts +69 -15
  22. package/dist/types/advanced/streamAsync.d.ts.map +1 -1
  23. package/dist/types/basic/constant.d.ts +44 -16
  24. package/dist/types/basic/constant.d.ts.map +1 -1
  25. package/dist/types/basic/derivation.d.ts +73 -24
  26. package/dist/types/basic/derivation.d.ts.map +1 -1
  27. package/dist/types/basic/disposable.d.ts +65 -6
  28. package/dist/types/basic/disposable.d.ts.map +1 -1
  29. package/dist/types/basic/effect.d.ts +27 -16
  30. package/dist/types/basic/effect.d.ts.map +1 -1
  31. package/dist/types/basic/index.d.ts +7 -8
  32. package/dist/types/basic/index.d.ts.map +1 -1
  33. package/dist/types/basic/observable.d.ts +62 -13
  34. package/dist/types/basic/observable.d.ts.map +1 -1
  35. package/dist/types/basic/signal.d.ts +35 -6
  36. package/dist/types/basic/signal.d.ts.map +1 -1
  37. package/dist/types/basic/state.d.ts +25 -4
  38. package/dist/types/basic/state.d.ts.map +1 -1
  39. package/dist/types/basic/trackingContext.d.ts +33 -0
  40. package/dist/types/basic/trackingContext.d.ts.map +1 -0
  41. package/dist/types/creators.d.ts +271 -26
  42. package/dist/types/creators.d.ts.map +1 -1
  43. package/dist/types/index.d.ts +60 -7
  44. package/dist/types/index.d.ts.map +1 -1
  45. package/dist/types/solid/converters.d.ts +5 -5
  46. package/dist/types/solid/converters.d.ts.map +1 -1
  47. package/dist/types/solid/index.d.ts +2 -2
  48. package/dist/types/solid/index.d.ts.map +1 -1
  49. package/dist/types/solid/primitives.d.ts +96 -4
  50. package/dist/types/solid/primitives.d.ts.map +1 -1
  51. package/docs/.vitepress/config.mts +110 -0
  52. package/docs/api/classes/FlowArray.md +489 -0
  53. package/docs/api/classes/FlowConstant.md +350 -0
  54. package/docs/api/classes/FlowDerivation.md +334 -0
  55. package/docs/api/classes/FlowEffect.md +100 -0
  56. package/docs/api/classes/FlowMap.md +512 -0
  57. package/docs/api/classes/FlowObservable.md +306 -0
  58. package/docs/api/classes/FlowResource.md +380 -0
  59. package/docs/api/classes/FlowResourceAsync.md +362 -0
  60. package/docs/api/classes/FlowSignal.md +160 -0
  61. package/docs/api/classes/FlowState.md +368 -0
  62. package/docs/api/classes/FlowStream.md +367 -0
  63. package/docs/api/classes/FlowStreamAsync.md +364 -0
  64. package/docs/api/classes/SolidDerivation.md +75 -0
  65. package/docs/api/classes/SolidResource.md +91 -0
  66. package/docs/api/classes/SolidState.md +71 -0
  67. package/docs/api/classes/TrackingContext.md +33 -0
  68. package/docs/api/functions/array.md +58 -0
  69. package/docs/api/functions/constant.md +45 -0
  70. package/docs/api/functions/derivation.md +53 -0
  71. package/docs/api/functions/effect.md +49 -0
  72. package/docs/api/functions/from.md +220 -0
  73. package/docs/api/functions/isDisposable.md +49 -0
  74. package/docs/api/functions/map.md +57 -0
  75. package/docs/api/functions/resource.md +52 -0
  76. package/docs/api/functions/resourceAsync.md +50 -0
  77. package/docs/api/functions/signal.md +36 -0
  78. package/docs/api/functions/state.md +47 -0
  79. package/docs/api/functions/stream.md +53 -0
  80. package/docs/api/functions/streamAsync.md +50 -0
  81. package/docs/api/index.md +118 -0
  82. package/docs/api/interfaces/FlowDisposable.md +65 -0
  83. package/docs/api/interfaces/SolidObservable.md +19 -0
  84. package/docs/api/type-aliases/FlowArrayAction.md +49 -0
  85. package/docs/api/type-aliases/FlowStreamDisposer.md +15 -0
  86. package/docs/api/type-aliases/FlowStreamSetter.md +27 -0
  87. package/docs/api/type-aliases/FlowStreamUpdater.md +32 -0
  88. package/docs/api/type-aliases/NotPromise.md +18 -0
  89. package/docs/api/type-aliases/SolidGetter.md +17 -0
  90. package/docs/api/typedoc-sidebar.json +1 -0
  91. package/docs/examples/examples.md +2313 -0
  92. package/docs/examples/patterns.md +649 -0
  93. package/docs/guide/advanced/disposal.md +426 -0
  94. package/docs/guide/advanced/solidjs.md +221 -0
  95. package/docs/guide/advanced/upgrading.md +464 -0
  96. package/docs/guide/introduction/concepts.md +56 -0
  97. package/docs/guide/introduction/conventions.md +61 -0
  98. package/docs/guide/introduction/getting-started.md +134 -0
  99. package/docs/guide/introduction/lifecycle.md +371 -0
  100. package/docs/guide/primitives/array.md +400 -0
  101. package/docs/guide/primitives/constant.md +380 -0
  102. package/docs/guide/primitives/derivations.md +348 -0
  103. package/docs/guide/primitives/effects.md +458 -0
  104. package/docs/guide/primitives/map.md +387 -0
  105. package/docs/guide/primitives/overview.md +175 -0
  106. package/docs/guide/primitives/resources.md +858 -0
  107. package/docs/guide/primitives/signal.md +259 -0
  108. package/docs/guide/primitives/state.md +368 -0
  109. package/docs/guide/primitives/streams.md +931 -0
  110. package/docs/index.md +47 -0
  111. package/docs/public/logo.svg +1 -0
  112. package/package.json +57 -41
  113. package/src/advanced/array.ts +208 -210
  114. package/src/advanced/index.ts +7 -7
  115. package/src/advanced/map.ts +178 -68
  116. package/src/advanced/resource.ts +87 -43
  117. package/src/advanced/resourceAsync.ts +62 -42
  118. package/src/advanced/stream.ts +113 -50
  119. package/src/advanced/streamAsync.ts +120 -61
  120. package/src/basic/constant.ts +82 -49
  121. package/src/basic/derivation.ts +128 -84
  122. package/src/basic/disposable.ts +74 -15
  123. package/src/basic/effect.ts +85 -77
  124. package/src/basic/index.ts +7 -8
  125. package/src/basic/observable.ts +94 -36
  126. package/src/basic/signal.ts +133 -105
  127. package/src/basic/state.ts +46 -25
  128. package/src/basic/trackingContext.ts +45 -0
  129. package/src/creators.ts +297 -54
  130. package/src/index.ts +96 -43
  131. package/src/solid/converters.ts +186 -67
  132. package/src/solid/index.ts +8 -2
  133. package/src/solid/primitives.ts +167 -65
  134. package/test/array.test.ts +592 -612
  135. package/test/constant.test.ts +31 -33
  136. package/test/derivation.test.ts +531 -536
  137. package/test/effect.test.ts +21 -21
  138. package/test/map.test.ts +233 -137
  139. package/test/resource.test.ts +119 -121
  140. package/test/resourceAsync.test.ts +98 -100
  141. package/test/signal.test.ts +51 -55
  142. package/test/state.test.ts +186 -168
  143. package/test/stream.test.ts +189 -189
  144. package/test/streamAsync.test.ts +186 -186
  145. package/tsconfig.json +19 -18
  146. package/typedoc.json +37 -0
  147. package/vite.config.ts +23 -20
  148. package/vitest.config.ts +7 -7
  149. package/api/doc/index.md +0 -31
  150. package/api/doc/picoflow.array.md +0 -55
  151. package/api/doc/picoflow.constant.md +0 -55
  152. package/api/doc/picoflow.derivation.md +0 -55
  153. package/api/doc/picoflow.effect.md +0 -55
  154. package/api/doc/picoflow.flowarray._constructor_.md +0 -49
  155. package/api/doc/picoflow.flowarray._lastaction.md +0 -13
  156. package/api/doc/picoflow.flowarray.clear.md +0 -17
  157. package/api/doc/picoflow.flowarray.dispose.md +0 -55
  158. package/api/doc/picoflow.flowarray.get.md +0 -19
  159. package/api/doc/picoflow.flowarray.length.md +0 -13
  160. package/api/doc/picoflow.flowarray.md +0 -273
  161. package/api/doc/picoflow.flowarray.pop.md +0 -17
  162. package/api/doc/picoflow.flowarray.push.md +0 -53
  163. package/api/doc/picoflow.flowarray.set.md +0 -53
  164. package/api/doc/picoflow.flowarray.setitem.md +0 -69
  165. package/api/doc/picoflow.flowarray.shift.md +0 -17
  166. package/api/doc/picoflow.flowarray.splice.md +0 -85
  167. package/api/doc/picoflow.flowarray.unshift.md +0 -53
  168. package/api/doc/picoflow.flowarrayaction.md +0 -37
  169. package/api/doc/picoflow.flowconstant._constructor_.md +0 -49
  170. package/api/doc/picoflow.flowconstant.get.md +0 -25
  171. package/api/doc/picoflow.flowconstant.md +0 -88
  172. package/api/doc/picoflow.flowderivation._constructor_.md +0 -49
  173. package/api/doc/picoflow.flowderivation.get.md +0 -23
  174. package/api/doc/picoflow.flowderivation.md +0 -86
  175. package/api/doc/picoflow.flowdisposable.dispose.md +0 -55
  176. package/api/doc/picoflow.flowdisposable.md +0 -43
  177. package/api/doc/picoflow.floweffect._constructor_.md +0 -54
  178. package/api/doc/picoflow.floweffect.dispose.md +0 -21
  179. package/api/doc/picoflow.floweffect.disposed.md +0 -13
  180. package/api/doc/picoflow.floweffect.md +0 -131
  181. package/api/doc/picoflow.flowgetter.md +0 -15
  182. package/api/doc/picoflow.flowmap._lastdeleted.md +0 -21
  183. package/api/doc/picoflow.flowmap._lastset.md +0 -21
  184. package/api/doc/picoflow.flowmap.delete.md +0 -61
  185. package/api/doc/picoflow.flowmap.md +0 -133
  186. package/api/doc/picoflow.flowmap.setat.md +0 -77
  187. package/api/doc/picoflow.flowobservable.get.md +0 -19
  188. package/api/doc/picoflow.flowobservable.md +0 -68
  189. package/api/doc/picoflow.flowobservable.subscribe.md +0 -55
  190. package/api/doc/picoflow.flowresource._constructor_.md +0 -49
  191. package/api/doc/picoflow.flowresource.fetch.md +0 -27
  192. package/api/doc/picoflow.flowresource.get.md +0 -23
  193. package/api/doc/picoflow.flowresource.md +0 -100
  194. package/api/doc/picoflow.flowresourceasync._constructor_.md +0 -49
  195. package/api/doc/picoflow.flowresourceasync.fetch.md +0 -27
  196. package/api/doc/picoflow.flowresourceasync.get.md +0 -23
  197. package/api/doc/picoflow.flowresourceasync.md +0 -100
  198. package/api/doc/picoflow.flowsignal.dispose.md +0 -59
  199. package/api/doc/picoflow.flowsignal.disposed.md +0 -18
  200. package/api/doc/picoflow.flowsignal.md +0 -112
  201. package/api/doc/picoflow.flowsignal.trigger.md +0 -21
  202. package/api/doc/picoflow.flowstate.md +0 -52
  203. package/api/doc/picoflow.flowstate.set.md +0 -61
  204. package/api/doc/picoflow.flowstream._constructor_.md +0 -49
  205. package/api/doc/picoflow.flowstream.dispose.md +0 -21
  206. package/api/doc/picoflow.flowstream.get.md +0 -23
  207. package/api/doc/picoflow.flowstream.md +0 -100
  208. package/api/doc/picoflow.flowstreamasync._constructor_.md +0 -54
  209. package/api/doc/picoflow.flowstreamasync.dispose.md +0 -21
  210. package/api/doc/picoflow.flowstreamasync.get.md +0 -23
  211. package/api/doc/picoflow.flowstreamasync.md +0 -100
  212. package/api/doc/picoflow.flowstreamdisposer.md +0 -13
  213. package/api/doc/picoflow.flowstreamsetter.md +0 -13
  214. package/api/doc/picoflow.flowstreamupdater.md +0 -19
  215. package/api/doc/picoflow.flowwatcher.md +0 -15
  216. package/api/doc/picoflow.from.md +0 -55
  217. package/api/doc/picoflow.from_1.md +0 -55
  218. package/api/doc/picoflow.from_2.md +0 -55
  219. package/api/doc/picoflow.from_3.md +0 -55
  220. package/api/doc/picoflow.from_4.md +0 -55
  221. package/api/doc/picoflow.from_5.md +0 -55
  222. package/api/doc/picoflow.isdisposable.md +0 -55
  223. package/api/doc/picoflow.map.md +0 -59
  224. package/api/doc/picoflow.md +0 -544
  225. package/api/doc/picoflow.resource.md +0 -55
  226. package/api/doc/picoflow.resourceasync.md +0 -55
  227. package/api/doc/picoflow.signal.md +0 -19
  228. package/api/doc/picoflow.solidderivation._constructor_.md +0 -49
  229. package/api/doc/picoflow.solidderivation.get.md +0 -13
  230. package/api/doc/picoflow.solidderivation.md +0 -94
  231. package/api/doc/picoflow.solidgetter.md +0 -13
  232. package/api/doc/picoflow.solidobservable.get.md +0 -13
  233. package/api/doc/picoflow.solidobservable.md +0 -57
  234. package/api/doc/picoflow.solidresource._constructor_.md +0 -49
  235. package/api/doc/picoflow.solidresource.get.md +0 -13
  236. package/api/doc/picoflow.solidresource.latest.md +0 -13
  237. package/api/doc/picoflow.solidresource.md +0 -157
  238. package/api/doc/picoflow.solidresource.refetch.md +0 -13
  239. package/api/doc/picoflow.solidresource.state.md +0 -13
  240. package/api/doc/picoflow.solidstate._constructor_.md +0 -49
  241. package/api/doc/picoflow.solidstate.get.md +0 -13
  242. package/api/doc/picoflow.solidstate.md +0 -115
  243. package/api/doc/picoflow.solidstate.set.md +0 -13
  244. package/api/doc/picoflow.state.md +0 -55
  245. package/api/doc/picoflow.stream.md +0 -55
  246. package/api/doc/picoflow.streamasync.md +0 -55
  247. package/api/picoflow.public.api.md +0 -244
  248. package/api-extractor.json +0 -61
@@ -2,28 +2,28 @@ import { describe, expect, test, vi } from "vitest";
2
2
  import { effect, signal } from "#package";
3
3
 
4
4
  describe("effect", () => {
5
- test("disposed is correct", () => {
6
- const $signal = signal();
7
- const effectFn = vi.fn();
8
- const $effect = effect((_, watch) => {
9
- watch($signal);
10
- effectFn();
11
- });
5
+ test("disposed is correct", () => {
6
+ const $signal = signal();
7
+ const effectFn = vi.fn();
8
+ const $effect = effect((t) => {
9
+ $signal.watch(t);
10
+ effectFn();
11
+ });
12
12
 
13
- expect($effect.disposed).toBe(false);
14
- $effect.dispose();
15
- expect($effect.disposed).toBe(true);
16
- });
13
+ expect($effect.disposed).toBe(false);
14
+ $effect.dispose();
15
+ expect($effect.disposed).toBe(true);
16
+ });
17
17
 
18
- test("throw when disposed twice", () => {
19
- const $signal = signal();
20
- const effectFn = vi.fn();
21
- const $effect = effect((_, watch) => {
22
- watch($signal);
23
- effectFn();
24
- });
18
+ test("throw when disposed twice", () => {
19
+ const $signal = signal();
20
+ const effectFn = vi.fn();
21
+ const $effect = effect((t) => {
22
+ $signal.watch(t);
23
+ effectFn();
24
+ });
25
25
 
26
- $effect.dispose();
27
- expect(() => $effect.dispose()).toThrow("Effect is disposed");
28
- });
26
+ $effect.dispose();
27
+ expect(() => $effect.dispose()).toThrow("Effect is disposed");
28
+ });
29
29
  });
package/test/map.test.ts CHANGED
@@ -1,144 +1,240 @@
1
1
  import { describe, expect, test, vi } from "vitest";
2
- import { effect, map } from "#package";
2
+ import { effect, type FlowState, map, state } from "#package";
3
3
 
4
4
  describe("map", () => {
5
- test("is initialized", () => {
6
- const $map = map({
7
- key1: 1,
8
- key2: 2,
9
- key3: 3,
10
- });
11
-
12
- expect(Array.from($map.get().entries())).toEqual([
13
- ["key1", 1],
14
- ["key2", 2],
15
- ["key3", 3],
16
- ]);
17
- });
18
-
19
- test("is updated", () => {
20
- const $map = map();
21
-
22
- expect(Array.from($map.get().entries())).toEqual([]);
23
-
24
- $map.setAt("key1", 1);
25
- expect($map.get().get("key1")).toBe(1);
26
- expect($map.$lastSet.get()).toEqual({ key: "key1", value: 1 });
27
-
28
- $map.setAt("key2", 2);
29
- expect($map.get().get("key1")).toBe(1);
30
- expect($map.get().get("key2")).toBe(2);
31
- expect($map.$lastSet.get()).toEqual({ key: "key2", value: 2 });
32
-
33
- $map.setAt("key1", 3);
34
- expect($map.get().get("key1")).toBe(3);
35
- expect($map.get().get("key2")).toBe(2);
36
- expect($map.$lastSet.get()).toEqual({ key: "key1", value: 3 });
37
-
38
- $map.delete("key1");
39
- expect($map.get().get("key1")).toBe(undefined);
40
- expect($map.get().get("key2")).toBe(2);
41
- expect($map.$lastDeleted.get()).toEqual({ key: "key1", value: 3 });
42
- });
43
-
44
- test("get throws when disposed", () => {
45
- const $map = map({ key1: 1, key2: 2, key3: 3 });
46
- $map.dispose();
47
- expect(() => $map.get()).toThrowError(
48
- "[PicoFlow] Primitive is disposed",
49
- );
50
- });
51
-
52
- test("set throws when disposed", () => {
53
- const $map = map<string, number>();
54
- $map.dispose();
55
- expect(() => $map.setAt("key1", 2)).toThrowError(
56
- "[PicoFlow] Primitive is disposed",
57
- );
58
- });
59
-
60
- test("delete throws when disposed", () => {
61
- const $map = map<string, number>({ key1: 1, key2: 2, key3: 3 });
62
- $map.dispose();
63
- expect(() => $map.delete("key1")).toThrowError(
64
- "[PicoFlow] Primitive is disposed",
65
- );
66
- });
5
+ test("is initialized", () => {
6
+ const $map = map({
7
+ key1: 1,
8
+ key2: 2,
9
+ key3: 3,
10
+ });
11
+
12
+ expect(Array.from($map.pick().entries())).toEqual([
13
+ ["key1", 1],
14
+ ["key2", 2],
15
+ ["key3", 3],
16
+ ]);
17
+ });
18
+
19
+ test("is updated", () => {
20
+ const $map = map();
21
+
22
+ expect(Array.from($map.pick().entries())).toEqual([]);
23
+
24
+ $map.add("key1", 1);
25
+ expect($map.pick().get("key1")).toBe(1);
26
+ expect($map.$lastAdded.pick()).toEqual({ key: "key1", value: 1 });
27
+
28
+ $map.add("key2", 2);
29
+ expect($map.pick().get("key1")).toBe(1);
30
+ expect($map.pick().get("key2")).toBe(2);
31
+ expect($map.$lastAdded.pick()).toEqual({ key: "key2", value: 2 });
32
+
33
+ $map.update("key1", 3);
34
+ expect($map.pick().get("key1")).toBe(3);
35
+ expect($map.pick().get("key2")).toBe(2);
36
+ expect($map.$lastUpdated.pick()).toEqual({ key: "key1", value: 3 });
37
+
38
+ $map.delete("key1");
39
+ expect($map.pick().get("key1")).toBe(undefined);
40
+ expect($map.pick().get("key2")).toBe(2);
41
+ expect($map.$lastDeleted.pick()).toEqual({ key: "key1", value: 3 });
42
+ });
43
+
44
+ test("get throws when disposed", () => {
45
+ const $map = map({ key1: 1, key2: 2, key3: 3 });
46
+ $map.dispose();
47
+ expect(() => $map.pick()).toThrowError("[PicoFlow] Primitive is disposed");
48
+ });
49
+
50
+ test("add throws when disposed", () => {
51
+ const $map = map<string, number>();
52
+ $map.dispose();
53
+ expect(() => $map.add("key1", 2)).toThrowError(
54
+ "[PicoFlow] Primitive is disposed",
55
+ );
56
+ });
57
+
58
+ test("update throws when disposed", () => {
59
+ const $map = map<string, number>();
60
+ $map.add("key1", 1);
61
+ $map.dispose();
62
+ expect(() => $map.update("key1", 2)).toThrowError(
63
+ "[PicoFlow] Primitive is disposed",
64
+ );
65
+ });
66
+
67
+ test("delete throws when disposed", () => {
68
+ const $map = map<string, number>({ key1: 1, key2: 2, key3: 3 });
69
+ $map.dispose();
70
+ expect(() => $map.delete("key1")).toThrowError(
71
+ "[PicoFlow] Primitive is disposed",
72
+ );
73
+ });
74
+
75
+ test("add throws when key already exists", () => {
76
+ const $map = map<string, number>();
77
+ $map.add("key1", 1);
78
+ expect(() => $map.add("key1", 2)).toThrowError(
79
+ "[PicoFlow] Key already exists",
80
+ );
81
+ });
82
+
83
+ test("update throws when key does not exist", () => {
84
+ const $map = map<string, number>();
85
+ expect(() => $map.update("key1", 1)).toThrowError(
86
+ "[PicoFlow] Key does not exist",
87
+ );
88
+ });
89
+
90
+ test("dispose disposes map values that are disposable", () => {
91
+ const $map = map<string, FlowState<number>>();
92
+ const $value1 = state(1);
93
+ const $value2 = state(2);
94
+ const $value3 = state(3);
95
+
96
+ $map.add("key1", $value1);
97
+ $map.add("key2", $value2);
98
+ $map.add("key3", $value3);
99
+
100
+ expect($value1.disposed).toBe(false);
101
+ expect($value2.disposed).toBe(false);
102
+ expect($value3.disposed).toBe(false);
103
+
104
+ $map.dispose();
105
+
106
+ expect($value1.disposed).toBe(true);
107
+ expect($value2.disposed).toBe(true);
108
+ expect($value3.disposed).toBe(true);
109
+ });
110
+
111
+ test("dispose clears the map after disposing values", () => {
112
+ const $map = map<string, FlowState<number>>();
113
+ const $value1 = state(1);
114
+ const $value2 = state(2);
115
+
116
+ $map.add("key1", $value1);
117
+ $map.add("key2", $value2);
118
+
119
+ expect($map.pick().size).toBe(2);
120
+
121
+ $map.dispose();
122
+
123
+ // Map is cleared during disposal, but we can't verify after disposal
124
+ // since pick() will throw. We verify the values were disposed instead.
125
+ expect($value1.disposed).toBe(true);
126
+ expect($value2.disposed).toBe(true);
127
+ });
128
+
129
+ test("dispose handles non-disposable values gracefully", () => {
130
+ const $map = map<string, number>();
131
+ $map.add("key1", 1);
132
+ $map.add("key2", 2);
133
+ $map.add("key3", 3);
134
+
135
+ expect($map.pick().size).toBe(3);
136
+
137
+ // Should not throw even with non-disposable values
138
+ expect(() => $map.dispose()).not.toThrow();
139
+ });
140
+
141
+ test("dispose passes options to value disposal", () => {
142
+ const $map = map<string, FlowState<number>>();
143
+ const $value1 = state(1);
144
+ const $value2 = state(2);
145
+
146
+ $map.add("key1", $value1);
147
+ $map.add("key2", $value2);
148
+
149
+ // Create an effect that depends on value1
150
+ const fx = effect((t) => {
151
+ $value1.get(t);
152
+ });
153
+
154
+ expect(fx.disposed).toBe(false);
155
+
156
+ // Dispose with self: true - should only dispose the map and values, not dependent effects
157
+ $map.dispose({ self: true });
158
+
159
+ expect($value1.disposed).toBe(true);
160
+ expect($value2.disposed).toBe(true);
161
+ // Effect should still be active since we used self: true
162
+ expect(fx.disposed).toBe(false);
163
+
164
+ fx.dispose();
165
+ });
67
166
  });
68
167
 
69
168
  describe("effect", () => {
70
- test("called when map is updated", () => {
71
- const $map = map();
72
- const onSetFn = vi.fn();
73
- const onSetAtFn = vi.fn();
74
- const onDeleteFn = vi.fn();
75
-
76
- effect((get) => onSetFn(get($map)));
77
- effect((get) => onSetAtFn(get($map.$lastSet)));
78
- effect((get) => onDeleteFn(get($map.$lastDeleted)));
79
-
80
- expect(onSetFn).toHaveBeenCalledTimes(1);
81
- expect(onSetFn).toHaveBeenLastCalledWith(new Map());
82
- expect(onSetAtFn).toHaveBeenCalledTimes(1);
83
- expect(onSetAtFn).toHaveBeenLastCalledWith({
84
- key: undefined,
85
- value: undefined,
86
- });
87
- expect(onDeleteFn).toHaveBeenCalledTimes(1);
88
- expect(onDeleteFn).toHaveBeenLastCalledWith({
89
- key: undefined,
90
- value: undefined,
91
- });
92
-
93
- $map.setAt("key1", 1);
94
- expect(onSetFn).toHaveBeenCalledTimes(2);
95
- expect(onSetFn).toHaveBeenLastCalledWith(new Map([["key1", 1]]));
96
- expect(onSetAtFn).toHaveBeenCalledTimes(2);
97
- expect(onSetAtFn).toHaveBeenLastCalledWith({ key: "key1", value: 1 });
98
- expect(onDeleteFn).toHaveBeenCalledTimes(1);
99
- expect(onDeleteFn).toHaveBeenLastCalledWith({
100
- key: undefined,
101
- value: undefined,
102
- });
103
-
104
- $map.setAt("key2", 2);
105
- expect(onSetFn).toHaveBeenCalledTimes(3);
106
- expect(onSetFn).toHaveBeenLastCalledWith(
107
- new Map([
108
- ["key1", 1],
109
- ["key2", 2],
110
- ]),
111
- );
112
- expect(onSetAtFn).toHaveBeenCalledTimes(3);
113
- expect(onSetAtFn).toHaveBeenLastCalledWith({ key: "key2", value: 2 });
114
- expect(onDeleteFn).toHaveBeenCalledTimes(1);
115
- expect(onDeleteFn).toHaveBeenLastCalledWith({
116
- key: undefined,
117
- value: undefined,
118
- });
119
-
120
- $map.setAt("key1", 3);
121
- expect(onSetFn).toHaveBeenCalledTimes(4);
122
- expect(onSetFn).toHaveBeenLastCalledWith(
123
- new Map([
124
- ["key1", 3],
125
- ["key2", 2],
126
- ]),
127
- );
128
- expect(onSetAtFn).toHaveBeenCalledTimes(4);
129
- expect(onSetAtFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
130
- expect(onDeleteFn).toHaveBeenCalledTimes(1);
131
- expect(onDeleteFn).toHaveBeenLastCalledWith({
132
- key: undefined,
133
- value: undefined,
134
- });
135
-
136
- $map.delete("key1");
137
- expect(onSetFn).toHaveBeenCalledTimes(5);
138
- expect(onSetFn).toHaveBeenLastCalledWith(new Map([["key2", 2]]));
139
- expect(onSetAtFn).toHaveBeenCalledTimes(4);
140
- expect(onSetAtFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
141
- expect(onDeleteFn).toHaveBeenCalledTimes(2);
142
- expect(onDeleteFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
143
- });
169
+ test("called when map is updated", () => {
170
+ const $map = map();
171
+ const onSetFn = vi.fn();
172
+ const onAddFn = vi.fn();
173
+ const onUpdateFn = vi.fn();
174
+ const onDeleteFn = vi.fn();
175
+
176
+ effect((t) => onSetFn($map.get(t)));
177
+ effect((t) => onAddFn($map.$lastAdded.get(t)));
178
+ effect((t) => onUpdateFn($map.$lastUpdated.get(t)));
179
+ effect((t) => onDeleteFn($map.$lastDeleted.get(t)));
180
+
181
+ expect(onSetFn).toHaveBeenCalledTimes(1);
182
+ expect(onSetFn).toHaveBeenLastCalledWith(new Map());
183
+ expect(onAddFn).toHaveBeenCalledTimes(1);
184
+ expect(onAddFn).toHaveBeenLastCalledWith(null);
185
+ expect(onUpdateFn).toHaveBeenCalledTimes(1);
186
+ expect(onUpdateFn).toHaveBeenLastCalledWith(null);
187
+ expect(onDeleteFn).toHaveBeenCalledTimes(1);
188
+ expect(onDeleteFn).toHaveBeenLastCalledWith(null);
189
+
190
+ $map.add("key1", 1);
191
+ expect(onSetFn).toHaveBeenCalledTimes(2);
192
+ expect(onSetFn).toHaveBeenLastCalledWith(new Map([["key1", 1]]));
193
+ expect(onAddFn).toHaveBeenCalledTimes(2);
194
+ expect(onAddFn).toHaveBeenLastCalledWith({ key: "key1", value: 1 });
195
+ expect(onUpdateFn).toHaveBeenCalledTimes(1);
196
+ expect(onUpdateFn).toHaveBeenLastCalledWith(null);
197
+ expect(onDeleteFn).toHaveBeenCalledTimes(1);
198
+ expect(onDeleteFn).toHaveBeenLastCalledWith(null);
199
+
200
+ $map.add("key2", 2);
201
+ expect(onSetFn).toHaveBeenCalledTimes(3);
202
+ expect(onSetFn).toHaveBeenLastCalledWith(
203
+ new Map([
204
+ ["key1", 1],
205
+ ["key2", 2],
206
+ ]),
207
+ );
208
+ expect(onAddFn).toHaveBeenCalledTimes(3);
209
+ expect(onAddFn).toHaveBeenLastCalledWith({ key: "key2", value: 2 });
210
+ expect(onUpdateFn).toHaveBeenCalledTimes(1);
211
+ expect(onUpdateFn).toHaveBeenLastCalledWith(null);
212
+ expect(onDeleteFn).toHaveBeenCalledTimes(1);
213
+ expect(onDeleteFn).toHaveBeenLastCalledWith(null);
214
+
215
+ $map.update("key1", 3);
216
+ expect(onSetFn).toHaveBeenCalledTimes(4);
217
+ expect(onSetFn).toHaveBeenLastCalledWith(
218
+ new Map([
219
+ ["key1", 3],
220
+ ["key2", 2],
221
+ ]),
222
+ );
223
+ expect(onAddFn).toHaveBeenCalledTimes(3);
224
+ expect(onAddFn).toHaveBeenLastCalledWith({ key: "key2", value: 2 });
225
+ expect(onUpdateFn).toHaveBeenCalledTimes(2);
226
+ expect(onUpdateFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
227
+ expect(onDeleteFn).toHaveBeenCalledTimes(1);
228
+ expect(onDeleteFn).toHaveBeenLastCalledWith(null);
229
+
230
+ $map.delete("key1");
231
+ expect(onSetFn).toHaveBeenCalledTimes(5);
232
+ expect(onSetFn).toHaveBeenLastCalledWith(new Map([["key2", 2]]));
233
+ expect(onAddFn).toHaveBeenCalledTimes(3);
234
+ expect(onAddFn).toHaveBeenLastCalledWith({ key: "key2", value: 2 });
235
+ expect(onUpdateFn).toHaveBeenCalledTimes(2);
236
+ expect(onUpdateFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
237
+ expect(onDeleteFn).toHaveBeenCalledTimes(2);
238
+ expect(onDeleteFn).toHaveBeenLastCalledWith({ key: "key1", value: 3 });
239
+ });
144
240
  });