@fuzionx/framework 0.1.39 → 0.1.41

package/lib/utilities/StrUtil.js

@@ -1,105 +1,105 @@
-/**
- * StrUtil — 문자열 순수 유틸리티
- */
-
-/**
- * URL-safe slug 생성
- * @param {string} str
- * @returns {string}
- */
-export function slug(str) {
-    return str
-        .toLowerCase()
-        .trim()
-        .replace(/[^\w\s가-힣-]/g, '')
-        .replace(/[\s_]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-}
-
-/**
- * 말줄임 (한글/이모지 안전)
- * @param {string} str
- * @param {number} len
- * @param {string} [suffix='…']
- * @returns {string}
- */
-export function truncate(str, len, suffix = '…') {
-    if (!str || str.length <= len) return str || '';
-    return str.slice(0, len) + suffix;
-}
-
-/**
- * camelCase 변환
- * @param {string} str
- * @returns {string}
- */
-export function camelCase(str) {
-    return str
-        .replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '')
-        .replace(/^[A-Z]/, c => c.toLowerCase());
-}
-
-/**
- * snake_case 변환
- * @param {string} str
- * @returns {string}
- */
-export function snakeCase(str) {
-    return str
-        .replace(/([a-z])([A-Z])/g, '$1_$2')
-        .replace(/[-\s]+/g, '_')
-        .toLowerCase();
-}
-
-/**
- * PascalCase 변환
- * @param {string} str
- * @returns {string}
- */
-export function pascalCase(str) {
-    return str
-        .replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '')
-        .replace(/^[a-z]/, c => c.toUpperCase());
-}
-
-/**
- * 첫 글자 대문자
- * @param {string} str
- * @returns {string}
- */
-export function capitalize(str) {
-    if (!str) return '';
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
-
-/**
- * 랜덤 문자열 생성
- * @param {number} len
- * @param {string} [chars]
- * @returns {string}
- */
-export function random(len = 16, chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789') {
-    let result = '';
-    for (let i = 0; i < len; i++) {
-        result += chars.charAt(Math.floor(Math.random() * chars.length));
-    }
-    return result;
-}
-
-/**
- * 마스킹 (이메일, 전화번호 등)
- * @param {string} str
- * @param {number} [visibleStart=2]
- * @param {number} [visibleEnd=2]
- * @param {string} [mask='*']
- * @returns {string}
- *
- * @example mask('hello@test.com', 2, 4) → 'he*****t.com'
- */
-export function mask(str, visibleStart = 2, visibleEnd = 2, maskChar = '*') {
-    if (!str || str.length <= visibleStart + visibleEnd) return str || '';
-    const start = str.slice(0, visibleStart);
-    const end = str.slice(-visibleEnd);
-    const middle = maskChar.repeat(str.length - visibleStart - visibleEnd);
-    return start + middle + end;
-}
+/**
+ * StrUtil — 문자열 순수 유틸리티
+ */
+
+/**
+ * URL-safe slug 생성
+ * @param {string} str
+ * @returns {string}
+ */
+export function slug(str) {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s가-힣-]/g, '')
+        .replace(/[\s_]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+
+/**
+ * 말줄임 (한글/이모지 안전)
+ * @param {string} str
+ * @param {number} len
+ * @param {string} [suffix='…']
+ * @returns {string}
+ */
+export function truncate(str, len, suffix = '…') {
+    if (!str || str.length <= len) return str || '';
+    return str.slice(0, len) + suffix;
+}
+
+/**
+ * camelCase 변환
+ * @param {string} str
+ * @returns {string}
+ */
+export function camelCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '')
+        .replace(/^[A-Z]/, c => c.toLowerCase());
+}
+
+/**
+ * snake_case 변환
+ * @param {string} str
+ * @returns {string}
+ */
+export function snakeCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/[-\s]+/g, '_')
+        .toLowerCase();
+}
+
+/**
+ * PascalCase 변환
+ * @param {string} str
+ * @returns {string}
+ */
+export function pascalCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '')
+        .replace(/^[a-z]/, c => c.toUpperCase());
+}
+
+/**
+ * 첫 글자 대문자
+ * @param {string} str
+ * @returns {string}
+ */
+export function capitalize(str) {
+    if (!str) return '';
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * 랜덤 문자열 생성
+ * @param {number} len
+ * @param {string} [chars]
+ * @returns {string}
+ */
+export function random(len = 16, chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789') {
+    let result = '';
+    for (let i = 0; i < len; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+
+/**
+ * 마스킹 (이메일, 전화번호 등)
+ * @param {string} str
+ * @param {number} [visibleStart=2]
+ * @param {number} [visibleEnd=2]
+ * @param {string} [mask='*']
+ * @returns {string}
+ *
+ * @example mask('hello@test.com', 2, 4) → 'he*****t.com'
+ */
+export function mask(str, visibleStart = 2, visibleEnd = 2, maskChar = '*') {
+    if (!str || str.length <= visibleStart + visibleEnd) return str || '';
+    const start = str.slice(0, visibleStart);
+    const end = str.slice(-visibleEnd);
+    const middle = maskChar.repeat(str.length - visibleStart - visibleEnd);
+    return start + middle + end;
+}

package/lib/utilities/index.js

@@ -1,18 +1,18 @@
-/**
- * Utilities — 순수 함수 유틸리티 배럴 export
- *
- * Helper와 달리 Bridge/App 의존 없이 import 즉시 사용 가능.
- *
- * @example
- * import { PaginationUtil, StrUtil, ObjectUtil } from '@fuzionx/framework';
- * const meta = PaginationUtil.buildMeta(100, 1, 20);
- * const s = StrUtil.slug('Hello World');
- * const cleaned = ObjectUtil.omit(user, ['password']);
- */
-export * as PaginationUtil from './PaginationUtil.js';
-export * as StrUtil from './StrUtil.js';
-export * as NumUtil from './NumUtil.js';
-export * as DateUtil from './DateUtil.js';
-export * as ArrUtil from './ArrUtil.js';
-export * as FunctionUtil from './FunctionUtil.js';
-export * as ObjectUtil from './ObjectUtil.js';
+/**
+ * Utilities — 순수 함수 유틸리티 배럴 export
+ *
+ * Helper와 달리 Bridge/App 의존 없이 import 즉시 사용 가능.
+ *
+ * @example
+ * import { PaginationUtil, StrUtil, ObjectUtil } from '@fuzionx/framework';
+ * const meta = PaginationUtil.buildMeta(100, 1, 20);
+ * const s = StrUtil.slug('Hello World');
+ * const cleaned = ObjectUtil.omit(user, ['password']);
+ */
+export * as PaginationUtil from './PaginationUtil.js';
+export * as StrUtil from './StrUtil.js';
+export * as NumUtil from './NumUtil.js';
+export * as DateUtil from './DateUtil.js';
+export * as ArrUtil from './ArrUtil.js';
+export * as FunctionUtil from './FunctionUtil.js';
+export * as ObjectUtil from './ObjectUtil.js';