@simplysm/core-common 13.0.100 → 14.0.4

package/dist/utils/date-format.js

@@ -1,106 +1,192 @@
-function normalizeMonth(year, month, day) {
-  const normalizedYear = year + Math.floor((month - 1) / 12);
-  const normalizedMonth = ((month - 1) % 12 + 12) % 12 + 1;
-  const lastDay = new Date(normalizedYear, normalizedMonth, 0).getDate();
-  const normalizedDay = Math.min(day, lastDay);
-  return { year: normalizedYear, month: normalizedMonth, day: normalizedDay };
+/**
+ * 월 설정 시 연/월/일 정규화
+ * - 월이 1-12 범위를 벗어나면 연도 조정
+ * - 현재 일이 대상 월의 일수보다 크면 해당 월의 마지막 일로 조정
+ *
+ * @param year 기준 연도
+ * @param month 설정할 월 (1-12 범위 밖의 값 허용)
+ * @param day 기준 일
+ * @returns 정규화된 연도, 월, 일
+ *
+ * @example
+ * normalizeMonth(2025, 13, 15) // { year: 2026, month: 1, day: 15 }
+ * normalizeMonth(2025, 2, 31)  // { year: 2025, month: 2, day: 28 }
+ */
+export function normalizeMonth(year, month, day) {
+    // 월 오버플로우/언더플로우 정규화
+    // 월이 1-12 범위를 벗어나면 연도 조정
+    const normalizedYear = year + Math.floor((month - 1) / 12);
+    // JavaScript % 연산자는 음수에 대해 음수를 반환하므로 (% 12 + 12) % 12 패턴으로 0-11 범위를 보장한 후 1-12로 변환
+    const normalizedMonth = ((((month - 1) % 12) + 12) % 12) + 1;
+    // 대상 월의 마지막 일 조회
+    const lastDay = new Date(normalizedYear, normalizedMonth, 0).getDate();
+    const normalizedDay = Math.min(day, lastDay);
+    return { year: normalizedYear, month: normalizedMonth, day: normalizedDay };
 }
-function convert12To24(rawHour, isPM) {
-  if (rawHour === 12) {
-    return isPM ? 12 : 0;
-  }
-  return isPM ? rawHour + 12 : rawHour;
+/**
+ * 12시간 형식을 24시간 형식으로 변환
+ * - 12:00 AM = 0:00, 12:00 PM = 12:00
+ * - 1-11 AM = 1-11, 1-11 PM = 13-23
+ *
+ * @param rawHour 12시간 형식의 시 (1-12)
+ * @param isPM 오후 여부
+ * @returns 24시간 형식의 시 (0-23)
+ */
+export function convert12To24(rawHour, isPM) {
+    if (rawHour === 12) {
+        return isPM ? 12 : 0;
+    }
+    return isPM ? rawHour + 12 : rawHour;
 }
+//#region 정규식 캐싱 (모듈 로드 시 한 번만 생성)
+/**
+ * 형식 패턴 정규식
+ *
+ * 순서가 중요함:
+ * dtFormat() 함수에서 긴 패턴(yyyy, MM, dd 등)이 먼저 처리되어야
+ * 짧은 패턴(y, M, d 등)이 부분적으로 매칭되는 것을 방지함.
+ * 예: "yyyy"가 먼저 처리되지 않으면 "yy"가 두 번 매칭될 수 있음
+ */
 const patterns = {
-  yyyy: /yyyy/g,
-  yy: /yy/g,
-  MM: /MM/g,
-  M: /M/g,
-  ddd: /ddd/g,
-  dd: /dd/g,
-  d: /d/g,
-  tt: /tt/g,
-  hh: /hh/g,
-  h: /h/g,
-  HH: /HH/g,
-  H: /H/g,
-  mm: /mm/g,
-  m: /m/g,
-  ss: /ss/g,
-  s: /s/g,
-  fff: /fff/g,
-  ff: /ff/g,
-  f: /f/g,
-  zzz: /zzz/g,
-  zz: /zz/g,
-  z: /z/g
+    yyyy: /yyyy/g,
+    yy: /yy/g,
+    MM: /MM/g,
+    M: /M/g,
+    ddd: /ddd/g,
+    dd: /dd/g,
+    d: /d/g,
+    tt: /tt/g,
+    hh: /hh/g,
+    h: /h/g,
+    HH: /HH/g,
+    H: /H/g,
+    mm: /mm/g,
+    m: /m/g,
+    ss: /ss/g,
+    s: /s/g,
+    fff: /fff/g,
+    ff: /ff/g,
+    f: /f/g,
+    zzz: /zzz/g,
+    zz: /zz/g,
+    z: /z/g,
 };
-const weekStrings = ["\uC77C", "\uC6D4", "\uD654", "\uC218", "\uBAA9", "\uAE08", "\uD1A0"];
-function format(formatString, args) {
-  const { year, month, day, hour, minute, second, millisecond, timezoneOffsetMinutes } = args;
-  const absOffsetMinutes = timezoneOffsetMinutes !== void 0 ? Math.abs(timezoneOffsetMinutes) : void 0;
-  const offsetHour = absOffsetMinutes !== void 0 ? Math.floor(absOffsetMinutes / 60) : void 0;
-  const offsetMinute = absOffsetMinutes !== void 0 ? absOffsetMinutes % 60 : void 0;
-  const offsetSign = timezoneOffsetMinutes !== void 0 ? timezoneOffsetMinutes >= 0 ? "+" : "-" : void 0;
-  const week = year !== void 0 && month !== void 0 && day !== void 0 ? new Date(year, month - 1, day).getDay() : void 0;
-  let result = formatString;
-  if (year !== void 0) {
-    const yearStr = year.toString();
-    result = result.replace(patterns.yyyy, yearStr);
-    result = result.replace(patterns.yy, yearStr.substring(2, 4));
-  }
-  if (month !== void 0) {
-    const monthStr = month.toString();
-    result = result.replace(patterns.MM, monthStr.padStart(2, "0"));
-    result = result.replace(patterns.M, monthStr);
-  }
-  if (week !== void 0) {
-    result = result.replace(patterns.ddd, weekStrings[week]);
-  }
-  if (day !== void 0) {
-    const dayStr = day.toString();
-    result = result.replace(patterns.dd, dayStr.padStart(2, "0"));
-    result = result.replace(patterns.d, dayStr);
-  }
-  if (hour !== void 0) {
-    result = result.replace(patterns.tt, hour < 12 ? "AM" : "PM");
-    const hour12 = hour % 12 || 12;
-    const hour12Str = hour12.toString();
-    result = result.replace(patterns.hh, hour12Str.padStart(2, "0"));
-    result = result.replace(patterns.h, hour12Str);
-    const hourStr = hour.toString();
-    result = result.replace(patterns.HH, hourStr.padStart(2, "0"));
-    result = result.replace(patterns.H, hourStr);
-  }
-  if (minute !== void 0) {
-    const minuteStr = minute.toString();
-    result = result.replace(patterns.mm, minuteStr.padStart(2, "0"));
-    result = result.replace(patterns.m, minuteStr);
-  }
-  if (second !== void 0) {
-    const secondStr = second.toString();
-    result = result.replace(patterns.ss, secondStr.padStart(2, "0"));
-    result = result.replace(patterns.s, secondStr);
-  }
-  if (millisecond !== void 0) {
-    const msStr = millisecond.toString().padStart(3, "0");
-    result = result.replace(patterns.fff, msStr);
-    result = result.replace(patterns.ff, msStr.substring(0, 2));
-    result = result.replace(patterns.f, msStr.substring(0, 1));
-  }
-  if (offsetSign !== void 0 && offsetHour !== void 0 && offsetMinute !== void 0) {
-    result = result.replace(
-      patterns.zzz,
-      `${offsetSign}${offsetHour.toString().padStart(2, "0")}:${offsetMinute.toString().padStart(2, "0")}`
-    );
-    result = result.replace(patterns.zz, `${offsetSign}${offsetHour.toString().padStart(2, "0")}`);
-    result = result.replace(patterns.z, `${offsetSign}${offsetHour}`);
-  }
-  return result;
+const weekStrings = ["일", "월", "화", "수", "목", "금", "토"];
+//#endregion
+/**
+ * 형식 문자열에 따라 날짜/시간을 문자열로 변환
+ *
+ * @param formatString 형식 문자열
+ * @param args 날짜/시간 구성요소
+ *
+ * @remarks
+ * C#과 동일한 형식 문자열을 지원:
+ *
+ * | 형식 | 설명 | 예시 |
+ * |------|------|------|
+ * | yyyy | 4자리 연도 | 2024 |
+ * | yy | 2자리 연도 | 24 |
+ * | MM | 0 채움 월 | 01~12 |
+ * | M | 월 | 1~12 |
+ * | ddd | 요일 | 일, 월, 화, 수, 목, 금, 토 |
+ * | dd | 0 채움 일 | 01~31 |
+ * | d | 일 | 1~31 |
+ * | tt | 오전/오후 | AM, PM |
+ * | hh | 0 채움 12시간 | 01~12 |
+ * | h | 12시간 | 1~12 |
+ * | HH | 0 채움 24시간 | 00~23 |
+ * | H | 24시간 | 0~23 |
+ * | mm | 0 채움 분 | 00~59 |
+ * | m | 분 | 0~59 |
+ * | ss | 0 채움 초 | 00~59 |
+ * | s | 초 | 0~59 |
+ * | fff | 밀리초 (3자리) | 000~999 |
+ * | ff | 밀리초 (2자리) | 00~99 |
+ * | f | 밀리초 (1자리) | 0~9 |
+ * | zzz | 타임존 오프셋 (±HH:mm) | +09:00 |
+ * | zz | 타임존 오프셋 (±HH) | +09 |
+ * | z | 타임존 오프셋 (±H) | +9 |
+ *
+ * @example
+ * ```typescript
+ * formatDate("yyyy-MM-dd", { year: 2024, month: 3, day: 15 });
+ * // "2024-03-15"
+ *
+ * formatDate("yyyy-M-d (ddd)", { year: 2024, month: 3, day: 15 });
+ * // "2024-3-15 (Fri)"
+ *
+ * formatDate("tt h:mm:ss", { hour: 14, minute: 30, second: 45 });
+ * // "PM 2:30:45"
+ * ```
+ */
+export function format(formatString, args) {
+    const { year, month, day, hour, minute, second, millisecond, timezoneOffsetMinutes } = args;
+    const absOffsetMinutes = timezoneOffsetMinutes !== undefined ? Math.abs(timezoneOffsetMinutes) : undefined;
+    const offsetHour = absOffsetMinutes !== undefined ? Math.floor(absOffsetMinutes / 60) : undefined;
+    const offsetMinute = absOffsetMinutes !== undefined ? absOffsetMinutes % 60 : undefined;
+    const offsetSign = timezoneOffsetMinutes !== undefined ? (timezoneOffsetMinutes >= 0 ? "+" : "-") : undefined;
+    const week = year !== undefined && month !== undefined && day !== undefined
+        ? new Date(year, month - 1, day).getDay()
+        : undefined;
+    let result = formatString;
+    // 연도
+    if (year !== undefined) {
+        const yearStr = year.toString();
+        result = result.replace(patterns.yyyy, yearStr);
+        result = result.replace(patterns.yy, yearStr.substring(2, 4));
+    }
+    // 월
+    if (month !== undefined) {
+        const monthStr = month.toString();
+        result = result.replace(patterns.MM, monthStr.padStart(2, "0"));
+        result = result.replace(patterns.M, monthStr);
+    }
+    // 요일
+    if (week !== undefined) {
+        result = result.replace(patterns.ddd, weekStrings[week]);
+    }
+    // 일
+    if (day !== undefined) {
+        const dayStr = day.toString();
+        result = result.replace(patterns.dd, dayStr.padStart(2, "0"));
+        result = result.replace(patterns.d, dayStr);
+    }
+    // 시
+    if (hour !== undefined) {
+        result = result.replace(patterns.tt, hour < 12 ? "AM" : "PM");
+        const hour12 = hour % 12 || 12;
+        const hour12Str = hour12.toString();
+        result = result.replace(patterns.hh, hour12Str.padStart(2, "0"));
+        result = result.replace(patterns.h, hour12Str);
+        const hourStr = hour.toString();
+        result = result.replace(patterns.HH, hourStr.padStart(2, "0"));
+        result = result.replace(patterns.H, hourStr);
+    }
+    // 분
+    if (minute !== undefined) {
+        const minuteStr = minute.toString();
+        result = result.replace(patterns.mm, minuteStr.padStart(2, "0"));
+        result = result.replace(patterns.m, minuteStr);
+    }
+    // 초
+    if (second !== undefined) {
+        const secondStr = second.toString();
+        result = result.replace(patterns.ss, secondStr.padStart(2, "0"));
+        result = result.replace(patterns.s, secondStr);
+    }
+    // 밀리초
+    if (millisecond !== undefined) {
+        const msStr = millisecond.toString().padStart(3, "0");
+        result = result.replace(patterns.fff, msStr);
+        result = result.replace(patterns.ff, msStr.substring(0, 2));
+        result = result.replace(patterns.f, msStr.substring(0, 1));
+    }
+    // 타임존
+    if (offsetSign !== undefined && offsetHour !== undefined && offsetMinute !== undefined) {
+        result = result.replace(patterns.zzz, `${offsetSign}${offsetHour.toString().padStart(2, "0")}:${offsetMinute.toString().padStart(2, "0")}`);
+        result = result.replace(patterns.zz, `${offsetSign}${offsetHour.toString().padStart(2, "0")}`);
+        result = result.replace(patterns.z, `${offsetSign}${offsetHour}`);
+    }
+    return result;
 }
-export {
-  convert12To24,
-  format,
-  normalizeMonth
-};
-//# sourceMappingURL=date-format.js.map
+//# sourceMappingURL=date-format.js.map

package/dist/utils/date-format.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/date-format.ts"],
-  "mappings": "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",
-  "names": []
-}
+{"version":3,"file":"date-format.js","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":"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"}

package/dist/utils/error.d.ts

@@ -1,10 +1,10 @@
 /**
- * Utility to extract message from unknown type error.
+ * unknown 타입 에러에서 메시지를 추출하는 유틸리티.
  *
- * Returns the message property if it's an Error instance, otherwise returns String conversion.
+ * Error 인스턴스이면 message 속성을 반환하고, 그렇지 않으면 String 변환 결과를 반환.
  *
- * @param err - Unknown error from catch block
- * @returns Error message string
+ * @param err - catch 블록의 unknown 에러
+ * @returns 에러 메시지 문자열
  */
 export declare function message(err: unknown): string;
 //# sourceMappingURL=error.d.ts.map

package/dist/utils/error.js

@@ -1,7 +1,12 @@
-function message(err) {
-  return err instanceof Error ? err.message : String(err);
+/**
+ * unknown 타입 에러에서 메시지를 추출하는 유틸리티.
+ *
+ * Error 인스턴스이면 message 속성을 반환하고, 그렇지 않으면 String 변환 결과를 반환.
+ *
+ * @param err - catch 블록의 unknown 에러
+ * @returns 에러 메시지 문자열
+ */
+export function message(err) {
+    return err instanceof Error ? err.message : String(err);
 }
-export {
-  message
-};
-//# sourceMappingURL=error.js.map
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/error.ts"],
-  "mappings": "AAQO,SAAS,QAAQ,KAAsB;AAC5C,SAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AACxD;",
-  "names": []
-}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/json.d.ts

@@ -1,17 +1,17 @@
 /**
- * Serialize object to JSON string
- * Supports custom types like DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array, etc.
+ * 객체를 JSON 문자열로 직렬화
+ * DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array 등 커스텀 타입 지원.
  *
- * @param obj Object to serialize
- * @param options Serialization options
- * @param options.space JSON indentation (number: number of spaces, string: indentation string)
- * @param options.replacer Custom replacer function. Called before default type conversion
- * @param options.redactBytes If true, replace Uint8Array contents with "__hidden__" (for logging). Results serialized with this option cannot restore original Uint8Array via jsonParse()
+ * @param obj 직렬화할 객체
+ * @param options 직렬화 옵션
+ * @param options.space JSON 들여쓰기 (숫자: 공백 수, 문자열: 들여쓰기 문자열)
+ * @param options.replacer 커스텀 replacer 함수. 기본 타입 변환 전에 호출됨
+ * @param options.redactBytes true이면 Uint8Array 내용을 "__hidden__"으로 대체 (로깅용). 이 옵션으로 직렬화된 결과는 jsonParse()로 원래 Uint8Array를 복원할 수 없음
  *
  * @remarks
- * - Objects with circular references throw TypeError
- * - If object has toJSON method, it is called and the result is used (except for custom types like Date, DateTime)
- * - Safe in Worker environments as global prototypes are not modified
+ * - 순환 참조가 있는 객체는 TypeError를 발생시킴
+ * - 객체에 toJSON 메서드가 있으면 호출하여 결과를 사용 (Date, DateTime 같은 커스텀 타입 제외)
+ * - 전역 프로토타입을 수정하지 않으므로 Worker 환경에서 안전
  */
 export declare function stringify(obj: unknown, options?: {
     space?: string | number;
@@ -19,18 +19,18 @@ export declare function stringify(obj: unknown, options?: {
     redactBytes?: boolean;
 }): string;
 /**
- * Deserialize JSON string to object
- * Restore custom types like DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array, etc.
+ * JSON 문자열을 객체로 역직렬화
+ * DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array 등 커스텀 타입 복원.
  *
  * @remarks
- * Objects with `__type__` and `data` keys are used for type restoration.
- * Be careful if user data contains objects with `{ __type__: "Date" | "DateTime" | "DateOnly" | "Time" | "Uuid" | "Set" | "Map" | "Error" | "Uint8Array", data: ... }`
- * format as they may be unintentionally converted to types.
- * All JSON null values are converted to undefined.
- * This is intentional for the simplysm framework's null-free convention.
+ * `__type__`과 `data` key를 가진 객체가 타입 복원에 사용됨.
+ * 사용자 데이터에 `{ __type__: "Date" | "DateTime" | "DateOnly" | "Time" | "Uuid" | "Set" | "Map" | "Error" | "Uint8Array", data: ... }`
+ * 형식의 객체가 포함되어 있으면 의도치 않게 타입으로 변환될 수 있으므로 주의.
+ * 모든 JSON null 값은 undefined로 변환됨.
+ * 이는 simplysm 프레임워크의 null-free 규칙을 위한 의도적인 동작.
  *
- * @security In development mode (`__DEV__`), the error message includes the entire JSON string.
- * In production mode, only JSON length is included.
+ * @security 개발 모드(`__DEV__`)에서는 에러 메시지에 전체 JSON 문자열이 포함됨.
+ * 운영 모드에서는 JSON 길이만 포함됨.
  */
 export declare function parse<TResult = unknown>(json: string): TResult;
 //# sourceMappingURL=json.d.ts.map