@ersbeth/picoflow 1.0.1 → 1.1.0

package/test/collections/flowMap.states.test.ts

@@ -0,0 +1,1097 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { effect, FlowGraph, type FlowState, map, state } from "#package";
+
+describe("FlowMap", () => {
+	describe("unit", () => {
+		describe("initialization", () => {
+			it("should initialize with provided Record of FlowState values", async () => {
+				const $map = map({
+					key1: state(1),
+					key2: state(2),
+					key3: state(3),
+				});
+
+				const values = await Promise.all(
+					Array.from((await $map.pick()).entries()).map(([_, value]) =>
+						value.pick(),
+					),
+				);
+
+				expect(values).toEqual([1, 2, 3]);
+			});
+
+			it("should initialize with provided Map of FlowState values", async () => {
+				const $value1 = state(1);
+				const $value2 = state(2);
+				const initialMap = new Map([
+					["key1", $value1],
+					["key2", $value2],
+				]);
+				const $map = map(initialMap);
+
+				expect(Array.from((await $map.pick()).entries())).toEqual([
+					["key1", $value1],
+					["key2", $value2],
+				]);
+			});
+
+			it("should initialize with empty map when no value provided", async () => {
+				const $map = map<string, FlowState<number>>();
+
+				expect(Array.from((await $map.pick()).entries())).toEqual([]);
+				expect((await $map.pick()).size).toBe(0);
+			});
+
+			it("should initialize $lastAction with set action on creation", async () => {
+				const $value1 = state(1);
+				const $value2 = state(2);
+				const $map = map({
+					key1: $value1,
+					key2: $value2,
+				});
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("set");
+				if (action.type === "set") {
+					expect(action.map.size).toBe(2);
+					expect(action.map.get("key1")).toBe($value1);
+					expect(action.map.get("key2")).toBe($value2);
+				}
+			});
+
+			it("should initialize $lastAction with empty map when no value provided", async () => {
+				const $map = map<string, FlowState<number>>();
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("set");
+				if (action.type === "set") {
+					expect(action.map.size).toBe(0);
+				}
+			});
+		});
+
+		describe("disposal", () => {
+			it("should have disposed property set to false initially and true after disposal", () => {
+				const $map = map({
+					key1: state(1),
+					key2: state(2),
+				});
+				expect($map.disposed).toBe(false);
+				$map.dispose();
+				expect($map.disposed).toBe(true);
+			});
+
+			it("should throw error when disposed twice", () => {
+				const $map = map({
+					key1: state(1),
+					key2: state(2),
+				});
+				$map.dispose();
+				expect(() => $map.dispose()).toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when pick is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+					key3: state(3),
+				});
+				$map.dispose();
+				await expect($map.pick()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when set is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+				});
+				$map.dispose();
+				await expect($map.set(new Map([["key2", state(2)]]))).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when add is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>();
+				$map.dispose();
+				await expect($map.add("key1", state(2))).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when update is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				$map.dispose();
+				await expect($map.update("key1", state(2))).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when delete is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+					key3: state(3),
+				});
+				$map.dispose();
+				await expect($map.delete("key1")).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when clear is called after disposal", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+				});
+				$map.dispose();
+				await expect($map.clear()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should dispose values when FlowMap is disposed", () => {
+				const $map = map<string, FlowState<number>>();
+				const $value1 = state(1);
+				const $value2 = state(2);
+				const $value3 = state(3);
+
+				$map.add("key1", $value1);
+				$map.add("key2", $value2);
+				$map.add("key3", $value3);
+
+				expect($value1.disposed).toBe(false);
+				expect($value2.disposed).toBe(false);
+				expect($value3.disposed).toBe(false);
+
+				$map.dispose();
+
+				expect($value1.disposed).toBe(true);
+				expect($value2.disposed).toBe(true);
+				expect($value3.disposed).toBe(true);
+			});
+
+			it("should dispose values with provided options when FlowMap is disposed", () => {
+				const $map = map<string, FlowState<number>>();
+				const $value1 = state(1);
+				const $value2 = state(2);
+
+				$map.add("key1", $value1);
+				$map.add("key2", $value2);
+
+				const $effect = effect((t) => {
+					$value1.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				$map.dispose({ self: true });
+
+				expect($value1.disposed).toBe(true);
+				expect($value2.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+
+				$effect.dispose();
+			});
+
+			it("should handle non-disposable values gracefully", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+				await $map.add("key3", state(3));
+
+				expect((await $map.pick()).size).toBe(3);
+
+				expect(() => $map.dispose()).not.toThrow();
+			});
+		});
+
+		describe("set", () => {
+			it("should replace entire map when set is called", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+				});
+				const $newValue1 = state(3);
+				const $newValue2 = state(4);
+				const newMap = new Map([
+					["key3", $newValue1],
+					["key4", $newValue2],
+				]);
+
+				await $map.set(newMap);
+				expect(Array.from((await $map.pick()).entries())).toEqual([
+					["key3", $newValue1],
+					["key4", $newValue2],
+				]);
+			});
+
+			it("should dispose values when set replaces map", async () => {
+				const $oldValue1 = state(1);
+				const $oldValue2 = state(2);
+				const $map = map(
+					new Map([
+						["key1", $oldValue1],
+						["key2", $oldValue2],
+					]),
+				);
+
+				expect($oldValue1.disposed).toBe(false);
+				expect($oldValue2.disposed).toBe(false);
+
+				await $map.set(
+					new Map([
+						["key3", state(3)],
+						["key4", state(4)],
+					]),
+				);
+
+				expect($oldValue1.disposed).toBe(true);
+				expect($oldValue2.disposed).toBe(true);
+			});
+
+			it("should dispose values with self option when set replaces map", async () => {
+				const $oldValue = state(1);
+				const $map = map(new Map([["key1", $oldValue]]));
+
+				const $effect = effect((t) => {
+					$oldValue.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $map.set(new Map([["key2", state(2)]]));
+
+				expect($oldValue.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+
+				$effect.dispose();
+			});
+
+			it("should update $lastAction with set action when set is called", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+				});
+				const $newValue1 = state(3);
+				const $newValue2 = state(4);
+				const newMap = new Map([
+					["key3", $newValue1],
+					["key4", $newValue2],
+				]);
+
+				await $map.set(newMap);
+				const action = await $map.$lastAction.pick();
+				expect(action).toEqual({
+					type: "set",
+					map: newMap,
+				});
+			});
+		});
+
+		describe("add", () => {
+			it("should add key-value pair to map", async () => {
+				const $map = map<string, FlowState<number>>();
+
+				await $map.add("key1", state(1));
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(1);
+				expect((await $map.pick()).size).toBe(1);
+			});
+
+			it("should add multiple keys successively", async () => {
+				const $map = map<string, FlowState<number>>();
+
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+				await $map.add("key3", state(3));
+
+				expect((await $map.pick()).size).toBe(3);
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(1);
+				expect(await (await $map.pick()).get("key2")?.pick()).toBe(2);
+				expect(await (await $map.pick()).get("key3")?.pick()).toBe(3);
+			});
+
+			it("should throw when key already exists", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await expect($map.add("key1", state(2))).rejects.toThrow(
+					"[PicoFlow] Key already exists",
+				);
+			});
+
+			it("should update $lastAction with add action when add is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const $value = state(1);
+				await $map.add("key1", $value);
+				const action = await $map.$lastAction.pick();
+				expect(action).toEqual({
+					type: "add",
+					key: "key1",
+					value: $value,
+				});
+			});
+
+			it("should have FlowState value in $lastAction when add is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const $value = state(100);
+				await $map.add("key1", $value);
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("add");
+				if (action.type === "add") {
+					expect(action.value).toBe($value);
+					expect(await action.value.pick()).toBe(100);
+				}
+			});
+
+			it("should trigger reactivity when add is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const effectFn = vi.fn();
+				effect((t) => effectFn($map.get(t)));
+
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+				await $map.add("key1", state(1));
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+			});
+		});
+
+		describe("update", () => {
+			it("should update existing key-value pair", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+
+				const $newValue = state(2);
+				await $map.update("key1", $newValue);
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(2);
+			});
+
+			it("should update multiple keys successively", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+
+				await $map.update("key1", state(10));
+				await $map.update("key2", state(20));
+
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(10);
+				expect(await (await $map.pick()).get("key2")?.pick()).toBe(20);
+			});
+
+			it("should throw when key does not exist", async () => {
+				const $map = map<string, FlowState<number>>();
+				await expect($map.update("key1", state(1))).rejects.toThrow(
+					"[PicoFlow] Key does not exist",
+				);
+			});
+
+			it("should update $lastAction with update action when update is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				const $newValue = state(2);
+				await $map.update("key1", $newValue);
+				const action = await $map.$lastAction.pick();
+				expect(action).toEqual({
+					type: "update",
+					key: "key1",
+					value: $newValue,
+				});
+			});
+
+			it("should have FlowState value in $lastAction when update is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				const $newValue = state(200);
+				await $map.update("key1", $newValue);
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("update");
+				if (action.type === "update") {
+					expect(action.value).toBe($newValue);
+					expect(await action.value.pick()).toBe(200);
+				}
+			});
+
+			it("should dispose old value when update is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const $oldValue = state(1);
+				await $map.add("key1", $oldValue);
+
+				const $newValue = state(2);
+				await $map.update("key1", $newValue);
+
+				expect($oldValue.disposed).toBe(true);
+				expect($newValue.disposed).toBe(false);
+			});
+
+			it("should trigger reactivity when update is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				const effectFn = vi.fn();
+				effect((t) => effectFn($map.get(t)));
+
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+				await $map.update("key1", state(2));
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+			});
+		});
+
+		describe("delete", () => {
+			it("should delete key from map", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+
+				await $map.delete("key1");
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(undefined);
+				expect(await (await $map.pick()).get("key2")?.pick()).toBe(2);
+				expect((await $map.pick()).size).toBe(1);
+			});
+
+			it("should delete multiple keys successively", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+				await $map.add("key3", state(3));
+
+				await $map.delete("key1");
+				await $map.delete("key2");
+
+				expect((await $map.pick()).size).toBe(1);
+				expect(await (await $map.pick()).get("key3")?.pick()).toBe(3);
+			});
+
+			it("should throw when key does not exist", async () => {
+				const $map = map<string, FlowState<number>>();
+				await expect($map.delete("key1")).rejects.toThrow(
+					"[PicoFlow] Key does not exist",
+				);
+			});
+
+			it("should update $lastAction with delete action when delete is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const $value = state(1);
+				await $map.add("key1", $value);
+				await $map.delete("key1");
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("delete");
+				if (action.type === "delete") {
+					expect(action.key).toBe("key1");
+					expect(action.value).toBe($value);
+				}
+			});
+
+			it("should have disposed FlowState value in $lastAction when delete is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				const $value = state(300);
+				await $map.add("key1", $value);
+				await $map.delete("key1");
+				const action = await $map.$lastAction.pick();
+				expect(action.type).toBe("delete");
+				if (action.type === "delete") {
+					expect(action.value).toBe($value);
+					expect(action.value.disposed).toBe(true);
+				}
+			});
+
+			it("should dispose value with self option when delete is called", async () => {
+				const $value = state(1);
+				const $map = map(new Map([["key1", $value]]));
+
+				const $effect = effect((t) => {
+					$value.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $map.delete("key1");
+
+				expect($value.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+
+				$effect.dispose();
+			});
+
+			it("should trigger reactivity when delete is called", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				const effectFn = vi.fn();
+				effect((t) => effectFn($map.get(t)));
+
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+				await $map.delete("key1");
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+			});
+		});
+
+		describe("clear", () => {
+			it("should remove all entries from map", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+					key3: state(3),
+				});
+				expect((await $map.pick()).size).toBe(3);
+
+				await $map.clear();
+				expect((await $map.pick()).size).toBe(0);
+			});
+
+			it("should dispose all values when clear is called", async () => {
+				const $value1 = state(1);
+				const $value2 = state(2);
+				const $value3 = state(3);
+				const $map = map(
+					new Map([
+						["key1", $value1],
+						["key2", $value2],
+						["key3", $value3],
+					]),
+				);
+
+				expect($value1.disposed).toBe(false);
+				expect($value2.disposed).toBe(false);
+				expect($value3.disposed).toBe(false);
+
+				await $map.clear();
+
+				expect($value1.disposed).toBe(true);
+				expect($value2.disposed).toBe(true);
+				expect($value3.disposed).toBe(true);
+			});
+
+			it("should dispose values with self option when clear is called", async () => {
+				const $value = state(1);
+				const $map = map(
+					new Map([
+						["key1", $value],
+						["key2", state(2)],
+					]),
+				);
+
+				const $effect = effect((t) => {
+					$value.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $map.clear();
+
+				expect($value.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+
+				$effect.dispose();
+			});
+
+			it("should update $lastAction with clear action when clear is called", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+					key2: state(2),
+				});
+				await $map.clear();
+				const action = await $map.$lastAction.pick();
+				expect(action).toEqual({ type: "clear" });
+			});
+		});
+
+		describe("$lastAction", () => {
+			describe("set action", () => {
+				it("should initialize $lastAction with set action on creation", async () => {
+					const $value1 = state(1);
+					const $value2 = state(2);
+					const $map = map({
+						key1: $value1,
+						key2: $value2,
+					});
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "set",
+						map: expect.any(Map),
+					});
+					if (action.type === "set") {
+						expect(action.map.get("key1")).toBe($value1);
+						expect(action.map.get("key2")).toBe($value2);
+					}
+				});
+
+				it("should update $lastAction with set action when set is called", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+					});
+					const $newValue = state(2);
+					const newMap = new Map([["key2", $newValue]]);
+					await $map.set(newMap);
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "set",
+						map: newMap,
+					});
+				});
+
+				it("should have correct structure for set action (type + map with FlowState)", async () => {
+					const $value = state(1);
+					const $map = map({ key1: $value });
+					const action = await $map.$lastAction.pick();
+					expect(action).toHaveProperty("type", "set");
+					if (action.type === "set") {
+						expect(action).toHaveProperty("map");
+						expect(action.map).toBeInstanceOf(Map);
+						expect(action.map.get("key1")).toBe($value);
+					}
+				});
+			});
+
+			describe("add action", () => {
+				it("should update $lastAction with add action when add is called", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(1);
+					await $map.add("key1", $value);
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "add",
+						key: "key1",
+						value: $value,
+					});
+				});
+
+				it("should have correct structure for add action (type + key + FlowState value)", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(100);
+					await $map.add("key1", $value);
+					const action = await $map.$lastAction.pick();
+					expect(action).toHaveProperty("type", "add");
+					if (action.type === "add") {
+						expect(action).toHaveProperty("key");
+						expect(action).toHaveProperty("value");
+						expect(action.key).toBe("key1");
+						expect(action.value).toBe($value);
+						expect(await action.value.pick()).toBe(100);
+					}
+				});
+			});
+
+			describe("update action", () => {
+				it("should update $lastAction with update action when update is called", async () => {
+					const $map = map<string, FlowState<number>>();
+					await $map.add("key1", state(1));
+					const $newValue = state(2);
+					await $map.update("key1", $newValue);
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "update",
+						key: "key1",
+						value: $newValue,
+					});
+				});
+
+				it("should have correct structure for update action (type + key + FlowState value)", async () => {
+					const $map = map<string, FlowState<number>>();
+					await $map.add("key1", state(1));
+					const $newValue = state(200);
+					await $map.update("key1", $newValue);
+					const action = await $map.$lastAction.pick();
+					expect(action).toHaveProperty("type", "update");
+					if (action.type === "update") {
+						expect(action).toHaveProperty("key");
+						expect(action).toHaveProperty("value");
+						expect(action.key).toBe("key1");
+						expect(action.value).toBe($newValue);
+						expect(await action.value.pick()).toBe(200);
+					}
+				});
+			});
+
+			describe("delete action", () => {
+				it("should update $lastAction with delete action when delete is called", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(1);
+					await $map.add("key1", $value);
+					await $map.delete("key1");
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "delete",
+						key: "key1",
+						value: $value,
+					});
+				});
+
+				it("should have correct structure for delete action (type + key + disposed FlowState value)", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(300);
+					await $map.add("key1", $value);
+					await $map.delete("key1");
+					const action = await $map.$lastAction.pick();
+					expect(action).toHaveProperty("type", "delete");
+					if (action.type === "delete") {
+						expect(action).toHaveProperty("key");
+						expect(action).toHaveProperty("value");
+						expect(action.key).toBe("key1");
+						expect(action.value).toBe($value);
+						expect(action.value.disposed).toBe(true);
+					}
+				});
+			});
+
+			describe("clear action", () => {
+				it("should update $lastAction with clear action when clear is called", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+						key2: state(2),
+					});
+					await $map.clear();
+					const action = await $map.$lastAction.pick();
+					expect(action).toEqual({
+						type: "clear",
+					});
+				});
+
+				it("should have correct structure for clear action (type only)", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+					});
+					await $map.clear();
+					const action = await $map.$lastAction.pick();
+					expect(action).toHaveProperty("type", "clear");
+					if (action.type === "clear") {
+						expect(action).not.toHaveProperty("key");
+						expect(action).not.toHaveProperty("value");
+						expect(action).not.toHaveProperty("map");
+					}
+				});
+			});
+		});
+
+		describe("edge cases", () => {
+			it("should handle multiple rapid operations", async () => {
+				const $map = map<string, FlowState<number>>();
+				await $map.add("key1", state(1));
+				await $map.add("key2", state(2));
+				await $map.add("key3", state(3));
+				await $map.update("key1", state(10));
+				await $map.delete("key2");
+				await $map.add("key4", state(4));
+				await $map.clear();
+				await $map.add("key5", state(5));
+
+				expect((await $map.pick()).size).toBe(1);
+				expect(await (await $map.pick()).get("key5")?.pick()).toBe(5);
+			});
+
+			it("should handle empty map operations", async () => {
+				const $map = map<string, FlowState<number>>();
+				expect((await $map.pick()).size).toBe(0);
+
+				await $map.add("key1", state(1));
+				expect((await $map.pick()).size).toBe(1);
+
+				await $map.delete("key1");
+				expect((await $map.pick()).size).toBe(0);
+			});
+
+			it("should handle map with single entry", async () => {
+				const $map = map<string, FlowState<number>>({
+					key1: state(1),
+				});
+				expect((await $map.pick()).size).toBe(1);
+
+				await $map.update("key1", state(2));
+				expect(await (await $map.pick()).get("key1")?.pick()).toBe(2);
+
+				await $map.delete("key1");
+				expect((await $map.pick()).size).toBe(0);
+			});
+
+			it("should handle map with many entries", async () => {
+				const $map = map<string, FlowState<number>>();
+				for (let i = 0; i < 100; i++) {
+					await $map.add(`key${i}`, state(i));
+				}
+				expect((await $map.pick()).size).toBe(100);
+
+				for (let i = 0; i < 50; i++) {
+					await $map.delete(`key${i}`);
+				}
+				expect((await $map.pick()).size).toBe(50);
+			});
+
+			it("should handle disposed values in map", async () => {
+				const $value = state(1);
+				const $map = map(new Map([["key1", $value]]));
+
+				await $map.delete("key1");
+
+				expect($value.disposed).toBe(true);
+				expect((await $map.pick()).size).toBe(0);
+			});
+
+			it("should handle effects on FlowState values in map", async () => {
+				const $value = state(1);
+				const $map = map(new Map([["key1", $value]]));
+				const effectFn = vi.fn();
+
+				effect((t) => {
+					const mapValue = $map.get(t).get("key1");
+					if (mapValue) {
+						effectFn(mapValue.get(t));
+					}
+				});
+
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+				expect(effectFn).toHaveBeenLastCalledWith(1);
+
+				await $value.set(2);
+				await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+				expect(effectFn).toHaveBeenLastCalledWith(2);
+			});
+		});
+	});
+
+	describe("integration", () => {
+		beforeEach(() => {
+			FlowGraph.clear();
+		});
+
+		describe("with effects", () => {
+			describe("reactivity", () => {
+				it("should call effect when initialized", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+						key2: state(2),
+					});
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith(
+						expect.objectContaining({
+							size: 2,
+						}),
+					);
+				});
+
+				it("should call effect when updated with set", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+					});
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					const $newValue = state(2);
+					await $map.set(new Map([["key2", $newValue]]));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(
+						expect.objectContaining({
+							size: 1,
+						}),
+					);
+				});
+
+				it("should call effect when updated with add", async () => {
+					const $map = map<string, FlowState<number>>();
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith(new Map());
+
+					const $key1Value = state(1);
+					await $map.add("key1", $key1Value);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(
+						new Map([["key1", $key1Value]]),
+					);
+
+					const $key2Value = state(2);
+					await $map.add("key2", $key2Value);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith(
+						new Map([
+							["key1", $key1Value],
+							["key2", $key2Value],
+						]),
+					);
+				});
+
+				it("should call effect when updated with update", async () => {
+					const $map = map<string, FlowState<number>>();
+					await $map.add("key1", state(1));
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					const $newValue = state(2);
+					await $map.update("key1", $newValue);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(
+						new Map([["key1", $newValue]]),
+					);
+				});
+
+				it("should call effect when updated with delete", async () => {
+					const $map = map<string, FlowState<number>>();
+					await $map.add("key1", state(1));
+					await $map.add("key2", state(2));
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					await $map.delete("key1");
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					const mapAfterDelete = effectFn.mock.calls[1][0];
+					expect(mapAfterDelete.size).toBe(1);
+					expect(mapAfterDelete.has("key2")).toBe(true);
+				});
+
+				it("should call effect when updated with clear", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+						key2: state(2),
+					});
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					await $map.clear();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(new Map());
+				});
+
+				it("should call effect when FlowState values in map are updated", async () => {
+					const $value = state(1);
+					const $map = map(new Map([["key1", $value]]));
+					const effectFn = vi.fn();
+
+					effect((t) => {
+						const mapValue = $map.get(t).get("key1");
+						if (mapValue) {
+							effectFn(mapValue.get(t));
+						}
+					});
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith(1);
+
+					await $value.set(2);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(2);
+				});
+			});
+
+			describe("$lastAction", () => {
+				it("should call effect when $lastAction is updated with set action", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+					});
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.$lastAction.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					const $newValue = state(2);
+					await $map.set(new Map([["key2", $newValue]]));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith({
+						type: "set",
+						map: expect.any(Map),
+					});
+				});
+
+				it("should call effect when $lastAction is updated with add action", async () => {
+					const $map = map<string, FlowState<number>>();
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.$lastAction.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					const $value = state(1);
+					await $map.add("key1", $value);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith({
+						type: "add",
+						key: "key1",
+						value: $value,
+					});
+				});
+
+				it("should call effect when $lastAction is updated with update action", async () => {
+					const $map = map<string, FlowState<number>>();
+					await $map.add("key1", state(1));
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.$lastAction.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					const $newValue = state(2);
+					await $map.update("key1", $newValue);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith({
+						type: "update",
+						key: "key1",
+						value: $newValue,
+					});
+				});
+
+				it("should call effect when $lastAction is updated with delete action", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(1);
+					await $map.add("key1", $value);
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.$lastAction.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					await $map.delete("key1");
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith({
+						type: "delete",
+						key: "key1",
+						value: $value,
+					});
+				});
+
+				it("should call effect when $lastAction is updated with clear action", async () => {
+					const $map = map<string, FlowState<number>>({
+						key1: state(1),
+						key2: state(2),
+					});
+					const effectFn = vi.fn();
+					effect((t) => effectFn($map.$lastAction.get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+					await $map.clear();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith({ type: "clear" });
+				});
+
+				it("should call effect when FlowState value in $lastAction is updated", async () => {
+					const $map = map<string, FlowState<number>>();
+					const $value = state(1);
+					await $map.add("key1", $value);
+					const effectFn = vi.fn();
+
+					effect((t) => {
+						const action = $map.$lastAction.get(t);
+						if (action.type === "add") {
+							effectFn(action.value.get(t));
+						}
+					});
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith(1);
+
+					await $value.set(2);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith(2);
+				});
+			});
+		});
+	});
+});