@blastlabs/utils 1.11.0

package/dist/components/dev/ZIndexDebugger.js

@@ -0,0 +1,184 @@
+import React, { useState, useEffect } from 'react';
+/**
+ * z-index 값을 시각화하는 개발용 컴포넌트
+ * 페이지의 모든 요소의 z-index를 하이라이트하고 목록으로 표시합니다.
+ *
+ * @example
+ * ```tsx
+ * // Vite 프로젝트
+ * import { ZIndexDebugger } from 'goodchuck-utils/components/dev';
+ *
+ * function App() {
+ *   return (
+ *     <div>
+ *       {import.meta.env.DEV && <ZIndexDebugger />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Create React App 프로젝트
+ * {process.env.NODE_ENV === 'development' && <ZIndexDebugger position="top-right" />}
+ * ```
+ */
+export default function ZIndexDebugger({ position = 'bottom-left' }) {
+    const [isActive, setIsActive] = useState(false);
+    const [elements, setElements] = useState([]);
+    const [hoveredElement, setHoveredElement] = useState(null);
+    useEffect(() => {
+        if (!isActive) {
+            setElements([]);
+            setHoveredElement(null);
+            return;
+        }
+        const scanElements = () => {
+            const allElements = document.querySelectorAll('*');
+            const elementsWithZIndex = [];
+            allElements.forEach((el) => {
+                if (!(el instanceof HTMLElement))
+                    return;
+                const computedStyle = window.getComputedStyle(el);
+                const zIndex = computedStyle.zIndex;
+                // z-index가 설정된 요소만 수집 (auto가 아닌 경우)
+                if (zIndex !== 'auto' && zIndex !== '0') {
+                    elementsWithZIndex.push({
+                        element: el,
+                        zIndex,
+                        tagName: el.tagName.toLowerCase(),
+                        id: el.id || undefined,
+                        className: el.className || undefined,
+                    });
+                }
+            });
+            // z-index 값으로 정렬 (높은 순)
+            elementsWithZIndex.sort((a, b) => {
+                const zA = parseInt(a.zIndex) || 0;
+                const zB = parseInt(b.zIndex) || 0;
+                return zB - zA;
+            });
+            setElements(elementsWithZIndex);
+        };
+        scanElements();
+        // DOM 변경 감지
+        const observer = new MutationObserver(scanElements);
+        observer.observe(document.body, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: ['style', 'class'],
+        });
+        return () => observer.disconnect();
+    }, [isActive]);
+    // 호버된 요소 하이라이트
+    useEffect(() => {
+        if (!hoveredElement)
+            return;
+        const originalOutline = hoveredElement.style.outline;
+        const originalOutlineOffset = hoveredElement.style.outlineOffset;
+        hoveredElement.style.outline = '3px solid #f59e0b';
+        hoveredElement.style.outlineOffset = '2px';
+        return () => {
+            hoveredElement.style.outline = originalOutline;
+            hoveredElement.style.outlineOffset = originalOutlineOffset;
+        };
+    }, [hoveredElement]);
+    const positionStyles = {
+        'top-left': { top: 16, left: 16 },
+        'top-right': { top: 16, right: 16 },
+        'bottom-left': { bottom: 16, left: 16 },
+        'bottom-right': { bottom: 16, right: 16 },
+    };
+    const containerStyle = {
+        position: 'fixed',
+        ...positionStyles[position],
+        zIndex: 999999,
+        fontFamily: 'system-ui, -apple-system, sans-serif',
+    };
+    const buttonStyle = {
+        padding: '8px 16px',
+        backgroundColor: isActive ? '#ef4444' : '#3b82f6',
+        color: 'white',
+        border: 'none',
+        borderRadius: '8px',
+        cursor: 'pointer',
+        fontSize: '13px',
+        fontWeight: 600,
+        boxShadow: '0 4px 6px rgba(0, 0, 0, 0.1)',
+        transition: 'background-color 0.2s',
+    };
+    const panelStyle = {
+        marginTop: '8px',
+        backgroundColor: 'white',
+        borderRadius: '12px',
+        boxShadow: '0 10px 25px rgba(0, 0, 0, 0.15)',
+        border: '1px solid #e5e7eb',
+        width: '320px',
+        maxHeight: '400px',
+        overflow: 'hidden',
+        display: 'flex',
+        flexDirection: 'column',
+    };
+    const headerStyle = {
+        padding: '12px 16px',
+        borderBottom: '1px solid #e5e7eb',
+        fontWeight: 'bold',
+        fontSize: '14px',
+        color: '#111827',
+        backgroundColor: '#f9fafb',
+    };
+    const listContainerStyle = {
+        overflowY: 'auto',
+        maxHeight: '350px',
+    };
+    const itemStyle = (isHovered) => ({
+        padding: '10px 16px',
+        borderBottom: '1px solid #f3f4f6',
+        cursor: 'pointer',
+        backgroundColor: isHovered ? '#fef3c7' : 'white',
+        transition: 'background-color 0.15s',
+    });
+    const zIndexBadgeStyle = {
+        display: 'inline-block',
+        padding: '2px 8px',
+        backgroundColor: '#dbeafe',
+        color: '#1e40af',
+        borderRadius: '6px',
+        fontSize: '12px',
+        fontWeight: 'bold',
+        fontFamily: 'monospace',
+        marginRight: '8px',
+    };
+    const tagStyle = {
+        fontSize: '12px',
+        color: '#6b7280',
+        fontFamily: 'monospace',
+    };
+    const getElementLabel = (info) => {
+        let label = info.tagName;
+        if (info.id)
+            label += `#${info.id}`;
+        if (info.className && typeof info.className === 'string') {
+            const classes = info.className.split(' ').filter(Boolean).slice(0, 2);
+            if (classes.length > 0) {
+                label += `.${classes.join('.')}`;
+            }
+        }
+        return label.length > 40 ? label.slice(0, 40) + '...' : label;
+    };
+    const handleElementClick = (element) => {
+        element.scrollIntoView({ behavior: 'smooth', block: 'center' });
+    };
+    return (React.createElement("div", { style: containerStyle },
+        React.createElement("button", { onClick: () => setIsActive(!isActive), style: buttonStyle, onMouseEnter: (e) => (e.currentTarget.style.backgroundColor = isActive ? '#dc2626' : '#2563eb'), onMouseLeave: (e) => (e.currentTarget.style.backgroundColor = isActive ? '#ef4444' : '#3b82f6') }, isActive ? '🔴 Z-Index 디버거 종료' : '🔍 Z-Index 디버거'),
+        isActive && (React.createElement("div", { style: panelStyle },
+            React.createElement("div", { style: headerStyle },
+                "\uD83D\uDCCA Z-Index \uBAA9\uB85D (",
+                elements.length,
+                "\uAC1C)"),
+            React.createElement("div", { style: listContainerStyle }, elements.length === 0 ? (React.createElement("div", { style: { padding: '20px', textAlign: 'center', color: '#9ca3af', fontSize: '13px' } }, "z-index\uAC00 \uC124\uC815\uB41C \uC694\uC18C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.")) : (elements.map((info, index) => (React.createElement("div", { key: index, style: itemStyle(hoveredElement === info.element), onMouseEnter: () => setHoveredElement(info.element), onMouseLeave: () => setHoveredElement(null), onClick: () => handleElementClick(info.element) },
+                React.createElement("div", null,
+                    React.createElement("span", { style: zIndexBadgeStyle }, info.zIndex),
+                    React.createElement("span", { style: tagStyle }, getElementLabel(info))))))))))));
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Development Components
+ *
+ * 개발 환경에서 사용하는 유틸리티 컴포넌트들입니다.
+ * production 환경에서는 제외하는 것을 권장합니다.
+ */
+export { default as IdSelector } from './IdSelector';
+export { default as WindowSizeDisplay } from './WindowSizeDisplay';
+export { default as DevPanel } from './DevPanel';
+export { default as ZIndexDebugger } from './ZIndexDebugger';
+export { default as ApiLogger, addApiLog, clearApiLogs } from './ApiLogger';
+export { default as FormDevTools } from './FormDevTools';
+export type { FormDevToolsProps, UseFormReturn as FormDevToolsUseFormReturn } from './FormDevTools';
+export type { ApiLogEntry } from './ApiLogger';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/dev/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,aAAa,IAAI,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACpG,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/components/dev/index.js

@@ -0,0 +1,12 @@
+/**
+ * Development Components
+ *
+ * 개발 환경에서 사용하는 유틸리티 컴포넌트들입니다.
+ * production 환경에서는 제외하는 것을 권장합니다.
+ */
+export { default as IdSelector } from './IdSelector';
+export { default as WindowSizeDisplay } from './WindowSizeDisplay';
+export { default as DevPanel } from './DevPanel';
+export { default as ZIndexDebugger } from './ZIndexDebugger';
+export { default as ApiLogger, addApiLog, clearApiLogs } from './ApiLogger';
+export { default as FormDevTools } from './FormDevTools';

package/dist/components/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * React Components
+ *
+ * Note: Requires React and React DOM as peer dependencies.
+ * Note: Uses Tailwind CSS classes - ensure Tailwind is configured in your project.
+ */
+export * from './dev';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,OAAO,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,7 @@
+/**
+ * React Components
+ *
+ * Note: Requires React and React DOM as peer dependencies.
+ * Note: Uses Tailwind CSS classes - ensure Tailwind is configured in your project.
+ */
+export * from './dev';

package/dist/date/index.d.ts

@@ -0,0 +1,64 @@
+import dayjs from 'dayjs';
+import 'dayjs/locale/ko';
+/**
+ * 날짜를 지정된 포맷으로 변환
+ * @param date - 변환할 날짜 (Date, string, number)
+ * @param format - 포맷 문자열 (기본값: 'YYYY-MM-DD HH:mm:ss')
+ */
+export declare function formatDate(date?: Date | string | number, format?: string): string;
+/**
+ * 현재 날짜/시간 반환
+ * @param format - 포맷 문자열 (선택)
+ */
+export declare function now(format?: string): string | Date;
+/**
+ * 상대 시간 반환 (예: "3시간 전")
+ * @param date - 기준 날짜
+ * @param locale - 로케일 (기본값: 'ko')
+ */
+export declare function fromNow(date: Date | string | number, locale?: string): string;
+/**
+ * 두 날짜 사이의 차이 계산
+ * @param date1 - 첫 번째 날짜
+ * @param date2 - 두 번째 날짜
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function diffDate(date1: Date | string | number, date2: Date | string | number, unit?: dayjs.OpUnitType): number;
+/**
+ * 날짜에 시간 더하기
+ * @param date - 기준 날짜
+ * @param value - 더할 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function addDate(date: Date | string | number, value: number, unit?: dayjs.ManipulateType): Date;
+/**
+ * 날짜에 시간 빼기
+ * @param date - 기준 날짜
+ * @param value - 뺄 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function subtractDate(date: Date | string | number, value: number, unit?: dayjs.ManipulateType): Date;
+/**
+ * 날짜가 특정 날짜보다 이전인지 확인
+ */
+export declare function isBefore(date1: Date | string | number, date2: Date | string | number): boolean;
+/**
+ * 날짜가 특정 날짜보다 이후인지 확인
+ */
+export declare function isAfter(date1: Date | string | number, date2: Date | string | number): boolean;
+/**
+ * 두 날짜가 같은지 확인
+ * @param unit - 비교 단위 (기본값: 'millisecond')
+ */
+export declare function isSame(date1: Date | string | number, date2: Date | string | number, unit?: dayjs.OpUnitType): boolean;
+/**
+ * 날짜가 유효한지 확인
+ */
+export declare function isValidDate(date: any): boolean;
+/**
+ * 타임존 변환
+ * @param date - 변환할 날짜
+ * @param tz - 타임존 (예: 'Asia/Seoul')
+ */
+export declare function toTimezone(date: Date | string | number, tz: string): Date;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,iBAAiB,CAAC;AAMzB;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,EACzC,MAAM,GAAE,MAA8B,GACrC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,IAAI,GAAE,KAAK,CAAC,UAAkB,GAC7B,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,CAAC,cAAsB,GACjC,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,CAAC,cAAsB,GACjC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAE9F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAE7F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,IAAI,GAAE,KAAK,CAAC,UAA0B,GACrC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzE"}

package/dist/date/index.js

@@ -0,0 +1,92 @@
+import dayjs from 'dayjs';
+import utc from 'dayjs/plugin/utc';
+import timezone from 'dayjs/plugin/timezone';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import 'dayjs/locale/ko';
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(relativeTime);
+/**
+ * 날짜를 지정된 포맷으로 변환
+ * @param date - 변환할 날짜 (Date, string, number)
+ * @param format - 포맷 문자열 (기본값: 'YYYY-MM-DD HH:mm:ss')
+ */
+export function formatDate(date = new Date(), format = 'YYYY-MM-DD HH:mm:ss') {
+    return dayjs(date).format(format);
+}
+/**
+ * 현재 날짜/시간 반환
+ * @param format - 포맷 문자열 (선택)
+ */
+export function now(format) {
+    const current = dayjs();
+    return format ? current.format(format) : current.toDate();
+}
+/**
+ * 상대 시간 반환 (예: "3시간 전")
+ * @param date - 기준 날짜
+ * @param locale - 로케일 (기본값: 'ko')
+ */
+export function fromNow(date, locale = 'ko') {
+    return dayjs(date).locale(locale).fromNow();
+}
+/**
+ * 두 날짜 사이의 차이 계산
+ * @param date1 - 첫 번째 날짜
+ * @param date2 - 두 번째 날짜
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function diffDate(date1, date2, unit = 'day') {
+    return dayjs(date1).diff(dayjs(date2), unit);
+}
+/**
+ * 날짜에 시간 더하기
+ * @param date - 기준 날짜
+ * @param value - 더할 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function addDate(date, value, unit = 'day') {
+    return dayjs(date).add(value, unit).toDate();
+}
+/**
+ * 날짜에 시간 빼기
+ * @param date - 기준 날짜
+ * @param value - 뺄 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function subtractDate(date, value, unit = 'day') {
+    return dayjs(date).subtract(value, unit).toDate();
+}
+/**
+ * 날짜가 특정 날짜보다 이전인지 확인
+ */
+export function isBefore(date1, date2) {
+    return dayjs(date1).isBefore(dayjs(date2));
+}
+/**
+ * 날짜가 특정 날짜보다 이후인지 확인
+ */
+export function isAfter(date1, date2) {
+    return dayjs(date1).isAfter(dayjs(date2));
+}
+/**
+ * 두 날짜가 같은지 확인
+ * @param unit - 비교 단위 (기본값: 'millisecond')
+ */
+export function isSame(date1, date2, unit = 'millisecond') {
+    return dayjs(date1).isSame(dayjs(date2), unit);
+}
+/**
+ * 날짜가 유효한지 확인
+ */
+export function isValidDate(date) {
+    return dayjs(date).isValid();
+}
+/**
+ * 타임존 변환
+ * @param date - 변환할 날짜
+ * @param tz - 타임존 (예: 'Asia/Seoul')
+ */
+export function toTimezone(date, tz) {
+    return dayjs(date).tz(tz).toDate();
+}

package/dist/date/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/date/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/date/index.test.ts"],"names":[],"mappings":""}

package/dist/date/index.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect } from 'vitest';
+import { formatDate, now, fromNow, diffDate, addDate, subtractDate, isBefore, isAfter, isSame, isValidDate, toTimezone, } from './index';
+describe('Date Utils', () => {
+    describe('formatDate', () => {
+        it('should format date with default format', () => {
+            const date = new Date('2024-01-15 10:30:45');
+            const result = formatDate(date);
+            expect(result).toBe('2024-01-15 10:30:45');
+        });
+        it('should format date with custom format', () => {
+            const date = new Date('2024-01-15');
+            const result = formatDate(date, 'YYYY년 MM월 DD일');
+            expect(result).toBe('2024년 01월 15일');
+        });
+        it('should format string date', () => {
+            const result = formatDate('2024-01-15', 'YYYY-MM-DD');
+            expect(result).toBe('2024-01-15');
+        });
+        it('should format timestamp', () => {
+            const timestamp = new Date('2024-01-15').getTime();
+            const result = formatDate(timestamp, 'YYYY-MM-DD');
+            expect(result).toBe('2024-01-15');
+        });
+    });
+    describe('now', () => {
+        it('should return formatted current date when format is provided', () => {
+            const result = now('YYYY-MM-DD');
+            expect(result).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        });
+        it('should return Date object when no format is provided', () => {
+            const result = now();
+            expect(result).toBeInstanceOf(Date);
+        });
+    });
+    describe('fromNow', () => {
+        it('should return relative time in Korean', () => {
+            const yesterday = new Date();
+            yesterday.setDate(yesterday.getDate() - 1);
+            const result = fromNow(yesterday, 'ko');
+            expect(result).toContain('전');
+        });
+        it('should return relative time in English', () => {
+            const yesterday = new Date();
+            yesterday.setDate(yesterday.getDate() - 1);
+            const result = fromNow(yesterday, 'en');
+            expect(result).toContain('ago');
+        });
+    });
+    describe('diffDate', () => {
+        it('should calculate difference in days', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            const result = diffDate(date1, date2, 'day');
+            expect(result).toBe(5);
+        });
+        it('should calculate difference in hours', () => {
+            const date1 = new Date('2024-01-15 15:00:00');
+            const date2 = new Date('2024-01-15 12:00:00');
+            const result = diffDate(date1, date2, 'hour');
+            expect(result).toBe(3);
+        });
+        it('should handle negative differences', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            const result = diffDate(date1, date2, 'day');
+            expect(result).toBe(-5);
+        });
+    });
+    describe('addDate', () => {
+        it('should add days to date', () => {
+            const date = new Date('2024-01-15');
+            const result = addDate(date, 5, 'day');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-20');
+        });
+        it('should add hours to date', () => {
+            const date = new Date('2024-01-15 10:00:00');
+            const result = addDate(date, 3, 'hour');
+            expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 13:00:00');
+        });
+        it('should add months to date', () => {
+            const date = new Date('2024-01-15');
+            const result = addDate(date, 2, 'month');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-03-15');
+        });
+    });
+    describe('subtractDate', () => {
+        it('should subtract days from date', () => {
+            const date = new Date('2024-01-20');
+            const result = subtractDate(date, 5, 'day');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-15');
+        });
+        it('should subtract hours from date', () => {
+            const date = new Date('2024-01-15 13:00:00');
+            const result = subtractDate(date, 3, 'hour');
+            expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 10:00:00');
+        });
+    });
+    describe('isBefore', () => {
+        it('should return true if first date is before second', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            expect(isBefore(date1, date2)).toBe(true);
+        });
+        it('should return false if first date is after second', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            expect(isBefore(date1, date2)).toBe(false);
+        });
+    });
+    describe('isAfter', () => {
+        it('should return true if first date is after second', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            expect(isAfter(date1, date2)).toBe(true);
+        });
+        it('should return false if first date is before second', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            expect(isAfter(date1, date2)).toBe(false);
+        });
+    });
+    describe('isSame', () => {
+        it('should return true for exact same dates', () => {
+            const date1 = new Date('2024-01-15 10:30:45');
+            const date2 = new Date('2024-01-15 10:30:45');
+            expect(isSame(date1, date2)).toBe(true);
+        });
+        it('should return true for same day (ignoring time)', () => {
+            const date1 = new Date('2024-01-15 10:00:00');
+            const date2 = new Date('2024-01-15 15:00:00');
+            expect(isSame(date1, date2, 'day')).toBe(true);
+        });
+        it('should return false for different days', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-16');
+            expect(isSame(date1, date2, 'day')).toBe(false);
+        });
+    });
+    describe('isValidDate', () => {
+        it('should return true for valid dates', () => {
+            expect(isValidDate(new Date('2024-01-15'))).toBe(true);
+            expect(isValidDate('2024-01-15')).toBe(true);
+            expect(isValidDate(1705276800000)).toBe(true);
+        });
+        it('should return false for invalid dates', () => {
+            expect(isValidDate('invalid-date')).toBe(false);
+            expect(isValidDate(NaN)).toBe(false);
+            expect(isValidDate(null)).toBe(false);
+        });
+    });
+    describe('toTimezone', () => {
+        it('should convert to specific timezone', () => {
+            const date = new Date('2024-01-15T00:00:00Z');
+            const result = toTimezone(date, 'Asia/Seoul');
+            expect(result).toBeInstanceOf(Date);
+        });
+        it('should handle different timezones', () => {
+            const date = new Date('2024-01-15T12:00:00Z');
+            const nyTime = toTimezone(date, 'America/New_York');
+            const seoulTime = toTimezone(date, 'Asia/Seoul');
+            expect(nyTime).toBeInstanceOf(Date);
+            expect(seoulTime).toBeInstanceOf(Date);
+            expect(nyTime.getTime()).toBe(seoulTime.getTime());
+        });
+    });
+});

package/dist/form/__tests__/formatter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formatter.test.d.ts.map

package/dist/form/__tests__/formatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.test.d.ts","sourceRoot":"","sources":["../../../src/form/__tests__/formatter.test.ts"],"names":[],"mappings":""}

package/dist/form/__tests__/formatter.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { formatPhoneNumber, formatBusinessNumber, formatCreditCard, extractNumbers, formatCurrency, maskResidentNumber, maskCreditCard, } from '../formatter';
+describe('Form Formatters', () => {
+    describe('formatPhoneNumber', () => {
+        it('should format phone numbers correctly', () => {
+            expect(formatPhoneNumber('01012345678')).toBe('010-1234-5678');
+            expect(formatPhoneNumber('0212345678')).toBe('021-2345-678');
+            expect(formatPhoneNumber('010')).toBe('010');
+            expect(formatPhoneNumber('0101234')).toBe('010-1234');
+        });
+        it('should handle already formatted numbers', () => {
+            expect(formatPhoneNumber('010-1234-5678')).toBe('010-1234-5678');
+        });
+        it('should limit to 11 digits', () => {
+            expect(formatPhoneNumber('010123456789999')).toBe('010-1234-5678');
+        });
+    });
+    describe('formatBusinessNumber', () => {
+        it('should format business numbers correctly', () => {
+            expect(formatBusinessNumber('1234567890')).toBe('123-45-67890');
+            expect(formatBusinessNumber('123')).toBe('123');
+            expect(formatBusinessNumber('12345')).toBe('123-45');
+        });
+        it('should limit to 10 digits', () => {
+            expect(formatBusinessNumber('12345678901234')).toBe('123-45-67890');
+        });
+    });
+    describe('formatCreditCard', () => {
+        it('should format credit card numbers', () => {
+            expect(formatCreditCard('1234567890123456')).toBe('1234-5678-9012-3456');
+            expect(formatCreditCard('1234')).toBe('1234');
+        });
+    });
+    describe('extractNumbers', () => {
+        it('should extract only numbers', () => {
+            expect(extractNumbers('abc123def456')).toBe('123456');
+            expect(extractNumbers('010-1234-5678')).toBe('01012345678');
+            expect(extractNumbers('no numbers')).toBe('');
+        });
+    });
+    describe('formatCurrency', () => {
+        it('should format numbers with commas', () => {
+            expect(formatCurrency(1234567)).toBe('1,234,567원');
+            expect(formatCurrency(1000)).toBe('1,000원');
+            expect(formatCurrency(0)).toBe('0원');
+        });
+        it('should handle string input', () => {
+            expect(formatCurrency('1234567')).toBe('1,234,567원');
+        });
+        it('should allow custom currency', () => {
+            expect(formatCurrency(1000, '달러')).toBe('1,000달러');
+        });
+        it('should handle invalid input', () => {
+            expect(formatCurrency('invalid')).toBe('0원');
+        });
+    });
+    describe('maskResidentNumber', () => {
+        it('should mask resident registration number', () => {
+            expect(maskResidentNumber('1234561234567')).toBe('123456-*******');
+            expect(maskResidentNumber('123456-1234567')).toBe('123456-*******');
+        });
+        it('should handle partial input', () => {
+            expect(maskResidentNumber('12345')).toBe('12345');
+        });
+    });
+    describe('maskCreditCard', () => {
+        it('should mask credit card number', () => {
+            expect(maskCreditCard('1234567890123456')).toBe('1234-****-****-3456');
+        });
+        it('should handle partial input', () => {
+            expect(maskCreditCard('1234567')).toBe('1234567');
+        });
+    });
+});

package/dist/form/__tests__/helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=helpers.test.d.ts.map

package/dist/form/__tests__/helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.d.ts","sourceRoot":"","sources":["../../../src/form/__tests__/helpers.test.ts"],"names":[],"mappings":""}