goodchuck-utils 1.2.0 → 1.4.0

package/dist/string/validation.js

@@ -0,0 +1,115 @@
+/**
+ * String Validation Utilities
+ */
+/**
+ * 빈 문자열 또는 공백만 있는지 확인
+ * @example isEmpty('') // true
+ * @example isEmpty('  ') // true
+ * @example isEmpty('hello') // false
+ */
+export function isEmpty(str) {
+    return !str || str.trim().length === 0;
+}
+/**
+ * 문자열이 특정 문자로 시작하는지 확인
+ * @example startsWith('hello', 'he') // true
+ */
+export function startsWith(str, searchString) {
+    return str.startsWith(searchString);
+}
+/**
+ * 문자열이 특정 문자로 끝나는지 확인
+ * @example endsWith('hello', 'lo') // true
+ */
+export function endsWith(str, searchString) {
+    return str.endsWith(searchString);
+}
+/**
+ * 문자열에 특정 문자열이 포함되어 있는지 확인
+ * @example contains('hello world', 'world') // true
+ */
+export function contains(str, searchString) {
+    return str.includes(searchString);
+}
+/**
+ * 알파벳만 포함하는지 확인
+ * @example isAlpha('hello') // true
+ * @example isAlpha('hello123') // false
+ */
+export function isAlpha(str) {
+    return /^[a-zA-Z]+$/.test(str);
+}
+/**
+ * 숫자만 포함하는지 확인
+ * @example isNumeric('123') // true
+ * @example isNumeric('123.45') // false
+ */
+export function isNumeric(str) {
+    return /^[0-9]+$/.test(str);
+}
+/**
+ * 알파벳과 숫자만 포함하는지 확인
+ * @example isAlphanumeric('hello123') // true
+ * @example isAlphanumeric('hello_123') // false
+ */
+export function isAlphanumeric(str) {
+    return /^[a-zA-Z0-9]+$/.test(str);
+}
+/**
+ * 소문자만 포함하는지 확인
+ * @example isLowerCase('hello') // true
+ * @example isLowerCase('Hello') // false
+ */
+export function isLowerCase(str) {
+    return str === str.toLowerCase() && str !== str.toUpperCase();
+}
+/**
+ * 대문자만 포함하는지 확인
+ * @example isUpperCase('HELLO') // true
+ * @example isUpperCase('Hello') // false
+ */
+export function isUpperCase(str) {
+    return str === str.toUpperCase() && str !== str.toLowerCase();
+}
+/**
+ * JSON 형식인지 확인
+ * @example isJSON('{"name":"John"}') // true
+ * @example isJSON('not json') // false
+ */
+export function isJSON(str) {
+    try {
+        JSON.parse(str);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 16진수 색상 코드인지 확인
+ * @example isHexColor('#fff') // true
+ * @example isHexColor('#ffffff') // true
+ * @example isHexColor('fff') // false
+ */
+export function isHexColor(str) {
+    return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(str);
+}
+/**
+ * UUID 형식인지 확인
+ * @example isUUID('123e4567-e89b-12d3-a456-426614174000') // true
+ */
+export function isUUID(str) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);
+}
+/**
+ * Base64 인코딩된 문자열인지 확인
+ * @example isBase64('SGVsbG8gV29ybGQ=') // true
+ */
+export function isBase64(str) {
+    try {
+        return btoa(atob(str)) === str;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "goodchuck-utils",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "prepare": "npm run build:tsc",
     "prepublishOnly": "npm run test:run && npm run build:tsc",
@@ -18,6 +22,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./src/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js",
+      "require": "./src/hooks/index.js"
     }
   },
   "keywords": [],
@@ -25,15 +34,21 @@
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "@types/node": "^25.0.6",
-    "dayjs": "^1.11.19",
-    "typescript": "^5.9.3"
+    "dayjs": "^1.11.19"
   },
-  "include": [
-    "src/**/*.ts"
-  ],
   "devDependencies": {
+    "@types/node": "^25.0.6",
+    "typescript": "^5.9.3",
+    "@types/react": "^19.2.8",
     "@vitest/ui": "^4.0.16",
     "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   }
 }

package/src/date/index.test.ts

@@ -1,206 +0,0 @@
-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/src/date/index.ts

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

package/src/index.ts

@@ -1,11 +0,0 @@
-// Date utilities
-export * from './date';
-
-// String utilities (placeholder for future)
-// export * from './string';
-
-// Array utilities (placeholder for future)
-// export * from './array';
-
-// Object utilities (placeholder for future)
-// export * from './object';

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020", "DOM"],
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "moduleResolution": "node",
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}

package/vitest.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'html'],
-      exclude: ['node_modules/', 'dist/', '**/*.test.ts'],
-    },
-  },
-});