goodchuck-utils 1.8.0 → 1.9.0

package/dist/components/dev/FormDevTools/FormDevTools.d.ts

@@ -17,6 +17,24 @@ export type Props = {
     originalValues?: Record<string, any>;
     /** Validation 스키마 정보 (zod, yup 등) - refine 조건 표시에 사용 */
     validationSchema?: Record<string, any>;
+    /** react-hook-form의 reset 함수 (mock 데이터 생성 후 폼에 채우기 위해 필요) */
+    reset?: (values: Record<string, any>, options?: {
+        keepDirty?: boolean;
+        keepTouched?: boolean;
+    }) => void;
+    /** react-hook-form의 setValue 함수 (dirty 상태를 true로 만들기 위해 필요, 선택사항) */
+    setValue?: (name: string, value: any, options?: {
+        shouldDirty?: boolean;
+        shouldValidate?: boolean;
+    }) => void;
+    /** react-hook-form의 trigger 함수 (validation 실행을 위해 필요, 선택사항) */
+    trigger?: (name?: string | string[]) => Promise<boolean>;
+    /** Mock 데이터 생성 함수 (비동기 가능) */
+    generateMock?: (params: {
+        values?: Record<string, any>;
+        originalValues?: Record<string, any>;
+        validationSchema?: Record<string, any>;
+    }) => Promise<Record<string, any>> | Record<string, any>;
     /** 표시 위치 (기본값: 'bottom-left') */
     position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
     /** 패널 제목 (기본값: 'Form DevTools') */
@@ -57,6 +75,26 @@ export type Props = {
  *           formState={formState}
  *           values={values}
  *           originalValues={defaultValues}
+ *           reset={reset} // mock 데이터 생성 후 폼에 채우기 위해 필요
+ *           generateMock={async ({ values, validationSchema }) => {
+ *             // AI를 사용한 mock 데이터 생성 (예시)
+ *             const response = await fetch('https://api.openai.com/v1/chat/completions', {
+ *               method: 'POST',
+ *               headers: {
+ *                 'Content-Type': 'application/json',
+ *                 'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
+ *               },
+ *               body: JSON.stringify({
+ *                 model: 'gpt-3.5-turbo',
+ *                 messages: [{
+ *                   role: 'user',
+ *                   content: `다음 폼 필드에 맞는 mock 데이터를 생성해주세요: ${JSON.stringify(values)}`
+ *                 }],
+ *               }),
+ *             });
+ *             const data = await response.json();
+ *             return JSON.parse(data.choices[0].message.content);
+ *           }}
  *         />
  *       )}
  *     </form>
@@ -97,5 +135,5 @@ export type Props = {
  * }
  * ```
  */
-export default function FormDevTools({ formState, values, originalValues, validationSchema, position, title }: Props): React.JSX.Element;
+export default function FormDevTools({ formState, values, originalValues, validationSchema, reset, setValue, trigger, generateMock, position, title }: Props): React.JSX.Element;
 //# sourceMappingURL=FormDevTools.d.ts.map

package/dist/components/dev/FormDevTools/FormDevTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormDevTools.d.ts","sourceRoot":"","sources":["../../../../src/components/dev/FormDevTools/FormDevTools.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AA0B3D,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,iCAAiC;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACrE,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAwB,EAAE,KAAuB,EAAE,EAAE,KAAK,qBAyarJ"}
+{"version":3,"file":"FormDevTools.d.ts","sourceRoot":"","sources":["../../../../src/components/dev/FormDevTools/FormDevTools.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AA0B3D,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,iCAAiC;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxG,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7G,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACxC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzD,iCAAiC;IACjC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACrE,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,QAAwB,EAAE,KAAuB,EAAE,EAAE,KAAK,qBAggB7L"}

package/dist/components/dev/FormDevTools/FormDevTools.js

@@ -36,6 +36,26 @@ import { getContainerStyle, getToggleButtonStyle, getPanelStyle, headerStyle, he
  *           formState={formState}
  *           values={values}
  *           originalValues={defaultValues}
+ *           reset={reset} // mock 데이터 생성 후 폼에 채우기 위해 필요
+ *           generateMock={async ({ values, validationSchema }) => {
+ *             // AI를 사용한 mock 데이터 생성 (예시)
+ *             const response = await fetch('https://api.openai.com/v1/chat/completions', {
+ *               method: 'POST',
+ *               headers: {
+ *                 'Content-Type': 'application/json',
+ *                 'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
+ *               },
+ *               body: JSON.stringify({
+ *                 model: 'gpt-3.5-turbo',
+ *                 messages: [{
+ *                   role: 'user',
+ *                   content: `다음 폼 필드에 맞는 mock 데이터를 생성해주세요: ${JSON.stringify(values)}`
+ *                 }],
+ *               }),
+ *             });
+ *             const data = await response.json();
+ *             return JSON.parse(data.choices[0].message.content);
+ *           }}
  *         />
  *       )}
  *     </form>
@@ -76,7 +96,7 @@ import { getContainerStyle, getToggleButtonStyle, getPanelStyle, headerStyle, he
  * }
  * ```
  */
-export default function FormDevTools({ formState, values, originalValues, validationSchema, position = 'bottom-left', title = 'Form DevTools' }) {
+export default function FormDevTools({ formState, values, originalValues, validationSchema, reset, setValue, trigger, generateMock, position = 'bottom-left', title = 'Form DevTools' }) {
     const [isOpen, setIsOpen] = useState(false);
     const [activeTab, setActiveTab] = useState('all');
     const [panelPosition, setPanelPosition] = useState({ x: 0, y: 0 });
@@ -85,6 +105,8 @@ export default function FormDevTools({ formState, values, originalValues, valida
     const [isResizing, setIsResizing] = useState(false);
     const [dragStart, setDragStart] = useState({ x: 0, y: 0 });
     const [resizeStart, setResizeStart] = useState({ x: 0, y: 0, width: 0, height: 0 });
+    const [isGenerating, setIsGenerating] = useState(false);
+    const [generateError, setGenerateError] = useState(null);
     const panelRef = useRef(null);
     const { copy, copiedText } = useCopyToClipboard();
     const handleCopy = () => {
@@ -205,6 +227,52 @@ export default function FormDevTools({ formState, values, originalValues, valida
             React.createElement("div", { style: errorLabelStyle }, field),
             React.createElement("div", { style: errorMessageStyle }, error?.message || 'Invalid value'))));
     };
+    // Mock 데이터 생성 핸들러
+    const handleGenerateMock = async () => {
+        if (!reset) {
+            setGenerateError('reset 함수가 필요합니다');
+            return;
+        }
+        if (!generateMock) {
+            setGenerateError('generateMock 함수가 필요합니다');
+            return;
+        }
+        setIsGenerating(true);
+        setGenerateError(null);
+        try {
+            // 사용자가 제공한 generateMock 함수 사용
+            const mockData = await generateMock({
+                values,
+                originalValues,
+                validationSchema,
+            });
+            // reset으로 값 설정
+            // keepDirty: false는 reset 후 dirty를 초기화하는데, 
+            // 이후 setValue로 shouldDirty: true를 설정하면 dirty가 true가 됨
+            reset(mockData, { keepDirty: false, keepTouched: false });
+            // dirty와 validate를 true로 만들기 위해 setValue 사용
+            // reset 후에 setValue를 호출하면 dirty 상태가 true가 됨
+            if (setValue) {
+                // 모든 필드를 dirty로 만들고 validation 실행
+                Object.keys(mockData).forEach((key) => {
+                    setValue(key, mockData[key], {
+                        shouldDirty: true, // dirty를 true로 설정
+                        shouldValidate: true, // validation 실행
+                    });
+                });
+            }
+            // 전체 validation 실행
+            if (trigger) {
+                await trigger();
+            }
+        }
+        catch (error) {
+            setGenerateError(error.message || 'Mock 데이터 생성 실패');
+        }
+        finally {
+            setIsGenerating(false);
+        }
+    };
     return (React.createElement("div", { style: getContainerStyle(position) },
         React.createElement("button", { onClick: () => setIsOpen(!isOpen), style: getToggleButtonStyle(formState.isValid), onMouseEnter: (e) => (e.currentTarget.style.backgroundColor = formState.isValid === false ? '#dc2626' : '#7c3aed'), onMouseLeave: (e) => (e.currentTarget.style.backgroundColor = formState.isValid === false ? '#ef4444' : '#8b5cf6') }, isOpen ? '✕' : '📝'),
         isOpen && (React.createElement("div", { ref: panelRef, style: getPanelStyle(position, panelPosition, panelSize, isDragging) },
@@ -214,13 +282,33 @@ export default function FormDevTools({ formState, values, originalValues, valida
                         "\uD83D\uDCDD ",
                         title),
                     React.createElement("div", { style: getStatusBadgeStyle(formState.isValid) }, formState.isValid ? '✓ Valid' : `✗ ${errorCount} Error${errorCount > 1 ? 's' : ''}`)),
-                React.createElement("button", { onClick: handleCopy, style: getCopyButtonStyle(isCopied), onMouseEnter: (e) => {
-                        if (!isCopied)
-                            e.currentTarget.style.backgroundColor = '#2563eb';
-                    }, onMouseLeave: (e) => {
-                        if (!isCopied)
-                            e.currentTarget.style.backgroundColor = '#3b82f6';
-                    } }, isCopied ? '✓ Copied' : 'Copy All')),
+                React.createElement("div", { style: { display: 'flex', gap: '8px', alignItems: 'center' } },
+                    reset && generateMock && (React.createElement("button", { onClick: handleGenerateMock, disabled: isGenerating, style: {
+                            ...getCopyButtonStyle(false),
+                            backgroundColor: isGenerating ? '#9ca3af' : '#10b981',
+                            opacity: isGenerating ? 0.6 : 1,
+                            cursor: isGenerating ? 'not-allowed' : 'pointer',
+                        }, onMouseEnter: (e) => {
+                            if (!isGenerating)
+                                e.currentTarget.style.backgroundColor = '#059669';
+                        }, onMouseLeave: (e) => {
+                            if (!isGenerating)
+                                e.currentTarget.style.backgroundColor = '#10b981';
+                        } }, isGenerating ? '⏳ Generating...' : '🤖 Generate Mock')),
+                    React.createElement("button", { onClick: handleCopy, style: getCopyButtonStyle(isCopied), onMouseEnter: (e) => {
+                            if (!isCopied)
+                                e.currentTarget.style.backgroundColor = '#2563eb';
+                        }, onMouseLeave: (e) => {
+                            if (!isCopied)
+                                e.currentTarget.style.backgroundColor = '#3b82f6';
+                        } }, isCopied ? '✓ Copied' : 'Copy All'))),
+            generateError && (React.createElement("div", { style: {
+                    padding: '8px 16px',
+                    backgroundColor: '#fef2f2',
+                    borderBottom: '1px solid #fecaca',
+                    fontSize: '12px',
+                    color: '#991b1b',
+                } }, generateError)),
             React.createElement("div", { style: tabContainerStyle },
                 React.createElement("button", { onClick: () => setActiveTab('all'), style: getTabStyle(activeTab === 'all'), onMouseEnter: (e) => {
                         if (activeTab !== 'all')

package/dist/index.d.ts

@@ -1,4 +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

@@ -1 +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"}
+{"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

@@ -4,6 +4,10 @@ export * from './date';
 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';

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"}

package/dist/mock/generators.js

@@ -0,0 +1,195 @@
+/**
+ * Mock Data Generators
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
+ */
+/**
+ * 한국어 이름 생성
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
+ * @returns 한국어 이름
+ *
+ * @example
+ * generateKoreanName() // "김민수"
+ * generateKoreanName('female') // "이지은"
+ */
+export function generateKoreanName(gender = 'random') {
+    const surnames = ['김', '이', '박', '최', '정', '강', '조', '윤', '장', '임', '한', '오', '서', '신', '권', '황', '안', '송', '전', '홍'];
+    const maleNames = ['민수', '준호', '성호', '지훈', '현우', '동현', '민준', '건우', '준영', '상우', '영수', '성민', '준혁', '태현', '승현'];
+    const femaleNames = ['지은', '수진', '미영', '혜진', '은지', '서연', '민지', '예은', '지원', '유진', '소영', '지현', '수빈', '하은', '서윤'];
+    const surname = surnames[Math.floor(Math.random() * surnames.length)];
+    const selectedGender = gender === 'random' ? (Math.random() > 0.5 ? 'male' : 'female') : gender;
+    const name = selectedGender === 'male'
+        ? maleNames[Math.floor(Math.random() * maleNames.length)]
+        : femaleNames[Math.floor(Math.random() * femaleNames.length)];
+    return `${surname}${name}`;
+}
+/**
+ * 영어 이름 생성
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
+ * @returns 영어 이름
+ *
+ * @example
+ * generateEnglishName() // "John Smith"
+ * generateEnglishName('female') // "Emily Johnson"
+ */
+export function generateEnglishName(gender = 'random') {
+    const maleFirstNames = ['James', 'John', 'Robert', 'Michael', 'William', 'David', 'Richard', 'Joseph', 'Thomas', 'Christopher'];
+    const femaleFirstNames = ['Mary', 'Patricia', 'Jennifer', 'Linda', 'Elizabeth', 'Barbara', 'Susan', 'Jessica', 'Sarah', 'Karen'];
+    const lastNames = ['Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller', 'Davis', 'Rodriguez', 'Martinez'];
+    const selectedGender = gender === 'random' ? (Math.random() > 0.5 ? 'male' : 'female') : gender;
+    const firstName = selectedGender === 'male'
+        ? maleFirstNames[Math.floor(Math.random() * maleFirstNames.length)]
+        : femaleFirstNames[Math.floor(Math.random() * femaleFirstNames.length)];
+    const lastName = lastNames[Math.floor(Math.random() * lastNames.length)];
+    return `${firstName} ${lastName}`;
+}
+/**
+ * 이메일 생성
+ * @param name - 이름 (선택, 없으면 랜덤 생성)
+ * @param domain - 도메인 (기본값: 'example.com')
+ * @returns 이메일 주소
+ *
+ * @example
+ * generateEmail() // "user123@example.com"
+ * generateEmail('홍길동') // "honggildong@example.com"
+ */
+export function generateEmail(name, domain = 'example.com') {
+    if (name) {
+        // 한글 이름을 영문으로 변환 (간단한 변환)
+        const nameMap = {
+            '김': 'kim', '이': 'lee', '박': 'park', '최': 'choi', '정': 'jung',
+            '강': 'kang', '조': 'cho', '윤': 'yoon', '장': 'jang', '임': 'lim'
+        };
+        let emailName = name.toLowerCase()
+            .replace(/[가-힣]/g, (char) => {
+            // 간단한 로마자 변환 (실제로는 더 복잡한 변환이 필요)
+            return nameMap[char] || 'user';
+        })
+            .replace(/[^a-z0-9]/g, '')
+            .substring(0, 20) || 'user';
+        if (emailName.length < 3)
+            emailName = 'user';
+        return `${emailName}${Math.floor(Math.random() * 1000)}@${domain}`;
+    }
+    const randomString = Math.random().toString(36).substring(2, 10);
+    return `${randomString}@${domain}`;
+}
+/**
+ * 전화번호 생성 (한국 형식)
+ * @returns 전화번호 (010-1234-5678 형식)
+ *
+ * @example
+ * generatePhoneNumber() // "010-1234-5678"
+ */
+export function generatePhoneNumber() {
+    const prefixes = ['010', '011', '016', '017', '018', '019'];
+    const prefix = prefixes[Math.floor(Math.random() * prefixes.length)];
+    const middle = Math.floor(Math.random() * 9000) + 1000;
+    const last = Math.floor(Math.random() * 9000) + 1000;
+    return `${prefix}-${middle}-${last}`;
+}
+/**
+ * 주소 생성 (한국 형식)
+ * @returns 한국 주소
+ *
+ * @example
+ * generateAddress() // "서울특별시 강남구 테헤란로 123"
+ */
+export function generateAddress() {
+    const cities = ['서울특별시', '부산광역시', '대구광역시', '인천광역시', '광주광역시', '대전광역시', '울산광역시'];
+    const districts = ['강남구', '강동구', '강북구', '강서구', '관악구', '광진구', '구로구', '금천구', '노원구', '도봉구'];
+    const streets = ['테헤란로', '강남대로', '서초대로', '올림픽대로', '반포대로', '한강대로', '을지로', '종로', '명동길', '이태원로'];
+    const city = cities[Math.floor(Math.random() * cities.length)];
+    const district = districts[Math.floor(Math.random() * districts.length)];
+    const street = streets[Math.floor(Math.random() * streets.length)];
+    const number = Math.floor(Math.random() * 999) + 1;
+    return `${city} ${district} ${street} ${number}`;
+}
+/**
+ * 날짜 생성 (범위 내)
+ * @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 function generateDate(startDate, endDate) {
+    const start = startDate ? new Date(startDate).getTime() : Date.now() - 365 * 24 * 60 * 60 * 1000;
+    const end = endDate ? new Date(endDate).getTime() : Date.now();
+    const randomTime = start + Math.random() * (end - start);
+    const date = new Date(randomTime);
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * 숫자 생성 (범위 내)
+ * @param min - 최소값 (기본값: 0)
+ * @param max - 최대값 (기본값: 100)
+ * @returns 랜덤 숫자
+ *
+ * @example
+ * generateNumber() // 42
+ * generateNumber(1, 10) // 7
+ */
+export function generateNumber(min = 0, max = 100) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/**
+ * 텍스트 생성 (한글)
+ * @param length - 길이 (기본값: 10)
+ * @returns 랜덤 한글 텍스트
+ *
+ * @example
+ * generateKoreanText() // "안녕하세요반갑습니다"
+ * generateKoreanText(5) // "테스트데이터"
+ */
+export function generateKoreanText(length = 10) {
+    const chars = '가나다라마바사아자차카타파하거너더러머버서어저처커터퍼허고노도로모보소오조초코토포호구누두루무부수우주추쿠투푸후그느드르므브스으즈츠크트프흐기니디리미비시이지치키티피히';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return result;
+}
+/**
+ * 텍스트 생성 (영문)
+ * @param length - 길이 (기본값: 10)
+ * @returns 랜덤 영문 텍스트
+ *
+ * @example
+ * generateEnglishText() // "loremipsum"
+ * generateEnglishText(5) // "testd"
+ */
+export function generateEnglishText(length = 10) {
+    const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return result;
+}
+/**
+ * 불린 값 생성
+ * @returns 랜덤 boolean
+ *
+ * @example
+ * generateBoolean() // true
+ */
+export function generateBoolean() {
+    return Math.random() > 0.5;
+}
+/**
+ * 배열에서 랜덤 선택
+ * @param array - 선택할 배열
+ * @returns 랜덤으로 선택된 요소
+ *
+ * @example
+ * generateFromArray(['red', 'blue', 'green']) // "blue"
+ */
+export function generateFromArray(array) {
+    return array[Math.floor(Math.random() * array.length)];
+}

package/dist/mock/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Mock Data Utilities
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
+ */
+export * from './generators';
+export * from './form';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mock/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC"}

package/dist/mock/index.js

@@ -0,0 +1,9 @@
+/**
+ * Mock Data Utilities
+ *
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
+ */
+// Generators
+export * from './generators';
+// Form mock data generators
+export * from './form';

package/dist/number/format.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Number Formatting Utilities
+ *
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
+ */
+/**
+ * 숫자를 천 단위 구분자로 포맷팅
+ * @param value - 포맷팅할 숫자
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @returns 포맷팅된 문자열
+ *
+ * @example
+ * formatNumber(1234567) // "1,234,567"
+ * formatNumber(1234.56, 2) // "1,234.56"
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
+ */
+export declare function formatNumber(value: number | string, decimals?: number, separator?: string): string;
+/**
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
+ * @param value - 포맷팅할 가격
+ * @param currency - 통화 기호 (기본값: '₩')
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @param position - 통화 기호 위치 (기본값: 'before')
+ * @returns 포맷팅된 가격 문자열
+ *
+ * @example
+ * formatPrice(1234567) // "₩1,234,567"
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
+ */
+export declare function formatPrice(value: number | string, currency?: string, decimals?: number, separator?: string, position?: 'before' | 'after'): string;
+/**
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
+ * @param value - 포맷팅할 금액
+ * @param locale - 로케일 (기본값: 'ko-KR')
+ * @param currency - 통화 코드 (기본값: 'KRW')
+ * @param style - 표시 스타일 (기본값: 'currency')
+ * @returns 포맷팅된 통화 문자열
+ *
+ * @example
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
+ */
+export declare function formatCurrencyIntl(value: number | string, locale?: string, currency?: string, style?: 'currency' | 'decimal'): string;
+/**
+ * 가격 문자열을 숫자로 변환
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
+ * @returns 변환된 숫자
+ *
+ * @example
+ * parsePrice("₩1,234,567") // 1234567
+ * parsePrice("1,234.56") // 1234.56
+ * parsePrice("$1,234.56") // 1234.56
+ */
+export declare function parsePrice(priceString: string): number;
+/**
+ * 할인율 계산
+ * @param originalPrice - 원래 가격
+ * @param discountedPrice - 할인된 가격
+ * @returns 할인율 (퍼센트)
+ *
+ * @example
+ * calculateDiscount(10000, 8000) // 20
+ * calculateDiscount(100, 75) // 25
+ */
+export declare function calculateDiscount(originalPrice: number, discountedPrice: number): number;
+/**
+ * 할인 가격 계산
+ * @param originalPrice - 원래 가격
+ * @param discountPercent - 할인율 (퍼센트)
+ * @returns 할인된 가격
+ *
+ * @example
+ * calculateDiscountedPrice(10000, 20) // 8000
+ * calculateDiscountedPrice(100, 25) // 75
+ */
+export declare function calculateDiscountedPrice(originalPrice: number, discountPercent: number): number;
+/**
+ * 세금 포함 가격 계산
+ * @param price - 세전 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세금 포함 가격
+ *
+ * @example
+ * calculatePriceWithTax(10000, 10) // 11000
+ * calculatePriceWithTax(100, 20) // 120
+ */
+export declare function calculatePriceWithTax(price: number, taxRate?: number): number;
+/**
+ * 세금 제외 가격 계산
+ * @param priceWithTax - 세금 포함 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세전 가격
+ *
+ * @example
+ * calculatePriceWithoutTax(11000, 10) // 10000
+ * calculatePriceWithoutTax(120, 20) // 100
+ */
+export declare function calculatePriceWithoutTax(priceWithTax: number, taxRate?: number): number;
+/**
+ * 백분율 포맷팅
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
+ * @param decimals - 소수점 자릿수 (기본값: 1)
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
+ * @returns 포맷팅된 퍼센트 문자열
+ *
+ * @example
+ * formatPercent(0.1234, 1, true) // "12.3%"
+ * formatPercent(12.34, 1, false) // "12.3%"
+ * formatPercent(50) // "50.0%"
+ */
+export declare function formatPercent(value: number, decimals?: number, isDecimal?: boolean): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/number/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/number/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAY,GACtB,MAAM,CAaR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAY,EACvB,QAAQ,GAAE,QAAQ,GAAG,OAAkB,GACtC,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,GAAE,MAAgB,EACxB,QAAQ,GAAE,MAAc,EACxB,KAAK,GAAE,UAAU,GAAG,SAAsB,GACzC,MAAM,CAaR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAG/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAGjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAG3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,OAAe,GACzB,MAAM,CAGR"}

package/dist/number/format.js

@@ -0,0 +1,165 @@
+/**
+ * Number Formatting Utilities
+ *
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
+ */
+/**
+ * 숫자를 천 단위 구분자로 포맷팅
+ * @param value - 포맷팅할 숫자
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @returns 포맷팅된 문자열
+ *
+ * @example
+ * formatNumber(1234567) // "1,234,567"
+ * formatNumber(1234.56, 2) // "1,234.56"
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
+ */
+export function formatNumber(value, decimals = 0, separator = ',') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num)) {
+        return '0';
+    }
+    const fixed = num.toFixed(decimals);
+    const parts = fixed.split('.');
+    const integerPart = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    const decimalPart = parts[1] ? `.${parts[1]}` : '';
+    return integerPart + decimalPart;
+}
+/**
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
+ * @param value - 포맷팅할 가격
+ * @param currency - 통화 기호 (기본값: '₩')
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @param position - 통화 기호 위치 (기본값: 'before')
+ * @returns 포맷팅된 가격 문자열
+ *
+ * @example
+ * formatPrice(1234567) // "₩1,234,567"
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
+ */
+export function formatPrice(value, currency = '₩', decimals = 0, separator = ',', position = 'before') {
+    const formatted = formatNumber(value, decimals, separator);
+    return position === 'before' ? `${currency}${formatted}` : `${formatted}${currency}`;
+}
+/**
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
+ * @param value - 포맷팅할 금액
+ * @param locale - 로케일 (기본값: 'ko-KR')
+ * @param currency - 통화 코드 (기본값: 'KRW')
+ * @param style - 표시 스타일 (기본값: 'currency')
+ * @returns 포맷팅된 통화 문자열
+ *
+ * @example
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
+ */
+export function formatCurrencyIntl(value, locale = 'ko-KR', currency = 'KRW', style = 'currency') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num)) {
+        return '0';
+    }
+    return new Intl.NumberFormat(locale, {
+        style,
+        currency,
+        minimumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
+        maximumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
+    }).format(num);
+}
+/**
+ * 가격 문자열을 숫자로 변환
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
+ * @returns 변환된 숫자
+ *
+ * @example
+ * parsePrice("₩1,234,567") // 1234567
+ * parsePrice("1,234.56") // 1234.56
+ * parsePrice("$1,234.56") // 1234.56
+ */
+export function parsePrice(priceString) {
+    if (!priceString || typeof priceString !== 'string') {
+        return 0;
+    }
+    // 통화 기호, 공백, 쉼표 제거
+    const cleaned = priceString.replace(/[₩$€£¥,\s]/g, '');
+    const parsed = parseFloat(cleaned);
+    return isNaN(parsed) ? 0 : parsed;
+}
+/**
+ * 할인율 계산
+ * @param originalPrice - 원래 가격
+ * @param discountedPrice - 할인된 가격
+ * @returns 할인율 (퍼센트)
+ *
+ * @example
+ * calculateDiscount(10000, 8000) // 20
+ * calculateDiscount(100, 75) // 25
+ */
+export function calculateDiscount(originalPrice, discountedPrice) {
+    if (originalPrice <= 0) {
+        return 0;
+    }
+    const discount = ((originalPrice - discountedPrice) / originalPrice) * 100;
+    return Math.round(discount * 100) / 100; // 소수점 2자리까지
+}
+/**
+ * 할인 가격 계산
+ * @param originalPrice - 원래 가격
+ * @param discountPercent - 할인율 (퍼센트)
+ * @returns 할인된 가격
+ *
+ * @example
+ * calculateDiscountedPrice(10000, 20) // 8000
+ * calculateDiscountedPrice(100, 25) // 75
+ */
+export function calculateDiscountedPrice(originalPrice, discountPercent) {
+    const discount = (originalPrice * discountPercent) / 100;
+    return Math.round((originalPrice - discount) * 100) / 100;
+}
+/**
+ * 세금 포함 가격 계산
+ * @param price - 세전 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세금 포함 가격
+ *
+ * @example
+ * calculatePriceWithTax(10000, 10) // 11000
+ * calculatePriceWithTax(100, 20) // 120
+ */
+export function calculatePriceWithTax(price, taxRate = 10) {
+    const tax = (price * taxRate) / 100;
+    return Math.round((price + tax) * 100) / 100;
+}
+/**
+ * 세금 제외 가격 계산
+ * @param priceWithTax - 세금 포함 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세전 가격
+ *
+ * @example
+ * calculatePriceWithoutTax(11000, 10) // 10000
+ * calculatePriceWithoutTax(120, 20) // 100
+ */
+export function calculatePriceWithoutTax(priceWithTax, taxRate = 10) {
+    const price = priceWithTax / (1 + taxRate / 100);
+    return Math.round(price * 100) / 100;
+}
+/**
+ * 백분율 포맷팅
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
+ * @param decimals - 소수점 자릿수 (기본값: 1)
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
+ * @returns 포맷팅된 퍼센트 문자열
+ *
+ * @example
+ * formatPercent(0.1234, 1, true) // "12.3%"
+ * formatPercent(12.34, 1, false) // "12.3%"
+ * formatPercent(50) // "50.0%"
+ */
+export function formatPercent(value, decimals = 1, isDecimal = false) {
+    const percent = isDecimal ? value * 100 : value;
+    return `${percent.toFixed(decimals)}%`;
+}

package/dist/number/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Number Utilities
+ *
+ * 숫자 및 가격 관련 유틸리티 함수들
+ */
+export * from './format';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC"}

package/dist/number/index.js

@@ -0,0 +1,7 @@
+/**
+ * Number Utilities
+ *
+ * 숫자 및 가격 관련 유틸리티 함수들
+ */
+// Formatting utilities
+export * from './format';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goodchuck-utils",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",