goodchuck-utils 1.1.0 → 1.3.0

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

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

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { hasFormErrors, getChangedFields, removeEmptyValues, } from '../helpers';
+describe('Form State Helpers', () => {
+    describe('hasFormErrors', () => {
+        it('should detect errors', () => {
+            expect(hasFormErrors({ email: 'error' })).toBe(true);
+            expect(hasFormErrors({})).toBe(false);
+        });
+    });
+    describe('getChangedFields', () => {
+        it('should return only changed fields', () => {
+            const original = { name: 'John', email: 'john@example.com', age: 30 };
+            const current = { name: 'Jane', email: 'john@example.com', age: 31 };
+            const changed = getChangedFields(original, current);
+            expect(changed).toEqual({ name: 'Jane', age: 31 });
+        });
+        it('should return empty object when nothing changed', () => {
+            const original = { name: 'John' };
+            const current = { name: 'John' };
+            expect(getChangedFields(original, current)).toEqual({});
+        });
+    });
+    describe('removeEmptyValues', () => {
+        it('should remove null, undefined, and empty strings', () => {
+            const input = {
+                name: 'John',
+                email: '',
+                age: null,
+                phone: undefined,
+                address: 'Seoul',
+            };
+            expect(removeEmptyValues(input)).toEqual({
+                name: 'John',
+                address: 'Seoul',
+            });
+        });
+        it('should keep zero values', () => {
+            const input = { count: 0, active: false };
+            expect(removeEmptyValues(input)).toEqual({ count: 0, active: false });
+        });
+    });
+});

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

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

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

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

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

@@ -0,0 +1,67 @@
+import { describe, it, expect } from 'vitest';
+import { isEmail, isPhoneNumber, isUrl, isStrongPassword, isBusinessNumber, } from '../validation';
+describe('Form Validation', () => {
+    describe('isEmail', () => {
+        it('should validate correct email formats', () => {
+            expect(isEmail('test@example.com')).toBe(true);
+            expect(isEmail('user.name@domain.co.kr')).toBe(true);
+            expect(isEmail('test+tag@example.com')).toBe(true);
+        });
+        it('should reject invalid email formats', () => {
+            expect(isEmail('invalid')).toBe(false);
+            expect(isEmail('test@')).toBe(false);
+            expect(isEmail('@example.com')).toBe(false);
+            expect(isEmail('test @example.com')).toBe(false);
+        });
+    });
+    describe('isPhoneNumber', () => {
+        it('should validate Korean phone numbers', () => {
+            expect(isPhoneNumber('010-1234-5678')).toBe(true);
+            expect(isPhoneNumber('01012345678')).toBe(true);
+            expect(isPhoneNumber('02-1234-5678')).toBe(true);
+            expect(isPhoneNumber('031-123-4567')).toBe(true);
+        });
+        it('should reject invalid phone numbers', () => {
+            expect(isPhoneNumber('123-456-7890')).toBe(false);
+            expect(isPhoneNumber('010-12-3456')).toBe(false);
+        });
+    });
+    describe('isUrl', () => {
+        it('should validate URLs', () => {
+            expect(isUrl('https://example.com')).toBe(true);
+            expect(isUrl('http://test.co.kr')).toBe(true);
+            expect(isUrl('https://example.com/path?query=1')).toBe(true);
+        });
+        it('should reject invalid URLs', () => {
+            expect(isUrl('not-a-url')).toBe(false);
+            expect(isUrl('example.com')).toBe(false);
+        });
+    });
+    describe('isStrongPassword', () => {
+        it('should validate strong passwords', () => {
+            expect(isStrongPassword('Password123!')).toBe(true);
+            expect(isStrongPassword('Str0ng#Pass')).toBe(true);
+        });
+        it('should reject weak passwords', () => {
+            expect(isStrongPassword('short')).toBe(false);
+            expect(isStrongPassword('NoNumbers!')).toBe(false);
+            expect(isStrongPassword('nouppercas3!')).toBe(false);
+            expect(isStrongPassword('NOLOWERCASE1!')).toBe(false);
+            expect(isStrongPassword('NoSpecialChar1')).toBe(false);
+        });
+        it('should respect custom options', () => {
+            expect(isStrongPassword('simple', { minLength: 6, requireUppercase: false, requireNumbers: false, requireSpecialChars: false })).toBe(true);
+            expect(isStrongPassword('PASSWORD', { requireLowercase: false, requireNumbers: false, requireSpecialChars: false })).toBe(true);
+        });
+    });
+    describe('isBusinessNumber', () => {
+        it('should validate 10-digit business numbers', () => {
+            expect(isBusinessNumber('1234567890')).toBe(true);
+            expect(isBusinessNumber('123-45-67890')).toBe(true);
+        });
+        it('should reject invalid business numbers', () => {
+            expect(isBusinessNumber('123456789')).toBe(false);
+            expect(isBusinessNumber('12345678901')).toBe(false);
+        });
+    });
+});

package/dist/form/formatter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Form Formatter Utilities
+ */
+/**
+ * 전화번호 포맷팅 (010-1234-5678)
+ */
+export declare function formatPhoneNumber(value: string): string;
+/**
+ * 사업자등록번호 포맷팅 (123-45-67890)
+ */
+export declare function formatBusinessNumber(value: string): string;
+/**
+ * 신용카드 번호 포맷팅 (1234-5678-9012-3456)
+ */
+export declare function formatCreditCard(value: string): string;
+/**
+ * 숫자만 추출
+ */
+export declare function extractNumbers(value: string): string;
+/**
+ * 통화 포맷팅 (천 단위 콤마)
+ * @param value - 숫자 값
+ * @param currency - 통화 기호 (기본값: '원')
+ */
+export declare function formatCurrency(value: number | string, currency?: string): string;
+/**
+ * 주민등록번호 앞자리만 표시 (123456-*******)
+ */
+export declare function maskResidentNumber(value: string): string;
+/**
+ * 카드번호 마스킹 (1234-****-****-5678)
+ */
+export declare function maskCreditCard(value: string): string;
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/form/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAKrF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/form/formatter.js

@@ -0,0 +1,76 @@
+/**
+ * Form Formatter Utilities
+ */
+/**
+ * 전화번호 포맷팅 (010-1234-5678)
+ */
+export function formatPhoneNumber(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    if (cleaned.length <= 3)
+        return cleaned;
+    if (cleaned.length <= 7) {
+        return `${cleaned.slice(0, 3)}-${cleaned.slice(3)}`;
+    }
+    if (cleaned.length <= 11) {
+        return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 7)}-${cleaned.slice(7)}`;
+    }
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 7)}-${cleaned.slice(7, 11)}`;
+}
+/**
+ * 사업자등록번호 포맷팅 (123-45-67890)
+ */
+export function formatBusinessNumber(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    if (cleaned.length <= 3)
+        return cleaned;
+    if (cleaned.length <= 5) {
+        return `${cleaned.slice(0, 3)}-${cleaned.slice(3)}`;
+    }
+    if (cleaned.length <= 10) {
+        return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 5)}-${cleaned.slice(5)}`;
+    }
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 5)}-${cleaned.slice(5, 10)}`;
+}
+/**
+ * 신용카드 번호 포맷팅 (1234-5678-9012-3456)
+ */
+export function formatCreditCard(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    const groups = cleaned.match(/.{1,4}/g);
+    return groups ? groups.join('-') : cleaned;
+}
+/**
+ * 숫자만 추출
+ */
+export function extractNumbers(value) {
+    return value.replace(/[^0-9]/g, '');
+}
+/**
+ * 통화 포맷팅 (천 단위 콤마)
+ * @param value - 숫자 값
+ * @param currency - 통화 기호 (기본값: '원')
+ */
+export function formatCurrency(value, currency = '원') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num))
+        return '0' + currency;
+    return num.toLocaleString('ko-KR') + currency;
+}
+/**
+ * 주민등록번호 앞자리만 표시 (123456-*******)
+ */
+export function maskResidentNumber(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    if (cleaned.length < 6)
+        return cleaned;
+    return `${cleaned.slice(0, 6)}-${'*'.repeat(7)}`;
+}
+/**
+ * 카드번호 마스킹 (1234-****-****-5678)
+ */
+export function maskCreditCard(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    if (cleaned.length < 12)
+        return value;
+    return `${cleaned.slice(0, 4)}-****-****-${cleaned.slice(-4)}`;
+}