@simplysm/excel 13.0.100 → 14.0.1

package/dist/utils/excel-utils.d.ts

@@ -1,50 +1,50 @@
 import type { ExcelAddressPoint, ExcelAddressRangePoint, ExcelNumberFormat } from "../types";
 /**
- * Collection of Excel utility functions.
- * Provides cell address conversion, date/number conversion, and number format processing.
+ * Excel 유틸리티 함수 모음.
+ * 셀 주소 변환, 날짜/숫자 변환, 숫자 형식 처리 기능을 제공한다.
  */
 export declare class ExcelUtils {
-    /** Convert cell coordinates to "A1" format string */
+    /** 셀 좌표를 "A1" 형식 문자열로 변환 */
     static stringifyAddr(point: ExcelAddressPoint): string;
-    /** Convert row index (0-based) to row address string (e.g. 0 -> "1") */
+    /** 행 인덱스(0 기반)를 행 주소 문자열로 변환 (예: 0 -> "1") */
     static stringifyRowAddr(r: number): string;
-    /** Convert column index (0-based) to column address string (e.g. 0 -> "A", 26 -> "AA") */
+    /** 열 인덱스(0 기반)를 열 주소 문자열로 변환 (예: 0 -> "A", 26 -> "AA") */
     static stringifyColAddr(c: number): string;
-    /** Extract row index from cell address (e.g. "A3" -> 2) */
+    /** 셀 주소에서 행 인덱스 추출 (예: "A3" -> 2) */
     static parseRowAddr(addr: string): number;
-    /** Extract column index from cell address (e.g. "B3" -> 1) */
+    /** 셀 주소에서 열 인덱스 추출 (예: "B3" -> 1) */
     static parseColAddr(addr: string): number;
-    /** Convert cell address to coordinates (e.g. "B3" -> {r: 2, c: 1}) */
+    /** 셀 주소를 좌표로 변환 (예: "B3" -> {r: 2, c: 1}) */
     static parseCellAddr(addr: string): ExcelAddressPoint;
-    /** Convert range address to coordinates (e.g. "A1:C3" -> {s: {r:0,c:0}, e: {r:2,c:2}}) */
+    /** 범위 주소를 좌표로 변환 (예: "A1:C3" -> {s: {r:0,c:0}, e: {r:2,c:2}}) */
     static parseRangeAddr(rangeAddr: string): ExcelAddressRangePoint;
-    /** Convert range coordinates to address string */
+    /** 범위 좌표를 주소 문자열로 변환 */
     static stringifyRangeAddr(point: ExcelAddressRangePoint): string;
     /**
-     * Convert JavaScript timestamp (ms) to Excel date number.
-     * Excel counts 1900-01-01 as 1 (1899-12-30 is date 0).
+     * JavaScript 타임스탬프(ms)를 Excel 날짜 숫자로 변환한다.
+     * Excel은 1900-01-01을 1로 계산한다 (1899-12-30이 날짜 0).
      */
     static convertTimeTickToNumber(tick: number): number;
     /**
-     * Convert Excel date number to JavaScript timestamp (ms).
-     * Excel counts 1900-01-01 as 1 (1899-12-30 is date 0).
+     * Excel 날짜 숫자를 JavaScript 타임스탬프(ms)로 변환한다.
+     * Excel은 1900-01-01을 1로 계산한다 (1899-12-30이 날짜 0).
      */
     static convertNumberToTimeTick(value: number): number;
-    /** Convert number format code to format name */
+    /** 숫자 형식 코드를 형식 이름으로 변환 */
     static convertNumFmtCodeToName(numFmtCode: string): ExcelNumberFormat;
     /**
-     * Convert number format ID to format name
+     * 숫자 형식 ID를 형식 이름으로 변환
      *
      * @remarks
-     * Excel built-in format ID ranges:
-     * - 0~13, 37~40, 48: number/general/currency/percent formats
-     * - 14~17, 27~31, 34~36, 50~58: date formats (including localized)
-     * - 22: date+time format
-     * - 18~21, 32~33, 45~47: time formats
-     * - 49: text format
+     * Excel 내장 형식 ID 범위:
+     * - 0~13, 37~40, 48: 숫자/일반/통화/퍼센트 형식
+     * - 14~17, 27~31, 34~36, 50~58: 날짜 형식 (로컬라이즈 포함)
+     * - 22: 날짜+시간 형식
+     * - 18~21, 32~33, 45~47: 시간 형식
+     * - 49: 텍스트 형식
      */
     static convertNumFmtIdToName(numFmtId: number): ExcelNumberFormat;
-    /** Convert number format name to format ID */
+    /** 숫자 형식 이름을 형식 ID로 변환 */
     static convertNumFmtNameToId(numFmtName: ExcelNumberFormat): number;
 }
 //# sourceMappingURL=excel-utils.d.ts.map

package/dist/utils/excel-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"excel-utils.d.ts","sourceRoot":"","sources":["..\\..\\src\\utils\\excel-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7F;;;GAGG;AACH,qBAAa,UAAU;IACrB,qDAAqD;IACrD,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAMtD,wEAAwE;IACxE,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1C,0FAA0F;IAC1F,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAe1C,2DAA2D;IAC3D,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASzC,8DAA8D;IAC9D,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYzC,sEAAsE;IACtE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAOrD,0FAA0F;IAC1F,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB;IAQhE,kDAAkD;IAClD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM;IAWhE;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQpD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IASrD,gDAAgD;IAChD,MAAM,CAAC,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IA0BrE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAkCjE,8CAA8C;IAC9C,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM;CAcpE"}
+{"version":3,"file":"excel-utils.d.ts","sourceRoot":"","sources":["..\\..\\src\\utils\\excel-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7F;;;GAGG;AACH,qBAAa,UAAU;IACrB,4BAA4B;IAC5B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAMtD,8CAA8C;IAC9C,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1C,0DAA0D;IAC1D,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAgB1C,qCAAqC;IACrC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASzC,qCAAqC;IACrC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYzC,6CAA6C;IAC7C,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAOrD,iEAAiE;IACjE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB;IAQhE,wBAAwB;IACxB,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM;IAWhE;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQpD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IASrD,2BAA2B;IAC3B,MAAM,CAAC,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IA+BrE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAkCjE,0BAA0B;IAC1B,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM;CAcpE"}

package/dist/utils/excel-utils.js

@@ -1,162 +1,194 @@
 import { num } from "@simplysm/core-common";
-class ExcelUtils {
-  /** Convert cell coordinates to "A1" format string */
-  static stringifyAddr(point) {
-    const rowStr = this.stringifyRowAddr(point.r);
-    const colStr = this.stringifyColAddr(point.c);
-    return `${colStr}${rowStr}`;
-  }
-  /** Convert row index (0-based) to row address string (e.g. 0 -> "1") */
-  static stringifyRowAddr(r) {
-    return (r + 1).toString();
-  }
-  /** Convert column index (0-based) to column address string (e.g. 0 -> "A", 26 -> "AA") */
-  static stringifyColAddr(c) {
-    if (c < 0 || c > 16383) {
-      throw new Error(`Column index must be in range 0~16383: ${c}`);
+/**
+ * Excel 유틸리티 함수 모음.
+ * 셀 주소 변환, 날짜/숫자 변환, 숫자 형식 처리 기능을 제공한다.
+ */
+export class ExcelUtils {
+    /** 셀 좌표를 "A1" 형식 문자열로 변환 */
+    static stringifyAddr(point) {
+        const rowStr = this.stringifyRowAddr(point.r);
+        const colStr = this.stringifyColAddr(point.c);
+        return `${colStr}${rowStr}`;
     }
-    let remained = c;
-    let result = String.fromCharCode(remained % 26 + 65);
-    remained = Math.floor(remained / 26);
-    while (remained !== 0) {
-      result = String.fromCharCode(remained % 26 + 64) + result;
-      remained = Math.floor(remained / 26);
+    /** 행 인덱스(0 기반)를 행 주소 문자열로 변환 (예: 0 -> "1") */
+    static stringifyRowAddr(r) {
+        return (r + 1).toString();
     }
-    return result;
-  }
-  /** Extract row index from cell address (e.g. "A3" -> 2) */
-  static parseRowAddr(addr) {
-    var _a;
-    const rowAddrCode = ((_a = /\d*$/.exec(addr)) == null ? void 0 : _a[0]) ?? "";
-    const parsed = num.parseInt(rowAddrCode);
-    if (parsed == null) {
-      throw new Error(`Invalid row address code: ${rowAddrCode}`);
+    /** 열 인덱스(0 기반)를 열 주소 문자열로 변환 (예: 0 -> "A", 26 -> "AA") */
+    static stringifyColAddr(c) {
+        if (c < 0 || c > 16383) {
+            throw new Error(`열 인덱스는 0~16383 범위여야 합니다: ${c}`);
+        }
+        let remained = c;
+        let result = String.fromCharCode((remained % 26) + 65);
+        remained = Math.floor(remained / 26);
+        while (remained !== 0) {
+            remained -= 1;
+            result = String.fromCharCode((remained % 26) + 65) + result;
+            remained = Math.floor(remained / 26);
+        }
+        return result;
     }
-    return parsed - 1;
-  }
-  /** Extract column index from cell address (e.g. "B3" -> 1) */
-  static parseColAddr(addr) {
-    var _a;
-    const colAddrCode = ((_a = /^[a-zA-Z]*/.exec(addr)) == null ? void 0 : _a[0]) ?? "";
-    let result = 0;
-    const revAddr = Array.from(colAddrCode).reverse().join("");
-    for (let i = 0; i < revAddr.length; i++) {
-      const col = revAddr.charCodeAt(i) - (i === 0 ? 65 : 64);
-      result += col * 26 ** i;
+    /** 셀 주소에서 행 인덱스 추출 (예: "A3" -> 2) */
+    static parseRowAddr(addr) {
+        const rowAddrCode = /\d*$/.exec(addr)?.[0] ?? "";
+        const parsed = num.parseInt(rowAddrCode);
+        if (parsed == null) {
+            throw new Error(`잘못된 행 주소 코드: ${rowAddrCode}`);
+        }
+        return parsed - 1;
     }
-    return result;
-  }
-  /** Convert cell address to coordinates (e.g. "B3" -> {r: 2, c: 1}) */
-  static parseCellAddr(addr) {
-    return {
-      r: ExcelUtils.parseRowAddr(addr),
-      c: ExcelUtils.parseColAddr(addr)
-    };
-  }
-  /** Convert range address to coordinates (e.g. "A1:C3" -> {s: {r:0,c:0}, e: {r:2,c:2}}) */
-  static parseRangeAddr(rangeAddr) {
-    const parts = rangeAddr.split(":");
-    return {
-      s: ExcelUtils.parseCellAddr(parts[0]),
-      e: ExcelUtils.parseCellAddr(parts[1] ?? parts[0])
-    };
-  }
-  /** Convert range coordinates to address string */
-  static stringifyRangeAddr(point) {
-    const sAddr = this.stringifyAddr(point.s);
-    const eAddr = this.stringifyAddr(point.e);
-    if (sAddr === eAddr) {
-      return sAddr;
-    } else {
-      return sAddr + ":" + eAddr;
+    /** 셀 주소에서 열 인덱스 추출 (예: "B3" -> 1) */
+    static parseColAddr(addr) {
+        const colAddrCode = /^[a-zA-Z]*/.exec(addr)?.[0] ?? "";
+        let result = 0;
+        const revAddr = Array.from(colAddrCode).reverse().join("");
+        for (let i = 0; i < revAddr.length; i++) {
+            const col = revAddr.charCodeAt(i) - (i === 0 ? 65 : 64);
+            result += col * 26 ** i;
+        }
+        return result;
     }
-  }
-  /**
-   * Convert JavaScript timestamp (ms) to Excel date number.
-   * Excel counts 1900-01-01 as 1 (1899-12-30 is date 0).
-   */
-  static convertTimeTickToNumber(tick) {
-    const currDate = new Date(tick);
-    currDate.setMinutes(currDate.getMinutes() - currDate.getTimezoneOffset());
-    const excelBaseDateNumberUtc = Date.UTC(1899, 11, 31);
-    const inputExcelDateNumberUtc = currDate.getTime() - excelBaseDateNumberUtc;
-    return inputExcelDateNumberUtc / (24 * 60 * 60 * 1e3) + 1;
-  }
-  /**
-   * Convert Excel date number to JavaScript timestamp (ms).
-   * Excel counts 1900-01-01 as 1 (1899-12-30 is date 0).
-   */
-  static convertNumberToTimeTick(value) {
-    const excelBaseDateNumberUtc = Date.UTC(1899, 11, 31);
-    const excelDateNumberUtc = (value - 1) * 24 * 60 * 60 * 1e3;
-    const dateNumberUtc = excelBaseDateNumberUtc + excelDateNumberUtc;
-    const date = new Date(dateNumberUtc);
-    date.setMinutes(date.getMinutes() + date.getTimezoneOffset());
-    return date.getTime();
-  }
-  /** Convert number format code to format name */
-  static convertNumFmtCodeToName(numFmtCode) {
-    if (numFmtCode === "General") {
-      return "number";
+    /** 셀 주소를 좌표로 변환 (예: "B3" -> {r: 2, c: 1}) */
+    static parseCellAddr(addr) {
+        return {
+            r: ExcelUtils.parseRowAddr(addr),
+            c: ExcelUtils.parseColAddr(addr),
+        };
     }
-    const hasDate = /yy/i.test(numFmtCode) || /dd/i.test(numFmtCode) || /mm/i.test(numFmtCode);
-    const hasTime = /hh/i.test(numFmtCode) || /ss/i.test(numFmtCode);
-    if (hasDate && hasTime) {
-      return "DateTime";
-    } else if (hasDate) {
-      return "DateOnly";
-    } else if (hasTime) {
-      return "Time";
-    } else if (/^[0.#,_;()\-\\$ @*?"E%+]*$/.test(numFmtCode.split("]").at(-1) ?? "")) {
-      return "number";
-    } else if ((numFmtCode.split("]").at(-1) ?? "").includes("#,0")) {
-      return "number";
-    } else {
-      throw new Error(`Unknown format for [numFmtCode: ${numFmtCode}].`);
+    /** 범위 주소를 좌표로 변환 (예: "A1:C3" -> {s: {r:0,c:0}, e: {r:2,c:2}}) */
+    static parseRangeAddr(rangeAddr) {
+        const parts = rangeAddr.split(":");
+        return {
+            s: ExcelUtils.parseCellAddr(parts[0]),
+            e: ExcelUtils.parseCellAddr(parts[1] ?? parts[0]),
+        };
     }
-  }
-  /**
-   * Convert number format ID to format name
-   *
-   * @remarks
-   * Excel built-in format ID ranges:
-   * - 0~13, 37~40, 48: number/general/currency/percent formats
-   * - 14~17, 27~31, 34~36, 50~58: date formats (including localized)
-   * - 22: date+time format
-   * - 18~21, 32~33, 45~47: time formats
-   * - 49: text format
-   */
-  static convertNumFmtIdToName(numFmtId) {
-    if (numFmtId <= 13 || numFmtId >= 37 && numFmtId <= 40 || numFmtId === 48) {
-      return "number";
-    } else if (numFmtId >= 14 && numFmtId <= 17 || numFmtId >= 27 && numFmtId <= 31 || numFmtId >= 34 && numFmtId <= 36 || numFmtId >= 50 && numFmtId <= 58) {
-      return "DateOnly";
-    } else if (numFmtId === 22) {
-      return "DateTime";
-    } else if (numFmtId >= 18 && numFmtId <= 21 || numFmtId >= 32 && numFmtId <= 33 || numFmtId >= 45 && numFmtId <= 47) {
-      return "Time";
-    } else if (numFmtId === 49) {
-      return "string";
-    } else {
-      throw new Error(`Unknown format for [numFmtId: ${numFmtId}].`);
+    /** 범위 좌표를 주소 문자열로 변환 */
+    static stringifyRangeAddr(point) {
+        const sAddr = this.stringifyAddr(point.s);
+        const eAddr = this.stringifyAddr(point.e);
+        if (sAddr === eAddr) {
+            return sAddr;
+        }
+        else {
+            return sAddr + ":" + eAddr;
+        }
     }
-  }
-  /** Convert number format name to format ID */
-  static convertNumFmtNameToId(numFmtName) {
-    if (numFmtName === "number") {
-      return 0;
-    } else if (numFmtName === "DateOnly") {
-      return 14;
-    } else if (numFmtName === "DateTime") {
-      return 22;
-    } else if (numFmtName === "Time") {
-      return 18;
-    } else {
-      return 49;
+    /**
+     * JavaScript 타임스탬프(ms)를 Excel 날짜 숫자로 변환한다.
+     * Excel은 1900-01-01을 1로 계산한다 (1899-12-30이 날짜 0).
+     */
+    static convertTimeTickToNumber(tick) {
+        const currDate = new Date(tick);
+        currDate.setMinutes(currDate.getMinutes() - currDate.getTimezoneOffset());
+        const excelBaseDateNumberUtc = Date.UTC(1899, 11, 31);
+        const inputExcelDateNumberUtc = currDate.getTime() - excelBaseDateNumberUtc;
+        return inputExcelDateNumberUtc / (24 * 60 * 60 * 1000) + 1;
+    }
+    /**
+     * Excel 날짜 숫자를 JavaScript 타임스탬프(ms)로 변환한다.
+     * Excel은 1900-01-01을 1로 계산한다 (1899-12-30이 날짜 0).
+     */
+    static convertNumberToTimeTick(value) {
+        const excelBaseDateNumberUtc = Date.UTC(1899, 11, 31);
+        const excelDateNumberUtc = (value - 1) * 24 * 60 * 60 * 1000;
+        const dateNumberUtc = excelBaseDateNumberUtc + excelDateNumberUtc;
+        const date = new Date(dateNumberUtc);
+        date.setMinutes(date.getMinutes() + date.getTimezoneOffset());
+        return date.getTime();
+    }
+    /** 숫자 형식 코드를 형식 이름으로 변환 */
+    static convertNumFmtCodeToName(numFmtCode) {
+        if (numFmtCode === "General") {
+            return "number";
+        }
+        // "mm"이 시간 문맥(h/hh 뒤 또는 ss 앞)에서 쓰이면 분(minute)이므로 날짜 판별에서 제외
+        const codeForDateCheck = numFmtCode
+            .replace(/h{1,2}\s*:?\s*mm/gi, "")
+            .replace(/mm\s*:?\s*ss/gi, "");
+        const hasDate = /yy/i.test(numFmtCode) || /dd/i.test(numFmtCode) || /mm/i.test(codeForDateCheck);
+        const hasTime = /h{1,2}/i.test(numFmtCode) || /ss/i.test(numFmtCode);
+        if (hasDate && hasTime) {
+            return "DateTime"; // 날짜+시간 = DateTime
+        }
+        else if (hasDate) {
+            return "DateOnly"; // 날짜만 = DateOnly
+        }
+        else if (hasTime) {
+            return "Time"; // 시간만 = Time
+        }
+        // 숫자 형식 패턴: 0, #, 소수점, 천단위 구분, 음수 구분, 괄호, 통화, 공백, 지수, 퍼센트 등
+        // "[조건부 형식]실제 형식" 구조에서 실제 형식 부분만 검사 (split("]").at(-1))
+        else if (/^[0.#,_;()\-\\$ @*?"E%+]*$/.test(numFmtCode.split("]").at(-1) ?? "")) {
+            return "number";
+        }
+        else if ((numFmtCode.split("]").at(-1) ?? "").includes("#,0")) {
+            return "number";
+        }
+        else {
+            throw new Error(`알 수 없는 형식 [numFmtCode: ${numFmtCode}]`);
+        }
+    }
+    /**
+     * 숫자 형식 ID를 형식 이름으로 변환
+     *
+     * @remarks
+     * Excel 내장 형식 ID 범위:
+     * - 0~13, 37~40, 48: 숫자/일반/통화/퍼센트 형식
+     * - 14~17, 27~31, 34~36, 50~58: 날짜 형식 (로컬라이즈 포함)
+     * - 22: 날짜+시간 형식
+     * - 18~21, 32~33, 45~47: 시간 형식
+     * - 49: 텍스트 형식
+     */
+    static convertNumFmtIdToName(numFmtId) {
+        // 숫자/일반/통화/퍼센트 형식
+        if (numFmtId <= 13 || (numFmtId >= 37 && numFmtId <= 40) || numFmtId === 48) {
+            return "number";
+        }
+        // 날짜 형식 (로컬라이즈 포함)
+        else if ((numFmtId >= 14 && numFmtId <= 17) ||
+            (numFmtId >= 27 && numFmtId <= 31) ||
+            (numFmtId >= 34 && numFmtId <= 36) ||
+            (numFmtId >= 50 && numFmtId <= 58)) {
+            return "DateOnly";
+        }
+        // 날짜+시간 형식
+        else if (numFmtId === 22) {
+            return "DateTime";
+        }
+        // 시간 형식
+        else if ((numFmtId >= 18 && numFmtId <= 21) ||
+            (numFmtId >= 32 && numFmtId <= 33) ||
+            (numFmtId >= 45 && numFmtId <= 47)) {
+            return "Time";
+        }
+        // 텍스트 형식
+        else if (numFmtId === 49) {
+            return "string";
+        }
+        else {
+            throw new Error(`알 수 없는 형식 [numFmtId: ${numFmtId}]`);
+        }
+    }
+    /** 숫자 형식 이름을 형식 ID로 변환 */
+    static convertNumFmtNameToId(numFmtName) {
+        if (numFmtName === "number") {
+            return 0;
+        }
+        else if (numFmtName === "DateOnly") {
+            return 14;
+        }
+        else if (numFmtName === "DateTime") {
+            return 22;
+        }
+        else if (numFmtName === "Time") {
+            return 18;
+        }
+        else {
+            // 마지막 케이스: "string" (TypeScript가 타입 좁히기를 통해 자동 검증)
+            return 49;
+        }
     }
-  }
 }
-export {
-  ExcelUtils
-};
-//# sourceMappingURL=excel-utils.js.map
+//# sourceMappingURL=excel-utils.js.map

package/dist/utils/excel-utils.js.map

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

package/dist/utils/zip-cache.d.ts

@@ -1,15 +1,15 @@
 import type { Bytes } from "@simplysm/core-common";
 import type { ExcelXml } from "../types";
 /**
- * Class managing file cache for Excel ZIP archives.
- * XML files are parsed into ExcelXml objects; other files are cached as byte arrays.
+ * Excel ZIP 아카이브의 파일 캐시를 관리하는 클래스.
+ * XML 파일은 ExcelXml 객체로 파싱하고, 기타 파일은 바이트 배열로 캐싱한다.
  *
  * @remarks
- * ## Lazy Loading Cache Strategy
+ * ## Lazy Loading 캐시 전략
  *
- * - Files are read and parsed from the ZIP only on first access
- * - Subsequent accesses return the cached object
- * - Loads only the needed parts from large Excel files for memory efficiency
+ * - 파일은 최초 접근 시에만 ZIP에서 읽고 파싱함
+ * - 이후 접근은 캐싱된 객체를 반환함
+ * - 대용량 Excel 파일에서 필요한 부분만 로드하여 메모리 효율적
  */
 export declare class ZipCache {
     private readonly _cache;

package/dist/utils/zip-cache.js

@@ -7,68 +7,86 @@ import { ExcelXmlStyle } from "../xml/excel-xml-style.js";
 import { ExcelXmlUnknown } from "../xml/excel-xml-unknown.js";
 import { ExcelXmlWorkbook } from "../xml/excel-xml-workbook.js";
 import { ExcelXmlWorksheet } from "../xml/excel-xml-worksheet.js";
-class ZipCache {
-  _cache = /* @__PURE__ */ new Map();
-  _zip;
-  constructor(arg) {
-    this._zip = new ZipArchive(arg);
-  }
-  async get(filePath) {
-    if (this._cache.has(filePath)) {
-      return this._cache.get(filePath);
+/**
+ * Excel ZIP 아카이브의 파일 캐시를 관리하는 클래스.
+ * XML 파일은 ExcelXml 객체로 파싱하고, 기타 파일은 바이트 배열로 캐싱한다.
+ *
+ * @remarks
+ * ## Lazy Loading 캐시 전략
+ *
+ * - 파일은 최초 접근 시에만 ZIP에서 읽고 파싱함
+ * - 이후 접근은 캐싱된 객체를 반환함
+ * - 대용량 Excel 파일에서 필요한 부분만 로드하여 메모리 효율적
+ */
+export class ZipCache {
+    _cache = new Map();
+    _zip;
+    constructor(arg) {
+        this._zip = new ZipArchive(arg);
     }
-    const fileData = await this._zip.get(filePath);
-    if (fileData == null) {
-      this._cache.set(filePath, void 0);
-      return void 0;
+    async get(filePath) {
+        if (this._cache.has(filePath)) {
+            return this._cache.get(filePath);
+        }
+        const fileData = await this._zip.get(filePath);
+        if (fileData == null) {
+            this._cache.set(filePath, undefined);
+            return undefined;
+        }
+        if (filePath.endsWith(".xml") || filePath.endsWith(".rels")) {
+            const fileText = new TextDecoder().decode(fileData);
+            const xml = xmlU.parse(fileText, { stripTagPrefix: true });
+            if (filePath.endsWith(".rels")) {
+                this._cache.set(filePath, new ExcelXmlRelationship(xml));
+            }
+            else if (filePath === "[Content_Types].xml") {
+                this._cache.set(filePath, new ExcelXmlContentType(xml));
+            }
+            else if (filePath === "xl/workbook.xml") {
+                this._cache.set(filePath, new ExcelXmlWorkbook(xml));
+            }
+            else if (filePath.startsWith("xl/worksheets/sheet") && filePath.endsWith(".xml")) {
+                this._cache.set(filePath, new ExcelXmlWorksheet(xml));
+            }
+            else if (filePath.startsWith("xl/drawings/drawing") && filePath.endsWith(".xml")) {
+                this._cache.set(filePath, new ExcelXmlDrawing(xml));
+            }
+            else if (filePath === "xl/sharedStrings.xml") {
+                this._cache.set(filePath, new ExcelXmlSharedString(xml));
+            }
+            else if (filePath === "xl/styles.xml") {
+                this._cache.set(filePath, new ExcelXmlStyle(xml));
+            }
+            else {
+                this._cache.set(filePath, new ExcelXmlUnknown(xml));
+            }
+        }
+        else {
+            this._cache.set(filePath, fileData);
+        }
+        return this._cache.get(filePath);
     }
-    if (filePath.endsWith(".xml") || filePath.endsWith(".rels")) {
-      const fileText = new TextDecoder().decode(fileData);
-      const xml = xmlU.parse(fileText, { stripTagPrefix: true });
-      if (filePath.endsWith(".rels")) {
-        this._cache.set(filePath, new ExcelXmlRelationship(xml));
-      } else if (filePath === "[Content_Types].xml") {
-        this._cache.set(filePath, new ExcelXmlContentType(xml));
-      } else if (filePath === "xl/workbook.xml") {
-        this._cache.set(filePath, new ExcelXmlWorkbook(xml));
-      } else if (filePath.startsWith("xl/worksheets/sheet") && filePath.endsWith(".xml")) {
-        this._cache.set(filePath, new ExcelXmlWorksheet(xml));
-      } else if (filePath.startsWith("xl/drawings/drawing") && filePath.endsWith(".xml")) {
-        this._cache.set(filePath, new ExcelXmlDrawing(xml));
-      } else if (filePath === "xl/sharedStrings.xml") {
-        this._cache.set(filePath, new ExcelXmlSharedString(xml));
-      } else if (filePath === "xl/styles.xml") {
-        this._cache.set(filePath, new ExcelXmlStyle(xml));
-      } else {
-        this._cache.set(filePath, new ExcelXmlUnknown(xml));
-      }
-    } else {
-      this._cache.set(filePath, fileData);
+    set(filePath, content) {
+        this._cache.set(filePath, content);
     }
-    return this._cache.get(filePath);
-  }
-  set(filePath, content) {
-    this._cache.set(filePath, content);
-  }
-  async toBytes() {
-    for (const filePath of this._cache.keys()) {
-      const content = this._cache.get(filePath);
-      if (content == null) continue;
-      if ("cleanup" in content) {
-        content.cleanup();
-        this._zip.write(filePath, new TextEncoder().encode(xmlU.stringify(content.data)));
-      } else {
-        this._zip.write(filePath, content);
-      }
+    async toBytes() {
+        for (const filePath of this._cache.keys()) {
+            const content = this._cache.get(filePath);
+            if (content == null)
+                continue;
+            if ("cleanup" in content) {
+                content.cleanup();
+                this._zip.write(filePath, new TextEncoder().encode(xmlU.stringify(content.data)));
+            }
+            else {
+                this._zip.write(filePath, content);
+            }
+        }
+        return this._zip.compress();
+    }
+    async close() {
+        await this._zip.close();
+        this._cache.clear();
     }
-    return this._zip.compress();
-  }
-  async close() {
-    await this._zip.close();
-    this._cache.clear();
-  }
 }
-export {
-  ZipCache
-};
-//# sourceMappingURL=zip-cache.js.map
+//# sourceMappingURL=zip-cache.js.map