@simplysm/core-common 13.0.99 → 14.0.1

package/tests/extensions/array-extension.spec.ts

@@ -1,654 +0,0 @@
-import { describe, it, expect } from "vitest";
-import "@simplysm/core-common"; // Enable $ extension
-
-describe("Array prototype extensions", () => {
-  //#region single
-
-  describe("single()", () => {
-    it("Returns single matching element", () => {
-      const result = [1, 2, 3].single((x) => x === 2);
-
-      expect(result).toBe(2);
-    });
-
-    it("Returns undefined if no matching element", () => {
-      const result = [1, 2, 3].single((x) => x === 4);
-
-      expect(result).toBe(undefined);
-    });
-
-    it("Throws error if multiple matching elements", () => {
-      expect(() => [1, 1, 2].single((x) => x === 1)).toThrow();
-    });
-
-    it("Without condition, targets entire array", () => {
-      expect([1].single()).toBe(1);
-      expect(([] as number[]).single()).toBe(undefined);
-      expect(() => [1, 2].single()).toThrow();
-    });
-  });
-
-  //#endregion
-
-  //#region Async methods
-
-  describe("parallelAsync()", () => {
-    it("Performs parallel async execution", async () => {
-      const result = await [1, 2, 3].parallelAsync(async (x) => Promise.resolve(x * 2));
-
-      expect(result).toEqual([2, 4, 6]);
-    });
-  });
-
-  describe("mapAsync()", () => {
-    it("Performs sequential async mapping", async () => {
-      const result = await [1, 2, 3].mapAsync(async (x) => Promise.resolve(x * 2));
-
-      expect(result).toEqual([2, 4, 6]);
-    });
-  });
-
-  describe("filterAsync()", () => {
-    it("Performs async filtering", async () => {
-      const result = await [1, 2, 3, 4, 5].filterAsync(async (x) => Promise.resolve(x > 2));
-
-      expect(result).toEqual([3, 4, 5]);
-    });
-  });
-
-  //#endregion
-
-  //#region Map conversion
-
-  describe("toMap()", () => {
-    it("Creates Map with key function", () => {
-      const result = [
-        { id: 1, name: "a" },
-        { id: 2, name: "b" },
-      ].toMap((x) => x.id);
-
-      expect(result.get(1)).toEqual({ id: 1, name: "a" });
-      expect(result.get(2)).toEqual({ id: 2, name: "b" });
-    });
-
-    it("Transforms values with value function", () => {
-      const result = [
-        { id: 1, name: "a" },
-        { id: 2, name: "b" },
-      ].toMap(
-        (x) => x.id,
-        (x) => x.name,
-      );
-
-      expect(result.get(1)).toBe("a");
-      expect(result.get(2)).toBe("b");
-    });
-
-    it("Throws error on duplicate keys", () => {
-      expect(() =>
-        [
-          { id: 1, name: "a" },
-          { id: 1, name: "b" },
-        ].toMap((x) => x.id),
-      ).toThrow("Duplicated key");
-    });
-  });
-
-  describe("toMapAsync()", () => {
-    it("Creates Map with async key/value functions", async () => {
-      const result = await [
-        { id: 1, name: "a" },
-        { id: 2, name: "b" },
-      ].toMapAsync(async (x) => Promise.resolve(x.id));
-
-      expect(result.get(1)).toEqual({ id: 1, name: "a" });
-      expect(result.get(2)).toEqual({ id: 2, name: "b" });
-    });
-  });
-
-  describe("toArrayMap()", () => {
-    it("Creates Map with array values", () => {
-      const result = [
-        { type: "a", v: 1 },
-        { type: "b", v: 2 },
-        { type: "a", v: 3 },
-      ].toArrayMap((x) => x.type);
-
-      expect(result.get("a")).toHaveLength(2);
-      expect(result.get("b")).toHaveLength(1);
-    });
-
-    it("Transforms values with value function", () => {
-      const result = [
-        { type: "a", v: 1 },
-        { type: "a", v: 2 },
-      ].toArrayMap(
-        (x) => x.type,
-        (x) => x.v,
-      );
-
-      expect(result.get("a")).toEqual([1, 2]);
-    });
-  });
-
-  describe("toSetMap()", () => {
-    it("Creates Map with Set values", () => {
-      const result = [
-        { type: "a", v: 1 },
-        { type: "a", v: 1 }, // duplicate
-        { type: "a", v: 2 },
-      ].toSetMap(
-        (x) => x.type,
-        (x) => x.v,
-      );
-
-      expect(result.get("a")?.size).toBe(2); // duplicates removed
-    });
-  });
-
-  describe("toMapValues()", () => {
-    it("Creates Map with aggregated results per group", () => {
-      const result = [
-        { type: "a", v: 10 },
-        { type: "b", v: 20 },
-        { type: "a", v: 30 },
-      ].toMapValues(
-        (x) => x.type,
-        (items) => items.reduce((sum, x) => sum + x.v, 0),
-      );
-
-      expect(result.get("a")).toBe(40);
-      expect(result.get("b")).toBe(20);
-    });
-  });
-
-  //#endregion
-
-  //#region Tree conversion
-
-  describe("toTree()", () => {
-    it("Converts to tree structure", () => {
-      interface Item {
-        id: number;
-        parentId?: number;
-        name: string;
-      }
-
-      const items: Item[] = [
-        { id: 1, name: "root" },
-        { id: 2, parentId: 1, name: "child1" },
-        { id: 3, parentId: 1, name: "child2" },
-        { id: 4, parentId: 2, name: "grandchild" },
-      ];
-
-      const result = items.toTree("id", "parentId");
-
-      expect(result).toHaveLength(1);
-      expect(result[0].children).toHaveLength(2);
-      expect(result[0].children[0].children).toHaveLength(1);
-    });
-  });
-
-  //#endregion
-
-  //#region Array comparison
-
-  describe("diffs()", () => {
-    it("Analyzes differences between arrays", () => {
-      interface Item {
-        [key: string]: unknown;
-        id: number;
-        value: string;
-      }
-
-      const source: Item[] = [
-        { id: 1, value: "a" },
-        { id: 2, value: "b" },
-        { id: 3, value: "c" },
-      ];
-
-      const target: Item[] = [
-        { id: 2, value: "b" },
-        { id: 3, value: "changed" },
-        { id: 4, value: "d" },
-      ];
-
-      const result = source.diffs(target, { keys: ["id"] });
-
-      const deleted = result.find((d) => d.source?.["id"] === 1);
-      expect(deleted?.target).toBe(undefined);
-
-      const updated = result.find((d) => d.source?.["id"] === 3);
-      expect(updated?.target?.["value"]).toBe("changed");
-
-      const inserted = result.find((d) => d.target?.["id"] === 4);
-      expect(inserted?.source).toBe(undefined);
-    });
-  });
-
-  describe("oneWayDiffs()", () => {
-    it("Analyzes one-way differences", () => {
-      interface Item {
-        id: number;
-        value: string;
-      }
-
-      const orgItems: Item[] = [
-        { id: 1, value: "a" },
-        { id: 2, value: "b" },
-      ];
-
-      const items: Item[] = [
-        { id: 2, value: "changed" },
-        { id: 3, value: "c" },
-      ];
-
-      const result = items.oneWayDiffs(orgItems, "id");
-
-      const updated = result.find((d) => d.item.id === 2);
-      expect(updated?.type).toBe("update");
-
-      const created = result.find((d) => d.item.id === 3);
-      expect(created?.type).toBe("create");
-    });
-
-    it("Includes unchanged items when includeSame=true", () => {
-      interface Item {
-        id: number;
-        value: string;
-      }
-
-      const orgItems: Item[] = [
-        { id: 1, value: "a" },
-        { id: 2, value: "b" },
-      ];
-
-      const items: Item[] = [
-        { id: 1, value: "a" }, // unchanged
-        { id: 2, value: "changed" },
-      ];
-
-      const result = items.oneWayDiffs(orgItems, "id", { includeSame: true });
-
-      const same = result.find((d) => d.item.id === 1);
-      expect(same?.type).toBe("same");
-
-      const updated = result.find((d) => d.item.id === 2);
-      expect(updated?.type).toBe("update");
-    });
-  });
-
-  describe("merge()", () => {
-    it("Merges modified items", () => {
-      interface Item {
-        [key: string]: unknown;
-        id: number;
-        value: string;
-      }
-
-      const source: Item[] = [
-        { id: 1, value: "a" },
-        { id: 2, value: "b" },
-      ];
-      const target: Item[] = [
-        { id: 1, value: "a" },
-        { id: 2, value: "changed" },
-      ];
-
-      const result = source.merge(target, { keys: ["id"] });
-
-      expect(result).toHaveLength(2);
-      expect(result.find((r) => r["id"] === 2)?.["value"]).toBe("changed");
-    });
-  });
-
-  //#endregion
-
-  //#region first, last
-
-  describe("first()", () => {
-    it("Returns first element", () => {
-      expect([1, 2, 3].first()).toBe(1);
-    });
-
-    it("Returns first matching element", () => {
-      expect([1, 2, 3, 4, 5].first((x) => x > 3)).toBe(4);
-    });
-
-    it("Returns undefined for empty array", () => {
-      expect(([] as number[]).first()).toBe(undefined);
-    });
-  });
-
-  describe("last()", () => {
-    it("Returns last element", () => {
-      expect([1, 2, 3].last()).toBe(3);
-    });
-
-    it("Returns last matching element", () => {
-      expect([1, 2, 3, 4, 5].last((x) => x < 4)).toBe(3);
-    });
-
-    it("Returns undefined for empty array", () => {
-      expect(([] as number[]).last()).toBe(undefined);
-    });
-  });
-
-  //#endregion
-
-  //#region filterExists, ofType
-
-  describe("filterExists()", () => {
-    it("Removes null/undefined", () => {
-      const arr = [1, null, 2, undefined, 3];
-      const result = arr.filterExists();
-      expect(result).toEqual([1, 2, 3]);
-    });
-  });
-
-  describe("ofType()", () => {
-    it("Filters string type elements only", () => {
-      const arr = [1, "a", 2, "b", true];
-      const result = arr.ofType("string");
-      expect(result).toEqual(["a", "b"]);
-    });
-
-    it("Filters number type elements only", () => {
-      const arr = [1, "a", 2, "b", 3];
-      const result = arr.ofType("number");
-      expect(result).toEqual([1, 2, 3]);
-    });
-
-    it("Filters boolean type elements only", () => {
-      const arr = [1, "a", true, false, 2];
-      const result = arr.ofType("boolean");
-      expect(result).toEqual([true, false]);
-    });
-  });
-
-  //#endregion
-
-  //#region mapMany
-
-  describe("mapMany()", () => {
-    it("Maps then flattens", () => {
-      const result = [1, 2, 3].mapMany((x) => [x, x * 10]);
-      expect(result).toEqual([1, 10, 2, 20, 3, 30]);
-    });
-  });
-
-  describe("mapManyAsync()", () => {
-    it("Async maps then flattens", async () => {
-      const result = await [1, 2, 3].mapManyAsync(async (x) => Promise.resolve([x, x * 10]));
-      expect(result).toEqual([1, 10, 2, 20, 3, 30]);
-    });
-
-    it("Async maps nested Promise array then flattens", async () => {
-      const result = await [1, 2].mapManyAsync(async (x) => Promise.resolve([x, x + 1, x + 2]));
-      expect(result).toEqual([1, 2, 3, 2, 3, 4]);
-    });
-  });
-
-  //#endregion
-
-  //#region groupBy
-
-  describe("groupBy()", () => {
-    it("Groups by key", () => {
-      const items = [
-        { type: "a", value: 1 },
-        { type: "b", value: 2 },
-        { type: "a", value: 3 },
-      ];
-      const result = items.groupBy((x) => x.type);
-
-      expect(result).toHaveLength(2);
-      expect(result.find((g) => g.key === "a")?.values).toHaveLength(2);
-      expect(result.find((g) => g.key === "b")?.values).toHaveLength(1);
-    });
-  });
-
-  //#endregion
-
-  //#region toObject
-
-  describe("toObject()", () => {
-    it("Converts array to object", () => {
-      const items = [
-        { key: "a", value: 1 },
-        { key: "b", value: 2 },
-      ];
-      const result = items.toObject(
-        (x) => x.key,
-        (x) => x.value,
-      );
-
-      expect(result).toEqual({ a: 1, b: 2 });
-    });
-
-    it("Throws error on duplicate keys", () => {
-      const items = [
-        { key: "a", value: 1 },
-        { key: "a", value: 2 },
-      ];
-      expect(() => items.toObject((x) => x.key)).toThrow();
-    });
-  });
-
-  //#endregion
-
-  //#region distinct
-
-  describe("distinct()", () => {
-    it("Removes duplicates", () => {
-      expect([1, 2, 2, 3, 3, 3].distinct()).toEqual([1, 2, 3]);
-    });
-
-    it("Removes duplicates from object array", () => {
-      const arr = [{ a: 1 }, { a: 2 }, { a: 1 }];
-      const result = arr.distinct();
-      expect(result).toHaveLength(2);
-    });
-
-    it("Can use custom key with keyFn", () => {
-      const arr = [
-        { id: 1, name: "a" },
-        { id: 2, name: "b" },
-        { id: 1, name: "c" },
-      ];
-      const result = arr.distinct({ keyFn: (x) => x.id });
-      expect(result).toHaveLength(2);
-    });
-
-    it("Removes duplicates by reference with matchAddress=true", () => {
-      const obj1 = { a: 1 };
-      const obj2 = { a: 1 }; // same value but different reference
-      const arr = [obj1, obj1, obj2];
-      const result = arr.distinct({ matchAddress: true });
-      expect(result).toHaveLength(2);
-      expect(result).toContain(obj1);
-      expect(result).toContain(obj2);
-    });
-  });
-
-  //#endregion
-
-  //#region orderBy, orderByDesc
-
-  describe("orderBy()", () => {
-    it("Sorts in ascending order", () => {
-      expect([3, 1, 2].orderBy()).toEqual([1, 2, 3]);
-    });
-
-    it("Can specify sort criteria with selector", () => {
-      const items = [
-        { name: "b", age: 30 },
-        { name: "a", age: 20 },
-        { name: "c", age: 25 },
-      ];
-      const result = items.orderBy((x) => x.age);
-      expect(result.map((x) => x.age)).toEqual([20, 25, 30]);
-    });
-  });
-
-  describe("orderByDesc()", () => {
-    it("Sorts in descending order", () => {
-      expect([1, 3, 2].orderByDesc()).toEqual([3, 2, 1]);
-    });
-  });
-
-  //#endregion
-
-  //#region sum, min, max
-
-  describe("sum()", () => {
-    it("Returns sum", () => {
-      expect([1, 2, 3, 4, 5].sum()).toBe(15);
-    });
-
-    it("Can extract values with selector", () => {
-      const items = [{ value: 10 }, { value: 20 }, { value: 30 }];
-      expect(items.sum((x) => x.value)).toBe(60);
-    });
-
-    it("Returns 0 for empty array", () => {
-      expect(([] as number[]).sum()).toBe(0);
-    });
-
-    it("Throws error for non-number type", () => {
-      expect(() => (["a", "b"] as unknown as number[]).sum()).toThrow("sum can only be used with numbers");
-    });
-  });
-
-  describe("min()", () => {
-    it("Returns minimum value", () => {
-      expect([3, 1, 2].min()).toBe(1);
-    });
-
-    it("Returns undefined for empty array", () => {
-      expect(([] as number[]).min()).toBe(undefined);
-    });
-
-    it("Throws error for non-number/string type", () => {
-      expect(() => ([true, false] as unknown as number[]).min()).toThrow(
-        "min can only be used with numbers/strings",
-      );
-    });
-  });
-
-  describe("max()", () => {
-    it("Returns maximum value", () => {
-      expect([1, 3, 2].max()).toBe(3);
-    });
-
-    it("Returns undefined for empty array", () => {
-      expect(([] as number[]).max()).toBe(undefined);
-    });
-
-    it("Throws error for non-number/string type", () => {
-      expect(() => ([{}, {}] as unknown as number[]).max()).toThrow(
-        "max can only be used with numbers/strings",
-      );
-    });
-  });
-
-  //#endregion
-
-  //#region shuffle
-
-  describe("shuffle()", () => {
-    it("Shuffles array (preserves original)", () => {
-      const original = [1, 2, 3, 4, 5];
-      const shuffled = original.shuffle();
-
-      // original unchanged
-      expect(original).toEqual([1, 2, 3, 4, 5]);
-      // has same elements
-      expect(shuffled.sort()).toEqual([1, 2, 3, 4, 5]);
-    });
-  });
-
-  //#endregion
-
-  //#region Mutating methods
-
-  describe("distinctThis()", () => {
-    it("Removes duplicates from original array", () => {
-      const arr = [1, 2, 2, 3, 3, 3];
-      const result = arr.distinctThis();
-
-      expect(arr).toEqual([1, 2, 3]);
-      expect(result).toEqual([1, 2, 3]);
-    });
-  });
-
-  describe("orderByThis()", () => {
-    it("Sorts original array in ascending order", () => {
-      const arr = [3, 1, 2];
-      arr.orderByThis();
-
-      expect(arr).toEqual([1, 2, 3]);
-    });
-  });
-
-  describe("orderByDescThis()", () => {
-    it("Sorts original array in descending order", () => {
-      const arr = [1, 3, 2];
-      arr.orderByDescThis();
-
-      expect(arr).toEqual([3, 2, 1]);
-    });
-  });
-
-  describe("insert()", () => {
-    it("Inserts item to original array", () => {
-      const arr = [1, 3];
-      arr.insert(1, 2);
-
-      expect(arr).toEqual([1, 2, 3]);
-    });
-  });
-
-  describe("remove()", () => {
-    it("Removes item from original array", () => {
-      const arr = [1, 2, 3];
-      arr.remove(2);
-
-      expect(arr).toEqual([1, 3]);
-    });
-
-    it("Removes item with condition function", () => {
-      const arr = [1, 2, 3, 4];
-      arr.remove((x) => x % 2 === 0);
-
-      expect(arr).toEqual([1, 3]);
-    });
-  });
-
-  describe("toggle()", () => {
-    it("Removes item if exists", () => {
-      const arr = [1, 2, 3];
-      arr.toggle(2);
-
-      expect(arr).toEqual([1, 3]);
-    });
-
-    it("Adds item if not exists", () => {
-      const arr = [1, 3];
-      arr.toggle(2);
-
-      expect(arr).toEqual([1, 3, 2]);
-    });
-  });
-
-  describe("clear()", () => {
-    it("Clears original array", () => {
-      const arr = [1, 2, 3];
-      arr.clear();
-
-      expect(arr).toEqual([]);
-    });
-  });
-
-  //#endregion
-});