@blastlabs/utils 1.11.0

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)}`;
+}

package/dist/form/helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Form State Helpers
+ */
+/**
+ * 폼 에러가 있는지 확인
+ */
+export declare function hasFormErrors(errors: Record<string, any>): boolean;
+/**
+ * 변경된 필드만 추출
+ */
+export declare function getChangedFields<T extends Record<string, any>>(original: T, current: T): Partial<T>;
+/**
+ * 빈 값 제거 (null, undefined, 빈 문자열)
+ */
+export declare function removeEmptyValues<T extends Record<string, any>>(obj: T): Partial<T>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/form/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWnF"}

package/dist/form/helpers.js

@@ -0,0 +1,34 @@
+/**
+ * Form State Helpers
+ */
+/**
+ * 폼 에러가 있는지 확인
+ */
+export function hasFormErrors(errors) {
+    return Object.keys(errors).length > 0;
+}
+/**
+ * 변경된 필드만 추출
+ */
+export function getChangedFields(original, current) {
+    const changed = {};
+    for (const key in current) {
+        if (current[key] !== original[key]) {
+            changed[key] = current[key];
+        }
+    }
+    return changed;
+}
+/**
+ * 빈 값 제거 (null, undefined, 빈 문자열)
+ */
+export function removeEmptyValues(obj) {
+    const result = {};
+    for (const key in obj) {
+        const value = obj[key];
+        if (value !== null && value !== undefined && value !== '') {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/form/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Form Utilities
+ *
+ * This module provides utilities for form validation, formatting, and state management.
+ */
+export * from './validation';
+export * from './formatter';
+export * from './helpers';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/form/index.js

@@ -0,0 +1,11 @@
+/**
+ * Form Utilities
+ *
+ * This module provides utilities for form validation, formatting, and state management.
+ */
+// Validation utilities
+export * from './validation';
+// Formatter utilities
+export * from './formatter';
+// Helper utilities
+export * from './helpers';

package/dist/form/validation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Form Validation Utilities
+ */
+/**
+ * 이메일 형식 검증
+ */
+export declare function isEmail(value: string): boolean;
+/**
+ * 한국 전화번호 형식 검증
+ * 010-1234-5678, 01012345678, 02-1234-5678 등 허용
+ */
+export declare function isPhoneNumber(value: string): boolean;
+/**
+ * URL 형식 검증
+ */
+export declare function isUrl(value: string): boolean;
+/**
+ * 비밀번호 강도 검증
+ * @param value - 검증할 비밀번호
+ * @param options - 검증 옵션
+ */
+export declare function isStrongPassword(value: string, options?: {
+    minLength?: number;
+    requireUppercase?: boolean;
+    requireLowercase?: boolean;
+    requireNumbers?: boolean;
+    requireSpecialChars?: boolean;
+}): boolean;
+/**
+ * 한국 사업자등록번호 형식 검증 (10자리)
+ */
+export declare function isBusinessNumber(value: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/form/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,OAAO,CAgBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/form/validation.js

@@ -0,0 +1,56 @@
+/**
+ * Form Validation Utilities
+ */
+/**
+ * 이메일 형식 검증
+ */
+export function isEmail(value) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(value);
+}
+/**
+ * 한국 전화번호 형식 검증
+ * 010-1234-5678, 01012345678, 02-1234-5678 등 허용
+ */
+export function isPhoneNumber(value) {
+    const phoneRegex = /^(01[016789]|02|0[3-9]{1}[0-9]{1})-?[0-9]{3,4}-?[0-9]{4}$/;
+    return phoneRegex.test(value.replace(/\s/g, ''));
+}
+/**
+ * URL 형식 검증
+ */
+export function isUrl(value) {
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 비밀번호 강도 검증
+ * @param value - 검증할 비밀번호
+ * @param options - 검증 옵션
+ */
+export function isStrongPassword(value, options = {}) {
+    const { minLength = 8, requireUppercase = true, requireLowercase = true, requireNumbers = true, requireSpecialChars = true, } = options;
+    if (value.length < minLength)
+        return false;
+    if (requireUppercase && !/[A-Z]/.test(value))
+        return false;
+    if (requireLowercase && !/[a-z]/.test(value))
+        return false;
+    if (requireNumbers && !/[0-9]/.test(value))
+        return false;
+    if (requireSpecialChars && !/[!@#$%^&*(),.?":{}|<>]/.test(value))
+        return false;
+    return true;
+}
+/**
+ * 한국 사업자등록번호 형식 검증 (10자리)
+ */
+export function isBusinessNumber(value) {
+    const cleaned = value.replace(/[^0-9]/g, '');
+    return cleaned.length === 10;
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * React Hooks
+ *
+ * This module provides React hooks for common use cases.
+ * Note: Requires React as a peer dependency.
+ */
+export * from './useLocalStorage';
+export * from './useSessionStorage';
+export * from './useMediaQuery';
+export * from './useClickOutside';
+export * from './useDebounce';
+export * from './useToggle';
+export * from './useCopyToClipboard';
+export * from './useWindowSize';
+export * from './usePrevious';
+export * from './useThrottle';
+export * from './useIntersectionObserver';
+export * from './useEventListener';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAG9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAG1C,cAAc,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,23 @@
+/**
+ * React Hooks
+ *
+ * This module provides React hooks for common use cases.
+ * Note: Requires React as a peer dependency.
+ */
+// Storage hooks
+export * from './useLocalStorage';
+export * from './useSessionStorage';
+// UI/UX hooks
+export * from './useMediaQuery';
+export * from './useClickOutside';
+// Utility hooks
+export * from './useDebounce';
+export * from './useToggle';
+export * from './useCopyToClipboard';
+export * from './useWindowSize';
+export * from './usePrevious';
+// Performance hooks
+export * from './useThrottle';
+export * from './useIntersectionObserver';
+// Event hooks
+export * from './useEventListener';

package/dist/hooks/useClickOutside.d.ts

@@ -0,0 +1,49 @@
+import { RefObject } from 'react';
+/**
+ * 요소 외부 클릭을 감지하는 hook
+ *
+ * @param ref - 외부 클릭을 감지할 요소의 ref
+ * @param handler - 외부 클릭 시 실행할 콜백 함수
+ * @param enabled - hook 활성화 여부 (기본값: true)
+ *
+ * @example
+ * function Dropdown() {
+ *   const [isOpen, setIsOpen] = useState(false);
+ *   const dropdownRef = useRef<HTMLDivElement>(null);
+ *
+ *   useClickOutside(dropdownRef, () => setIsOpen(false));
+ *
+ *   return (
+ *     <div ref={dropdownRef}>
+ *       <button onClick={() => setIsOpen(!isOpen)}>Toggle</button>
+ *       {isOpen && <div>Dropdown Content</div>}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // 조건부 활성화
+ * useClickOutside(modalRef, handleClose, isModalOpen);
+ */
+export declare function useClickOutside<T extends HTMLElement = HTMLElement>(ref: RefObject<T>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+/**
+ * 여러 요소의 외부 클릭을 감지하는 hook
+ *
+ * @param refs - 외부 클릭을 감지할 요소들의 ref 배열
+ * @param handler - 외부 클릭 시 실행할 콜백 함수
+ * @param enabled - hook 활성화 여부 (기본값: true)
+ *
+ * @example
+ * function Modal() {
+ *   const modalRef = useRef<HTMLDivElement>(null);
+ *   const triggerRef = useRef<HTMLButtonElement>(null);
+ *
+ *   // 모달과 트리거 버튼 외부 클릭 시 닫기
+ *   useClickOutsideMultiple(
+ *     [modalRef, triggerRef],
+ *     () => setIsOpen(false)
+ *   );
+ * }
+ */
+export declare function useClickOutsideMultiple<T extends HTMLElement = HTMLElement>(refs: RefObject<T>[], handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+//# sourceMappingURL=useClickOutside.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../src/hooks/useClickOutside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,EACjD,OAAO,GAAE,OAAc,GACtB,IAAI,CA2BN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACzE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,EACjD,OAAO,GAAE,OAAc,GACtB,IAAI,CA6BN"}

package/dist/hooks/useClickOutside.js

@@ -0,0 +1,94 @@
+import { useEffect } from 'react';
+/**
+ * 요소 외부 클릭을 감지하는 hook
+ *
+ * @param ref - 외부 클릭을 감지할 요소의 ref
+ * @param handler - 외부 클릭 시 실행할 콜백 함수
+ * @param enabled - hook 활성화 여부 (기본값: true)
+ *
+ * @example
+ * function Dropdown() {
+ *   const [isOpen, setIsOpen] = useState(false);
+ *   const dropdownRef = useRef<HTMLDivElement>(null);
+ *
+ *   useClickOutside(dropdownRef, () => setIsOpen(false));
+ *
+ *   return (
+ *     <div ref={dropdownRef}>
+ *       <button onClick={() => setIsOpen(!isOpen)}>Toggle</button>
+ *       {isOpen && <div>Dropdown Content</div>}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // 조건부 활성화
+ * useClickOutside(modalRef, handleClose, isModalOpen);
+ */
+export function useClickOutside(ref, handler, enabled = true) {
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        const listener = (event) => {
+            const element = ref.current;
+            // ref가 없거나, 클릭한 요소가 ref 내부인 경우 무시
+            if (!element || element.contains(event.target)) {
+                return;
+            }
+            // 외부 클릭 시 handler 실행
+            handler(event);
+        };
+        // mousedown과 touchstart 이벤트 모두 처리 (모바일 지원)
+        document.addEventListener('mousedown', listener);
+        document.addEventListener('touchstart', listener);
+        return () => {
+            document.removeEventListener('mousedown', listener);
+            document.removeEventListener('touchstart', listener);
+        };
+    }, [ref, handler, enabled]);
+}
+/**
+ * 여러 요소의 외부 클릭을 감지하는 hook
+ *
+ * @param refs - 외부 클릭을 감지할 요소들의 ref 배열
+ * @param handler - 외부 클릭 시 실행할 콜백 함수
+ * @param enabled - hook 활성화 여부 (기본값: true)
+ *
+ * @example
+ * function Modal() {
+ *   const modalRef = useRef<HTMLDivElement>(null);
+ *   const triggerRef = useRef<HTMLButtonElement>(null);
+ *
+ *   // 모달과 트리거 버튼 외부 클릭 시 닫기
+ *   useClickOutsideMultiple(
+ *     [modalRef, triggerRef],
+ *     () => setIsOpen(false)
+ *   );
+ * }
+ */
+export function useClickOutsideMultiple(refs, handler, enabled = true) {
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        const listener = (event) => {
+            // 모든 ref를 확인하여 하나라도 내부 클릭이면 무시
+            const isInside = refs.some((ref) => {
+                const element = ref.current;
+                return element && element.contains(event.target);
+            });
+            if (isInside) {
+                return;
+            }
+            // 모든 요소 외부 클릭 시 handler 실행
+            handler(event);
+        };
+        document.addEventListener('mousedown', listener);
+        document.addEventListener('touchstart', listener);
+        return () => {
+            document.removeEventListener('mousedown', listener);
+            document.removeEventListener('touchstart', listener);
+        };
+    }, [refs, handler, enabled]);
+}

package/dist/hooks/useCopyToClipboard.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useCopyToClipboard의 반환 타입
+ */
+export interface CopyToClipboardResult {
+    /** 복사된 값 (null이면 아직 복사 안됨) */
+    copiedText: string | null;
+    /** 클립보드에 복사하는 함수 */
+    copy: (text: string) => Promise<boolean>;
+    /** 복사 상태를 초기화하는 함수 */
+    reset: () => void;
+}
+/**
+ * 클립보드에 텍스트를 복사하는 hook
+ *
+ * @returns {CopyToClipboardResult} 복사된 텍스트, 복사 함수, 리셋 함수
+ *
+ * @example
+ * // 기본 사용
+ * function CopyButton() {
+ *   const { copiedText, copy } = useCopyToClipboard();
+ *
+ *   const handleCopy = () => {
+ *     copy('Hello, World!');
+ *   };
+ *
+ *   return (
+ *     <button onClick={handleCopy}>
+ *       {copiedText ? 'Copied!' : 'Copy'}
+ *     </button>
+ *   );
+ * }
+ *
+ * @example
+ * // 코드 블록 복사
+ * function CodeBlock({ code }: { code: string }) {
+ *   const { copiedText, copy } = useCopyToClipboard();
+ *   const isCopied = copiedText === code;
+ *
+ *   return (
+ *     <div>
+ *       <pre>{code}</pre>
+ *       <button onClick={() => copy(code)}>
+ *         {isCopied ? '✓ Copied' : 'Copy Code'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // 에러 처리
+ * function ShareLink({ url }: { url: string }) {
+ *   const { copy } = useCopyToClipboard();
+ *
+ *   const handleShare = async () => {
+ *     const success = await copy(url);
+ *     if (success) {
+ *       alert('Link copied!');
+ *     } else {
+ *       alert('Failed to copy');
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleShare}>Share</button>;
+ * }
+ */
+export declare function useCopyToClipboard(): CopyToClipboardResult;
+//# sourceMappingURL=useCopyToClipboard.d.ts.map