@simplysm/excel 13.0.99 → 14.0.1

package/dist/excel-cell.d.ts

@@ -1,58 +1,58 @@
 import type { ZipCache } from "./utils/zip-cache";
 import type { ExcelAddressPoint, ExcelStyleOptions, ExcelValueType } from "./types";
 /**
- * Class representing an Excel cell.
- * Provides value read/write, formula, style, and cell merge functionality.
+ * Excel 셀을 나타내는 클래스.
+ * 값 읽기/쓰기, 수식, 스타일, 셀 병합 기능을 제공한다.
  *
  * @remarks
- * ## Async Method Design
+ * ## 비동기 메서드 설계
  *
- * Why all cell methods like `getValue()`, `setValue()` are `async`:
- * - Only the XML needed for the cell type is selectively loaded
- * - String cell: loads SharedStrings.xml
- * - Number cell: does not load SharedStrings
- * - Styled cell: loads Styles.xml
+ * `getValue()`, `setValue()` 등 모든 셀 메서드가 `async`인 이유:
+ * - 셀 타입에 필요한 XML만 선택적으로 로드함
+ * - 문자열 셀: SharedStrings.xml 로드
+ * - 숫자 셀: SharedStrings 로드하지 않음
+ * - 스타일 적용 셀: Styles.xml 로드
  *
- * Since the cell to be read cannot be known in advance, a synchronous design is not feasible.
- * A synchronous design would require preloading all XML, causing memory issues with large files.
+ * 읽을 셀을 사전에 알 수 없으므로 동기 설계가 불가능하다.
+ * 동기 설계는 모든 XML을 미리 로드해야 하므로 대용량 파일에서 메모리 문제가 발생한다.
  */
 export declare class ExcelCell {
     private readonly _zipCache;
     private readonly _targetFileName;
     private readonly _r;
     private readonly _c;
-    /** Cell address (0-based row/column index) */
+    /** 셀 주소 (0 기반 행/열 인덱스) */
     readonly addr: ExcelAddressPoint;
     constructor(_zipCache: ZipCache, _targetFileName: string, _r: number, _c: number);
-    /** Set formula on cell (undefined: remove formula) */
+    /** 셀에 수식 설정 (undefined: 수식 제거) */
     setFormula(val: string | undefined): Promise<void>;
-    /** Return cell formula */
+    /** 셀 수식 반환 */
     getFormula(): Promise<string | undefined>;
-    /** Set cell value (undefined: delete cell) */
+    /** 셀 값 설정 (undefined: 셀 삭제) */
     setValue(val: ExcelValueType): Promise<void>;
-    /** Return cell value */
+    /** 셀 값 반환 */
     getValue(): Promise<ExcelValueType>;
     /**
-     * Merge cells from current cell to the specified end coordinates
-     * @param r End row index of merge (0-based)
-     * @param c End column index of merge (0-based)
+     * 현재 셀에서 지정된 끝 좌표까지 셀 병합
+     * @param r 병합 끝 행 인덱스 (0 기반)
+     * @param c 병합 끝 열 인덱스 (0 기반)
      * @example
-     * // Called from cell A1, merges range A1:C3 (3 rows x 3 columns)
+     * // A1 셀에서 호출하여 A1:C3 범위 병합 (3행 x 3열)
      * await ws.cell(0, 0).merge(2, 2);
      */
     merge(r: number, c: number): Promise<void>;
-    /** Return cell style ID */
+    /** 셀 스타일 ID 반환 */
     getStyleId(): Promise<string | undefined>;
-    /** Set cell style ID */
+    /** 셀 스타일 ID 설정 */
     setStyleId(styleId: string | undefined): Promise<void>;
     /**
-     * Set cell style
-     * @param opts Style options
-     * @param opts.background Background color (ARGB format, 8-digit hex. e.g. "00FF0000")
-     * @param opts.border Border position array (e.g. ["left", "right", "top", "bottom"])
-     * @param opts.horizontalAlign Horizontal alignment ("left", "center", "right")
-     * @param opts.verticalAlign Vertical alignment ("top", "center", "bottom")
-     * @param opts.numberFormat Number format ("number", "DateOnly", "DateTime", "Time", "string")
+     * 셀 스타일 설정
+     * @param opts 스타일 옵션
+     * @param opts.background 배경색 (ARGB 형식, 8자리 16진수. 예: "00FF0000")
+     * @param opts.border 테두리 위치 배열 (예: ["left", "right", "top", "bottom"])
+     * @param opts.horizontalAlign 가로 정렬 ("left", "center", "right")
+     * @param opts.verticalAlign 세로 정렬 ("top", "center", "bottom")
+     * @param opts.numberFormat 숫자 형식 ("number", "DateOnly", "DateTime", "Time", "string")
      */
     setStyle(opts: ExcelStyleOptions): Promise<void>;
     private _deleteCell;

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

@@ -1 +1 @@
-{"version":3,"file":"excel-cell.d.ts","sourceRoot":"","sources":["..\\src\\excel-cell.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAYpF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAPrB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAGd,SAAS,EAAE,QAAQ,EACnB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM;IAO7B,sDAAsD;IAChD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,0BAA0B;IACpB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK/C,8CAA8C;IACxC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwClD,wBAAwB;IAClB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAwFzC;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,2BAA2B;IACrB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK/C,wBAAwB;IAClB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCxC,WAAW;YAKX,UAAU;YAIV,iBAAiB;YAYjB,YAAY;YAIZ,UAAU;YAIV,aAAa;YAIb,aAAa;YAIb,kBAAkB;YAqBlB,qBAAqB;CAsBpC"}
+{"version":3,"file":"excel-cell.d.ts","sourceRoot":"","sources":["..\\src\\excel-cell.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAYpF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAPrB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAGd,SAAS,EAAE,QAAQ,EACnB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM;IAO7B,kCAAkC;IAC5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,cAAc;IACR,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK/C,+BAA+B;IACzB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwClD,aAAa;IACP,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAwFzC;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,kBAAkB;IACZ,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK/C,kBAAkB;IACZ,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCxC,WAAW;YAKX,UAAU;YAIV,iBAAiB;YAYjB,YAAY;YAIZ,UAAU;YAIV,aAAa;YAIb,aAAa;YAIb,kBAAkB;YAqBlB,qBAAqB;CAsBpC"}

package/dist/excel-cell.js

@@ -1,283 +1,292 @@
-import {
-  DateOnly,
-  DateTime,
-  num,
-  str,
-  Time
-} from "@simplysm/core-common";
+import { DateOnly, DateTime, num, str, Time, } from "@simplysm/core-common";
 import { ExcelXmlSharedString as ExcelXmlSharedStringClass } from "./xml/excel-xml-shared-string.js";
 import { ExcelXmlStyle as ExcelXmlStyleClass } from "./xml/excel-xml-style.js";
 import { ExcelUtils } from "./utils/excel-utils.js";
-class ExcelCell {
-  constructor(_zipCache, _targetFileName, _r, _c) {
-    this._zipCache = _zipCache;
-    this._targetFileName = _targetFileName;
-    this._r = _r;
-    this._c = _c;
-    this.addr = { r: this._r, c: this._c };
-  }
-  /** Cell address (0-based row/column index) */
-  addr;
-  //#region Value Methods
-  /** Set formula on cell (undefined: remove formula) */
-  async setFormula(val) {
-    if (val === void 0) {
-      await this._deleteCell(this.addr);
-    } else {
-      const wsData = await this._getWsData();
-      wsData.setCellType(this.addr, "str");
-      wsData.setCellVal(this.addr, void 0);
-      wsData.setCellFormula(this.addr, val);
+/**
+ * Excel 셀을 나타내는 클래스.
+ * 값 읽기/쓰기, 수식, 스타일, 셀 병합 기능을 제공한다.
+ *
+ * @remarks
+ * ## 비동기 메서드 설계
+ *
+ * `getValue()`, `setValue()` 등 모든 셀 메서드가 `async`인 이유:
+ * - 셀 타입에 필요한 XML만 선택적으로 로드함
+ * - 문자열 셀: SharedStrings.xml 로드
+ * - 숫자 셀: SharedStrings 로드하지 않음
+ * - 스타일 적용 셀: Styles.xml 로드
+ *
+ * 읽을 셀을 사전에 알 수 없으므로 동기 설계가 불가능하다.
+ * 동기 설계는 모든 XML을 미리 로드해야 하므로 대용량 파일에서 메모리 문제가 발생한다.
+ */
+export class ExcelCell {
+    _zipCache;
+    _targetFileName;
+    _r;
+    _c;
+    /** 셀 주소 (0 기반 행/열 인덱스) */
+    addr;
+    constructor(_zipCache, _targetFileName, _r, _c) {
+        this._zipCache = _zipCache;
+        this._targetFileName = _targetFileName;
+        this._r = _r;
+        this._c = _c;
+        this.addr = { r: this._r, c: this._c };
     }
-  }
-  /** Return cell formula */
-  async getFormula() {
-    const wsData = await this._getWsData();
-    return wsData.getCellFormula(this.addr);
-  }
-  /** Set cell value (undefined: delete cell) */
-  async setValue(val) {
-    if (val === void 0) {
-      await this._deleteCell(this.addr);
-    } else if (typeof val === "string") {
-      const wsData = await this._getWsData();
-      const ssData = await this._getOrCreateSsData();
-      const ssId = ssData.getIdByString(val);
-      if (ssId !== void 0) {
-        wsData.setCellType(this.addr, "s");
-        wsData.setCellVal(this.addr, ssId.toString());
-      } else {
-        const newSsId = ssData.add(val);
-        wsData.setCellType(this.addr, "s");
-        wsData.setCellVal(this.addr, newSsId.toString());
-      }
-    } else if (typeof val === "boolean") {
-      const wsData = await this._getWsData();
-      wsData.setCellType(this.addr, "b");
-      wsData.setCellVal(this.addr, val ? "1" : "0");
-    } else if (typeof val === "number") {
-      const wsData = await this._getWsData();
-      wsData.setCellType(this.addr, void 0);
-      wsData.setCellVal(this.addr, val.toString());
-    } else if (val instanceof DateOnly || val instanceof DateTime || val instanceof Time) {
-      const wsData = await this._getWsData();
-      wsData.setCellType(this.addr, void 0);
-      wsData.setCellVal(this.addr, ExcelUtils.convertTimeTickToNumber(val.tick).toString());
-      const numFmtName = val instanceof DateOnly ? "DateOnly" : val instanceof DateTime ? "DateTime" : "Time";
-      await this._setStyleInternal({
-        numFmtId: ExcelUtils.convertNumFmtNameToId(numFmtName).toString()
-      });
-    } else {
-      throw new Error(
-        `[${ExcelUtils.stringifyAddr(this.addr)}] Unsupported type: ${typeof val}`
-      );
+    //#region Value Methods
+    /** 셀에 수식 설정 (undefined: 수식 제거) */
+    async setFormula(val) {
+        if (val === undefined) {
+            await this._deleteCell(this.addr);
+        }
+        else {
+            const wsData = await this._getWsData();
+            wsData.setCellType(this.addr, "str");
+            wsData.setCellVal(this.addr, undefined);
+            wsData.setCellFormula(this.addr, val);
+        }
+    }
+    /** 셀 수식 반환 */
+    async getFormula() {
+        const wsData = await this._getWsData();
+        return wsData.getCellFormula(this.addr);
+    }
+    /** 셀 값 설정 (undefined: 셀 삭제) */
+    async setValue(val) {
+        if (val === undefined) {
+            await this._deleteCell(this.addr);
+        }
+        else if (typeof val === "string") {
+            const wsData = await this._getWsData();
+            const ssData = await this._getOrCreateSsData();
+            const ssId = ssData.getIdByString(val);
+            if (ssId !== undefined) {
+                wsData.setCellType(this.addr, "s");
+                wsData.setCellVal(this.addr, ssId.toString());
+            }
+            else {
+                const newSsId = ssData.add(val);
+                wsData.setCellType(this.addr, "s");
+                wsData.setCellVal(this.addr, newSsId.toString());
+            }
+        }
+        else if (typeof val === "boolean") {
+            const wsData = await this._getWsData();
+            wsData.setCellType(this.addr, "b");
+            wsData.setCellVal(this.addr, val ? "1" : "0");
+        }
+        else if (typeof val === "number") {
+            const wsData = await this._getWsData();
+            wsData.setCellType(this.addr, undefined);
+            wsData.setCellVal(this.addr, val.toString());
+        }
+        else if (val instanceof DateOnly || val instanceof DateTime || val instanceof Time) {
+            const wsData = await this._getWsData();
+            wsData.setCellType(this.addr, undefined);
+            wsData.setCellVal(this.addr, ExcelUtils.convertTimeTickToNumber(val.tick).toString());
+            const numFmtName = val instanceof DateOnly ? "DateOnly" : val instanceof DateTime ? "DateTime" : "Time";
+            await this._setStyleInternal({
+                numFmtId: ExcelUtils.convertNumFmtNameToId(numFmtName).toString(),
+            });
+        }
+        else {
+            throw new Error(`[${ExcelUtils.stringifyAddr(this.addr)}] 지원하지 않는 타입: ${typeof val}`);
+        }
+    }
+    /** 셀 값 반환 */
+    async getValue() {
+        const wsData = await this._getWsData();
+        const cellVal = wsData.getCellVal(this.addr);
+        if (cellVal === undefined || str.isNullOrEmpty(cellVal)) {
+            return undefined;
+        }
+        const cellType = wsData.getCellType(this.addr);
+        if (cellType === "s") {
+            const ssData = await this._getOrCreateSsData();
+            const ssId = num.parseInt(cellVal);
+            if (ssId == null) {
+                throw new Error(`[${ExcelUtils.stringifyAddr(this.addr)}] SharedString ID 파싱 실패: ${cellVal}`);
+            }
+            return ssData.getStringById(ssId);
+        }
+        else if (cellType === "str") {
+            return cellVal;
+        }
+        else if (cellType === "inlineStr") {
+            return cellVal;
+        }
+        else if (cellType === "b") {
+            return cellVal === "1";
+        }
+        else if (cellType === "n") {
+            return parseFloat(cellVal);
+        }
+        else if (cellType === "e") {
+            throw new Error(`[${ExcelUtils.stringifyAddr(this.addr)}] 셀 타입 분석 실패: 셀에 에러 값이 포함되어 있음 (${cellVal})`);
+        }
+        else {
+            // cellType === undefined: 숫자 또는 날짜/시간 타입
+            const cellStyleId = wsData.getCellStyleId(this.addr);
+            if (cellStyleId === undefined) {
+                return parseFloat(cellVal);
+            }
+            const styleData = await this._getStyleData();
+            if (styleData == null) {
+                return parseFloat(cellVal);
+            }
+            const numFmtId = styleData.get(cellStyleId).numFmtId;
+            if (numFmtId === undefined) {
+                return parseFloat(cellVal);
+            }
+            const numFmtCode = styleData.getNumFmtCode(numFmtId);
+            let numFmt;
+            if (numFmtCode !== undefined) {
+                numFmt = ExcelUtils.convertNumFmtCodeToName(numFmtCode);
+            }
+            else {
+                const numFmtIdNum = num.parseInt(numFmtId);
+                if (numFmtIdNum == null) {
+                    throw new Error(`[${ExcelUtils.stringifyAddr(this.addr)}] numFmtId 파싱 실패: ${numFmtId}`);
+                }
+                numFmt = ExcelUtils.convertNumFmtIdToName(numFmtIdNum);
+            }
+            if (numFmt === "number") {
+                return parseFloat(cellVal);
+            }
+            else if (numFmt === "string") {
+                return cellVal;
+            }
+            else {
+                // DateOnly, DateTime, Time 타입
+                const dateNum = num.parseFloat(cellVal);
+                if (dateNum == null) {
+                    throw new Error(`[${ExcelUtils.stringifyAddr(this.addr)}] 날짜 숫자 파싱 실패: ${cellVal}`);
+                }
+                const tick = ExcelUtils.convertNumberToTimeTick(dateNum);
+                if (numFmt === "DateOnly") {
+                    return new DateOnly(tick);
+                }
+                else if (numFmt === "DateTime") {
+                    return new DateTime(tick);
+                }
+                else {
+                    return new Time(tick);
+                }
+            }
+        }
+    }
+    //#endregion
+    //#region Merge Methods
+    /**
+     * 현재 셀에서 지정된 끝 좌표까지 셀 병합
+     * @param r 병합 끝 행 인덱스 (0 기반)
+     * @param c 병합 끝 열 인덱스 (0 기반)
+     * @example
+     * // A1 셀에서 호출하여 A1:C3 범위 병합 (3행 x 3열)
+     * await ws.cell(0, 0).merge(2, 2);
+     */
+    async merge(r, c) {
+        const wsData = await this._getWsData();
+        wsData.setMergeCells(this.addr, { r, c });
+    }
+    //#endregion
+    //#region Style Methods
+    /** 셀 스타일 ID 반환 */
+    async getStyleId() {
+        const wsData = await this._getWsData();
+        return wsData.getCellStyleId(this.addr);
     }
-  }
-  /** Return cell value */
-  async getValue() {
-    const wsData = await this._getWsData();
-    const cellVal = wsData.getCellVal(this.addr);
-    if (cellVal === void 0 || str.isNullOrEmpty(cellVal)) {
-      return void 0;
+    /** 셀 스타일 ID 설정 */
+    async setStyleId(styleId) {
+        const wsData = await this._getWsData();
+        wsData.setCellStyleId(this.addr, styleId);
     }
-    const cellType = wsData.getCellType(this.addr);
-    if (cellType === "s") {
-      const ssData = await this._getOrCreateSsData();
-      const ssId = num.parseInt(cellVal);
-      if (ssId == null) {
-        throw new Error(
-          `[${ExcelUtils.stringifyAddr(this.addr)}] Failed to parse SharedString ID: ${cellVal}`
-        );
-      }
-      return ssData.getStringById(ssId);
-    } else if (cellType === "str") {
-      return cellVal;
-    } else if (cellType === "inlineStr") {
-      return cellVal;
-    } else if (cellType === "b") {
-      return cellVal === "1";
-    } else if (cellType === "n") {
-      return parseFloat(cellVal);
-    } else if (cellType === "e") {
-      throw new Error(
-        `[${ExcelUtils.stringifyAddr(this.addr)}] Cell type analysis failed: cell contains error value (${cellVal})`
-      );
-    } else {
-      const cellStyleId = wsData.getCellStyleId(this.addr);
-      if (cellStyleId === void 0) {
-        return parseFloat(cellVal);
-      }
-      const styleData = await this._getStyleData();
-      if (styleData == null) {
-        return parseFloat(cellVal);
-      }
-      const numFmtId = styleData.get(cellStyleId).numFmtId;
-      if (numFmtId === void 0) {
-        return parseFloat(cellVal);
-      }
-      const numFmtCode = styleData.getNumFmtCode(numFmtId);
-      let numFmt;
-      if (numFmtCode !== void 0) {
-        numFmt = ExcelUtils.convertNumFmtCodeToName(numFmtCode);
-      } else {
-        const numFmtIdNum = num.parseInt(numFmtId);
-        if (numFmtIdNum == null) {
-          throw new Error(
-            `[${ExcelUtils.stringifyAddr(this.addr)}] Failed to parse numFmtId: ${numFmtId}`
-          );
+    /**
+     * 셀 스타일 설정
+     * @param opts 스타일 옵션
+     * @param opts.background 배경색 (ARGB 형식, 8자리 16진수. 예: "00FF0000")
+     * @param opts.border 테두리 위치 배열 (예: ["left", "right", "top", "bottom"])
+     * @param opts.horizontalAlign 가로 정렬 ("left", "center", "right")
+     * @param opts.verticalAlign 세로 정렬 ("top", "center", "bottom")
+     * @param opts.numberFormat 숫자 형식 ("number", "DateOnly", "DateTime", "Time", "string")
+     */
+    async setStyle(opts) {
+        const style = {};
+        if (opts.background != null) {
+            if (!/^[0-9A-F]{8}$/i.test(opts.background)) {
+                throw new Error("잘못된 색상 형식입니다. (형식: 00000000: alpha(반전)+rgb)");
+            }
+            style.background = opts.background;
         }
-        numFmt = ExcelUtils.convertNumFmtIdToName(numFmtIdNum);
-      }
-      if (numFmt === "number") {
-        return parseFloat(cellVal);
-      } else if (numFmt === "string") {
-        return cellVal;
-      } else {
-        const dateNum = num.parseFloat(cellVal);
-        if (dateNum == null) {
-          throw new Error(
-            `[${ExcelUtils.stringifyAddr(this.addr)}] Failed to parse date number: ${cellVal}`
-          );
+        if (opts.border != null) {
+            style.border = opts.border;
         }
-        const tick = ExcelUtils.convertNumberToTimeTick(dateNum);
-        if (numFmt === "DateOnly") {
-          return new DateOnly(tick);
-        } else if (numFmt === "DateTime") {
-          return new DateTime(tick);
-        } else {
-          return new Time(tick);
+        if (opts.horizontalAlign != null) {
+            style.horizontalAlign = opts.horizontalAlign;
         }
-      }
+        if (opts.verticalAlign != null) {
+            style.verticalAlign = opts.verticalAlign;
+        }
+        if (opts.numberFormat != null) {
+            style.numFmtId = ExcelUtils.convertNumFmtNameToId(opts.numberFormat).toString();
+        }
+        await this._setStyleInternal(style);
     }
-  }
-  //#endregion
-  //#region Merge Methods
-  /**
-   * Merge cells from current cell to the specified end coordinates
-   * @param r End row index of merge (0-based)
-   * @param c End column index of merge (0-based)
-   * @example
-   * // Called from cell A1, merges range A1:C3 (3 rows x 3 columns)
-   * await ws.cell(0, 0).merge(2, 2);
-   */
-  async merge(r, c) {
-    const wsData = await this._getWsData();
-    wsData.setMergeCells(this.addr, { r, c });
-  }
-  //#endregion
-  //#region Style Methods
-  /** Return cell style ID */
-  async getStyleId() {
-    const wsData = await this._getWsData();
-    return wsData.getCellStyleId(this.addr);
-  }
-  /** Set cell style ID */
-  async setStyleId(styleId) {
-    const wsData = await this._getWsData();
-    wsData.setCellStyleId(this.addr, styleId);
-  }
-  /**
-   * Set cell style
-   * @param opts Style options
-   * @param opts.background Background color (ARGB format, 8-digit hex. e.g. "00FF0000")
-   * @param opts.border Border position array (e.g. ["left", "right", "top", "bottom"])
-   * @param opts.horizontalAlign Horizontal alignment ("left", "center", "right")
-   * @param opts.verticalAlign Vertical alignment ("top", "center", "bottom")
-   * @param opts.numberFormat Number format ("number", "DateOnly", "DateTime", "Time", "string")
-   */
-  async setStyle(opts) {
-    const style = {};
-    if (opts.background != null) {
-      if (!/^[0-9A-F]{8}$/i.test(opts.background)) {
-        throw new Error("Invalid color format. (Format: 00000000: alpha(reversed)+rgb)");
-      }
-      style.background = opts.background;
+    //#endregion
+    //#region Private Methods
+    async _deleteCell(addr) {
+        const wsData = await this._getWsData();
+        wsData.deleteCell(addr);
     }
-    if (opts.border != null) {
-      style.border = opts.border;
+    async _getWsData() {
+        return (await this._zipCache.get(`xl/worksheets/${this._targetFileName}`));
     }
-    if (opts.horizontalAlign != null) {
-      style.horizontalAlign = opts.horizontalAlign;
+    async _setStyleInternal(style) {
+        const wsData = await this._getWsData();
+        const styleData = await this._getOrCreateStyleData();
+        let styleId = wsData.getCellStyleId(this.addr);
+        if (styleId == null) {
+            styleId = styleData.add(style);
+        }
+        else {
+            styleId = styleData.addWithClone(styleId, style);
+        }
+        wsData.setCellStyleId(this.addr, styleId);
     }
-    if (opts.verticalAlign != null) {
-      style.verticalAlign = opts.verticalAlign;
+    async _getTypeData() {
+        return (await this._zipCache.get("[Content_Types].xml"));
     }
-    if (opts.numberFormat != null) {
-      style.numFmtId = ExcelUtils.convertNumFmtNameToId(opts.numberFormat).toString();
+    async _getSsData() {
+        return (await this._zipCache.get("xl/sharedStrings.xml"));
     }
-    await this._setStyleInternal(style);
-  }
-  //#endregion
-  //#region Private Methods
-  async _deleteCell(addr) {
-    const wsData = await this._getWsData();
-    wsData.deleteCell(addr);
-  }
-  async _getWsData() {
-    return await this._zipCache.get(`xl/worksheets/${this._targetFileName}`);
-  }
-  async _setStyleInternal(style) {
-    const wsData = await this._getWsData();
-    const styleData = await this._getOrCreateStyleData();
-    let styleId = wsData.getCellStyleId(this.addr);
-    if (styleId == null) {
-      styleId = styleData.add(style);
-    } else {
-      styleId = styleData.addWithClone(styleId, style);
+    async _getWbRelData() {
+        return (await this._zipCache.get("xl/_rels/workbook.xml.rels"));
     }
-    wsData.setCellStyleId(this.addr, styleId);
-  }
-  async _getTypeData() {
-    return await this._zipCache.get("[Content_Types].xml");
-  }
-  async _getSsData() {
-    return await this._zipCache.get("xl/sharedStrings.xml");
-  }
-  async _getWbRelData() {
-    return await this._zipCache.get("xl/_rels/workbook.xml.rels");
-  }
-  async _getStyleData() {
-    return await this._zipCache.get("xl/styles.xml");
-  }
-  async _getOrCreateSsData() {
-    let ssData = await this._getSsData();
-    if (ssData == null) {
-      ssData = new ExcelXmlSharedStringClass();
-      this._zipCache.set("xl/sharedStrings.xml", ssData);
-      const typeData = await this._getTypeData();
-      typeData.add(
-        "/xl/sharedStrings.xml",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"
-      );
-      const wbRelData = await this._getWbRelData();
-      wbRelData.add(
-        "sharedStrings.xml",
-        "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings"
-      );
+    async _getStyleData() {
+        return (await this._zipCache.get("xl/styles.xml"));
     }
-    return ssData;
-  }
-  async _getOrCreateStyleData() {
-    let styleData = await this._getStyleData();
-    if (styleData == null) {
-      styleData = new ExcelXmlStyleClass();
-      this._zipCache.set("xl/styles.xml", styleData);
-      const typeData = await this._getTypeData();
-      typeData.add(
-        "/xl/styles.xml",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"
-      );
-      const wbRelData = await this._getWbRelData();
-      wbRelData.add(
-        "styles.xml",
-        "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles"
-      );
+    async _getOrCreateSsData() {
+        let ssData = await this._getSsData();
+        if (ssData == null) {
+            ssData = new ExcelXmlSharedStringClass();
+            this._zipCache.set("xl/sharedStrings.xml", ssData);
+            const typeData = await this._getTypeData();
+            typeData.add("/xl/sharedStrings.xml", "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml");
+            const wbRelData = await this._getWbRelData();
+            wbRelData.add("sharedStrings.xml", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings");
+        }
+        return ssData;
+    }
+    async _getOrCreateStyleData() {
+        let styleData = await this._getStyleData();
+        if (styleData == null) {
+            styleData = new ExcelXmlStyleClass();
+            this._zipCache.set("xl/styles.xml", styleData);
+            const typeData = await this._getTypeData();
+            typeData.add("/xl/styles.xml", "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml");
+            const wbRelData = await this._getWbRelData();
+            wbRelData.add("styles.xml", "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles");
+        }
+        return styleData;
     }
-    return styleData;
-  }
-  //#endregion
 }
-export {
-  ExcelCell
-};
-//# sourceMappingURL=excel-cell.js.map
+//# sourceMappingURL=excel-cell.js.map