@simplysm/core-common 13.0.99 → 14.0.1

package/dist/utils/transferable.d.ts

@@ -1,46 +1,46 @@
 /**
- * Object types that can be transferred between Workers
+ * Worker 간 전송 가능한 객체 타입
  *
- * Only ArrayBuffer is used in this code.
+ * 이 코드에서는 ArrayBuffer만 사용됨.
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Transferable_objects
  */
 type Transferable = ArrayBuffer;
 /**
- * Transferable conversion utility functions
+ * Transferable 변환 유틸리티 함수
  *
- * Performs serialization/deserialization for data transfer between Workers.
- * Handles custom types that structuredClone does not support.
+ * Worker 간 데이터 전송을 위한 직렬화/역직렬화 수행.
+ * structuredClone이 지원하지 않는 커스텀 타입을 처리.
  *
- * Supported types:
+ * 지원 타입:
  * - Date, DateTime, DateOnly, Time, Uuid, RegExp
- * - Error (including cause, code, detail)
- * - Uint8Array (other TypedArrays not supported, handled as plain objects)
- * - Array, Map, Set, plain objects
+ * - Error (cause, code, detail 포함)
+ * - Uint8Array (다른 TypedArray는 지원하지 않으며 일반 객체로 처리)
+ * - Array, Map, Set, 일반 객체
  *
- * @note Circular references cause TypeError in transferableEncode (includes path info)
- * @note If the same object is referenced from multiple places, the cached encoding result is reused
+ * @note 순환 참조 시 transferableEncode에서 TypeError 발생 (경로 정보 포함)
+ * @note 같은 객체가 여러 곳에서 참조되면 캐싱된 인코딩 결과를 재사용
  *
  * @example
- * // Send data to Worker
+ * // Worker로 데이터 전송
  * const { result, transferList } = transferableEncode(data);
  * worker.postMessage(result, transferList);
  *
- * // Receive data from Worker
+ * // Worker에서 데이터 수신
  * const decoded = decode(event.data);
  */
 /**
- * Convert objects using Simplysm types to plain objects
- * Serializes in a form that can be sent to a Worker
+ * Simplysm 타입을 사용하는 객체를 일반 객체로 변환
+ * Worker로 전송 가능한 형태로 직렬화
  *
- * @throws TypeError if circular reference is detected
+ * @throws TypeError 순환 참조가 감지된 경우
  */
 export declare function encode(obj: unknown): {
     result: unknown;
     transferList: Transferable[];
 };
 /**
- * Convert serialized objects to objects using Simplysm types
- * Deserialize data received from a Worker
+ * 직렬화된 객체를 Simplysm 타입을 사용하는 객체로 변환
+ * Worker에서 수신한 데이터 역직렬화
  */
 export declare function decode(obj: unknown): unknown;
 export {};

package/dist/utils/transferable.js

@@ -2,166 +2,233 @@ import { DateTime } from "../types/date-time.js";
 import { DateOnly } from "../types/date-only.js";
 import { Time } from "../types/time.js";
 import { Uuid } from "../types/uuid.js";
-function encode(obj) {
-  const transferList = [];
-  const ancestors = /* @__PURE__ */ new Set();
-  const cache = /* @__PURE__ */ new Map();
-  const result = encodeImpl(obj, transferList, [], ancestors, cache);
-  return { result, transferList };
+/**
+ * Transferable 변환 유틸리티 함수
+ *
+ * Worker 간 데이터 전송을 위한 직렬화/역직렬화 수행.
+ * structuredClone이 지원하지 않는 커스텀 타입을 처리.
+ *
+ * 지원 타입:
+ * - Date, DateTime, DateOnly, Time, Uuid, RegExp
+ * - Error (cause, code, detail 포함)
+ * - Uint8Array (다른 TypedArray는 지원하지 않으며 일반 객체로 처리)
+ * - Array, Map, Set, 일반 객체
+ *
+ * @note 순환 참조 시 transferableEncode에서 TypeError 발생 (경로 정보 포함)
+ * @note 같은 객체가 여러 곳에서 참조되면 캐싱된 인코딩 결과를 재사용
+ *
+ * @example
+ * // Worker로 데이터 전송
+ * const { result, transferList } = transferableEncode(data);
+ * worker.postMessage(result, transferList);
+ *
+ * // Worker에서 데이터 수신
+ * const decoded = decode(event.data);
+ */
+//#region encode
+/**
+ * Simplysm 타입을 사용하는 객체를 일반 객체로 변환
+ * Worker로 전송 가능한 형태로 직렬화
+ *
+ * @throws TypeError 순환 참조가 감지된 경우
+ */
+export function encode(obj) {
+    const transferList = [];
+    const ancestors = new Set();
+    const cache = new Map();
+    const result = encodeImpl(obj, transferList, [], ancestors, cache);
+    return { result, transferList };
 }
 function encodeImpl(obj, transferList, path, ancestors, cache) {
-  if (obj == null) return obj;
-  if (typeof obj === "object") {
-    if (ancestors.has(obj)) {
-      const currentPath = path.length > 0 ? path.join(".") : "root";
-      throw new TypeError(`Circular reference detected: ${currentPath}`);
-    }
-    const cached = cache.get(obj);
-    if (cached !== void 0) return cached;
-    ancestors.add(obj);
-  }
-  let result;
-  try {
-    if (obj instanceof Uint8Array) {
-      const isSharedArrayBuffer = typeof SharedArrayBuffer !== "undefined" && obj.buffer instanceof SharedArrayBuffer;
-      const buffer = obj.buffer;
-      if (!isSharedArrayBuffer && !transferList.includes(buffer)) {
-        transferList.push(buffer);
-      }
-      result = obj;
-    } else if (obj instanceof Date) {
-      result = { __type__: "Date", data: obj.getTime() };
-    } else if (obj instanceof DateTime) {
-      result = { __type__: "DateTime", data: obj.tick };
-    } else if (obj instanceof DateOnly) {
-      result = { __type__: "DateOnly", data: obj.tick };
-    } else if (obj instanceof Time) {
-      result = { __type__: "Time", data: obj.tick };
-    } else if (obj instanceof Uuid) {
-      result = { __type__: "Uuid", data: obj.toString() };
-    } else if (obj instanceof RegExp) {
-      result = { __type__: "RegExp", data: { source: obj.source, flags: obj.flags } };
-    } else if (obj instanceof Error) {
-      const errObj = obj;
-      result = {
-        __type__: "Error",
-        data: {
-          name: errObj.name,
-          message: errObj.message,
-          stack: errObj.stack,
-          ...errObj.code !== void 0 ? { code: errObj.code } : {},
-          ...errObj.detail !== void 0 ? {
-            detail: encodeImpl(
-              errObj.detail,
-              transferList,
-              [...path, "detail"],
-              ancestors,
-              cache
-            )
-          } : {},
-          ...errObj.cause !== void 0 ? {
-            cause: encodeImpl(errObj.cause, transferList, [...path, "cause"], ancestors, cache)
-          } : {}
-        }
-      };
-    } else if (Array.isArray(obj)) {
-      result = obj.map(
-        (item, idx) => encodeImpl(item, transferList, [...path, idx], ancestors, cache)
-      );
-    } else if (obj instanceof Map) {
-      let idx = 0;
-      result = new Map(
-        Array.from(obj.entries()).map(([k, v]) => {
-          const keyPath = [...path, `Map[${idx}].key`];
-          const valuePath = [...path, `Map[${idx}].value`];
-          idx++;
-          return [
-            encodeImpl(k, transferList, keyPath, ancestors, cache),
-            encodeImpl(v, transferList, valuePath, ancestors, cache)
-          ];
-        })
-      );
-    } else if (obj instanceof Set) {
-      let idx = 0;
-      result = new Set(
-        Array.from(obj).map(
-          (v) => encodeImpl(v, transferList, [...path, `Set[${idx++}]`], ancestors, cache)
-        )
-      );
-    } else if (typeof obj === "object") {
-      const res = {};
-      const record = obj;
-      for (const key of Object.keys(record)) {
-        res[key] = encodeImpl(record[key], transferList, [...path, key], ancestors, cache);
-      }
-      result = res;
-    } else {
-      return obj;
-    }
+    if (obj == null)
+        return obj;
+    // 객체 타입 처리: 순환 참조 감지 + 캐시
     if (typeof obj === "object") {
-      cache.set(obj, result);
+        // 순환 참조 감지 (현재 재귀 스택에 있는 객체)
+        if (ancestors.has(obj)) {
+            const currentPath = path.length > 0 ? path.join(".") : "root";
+            throw new TypeError(`순환 참조 감지됨: ${currentPath}`);
+        }
+        // 이미 인코딩된 객체이면 캐싱된 결과 재사용
+        const cached = cache.get(obj);
+        if (cached !== undefined)
+            return cached;
+        // 재귀 스택에 추가
+        ancestors.add(obj);
     }
-    return result;
-  } finally {
-    if (typeof obj === "object") {
-      ancestors.delete(obj);
+    let result;
+    try {
+        // 1. Uint8Array
+        if (obj instanceof Uint8Array) {
+            // SharedArrayBuffer는 이미 공유 메모리이므로 transferList에 추가하지 않음
+            // zero-copy 전송을 위해 ArrayBuffer만 transferList에 추가
+            const isSharedArrayBuffer = typeof SharedArrayBuffer !== "undefined" && obj.buffer instanceof SharedArrayBuffer;
+            const buffer = obj.buffer;
+            if (!isSharedArrayBuffer && !transferList.includes(buffer)) {
+                transferList.push(buffer);
+            }
+            result = obj;
+        }
+        // 2. 특수 타입 변환 (JSON.stringify 없이 태그된 객체로 변환)
+        else if (obj instanceof Date) {
+            result = { __type__: "Date", data: obj.getTime() };
+        }
+        else if (obj instanceof DateTime) {
+            result = { __type__: "DateTime", data: obj.tick };
+        }
+        else if (obj instanceof DateOnly) {
+            result = { __type__: "DateOnly", data: obj.tick };
+        }
+        else if (obj instanceof Time) {
+            result = { __type__: "Time", data: obj.tick };
+        }
+        else if (obj instanceof Uuid) {
+            result = { __type__: "Uuid", data: obj.toString() };
+        }
+        else if (obj instanceof RegExp) {
+            result = { __type__: "RegExp", data: { source: obj.source, flags: obj.flags } };
+        }
+        else if (obj instanceof Error) {
+            const errObj = obj;
+            result = {
+                __type__: "Error",
+                data: {
+                    name: errObj.name,
+                    message: errObj.message,
+                    stack: errObj.stack,
+                    ...(errObj.code !== undefined ? { code: errObj.code } : {}),
+                    ...(errObj.detail !== undefined
+                        ? {
+                            detail: encodeImpl(errObj.detail, transferList, [...path, "detail"], ancestors, cache),
+                        }
+                        : {}),
+                    ...(errObj.cause !== undefined
+                        ? {
+                            cause: encodeImpl(errObj.cause, transferList, [...path, "cause"], ancestors, cache),
+                        }
+                        : {}),
+                },
+            };
+        }
+        // 3. Array 재귀
+        else if (Array.isArray(obj)) {
+            result = obj.map((item, idx) => encodeImpl(item, transferList, [...path, idx], ancestors, cache));
+        }
+        // 4. Map 재귀
+        else if (obj instanceof Map) {
+            let idx = 0;
+            result = new Map(Array.from(obj.entries()).map(([k, v]) => {
+                const keyPath = [...path, `Map[${idx}].key`];
+                const valuePath = [...path, `Map[${idx}].value`];
+                idx++;
+                return [
+                    encodeImpl(k, transferList, keyPath, ancestors, cache),
+                    encodeImpl(v, transferList, valuePath, ancestors, cache),
+                ];
+            }));
+        }
+        // 5. Set 재귀
+        else if (obj instanceof Set) {
+            let idx = 0;
+            result = new Set(Array.from(obj).map((v) => encodeImpl(v, transferList, [...path, `Set[${idx++}]`], ancestors, cache)));
+        }
+        // 6. 일반 객체 재귀
+        else if (typeof obj === "object") {
+            const res = {};
+            const record = obj;
+            for (const key of Object.keys(record)) {
+                res[key] = encodeImpl(record[key], transferList, [...path, key], ancestors, cache);
+            }
+            result = res;
+        }
+        // 7. 원시 타입
+        else {
+            return obj;
+        }
+        // 캐시에 저장 (성공 시에만)
+        if (typeof obj === "object") {
+            cache.set(obj, result);
+        }
+        return result;
+    }
+    finally {
+        // 재귀 스택에서 제거 (예외 발생 시에도 반드시 실행)
+        if (typeof obj === "object") {
+            ancestors.delete(obj);
+        }
     }
-  }
 }
-function decode(obj) {
-  if (obj == null) return obj;
-  if (typeof obj === "object" && "__type__" in obj && "data" in obj) {
-    const typed = obj;
-    const data = typed.data;
-    if (typed.__type__ === "Date" && typeof data === "number") return new Date(data);
-    if (typed.__type__ === "DateTime" && typeof data === "number") return new DateTime(data);
-    if (typed.__type__ === "DateOnly" && typeof data === "number") return new DateOnly(data);
-    if (typed.__type__ === "Time" && typeof data === "number") return new Time(data);
-    if (typed.__type__ === "Uuid" && typeof data === "string") return new Uuid(data);
-    if (typed.__type__ === "RegExp" && typeof data === "object" && data !== null) {
-      const regexData = data;
-      return new RegExp(regexData.source, regexData.flags);
+//#endregion
+//#region decode
+/**
+ * 직렬화된 객체를 Simplysm 타입을 사용하는 객체로 변환
+ * Worker에서 수신한 데이터 역직렬화
+ */
+export function decode(obj) {
+    if (obj == null)
+        return obj;
+    // 1. 태그된 객체에서 특수 타입 복원
+    if (typeof obj === "object" && "__type__" in obj && "data" in obj) {
+        const typed = obj;
+        const data = typed.data;
+        if (typed.__type__ === "Date" && typeof data === "number")
+            return new Date(data);
+        if (typed.__type__ === "DateTime" && typeof data === "number")
+            return new DateTime(data);
+        if (typed.__type__ === "DateOnly" && typeof data === "number")
+            return new DateOnly(data);
+        if (typed.__type__ === "Time" && typeof data === "number")
+            return new Time(data);
+        if (typed.__type__ === "Uuid" && typeof data === "string")
+            return new Uuid(data);
+        if (typed.__type__ === "RegExp" && typeof data === "object" && data !== null) {
+            const regexData = data;
+            return new RegExp(regexData.source, regexData.flags);
+        }
+        if (typed.__type__ === "Error" && typeof data === "object" && data !== null) {
+            const errorData = data;
+            const err = new Error(errorData.message);
+            err.name = errorData.name;
+            err.stack = errorData.stack;
+            if (errorData.code !== undefined)
+                err.code = errorData.code;
+            if (errorData.cause !== undefined)
+                err.cause = decode(errorData.cause);
+            if (errorData.detail !== undefined)
+                err.detail = decode(errorData.detail);
+            return err;
+        }
     }
-    if (typed.__type__ === "Error" && typeof data === "object" && data !== null) {
-      const errorData = data;
-      const err = new Error(errorData.message);
-      err.name = errorData.name;
-      err.stack = errorData.stack;
-      if (errorData.code !== void 0) err.code = errorData.code;
-      if (errorData.cause !== void 0) err.cause = decode(errorData.cause);
-      if (errorData.detail !== void 0) err.detail = decode(errorData.detail);
-      return err;
+    // 2. Array 재귀
+    if (Array.isArray(obj)) {
+        return obj.map((item) => decode(item));
     }
-  }
-  if (Array.isArray(obj)) {
-    return obj.map((item) => decode(item));
-  }
-  if (obj instanceof Map) {
-    const newMap = /* @__PURE__ */ new Map();
-    for (const [k, v] of obj) {
-      newMap.set(decode(k), decode(v));
+    // 3. Map 재귀
+    if (obj instanceof Map) {
+        const newMap = new Map();
+        for (const [k, v] of obj) {
+            newMap.set(decode(k), decode(v));
+        }
+        return newMap;
     }
-    return newMap;
-  }
-  if (obj instanceof Set) {
-    const newSet = /* @__PURE__ */ new Set();
-    for (const v of obj) {
-      newSet.add(decode(v));
+    // 4. Set 재귀
+    if (obj instanceof Set) {
+        const newSet = new Set();
+        for (const v of obj) {
+            newSet.add(decode(v));
+        }
+        return newSet;
     }
-    return newSet;
-  }
-  if (typeof obj === "object") {
-    const record = obj;
-    const result = {};
-    for (const key of Object.keys(record)) {
-      result[key] = decode(record[key]);
+    // 5. 객체 재귀
+    if (typeof obj === "object") {
+        const record = obj;
+        const result = {};
+        for (const key of Object.keys(record)) {
+            result[key] = decode(record[key]);
+        }
+        return result;
     }
-    return result;
-  }
-  return obj;
+    return obj;
 }
-export {
-  decode,
-  encode
-};
-//# sourceMappingURL=transferable.js.map
+//#endregion
+//# sourceMappingURL=transferable.js.map

package/dist/utils/transferable.js.map

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

package/dist/utils/wait.d.ts

@@ -1,19 +1,19 @@
 /**
- * Wait until a condition becomes true
- * @param forwarder Condition function
- * @param milliseconds Check interval (default: 100ms)
- * @param maxCount Maximum number of attempts (undefined for unlimited)
+ * 조건이 true가 될 때까지 대기
+ * @param forwarder 조건 함수
+ * @param milliseconds 확인 간격 (기본값: 100ms)
+ * @param maxCount 최대 시도 횟수 (undefined이면 무제한)
  *
- * @note Returns immediately if the condition is true on the first call.
+ * @note 첫 번째 호출에서 조건이 true이면 즉시 반환.
  * @example
- * // maxCount=3: checks condition up to 3 times, throws TimeoutError if all are false
+ * // maxCount=3: 최대 3번 조건 확인, 모두 false이면 TimeoutError 발생
  * await waitUntil(() => someCondition, 100, 3);
- * @throws TimeoutError when maximum number of attempts is exceeded
+ * @throws TimeoutError 최대 시도 횟수를 초과했을 때
  */
 export declare function until(forwarder: () => boolean | Promise<boolean>, milliseconds?: number, maxCount?: number): Promise<void>;
 /**
- * Wait for a specified amount of time
- * @param millisecond Wait time (ms)
+ * 지정된 시간만큼 대기
+ * @param millisecond 대기 시간 (ms)
  */
 export declare function time(millisecond: number): Promise<void>;
 //# sourceMappingURL=wait.d.ts.map

package/dist/utils/wait.js

@@ -1,19 +1,34 @@
+/**
+ * 대기 유틸리티 함수
+ */
 import { TimeoutError } from "../errors/timeout-error.js";
-async function until(forwarder, milliseconds, maxCount) {
-  let count = 0;
-  while (!await forwarder()) {
-    count++;
-    if (maxCount !== void 0 && count >= maxCount) {
-      throw new TimeoutError(count);
+/**
+ * 조건이 true가 될 때까지 대기
+ * @param forwarder 조건 함수
+ * @param milliseconds 확인 간격 (기본값: 100ms)
+ * @param maxCount 최대 시도 횟수 (undefined이면 무제한)
+ *
+ * @note 첫 번째 호출에서 조건이 true이면 즉시 반환.
+ * @example
+ * // maxCount=3: 최대 3번 조건 확인, 모두 false이면 TimeoutError 발생
+ * await waitUntil(() => someCondition, 100, 3);
+ * @throws TimeoutError 최대 시도 횟수를 초과했을 때
+ */
+export async function until(forwarder, milliseconds, maxCount) {
+    let count = 0;
+    while (!(await forwarder())) {
+        count++;
+        if (maxCount !== undefined && count >= maxCount) {
+            throw new TimeoutError(count);
+        }
+        await time(milliseconds ?? 100);
     }
-    await time(milliseconds ?? 100);
-  }
 }
-async function time(millisecond) {
-  return new Promise((resolve) => setTimeout(resolve, millisecond));
+/**
+ * 지정된 시간만큼 대기
+ * @param millisecond 대기 시간 (ms)
+ */
+export async function time(millisecond) {
+    return new Promise((resolve) => setTimeout(resolve, millisecond));
 }
-export {
-  time,
-  until
-};
-//# sourceMappingURL=wait.js.map
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/wait.ts"],
-  "mappings": "AAGA,SAAS,oBAAoB;AAc7B,eAAsB,MACpB,WACA,cACA,UACe;AACf,MAAI,QAAQ;AACZ,SAAO,CAAE,MAAM,UAAU,GAAI;AAC3B;AACA,QAAI,aAAa,UAAa,SAAS,UAAU;AAC/C,YAAM,IAAI,aAAa,KAAK;AAAA,IAC9B;AAEA,UAAM,KAAK,gBAAgB,GAAG;AAAA,EAChC;AACF;AAMA,eAAsB,KAAK,aAAoC;AAC7D,SAAO,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,WAAW,CAAC;AACxE;",
-  "names": []
-}
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,SAA2C,EAC3C,YAAqB,EACrB,QAAiB;IAEjB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;QAC5B,KAAK,EAAE,CAAC;QACR,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,WAAmB;IAC5C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/utils/xml.d.ts

@@ -1,16 +1,16 @@
 /**
- * XML conversion utility
+ * XML 변환 유틸리티
  */
 import type { XmlBuilderOptions } from "fast-xml-parser";
 /**
- * Parse XML string into an object
- * @param str XML string
- * @param options Options
- * @param options.stripTagPrefix Whether to remove tag prefix (namespace)
- * @returns Parsed object. Structure:
- *   - Attributes: grouped in `$` object
- *   - Text nodes: stored in `_` key
- *   - Child elements: converted to array (except root element)
+ * XML 문자열을 객체로 파싱
+ * @param str XML 문자열
+ * @param options 옵션
+ * @param options.stripTagPrefix 태그 접두사(네임스페이스) 제거 여부
+ * @returns 파싱된 객체. 구조:
+ *   - 속성: `$` 객체에 그룹화
+ *   - 텍스트 노드: `_` key에 저장
+ *   - 자식 요소: array로 변환 (루트 요소 제외)
  * @example
  * xmlParse('<root id="1"><item>hello</item></root>');
  * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
@@ -19,10 +19,10 @@ export declare function parse(str: string, options?: {
     stripTagPrefix?: boolean;
 }): unknown;
 /**
- * Serialize object to XML string
- * @param obj Object to serialize
- * @param options fast-xml-parser XmlBuilderOptions (optional)
- * @returns XML string
+ * 객체를 XML 문자열로 직렬화
+ * @param obj 직렬화할 객체
+ * @param options fast-xml-parser XmlBuilderOptions (선택사항)
+ * @returns XML 문자열
  * @example
  * xmlStringify({
  *   root: {