@simplysm/core-common 13.0.99 → 14.0.1

package/dist/features/debounce-queue.d.ts

@@ -1,23 +1,23 @@
 /**
- * Asynchronous debounce queue
+ * 비동기 디바운스 큐
  *
- * When called multiple times within a short time, only the last request is executed
- * and previous requests are ignored. Useful for input field auto-complete,
- * batching consecutive state changes, and more.
+ * 짧은 시간 내에 여러 번 호출되면 마지막 요청만 실행하고
+ * 이전 요청은 무시한다. 입력 필드 자동완성,
+ * 연속적인 상태 변경 일괄 처리 등에 유용함.
  *
  * @remarks
- * Requests added during execution are processed immediately after the current execution
- * completes without debounce delay. This is an intentional design to ensure that
- * requests arriving before execution completes are not missed.
+ * 실행 중에 추가된 요청은 디바운스 지연 없이 현재 실행이
+ * 완료된 직후 즉시 처리됨. 이는 실행 완료 전에 도착한
+ * 요청을 놓치지 않기 위한 의도적인 설계임.
  *
  * @example
- * const queue = new DebounceQueue(300); // 300ms delay
- * queue.run(() => console.log("1")); // ignored
- * queue.run(() => console.log("2")); // ignored
- * queue.run(() => console.log("3")); // executed after 300ms
+ * const queue = new DebounceQueue(300); // 300ms 지연
+ * queue.run(() => console.log("1")); // 무시됨
+ * queue.run(() => console.log("2")); // 무시됨
+ * queue.run(() => console.log("3")); // 300ms 후 실행
  *
  * @example
- * // Error handling
+ * // 에러 처리
  * queue.on("error", (err) => console.error(err));
  */
 import { SdError } from "../errors/sd-error";
@@ -33,20 +33,20 @@ export declare class DebounceQueue extends EventEmitter<DebounceQueueEvents> {
     private _isDisposed;
     private _timer;
     /**
-     * @param _delay Debounce delay time (milliseconds). If omitted, executes immediately (next event loop)
+     * @param _delay 디바운스 지연 시간 (밀리초). 생략 시 즉시 실행 (다음 이벤트 루프)
      */
     constructor(_delay?: number | undefined);
     /**
-     * Clean up pending tasks and timers
+     * 대기 중인 작업과 타이머 정리
      */
     dispose(): void;
     /**
-     * Supports using statement
+     * using 문 지원
      */
     [Symbol.dispose](): void;
     /**
-     * Add a function to the queue
-     * If there was a previously added function, it will be replaced
+     * 큐에 함수 추가
+     * 이전에 추가된 함수가 있으면 교체됨
      */
     run(fn: () => void | Promise<void>): void;
     private _processLast;

package/dist/features/debounce-queue.js

@@ -1,80 +1,108 @@
+/**
+ * 비동기 디바운스 큐
+ *
+ * 짧은 시간 내에 여러 번 호출되면 마지막 요청만 실행하고
+ * 이전 요청은 무시한다. 입력 필드 자동완성,
+ * 연속적인 상태 변경 일괄 처리 등에 유용함.
+ *
+ * @remarks
+ * 실행 중에 추가된 요청은 디바운스 지연 없이 현재 실행이
+ * 완료된 직후 즉시 처리됨. 이는 실행 완료 전에 도착한
+ * 요청을 놓치지 않기 위한 의도적인 설계임.
+ *
+ * @example
+ * const queue = new DebounceQueue(300); // 300ms 지연
+ * queue.run(() => console.log("1")); // 무시됨
+ * queue.run(() => console.log("2")); // 무시됨
+ * queue.run(() => console.log("3")); // 300ms 후 실행
+ *
+ * @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";
-class DebounceQueue extends EventEmitter {
-  /**
-   * @param _delay Debounce delay time (milliseconds). If omitted, executes immediately (next event loop)
-   */
-  constructor(_delay) {
-    super();
-    this._delay = _delay;
-  }
-  static _logger = consola.withTag("DebounceQueue");
-  _pendingFn;
-  _isRunning = false;
-  _isDisposed = false;
-  _timer;
-  /**
-   * Clean up pending tasks and timers
-   */
-  dispose() {
-    this._isDisposed = true;
-    if (this._timer) {
-      clearTimeout(this._timer);
-      this._timer = void 0;
+export class DebounceQueue extends EventEmitter {
+    _delay;
+    static _logger = consola.withTag("DebounceQueue");
+    _pendingFn;
+    _isRunning = false;
+    _isDisposed = false;
+    _timer;
+    /**
+     * @param _delay 디바운스 지연 시간 (밀리초). 생략 시 즉시 실행 (다음 이벤트 루프)
+     */
+    constructor(_delay) {
+        super();
+        this._delay = _delay;
     }
-    this._pendingFn = void 0;
-    super.dispose();
-  }
-  /**
-   * Supports using statement
-   */
-  [Symbol.dispose]() {
-    this.dispose();
-  }
-  /**
-   * Add a function to the queue
-   * If there was a previously added function, it will be replaced
-   */
-  run(fn) {
-    if (this._isDisposed) return;
-    this._pendingFn = fn;
-    if (this._timer) {
-      clearTimeout(this._timer);
-      this._timer = void 0;
+    /**
+     * 대기 중인 작업과 타이머 정리
+     */
+    dispose() {
+        this._isDisposed = true;
+        if (this._timer != null) {
+            clearTimeout(this._timer);
+            this._timer = undefined;
+        }
+        this._pendingFn = undefined;
+        super.dispose();
     }
-    if (!this._isRunning) {
-      this._timer = setTimeout(() => {
-        void this._processLast();
-      }, this._delay);
+    /**
+     * using 문 지원
+     */
+    [Symbol.dispose]() {
+        this.dispose();
     }
-  }
-  async _processLast() {
-    if (this._isDisposed || this._isRunning || !this._pendingFn) return;
-    this._isRunning = true;
-    this._timer = void 0;
-    try {
-      while (this._pendingFn) {
-        const currentFn = this._pendingFn;
-        this._pendingFn = void 0;
+    /**
+     * 큐에 함수 추가
+     * 이전에 추가된 함수가 있으면 교체됨
+     */
+    run(fn) {
+        if (this._isDisposed)
+            return;
+        this._pendingFn = fn;
+        if (this._timer != null) {
+            clearTimeout(this._timer);
+            this._timer = undefined;
+        }
+        if (!this._isRunning) {
+            this._timer = setTimeout(() => {
+                void this._processLast();
+            }, this._delay);
+        }
+    }
+    async _processLast() {
+        if (this._isDisposed || this._isRunning || !this._pendingFn)
+            return;
+        this._isRunning = true;
+        this._timer = undefined;
         try {
-          await currentFn();
-        } catch (err) {
-          const error = err instanceof Error ? err : new Error(String(err));
-          const sdError = new SdError(error, "Error occurred while executing task");
-          if (this.listenerCount("error") > 0) {
-            this.emit("error", sdError);
-          } else {
-            DebounceQueue._logger.error(sdError);
-          }
+            // 실행 중에 새 요청이 들어오면 디바운스 지연 없이 즉시 처리
+            // 실행 완료 전에 도착한 요청을 실행 직후 즉시 처리하기 위한 의도적인 설계
+            while (this._pendingFn) {
+                const currentFn = this._pendingFn;
+                this._pendingFn = undefined;
+                try {
+                    await currentFn();
+                }
+                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 {
+                        DebounceQueue._logger.error(sdError);
+                    }
+                }
+            }
+        }
+        finally {
+            this._isRunning = false;
         }
-      }
-    } finally {
-      this._isRunning = false;
     }
-  }
 }
-export {
-  DebounceQueue
-};
-//# sourceMappingURL=debounce-queue.js.map
+//# sourceMappingURL=debounce-queue.js.map

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

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/features/debounce-queue.ts"],
-  "mappings": "AAsBA,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,OAAO,aAAa;AAMb,MAAM,sBAAsB,aAAkC;AAAA;AAAA;AAAA;AAAA,EAWnE,YAA6B,QAAiB;AAC5C,UAAM;AADqB;AAAA,EAE7B;AAAA,EAZA,OAAwB,UAAU,QAAQ,QAAQ,eAAe;AAAA,EAEzD;AAAA,EACA,aAAa;AAAA,EACb,cAAc;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAYC,UAAgB;AACvB,SAAK,cAAc;AACnB,QAAI,KAAK,QAAQ;AACf,mBAAa,KAAK,MAAM;AACxB,WAAK,SAAS;AAAA,IAChB;AACA,SAAK,aAAa;AAClB,UAAM,QAAQ;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,CAAU,OAAO,OAAO,IAAU;AAChC,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,IAAsC;AACxC,QAAI,KAAK,YAAa;AAEtB,SAAK,aAAa;AAElB,QAAI,KAAK,QAAQ;AACf,mBAAa,KAAK,MAAM;AACxB,WAAK,SAAS;AAAA,IAChB;AAEA,QAAI,CAAC,KAAK,YAAY;AACpB,WAAK,SAAS,WAAW,MAAM;AAC7B,aAAK,KAAK,aAAa;AAAA,MACzB,GAAG,KAAK,MAAM;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,MAAc,eAA8B;AAC1C,QAAI,KAAK,eAAe,KAAK,cAAc,CAAC,KAAK,WAAY;AAE7D,SAAK,aAAa;AAClB,SAAK,SAAS;AAEd,QAAI;AAGF,aAAO,KAAK,YAAY;AACtB,cAAM,YAAY,KAAK;AACvB,aAAK,aAAa;AAElB,YAAI;AACF,gBAAM,UAAU;AAAA,QAClB,SAAS,KAAK;AACZ,gBAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,gBAAM,UAAU,IAAI,QAAQ,OAAO,qCAAqC;AAGxE,cAAI,KAAK,cAAc,OAAO,IAAI,GAAG;AACnC,iBAAK,KAAK,SAAS,OAAO;AAAA,UAC5B,OAAO;AACL,0BAAc,QAAQ,MAAM,OAAO;AAAA,UACrC;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,WAAK,aAAa;AAAA,IACpB;AAAA,EACF;AACF;",
-  "names": []
-}
+{"version":3,"file":"debounce-queue.js","sourceRoot":"","sources":["../../src/features/debounce-queue.ts"],"names":[],"mappings":"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"}

package/dist/features/event-emitter.d.ts

@@ -1,10 +1,10 @@
 /**
- * EventTarget wrapper - provides EventEmitter-like API
+ * EventTarget 래퍼 - EventEmitter와 유사한 API 제공
  *
- * A type-safe event emitter that can be used in both browsers and Node.js.
- * Internally implemented using EventTarget.
+ * 브라우저와 Node.js 모두에서 사용 가능한 타입 안전한 이벤트 이미터.
+ * 내부적으로 EventTarget을 사용하여 구현됨.
  *
- * @typeParam TEvents Event type map. Keys are event names, values are event data types
+ * @typeParam TEvents 이벤트 타입 맵. key는 이벤트 이름, value는 이벤트 데이터 타입
  *
  * @example
  * interface MyEvents {
@@ -18,7 +18,7 @@
  * const emitter = new MyEmitter();
  * emitter.on("data", (data) => console.log(data)); // data: string
  * emitter.emit("data", "hello");
- * emitter.emit("done"); // void type is called without arguments
+ * emitter.emit("done"); // void 타입은 인자 없이 호출
  */
 export declare class EventEmitter<TEvents extends {
     [K in keyof TEvents]: unknown;
@@ -26,40 +26,40 @@ export declare class EventEmitter<TEvents extends {
     private readonly _target;
     private readonly _listenerMap;
     /**
-     * Register an event listener
+     * 이벤트 리스너 등록
      *
-     * @param type Event type
-     * @param listener Event handler
-     * @note Duplicate registration of the same listener to the same event is ignored
+     * @param type 이벤트 타입
+     * @param listener 이벤트 핸들러
+     * @note 같은 리스너를 같은 이벤트에 중복 등록하면 무시됨
      */
     on<TEventName extends keyof TEvents & string>(type: TEventName, listener: (data: TEvents[TEventName]) => void): void;
     /**
-     * Remove an event listener
+     * 이벤트 리스너 제거
      *
-     * @param type Event type
-     * @param listener Event handler to remove
+     * @param type 이벤트 타입
+     * @param listener 제거할 이벤트 핸들러
      */
     off<TEventName extends keyof TEvents & string>(type: TEventName, listener: (data: TEvents[TEventName]) => void): void;
     /**
-     * Emit an event
+     * 이벤트 발행
      *
-     * @param type Event type
-     * @param args Event data (omitted if void type)
+     * @param type 이벤트 타입
+     * @param args 이벤트 데이터 (void 타입이면 생략)
      */
     emit<TEventName extends keyof TEvents & string>(type: TEventName, ...args: TEvents[TEventName] extends void ? [] : [data: TEvents[TEventName]]): void;
     /**
-     * Return the number of listeners for a specific event
+     * 특정 이벤트의 리스너 수 반환
      *
-     * @param type Event type
-     * @returns Number of registered listeners
+     * @param type 이벤트 타입
+     * @returns 등록된 리스너 수
      */
     listenerCount<TEventName extends keyof TEvents & string>(type: TEventName): number;
     /**
-     * Remove all event listeners
+     * 모든 이벤트 리스너 제거
      */
     dispose(): void;
     /**
-     * Supports using statement
+     * using 문 지원
      */
     [Symbol.dispose](): void;
 }

package/dist/features/event-emitter.js

@@ -1,82 +1,105 @@
-class EventEmitter {
-  _target = new EventTarget();
-  // Manage listener maps by event type (same listener can be registered to different events)
-  // Use Function type for polymorphic listener management
-  _listenerMap = /* @__PURE__ */ new Map();
-  /**
-   * Register an event listener
-   *
-   * @param type Event type
-   * @param listener Event handler
-   * @note Duplicate registration of the same listener to the same event is ignored
-   */
-  on(type, listener) {
-    let typeMap = this._listenerMap.get(type);
-    if (!typeMap) {
-      typeMap = /* @__PURE__ */ new Map();
-      this._listenerMap.set(type, typeMap);
+/**
+ * EventTarget 래퍼 - EventEmitter와 유사한 API 제공
+ *
+ * 브라우저와 Node.js 모두에서 사용 가능한 타입 안전한 이벤트 이미터.
+ * 내부적으로 EventTarget을 사용하여 구현됨.
+ *
+ * @typeParam TEvents 이벤트 타입 맵. key는 이벤트 이름, value는 이벤트 데이터 타입
+ *
+ * @example
+ * interface MyEvents {
+ *   data: string;
+ *   error: Error;
+ *   done: void;
+ * }
+ *
+ * class MyEmitter extends EventEmitter<MyEvents> {}
+ *
+ * const emitter = new MyEmitter();
+ * emitter.on("data", (data) => console.log(data)); // data: string
+ * emitter.emit("data", "hello");
+ * emitter.emit("done"); // void 타입은 인자 없이 호출
+ */
+export class EventEmitter {
+    _target = new EventTarget();
+    // 이벤트 타입별 리스너 맵 관리 (같은 리스너를 다른 이벤트에 등록 가능)
+    // 다형성 리스너 관리를 위해 Function 타입 사용
+    _listenerMap = new Map();
+    /**
+     * 이벤트 리스너 등록
+     *
+     * @param type 이벤트 타입
+     * @param listener 이벤트 핸들러
+     * @note 같은 리스너를 같은 이벤트에 중복 등록하면 무시됨
+     */
+    on(type, listener) {
+        // 이벤트 타입에 대한 맵 조회 또는 생성
+        let typeMap = this._listenerMap.get(type);
+        if (!typeMap) {
+            typeMap = new Map();
+            this._listenerMap.set(type, typeMap);
+        }
+        // 이 이벤트에 이미 등록된 리스너이면 무시 (중복 등록 방지)
+        if (typeMap.has(listener))
+            return;
+        const wrappedListener = (e) => listener(e.detail);
+        typeMap.set(listener, wrappedListener);
+        this._target.addEventListener(type, wrappedListener);
     }
-    if (typeMap.has(listener)) return;
-    const wrappedListener = (e) => listener(e.detail);
-    typeMap.set(listener, wrappedListener);
-    this._target.addEventListener(type, wrappedListener);
-  }
-  /**
-   * Remove an event listener
-   *
-   * @param type Event type
-   * @param listener Event handler to remove
-   */
-  off(type, listener) {
-    const typeMap = this._listenerMap.get(type);
-    if (!typeMap) return;
-    const wrappedListener = typeMap.get(listener);
-    if (wrappedListener) {
-      this._target.removeEventListener(type, wrappedListener);
-      typeMap.delete(listener);
-      if (typeMap.size === 0) {
-        this._listenerMap.delete(type);
-      }
+    /**
+     * 이벤트 리스너 제거
+     *
+     * @param type 이벤트 타입
+     * @param listener 제거할 이벤트 핸들러
+     */
+    off(type, listener) {
+        const typeMap = this._listenerMap.get(type);
+        if (!typeMap)
+            return;
+        const wrappedListener = typeMap.get(listener);
+        if (wrappedListener) {
+            this._target.removeEventListener(type, wrappedListener);
+            typeMap.delete(listener);
+            // 빈 맵 정리
+            if (typeMap.size === 0) {
+                this._listenerMap.delete(type);
+            }
+        }
     }
-  }
-  /**
-   * Emit an event
-   *
-   * @param type Event type
-   * @param args Event data (omitted if void type)
-   */
-  emit(type, ...args) {
-    this._target.dispatchEvent(new CustomEvent(type, { detail: args[0] }));
-  }
-  /**
-   * Return the number of listeners for a specific event
-   *
-   * @param type Event type
-   * @returns Number of registered listeners
-   */
-  listenerCount(type) {
-    var _a;
-    return ((_a = this._listenerMap.get(type)) == null ? void 0 : _a.size) ?? 0;
-  }
-  /**
-   * Remove all event listeners
-   */
-  dispose() {
-    for (const [type, typeMap] of this._listenerMap) {
-      for (const wrappedListener of typeMap.values()) {
-        this._target.removeEventListener(type, wrappedListener);
-      }
+    /**
+     * 이벤트 발행
+     *
+     * @param type 이벤트 타입
+     * @param args 이벤트 데이터 (void 타입이면 생략)
+     */
+    emit(type, ...args) {
+        this._target.dispatchEvent(new CustomEvent(type, { detail: args[0] }));
+    }
+    /**
+     * 특정 이벤트의 리스너 수 반환
+     *
+     * @param type 이벤트 타입
+     * @returns 등록된 리스너 수
+     */
+    listenerCount(type) {
+        return this._listenerMap.get(type)?.size ?? 0;
+    }
+    /**
+     * 모든 이벤트 리스너 제거
+     */
+    dispose() {
+        for (const [type, typeMap] of this._listenerMap) {
+            for (const wrappedListener of typeMap.values()) {
+                this._target.removeEventListener(type, wrappedListener);
+            }
+        }
+        this._listenerMap.clear();
+    }
+    /**
+     * using 문 지원
+     */
+    [Symbol.dispose]() {
+        this.dispose();
     }
-    this._listenerMap.clear();
-  }
-  /**
-   * Supports using statement
-   */
-  [Symbol.dispose]() {
-    this.dispose();
-  }
 }
-export {
-  EventEmitter
-};
-//# sourceMappingURL=event-emitter.js.map
+//# sourceMappingURL=event-emitter.js.map

package/dist/features/event-emitter.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/features/event-emitter.ts"],
-  "mappings": "AAsBO,MAAM,aAEX;AAAA,EACiB,UAAU,IAAI,YAAY;AAAA;AAAA;AAAA,EAG1B,eAAe,oBAAI,IAA+C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASnF,GAA8C,MAAkB,UAAqD;AAEnH,QAAI,UAAU,KAAK,aAAa,IAAI,IAAI;AACxC,QAAI,CAAC,SAAS;AACZ,gBAAU,oBAAI,IAAI;AAClB,WAAK,aAAa,IAAI,MAAM,OAAO;AAAA,IACrC;AAGA,QAAI,QAAQ,IAAI,QAAQ,EAAG;AAE3B,UAAM,kBAAkB,CAAC,MAAa,SAAU,EAAkB,MAAM;AACxE,YAAQ,IAAI,UAAU,eAAe;AACrC,SAAK,QAAQ,iBAAiB,MAAM,eAAe;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAA+C,MAAkB,UAAqD;AACpH,UAAM,UAAU,KAAK,aAAa,IAAI,IAAI;AAC1C,QAAI,CAAC,QAAS;AAEd,UAAM,kBAAkB,QAAQ,IAAI,QAAQ;AAC5C,QAAI,iBAAiB;AACnB,WAAK,QAAQ,oBAAoB,MAAM,eAAe;AACtD,cAAQ,OAAO,QAAQ;AAGvB,UAAI,QAAQ,SAAS,GAAG;AACtB,aAAK,aAAa,OAAO,IAAI;AAAA,MAC/B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,KACE,SACG,MACG;AACN,SAAK,QAAQ,cAAc,IAAI,YAAY,MAAM,EAAE,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAyD,MAA0B;AA9FrF;AA+FI,aAAO,UAAK,aAAa,IAAI,IAAI,MAA1B,mBAA6B,SAAQ;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,eAAW,CAAC,MAAM,OAAO,KAAK,KAAK,cAAc;AAC/C,iBAAW,mBAAmB,QAAQ,OAAO,GAAG;AAC9C,aAAK,QAAQ,oBAAoB,MAAM,eAAe;AAAA,MACxD;AAAA,IACF;AACA,SAAK,aAAa,MAAM;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,CAAC,OAAO,OAAO,IAAU;AACvB,SAAK,QAAQ;AAAA,EACf;AACF;",
-  "names": []
-}
+{"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../../src/features/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,YAAY;IAGN,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7C,2CAA2C;IAC3C,gCAAgC;IACf,YAAY,GAAG,IAAI,GAAG,EAA6C,CAAC;IAErF;;;;;;OAMG;IACH,EAAE,CAA4C,IAAgB,EAAE,QAA6C;QAC3G,wBAAwB;QACxB,IAAI,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAElC,MAAM,eAAe,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,QAAQ,CAAE,CAAiB,CAAC,MAAM,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAA4C,IAAgB,EAAE,QAA6C;QAC5G,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAEzB,SAAS;YACT,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,IAAgB,EAChB,GAAG,IAAyE;QAE5E,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAA4C,IAAgB;QACvE,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAChD,KAAK,MAAM,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;CACF"}

package/dist/features/serial-queue.d.ts

@@ -1,18 +1,18 @@
 /**
- * Asynchronous serial queue
+ * 비동기 직렬 큐
  *
- * Functions added to the queue are executed sequentially.
- * The next task starts only after one task completes.
- * Subsequent tasks continue to execute even if an error occurs.
+ * 큐에 추가된 함수들은 순차적으로 실행됨.
+ * 하나의 작업이 완료된 후에야 다음 작업이 시작됨.
+ * 에러가 발생해도 후속 작업은 계속 실행됨.
  *
  * @example
  * const queue = new SerialQueue();
  * queue.run(async () => { await fetch("/api/1"); });
- * queue.run(async () => { await fetch("/api/2"); }); // executed after 1 completes
- * queue.run(async () => { await fetch("/api/3"); }); // executed after 2 completes
+ * queue.run(async () => { await fetch("/api/2"); }); // 1 완료 후 실행
+ * queue.run(async () => { await fetch("/api/3"); }); // 2 완료 후 실행
  *
  * @example
- * // Error handling
+ * // 에러 처리
  * queue.on("error", (err) => console.error(err));
  */
 import { SdError } from "../errors/sd-error";
@@ -26,19 +26,19 @@ export declare class SerialQueue extends EventEmitter<SerialQueueEvents> {
     private readonly _queue;
     private _isQueueRunning;
     /**
-     * @param _gap Gap between each task (ms)
+     * @param _gap 각 작업 사이의 간격 (ms)
      */
     constructor(_gap?: number);
     /**
-     * Clear pending queue (currently executing task will complete)
+     * 대기 중인 큐 비우기 (현재 실행 중인 작업은 완료됨)
      */
     dispose(): void;
     /**
-     * Supports using statement
+     * using 문 지원
      */
     [Symbol.dispose](): void;
     /**
-     * Add a function to the queue and execute it
+     * 큐에 함수를 추가하고 실행
      */
     run(fn: () => void | Promise<void>): void;
     private _process;