@ersbeth/picoflow 1.0.1 → 1.1.1

package/test/collections/flowArray.asyncStates.test.ts

@@ -0,0 +1,1553 @@
+import { describe, expect, it, vi } from "vitest";
+import { array, effect, type FlowStateAsync, stateAsync } from "#package";
+
+describe("FlowArray", () => {
+	describe("unit", () => {
+		describe("initialization", () => {
+			it("should initialize with provided FlowStateAsync values", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 2, 3]);
+			});
+
+			it("should initialize with empty array when no value provided", async () => {
+				const $array = array<FlowStateAsync<number>>();
+
+				expect(await $array.pick()).toEqual([]);
+			});
+		});
+
+		describe("disposal", () => {
+			it("should have disposed property set to false initially and true after disposal", () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				expect($array.disposed).toBe(false);
+				$array.dispose();
+				expect($array.disposed).toBe(true);
+			});
+
+			it("should throw error when disposed twice", () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				expect(() => $array.dispose()).toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when pick is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect($array.pick()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when set is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect(
+					$array.set([stateAsync(Promise.resolve(1))]),
+				).rejects.toThrow("[PicoFlow] Primitive is disposed");
+			});
+
+			it("should throw when setItem is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect(
+					$array.update(0, stateAsync(Promise.resolve(3))),
+				).rejects.toThrow("[PicoFlow] Primitive is disposed");
+			});
+
+			it("should throw when push is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect(
+					$array.push(stateAsync(Promise.resolve(3))),
+				).rejects.toThrow("[PicoFlow] Primitive is disposed");
+			});
+
+			it("should throw when pop is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect($array.pop()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when unshift is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect(
+					$array.unshift(stateAsync(Promise.resolve(3))),
+				).rejects.toThrow("[PicoFlow] Primitive is disposed");
+			});
+
+			it("should throw when shift is called after disposal", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				await expect($array.shift()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when splice is called after disposal", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				$array.dispose();
+				await expect($array.splice(1, 2)).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should throw when clear is called after disposal", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				$array.dispose();
+				await expect($array.clear()).rejects.toThrow(
+					"[PicoFlow] Primitive is disposed",
+				);
+			});
+
+			it("should dispose items when FlowArray is disposed", () => {
+				const $item1 = stateAsync(Promise.resolve(1));
+				const $item2 = stateAsync(Promise.resolve(2));
+				const $item3 = stateAsync(Promise.resolve(3));
+				const $array = array([$item1, $item2, $item3]);
+
+				expect($item1.disposed).toBe(false);
+				expect($item2.disposed).toBe(false);
+				expect($item3.disposed).toBe(false);
+
+				$array.dispose();
+
+				expect($item1.disposed).toBe(true);
+				expect($item2.disposed).toBe(true);
+				expect($item3.disposed).toBe(true);
+			});
+
+			it("should dispose items with provided options when FlowArray is disposed", async () => {
+				const $item1 = stateAsync(Promise.resolve(1));
+				const $item2 = stateAsync(Promise.resolve(2));
+				const $array = array([$item1, $item2]);
+
+				const $effect = effect(async (t) => {
+					await $item1.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+				await $effect.settled;
+
+				$array.dispose({ self: true });
+
+				expect($item1.disposed).toBe(true);
+				expect($item2.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+		});
+
+		describe("length", () => {
+			it("should return correct length", () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				expect($array.length).toBe(3);
+			});
+
+			it("should return zero for empty array", () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect($array.length).toBe(0);
+			});
+
+			it("should throw when length is accessed after disposal", () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				$array.dispose();
+				expect(() => $array.length).toThrow("[PicoFlow] Primitive is disposed");
+			});
+
+			it("should update length when array is modified", async () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect($array.length).toBe(0);
+
+				$array.push(stateAsync(Promise.resolve(1)));
+				expect($array.length).toBe(1);
+
+				$array.push(stateAsync(Promise.resolve(2)));
+				expect($array.length).toBe(2);
+
+				$array.pop();
+				expect($array.length).toBe(1);
+
+				$array.unshift(stateAsync(Promise.resolve(0)));
+				expect($array.length).toBe(2);
+
+				$array.shift();
+				expect($array.length).toBe(1);
+
+				$array.clear();
+				expect($array.length).toBe(0);
+			});
+		});
+
+		describe("set", () => {
+			it("should update array when set is called with FlowStateAsync", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2]);
+
+				await $array.set([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 2, 3]);
+			});
+
+			it("should dispose items when set replaces array", () => {
+				const $oldItem1 = stateAsync(Promise.resolve(1));
+				const $oldItem2 = stateAsync(Promise.resolve(2));
+				const $array = array([$oldItem1, $oldItem2]);
+
+				expect($oldItem1.disposed).toBe(false);
+				expect($oldItem2.disposed).toBe(false);
+
+				$array.set([
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+
+				expect($oldItem1.disposed).toBe(true);
+				expect($oldItem2.disposed).toBe(true);
+			});
+
+			it("should dispose items with self option when set replaces array", async () => {
+				const $oldItem = stateAsync(Promise.resolve(1));
+				const $array = array([$oldItem]);
+
+				const $effect = effect(async (t) => {
+					await $oldItem.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $array.set([stateAsync(Promise.resolve(2))]);
+
+				expect($oldItem.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+		});
+
+		describe("setItem", () => {
+			it("should update item at specific index", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2]);
+
+				$array.update(0, stateAsync(Promise.resolve(1)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 1, 2]);
+
+				$array.update(1, stateAsync(Promise.resolve(2)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 2, 2]);
+
+				$array.update(2, stateAsync(Promise.resolve(3)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 2, 3]);
+			});
+
+			it("should throw when setItem is called with negative index", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				await expect(
+					$array.update(-1, stateAsync(Promise.resolve(0))),
+				).rejects.toThrow("[PicoFlow] Index out of bounds");
+			});
+
+			it("should throw when setItem is called with index >= length", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+				]);
+				await expect(
+					$array.update(3, stateAsync(Promise.resolve(0))),
+				).rejects.toThrow("[PicoFlow] Index out of bounds");
+				await expect(
+					$array.update(10, stateAsync(Promise.resolve(0))),
+				).rejects.toThrow("[PicoFlow] Index out of bounds");
+			});
+
+			it("should handle boundary indices correctly", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				$array.update(0, stateAsync(Promise.resolve(10)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([10, 1, 2]);
+
+				$array.update(2, stateAsync(Promise.resolve(20)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([10, 1, 20]);
+			});
+		});
+
+		describe("push", () => {
+			it("should append FlowStateAsync to end of array", async () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect(await $array.pick()).toEqual([]);
+
+				$array.push(stateAsync(Promise.resolve(0)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0]);
+
+				$array.push(stateAsync(Promise.resolve(1)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1]);
+
+				$array.push(stateAsync(Promise.resolve(2)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2]);
+			});
+
+			it("should handle operations on empty array", () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect($array.length).toBe(0);
+				$array.push(stateAsync(Promise.resolve(1)));
+				expect($array.length).toBe(1);
+			});
+		});
+
+		describe("pop", () => {
+			it("should remove last FlowStateAsync from array", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2]);
+
+				$array.pop();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1]);
+
+				$array.pop();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0]);
+
+				$array.pop();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([]);
+			});
+
+			it("should dispose item when pop removes it", () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([$item]);
+
+				expect($item.disposed).toBe(false);
+
+				$array.pop();
+
+				expect($item.disposed).toBe(true);
+			});
+
+			it("should dispose item with self option when pop removes it", async () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([$item]);
+
+				const $effect = effect(async (t) => {
+					await $item.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $array.pop();
+
+				expect($item.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+
+			it("should handle operations on empty array", () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect($array.length).toBe(0);
+				$array.pop();
+				expect($array.length).toBe(0);
+			});
+		});
+
+		describe("unshift", () => {
+			it("should insert FlowStateAsync at beginning of array", async () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect(await $array.pick()).toEqual([]);
+
+				$array.unshift(stateAsync(Promise.resolve(0)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0]);
+
+				$array.unshift(stateAsync(Promise.resolve(1)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 0]);
+
+				$array.unshift(stateAsync(Promise.resolve(2)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([2, 1, 0]);
+			});
+		});
+
+		describe("shift", () => {
+			it("should remove first FlowStateAsync from array", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2]);
+
+				$array.shift();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([1, 2]);
+
+				$array.shift();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([2]);
+
+				$array.shift();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([]);
+			});
+
+			it("should dispose item when shift removes it", () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([$item, stateAsync(Promise.resolve(2))]);
+
+				expect($item.disposed).toBe(false);
+
+				$array.shift();
+
+				expect($item.disposed).toBe(true);
+			});
+
+			it("should dispose item with self option when shift removes it", async () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([$item, stateAsync(Promise.resolve(2))]);
+
+				const $effect = effect(async (t) => {
+					await $item.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $array.shift();
+
+				expect($item.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+
+			it("should handle operations on empty array", () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				expect($array.length).toBe(0);
+				$array.shift();
+				expect($array.length).toBe(0);
+			});
+		});
+
+		describe("splice", () => {
+			it("should remove FlowStateAsync from array", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2, 3, 4]);
+
+				$array.splice(1, 2);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 3, 4]);
+			});
+
+			it("should insert FlowStateAsync into array", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				$array.splice(
+					1,
+					0,
+					stateAsync(Promise.resolve(10)),
+					stateAsync(Promise.resolve(11)),
+				);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 10, 11, 1, 2, 3, 4]);
+			});
+
+			it("should replace FlowStateAsync in array", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				$array.splice(
+					1,
+					2,
+					stateAsync(Promise.resolve(10)),
+					stateAsync(Promise.resolve(11)),
+				);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 10, 11, 3, 4]);
+			});
+
+			it("should dispose items when splice removes them", () => {
+				const $item1 = stateAsync(Promise.resolve(1));
+				const $item2 = stateAsync(Promise.resolve(2));
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					$item1,
+					$item2,
+					stateAsync(Promise.resolve(3)),
+				]);
+
+				expect($item1.disposed).toBe(false);
+				expect($item2.disposed).toBe(false);
+
+				$array.splice(1, 2);
+
+				expect($item1.disposed).toBe(true);
+				expect($item2.disposed).toBe(true);
+			});
+
+			it("should dispose items with self option when splice removes them", async () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					$item,
+					stateAsync(Promise.resolve(2)),
+				]);
+
+				const $effect = effect(async (t) => {
+					await $item.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $array.splice(1, 1);
+
+				expect($item.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+		});
+
+		describe("clear", () => {
+			it("should remove all FlowStateAsync from array", async () => {
+				const $array = array<FlowStateAsync<number>>([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+					stateAsync(Promise.resolve(3)),
+					stateAsync(Promise.resolve(4)),
+				]);
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 1, 2, 3, 4]);
+
+				$array.clear();
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([]);
+			});
+
+			it("should dispose all items when clear is called", () => {
+				const $item1 = stateAsync(Promise.resolve(1));
+				const $item2 = stateAsync(Promise.resolve(2));
+				const $item3 = stateAsync(Promise.resolve(3));
+				const $array = array([$item1, $item2, $item3]);
+
+				expect($item1.disposed).toBe(false);
+				expect($item2.disposed).toBe(false);
+				expect($item3.disposed).toBe(false);
+
+				$array.clear();
+
+				expect($item1.disposed).toBe(true);
+				expect($item2.disposed).toBe(true);
+				expect($item3.disposed).toBe(true);
+			});
+
+			it("should dispose items with self option when clear is called", async () => {
+				const $item = stateAsync(Promise.resolve(1));
+				const $array = array([$item, stateAsync(Promise.resolve(2))]);
+
+				const $effect = effect(async (t) => {
+					await $item.get(t);
+				});
+
+				expect($effect.disposed).toBe(false);
+
+				await $array.clear();
+
+				expect($item.disposed).toBe(true);
+				expect($effect.disposed).toBe(false);
+			});
+		});
+
+		describe("$lastAction", () => {
+			describe("set action", () => {
+				it("should initialize $lastAction with set action on creation", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("set");
+					if (action.type === "set") {
+						expect(action.items).toHaveLength(3);
+						expect(action.items[0]).toBeInstanceOf(Object);
+						expect(action.items[1]).toBeInstanceOf(Object);
+						expect(action.items[2]).toBeInstanceOf(Object);
+					}
+				});
+
+				it("should update $lastAction with set action when set is called", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					await $array.set([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("set");
+					if (action.type === "set") {
+						expect(action.items).toHaveLength(3);
+					}
+				});
+
+				it("should have correct structure for set action (items array)", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "set");
+					if (action.type === "set") {
+						expect(action).toHaveProperty("items");
+						expect(Array.isArray(action.items)).toBe(true);
+						expect(action.items).toHaveLength(3);
+					}
+				});
+			});
+
+			describe("update action", () => {
+				it("should update $lastAction with setItem action when setItem is called", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					const $newItem = stateAsync(Promise.resolve(10));
+					$array.update(1, $newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("update");
+					if (action.type === "update") {
+						expect(action.index).toBe(1);
+						expect(action.item).toBe($newItem);
+					}
+				});
+
+				it("should have correct structure for update action (index and item)", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					const $newItem = stateAsync(Promise.resolve(10));
+					$array.update(0, $newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "update");
+					if (action.type === "update") {
+						expect(action).toHaveProperty("index");
+						expect(action).toHaveProperty("item");
+						expect(action.index).toBe(0);
+						expect(action.item).toBe($newItem);
+					}
+				});
+			});
+
+			describe("push action", () => {
+				it("should update $lastAction with push action when push is called", async () => {
+					const $array = array<FlowStateAsync<number>>([]);
+					const $newItem = stateAsync(Promise.resolve(42));
+					$array.push($newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("push");
+					if (action.type === "push") {
+						expect(action.item).toBe($newItem);
+					}
+				});
+
+				it("should have correct structure for push action (item)", async () => {
+					const $array = array<FlowStateAsync<number>>([]);
+					const $newItem = stateAsync(Promise.resolve(100));
+					$array.push($newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "push");
+					if (action.type === "push") {
+						expect(action).toHaveProperty("item");
+						expect(action.item).toBe($newItem);
+					}
+				});
+			});
+
+			describe("pop action", () => {
+				it("should update $lastAction with pop action when pop is called", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					$array.pop();
+					const action = await $array.$lastAction.pick();
+					expect(action).toEqual({
+						type: "pop",
+					});
+				});
+
+				it("should have correct structure for pop action (no additional fields)", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					$array.pop();
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "pop");
+					if (action.type === "pop") {
+						expect(action).not.toHaveProperty("item");
+						expect(action).not.toHaveProperty("index");
+						expect(action).not.toHaveProperty("items");
+					}
+				});
+			});
+
+			describe("unshift action", () => {
+				it("should update $lastAction with unshift action when unshift is called", async () => {
+					const $array = array<FlowStateAsync<number>>([]);
+					const $newItem = stateAsync(Promise.resolve(42));
+					$array.unshift($newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("unshift");
+					if (action.type === "unshift") {
+						expect(action.item).toBe($newItem);
+					}
+				});
+
+				it("should have correct structure for unshift action (item)", async () => {
+					const $array = array<FlowStateAsync<number>>([]);
+					const $newItem = stateAsync(Promise.resolve(200));
+					$array.unshift($newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "unshift");
+					if (action.type === "unshift") {
+						expect(action).toHaveProperty("item");
+						expect(action.item).toBe($newItem);
+					}
+				});
+			});
+
+			describe("shift action", () => {
+				it("should update $lastAction with shift action when shift is called", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					$array.shift();
+					const action = await $array.$lastAction.pick();
+					expect(action).toEqual({
+						type: "shift",
+					});
+				});
+
+				it("should have correct structure for shift action (no additional fields)", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					$array.shift();
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "shift");
+					if (action.type === "shift") {
+						expect(action).not.toHaveProperty("item");
+						expect(action).not.toHaveProperty("index");
+						expect(action).not.toHaveProperty("items");
+					}
+				});
+			});
+
+			describe("splice action", () => {
+				it("should update $lastAction with splice action when splice is called", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+						stateAsync(Promise.resolve(4)),
+					]);
+					const $newItem1 = stateAsync(Promise.resolve(10));
+					const $newItem2 = stateAsync(Promise.resolve(11));
+					$array.splice(1, 2, $newItem1, $newItem2);
+					const action = await $array.$lastAction.pick();
+					expect(action.type).toBe("splice");
+					if (action.type === "splice") {
+						expect(action.start).toBe(1);
+						expect(action.deleteCount).toBe(2);
+						expect(action.items).toHaveLength(2);
+						expect(action.items[0]).toBe($newItem1);
+						expect(action.items[1]).toBe($newItem2);
+					}
+				});
+
+				it("should have correct structure for splice action (start, deleteCount, items)", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					const $newItem = stateAsync(Promise.resolve(100));
+					$array.splice(1, 1, $newItem);
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "splice");
+					if (action.type === "splice") {
+						expect(action).toHaveProperty("start");
+						expect(action).toHaveProperty("deleteCount");
+						expect(action).toHaveProperty("items");
+						expect(action.start).toBe(1);
+						expect(action.deleteCount).toBe(1);
+						expect(Array.isArray(action.items)).toBe(true);
+						expect(action.items).toHaveLength(1);
+						expect(action.items[0]).toBe($newItem);
+					}
+				});
+			});
+
+			describe("clear action", () => {
+				it("should update $lastAction with clear action when clear is called", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+						stateAsync(Promise.resolve(4)),
+					]);
+					$array.clear();
+					const action = await $array.$lastAction.pick();
+					expect(action).toEqual({
+						type: "clear",
+					});
+				});
+
+				it("should have correct structure for clear action (no additional fields)", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					$array.clear();
+					const action = await $array.$lastAction.pick();
+					expect(action).toHaveProperty("type", "clear");
+					if (action.type === "clear") {
+						expect(action).not.toHaveProperty("item");
+						expect(action).not.toHaveProperty("index");
+						expect(action).not.toHaveProperty("items");
+					}
+				});
+			});
+		});
+
+		describe("edge cases", () => {
+			it("should handle multiple rapid operations", async () => {
+				const $array = array<FlowStateAsync<number>>([]);
+				$array.push(stateAsync(Promise.resolve(1)));
+				$array.push(stateAsync(Promise.resolve(2)));
+				$array.push(stateAsync(Promise.resolve(3)));
+				$array.pop();
+				$array.shift();
+				$array.unshift(stateAsync(Promise.resolve(0)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([0, 2]);
+			});
+
+			it("should handle boundary indices correctly", async () => {
+				const $array = array([
+					stateAsync(Promise.resolve(0)),
+					stateAsync(Promise.resolve(1)),
+					stateAsync(Promise.resolve(2)),
+				]);
+				$array.update(0, stateAsync(Promise.resolve(10)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([10, 1, 2]);
+
+				$array.update(2, stateAsync(Promise.resolve(20)));
+				expect(
+					await Promise.all((await $array.pick()).map((state) => state.pick())),
+				).toEqual([10, 1, 20]);
+			});
+		});
+	});
+
+	describe("integration", () => {
+		describe("with effects", () => {
+			describe("reactivity", () => {
+				it("should call effect when initialized", async () => {
+					const $array = array([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								(await $array.get(t)).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 2, 3]);
+				});
+
+				it("should call effect when updated with set", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								(await $array.get(t)).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2]);
+
+					await $array.set([
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+					]);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 2, 3]);
+				});
+
+				it("should call effect when updated with push/pop", async () => {
+					const $array = array<FlowStateAsync<number>>();
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								(await $array.get(t)).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([]);
+
+					$array.push(stateAsync(Promise.resolve(0)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([0]);
+
+					$array.push(stateAsync(Promise.resolve(1)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1]);
+
+					$array.push(stateAsync(Promise.resolve(2)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(4));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2]);
+
+					$array.pop();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(5));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1]);
+
+					$array.pop();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(6));
+					expect(effectFn).toHaveBeenLastCalledWith([0]);
+
+					$array.pop();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(7));
+					expect(effectFn).toHaveBeenLastCalledWith([]);
+				});
+
+				it("should call effect when updated with unshift/shift", async () => {
+					const $array = array<FlowStateAsync<number>>();
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								(await $array.get(t)).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([]);
+
+					$array.unshift(stateAsync(Promise.resolve(0)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([0]);
+
+					$array.unshift(stateAsync(Promise.resolve(1)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 0]);
+
+					$array.unshift(stateAsync(Promise.resolve(2)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(4));
+					expect(effectFn).toHaveBeenLastCalledWith([2, 1, 0]);
+
+					$array.shift();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(5));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 0]);
+
+					$array.shift();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(6));
+					expect(effectFn).toHaveBeenLastCalledWith([0]);
+
+					$array.shift();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(7));
+					expect(effectFn).toHaveBeenLastCalledWith([]);
+				});
+
+				it("should call effect when updated with splice", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+						stateAsync(Promise.resolve(4)),
+					]);
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								$array.get(t).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2, 3, 4]);
+
+					$array.splice(1, 2);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 3, 4]);
+
+					$array.splice(
+						1,
+						0,
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					);
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2, 3, 4]);
+				});
+
+				it("should call effect when updated with clear", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+						stateAsync(Promise.resolve(3)),
+						stateAsync(Promise.resolve(4)),
+					]);
+					const effectFn = vi.fn();
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								$array.get(t).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2, 3, 4]);
+
+					$array.clear();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([]);
+				});
+			});
+
+			describe("item reactivity", () => {
+				it("should call effect when item is updated", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					const effectFn = vi.fn();
+					const effect0Fn = vi.fn();
+					const effect1Fn = vi.fn();
+					const effect2Fn = vi.fn();
+
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								$array.get(t).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+					effect(async (t) => effect0Fn(await (await $array.get(t))[0].get(t)));
+					effect(async (t) => effect1Fn(await (await $array.get(t))[1].get(t)));
+					effect(async (t) => effect2Fn(await (await $array.get(t))[2].get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(1));
+					expect(effect0Fn).toHaveBeenLastCalledWith(0);
+					await vi.waitFor(() => expect(effect1Fn).toHaveBeenCalledTimes(1));
+					expect(effect1Fn).toHaveBeenLastCalledWith(1);
+					await vi.waitFor(() => expect(effect2Fn).toHaveBeenCalledTimes(1));
+					expect(effect2Fn).toHaveBeenLastCalledWith(2);
+
+					await (await $array.pick())[0].set(Promise.resolve(1));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(2));
+					expect(effect0Fn).toHaveBeenLastCalledWith(1);
+					await vi.waitFor(() => expect(effect1Fn).toHaveBeenCalledTimes(1));
+					expect(effect1Fn).toHaveBeenLastCalledWith(1);
+					await vi.waitFor(() => expect(effect2Fn).toHaveBeenCalledTimes(1));
+					expect(effect2Fn).toHaveBeenLastCalledWith(2);
+
+					await (await $array.pick())[1].set(Promise.resolve(2));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 2, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(2));
+					expect(effect0Fn).toHaveBeenLastCalledWith(1);
+					await vi.waitFor(() => expect(effect1Fn).toHaveBeenCalledTimes(2));
+					expect(effect1Fn).toHaveBeenLastCalledWith(2);
+					await vi.waitFor(() => expect(effect2Fn).toHaveBeenCalledTimes(1));
+					expect(effect2Fn).toHaveBeenLastCalledWith(2);
+
+					await (await $array.pick())[2].set(Promise.resolve(3));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(4));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 2, 3]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(2));
+					expect(effect0Fn).toHaveBeenLastCalledWith(1);
+					await vi.waitFor(() => expect(effect1Fn).toHaveBeenCalledTimes(2));
+					expect(effect1Fn).toHaveBeenLastCalledWith(2);
+					await vi.waitFor(() => expect(effect2Fn).toHaveBeenCalledTimes(2));
+					expect(effect2Fn).toHaveBeenLastCalledWith(3);
+				});
+
+				it("should call effect when item is replaced", async () => {
+					const $array = array<FlowStateAsync<number>>([
+						stateAsync(Promise.resolve(0)),
+						stateAsync(Promise.resolve(1)),
+						stateAsync(Promise.resolve(2)),
+					]);
+					const effectFn = vi.fn();
+					const effect0Fn = vi.fn();
+
+					effect(async (t) =>
+						effectFn(
+							await Promise.all(
+								$array.get(t).map(async (state) => await state.get(t)),
+							),
+						),
+					);
+					effect(async (t) => effect0Fn(await $array.get(t)[0].get(t)));
+
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+					expect(effectFn).toHaveBeenLastCalledWith([0, 1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(1));
+					expect(effect0Fn).toHaveBeenLastCalledWith(0);
+
+					$array.update(0, stateAsync(Promise.resolve(3)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+					expect(effectFn).toHaveBeenLastCalledWith([3, 1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(2));
+					expect(effect0Fn).toHaveBeenLastCalledWith(3);
+
+					$array.shift();
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+					expect(effectFn).toHaveBeenLastCalledWith([1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(3));
+					expect(effect0Fn).toHaveBeenLastCalledWith(1);
+
+					$array.unshift(stateAsync(Promise.resolve(4)));
+					await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(4));
+					expect(effectFn).toHaveBeenLastCalledWith([4, 1, 2]);
+					await vi.waitFor(() => expect(effect0Fn).toHaveBeenCalledTimes(4));
+					expect(effect0Fn).toHaveBeenLastCalledWith(4);
+				});
+			});
+
+			describe("lastAction reactivity", () => {
+				describe("set action", () => {
+					it("should call effect when $lastAction is updated with set action", async () => {
+						const $array = array([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+
+						await $array.set([
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+							stateAsync(Promise.resolve(3)),
+						]);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+					});
+				});
+
+				describe("setItem action", () => {
+					it("should call effect when $lastAction is updated with setItem action", async () => {
+						const $array = array([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+						const $newItem = stateAsync(Promise.resolve(10));
+						$array.update(1, $newItem);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "update",
+								index: 1,
+							}),
+						);
+					});
+				});
+
+				describe("push action", () => {
+					it("should call effect when $lastAction is updated with push action", async () => {
+						const $array = array<FlowStateAsync<number>>();
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+
+						const $newItem = stateAsync(Promise.resolve(0));
+						$array.push($newItem);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "push",
+							}),
+						);
+
+						const $newItem2 = stateAsync(Promise.resolve(1));
+						$array.push($newItem2);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "push",
+							}),
+						);
+					});
+				});
+
+				describe("pop action", () => {
+					it("should call effect when $lastAction is updated with pop action", async () => {
+						const $array = array<FlowStateAsync<number>>([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+						$array.pop();
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith({
+							type: "pop",
+						});
+
+						$array.pop();
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+						expect(effectFn).toHaveBeenLastCalledWith({
+							type: "pop",
+						});
+					});
+				});
+
+				describe("unshift action", () => {
+					it("should call effect when $lastAction is updated with unshift action", async () => {
+						const $array = array<FlowStateAsync<number>>();
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+
+						const $newItem = stateAsync(Promise.resolve(0));
+						$array.unshift($newItem);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "unshift",
+							}),
+						);
+
+						const $newItem2 = stateAsync(Promise.resolve(1));
+						$array.unshift($newItem2);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "unshift",
+							}),
+						);
+					});
+				});
+
+				describe("shift action", () => {
+					it("should call effect when $lastAction is updated with shift action", async () => {
+						const $array = array<FlowStateAsync<number>>([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+
+						$array.shift();
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith({
+							type: "shift",
+						});
+
+						$array.shift();
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+						expect(effectFn).toHaveBeenLastCalledWith({
+							type: "shift",
+						});
+					});
+				});
+
+				describe("splice action", () => {
+					it("should call effect when $lastAction is updated with splice action", async () => {
+						const $array = array<FlowStateAsync<number>>([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+							stateAsync(Promise.resolve(3)),
+							stateAsync(Promise.resolve(4)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+
+						$array.splice(1, 2);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "splice",
+								start: 1,
+								deleteCount: 2,
+							}),
+						);
+
+						$array.splice(
+							1,
+							0,
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+						);
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(3));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "splice",
+								start: 1,
+								deleteCount: 0,
+							}),
+						);
+					});
+				});
+
+				describe("clear action", () => {
+					it("should call effect when $lastAction is updated with clear action", async () => {
+						const $array = array<FlowStateAsync<number>>([
+							stateAsync(Promise.resolve(0)),
+							stateAsync(Promise.resolve(1)),
+							stateAsync(Promise.resolve(2)),
+							stateAsync(Promise.resolve(3)),
+							stateAsync(Promise.resolve(4)),
+						]);
+						const effectFn = vi.fn();
+						effect(async (t) => effectFn(await $array.$lastAction.get(t)));
+
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(1));
+						expect(effectFn).toHaveBeenLastCalledWith(
+							expect.objectContaining({
+								type: "set",
+							}),
+						);
+
+						$array.clear();
+						await vi.waitFor(() => expect(effectFn).toHaveBeenCalledTimes(2));
+						expect(effectFn).toHaveBeenLastCalledWith({
+							type: "clear",
+						});
+					});
+				});
+			});
+		});
+	});
+});