feat(utils): expand utility modules and exports

Author: klmhyeonwoo

package.json

@@ -35,21 +35,56 @@
       "require": "./dist/types/stringUtil/index.js",
       "import": "./dist/types/stringUtil/index.js"
     },
+    "./arrayUtil": {
+      "types": "./dist/types/arrayUtil/index.d.ts",
+      "require": "./dist/types/arrayUtil/index.js",
+      "import": "./dist/types/arrayUtil/index.js"
+    },
+    "./collectionUtil": {
+      "types": "./dist/types/collectionUtil/index.d.ts",
+      "require": "./dist/types/collectionUtil/index.js",
+      "import": "./dist/types/collectionUtil/index.js"
+    },
     "./objectUtil": {
       "types": "./dist/types/objectUtil/index.d.ts",
       "require": "./dist/types/objectUtil/index.js",
       "import": "./dist/types/objectUtil/index.js"
     },
+    "./asyncUtil": {
+      "types": "./dist/types/asyncUtil/index.d.ts",
+      "require": "./dist/types/asyncUtil/index.js",
+      "import": "./dist/types/asyncUtil/index.js"
+    },
     "./cookieUtil": {
       "types": "./dist/types/cookieUtil/index.d.ts",
       "require": "./dist/types/cookieUtil/index.js",
       "import": "./dist/types/cookieUtil/index.js"
     },
+    "./dateUtil": {
+      "types": "./dist/types/dateUtil/index.d.ts",
+      "require": "./dist/types/dateUtil/index.js",
+      "import": "./dist/types/dateUtil/index.js"
+    },
+    "./langUtil": {
+      "types": "./dist/types/langUtil/index.d.ts",
+      "require": "./dist/types/langUtil/index.js",
+      "import": "./dist/types/langUtil/index.js"
+    },
+    "./mathUtil": {
+      "types": "./dist/types/mathUtil/index.d.ts",
+      "require": "./dist/types/mathUtil/index.js",
+      "import": "./dist/types/mathUtil/index.js"
+    },
     "./numberUtil": {
       "types": "./dist/types/numberUtil/index.d.ts",
       "require": "./dist/types/numberUtil/index.js",
       "import": "./dist/types/numberUtil/index.js"
     },
+    "./promiseUtil": {
+      "types": "./dist/types/promiseUtil/index.d.ts",
+      "require": "./dist/types/promiseUtil/index.js",
+      "import": "./dist/types/promiseUtil/index.js"
+    },
     "./validationUtil": {
       "types": "./dist/types/validationUtil/index.d.ts",
       "require": "./dist/types/validationUtil/index.js",
@@ -60,6 +95,11 @@
       "require": "./dist/types/commonUtil/index.js",
       "import": "./dist/types/commonUtil/index.js"
     },
+    "./functionUtil": {
+      "types": "./dist/types/functionUtil/index.d.ts",
+      "require": "./dist/types/functionUtil/index.js",
+      "import": "./dist/types/functionUtil/index.js"
+    },
     "./searchQueryUtil": {
       "types": "./dist/types/searchQueryUtil/index.d.ts",
       "require": "./dist/types/searchQueryUtil/index.js",

package/arrayUtil/chunk/index.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, test } from "vitest";
+import chunk from ".";
+
+describe("chunk 유틸 함수 테스트", () => {
+  test("배열을 지정된 크기로 분할한다.", () => {
+    expect(chunk([1, 2, 3, 4, 5], 2)).toEqual([[1, 2], [3, 4], [5]]);
+  });
+
+  test("size가 1보다 작거나 유효하지 않으면 1로 처리한다.", () => {
+    expect(chunk([1, 2, 3], 0)).toEqual([[1], [2], [3]]);
+    expect(chunk([1, 2, 3], Number.NaN)).toEqual([[1], [2], [3]]);
+  });
+
+  test("빈 배열은 빈 배열을 반환한다.", () => {
+    expect(chunk([], 3)).toEqual([]);
+  });
+});

package/arrayUtil/chunk/index.ts

@@ -0,0 +1,14 @@
+export default function chunk<T>(array: readonly T[], size: number = 1): T[][] {
+  if (array.length === 0) {
+    return [];
+  }
+
+  const normalizedSize = Number.isFinite(size) ? Math.max(1, Math.floor(size)) : 1;
+  const result: T[][] = [];
+
+  for (let i = 0; i < array.length; i += normalizedSize) {
+    result.push(array.slice(i, i + normalizedSize));
+  }
+
+  return result;
+}

package/arrayUtil/compact/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, test } from "vitest";
+import compact from ".";
+
+describe("compact 유틸 함수 테스트", () => {
+  test("falsy 값을 제거한다.", () => {
+    expect(compact([0, 1, false, 2, "", 3, null, undefined])).toEqual([1, 2, 3]);
+  });
+
+  test("truthy 값은 유지한다.", () => {
+    expect(compact(["a", "b", "c"])).toEqual(["a", "b", "c"]);
+  });
+});

package/arrayUtil/compact/index.ts

@@ -0,0 +1,7 @@
+type Falsy = false | 0 | 0n | "" | null | undefined;
+
+export default function compact<T>(
+  array: readonly T[]
+): Array<Exclude<T, Falsy>> {
+  return array.filter(Boolean) as Array<Exclude<T, Falsy>>;
+}

package/arrayUtil/difference/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, test } from "vitest";
+import difference from ".";
+
+describe("difference 유틸 함수 테스트", () => {
+  test("두 번째 배열에 없는 값만 반환한다.", () => {
+    expect(difference([1, 2, 3, 4], [2, 4])).toEqual([1, 3]);
+  });
+
+  test("제외 배열이 비어 있으면 원본 복사본을 반환한다.", () => {
+    expect(difference([1, 2], [])).toEqual([1, 2]);
+  });
+});

package/arrayUtil/difference/index.ts

@@ -0,0 +1,4 @@
+export default function difference<T>(array: readonly T[], values: readonly T[]): T[] {
+  const excludeSet = new Set(values);
+  return array.filter((item) => !excludeSet.has(item));
+}

package/arrayUtil/first/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, test } from "vitest";
+import first from ".";
+
+describe("first 유틸 함수 테스트", () => {
+  test("첫 번째 값을 반환한다.", () => {
+    expect(first([1, 2, 3])).toBe(1);
+  });
+
+  test("빈 배열은 undefined를 반환한다.", () => {
+    expect(first([])).toBeUndefined();
+  });
+});

package/arrayUtil/first/index.ts

@@ -0,0 +1,3 @@
+export default function first<T>(array: readonly T[]): T | undefined {
+  return array[0];
+}

package/arrayUtil/flatten/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, test } from "vitest";
+import flatten from ".";
+
+describe("flatten 유틸 함수 테스트", () => {
+  test("1단계 중첩 배열을 평탄화한다.", () => {
+    expect(flatten([1, [2, 3], [4]])).toEqual([1, 2, 3, 4]);
+  });
+
+  test("빈 배열은 빈 배열을 반환한다.", () => {
+    expect(flatten([])).toEqual([]);
+  });
+});