@fuzionx/framework 0.1.38 → 0.1.41

package/lib/utilities/FunctionUtil.js

@@ -1,119 +1,119 @@
-/**
- * FunctionUtil — 함수 순수 유틸리티
- */
-
-/**
- * Debounce — 마지막 호출 후 delay ms 뒤 실행
- * @param {Function} fn
- * @param {number} delay - ms
- * @returns {Function}
- */
-export function debounce(fn, delay = 300) {
-    let timer;
-    const debounced = (...args) => {
-        clearTimeout(timer);
-        timer = setTimeout(() => fn(...args), delay);
-    };
-    debounced.cancel = () => clearTimeout(timer);
-    return debounced;
-}
-
-/**
- * Throttle — delay ms 간격으로 최대 1회 실행
- * @param {Function} fn
- * @param {number} delay - ms
- * @returns {Function}
- */
-export function throttle(fn, delay = 300) {
-    let last = 0;
-    let timer;
-    return (...args) => {
-        const now = Date.now();
-        const remaining = delay - (now - last);
-        clearTimeout(timer);
-        if (remaining <= 0) {
-            last = now;
-            fn(...args);
-        } else {
-            timer = setTimeout(() => {
-                last = Date.now();
-                fn(...args);
-            }, remaining);
-        }
-    };
-}
-
-/**
- * 한 번만 실행
- * @param {Function} fn
- * @returns {Function}
- */
-export function once(fn) {
-    let called = false;
-    let result;
-    return (...args) => {
-        if (called) return result;
-        called = true;
-        result = fn(...args);
-        return result;
-    };
-}
-
-/**
- * Promise 타임아웃 래퍼
- * @param {Promise} promise
- * @param {number} ms
- * @param {string} [message='Timeout']
- * @returns {Promise}
- */
-export function timeout(promise, ms, message = 'Timeout') {
-    return Promise.race([
-        promise,
-        new Promise((_, reject) => setTimeout(() => reject(new Error(message)), ms)),
-    ]);
-}
-
-/**
- * 딜레이 (async sleep)
- * @param {number} ms
- * @returns {Promise<void>}
- */
-export function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-/**
- * 함수 파이프라인 (왼→오) — 순차 실행
- * @param {...Function} fns
- * @returns {Function}
- *
- * @example pipe(addOne, double, square)(2) → square(double(addOne(2)))
- */
-export function pipe(...fns) {
-    return (x) => fns.reduce((v, fn) => fn(v), x);
-}
-
-/**
- * 메모이제이션 — 결과 캐싱
- * @param {Function} fn
- * @param {Function} [keyFn] - 캐시 키 생성 함수 (기본: 첫 인자)
- * @returns {Function}
- */
-export function memoize(fn, keyFn) {
-    const cache = new Map();
-    const memoized = (...args) => {
-        const key = keyFn ? keyFn(...args) : args[0];
-        if (cache.has(key)) return cache.get(key);
-        const result = fn(...args);
-        cache.set(key, result);
-        return result;
-    };
-    memoized.cache = cache;
-    memoized.clear = () => cache.clear();
-    return memoized;
-}
-
-/**
- * noop — 아무것도 하지 않는 함수
- */
-export function noop() {}
+/**
+ * FunctionUtil — 함수 순수 유틸리티
+ */
+
+/**
+ * Debounce — 마지막 호출 후 delay ms 뒤 실행
+ * @param {Function} fn
+ * @param {number} delay - ms
+ * @returns {Function}
+ */
+export function debounce(fn, delay = 300) {
+    let timer;
+    const debounced = (...args) => {
+        clearTimeout(timer);
+        timer = setTimeout(() => fn(...args), delay);
+    };
+    debounced.cancel = () => clearTimeout(timer);
+    return debounced;
+}
+
+/**
+ * Throttle — delay ms 간격으로 최대 1회 실행
+ * @param {Function} fn
+ * @param {number} delay - ms
+ * @returns {Function}
+ */
+export function throttle(fn, delay = 300) {
+    let last = 0;
+    let timer;
+    return (...args) => {
+        const now = Date.now();
+        const remaining = delay - (now - last);
+        clearTimeout(timer);
+        if (remaining <= 0) {
+            last = now;
+            fn(...args);
+        } else {
+            timer = setTimeout(() => {
+                last = Date.now();
+                fn(...args);
+            }, remaining);
+        }
+    };
+}
+
+/**
+ * 한 번만 실행
+ * @param {Function} fn
+ * @returns {Function}
+ */
+export function once(fn) {
+    let called = false;
+    let result;
+    return (...args) => {
+        if (called) return result;
+        called = true;
+        result = fn(...args);
+        return result;
+    };
+}
+
+/**
+ * Promise 타임아웃 래퍼
+ * @param {Promise} promise
+ * @param {number} ms
+ * @param {string} [message='Timeout']
+ * @returns {Promise}
+ */
+export function timeout(promise, ms, message = 'Timeout') {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(message)), ms)),
+    ]);
+}
+
+/**
+ * 딜레이 (async sleep)
+ * @param {number} ms
+ * @returns {Promise<void>}
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * 함수 파이프라인 (왼→오) — 순차 실행
+ * @param {...Function} fns
+ * @returns {Function}
+ *
+ * @example pipe(addOne, double, square)(2) → square(double(addOne(2)))
+ */
+export function pipe(...fns) {
+    return (x) => fns.reduce((v, fn) => fn(v), x);
+}
+
+/**
+ * 메모이제이션 — 결과 캐싱
+ * @param {Function} fn
+ * @param {Function} [keyFn] - 캐시 키 생성 함수 (기본: 첫 인자)
+ * @returns {Function}
+ */
+export function memoize(fn, keyFn) {
+    const cache = new Map();
+    const memoized = (...args) => {
+        const key = keyFn ? keyFn(...args) : args[0];
+        if (cache.has(key)) return cache.get(key);
+        const result = fn(...args);
+        cache.set(key, result);
+        return result;
+    };
+    memoized.cache = cache;
+    memoized.clear = () => cache.clear();
+    return memoized;
+}
+
+/**
+ * noop — 아무것도 하지 않는 함수
+ */
+export function noop() {}

package/lib/utilities/NumUtil.js

@@ -1,75 +1,75 @@
-/**
- * NumUtil — 숫자 순수 유틸리티
- */
-
-/**
- * 범위 제한 (clamp)
- * @param {number} n
- * @param {number} min
- * @param {number} max
- * @returns {number}
- */
-export function clamp(n, min, max) {
-    return Math.min(Math.max(n, min), max);
-}
-
-/**
- * 범위 내 랜덤 정수
- * @param {number} min
- * @param {number} max
- * @returns {number}
- */
-export function random(min = 0, max = 100) {
-    return Math.floor(Math.random() * (max - min + 1)) + min;
-}
-
-/**
- * 숫자 포맷 (로케일)
- * @param {number} n
- * @param {string} [locale='ko-KR']
- * @returns {string}
- *
- * @example format(1234567) → '1,234,567'
- */
-export function format(n, locale = 'ko-KR') {
-    return new Intl.NumberFormat(locale).format(n);
-}
-
-/**
- * 바이트 → 읽기 쉬운 단위 변환
- * @param {number} bytes
- * @param {number} [decimals=2]
- * @returns {string}
- *
- * @example fileSize(1536) → '1.50 KB'
- */
-export function fileSize(bytes, decimals = 2) {
-    if (bytes === 0) return '0 B';
-    const k = 1024;
-    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(decimals))} ${units[i]}`;
-}
-
-/**
- * 퍼센트 계산
- * @param {number} part
- * @param {number} total
- * @param {number} [decimals=1]
- * @returns {number}
- */
-export function percent(part, total, decimals = 1) {
-    if (total === 0) return 0;
-    return parseFloat(((part / total) * 100).toFixed(decimals));
-}
-
-/**
- * 안전한 정수 파싱
- * @param {*} value
- * @param {number} [fallback=0]
- * @returns {number}
- */
-export function toInt(value, fallback = 0) {
-    const n = parseInt(value, 10);
-    return isNaN(n) ? fallback : n;
-}
+/**
+ * NumUtil — 숫자 순수 유틸리티
+ */
+
+/**
+ * 범위 제한 (clamp)
+ * @param {number} n
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+export function clamp(n, min, max) {
+    return Math.min(Math.max(n, min), max);
+}
+
+/**
+ * 범위 내 랜덤 정수
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+export function random(min = 0, max = 100) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+/**
+ * 숫자 포맷 (로케일)
+ * @param {number} n
+ * @param {string} [locale='ko-KR']
+ * @returns {string}
+ *
+ * @example format(1234567) → '1,234,567'
+ */
+export function format(n, locale = 'ko-KR') {
+    return new Intl.NumberFormat(locale).format(n);
+}
+
+/**
+ * 바이트 → 읽기 쉬운 단위 변환
+ * @param {number} bytes
+ * @param {number} [decimals=2]
+ * @returns {string}
+ *
+ * @example fileSize(1536) → '1.50 KB'
+ */
+export function fileSize(bytes, decimals = 2) {
+    if (bytes === 0) return '0 B';
+    const k = 1024;
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(decimals))} ${units[i]}`;
+}
+
+/**
+ * 퍼센트 계산
+ * @param {number} part
+ * @param {number} total
+ * @param {number} [decimals=1]
+ * @returns {number}
+ */
+export function percent(part, total, decimals = 1) {
+    if (total === 0) return 0;
+    return parseFloat(((part / total) * 100).toFixed(decimals));
+}
+
+/**
+ * 안전한 정수 파싱
+ * @param {*} value
+ * @param {number} [fallback=0]
+ * @returns {number}
+ */
+export function toInt(value, fallback = 0) {
+    const n = parseInt(value, 10);
+    return isNaN(n) ? fallback : n;
+}