feat(utils): chunk 유틸 함수 구현

.changeset/loud-zebras-shave.md

@@ -0,0 +1,6 @@
+---
+"@modern-kit/types": minor
+"@modern-kit/utils": minor
+---
+
+feat(utils): chunk 유틸 함수 추가 및 Interger, NaturalNumber WholeNumber 유틸 타입 추가

packages/types/src/Integer/index.ts

@@ -0,0 +1,5 @@
+export type Integer<T extends number> = `${T}` extends
+  | `${string}.${string}`
+  | 'NaN'
+  ? never
+  : T;

packages/types/src/NaturalNumber/index.ts

@@ -0,0 +1,7 @@
+import { Integer } from 'Integer';
+
+export type NaturalNumber<T extends number> = Integer<T> extends never
+  ? never
+  : `${T}` extends `-${string}` | '0'
+  ? never
+  : T;

packages/types/src/WholeNumber/index.ts

@@ -0,0 +1,7 @@
+import { Integer } from 'Integer';
+
+export type WholeNumber<T extends number> = Integer<T> extends never
+  ? never
+  : `${T}` extends `-${string}`
+  ? never
+  : T;

packages/types/src/index.ts

@@ -8,3 +8,6 @@ export * from './Nullable';
 export * from './ObjectEntries';
 export * from './ObjectKeys';
 export * from './Promiseable';
+export * from './Integer';
+export * from './NaturalNumber';
+export * from './WholeNumber';

packages/utils/src/array/chunk/chunk.spec.ts

@@ -0,0 +1,44 @@
+import { chunk } from '../chunk';
+
+describe('chunk', () => {
+  it('splits the array according to the second parameter', () => {
+    const arr1 = [1, 2, 3, 4, 5, 6];
+    expect(chunk(arr1, 1)).toEqual([[1], [2], [3], [4], [5], [6]]);
+    expect(chunk(arr1, 2)).toEqual([
+      [1, 2],
+      [3, 4],
+      [5, 6],
+    ]);
+
+    const arr2 = [1, 2, 3, 4, 5];
+    expect(chunk(arr2, 3)).toEqual([
+      [1, 2, 3],
+      [4, 5],
+    ]);
+  });
+
+  it('returns an array of each element when the second parameter is 1', () => {
+    const arr = [1, 2, 3, 4, 5, 6];
+    expect(chunk(arr, 1)).toEqual([[1], [2], [3], [4], [5], [6]]);
+  });
+
+  it('returns an empty array when given an empty array', () => {
+    const arr = [] as [];
+    expect(chunk(arr, 3)).toEqual([]);
+  });
+
+  it('returns the array as is if the chunk size is greater than the length of the array', () => {
+    const arr = [1, 2];
+    expect(chunk(arr, 3)).toEqual([arr]);
+  });
+
+  it('returns an empty array if the second parameter is 0', () => {
+    const arr = [1, 2];
+    expect(chunk(arr, 0 as number)).toEqual([]);
+  });
+
+  it('returns an empty array if the second parameter is NaN', () => {
+    const arr = [1, 2];
+    expect(chunk(arr, NaN)).toEqual([]);
+  });
+});

packages/utils/src/array/chunk/index.ts

@@ -0,0 +1,21 @@
+import { NaturalNumber } from '@modern-kit/types';
+
+export const chunk = <T, U extends number>(
+  array: T[],
+  size: NaturalNumber<U>
+): T[][] => {
+  if (array.length === 0 || Number.isNaN(size) || size === 0) {
+    return [];
+  }
+
+  if (size >= array.length) {
+    return [array];
+  }
+
+  return array.reduce((result, _, index) => {
+    if (index % size === 0) {
+      result.push(array.slice(index, index + size));
+    }
+    return result;
+  }, [] as T[][]);
+};

packages/utils/src/array/index.ts

@@ -1,2 +1,3 @@
 export * from './countOccurrencesInArray';
 export * from './excludeElements';
+export * from './chunk';