@jthong/util 0.1.0-alpha.0 → 0.1.0-alpha.2

package/README.md

@@ -27,11 +27,14 @@ import { debounce } from "@jthong/util/fn";
 - `capitalize(str)` — 첫 글자 대문자
 - `camelToKebab(str)` / `kebabToCamel(str)` — 케이스 변환
 - `truncate(str, max, suffix?)` — 자르고 접미사 붙이기
+- `formatNumber(n, locale?)` — 천 단위 콤마 (`1234567 → "1,234,567"`)
+- `mask(str, { start?, end?, char? })` — 일부 마스킹 (`"01012345678" → "010****5678"`)
 
 ### `/array`
 - `chunk(arr, size)` — n개씩 분할
 - `unique(arr)` — 중복 제거
 - `groupBy(arr, keyFn)` — 키별 그룹화
+- `sortBy(arr, keyFn, order?)` — 키 기반 정렬 (asc/desc, 입력 불변)
 - `range(start, end?, step?)` — 정수 범위
 
 ### `/object`
@@ -41,3 +44,7 @@ import { debounce } from "@jthong/util/fn";
 ### `/fn`
 - `debounce(fn, ms)` / `throttle(fn, ms)`
 - `sleep(ms)` — Promise 기반 대기
+- `once(fn)` — 첫 호출 결과를 캐싱, 이후 동일 결과 반환
+- `memoize(fn, keyFn?)` — 인자별 결과 캐싱
+- `retry(fn, { retries?, delay?, backoff?, onError? })` — 지수 백오프 재시도
+- `withTimeout(promise, ms, errorMessage?)` — Promise에 타임아웃 부여

package/dist/array/index.cjs

@@ -18,6 +18,16 @@ var groupBy = (arr, keyFn) => {
   }
   return result;
 };
+var sortBy = (arr, keyFn, order = "asc") => {
+  const sign = order === "asc" ? 1 : -1;
+  return [...arr].sort((a, b) => {
+    const ka = keyFn(a);
+    const kb = keyFn(b);
+    if (ka < kb) return -1 * sign;
+    if (ka > kb) return 1 * sign;
+    return 0;
+  });
+};
 var range = (start, end, step = 1) => {
   const [from, to] = end === void 0 ? [0, start] : [start, end];
   const result = [];
@@ -30,6 +40,7 @@ var range = (start, end, step = 1) => {
 exports.chunk = chunk;
 exports.groupBy = groupBy;
 exports.range = range;
+exports.sortBy = sortBy;
 exports.unique = unique;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/array/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/index.ts"],"names":[],"mappings":";;;AAAO,IAAM,KAAA,GAAQ,CAAI,GAAA,EAAmB,IAAA,KAAwB;AAClE,EAAA,IAAI,IAAA,IAAQ,CAAA,EAAG,OAAO,EAAC;AACvB,EAAA,MAAM,SAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAA,EAAM;AACzC,IAAA,MAAA,CAAO,KAAK,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,IAAI,CAAC,CAAA;AAAA,EACpC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,MAAA,GAAS,CAAI,GAAA,KAA2B,KAAA,CAAM,KAAK,IAAI,GAAA,CAAI,GAAG,CAAC;AAErE,IAAM,OAAA,GAAU,CACrB,GAAA,EACA,KAAA,KACmB;AACnB,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,CAAC,OAAO,GAAG,CAAA,KAAM,EAAC,EAAG,KAAK,IAAI,CAAA;AAAA,EAChC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAc,OAAO,CAAA,KAAgB;AACxE,EAAA,MAAM,CAAC,IAAA,EAAM,EAAE,CAAA,GAAI,GAAA,KAAQ,MAAA,GAAY,CAAC,CAAA,EAAG,KAAK,CAAA,GAAI,CAAC,KAAA,EAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,IAAS,CAAA,GAAI,MAAM,IAAA,GAAO,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA,GAAI,EAAA,EAAI,CAAA,IAAK,IAAA,EAAM;AACxD,IAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["export const chunk = <T>(arr: readonly T[], size: number): T[][] => {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size));\n  }\n  return result;\n};\n\nexport const unique = <T>(arr: readonly T[]): T[] => Array.from(new Set(arr));\n\nexport const groupBy = <T, K extends PropertyKey>(\n  arr: readonly T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> => {\n  const result = {} as Record<K, T[]>;\n  for (const item of arr) {\n    const key = keyFn(item);\n    (result[key] ??= []).push(item);\n  }\n  return result;\n};\n\nexport const range = (start: number, end?: number, step = 1): number[] => {\n  const [from, to] = end === undefined ? [0, start] : [start, end];\n  const result: number[] = [];\n  for (let i = from; step > 0 ? i < to : i > to; i += step) {\n    result.push(i);\n  }\n  return result;\n};\n"]}
+{"version":3,"sources":["../../src/array/index.ts"],"names":[],"mappings":";;;AAaO,IAAM,KAAA,GAAQ,CAAI,GAAA,EAAmB,IAAA,KAAwB;AAClE,EAAA,IAAI,IAAA,IAAQ,CAAA,EAAG,OAAO,EAAC;AACvB,EAAA,MAAM,SAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAA,EAAM;AACzC,IAAA,MAAA,CAAO,KAAK,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,IAAI,CAAC,CAAA;AAAA,EACpC;AACA,EAAA,OAAO,MAAA;AACT;AAcO,IAAM,MAAA,GAAS,CAAI,GAAA,KAA2B,KAAA,CAAM,KAAK,IAAI,GAAA,CAAI,GAAG,CAAC;AAsBrE,IAAM,OAAA,GAAU,CACrB,GAAA,EACA,KAAA,KACmB;AACnB,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,CAAC,OAAO,GAAG,CAAA,KAAM,EAAC,EAAG,KAAK,IAAI,CAAA;AAAA,EAChC;AACA,EAAA,OAAO,MAAA;AACT;AAuBO,IAAM,MAAA,GAAS,CACpB,GAAA,EACA,KAAA,EACA,QAAwB,KAAA,KAChB;AACR,EAAA,MAAM,IAAA,GAAO,KAAA,KAAU,KAAA,GAAQ,CAAA,GAAI,EAAA;AACnC,EAAA,OAAO,CAAC,GAAG,GAAG,EAAE,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM;AAC7B,IAAA,MAAM,EAAA,GAAK,MAAM,CAAC,CAAA;AAClB,IAAA,MAAM,EAAA,GAAK,MAAM,CAAC,CAAA;AAClB,IAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,EAAA,GAAK,IAAA;AACzB,IAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,CAAA,GAAI,IAAA;AACxB,IAAA,OAAO,CAAA;AAAA,EACT,CAAC,CAAA;AACH;AAqBO,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAc,OAAO,CAAA,KAAgB;AACxE,EAAA,MAAM,CAAC,IAAA,EAAM,EAAE,CAAA,GAAI,GAAA,KAAQ,MAAA,GAAY,CAAC,CAAA,EAAG,KAAK,CAAA,GAAI,CAAC,KAAA,EAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,IAAS,CAAA,GAAI,MAAM,IAAA,GAAO,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA,GAAI,EAAA,EAAI,CAAA,IAAK,IAAA,EAAM;AACxD,IAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * 배열을 지정한 크기로 분할합니다. 마지막 청크는 크기보다 작을 수 있습니다.\n *\n * @param arr - 분할할 배열\n * @param size - 각 청크의 크기 (양수)\n * @returns 청크들의 배열. `size <= 0`이면 빈 배열을 반환합니다.\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n * chunk([1, 2, 3], 5);       // [[1, 2, 3]]\n * chunk([1, 2, 3], 0);       // []\n * ```\n */\nexport const chunk = <T>(arr: readonly T[], size: number): T[][] => {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size));\n  }\n  return result;\n};\n\n/**\n * 배열에서 중복 요소를 제거합니다. 등호 비교는 `Set`을 사용하므로 원시값/참조값 모두에 동작하지만,\n * 객체는 참조 동일성으로만 비교됩니다.\n *\n * @param arr - 원본 배열\n * @returns 중복이 제거된 새 배열 (입력 순서 유지)\n * @example\n * ```ts\n * unique([1, 2, 2, 3, 1]);           // [1, 2, 3]\n * unique([\"a\", \"b\", \"a\"]);           // [\"a\", \"b\"]\n * ```\n */\nexport const unique = <T>(arr: readonly T[]): T[] => Array.from(new Set(arr));\n\n/**\n * 키 함수가 반환한 값으로 배열을 그룹화합니다.\n *\n * @param arr - 그룹화할 배열\n * @param keyFn - 각 요소에서 그룹 키를 추출하는 함수\n * @returns 키별로 묶인 객체. 키는 `keyFn`의 반환값.\n * @example\n * ```ts\n * const users = [\n *   { name: \"Alice\", role: \"admin\" },\n *   { name: \"Bob\",   role: \"user\" },\n *   { name: \"Carol\", role: \"admin\" },\n * ];\n * groupBy(users, (u) => u.role);\n * // {\n * //   admin: [{ name: \"Alice\", role: \"admin\" }, { name: \"Carol\", role: \"admin\" }],\n * //   user:  [{ name: \"Bob\",   role: \"user\" }],\n * // }\n * ```\n */\nexport const groupBy = <T, K extends PropertyKey>(\n  arr: readonly T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> => {\n  const result = {} as Record<K, T[]>;\n  for (const item of arr) {\n    const key = keyFn(item);\n    (result[key] ??= []).push(item);\n  }\n  return result;\n};\n\ntype Comparable = string | number | bigint | boolean | Date;\n\n/**\n * 키 함수가 반환한 값을 기준으로 배열을 정렬합니다. **입력 배열은 변경되지 않습니다** (새 배열 반환).\n *\n * @param arr - 정렬할 배열\n * @param keyFn - 정렬 기준 값을 추출하는 함수 (`string` | `number` | `bigint` | `boolean` | `Date` 반환)\n * @param order - `\"asc\"` (오름차순, 기본값) 또는 `\"desc\"` (내림차순)\n * @returns 정렬된 새 배열\n * @example\n * ```ts\n * sortBy([{ n: 3 }, { n: 1 }, { n: 2 }], (i) => i.n);\n * // [{ n: 1 }, { n: 2 }, { n: 3 }]\n *\n * sortBy([\"banana\", \"apple\", \"cherry\"], (s) => s);\n * // [\"apple\", \"banana\", \"cherry\"]\n *\n * sortBy([1, 3, 2], (n) => n, \"desc\");\n * // [3, 2, 1]\n * ```\n */\nexport const sortBy = <T>(\n  arr: readonly T[],\n  keyFn: (item: T) => Comparable,\n  order: \"asc\" | \"desc\" = \"asc\",\n): T[] => {\n  const sign = order === \"asc\" ? 1 : -1;\n  return [...arr].sort((a, b) => {\n    const ka = keyFn(a);\n    const kb = keyFn(b);\n    if (ka < kb) return -1 * sign;\n    if (ka > kb) return 1 * sign;\n    return 0;\n  });\n};\n\n/**\n * 정수 범위 배열을 생성합니다. Python의 `range()`와 같은 시맨틱.\n *\n * - 인자 1개: `[0, start)` 범위\n * - 인자 2개: `[start, end)` 범위\n * - 인자 3개: `[start, end)` 범위, `step` 간격\n *\n * @param start - 시작값 (또는 종료값, 인자 1개일 때)\n * @param end - 종료값 (배제, exclusive)\n * @param step - 증가폭. 기본값 `1`. 음수면 감소.\n * @returns 정수 배열\n * @example\n * ```ts\n * range(3);          // [0, 1, 2]\n * range(2, 5);       // [2, 3, 4]\n * range(0, 10, 3);   // [0, 3, 6, 9]\n * range(5, 0, -1);   // [5, 4, 3, 2, 1]\n * ```\n */\nexport const range = (start: number, end?: number, step = 1): number[] => {\n  const [from, to] = end === undefined ? [0, start] : [start, end];\n  const result: number[] = [];\n  for (let i = from; step > 0 ? i < to : i > to; i += step) {\n    result.push(i);\n  }\n  return result;\n};\n"]}

package/dist/array/index.d.ts

@@ -1,6 +1,91 @@
-declare const chunk: <T>(arr: readonly T[], size: number) => T[][];
-declare const unique: <T>(arr: readonly T[]) => T[];
-declare const groupBy: <T, K extends PropertyKey>(arr: readonly T[], keyFn: (item: T) => K) => Record<K, T[]>;
-declare const range: (start: number, end?: number, step?: number) => number[];
-
-export { chunk, groupBy, range, unique };
+/**
+ * 배열을 지정한 크기로 분할합니다. 마지막 청크는 크기보다 작을 수 있습니다.
+ *
+ * @param arr - 분할할 배열
+ * @param size - 각 청크의 크기 (양수)
+ * @returns 청크들의 배열. `size <= 0`이면 빈 배열을 반환합니다.
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+ * chunk([1, 2, 3], 5);       // [[1, 2, 3]]
+ * chunk([1, 2, 3], 0);       // []
+ * ```
+ */
+export declare const chunk: <T>(arr: readonly T[], size: number) => T[][];
+/**
+ * 배열에서 중복 요소를 제거합니다. 등호 비교는 `Set`을 사용하므로 원시값/참조값 모두에 동작하지만,
+ * 객체는 참조 동일성으로만 비교됩니다.
+ *
+ * @param arr - 원본 배열
+ * @returns 중복이 제거된 새 배열 (입력 순서 유지)
+ * @example
+ * ```ts
+ * unique([1, 2, 2, 3, 1]);           // [1, 2, 3]
+ * unique(["a", "b", "a"]);           // ["a", "b"]
+ * ```
+ */
+export declare const unique: <T>(arr: readonly T[]) => T[];
+/**
+ * 키 함수가 반환한 값으로 배열을 그룹화합니다.
+ *
+ * @param arr - 그룹화할 배열
+ * @param keyFn - 각 요소에서 그룹 키를 추출하는 함수
+ * @returns 키별로 묶인 객체. 키는 `keyFn`의 반환값.
+ * @example
+ * ```ts
+ * const users = [
+ *   { name: "Alice", role: "admin" },
+ *   { name: "Bob",   role: "user" },
+ *   { name: "Carol", role: "admin" },
+ * ];
+ * groupBy(users, (u) => u.role);
+ * // {
+ * //   admin: [{ name: "Alice", role: "admin" }, { name: "Carol", role: "admin" }],
+ * //   user:  [{ name: "Bob",   role: "user" }],
+ * // }
+ * ```
+ */
+export declare const groupBy: <T, K extends PropertyKey>(arr: readonly T[], keyFn: (item: T) => K) => Record<K, T[]>;
+type Comparable = string | number | bigint | boolean | Date;
+/**
+ * 키 함수가 반환한 값을 기준으로 배열을 정렬합니다. **입력 배열은 변경되지 않습니다** (새 배열 반환).
+ *
+ * @param arr - 정렬할 배열
+ * @param keyFn - 정렬 기준 값을 추출하는 함수 (`string` | `number` | `bigint` | `boolean` | `Date` 반환)
+ * @param order - `"asc"` (오름차순, 기본값) 또는 `"desc"` (내림차순)
+ * @returns 정렬된 새 배열
+ * @example
+ * ```ts
+ * sortBy([{ n: 3 }, { n: 1 }, { n: 2 }], (i) => i.n);
+ * // [{ n: 1 }, { n: 2 }, { n: 3 }]
+ *
+ * sortBy(["banana", "apple", "cherry"], (s) => s);
+ * // ["apple", "banana", "cherry"]
+ *
+ * sortBy([1, 3, 2], (n) => n, "desc");
+ * // [3, 2, 1]
+ * ```
+ */
+export declare const sortBy: <T>(arr: readonly T[], keyFn: (item: T) => Comparable, order?: "asc" | "desc") => T[];
+/**
+ * 정수 범위 배열을 생성합니다. Python의 `range()`와 같은 시맨틱.
+ *
+ * - 인자 1개: `[0, start)` 범위
+ * - 인자 2개: `[start, end)` 범위
+ * - 인자 3개: `[start, end)` 범위, `step` 간격
+ *
+ * @param start - 시작값 (또는 종료값, 인자 1개일 때)
+ * @param end - 종료값 (배제, exclusive)
+ * @param step - 증가폭. 기본값 `1`. 음수면 감소.
+ * @returns 정수 배열
+ * @example
+ * ```ts
+ * range(3);          // [0, 1, 2]
+ * range(2, 5);       // [2, 3, 4]
+ * range(0, 10, 3);   // [0, 3, 6, 9]
+ * range(5, 0, -1);   // [5, 4, 3, 2, 1]
+ * ```
+ */
+export declare const range: (start: number, end?: number, step?: number) => number[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/array/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,EAAE,EAO7D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,KAAG,CAAC,EAA8B,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,SAAS,WAAW,EAC9C,KAAK,SAAS,CAAC,EAAE,EACjB,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAOf,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,KAAK,SAAS,CAAC,EAAE,EACjB,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,UAAU,EAC9B,QAAO,KAAK,GAAG,MAAc,KAC5B,CAAC,EASH,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,EAAE,aAAQ,KAAG,MAAM,EAOnE,CAAC"}

package/dist/array/index.js

@@ -16,6 +16,16 @@ var groupBy = (arr, keyFn) => {
   }
   return result;
 };
+var sortBy = (arr, keyFn, order = "asc") => {
+  const sign = order === "asc" ? 1 : -1;
+  return [...arr].sort((a, b) => {
+    const ka = keyFn(a);
+    const kb = keyFn(b);
+    if (ka < kb) return -1 * sign;
+    if (ka > kb) return 1 * sign;
+    return 0;
+  });
+};
 var range = (start, end, step = 1) => {
   const [from, to] = end === void 0 ? [0, start] : [start, end];
   const result = [];
@@ -25,6 +35,6 @@ var range = (start, end, step = 1) => {
   return result;
 };
 
-export { chunk, groupBy, range, unique };
+export { chunk, groupBy, range, sortBy, unique };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/array/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/index.ts"],"names":[],"mappings":";AAAO,IAAM,KAAA,GAAQ,CAAI,GAAA,EAAmB,IAAA,KAAwB;AAClE,EAAA,IAAI,IAAA,IAAQ,CAAA,EAAG,OAAO,EAAC;AACvB,EAAA,MAAM,SAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAA,EAAM;AACzC,IAAA,MAAA,CAAO,KAAK,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,IAAI,CAAC,CAAA;AAAA,EACpC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,MAAA,GAAS,CAAI,GAAA,KAA2B,KAAA,CAAM,KAAK,IAAI,GAAA,CAAI,GAAG,CAAC;AAErE,IAAM,OAAA,GAAU,CACrB,GAAA,EACA,KAAA,KACmB;AACnB,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,CAAC,OAAO,GAAG,CAAA,KAAM,EAAC,EAAG,KAAK,IAAI,CAAA;AAAA,EAChC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAc,OAAO,CAAA,KAAgB;AACxE,EAAA,MAAM,CAAC,IAAA,EAAM,EAAE,CAAA,GAAI,GAAA,KAAQ,MAAA,GAAY,CAAC,CAAA,EAAG,KAAK,CAAA,GAAI,CAAC,KAAA,EAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,IAAS,CAAA,GAAI,MAAM,IAAA,GAAO,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA,GAAI,EAAA,EAAI,CAAA,IAAK,IAAA,EAAM;AACxD,IAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["export const chunk = <T>(arr: readonly T[], size: number): T[][] => {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size));\n  }\n  return result;\n};\n\nexport const unique = <T>(arr: readonly T[]): T[] => Array.from(new Set(arr));\n\nexport const groupBy = <T, K extends PropertyKey>(\n  arr: readonly T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> => {\n  const result = {} as Record<K, T[]>;\n  for (const item of arr) {\n    const key = keyFn(item);\n    (result[key] ??= []).push(item);\n  }\n  return result;\n};\n\nexport const range = (start: number, end?: number, step = 1): number[] => {\n  const [from, to] = end === undefined ? [0, start] : [start, end];\n  const result: number[] = [];\n  for (let i = from; step > 0 ? i < to : i > to; i += step) {\n    result.push(i);\n  }\n  return result;\n};\n"]}
+{"version":3,"sources":["../../src/array/index.ts"],"names":[],"mappings":";AAaO,IAAM,KAAA,GAAQ,CAAI,GAAA,EAAmB,IAAA,KAAwB;AAClE,EAAA,IAAI,IAAA,IAAQ,CAAA,EAAG,OAAO,EAAC;AACvB,EAAA,MAAM,SAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAA,EAAM;AACzC,IAAA,MAAA,CAAO,KAAK,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,IAAI,CAAC,CAAA;AAAA,EACpC;AACA,EAAA,OAAO,MAAA;AACT;AAcO,IAAM,MAAA,GAAS,CAAI,GAAA,KAA2B,KAAA,CAAM,KAAK,IAAI,GAAA,CAAI,GAAG,CAAC;AAsBrE,IAAM,OAAA,GAAU,CACrB,GAAA,EACA,KAAA,KACmB;AACnB,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,CAAC,OAAO,GAAG,CAAA,KAAM,EAAC,EAAG,KAAK,IAAI,CAAA;AAAA,EAChC;AACA,EAAA,OAAO,MAAA;AACT;AAuBO,IAAM,MAAA,GAAS,CACpB,GAAA,EACA,KAAA,EACA,QAAwB,KAAA,KAChB;AACR,EAAA,MAAM,IAAA,GAAO,KAAA,KAAU,KAAA,GAAQ,CAAA,GAAI,EAAA;AACnC,EAAA,OAAO,CAAC,GAAG,GAAG,EAAE,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM;AAC7B,IAAA,MAAM,EAAA,GAAK,MAAM,CAAC,CAAA;AAClB,IAAA,MAAM,EAAA,GAAK,MAAM,CAAC,CAAA;AAClB,IAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,EAAA,GAAK,IAAA;AACzB,IAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,CAAA,GAAI,IAAA;AACxB,IAAA,OAAO,CAAA;AAAA,EACT,CAAC,CAAA;AACH;AAqBO,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAc,OAAO,CAAA,KAAgB;AACxE,EAAA,MAAM,CAAC,IAAA,EAAM,EAAE,CAAA,GAAI,GAAA,KAAQ,MAAA,GAAY,CAAC,CAAA,EAAG,KAAK,CAAA,GAAI,CAAC,KAAA,EAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,IAAS,CAAA,GAAI,MAAM,IAAA,GAAO,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA,GAAI,EAAA,EAAI,CAAA,IAAK,IAAA,EAAM;AACxD,IAAA,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACf;AACA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * 배열을 지정한 크기로 분할합니다. 마지막 청크는 크기보다 작을 수 있습니다.\n *\n * @param arr - 분할할 배열\n * @param size - 각 청크의 크기 (양수)\n * @returns 청크들의 배열. `size <= 0`이면 빈 배열을 반환합니다.\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n * chunk([1, 2, 3], 5);       // [[1, 2, 3]]\n * chunk([1, 2, 3], 0);       // []\n * ```\n */\nexport const chunk = <T>(arr: readonly T[], size: number): T[][] => {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size));\n  }\n  return result;\n};\n\n/**\n * 배열에서 중복 요소를 제거합니다. 등호 비교는 `Set`을 사용하므로 원시값/참조값 모두에 동작하지만,\n * 객체는 참조 동일성으로만 비교됩니다.\n *\n * @param arr - 원본 배열\n * @returns 중복이 제거된 새 배열 (입력 순서 유지)\n * @example\n * ```ts\n * unique([1, 2, 2, 3, 1]);           // [1, 2, 3]\n * unique([\"a\", \"b\", \"a\"]);           // [\"a\", \"b\"]\n * ```\n */\nexport const unique = <T>(arr: readonly T[]): T[] => Array.from(new Set(arr));\n\n/**\n * 키 함수가 반환한 값으로 배열을 그룹화합니다.\n *\n * @param arr - 그룹화할 배열\n * @param keyFn - 각 요소에서 그룹 키를 추출하는 함수\n * @returns 키별로 묶인 객체. 키는 `keyFn`의 반환값.\n * @example\n * ```ts\n * const users = [\n *   { name: \"Alice\", role: \"admin\" },\n *   { name: \"Bob\",   role: \"user\" },\n *   { name: \"Carol\", role: \"admin\" },\n * ];\n * groupBy(users, (u) => u.role);\n * // {\n * //   admin: [{ name: \"Alice\", role: \"admin\" }, { name: \"Carol\", role: \"admin\" }],\n * //   user:  [{ name: \"Bob\",   role: \"user\" }],\n * // }\n * ```\n */\nexport const groupBy = <T, K extends PropertyKey>(\n  arr: readonly T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> => {\n  const result = {} as Record<K, T[]>;\n  for (const item of arr) {\n    const key = keyFn(item);\n    (result[key] ??= []).push(item);\n  }\n  return result;\n};\n\ntype Comparable = string | number | bigint | boolean | Date;\n\n/**\n * 키 함수가 반환한 값을 기준으로 배열을 정렬합니다. **입력 배열은 변경되지 않습니다** (새 배열 반환).\n *\n * @param arr - 정렬할 배열\n * @param keyFn - 정렬 기준 값을 추출하는 함수 (`string` | `number` | `bigint` | `boolean` | `Date` 반환)\n * @param order - `\"asc\"` (오름차순, 기본값) 또는 `\"desc\"` (내림차순)\n * @returns 정렬된 새 배열\n * @example\n * ```ts\n * sortBy([{ n: 3 }, { n: 1 }, { n: 2 }], (i) => i.n);\n * // [{ n: 1 }, { n: 2 }, { n: 3 }]\n *\n * sortBy([\"banana\", \"apple\", \"cherry\"], (s) => s);\n * // [\"apple\", \"banana\", \"cherry\"]\n *\n * sortBy([1, 3, 2], (n) => n, \"desc\");\n * // [3, 2, 1]\n * ```\n */\nexport const sortBy = <T>(\n  arr: readonly T[],\n  keyFn: (item: T) => Comparable,\n  order: \"asc\" | \"desc\" = \"asc\",\n): T[] => {\n  const sign = order === \"asc\" ? 1 : -1;\n  return [...arr].sort((a, b) => {\n    const ka = keyFn(a);\n    const kb = keyFn(b);\n    if (ka < kb) return -1 * sign;\n    if (ka > kb) return 1 * sign;\n    return 0;\n  });\n};\n\n/**\n * 정수 범위 배열을 생성합니다. Python의 `range()`와 같은 시맨틱.\n *\n * - 인자 1개: `[0, start)` 범위\n * - 인자 2개: `[start, end)` 범위\n * - 인자 3개: `[start, end)` 범위, `step` 간격\n *\n * @param start - 시작값 (또는 종료값, 인자 1개일 때)\n * @param end - 종료값 (배제, exclusive)\n * @param step - 증가폭. 기본값 `1`. 음수면 감소.\n * @returns 정수 배열\n * @example\n * ```ts\n * range(3);          // [0, 1, 2]\n * range(2, 5);       // [2, 3, 4]\n * range(0, 10, 3);   // [0, 3, 6, 9]\n * range(5, 0, -1);   // [5, 4, 3, 2, 1]\n * ```\n */\nexport const range = (start: number, end?: number, step = 1): number[] => {\n  const [from, to] = end === undefined ? [0, start] : [start, end];\n  const result: number[] = [];\n  for (let i = from; step > 0 ? i < to : i > to; i += step) {\n    result.push(i);\n  }\n  return result;\n};\n"]}

package/dist/fn/index.cjs

@@ -19,9 +19,63 @@ var throttle = (fn, ms) => {
   };
 };
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var once = (fn) => {
+  let called = false;
+  let result;
+  return (...args) => {
+    if (!called) {
+      called = true;
+      result = fn(...args);
+    }
+    return result;
+  };
+};
+var memoize = (fn, keyFn = (...args) => JSON.stringify(args)) => {
+  const cache = /* @__PURE__ */ new Map();
+  return (...args) => {
+    const key = keyFn(...args);
+    const cached = cache.get(key);
+    if (cached !== void 0 || cache.has(key)) return cached;
+    const result = fn(...args);
+    cache.set(key, result);
+    return result;
+  };
+};
+var retry = async (fn, opts = {}) => {
+  const { retries = 3, delay = 100, backoff = 2, onError } = opts;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      onError?.(err, attempt);
+      if (attempt < retries) {
+        await sleep(delay * Math.pow(backoff, attempt));
+      }
+    }
+  }
+  throw lastError;
+};
+var withTimeout = (promise, ms, errorMessage = "Operation timed out") => {
+  let timeoutId;
+  const timeout = new Promise((_, reject) => {
+    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);
+  });
+  return Promise.race([
+    promise.finally(() => {
+      if (timeoutId !== void 0) clearTimeout(timeoutId);
+    }),
+    timeout
+  ]);
+};
 
 exports.debounce = debounce;
+exports.memoize = memoize;
+exports.once = once;
+exports.retry = retry;
 exports.sleep = sleep;
 exports.throttle = throttle;
+exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/fn/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fn/index.ts"],"names":[],"mappings":";;;AAAO,IAAM,QAAA,GAAW,CACtB,EAAA,EACA,EAAA,KAC8B;AAC9B,EAAA,IAAI,KAAA;AACJ,EAAA,OAAO,IAAI,IAAA,KAAe;AACxB,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,WAAW,MAAM,EAAA,CAAG,GAAG,IAAI,GAAG,EAAE,CAAA;AAAA,EAC1C,CAAA;AACF;AAEO,IAAM,QAAA,GAAW,CACtB,EAAA,EACA,EAAA,KAC8B;AAC9B,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,OAAO,IAAI,IAAA,KAAe;AACxB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI,GAAA,GAAM,QAAQ,EAAA,EAAI;AACpB,MAAA,IAAA,GAAO,GAAA;AACP,MAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,IACZ;AAAA,EACF,CAAA;AACF;AAEO,IAAM,KAAA,GAAQ,CAAC,EAAA,KACpB,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC","file":"index.cjs","sourcesContent":["export const debounce = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: Args) => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n};\n\nexport const throttle = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let last = 0;\n  return (...args: Args) => {\n    const now = Date.now();\n    if (now - last >= ms) {\n      last = now;\n      fn(...args);\n    }\n  };\n};\n\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n"]}
+{"version":3,"sources":["../../src/fn/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 함수 호출을 지연시켜, 마지막 호출 후 `ms` 밀리초가 지나야 실제로 실행되도록 합니다.\n * 검색 입력, 윈도우 리사이즈 등 \"연속 입력이 멈춘 뒤\"에 한 번만 실행하고 싶을 때 사용합니다.\n *\n * @param fn - 디바운스할 함수\n * @param ms - 대기 시간 (밀리초)\n * @returns 디바운스가 적용된 새 함수\n * @example\n * ```ts\n * const onResize = debounce(() => console.log(\"resized\"), 200);\n * window.addEventListener(\"resize\", onResize);\n * // 사용자가 리사이즈를 멈춘 뒤 200ms 후에 한 번만 출력\n * ```\n */\nexport const debounce = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: Args) => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n};\n\n/**\n * `ms` 밀리초마다 최대 한 번씩만 함수가 실행되도록 제한합니다.\n * 스크롤/마우스 무브 등 너무 자주 호출되는 이벤트의 빈도를 줄일 때 사용합니다.\n *\n * @param fn - 스로틀할 함수\n * @param ms - 최소 호출 간격 (밀리초)\n * @returns 스로틀이 적용된 새 함수\n * @example\n * ```ts\n * const onScroll = throttle(() => console.log(\"scroll\"), 100);\n * window.addEventListener(\"scroll\", onScroll);\n * // 100ms에 최대 1번만 출력\n * ```\n */\nexport const throttle = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let last = 0;\n  return (...args: Args) => {\n    const now = Date.now();\n    if (now - last >= ms) {\n      last = now;\n      fn(...args);\n    }\n  };\n};\n\n/**\n * 지정한 시간만큼 대기하는 Promise를 반환합니다.\n *\n * @param ms - 대기 시간 (밀리초)\n * @returns `ms` 이후 resolve되는 Promise\n * @example\n * ```ts\n * async function task() {\n *   console.log(\"start\");\n *   await sleep(1000);\n *   console.log(\"1초 뒤\");\n * }\n * ```\n */\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\n/**\n * 첫 호출의 결과를 저장하고, 이후 호출 시 인자에 관계없이 같은 결과를 반환합니다.\n * 초기화 함수나 싱글톤 생성 등 \"한 번만 실행되어야 하는 작업\"에 유용합니다.\n *\n * @param fn - 한 번만 실행할 함수\n * @returns 첫 호출 결과를 캐싱하는 래퍼 함수\n * @example\n * ```ts\n * const init = once(() => {\n *   console.log(\"initialized\");\n *   return { ready: true };\n * });\n *\n * init(); // \"initialized\" 출력 후 { ready: true } 반환\n * init(); // 출력 없음, 같은 객체 반환\n * ```\n */\nexport const once = <Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n): ((...args: Args) => R) => {\n  let called = false;\n  let result: R;\n  return (...args: Args): R => {\n    if (!called) {\n      called = true;\n      result = fn(...args);\n    }\n    return result;\n  };\n};\n\n/**\n * 함수의 결과를 인자별로 캐싱합니다. 동일한 인자로 다시 호출되면 캐시된 결과를 반환합니다.\n *\n * 기본 캐시 키는 `JSON.stringify(args)`로 생성되므로 객체 인자도 값 비교가 가능합니다.\n * 필요하면 `keyFn`을 직접 지정해 키 생성 로직을 커스터마이즈하세요.\n *\n * @param fn - 결과를 캐싱할 함수\n * @param keyFn - 인자에서 캐시 키를 만드는 함수 (기본값: `JSON.stringify(args)`)\n * @returns 결과 캐싱이 적용된 래퍼 함수\n * @example\n * ```ts\n * const slow = memoize((n: number) => {\n *   console.log(\"compute\", n);\n *   return n * 2;\n * });\n *\n * slow(2); // \"compute 2\" 출력 후 4\n * slow(2); // 출력 없음, 4\n * slow(3); // \"compute 3\" 출력 후 6\n *\n * // 커스텀 키: 객체 id 기준 캐싱\n * const byId = memoize(\n *   (user: { id: number; name: string }) => fetchProfile(user.id),\n *   (user) => String(user.id),\n * );\n * ```\n */\nexport const memoize = <Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n  keyFn: (...args: Args) => string = (...args) => JSON.stringify(args),\n): ((...args: Args) => R) => {\n  const cache = new Map<string, R>();\n  return (...args: Args): R => {\n    const key = keyFn(...args);\n    const cached = cache.get(key);\n    if (cached !== undefined || cache.has(key)) return cached as R;\n    const result = fn(...args);\n    cache.set(key, result);\n    return result;\n  };\n};\n\n/**\n * {@link retry} 함수의 옵션.\n */\nexport interface RetryOptions {\n  /** 추가 재시도 횟수. 총 시도 횟수는 `retries + 1`. 기본값 `3`. */\n  retries?: number;\n  /** 첫 재시도 전 대기 시간(ms). 기본값 `100`. */\n  delay?: number;\n  /** 매 재시도마다 대기 시간에 곱해질 배수 (지수 백오프). 기본값 `2`. */\n  backoff?: number;\n  /** 매 실패마다 호출되는 콜백. `attempt`는 0부터 시작하는 시도 인덱스. */\n  onError?: (error: unknown, attempt: number) => void;\n}\n\n/**\n * 함수를 호출하다가 예외가 나면 지수 백오프로 재시도합니다. 동기/비동기 함수 모두 지원합니다.\n *\n * 모든 시도가 실패하면 마지막 에러를 throw합니다.\n *\n * @param fn - 실행할 함수 (동기 또는 비동기)\n * @param opts - 재시도 옵션 ({@link RetryOptions} 참고)\n * @returns 함수의 결과를 담은 Promise\n * @example\n * ```ts\n * // 기본 옵션: 최대 3회 재시도, 100ms부터 2배씩 백오프 (100, 200, 400ms)\n * const data = await retry(() => fetch(\"/api/data\").then((r) => r.json()));\n *\n * // 커스텀 옵션\n * await retry(unstableTask, {\n *   retries: 5,\n *   delay: 200,\n *   backoff: 1.5,\n *   onError: (err, attempt) => console.warn(`시도 ${attempt + 1} 실패`, err),\n * });\n * ```\n */\nexport const retry = async <T>(\n  fn: () => Promise<T> | T,\n  opts: RetryOptions = {},\n): Promise<T> => {\n  const { retries = 3, delay = 100, backoff = 2, onError } = opts;\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= retries; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      onError?.(err, attempt);\n      if (attempt < retries) {\n        await sleep(delay * Math.pow(backoff, attempt));\n      }\n    }\n  }\n  throw lastError;\n};\n\n/**\n * Promise에 타임아웃을 부여합니다. 지정한 시간 안에 settle되지 않으면 reject됩니다.\n *\n * 원본 Promise가 먼저 끝나면 내부 타이머는 자동으로 해제되므로 타이머 누수가 없습니다.\n *\n * @param promise - 타임아웃을 걸 Promise\n * @param ms - 제한 시간 (밀리초)\n * @param errorMessage - 타임아웃 시 던질 에러 메시지 (기본값 `\"Operation timed out\"`)\n * @returns 원본 결과 또는 타임아웃 에러로 settle되는 Promise\n * @example\n * ```ts\n * try {\n *   const data = await withTimeout(fetch(\"/slow-api\"), 3000);\n * } catch (err) {\n *   // 3초 안에 안 오면 여기로 떨어짐\n * }\n *\n * await withTimeout(longTask(), 5000, \"작업이 너무 오래 걸립니다\");\n * ```\n */\nexport const withTimeout = <T>(\n  promise: Promise<T>,\n  ms: number,\n  errorMessage = \"Operation timed out\",\n): Promise<T> => {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);\n  });\n  return Promise.race([\n    promise.finally(() => {\n      if (timeoutId !== undefined) clearTimeout(timeoutId);\n    }),\n    timeout,\n  ]);\n};\n"]}

package/dist/fn/index.d.ts

@@ -1,5 +1,149 @@
-declare const debounce: <Args extends unknown[]>(fn: (...args: Args) => void, ms: number) => ((...args: Args) => void);
-declare const throttle: <Args extends unknown[]>(fn: (...args: Args) => void, ms: number) => ((...args: Args) => void);
-declare const sleep: (ms: number) => Promise<void>;
-
-export { debounce, sleep, throttle };
+/**
+ * 함수 호출을 지연시켜, 마지막 호출 후 `ms` 밀리초가 지나야 실제로 실행되도록 합니다.
+ * 검색 입력, 윈도우 리사이즈 등 "연속 입력이 멈춘 뒤"에 한 번만 실행하고 싶을 때 사용합니다.
+ *
+ * @param fn - 디바운스할 함수
+ * @param ms - 대기 시간 (밀리초)
+ * @returns 디바운스가 적용된 새 함수
+ * @example
+ * ```ts
+ * const onResize = debounce(() => console.log("resized"), 200);
+ * window.addEventListener("resize", onResize);
+ * // 사용자가 리사이즈를 멈춘 뒤 200ms 후에 한 번만 출력
+ * ```
+ */
+export declare const debounce: <Args extends unknown[]>(fn: (...args: Args) => void, ms: number) => ((...args: Args) => void);
+/**
+ * `ms` 밀리초마다 최대 한 번씩만 함수가 실행되도록 제한합니다.
+ * 스크롤/마우스 무브 등 너무 자주 호출되는 이벤트의 빈도를 줄일 때 사용합니다.
+ *
+ * @param fn - 스로틀할 함수
+ * @param ms - 최소 호출 간격 (밀리초)
+ * @returns 스로틀이 적용된 새 함수
+ * @example
+ * ```ts
+ * const onScroll = throttle(() => console.log("scroll"), 100);
+ * window.addEventListener("scroll", onScroll);
+ * // 100ms에 최대 1번만 출력
+ * ```
+ */
+export declare const throttle: <Args extends unknown[]>(fn: (...args: Args) => void, ms: number) => ((...args: Args) => void);
+/**
+ * 지정한 시간만큼 대기하는 Promise를 반환합니다.
+ *
+ * @param ms - 대기 시간 (밀리초)
+ * @returns `ms` 이후 resolve되는 Promise
+ * @example
+ * ```ts
+ * async function task() {
+ *   console.log("start");
+ *   await sleep(1000);
+ *   console.log("1초 뒤");
+ * }
+ * ```
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * 첫 호출의 결과를 저장하고, 이후 호출 시 인자에 관계없이 같은 결과를 반환합니다.
+ * 초기화 함수나 싱글톤 생성 등 "한 번만 실행되어야 하는 작업"에 유용합니다.
+ *
+ * @param fn - 한 번만 실행할 함수
+ * @returns 첫 호출 결과를 캐싱하는 래퍼 함수
+ * @example
+ * ```ts
+ * const init = once(() => {
+ *   console.log("initialized");
+ *   return { ready: true };
+ * });
+ *
+ * init(); // "initialized" 출력 후 { ready: true } 반환
+ * init(); // 출력 없음, 같은 객체 반환
+ * ```
+ */
+export declare const once: <Args extends unknown[], R>(fn: (...args: Args) => R) => ((...args: Args) => R);
+/**
+ * 함수의 결과를 인자별로 캐싱합니다. 동일한 인자로 다시 호출되면 캐시된 결과를 반환합니다.
+ *
+ * 기본 캐시 키는 `JSON.stringify(args)`로 생성되므로 객체 인자도 값 비교가 가능합니다.
+ * 필요하면 `keyFn`을 직접 지정해 키 생성 로직을 커스터마이즈하세요.
+ *
+ * @param fn - 결과를 캐싱할 함수
+ * @param keyFn - 인자에서 캐시 키를 만드는 함수 (기본값: `JSON.stringify(args)`)
+ * @returns 결과 캐싱이 적용된 래퍼 함수
+ * @example
+ * ```ts
+ * const slow = memoize((n: number) => {
+ *   console.log("compute", n);
+ *   return n * 2;
+ * });
+ *
+ * slow(2); // "compute 2" 출력 후 4
+ * slow(2); // 출력 없음, 4
+ * slow(3); // "compute 3" 출력 후 6
+ *
+ * // 커스텀 키: 객체 id 기준 캐싱
+ * const byId = memoize(
+ *   (user: { id: number; name: string }) => fetchProfile(user.id),
+ *   (user) => String(user.id),
+ * );
+ * ```
+ */
+export declare const memoize: <Args extends unknown[], R>(fn: (...args: Args) => R, keyFn?: (...args: Args) => string) => ((...args: Args) => R);
+/**
+ * {@link retry} 함수의 옵션.
+ */
+export interface RetryOptions {
+    /** 추가 재시도 횟수. 총 시도 횟수는 `retries + 1`. 기본값 `3`. */
+    retries?: number;
+    /** 첫 재시도 전 대기 시간(ms). 기본값 `100`. */
+    delay?: number;
+    /** 매 재시도마다 대기 시간에 곱해질 배수 (지수 백오프). 기본값 `2`. */
+    backoff?: number;
+    /** 매 실패마다 호출되는 콜백. `attempt`는 0부터 시작하는 시도 인덱스. */
+    onError?: (error: unknown, attempt: number) => void;
+}
+/**
+ * 함수를 호출하다가 예외가 나면 지수 백오프로 재시도합니다. 동기/비동기 함수 모두 지원합니다.
+ *
+ * 모든 시도가 실패하면 마지막 에러를 throw합니다.
+ *
+ * @param fn - 실행할 함수 (동기 또는 비동기)
+ * @param opts - 재시도 옵션 ({@link RetryOptions} 참고)
+ * @returns 함수의 결과를 담은 Promise
+ * @example
+ * ```ts
+ * // 기본 옵션: 최대 3회 재시도, 100ms부터 2배씩 백오프 (100, 200, 400ms)
+ * const data = await retry(() => fetch("/api/data").then((r) => r.json()));
+ *
+ * // 커스텀 옵션
+ * await retry(unstableTask, {
+ *   retries: 5,
+ *   delay: 200,
+ *   backoff: 1.5,
+ *   onError: (err, attempt) => console.warn(`시도 ${attempt + 1} 실패`, err),
+ * });
+ * ```
+ */
+export declare const retry: <T>(fn: () => Promise<T> | T, opts?: RetryOptions) => Promise<T>;
+/**
+ * Promise에 타임아웃을 부여합니다. 지정한 시간 안에 settle되지 않으면 reject됩니다.
+ *
+ * 원본 Promise가 먼저 끝나면 내부 타이머는 자동으로 해제되므로 타이머 누수가 없습니다.
+ *
+ * @param promise - 타임아웃을 걸 Promise
+ * @param ms - 제한 시간 (밀리초)
+ * @param errorMessage - 타임아웃 시 던질 에러 메시지 (기본값 `"Operation timed out"`)
+ * @returns 원본 결과 또는 타임아웃 에러로 settle되는 Promise
+ * @example
+ * ```ts
+ * try {
+ *   const data = await withTimeout(fetch("/slow-api"), 3000);
+ * } catch (err) {
+ *   // 3초 안에 안 오면 여기로 떨어짐
+ * }
+ *
+ * await withTimeout(longTask(), 5000, "작업이 너무 오래 걸립니다");
+ * ```
+ */
+export declare const withTimeout: <T>(promise: Promise<T>, ms: number, errorMessage?: string) => Promise<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/fn/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fn/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,SAAS,OAAO,EAAE,EAC7C,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,MAAM,KACT,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAM1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,SAAS,OAAO,EAAE,EAC7C,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,MAAM,KACT,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAS1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI,GAAI,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAC5C,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,KACvB,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAUvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,OAAO,GAAI,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAC/C,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EACxB,QAAO,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAA0C,KACnE,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAUvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK,GAAU,CAAC,EAC3B,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAM,YAAiB,KACtB,OAAO,CAAC,CAAC,CAeX,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,SAAS,OAAO,CAAC,CAAC,CAAC,EACnB,IAAI,MAAM,EACV,qBAAoC,KACnC,OAAO,CAAC,CAAC,CAWX,CAAC"}

package/dist/fn/index.js

@@ -17,7 +17,57 @@ var throttle = (fn, ms) => {
   };
 };
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var once = (fn) => {
+  let called = false;
+  let result;
+  return (...args) => {
+    if (!called) {
+      called = true;
+      result = fn(...args);
+    }
+    return result;
+  };
+};
+var memoize = (fn, keyFn = (...args) => JSON.stringify(args)) => {
+  const cache = /* @__PURE__ */ new Map();
+  return (...args) => {
+    const key = keyFn(...args);
+    const cached = cache.get(key);
+    if (cached !== void 0 || cache.has(key)) return cached;
+    const result = fn(...args);
+    cache.set(key, result);
+    return result;
+  };
+};
+var retry = async (fn, opts = {}) => {
+  const { retries = 3, delay = 100, backoff = 2, onError } = opts;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      onError?.(err, attempt);
+      if (attempt < retries) {
+        await sleep(delay * Math.pow(backoff, attempt));
+      }
+    }
+  }
+  throw lastError;
+};
+var withTimeout = (promise, ms, errorMessage = "Operation timed out") => {
+  let timeoutId;
+  const timeout = new Promise((_, reject) => {
+    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);
+  });
+  return Promise.race([
+    promise.finally(() => {
+      if (timeoutId !== void 0) clearTimeout(timeoutId);
+    }),
+    timeout
+  ]);
+};
 
-export { debounce, sleep, throttle };
+export { debounce, memoize, once, retry, sleep, throttle, withTimeout };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/fn/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fn/index.ts"],"names":[],"mappings":";AAAO,IAAM,QAAA,GAAW,CACtB,EAAA,EACA,EAAA,KAC8B;AAC9B,EAAA,IAAI,KAAA;AACJ,EAAA,OAAO,IAAI,IAAA,KAAe;AACxB,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,WAAW,MAAM,EAAA,CAAG,GAAG,IAAI,GAAG,EAAE,CAAA;AAAA,EAC1C,CAAA;AACF;AAEO,IAAM,QAAA,GAAW,CACtB,EAAA,EACA,EAAA,KAC8B;AAC9B,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,OAAO,IAAI,IAAA,KAAe;AACxB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI,GAAA,GAAM,QAAQ,EAAA,EAAI;AACpB,MAAA,IAAA,GAAO,GAAA;AACP,MAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,IACZ;AAAA,EACF,CAAA;AACF;AAEO,IAAM,KAAA,GAAQ,CAAC,EAAA,KACpB,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC","file":"index.js","sourcesContent":["export const debounce = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: Args) => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n};\n\nexport const throttle = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let last = 0;\n  return (...args: Args) => {\n    const now = Date.now();\n    if (now - last >= ms) {\n      last = now;\n      fn(...args);\n    }\n  };\n};\n\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n"]}
+{"version":3,"sources":["../../src/fn/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 함수 호출을 지연시켜, 마지막 호출 후 `ms` 밀리초가 지나야 실제로 실행되도록 합니다.\n * 검색 입력, 윈도우 리사이즈 등 \"연속 입력이 멈춘 뒤\"에 한 번만 실행하고 싶을 때 사용합니다.\n *\n * @param fn - 디바운스할 함수\n * @param ms - 대기 시간 (밀리초)\n * @returns 디바운스가 적용된 새 함수\n * @example\n * ```ts\n * const onResize = debounce(() => console.log(\"resized\"), 200);\n * window.addEventListener(\"resize\", onResize);\n * // 사용자가 리사이즈를 멈춘 뒤 200ms 후에 한 번만 출력\n * ```\n */\nexport const debounce = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: Args) => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n};\n\n/**\n * `ms` 밀리초마다 최대 한 번씩만 함수가 실행되도록 제한합니다.\n * 스크롤/마우스 무브 등 너무 자주 호출되는 이벤트의 빈도를 줄일 때 사용합니다.\n *\n * @param fn - 스로틀할 함수\n * @param ms - 최소 호출 간격 (밀리초)\n * @returns 스로틀이 적용된 새 함수\n * @example\n * ```ts\n * const onScroll = throttle(() => console.log(\"scroll\"), 100);\n * window.addEventListener(\"scroll\", onScroll);\n * // 100ms에 최대 1번만 출력\n * ```\n */\nexport const throttle = <Args extends unknown[]>(\n  fn: (...args: Args) => void,\n  ms: number,\n): ((...args: Args) => void) => {\n  let last = 0;\n  return (...args: Args) => {\n    const now = Date.now();\n    if (now - last >= ms) {\n      last = now;\n      fn(...args);\n    }\n  };\n};\n\n/**\n * 지정한 시간만큼 대기하는 Promise를 반환합니다.\n *\n * @param ms - 대기 시간 (밀리초)\n * @returns `ms` 이후 resolve되는 Promise\n * @example\n * ```ts\n * async function task() {\n *   console.log(\"start\");\n *   await sleep(1000);\n *   console.log(\"1초 뒤\");\n * }\n * ```\n */\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\n/**\n * 첫 호출의 결과를 저장하고, 이후 호출 시 인자에 관계없이 같은 결과를 반환합니다.\n * 초기화 함수나 싱글톤 생성 등 \"한 번만 실행되어야 하는 작업\"에 유용합니다.\n *\n * @param fn - 한 번만 실행할 함수\n * @returns 첫 호출 결과를 캐싱하는 래퍼 함수\n * @example\n * ```ts\n * const init = once(() => {\n *   console.log(\"initialized\");\n *   return { ready: true };\n * });\n *\n * init(); // \"initialized\" 출력 후 { ready: true } 반환\n * init(); // 출력 없음, 같은 객체 반환\n * ```\n */\nexport const once = <Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n): ((...args: Args) => R) => {\n  let called = false;\n  let result: R;\n  return (...args: Args): R => {\n    if (!called) {\n      called = true;\n      result = fn(...args);\n    }\n    return result;\n  };\n};\n\n/**\n * 함수의 결과를 인자별로 캐싱합니다. 동일한 인자로 다시 호출되면 캐시된 결과를 반환합니다.\n *\n * 기본 캐시 키는 `JSON.stringify(args)`로 생성되므로 객체 인자도 값 비교가 가능합니다.\n * 필요하면 `keyFn`을 직접 지정해 키 생성 로직을 커스터마이즈하세요.\n *\n * @param fn - 결과를 캐싱할 함수\n * @param keyFn - 인자에서 캐시 키를 만드는 함수 (기본값: `JSON.stringify(args)`)\n * @returns 결과 캐싱이 적용된 래퍼 함수\n * @example\n * ```ts\n * const slow = memoize((n: number) => {\n *   console.log(\"compute\", n);\n *   return n * 2;\n * });\n *\n * slow(2); // \"compute 2\" 출력 후 4\n * slow(2); // 출력 없음, 4\n * slow(3); // \"compute 3\" 출력 후 6\n *\n * // 커스텀 키: 객체 id 기준 캐싱\n * const byId = memoize(\n *   (user: { id: number; name: string }) => fetchProfile(user.id),\n *   (user) => String(user.id),\n * );\n * ```\n */\nexport const memoize = <Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n  keyFn: (...args: Args) => string = (...args) => JSON.stringify(args),\n): ((...args: Args) => R) => {\n  const cache = new Map<string, R>();\n  return (...args: Args): R => {\n    const key = keyFn(...args);\n    const cached = cache.get(key);\n    if (cached !== undefined || cache.has(key)) return cached as R;\n    const result = fn(...args);\n    cache.set(key, result);\n    return result;\n  };\n};\n\n/**\n * {@link retry} 함수의 옵션.\n */\nexport interface RetryOptions {\n  /** 추가 재시도 횟수. 총 시도 횟수는 `retries + 1`. 기본값 `3`. */\n  retries?: number;\n  /** 첫 재시도 전 대기 시간(ms). 기본값 `100`. */\n  delay?: number;\n  /** 매 재시도마다 대기 시간에 곱해질 배수 (지수 백오프). 기본값 `2`. */\n  backoff?: number;\n  /** 매 실패마다 호출되는 콜백. `attempt`는 0부터 시작하는 시도 인덱스. */\n  onError?: (error: unknown, attempt: number) => void;\n}\n\n/**\n * 함수를 호출하다가 예외가 나면 지수 백오프로 재시도합니다. 동기/비동기 함수 모두 지원합니다.\n *\n * 모든 시도가 실패하면 마지막 에러를 throw합니다.\n *\n * @param fn - 실행할 함수 (동기 또는 비동기)\n * @param opts - 재시도 옵션 ({@link RetryOptions} 참고)\n * @returns 함수의 결과를 담은 Promise\n * @example\n * ```ts\n * // 기본 옵션: 최대 3회 재시도, 100ms부터 2배씩 백오프 (100, 200, 400ms)\n * const data = await retry(() => fetch(\"/api/data\").then((r) => r.json()));\n *\n * // 커스텀 옵션\n * await retry(unstableTask, {\n *   retries: 5,\n *   delay: 200,\n *   backoff: 1.5,\n *   onError: (err, attempt) => console.warn(`시도 ${attempt + 1} 실패`, err),\n * });\n * ```\n */\nexport const retry = async <T>(\n  fn: () => Promise<T> | T,\n  opts: RetryOptions = {},\n): Promise<T> => {\n  const { retries = 3, delay = 100, backoff = 2, onError } = opts;\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= retries; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      onError?.(err, attempt);\n      if (attempt < retries) {\n        await sleep(delay * Math.pow(backoff, attempt));\n      }\n    }\n  }\n  throw lastError;\n};\n\n/**\n * Promise에 타임아웃을 부여합니다. 지정한 시간 안에 settle되지 않으면 reject됩니다.\n *\n * 원본 Promise가 먼저 끝나면 내부 타이머는 자동으로 해제되므로 타이머 누수가 없습니다.\n *\n * @param promise - 타임아웃을 걸 Promise\n * @param ms - 제한 시간 (밀리초)\n * @param errorMessage - 타임아웃 시 던질 에러 메시지 (기본값 `\"Operation timed out\"`)\n * @returns 원본 결과 또는 타임아웃 에러로 settle되는 Promise\n * @example\n * ```ts\n * try {\n *   const data = await withTimeout(fetch(\"/slow-api\"), 3000);\n * } catch (err) {\n *   // 3초 안에 안 오면 여기로 떨어짐\n * }\n *\n * await withTimeout(longTask(), 5000, \"작업이 너무 오래 걸립니다\");\n * ```\n */\nexport const withTimeout = <T>(\n  promise: Promise<T>,\n  ms: number,\n  errorMessage = \"Operation timed out\",\n): Promise<T> => {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);\n  });\n  return Promise.race([\n    promise.finally(() => {\n      if (timeoutId !== undefined) clearTimeout(timeoutId);\n    }),\n    timeout,\n  ]);\n};\n"]}