@simplysm/core-common 13.0.99 → 14.0.1

package/dist/features/serial-queue.js

@@ -1,66 +1,87 @@
+/**
+ * 비동기 직렬 큐
+ *
+ * 큐에 추가된 함수들은 순차적으로 실행됨.
+ * 하나의 작업이 완료된 후에야 다음 작업이 시작됨.
+ * 에러가 발생해도 후속 작업은 계속 실행됨.
+ *
+ * @example
+ * const queue = new SerialQueue();
+ * queue.run(async () => { await fetch("/api/1"); });
+ * queue.run(async () => { await fetch("/api/2"); }); // 1 완료 후 실행
+ * queue.run(async () => { await fetch("/api/3"); }); // 2 완료 후 실행
+ *
+ * @example
+ * // 에러 처리
+ * queue.on("error", (err) => console.error(err));
+ */
 import { SdError } from "../errors/sd-error.js";
 import { EventEmitter } from "./event-emitter.js";
 import consola from "consola";
 import { time } from "../utils/wait.js";
-class SerialQueue extends EventEmitter {
-  /**
-   * @param _gap Gap between each task (ms)
-   */
-  constructor(_gap = 0) {
-    super();
-    this._gap = _gap;
-  }
-  static _logger = consola.withTag("SerialQueue");
-  _queue = [];
-  _isQueueRunning = false;
-  /**
-   * Clear pending queue (currently executing task will complete)
-   */
-  dispose() {
-    this._queue.length = 0;
-    super.dispose();
-  }
-  /**
-   * Supports using statement
-   */
-  [Symbol.dispose]() {
-    this.dispose();
-  }
-  /**
-   * Add a function to the queue and execute it
-   */
-  run(fn) {
-    this._queue.push(fn);
-    void this._process();
-  }
-  async _process() {
-    if (this._isQueueRunning) return;
-    this._isQueueRunning = true;
-    try {
-      while (this._queue.length > 0) {
-        const fn = this._queue.shift();
-        if (!fn) break;
+export class SerialQueue extends EventEmitter {
+    _gap;
+    static _logger = consola.withTag("SerialQueue");
+    _queue = [];
+    _isQueueRunning = false;
+    /**
+     * @param _gap 각 작업 사이의 간격 (ms)
+     */
+    constructor(_gap = 0) {
+        super();
+        this._gap = _gap;
+    }
+    /**
+     * 대기 중인 큐 비우기 (현재 실행 중인 작업은 완료됨)
+     */
+    dispose() {
+        this._queue.length = 0;
+        super.dispose();
+    }
+    /**
+     * using 문 지원
+     */
+    [Symbol.dispose]() {
+        this.dispose();
+    }
+    /**
+     * 큐에 함수를 추가하고 실행
+     */
+    run(fn) {
+        this._queue.push(fn);
+        void this._process();
+    }
+    async _process() {
+        if (this._isQueueRunning)
+            return;
+        this._isQueueRunning = true;
         try {
-          await fn();
-        } catch (err) {
-          const error = err instanceof Error ? err : new Error(String(err));
-          const sdError = new SdError(error, "Error occurred while executing queue task");
-          if (this.listenerCount("error") > 0) {
-            this.emit("error", sdError);
-          } else {
-            SerialQueue._logger.error(sdError);
-          }
+            while (this._queue.length > 0) {
+                const fn = this._queue.shift();
+                if (!fn)
+                    break;
+                try {
+                    await fn();
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    const sdError = new SdError(error, "큐 작업 실행 중 오류 발생");
+                    // 리스너가 있으면 이벤트로 발행, 없으면 로그 출력
+                    if (this.listenerCount("error") > 0) {
+                        this.emit("error", sdError);
+                    }
+                    else {
+                        SerialQueue._logger.error(sdError);
+                    }
+                }
+                if (this._gap > 0 && this._queue.length > 0) {
+                    await time(this._gap);
+                }
+            }
         }
-        if (this._gap > 0 && this._queue.length > 0) {
-          await time(this._gap);
+        finally {
+            this._isQueueRunning = false;
         }
-      }
-    } finally {
-      this._isQueueRunning = false;
     }
-  }
 }
-export {
-  SerialQueue
-};
-//# sourceMappingURL=serial-queue.js.map
+//# sourceMappingURL=serial-queue.js.map

package/dist/features/serial-queue.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/features/serial-queue.ts"],
-  "mappings": "AAiBA,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,OAAO,aAAa;AACpB,SAAS,YAAY;AAMd,MAAM,oBAAoB,aAAgC;AAAA;AAAA;AAAA;AAAA,EAS/D,YAA6B,OAAe,GAAG;AAC7C,UAAM;AADqB;AAAA,EAE7B;AAAA,EAVA,OAAwB,UAAU,QAAQ,QAAQ,aAAa;AAAA,EAE9C,SAAyC,CAAC;AAAA,EACnD,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAYjB,UAAgB;AACvB,SAAK,OAAO,SAAS;AACrB,UAAM,QAAQ;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,CAAU,OAAO,OAAO,IAAU;AAChC,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,IAAsC;AACxC,SAAK,OAAO,KAAK,EAAE;AACnB,SAAK,KAAK,SAAS;AAAA,EACrB;AAAA,EAEA,MAAc,WAA0B;AACtC,QAAI,KAAK,gBAAiB;AAC1B,SAAK,kBAAkB;AAEvB,QAAI;AACF,aAAO,KAAK,OAAO,SAAS,GAAG;AAC7B,cAAM,KAAK,KAAK,OAAO,MAAM;AAC7B,YAAI,CAAC,GAAI;AAET,YAAI;AACF,gBAAM,GAAG;AAAA,QACX,SAAS,KAAK;AACZ,gBAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,gBAAM,UAAU,IAAI,QAAQ,OAAO,2CAA2C;AAG9E,cAAI,KAAK,cAAc,OAAO,IAAI,GAAG;AACnC,iBAAK,KAAK,SAAS,OAAO;AAAA,UAC5B,OAAO;AACL,wBAAY,QAAQ,MAAM,OAAO;AAAA,UACnC;AAAA,QACF;AAEA,YAAI,KAAK,OAAO,KAAK,KAAK,OAAO,SAAS,GAAG;AAC3C,gBAAM,KAAK,KAAK,IAAI;AAAA,QACtB;AAAA,MACF;AAAA,IACF,UAAE;AACA,WAAK,kBAAkB;AAAA,IACzB;AAAA,EACF;AACF;",
-  "names": []
-}
+{"version":3,"file":"serial-queue.js","sourceRoot":"","sources":["../../src/features/serial-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAMrC,MAAM,OAAO,WAAY,SAAQ,YAA+B;IASjC;IARrB,MAAM,CAAU,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEhD,MAAM,GAAmC,EAAE,CAAC;IACrD,eAAe,GAAG,KAAK,CAAC;IAEhC;;OAEG;IACH,YAA6B,OAAe,CAAC;QAC3C,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAY;IAE7C,CAAC;IAED;;OAEG;IACM,OAAO;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACM,CAAC,MAAM,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAA8B;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,EAAE;oBAAE,MAAM;gBAEf,IAAI,CAAC;oBACH,MAAM,EAAE,EAAE,CAAC;gBACb,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;oBAEtD,8BAA8B;oBAC9B,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBACpC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACN,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC"}

package/dist/globals.d.ts

@@ -1,9 +1,9 @@
 /**
- * Whether development mode is enabled
+ * 개발 모드 활성화 여부
  *
- * Substituted at build time:
- * - Library build: Not substituted (kept as-is)
- * - Client/Server build: Substituted with `define: { '__DEV__': 'true/false' }`
+ * 빌드 시점에 치환됨:
+ * - 라이브러리 빌드: 치환되지 않음 (그대로 유지)
+ * - 클라이언트/서버 빌드: `define: { '__DEV__': 'true/false' }`로 치환
  */
 export {};
 declare global {

package/dist/globals.js

@@ -1 +1,9 @@
-//# sourceMappingURL=globals.js.map
+/**
+ * 개발 모드 활성화 여부
+ *
+ * 빌드 시점에 치환됨:
+ * - 라이브러리 빌드: 치환되지 않음 (그대로 유지)
+ * - 클라이언트/서버 빌드: `define: { '__DEV__': 'true/false' }`로 치환
+ */
+export {};
+//# sourceMappingURL=globals.js.map

package/dist/globals.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -1,47 +1,48 @@
+// @simplysm/core-common
+// 공통 유틸리티 패키지
 import "./extensions/arr-ext.js";
 import "./extensions/set-ext.js";
 import "./extensions/map-ext.js";
 export * from "./env.js";
+// arr-extension 재내보내기
 export * from "./extensions/arr-ext.js";
+//#region errors
 export * from "./errors/sd-error.js";
 export * from "./errors/argument-error.js";
 export * from "./errors/not-implemented-error.js";
 export * from "./errors/timeout-error.js";
+//#endregion
+//#region types
 export * from "./types/uuid.js";
 export * from "./types/lazy-gc-map.js";
 export * from "./types/date-time.js";
 export * from "./types/date-only.js";
 export * from "./types/time.js";
+//#endregion
+//#region features
 export * from "./features/debounce-queue.js";
 export * from "./features/serial-queue.js";
 export * from "./features/event-emitter.js";
-import * as obj from "./utils/obj.js";
-import * as str from "./utils/str.js";
-import * as num from "./utils/num.js";
-import * as bytes from "./utils/bytes.js";
-import * as path from "./utils/path.js";
-import * as json from "./utils/json.js";
-import * as xml from "./utils/xml.js";
-import * as wait from "./utils/wait.js";
-import * as transfer from "./utils/transferable.js";
-import * as err from "./utils/error.js";
-import * as dt from "./utils/date-format.js";
-import * as primitive from "./utils/primitive.js";
+//#endregion
+//#region utils (네임스페이스 내보내기)
+export * as obj from "./utils/obj.js";
+export * as str from "./utils/str.js";
+export * as num from "./utils/num.js";
+export * as bytes from "./utils/bytes.js";
+export * as path from "./utils/path.js";
+export * as json from "./utils/json.js";
+export * as xml from "./utils/xml.js";
+export * as wait from "./utils/wait.js";
+export * as transfer from "./utils/transferable.js";
+export * as err from "./utils/error.js";
+export * as dt from "./utils/date-format.js";
+export * as primitive from "./utils/primitive.js";
+//#endregion
+//#region utils (직접 내보내기)
 export * from "./utils/template-strings.js";
 export * from "./utils/zip.js";
+//#endregion
+//#region 타입 유틸리티
 export * from "./common.types.js";
-export {
-  bytes,
-  dt,
-  err,
-  json,
-  num,
-  obj,
-  path,
-  primitive,
-  str,
-  transfer,
-  wait,
-  xml
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AAGA,OAAO;AACP,OAAO;AACP,OAAO;AAEP,cAAc;AAGd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;AACd,cAAc;AAId,YAAY,SAAS;AACrB,YAAY,SAAS;AACrB,YAAY,SAAS;AACrB,YAAY,WAAW;AACvB,YAAY,UAAU;AACtB,YAAY,UAAU;AACtB,YAAY,SAAS;AACrB,YAAY,UAAU;AACtB,YAAY,cAAc;AAC1B,YAAY,SAAS;AACrB,YAAY,QAAQ;AACpB,YAAY,eAAe;AAI3B,cAAc;AACd,cAAc;AAId,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,cAAc;AAEd,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAE9B,cAAc,OAAO,CAAC;AAEtB,sBAAsB;AACtB,cAAc,sBAAsB,CAAC;AAErC,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,YAAY;AAEZ,eAAe;AACf,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,YAAY;AAEZ,kBAAkB;AAClB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,YAAY;AAEZ,6BAA6B;AAC7B,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,YAAY;AAEZ,yBAAyB;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,YAAY;AAEZ,iBAAiB;AACjB,cAAc,gBAAgB,CAAC;AAC/B,YAAY"}

package/dist/types/date-only.d.ts

@@ -1,8 +1,8 @@
 /**
- * Date class (without time: yyyy-MM-dd, immutable)
+ * 날짜 클래스 (시간 제외: yyyy-MM-dd, 불변)
  *
- * An immutable class that stores only the date without time information.
- * Operates based on local timezone.
+ * 시간 정보 없이 날짜만 저장하는 불변 클래스.
+ * 로컬 타임존 기준으로 동작함.
  *
  * @example
  * const today = new DateOnly();
@@ -12,38 +12,38 @@
 export declare class DateOnly {
     private static readonly MS_PER_DAY;
     readonly date: Date;
-    /** Current time */
+    /** 현재 시간 */
     constructor();
-    /** Initialize with year, month, day */
+    /** 년, 월, 일로 초기화 */
     constructor(year: number, month: number, day: number);
-    /** Create from tick (millisecond) */
+    /** tick (밀리초)으로 생성 */
     constructor(tick: number);
-    /** Create from Date type */
+    /** Date 타입으로 생성 */
     constructor(date: Date);
     /**
-     * Parse a string into DateOnly
-     * @param str Date string
-     * @returns DateOnly instance
+     * 문자열을 DateOnly로 파싱
+     * @param str 날짜 문자열
+     * @returns DateOnly 인스턴스
      *
-     * Supported formats:
-     * - `yyyy-MM-dd` (e.g., '2024-01-15') - Extracted directly from string, timezone-independent
-     * - `yyyyMMdd` (e.g., '20240115') - Extracted directly from string, timezone-independent
-     * - ISO 8601 (e.g., '2024-01-15T00:00:00Z') - Interpreted as UTC, then converted to local timezone
+     * 지원 형식:
+     * - `yyyy-MM-dd` (예: '2024-01-15') - 문자열에서 직접 추출, 타임존 무관
+     * - `yyyyMMdd` (예: '20240115') - 문자열에서 직접 추출, 타임존 무관
+     * - ISO 8601 (예: '2024-01-15T00:00:00Z') - UTC로 해석 후 로컬 타임존으로 변환
      *
-     * @note For different server/client timezones, `yyyy-MM-dd` format is recommended
-     * @note For DST regions when parsing ISO 8601 format, the offset of the parsing target date is used.
+     * @note 서버/클라이언트 타임존이 다른 경우 `yyyy-MM-dd` 형식 권장
+     * @note DST 지역에서 ISO 8601 형식 파싱 시 파싱 대상 날짜의 오프셋이 사용됨.
      */
     static parse(str: string): DateOnly;
     /**
-     * Return the base year and month based on week information
-     * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-     * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-     * @returns Base year and month of the week containing this date
+     * 주차 정보 기반으로 기준 연도와 월 반환
+     * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+     * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+     * @returns 이 날짜가 포함된 주의 기준 연도와 월
      *
      * @example
-     * // ISO 8601 standard (Monday start, first week minimum 4 days)
+     * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
      * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)
-     * // US style (Sunday start, first week minimum 1 day)
+     * // 미국식 (일요일 시작, 첫 주 최소 1일)
      * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)
      */
     getBaseYearMonthSeqForWeekSeq(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -51,23 +51,23 @@ export declare class DateOnly {
         monthSeq: number;
     };
     /**
-     * Calculate the start date of the week based on week information
-     * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-     * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-     * @returns Start date of the week containing this date
+     * 주차 정보 기반으로 해당 주의 시작 날짜 계산
+     * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+     * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+     * @returns 이 날짜가 포함된 주의 시작 날짜
      */
     getWeekSeqStartDate(weekStartDay?: number, minDaysInFirstWeek?: number): DateOnly;
     /**
-     * Return year and week sequence information
-     * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-     * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-     * @returns Year and week number within that year
+     * 연도와 주차 정보 반환
+     * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+     * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+     * @returns 해당 연도와 그 연도 내의 주차 번호
      *
      * @example
-     * // ISO 8601 standard (Monday start, first week minimum 4 days)
+     * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
      * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }
      *
-     * // US style (Sunday start, first week minimum 1 day)
+     * // 미국식 (일요일 시작, 첫 주 최소 1일)
      * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }
      */
     getWeekSeqOfYear(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -75,16 +75,16 @@ export declare class DateOnly {
         weekSeq: number;
     };
     /**
-     * Return year, month and week sequence information for the given date
-     * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-     * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-     * @returns Year, month and week number within that month
+     * 해당 날짜의 연도, 월, 주차 정보 반환
+     * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+     * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+     * @returns 연도, 월, 해당 월 내의 주차 번호
      *
      * @example
-     * // ISO 8601 standard (Monday start, first week minimum 4 days)
+     * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
      * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }
      *
-     * // US style (Sunday start, first week minimum 1 day)
+     * // 미국식 (일요일 시작, 첫 주 최소 1일)
      * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }
      */
     getWeekSeqOfMonth(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -93,58 +93,58 @@ export declare class DateOnly {
         weekSeq: number;
     };
     /**
-     * Get the start date of a week based on week information
-     * @param arg Year, optional month, and week number
-     * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-     * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-     * @returns Start date of the specified week
+     * 주차 정보 기반으로 해당 주의 시작 날짜 반환
+     * @param arg 연도, 선택적 월, 주차 번호
+     * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+     * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+     * @returns 지정된 주의 시작 날짜
      *
      * @example
-     * // Start date of week 2 in 2025 (ISO 8601 standard)
-     * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (Monday)
+     * // 2025년 2주차 시작 날짜 (ISO 8601 표준)
+     * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (월요일)
      *
-     * // Start date of week 3 in January 2025
-     * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (Monday)
+     * // 2025년 1월 3주차 시작 날짜
+     * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (월요일)
      */
     static getDateByYearWeekSeq(arg: {
         year: number;
         month?: number;
         weekSeq: number;
     }, weekStartDay?: number, minDaysInFirstWeek?: number): DateOnly;
-    /** Whether the date is set correctly */
+    /** 날짜가 올바르게 설정되었는지 여부 */
     get isValid(): boolean;
     get year(): number;
     get month(): number;
     get day(): number;
     get tick(): number;
-    /** Day of week (Sunday~Saturday: 0~6) */
+    /** 요일 (일요일~토요일: 0~6) */
     get dayOfWeek(): number;
-    /** Return new instance with specified year */
+    /** 지정된 연도로 새 인스턴스 반환 */
     setYear(year: number): DateOnly;
     /**
-     * Return new DateOnly 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)
+     * 지정된 월로 새 DateOnly 인스턴스 반환
+     * @param month 설정할 월 (1-12, 범위 밖의 값은 연도에서 조정됨)
+     * @note 현재 일이 대상 월의 일수보다 크면 해당 월의 마지막 일로 조정됨
+     *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
      */
     setMonth(month: number): DateOnly;
     /**
-     * Return new DateOnly 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)
+     * 지정된 일로 새 DateOnly 인스턴스 반환
+     * @param day 설정할 일
+     * @note 유효한 월 범위를 벗어나는 일은 JavaScript Date 동작에 따라 자동으로 다음/이전 월로 조정됨
+     *       (예: 1월에 day=32 → 2월 1일)
      */
     setDay(day: number): DateOnly;
-    /** Return new instance with specified years added */
+    /** 지정된 연수를 더한 새 인스턴스 반환 */
     addYears(years: number): DateOnly;
-    /** Return new instance with specified months added */
+    /** 지정된 월수를 더한 새 인스턴스 반환 */
     addMonths(months: number): DateOnly;
-    /** Return new instance with specified days added */
+    /** 지정된 일수를 더한 새 인스턴스 반환 */
     addDays(days: number): DateOnly;
     /**
-     * Convert to string with specified format
-     * @param format Format string
-     * @see dtFormat for supported format strings
+     * 지정된 형식으로 문자열 변환
+     * @param format 형식 문자열
+     * @see dtFormat 지원되는 형식 문자열 참조
      */
     toFormatString(formatStr: string): string;
     toString(): string;

package/dist/types/date-only.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-only.d.ts","sourceRoot":"","sources":["../../src/types/date-only.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,mBAAmB;;IAEnB,uCAAuC;gBAC3B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACpD,qCAAqC;gBACzB,IAAI,EAAE,MAAM;IACxB,4BAA4B;gBAChB,IAAI,EAAE,IAAI;IAiBtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAwCnC;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;;;;IA2BtF;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;IAW5E;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAepC;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBtD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACtD,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU;IAYhC,wCAAwC;IACxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yCAAyC;IACzC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAMD,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAQ7B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,sDAAsD;IACtD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAQ/B;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzC,QAAQ,IAAI,MAAM;CAKnB"}
+{"version":3,"file":"date-only.d.ts","sourceRoot":"","sources":["../../src/types/date-only.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,YAAY;;IAEZ,mBAAmB;gBACP,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACpD,sBAAsB;gBACV,IAAI,EAAE,MAAM;IACxB,mBAAmB;gBACP,IAAI,EAAE,IAAI;IAiBtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAwCnC;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;;;;IA2BtF;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;IAW5E;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAepC;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBtD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACtD,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU;IAYhC,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAMD,wBAAwB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAK/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAQ7B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAQ/B;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzC,QAAQ,IAAI,MAAM;CAKnB"}