@blastlabs/utils 1.11.0

package/dist/hooks/useWindowSize.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 윈도우 크기 정보
+ */
+export interface WindowSize {
+    /** 윈도우 너비 (픽셀) */
+    width: number;
+    /** 윈도우 높이 (픽셀) */
+    height: number;
+}
+/**
+ * 윈도우 크기를 추적하는 hook
+ *
+ * @returns 윈도우의 현재 너비와 높이
+ *
+ * @example
+ * // 기본 사용
+ * function ResponsiveComponent() {
+ *   const { width, height } = useWindowSize();
+ *
+ *   return (
+ *     <div>
+ *       Window size: {width} x {height}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // 반응형 레이아웃
+ * function AdaptiveLayout() {
+ *   const { width } = useWindowSize();
+ *
+ *   if (width < 768) {
+ *     return <MobileLayout />;
+ *   } else if (width < 1024) {
+ *     return <TabletLayout />;
+ *   } else {
+ *     return <DesktopLayout />;
+ *   }
+ * }
+ *
+ * @example
+ * // 캔버스 크기 조정
+ * function Canvas() {
+ *   const { width, height } = useWindowSize();
+ *   const canvasRef = useRef<HTMLCanvasElement>(null);
+ *
+ *   useEffect(() => {
+ *     if (canvasRef.current) {
+ *       canvasRef.current.width = width;
+ *       canvasRef.current.height = height;
+ *     }
+ *   }, [width, height]);
+ *
+ *   return <canvas ref={canvasRef} />;
+ * }
+ */
+export declare function useWindowSize(): WindowSize;
+//# sourceMappingURL=useWindowSize.d.ts.map

package/dist/hooks/useWindowSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWindowSize.d.ts","sourceRoot":"","sources":["../../src/hooks/useWindowSize.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAoC1C"}

package/dist/hooks/useWindowSize.js

@@ -0,0 +1,79 @@
+import { useState, useEffect } from 'react';
+/**
+ * 윈도우 크기를 추적하는 hook
+ *
+ * @returns 윈도우의 현재 너비와 높이
+ *
+ * @example
+ * // 기본 사용
+ * function ResponsiveComponent() {
+ *   const { width, height } = useWindowSize();
+ *
+ *   return (
+ *     <div>
+ *       Window size: {width} x {height}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // 반응형 레이아웃
+ * function AdaptiveLayout() {
+ *   const { width } = useWindowSize();
+ *
+ *   if (width < 768) {
+ *     return <MobileLayout />;
+ *   } else if (width < 1024) {
+ *     return <TabletLayout />;
+ *   } else {
+ *     return <DesktopLayout />;
+ *   }
+ * }
+ *
+ * @example
+ * // 캔버스 크기 조정
+ * function Canvas() {
+ *   const { width, height } = useWindowSize();
+ *   const canvasRef = useRef<HTMLCanvasElement>(null);
+ *
+ *   useEffect(() => {
+ *     if (canvasRef.current) {
+ *       canvasRef.current.width = width;
+ *       canvasRef.current.height = height;
+ *     }
+ *   }, [width, height]);
+ *
+ *   return <canvas ref={canvasRef} />;
+ * }
+ */
+export function useWindowSize() {
+    // SSR 환경에서는 기본값 사용
+    const [windowSize, setWindowSize] = useState(() => {
+        if (typeof window === 'undefined') {
+            return { width: 0, height: 0 };
+        }
+        return {
+            width: window.innerWidth,
+            height: window.innerHeight,
+        };
+    });
+    useEffect(() => {
+        // SSR 환경에서는 이벤트 리스너 추가하지 않음
+        if (typeof window === 'undefined') {
+            return;
+        }
+        const handleResize = () => {
+            setWindowSize({
+                width: window.innerWidth,
+                height: window.innerHeight,
+            });
+        };
+        // 초기 크기 설정
+        handleResize();
+        window.addEventListener('resize', handleResize);
+        return () => {
+            window.removeEventListener('resize', handleResize);
+        };
+    }, []);
+    return windowSize;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './date';
+export * from './form';
+export * from './string';
+export * from './number';
+export * from './mock';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// Date utilities
+export * from './date';
+// Form utilities
+export * from './form';
+// String utilities
+export * from './string';
+// Number utilities
+export * from './number';
+// Mock data utilities
+export * from './mock';
+// React Hooks (import separately: 'goodchuck-utils/hooks')
+// Note: Hooks are not exported from main entry to avoid React dependency for non-React users
+// export * from './hooks';
+// Array utilities (placeholder for future)
+// export * from './array';
+// Object utilities (placeholder for future)
+// export * from './object';

package/dist/mock/form.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Form Mock Data Generator
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 자동 생성
+ */
+/**
+ * 폼 스키마로부터 mock 데이터 생성
+ * @param schema - 폼 스키마 (필드명과 타입 정보)
+ * @param count - 생성할 데이터 개수 (기본값: 1)
+ * @returns 생성된 mock 데이터 배열
+ *
+ * @example
+ * generateFormMockData({
+ *   name: { type: 'text' },
+ *   email: { type: 'email' },
+ *   age: { type: 'number', min: 18, max: 80 }
+ * }) // [{ name: "김민수", email: "user123@example.com", age: 25 }]
+ *
+ * @example
+ * generateFormMockData({
+ *   username: 'text',
+ *   email: 'email',
+ *   phone: 'tel'
+ * }, 5) // 5개의 mock 데이터 배열
+ */
+export declare function generateFormMockData(schema: Record<string, any>, count?: number): Record<string, any>[];
+/**
+ * react-hook-form의 defaultValues로부터 mock 데이터 생성
+ * @param defaultValues - react-hook-form의 defaultValues
+ * @param count - 생성할 데이터 개수 (기본값: 1)
+ * @returns 생성된 mock 데이터 배열
+ *
+ * @example
+ * generateFromDefaultValues({
+ *   username: '',
+ *   email: '',
+ *   age: 0
+ * }) // [{ username: "johnsmith", email: "user123@example.com", age: 25 }]
+ */
+export declare function generateFromDefaultValues(defaultValues: Record<string, any>, count?: number): Record<string, any>[];
+//# sourceMappingURL=form.d.ts.map

package/dist/mock/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/mock/form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4GH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,KAAK,GAAE,MAAU,GAChB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAiCvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,KAAK,GAAE,MAAU,GAChB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAuBvB"}

package/dist/mock/form.js

@@ -0,0 +1,195 @@
+/**
+ * Form Mock Data Generator
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 자동 생성
+ */
+import { generateKoreanName, generateEnglishName, generateEmail, generatePhoneNumber, generateAddress, generateDate, generateNumber, generateKoreanText, generateBoolean, generateFromArray, } from './generators';
+/**
+ * 필드 타입별 mock 데이터 생성 맵핑
+ */
+const fieldTypeMap = {
+    // 이름 관련
+    name: () => generateKoreanName(),
+    username: () => generateEnglishName().toLowerCase().replace(/\s/g, ''),
+    fullName: () => generateKoreanName(),
+    firstName: () => generateKoreanName().substring(1),
+    lastName: () => generateKoreanName().substring(0, 1),
+    // 연락처 관련
+    email: (fieldName) => generateEmail(),
+    phone: () => generatePhoneNumber(),
+    phoneNumber: () => generatePhoneNumber(),
+    mobile: () => generatePhoneNumber(),
+    tel: () => generatePhoneNumber(),
+    // 주소 관련
+    address: () => generateAddress(),
+    zipCode: () => String(generateNumber(10000, 99999)),
+    postalCode: () => String(generateNumber(10000, 99999)),
+    // 날짜 관련
+    date: () => generateDate(),
+    birthDate: () => generateDate('1950-01-01', '2010-12-31'),
+    birthday: () => generateDate('1950-01-01', '2010-12-31'),
+    // 숫자 관련
+    age: () => generateNumber(18, 80),
+    price: () => generateNumber(1000, 1000000),
+    amount: () => generateNumber(1, 1000),
+    quantity: () => generateNumber(1, 100),
+    count: () => generateNumber(0, 100),
+    // 텍스트 관련
+    title: () => generateKoreanText(10),
+    content: () => generateKoreanText(50),
+    description: () => generateKoreanText(30),
+    message: () => generateKoreanText(20),
+    comment: () => generateKoreanText(15),
+    note: () => generateKoreanText(20),
+    // 불린 관련
+    isActive: () => generateBoolean(),
+    enabled: () => generateBoolean(),
+    checked: () => generateBoolean(),
+    agree: () => generateBoolean(),
+    accept: () => generateBoolean(),
+    // 기본값
+    default: (fieldName) => {
+        // 필드명에 따라 추론
+        const lowerName = fieldName.toLowerCase();
+        if (lowerName.includes('email'))
+            return generateEmail();
+        if (lowerName.includes('phone') || lowerName.includes('tel') || lowerName.includes('mobile'))
+            return generatePhoneNumber();
+        if (lowerName.includes('name'))
+            return generateKoreanName();
+        if (lowerName.includes('address'))
+            return generateAddress();
+        if (lowerName.includes('date') || lowerName.includes('birth'))
+            return generateDate();
+        if (lowerName.includes('age') || lowerName.includes('count') || lowerName.includes('quantity'))
+            return generateNumber(1, 100);
+        if (lowerName.includes('price') || lowerName.includes('amount') || lowerName.includes('cost'))
+            return generateNumber(1000, 100000);
+        if (lowerName.includes('is') || lowerName.includes('has') || lowerName.includes('can'))
+            return generateBoolean();
+        return generateKoreanText(10);
+    },
+};
+/**
+ * 필드 타입을 추론하여 mock 데이터 생성
+ * @param fieldName - 필드 이름
+ * @param fieldType - 필드 타입 (선택)
+ * @param options - 추가 옵션
+ * @returns 생성된 mock 데이터
+ */
+function inferAndGenerate(fieldName, fieldType, options) {
+    const lowerName = fieldName.toLowerCase();
+    const lowerType = fieldType?.toLowerCase() || '';
+    // 타입 기반 생성
+    if (lowerType.includes('email'))
+        return generateEmail();
+    if (lowerType.includes('tel') || lowerType.includes('phone'))
+        return generatePhoneNumber();
+    if (lowerType.includes('date'))
+        return generateDate();
+    if (lowerType.includes('number') || lowerType.includes('int'))
+        return generateNumber(options?.min, options?.max);
+    if (lowerType.includes('boolean') || lowerType.includes('bool'))
+        return generateBoolean();
+    if (lowerType.includes('text') || lowerType.includes('string')) {
+        return options?.maxLength ? generateKoreanText(Math.min(options.maxLength, 50)) : generateKoreanText(10);
+    }
+    // 필드명 기반 생성
+    const generator = fieldTypeMap[lowerName] || fieldTypeMap.default;
+    return generator(fieldName, options);
+}
+/**
+ * 폼 스키마로부터 mock 데이터 생성
+ * @param schema - 폼 스키마 (필드명과 타입 정보)
+ * @param count - 생성할 데이터 개수 (기본값: 1)
+ * @returns 생성된 mock 데이터 배열
+ *
+ * @example
+ * generateFormMockData({
+ *   name: { type: 'text' },
+ *   email: { type: 'email' },
+ *   age: { type: 'number', min: 18, max: 80 }
+ * }) // [{ name: "김민수", email: "user123@example.com", age: 25 }]
+ *
+ * @example
+ * generateFormMockData({
+ *   username: 'text',
+ *   email: 'email',
+ *   phone: 'tel'
+ * }, 5) // 5개의 mock 데이터 배열
+ */
+export function generateFormMockData(schema, count = 1) {
+    const results = [];
+    for (let i = 0; i < count; i++) {
+        const data = {};
+        for (const [fieldName, fieldConfig] of Object.entries(schema)) {
+            if (typeof fieldConfig === 'string') {
+                // 간단한 타입 문자열인 경우
+                data[fieldName] = inferAndGenerate(fieldName, fieldConfig);
+            }
+            else if (typeof fieldConfig === 'object' && fieldConfig !== null) {
+                // 객체 형태인 경우
+                if (fieldConfig.type) {
+                    data[fieldName] = inferAndGenerate(fieldName, fieldConfig.type, fieldConfig);
+                }
+                else if (fieldConfig.enum) {
+                    // enum 값이 있는 경우
+                    data[fieldName] = generateFromArray(fieldConfig.enum);
+                }
+                else if (fieldConfig.default !== undefined) {
+                    // default 값이 있는 경우
+                    data[fieldName] = fieldConfig.default;
+                }
+                else {
+                    data[fieldName] = inferAndGenerate(fieldName, undefined, fieldConfig);
+                }
+            }
+            else {
+                // 그 외의 경우 필드명으로 추론
+                data[fieldName] = inferAndGenerate(fieldName);
+            }
+        }
+        results.push(data);
+    }
+    return results;
+}
+/**
+ * react-hook-form의 defaultValues로부터 mock 데이터 생성
+ * @param defaultValues - react-hook-form의 defaultValues
+ * @param count - 생성할 데이터 개수 (기본값: 1)
+ * @returns 생성된 mock 데이터 배열
+ *
+ * @example
+ * generateFromDefaultValues({
+ *   username: '',
+ *   email: '',
+ *   age: 0
+ * }) // [{ username: "johnsmith", email: "user123@example.com", age: 25 }]
+ */
+export function generateFromDefaultValues(defaultValues, count = 1) {
+    const schema = {};
+    // defaultValues의 타입을 추론하여 schema 생성
+    for (const [fieldName, defaultValue] of Object.entries(defaultValues)) {
+        if (typeof defaultValue === 'string') {
+            if (defaultValue === '') {
+                schema[fieldName] = { type: 'text' };
+            }
+            else if (defaultValue.includes('@')) {
+                schema[fieldName] = { type: 'email' };
+            }
+            else {
+                schema[fieldName] = { type: 'text', default: defaultValue };
+            }
+        }
+        else if (typeof defaultValue === 'number') {
+            schema[fieldName] = { type: 'number', default: defaultValue };
+        }
+        else if (typeof defaultValue === 'boolean') {
+            schema[fieldName] = { type: 'boolean', default: defaultValue };
+        }
+        else {
+            schema[fieldName] = { type: 'text' };
+        }
+    }
+    return generateFormMockData(schema, count);
+}

package/dist/mock/generators.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Mock Data Generators
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
+ */
+/**
+ * 한국어 이름 생성
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
+ * @returns 한국어 이름
+ *
+ * @example
+ * generateKoreanName() // "김민수"
+ * generateKoreanName('female') // "이지은"
+ */
+export declare function generateKoreanName(gender?: 'male' | 'female' | 'random'): string;
+/**
+ * 영어 이름 생성
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
+ * @returns 영어 이름
+ *
+ * @example
+ * generateEnglishName() // "John Smith"
+ * generateEnglishName('female') // "Emily Johnson"
+ */
+export declare function generateEnglishName(gender?: 'male' | 'female' | 'random'): string;
+/**
+ * 이메일 생성
+ * @param name - 이름 (선택, 없으면 랜덤 생성)
+ * @param domain - 도메인 (기본값: 'example.com')
+ * @returns 이메일 주소
+ *
+ * @example
+ * generateEmail() // "user123@example.com"
+ * generateEmail('홍길동') // "honggildong@example.com"
+ */
+export declare function generateEmail(name?: string, domain?: string): string;
+/**
+ * 전화번호 생성 (한국 형식)
+ * @returns 전화번호 (010-1234-5678 형식)
+ *
+ * @example
+ * generatePhoneNumber() // "010-1234-5678"
+ */
+export declare function generatePhoneNumber(): string;
+/**
+ * 주소 생성 (한국 형식)
+ * @returns 한국 주소
+ *
+ * @example
+ * generateAddress() // "서울특별시 강남구 테헤란로 123"
+ */
+export declare function generateAddress(): string;
+/**
+ * 날짜 생성 (범위 내)
+ * @param startDate - 시작 날짜 (기본값: 1년 전)
+ * @param endDate - 종료 날짜 (기본값: 오늘)
+ * @returns 날짜 문자열 (YYYY-MM-DD)
+ *
+ * @example
+ * generateDate() // "2023-06-15"
+ * generateDate('2024-01-01', '2024-12-31') // "2024-08-20"
+ */
+export declare function generateDate(startDate?: string, endDate?: string): string;
+/**
+ * 숫자 생성 (범위 내)
+ * @param min - 최소값 (기본값: 0)
+ * @param max - 최대값 (기본값: 100)
+ * @returns 랜덤 숫자
+ *
+ * @example
+ * generateNumber() // 42
+ * generateNumber(1, 10) // 7
+ */
+export declare function generateNumber(min?: number, max?: number): number;
+/**
+ * 텍스트 생성 (한글)
+ * @param length - 길이 (기본값: 10)
+ * @returns 랜덤 한글 텍스트
+ *
+ * @example
+ * generateKoreanText() // "안녕하세요반갑습니다"
+ * generateKoreanText(5) // "테스트데이터"
+ */
+export declare function generateKoreanText(length?: number): string;
+/**
+ * 텍스트 생성 (영문)
+ * @param length - 길이 (기본값: 10)
+ * @returns 랜덤 영문 텍스트
+ *
+ * @example
+ * generateEnglishText() // "loremipsum"
+ * generateEnglishText(5) // "testd"
+ */
+export declare function generateEnglishText(length?: number): string;
+/**
+ * 불린 값 생성
+ * @returns 랜덤 boolean
+ *
+ * @example
+ * generateBoolean() // true
+ */
+export declare function generateBoolean(): boolean;
+/**
+ * 배열에서 랜덤 선택
+ * @param array - 선택할 배열
+ * @returns 랜덤으로 선택된 요소
+ *
+ * @example
+ * generateFromArray(['red', 'blue', 'green']) // "blue"
+ */
+export declare function generateFromArray<T>(array: T[]): T;
+//# sourceMappingURL=generators.d.ts.map

package/dist/mock/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/mock/generators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAM,GAAG,QAAQ,GAAG,QAAmB,GAAG,MAAM,CAY1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAM,GAAG,QAAQ,GAAG,QAAmB,GAAG,MAAM,CAY3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAqBnF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAU,EAAE,GAAG,GAAE,MAAY,GAAG,MAAM,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAO9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAO/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAElD"}