@simplysm/core-common 13.0.69 → 13.0.71

package/dist/types/date-time.js

@@ -22,17 +22,17 @@ class DateTime {
     }
   }
   /**
-   * 문자열을 파싱하여 DateTime 인스턴스를 생성
+   * Parse a string to create DateTime instance
    *
-   * @param str 날짜시간 문자열
-   * @returns 파싱된 DateTime 인스턴스
-   * @throws ArgumentError 지원하지 않는 형식인 경우
+   * @param str DateTime string
+   * @returns Parsed DateTime instance
+   * @throws ArgumentError If unsupported format
    *
    * @example
    * DateTime.parse("2025-01-15 10:30:00")     // yyyy-MM-dd HH:mm:ss
    * DateTime.parse("2025-01-15 10:30:00.123") // yyyy-MM-dd HH:mm:ss.fff
    * DateTime.parse("20250115103000")          // yyyyMMddHHmmss
-   * DateTime.parse("2025-01-15 오전 10:30:00") // yyyy-MM-dd 오전/오후 HH:mm:ss
+   * DateTime.parse("2025-01-15 AM 10:30:00")  // yyyy-MM-dd AM/PM HH:mm:ss
    * DateTime.parse("2025-01-15T10:30:00Z")    // ISO 8601
    */
   static parse(str) {
@@ -40,12 +40,12 @@ class DateTime {
     if (!Number.isNaN(parsedTick)) {
       return new DateTime(parsedTick);
     }
-    const match1 = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) (오전|오후) ([0-9]{1,2}):([0-9]{2}):([0-9]{2})(\.([0-9]{1,3}))?$/.exec(
+    const match1 = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) (AM|PM) ([0-9]{1,2}):([0-9]{2}):([0-9]{2})(\.([0-9]{1,3}))?$/i.exec(
       str
     );
     if (match1 != null) {
       const rawHour = Number(match1[5]);
-      const isPM = match1[4] === "\uC624\uD6C4";
+      const isPM = match1[4].toUpperCase() === "PM";
       const hour = convert12To24(rawHour, isPM);
       return new DateTime(
         Number(match1[1]),
@@ -57,6 +57,23 @@ class DateTime {
         match1[9] ? Number(match1[9].padEnd(3, "0")) : void 0
       );
     }
+    const matchKorean = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) (오전|오후) ([0-9]{1,2}):([0-9]{2}):([0-9]{2})(\.([0-9]{1,3}))?$/.exec(
+      str
+    );
+    if (matchKorean != null) {
+      const rawHour = Number(matchKorean[5]);
+      const isPM = matchKorean[4] === "\uC624\uD6C4";
+      const hour = convert12To24(rawHour, isPM);
+      return new DateTime(
+        Number(matchKorean[1]),
+        Number(matchKorean[2]),
+        Number(matchKorean[3]),
+        hour,
+        Number(matchKorean[6]),
+        Number(matchKorean[7]),
+        matchKorean[9] ? Number(matchKorean[9].padEnd(3, "0")) : void 0
+      );
+    }
     const match2 = /^[0-9]{14}$/.exec(str);
     if (match2 != null) {
       return new DateTime(
@@ -83,11 +100,11 @@ class DateTime {
       );
     }
     throw new ArgumentError(
-      `\uB0A0\uC9DC\uC2DC\uAC04 \uD615\uC2DD\uC744 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC9C0\uC6D0 \uD615\uC2DD: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd \uC624\uC804/\uC624\uD6C4 HH:mm:ss', ISO 8601`,
+      `Failed to parse datetime format. Supported formats: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd AM/PM HH:mm:ss', ISO 8601`,
       { input: str }
     );
   }
-  //#region Getters (읽기 전용)
+  //#region Getters (read-only)
   get year() {
     return this.date.getFullYear();
   }
@@ -112,20 +129,20 @@ class DateTime {
   get tick() {
     return this.date.getTime();
   }
-  /** 요일 (일~토: 0~6) */
+  /** Day of week (Sunday~Saturday: 0~6) */
   get dayOfWeek() {
     return this.date.getDay();
   }
   get timezoneOffsetMinutes() {
     return -this.date.getTimezoneOffset();
   }
-  /** 날짜시간 세팅이 제대로 되었는지 여부 */
+  /** Whether the datetime is set correctly */
   get isValid() {
     return this.date instanceof Date && !Number.isNaN(this.date.getTime());
   }
   //#endregion
-  //#region 불변 변환 메서드 (새 인스턴스 반환)
-  /** 지정된 연도로 새 인스턴스 반환 */
+  //#region Immutable transformation methods (returns new instance)
+  /** Return new instance with specified year */
   setYear(year) {
     return new DateTime(
       year,
@@ -138,10 +155,10 @@ class DateTime {
     );
   }
   /**
-   * 지정된 월로 새 DateTime 인스턴스를 반환
-   * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
-   * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
-   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+   * Return new DateTime instance with specified month
+   * @param month Month to set (1-12, out-of-range values are adjusted in year)
+   * @note If current day is greater than target month's day count, it will be adjusted to last day of month
+   *       (e.g., setMonth(2) on Jan 31 → Feb 28 or 29)
    */
   setMonth(month) {
     const normalized = normalizeMonth(this.year, month, this.day);
@@ -156,10 +173,10 @@ class DateTime {
     );
   }
   /**
-   * 지정된 일자로 새 DateTime 인스턴스를 반환
-   * @param day 설정할 일자
-   * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
-   *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+   * Return new DateTime instance with specified day
+   * @param day Day to set
+   * @note Days outside valid month range are automatically adjusted to next/previous month per JavaScript Date behavior
+   *       (e.g., day=32 in January → February 1)
    */
   setDay(day) {
     return new DateTime(
@@ -172,7 +189,7 @@ class DateTime {
       this.millisecond
     );
   }
-  /** 지정된 시로 새 인스턴스 반환 */
+  /** Return new instance with specified hour */
   setHour(hour) {
     return new DateTime(
       this.year,
@@ -184,7 +201,7 @@ class DateTime {
       this.millisecond
     );
   }
-  /** 지정된 분으로 새 인스턴스 반환 */
+  /** Return new instance with specified minute */
   setMinute(minute) {
     return new DateTime(
       this.year,
@@ -196,7 +213,7 @@ class DateTime {
       this.millisecond
     );
   }
-  /** 지정된 초로 새 인스턴스 반환 */
+  /** Return new instance with specified second */
   setSecond(second) {
     return new DateTime(
       this.year,
@@ -208,7 +225,7 @@ class DateTime {
       this.millisecond
     );
   }
-  /** 지정된 밀리초로 새 인스턴스 반환 */
+  /** Return new instance with specified millisecond */
   setMillisecond(millisecond) {
     return new DateTime(
       this.year,
@@ -221,41 +238,41 @@ class DateTime {
     );
   }
   //#endregion
-  //#region 산술 메서드 (새 인스턴스 반환)
-  /** 지정된 연수를 더한 새 인스턴스 반환 */
+  //#region Arithmetic methods (returns new instance)
+  /** Return new instance with specified years added */
   addYears(years) {
     return this.setYear(this.year + years);
   }
-  /** 지정된 월수를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified months added */
   addMonths(months) {
     return this.setMonth(this.month + months);
   }
-  /** 지정된 일수를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified days added */
   addDays(days) {
     return new DateTime(this.tick + days * 24 * 60 * 60 * 1e3);
   }
-  /** 지정된 시간을 더한 새 인스턴스 반환 */
+  /** Return new instance with specified hours added */
   addHours(hours) {
     return new DateTime(this.tick + hours * 60 * 60 * 1e3);
   }
-  /** 지정된 분을 더한 새 인스턴스 반환 */
+  /** Return new instance with specified minutes added */
   addMinutes(minutes) {
     return new DateTime(this.tick + minutes * 60 * 1e3);
   }
-  /** 지정된 초를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified seconds added */
   addSeconds(seconds) {
     return new DateTime(this.tick + seconds * 1e3);
   }
-  /** 지정된 밀리초를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified milliseconds added */
   addMilliseconds(milliseconds) {
     return new DateTime(this.tick + milliseconds);
   }
   //#endregion
-  //#region 포맷팅
+  //#region Formatting
   /**
-   * 지정된 포맷으로 문자열 변환
-   * @param format 포맷 문자열
-   * @see dtFormat 지원 포맷 문자열 참조
+   * Convert to string with specified format
+   * @param format Format string
+   * @see dtFormat for supported format strings
    */
   toFormatString(formatStr) {
     return formatDate(formatStr, {

package/dist/types/date-time.js.map

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

package/dist/types/lazy-gc-map.d.ts

@@ -1,18 +1,18 @@
 /**
- * 자동 만료 기능이 있는 Map
- * LRU 방식으로 접근 시간 갱신, 일정 시간 미접근 시 자동 삭제
+ * Map with automatic expiration feature
+ * Updates access time in LRU manner, auto-deletes if not accessed for specified time
  *
- * @note 인스턴스 사용 후 반드시 dispose()를 호출하거나 using 문을 사용해야 함.
- *       그렇지 않으면 GC 타이머가 계속 동작하여 메모리 누수 발생.
+ * @note Must call dispose() or use 'using' statement after use.
+ *       Otherwise GC timer continues running and causes memory leak.
  *
  * @example
- * // using 문 사용 (권장)
+ * // using statement (recommended)
  * using map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
  *
- * // 또는 명시적 dispose() 호출
+ * // Or explicit dispose() call
  * const map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
  * try {
- *   // ... 사용
+ *   // ... usage
  * } finally {
  *   map.dispose();
  * }
@@ -25,46 +25,46 @@ export declare class LazyGcMap<TKey, TValue> {
     private _isGcRunning;
     private _isDestroyed;
     /**
-     * @param _options 설정 옵션
-     * @param _options.gcInterval GC 주기 (밀리초). 기본값: expireTime의 1/10 (최소 1000ms)
-     * @param _options.expireTime 만료 시간 (밀리초). 마지막 접근 후 이 시간이 지나면 삭제됨. 예: 60000 (60초)
-     * @param _options.onExpire 만료 시 호출되는 콜백. 비동기 함수도 가능하며, 에러 발생 시 로깅 후 계속 진행됨
+     * @param _options Configuration options
+     * @param _options.gcInterval GC interval in milliseconds. Default: 1/10 of expireTime (minimum 1000ms)
+     * @param _options.expireTime Expiration time in milliseconds. Deleted after this time since last access. Example: 60000 (60 seconds)
+     * @param _options.onExpire Callback called on expiration. Can be async function, errors are logged and continue execution
      */
     constructor(_options: {
         gcInterval?: number;
         expireTime: number;
         onExpire?: (key: TKey, value: TValue) => void | Promise<void>;
     });
-    /** 저장된 항목 수 */
+    /** Number of stored items */
     get size(): number;
-    /** 키 존재 여부 확인 (접근 시간 갱신 안함) */
+    /** Check if key exists (does not update access time) */
     has(key: TKey): boolean;
-    /** 값 조회 (접근 시간 갱신됨) */
+    /** Get value (updates access time) */
     get(key: TKey): TValue | undefined;
-    /** 값 저장 (접근 시간 설정 및 GC 타이머 시작) */
+    /** Store value (sets access time and starts GC timer) */
     set(key: TKey, value: TValue): void;
-    /** 항목 삭제 (비었으면 GC 타이머 중지) */
+    /** Delete item (stops GC timer if empty) */
     delete(key: TKey): boolean;
-    /** 인스턴스 정리 (GC 타이머 중지 및 데이터 삭제) */
+    /** Clean up instance (stop GC timer and delete data) */
     dispose(): void;
-    /** using 문 지원 */
+    /** Support for 'using' statement */
     [Symbol.dispose](): void;
     /**
-     * 모든 항목 삭제 (인스턴스는 계속 사용 가능)
+     * Delete all items (instance can still be used)
      */
     clear(): void;
     /**
-     * 키에 해당하는 값을 반환하고, 없으면 factory로 생성 후 저장하여 반환
-     * @param key 조회할 키
-     * @param factory 키가 없을 때 값을 생성하는 함수
-     * @returns 기존 값 또는 새로 생성된 값
+     * Return value for key, or create and store via factory if not found
+     * @param key Key to look up
+     * @param factory Function to create value if key not found
+     * @returns Existing or newly created value
      */
     getOrCreate(key: TKey, factory: () => TValue): TValue;
-    /** 값들만 순회 (Iterator) */
+    /** Iterate over values only (Iterator) */
     values(): IterableIterator<TValue>;
-    /** 키들만 순회 (Iterator) */
+    /** Iterate over keys only (Iterator) */
     keys(): IterableIterator<TKey>;
-    /** 엔트리 순회 (Iterator) */
+    /** Iterate over entries (Iterator) */
     entries(): IterableIterator<[TKey, TValue]>;
     private _startGc;
     private _runGc;

package/dist/types/lazy-gc-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-gc-map.d.ts","sourceRoot":"","sources":["../../src/types/lazy-gc-map.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS,CAAC,IAAI,EAAE,MAAM;IAoB/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAG/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0D;IAG/E,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAElD,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;OAKG;gBAEgB,QAAQ,EAAE;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D;IAGH,eAAe;IACf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+BAA+B;IAC/B,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAKvB,uBAAuB;IACvB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAUlC,kCAAkC;IAClC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnC,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAU1B,mCAAmC;IACnC,OAAO,IAAI,IAAI;IAOf,iBAAiB;IACjB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM;IAerD,wBAAwB;IACvB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAOnC,wBAAwB;IACvB,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAK/B,wBAAwB;IACvB,OAAO,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAS5C,OAAO,CAAC,QAAQ;YAUF,MAAM;IAmDpB,OAAO,CAAC,OAAO;CAQhB"}
+{"version":3,"file":"lazy-gc-map.d.ts","sourceRoot":"","sources":["../../src/types/lazy-gc-map.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS,CAAC,IAAI,EAAE,MAAM;IAoB/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAG/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0D;IAG/E,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAElD,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;OAKG;gBAEgB,QAAQ,EAAE;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D;IAGH,6BAA6B;IAC7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAKvB,sCAAsC;IACtC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAUlC,yDAAyD;IACzD,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnC,4CAA4C;IAC5C,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAU1B,wDAAwD;IACxD,OAAO,IAAI,IAAI;IAOf,oCAAoC;IACpC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM;IAerD,0CAA0C;IACzC,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAOnC,wCAAwC;IACvC,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAK/B,sCAAsC;IACrC,OAAO,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAS5C,OAAO,CAAC,QAAQ;YAUF,MAAM;IAmDpB,OAAO,CAAC,OAAO;CAQhB"}

package/dist/types/lazy-gc-map.js

@@ -1,33 +1,33 @@
 import consola from "consola";
 class LazyGcMap {
   /**
-   * @param _options 설정 옵션
-   * @param _options.gcInterval GC 주기 (밀리초). 기본값: expireTime의 1/10 (최소 1000ms)
-   * @param _options.expireTime 만료 시간 (밀리초). 마지막 접근 후 이 시간이 지나면 삭제됨. 예: 60000 (60초)
-   * @param _options.onExpire 만료 시 호출되는 콜백. 비동기 함수도 가능하며, 에러 발생 시 로깅 후 계속 진행됨
+   * @param _options Configuration options
+   * @param _options.gcInterval GC interval in milliseconds. Default: 1/10 of expireTime (minimum 1000ms)
+   * @param _options.expireTime Expiration time in milliseconds. Deleted after this time since last access. Example: 60000 (60 seconds)
+   * @param _options.onExpire Callback called on expiration. Can be async function, errors are logged and continue execution
    */
   constructor(_options) {
     this._options = _options;
   }
   static _logger = consola.withTag("LazyGcMap");
-  // 실제 데이터와 마지막 접근 시간을 함께 저장
+  // Store actual data and last access time together
   _map = /* @__PURE__ */ new Map();
-  // GC 타이머
+  // GC timer
   _gcTimer;
-  // GC 실행 중 플래그 (중복 실행 방지)
+  // Flag to prevent duplicate GC runs
   _isGcRunning = false;
-  // destroy 호출 여부
+  // Whether dispose() has been called
   _isDestroyed = false;
-  /** 저장된 항목 수 */
+  /** Number of stored items */
   get size() {
     return this._map.size;
   }
-  /** 키 존재 여부 확인 (접근 시간 갱신 안함) */
+  /** Check if key exists (does not update access time) */
   has(key) {
     if (this._isDestroyed) return false;
     return this._map.has(key);
   }
-  /** 값 조회 (접근 시간 갱신됨) */
+  /** Get value (updates access time) */
   get(key) {
     if (this._isDestroyed) return void 0;
     const item = this._map.get(key);
@@ -35,13 +35,13 @@ class LazyGcMap {
     item.lastAccess = Date.now();
     return item.value;
   }
-  /** 값 저장 (접근 시간 설정 및 GC 타이머 시작) */
+  /** Store value (sets access time and starts GC timer) */
   set(key, value) {
     if (this._isDestroyed) return;
     this._map.set(key, { value, lastAccess: Date.now() });
     this._startGc();
   }
-  /** 항목 삭제 (비었으면 GC 타이머 중지) */
+  /** Delete item (stops GC timer if empty) */
   delete(key) {
     if (this._isDestroyed) return false;
     const result = this._map.delete(key);
@@ -50,19 +50,19 @@ class LazyGcMap {
     }
     return result;
   }
-  /** 인스턴스 정리 (GC 타이머 중지 및 데이터 삭제) */
+  /** Clean up instance (stop GC timer and delete data) */
   dispose() {
     if (this._isDestroyed) return;
     this._isDestroyed = true;
     this._map.clear();
     this._stopGc();
   }
-  /** using 문 지원 */
+  /** Support for 'using' statement */
   [Symbol.dispose]() {
     this.dispose();
   }
   /**
-   * 모든 항목 삭제 (인스턴스는 계속 사용 가능)
+   * Delete all items (instance can still be used)
    */
   clear() {
     if (this._isDestroyed) return;
@@ -70,14 +70,14 @@ class LazyGcMap {
     this._stopGc();
   }
   /**
-   * 키에 해당하는 값을 반환하고, 없으면 factory로 생성 후 저장하여 반환
-   * @param key 조회할 키
-   * @param factory 키가 없을 때 값을 생성하는 함수
-   * @returns 기존 값 또는 새로 생성된 값
+   * Return value for key, or create and store via factory if not found
+   * @param key Key to look up
+   * @param factory Function to create value if key not found
+   * @returns Existing or newly created value
    */
   getOrCreate(key, factory) {
     if (this._isDestroyed) {
-      throw new Error("LazyGcMap\uC774 \uC774\uBBF8 dispose\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+      throw new Error("LazyGcMap has already been disposed.");
     }
     const item = this._map.get(key);
     if (item == null) {
@@ -88,26 +88,26 @@ class LazyGcMap {
     item.lastAccess = Date.now();
     return item.value;
   }
-  /** 값들만 순회 (Iterator) */
+  /** Iterate over values only (Iterator) */
   *values() {
     if (this._isDestroyed) return;
     for (const item of this._map.values()) {
       yield item.value;
     }
   }
-  /** 키들만 순회 (Iterator) */
+  /** Iterate over keys only (Iterator) */
   *keys() {
     if (this._isDestroyed) return;
     yield* this._map.keys();
   }
-  /** 엔트리 순회 (Iterator) */
+  /** Iterate over entries (Iterator) */
   *entries() {
     if (this._isDestroyed) return;
     for (const [key, item] of this._map.entries()) {
       yield [key, item.value];
     }
   }
-  //#region GC 로직
+  //#region GC logic
   _startGc() {
     if (this._isDestroyed) return;
     if (this._gcTimer != null) return;
@@ -136,7 +136,7 @@ class LazyGcMap {
           try {
             await this._options.onExpire(key, item.value);
           } catch (err) {
-            LazyGcMap._logger.error("onExpire \uCF5C\uBC31 \uC5D0\uB7EC", err);
+            LazyGcMap._logger.error("onExpire callback error", err);
           }
         }
         const afterItem = this._map.get(key);

package/dist/types/lazy-gc-map.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/types/lazy-gc-map.ts"],
-  "mappings": "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",
+  "mappings": "AAAA,OAAO,aAAa;AAqBb,MAAM,UAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBnC,YACmB,UAKjB;AALiB;AAAA,EAKhB;AAAA,EAxBH,OAAwB,UAAU,QAAQ,QAAQ,WAAW;AAAA;AAAA,EAG5C,OAAO,oBAAI,IAAiD;AAAA;AAAA,EAGrE;AAAA;AAAA,EAEA,eAAe;AAAA;AAAA,EAEf,eAAe;AAAA;AAAA,EAiBvB,IAAI,OAAe;AACjB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA;AAAA,EAGA,IAAI,KAAoB;AACtB,QAAI,KAAK,aAAc,QAAO;AAC9B,WAAO,KAAK,KAAK,IAAI,GAAG;AAAA,EAC1B;AAAA;AAAA,EAGA,IAAI,KAA+B;AACjC,QAAI,KAAK,aAAc,QAAO;AAC9B,UAAM,OAAO,KAAK,KAAK,IAAI,GAAG;AAC9B,QAAI,QAAQ,KAAM,QAAO;AAGzB,SAAK,aAAa,KAAK,IAAI;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,KAAW,OAAqB;AAClC,QAAI,KAAK,aAAc;AACvB,SAAK,KAAK,IAAI,KAAK,EAAE,OAAO,YAAY,KAAK,IAAI,EAAE,CAAC;AAEpD,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGA,OAAO,KAAoB;AACzB,QAAI,KAAK,aAAc,QAAO;AAC9B,UAAM,SAAS,KAAK,KAAK,OAAO,GAAG;AAEnC,QAAI,KAAK,KAAK,SAAS,GAAG;AACxB,WAAK,QAAQ;AAAA,IACf;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,aAAc;AACvB,SAAK,eAAe;AACpB,SAAK,KAAK,MAAM;AAChB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,OAAO,OAAO,IAAU;AACvB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,QAAI,KAAK,aAAc;AACvB,SAAK,KAAK,MAAM;AAChB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,KAAW,SAA+B;AACpD,QAAI,KAAK,cAAc;AACrB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,UAAM,OAAO,KAAK,KAAK,IAAI,GAAG;AAC9B,QAAI,QAAQ,MAAM;AAChB,YAAM,QAAQ,QAAQ;AACtB,WAAK,IAAI,KAAK,KAAK;AACnB,aAAO;AAAA,IACT;AAEA,SAAK,aAAa,KAAK,IAAI;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,CAAC,SAAmC;AAClC,QAAI,KAAK,aAAc;AACvB,eAAW,QAAQ,KAAK,KAAK,OAAO,GAAG;AACrC,YAAM,KAAK;AAAA,IACb;AAAA,EACF;AAAA;AAAA,EAGA,CAAC,OAA+B;AAC9B,QAAI,KAAK,aAAc;AACvB,WAAO,KAAK,KAAK,KAAK;AAAA,EACxB;AAAA;AAAA,EAGA,CAAC,UAA4C;AAC3C,QAAI,KAAK,aAAc;AACvB,eAAW,CAAC,KAAK,IAAI,KAAK,KAAK,KAAK,QAAQ,GAAG;AAC7C,YAAM,CAAC,KAAK,KAAK,KAAK;AAAA,IACxB;AAAA,EACF;AAAA;AAAA,EAIQ,WAAiB;AACvB,QAAI,KAAK,aAAc;AACvB,QAAI,KAAK,YAAY,KAAM;AAE3B,UAAM,WAAW,KAAK,SAAS,cAAc,KAAK,IAAI,KAAK,SAAS,aAAa,IAAI,GAAI;AACzF,SAAK,WAAW,YAAY,MAAM;AAChC,WAAK,KAAK,OAAO;AAAA,IACnB,GAAG,QAAQ;AAAA,EACb;AAAA,EAEA,MAAc,SAAwB;AAEpC,QAAI,KAAK,aAAc;AACvB,SAAK,eAAe;AAEpB,QAAI;AACF,YAAM,MAAM,KAAK,IAAI;AAGrB,YAAM,iBAA+E,CAAC;AACtF,iBAAW,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM;AACnC,YAAI,MAAM,KAAK,aAAa,KAAK,SAAS,YAAY;AACpD,yBAAe,KAAK,EAAE,KAAK,KAAK,CAAC;AAAA,QACnC;AAAA,MACF;AAGA,iBAAW,EAAE,KAAK,KAAK,KAAK,gBAAgB;AAE1C,cAAM,cAAc,KAAK,KAAK,IAAI,GAAG;AACrC,YAAI,gBAAgB,MAAM;AACxB;AAAA,QACF;AAGA,YAAI,KAAK,SAAS,YAAY,MAAM;AAClC,cAAI;AACF,kBAAM,KAAK,SAAS,SAAS,KAAK,KAAK,KAAK;AAAA,UAC9C,SAAS,KAAK;AACZ,sBAAU,QAAQ,MAAM,2BAA2B,GAAG;AAAA,UACxD;AAAA,QACF;AAKA,cAAM,YAAY,KAAK,KAAK,IAAI,GAAG;AACnC,YAAI,cAAc,MAAM;AACtB,eAAK,KAAK,OAAO,GAAG;AAAA,QACtB;AAAA,MACF;AAGA,UAAI,KAAK,KAAK,SAAS,GAAG;AACxB,aAAK,QAAQ;AAAA,MACf;AAAA,IACF,UAAE;AACA,WAAK,eAAe;AAAA,IACtB;AAAA,EACF;AAAA,EAEQ,UAAgB;AACtB,QAAI,KAAK,YAAY,MAAM;AACzB,oBAAc,KAAK,QAAQ;AAC3B,WAAK,WAAW;AAAA,IAClB;AAAA,EACF;AAAA;AAGF;",
   "names": []
 }

package/dist/types/time.d.ts

@@ -1,8 +1,8 @@
 /**
- * 시간 클래스 (날짜제외: HH:mm:ss.fff, 불변)
+ * Time class (without date: HH:mm:ss.fff, immutable)
  *
- * 날짜 정보 없이 시간만 저장하는 불변 클래스이다.
- * 24시간을 초과하거나 음수인 경우 자동으로 정규화된다.
+ * An immutable class that stores only time without date information.
+ * Values exceeding 24 hours or negative values are automatically normalized.
  *
  * @example
  * const now = new Time();
@@ -12,26 +12,26 @@
 export declare class Time {
     private static readonly MS_PER_DAY;
     private readonly _tick;
-    /** 현재 시간으로 생성 */
+    /** Create with current time */
     constructor();
-    /** 시분초밀리초로 생성 */
+    /** Create with hour, minute, second, millisecond */
     constructor(hour: number, minute: number, second?: number, millisecond?: number);
-    /** tick (밀리초)으로 생성 */
+    /** Create from tick (millisecond) */
     constructor(tick: number);
-    /** Date 객체에서 시간 부분만 추출하여 생성 */
+    /** Create by extracting time part only from Date object */
     constructor(date: Date);
     /**
-     * 문자열을 파싱하여 Time 인스턴스를 생성
+     * Parse a string to create Time instance
      *
-     * @param str 시간 문자열
-     * @returns 파싱된 Time 인스턴스
-     * @throws ArgumentError 지원하지 않는 형식인 경우
+     * @param str Time string
+     * @returns Parsed Time instance
+     * @throws ArgumentError If unsupported format
      *
      * @example
      * Time.parse("10:30:00")           // HH:mm:ss
      * Time.parse("10:30:00.123")       // HH:mm:ss.fff
-     * Time.parse("오전 10:30:00")       // 오전/오후 HH:mm:ss
-     * Time.parse("2025-01-15T10:30:00") // ISO 8601 (시간 부분만 추출)
+     * Time.parse("AM 10:30:00")        // AM/PM HH:mm:ss
+     * Time.parse("2025-01-15T10:30:00") // ISO 8601 (extract time part only)
      */
     static parse(str: string): Time;
     get hour(): number;
@@ -39,28 +39,28 @@ export declare class Time {
     get second(): number;
     get millisecond(): number;
     get tick(): number;
-    /** 시간 세팅이 제대로 되었는지 여부 */
+    /** Whether time is set correctly */
     get isValid(): boolean;
-    /** 지정된 시로 새 인스턴스 반환 */
+    /** Return new instance with specified hour */
     setHour(hour: number): Time;
-    /** 지정된 분으로 새 인스턴스 반환 */
+    /** Return new instance with specified minute */
     setMinute(minute: number): Time;
-    /** 지정된 초로 새 인스턴스 반환 */
+    /** Return new instance with specified second */
     setSecond(second: number): Time;
-    /** 지정된 밀리초로 새 인스턴스 반환 */
+    /** Return new instance with specified millisecond */
     setMillisecond(millisecond: number): Time;
-    /** 지정된 시간을 더한 새 인스턴스 반환 (24시간 순환) */
+    /** Return new instance with specified hours added (24-hour wraparound) */
     addHours(hours: number): Time;
-    /** 지정된 분을 더한 새 인스턴스 반환 (24시간 순환) */
+    /** Return new instance with specified minutes added (24-hour wraparound) */
     addMinutes(minutes: number): Time;
-    /** 지정된 초를 더한 새 인스턴스 반환 (24시간 순환) */
+    /** Return new instance with specified seconds added (24-hour wraparound) */
     addSeconds(seconds: number): Time;
-    /** 지정된 밀리초를 더한 새 인스턴스 반환 (24시간 순환) */
+    /** Return new instance with specified milliseconds added (24-hour wraparound) */
     addMilliseconds(milliseconds: number): Time;
     /**
-     * 지정된 포맷으로 문자열 변환
-     * @param format 포맷 문자열
-     * @see dtFormat 지원 포맷 문자열 참조
+     * Convert to string with specified format
+     * @param format Format string
+     * @see dtFormat for supported format strings
      */
     toFormatString(formatStr: string): string;
     toString(): string;

package/dist/types/time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,iBAAiB;;IAEjB,iBAAiB;gBACL,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAC/E,sBAAsB;gBACV,IAAI,EAAE,MAAM;IACxB,+BAA+B;gBACnB,IAAI,EAAE,IAAI;IA8BtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA+C/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD,uBAAuB;IACvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,wBAAwB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,yBAAyB;IACzB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,sCAAsC;IACtC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAU3C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IASzC,QAAQ,IAAI,MAAM;CAKnB"}
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,+BAA+B;;IAE/B,oDAAoD;gBACxC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAC/E,qCAAqC;gBACzB,IAAI,EAAE,MAAM;IACxB,2DAA2D;gBAC/C,IAAI,EAAE,IAAI;IA8BtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA+C/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oCAAoC;IACpC,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,qDAAqD;IACrD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,4EAA4E;IAC5E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,4EAA4E;IAC5E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,iFAAiF;IACjF,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAU3C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IASzC,QAAQ,IAAI,MAAM;CAKnB"}