@simplysm/excel 13.0.99 → 14.0.1

package/dist/excel-worksheet.js

@@ -5,273 +5,301 @@ import { ExcelCol } from "./excel-col.js";
 import { ExcelRow } from "./excel-row.js";
 import { ExcelXmlDrawing } from "./xml/excel-xml-drawing.js";
 import { ExcelXmlRelationship } from "./xml/excel-xml-relationship.js";
-class ExcelWorksheet {
-  constructor(_zipCache, _relId, _targetFileName) {
-    this._zipCache = _zipCache;
-    this._relId = _relId;
-    this._targetFileName = _targetFileName;
-  }
-  _rowMap = /* @__PURE__ */ new Map();
-  _colMap = /* @__PURE__ */ new Map();
-  //#region Name Methods
-  /** Return worksheet name */
-  async getName() {
-    const wbXmlData = await this._getWbData();
-    const name = wbXmlData.getWorksheetNameById(this._relId);
-    if (name == null) {
-      throw new Error(`Cannot find name for worksheet ID ${this._relId}`);
+/**
+ * Excel 워크시트를 나타내는 클래스.
+ * 셀 접근, 행/열 복사, 데이터 테이블 처리, 이미지 삽입 기능을 제공한다.
+ */
+export class ExcelWorksheet {
+    _zipCache;
+    _relId;
+    _targetFileName;
+    _rowMap = new Map();
+    _colMap = new Map();
+    constructor(_zipCache, _relId, _targetFileName) {
+        this._zipCache = _zipCache;
+        this._relId = _relId;
+        this._targetFileName = _targetFileName;
     }
-    return name;
-  }
-  /** Rename worksheet */
-  async setName(newName) {
-    const wbXmlData = await this._getWbData();
-    wbXmlData.setWorksheetNameById(this._relId, newName);
-  }
-  //#endregion
-  //#region Cell Access Methods
-  /** Return row object (0-based) */
-  row(r) {
-    return this._rowMap.getOrCreate(r, new ExcelRow(this._zipCache, this._targetFileName, r));
-  }
-  /** Return cell object (0-based row/column) */
-  cell(r, c) {
-    return this.row(r).cell(c);
-  }
-  /** Return column object (0-based) */
-  col(c) {
-    return this._colMap.getOrCreate(c, new ExcelCol(this._zipCache, this._targetFileName, c));
-  }
-  //#endregion
-  //#region Copy Methods
-  /** Copy style from source row to target row */
-  async copyRowStyle(srcR, targetR) {
-    const range = await this.getRange();
-    for (let c = range.s.c; c <= range.e.c; c++) {
-      await this.copyCellStyle({ r: srcR, c }, { r: targetR, c });
+    //#region Name Methods
+    /** 워크시트 이름 반환 */
+    async getName() {
+        const wbXmlData = await this._getWbData();
+        const name = wbXmlData.getWorksheetNameById(this._relId);
+        if (name == null) {
+            throw new Error(`워크시트 ID ${this._relId}의 이름을 찾을 수 없습니다`);
+        }
+        return name;
+    }
+    /** 워크시트 이름 변경 */
+    async setName(newName) {
+        const wbXmlData = await this._getWbData();
+        wbXmlData.setWorksheetNameById(this._relId, newName);
+    }
+    //#endregion
+    //#region Cell Access Methods
+    /** 행 객체 반환 (0 기반) */
+    row(r) {
+        return this._rowMap.getOrCreate(r, new ExcelRow(this._zipCache, this._targetFileName, r));
+    }
+    /** 셀 객체 반환 (0 기반 행/열) */
+    cell(r, c) {
+        return this.row(r).cell(c);
+    }
+    /** 열 객체 반환 (0 기반) */
+    col(c) {
+        return this._colMap.getOrCreate(c, new ExcelCol(this._zipCache, this._targetFileName, c));
     }
-  }
-  /** Copy style from source cell to target cell */
-  async copyCellStyle(srcAddr, targetAddr) {
-    const wsData = await this._getWsData();
-    const styleId = wsData.getCellStyleId(srcAddr);
-    if (styleId != null) {
-      wsData.setCellStyleId(targetAddr, styleId);
+    //#endregion
+    //#region Copy Methods
+    /** 원본 행에서 대상 행으로 스타일 복사 */
+    async copyRowStyle(srcR, targetR) {
+        const range = await this.getRange();
+        for (let c = range.s.c; c <= range.e.c; c++) {
+            await this.copyCellStyle({ r: srcR, c: c }, { r: targetR, c: c });
+        }
+    }
+    /** 원본 셀에서 대상 셀로 스타일 복사 */
+    async copyCellStyle(srcAddr, targetAddr) {
+        const wsData = await this._getWsData();
+        const styleId = wsData.getCellStyleId(srcAddr);
+        if (styleId != null) {
+            wsData.setCellStyleId(targetAddr, styleId);
+        }
     }
-  }
-  /** Copy source row to target row (overwrite) */
-  async copyRow(srcR, targetR) {
-    const wsData = await this._getWsData();
-    wsData.copyRow(srcR, targetR);
-  }
-  /** Copy source cell to target cell */
-  async copyCell(srcAddr, targetAddr) {
-    const wsData = await this._getWsData();
-    wsData.copyCell(srcAddr, targetAddr);
-  }
-  /**
-   * Insert-copy the source row at the target position.
-   * Existing rows at and below the target are shifted down by one.
-   * @param srcR Source row index to copy (0-based)
-   * @param targetR Target row index to insert at (0-based)
-   */
-  async insertCopyRow(srcR, targetR) {
-    const wsData = await this._getWsData();
-    const range = wsData.range;
-    wsData.shiftMergeCells(targetR, 1);
-    const adjustedSrcR = srcR >= targetR ? srcR + 1 : srcR;
-    for (let r = range.e.r; r >= targetR; r--) {
-      wsData.copyRow(r, r + 1, { skipMerge: true });
+    /** 원본 행을 대상 행으로 복사 (덮어쓰기) */
+    async copyRow(srcR, targetR) {
+        const wsData = await this._getWsData();
+        wsData.copyRow(srcR, targetR);
     }
-    wsData.copyRow(adjustedSrcR, targetR);
-  }
-  //#endregion
-  //#region Range Methods
-  /** Return data range of the worksheet */
-  async getRange() {
-    const xml = await this._getWsData();
-    return xml.range;
-  }
-  /** Return all cells as a 2D array */
-  async getCells() {
-    const xml = await this._getWsData();
-    const range = xml.range;
-    const promises = [];
-    for (let r = range.s.r; r <= range.e.r; r++) {
-      promises.push(this.row(r).getCells());
+    /** 원본 셀을 대상 셀로 복사 */
+    async copyCell(srcAddr, targetAddr) {
+        const wsData = await this._getWsData();
+        wsData.copyCell(srcAddr, targetAddr);
     }
-    return Promise.all(promises);
-  }
-  //#endregion
-  //#region Data Methods
-  /**
-   * Return worksheet data as a table (record array).
-   * @param opt.headerRowIndex Header row index (default: first row)
-   * @param opt.checkEndColIndex Column index to determine data end. Data ends when this column is empty.
-   * @param opt.usableHeaderNameFn Function to filter usable headers
-   */
-  async getDataTable(opt) {
-    const result = [];
-    const headerMap = /* @__PURE__ */ new Map();
-    const xml = await this._getWsData();
-    const range = xml.range;
-    const startRow = (opt == null ? void 0 : opt.headerRowIndex) ?? range.s.r;
-    for (let c = range.s.c; c <= range.e.c; c++) {
-      const headerName = await this.cell(startRow, c).getValue();
-      if (typeof headerName === "string") {
-        if ((opt == null ? void 0 : opt.usableHeaderNameFn) == null || opt.usableHeaderNameFn(headerName)) {
-          headerMap.set(headerName, c);
+    /**
+     * 원본 행을 대상 위치에 삽입 복사한다.
+     * 대상 위치 이하의 기존 행은 한 칸 아래로 밀린다.
+     * @param srcR 복사할 원본 행 인덱스 (0 기반)
+     * @param targetR 삽입할 대상 행 인덱스 (0 기반)
+     */
+    async insertCopyRow(srcR, targetR) {
+        const wsData = await this._getWsData();
+        const range = wsData.range;
+        // targetR 이하의 병합 셀을 1칸 아래로 이동
+        // 삽입 지점을 관통하는 다중행 병합은 자동으로 1행 확장됨
+        wsData.shiftMergeCells(targetR, 1);
+        // srcR >= targetR인 경우, srcR의 이동된 위치를 보정
+        const adjustedSrcR = srcR >= targetR ? srcR + 1 : srcR;
+        // 기존 행을 아래로 이동 (덮어쓰기 방지를 위해 아래에서 위로)
+        // 병합 셀은 위에서 이미 이동했으므로 skipMerge: true 사용
+        for (let r = range.e.r; r >= targetR; r--) {
+            wsData.copyRow(r, r + 1, { skipMerge: true });
         }
-      }
+        // 원본 행을 대상 위치에 복사 (병합은 skipMerge로 건너뜀)
+        wsData.copyRow(adjustedSrcR, targetR, { skipMerge: true });
+        // 원본 행의 단일행 병합만 대상 행에 복사
+        // (다중행 병합은 shiftMergeCells에서 이미 확장 처리됨)
+        const allMergeCells = wsData.getMergeCells();
+        const sourceMergeCells = allMergeCells.filter((mc) => mc.s.r === adjustedSrcR && mc.e.r === adjustedSrcR);
+        for (const mergeCell of sourceMergeCells) {
+            const newStartAddr = { r: targetR, c: mergeCell.s.c };
+            const newEndAddr = { r: targetR, c: mergeCell.e.c };
+            wsData.setMergeCells(newStartAddr, newEndAddr);
+        }
+    }
+    //#endregion
+    //#region Range Methods
+    /** 워크시트의 데이터 범위 반환 */
+    async getRange() {
+        const xml = await this._getWsData();
+        return xml.range;
     }
-    for (let r = startRow + 1; r <= range.e.r; r++) {
-      if ((opt == null ? void 0 : opt.checkEndColIndex) !== void 0 && await this.cell(r, opt.checkEndColIndex).getValue() === void 0) {
-        break;
-      }
-      const record = {};
-      for (const header of headerMap.keys()) {
-        const c = headerMap.get(header);
-        record[header] = await this.cell(r, c).getValue();
-      }
-      result.push(record);
+    /** 모든 셀을 2차원 배열로 반환 */
+    async getCells() {
+        const xml = await this._getWsData();
+        const range = xml.range;
+        const promises = [];
+        for (let r = range.s.r; r <= range.e.r; r++) {
+            promises.push(this.row(r).getCells());
+        }
+        return Promise.all(promises);
     }
-    return result;
-  }
-  /**
-   * Write 2D array data to the worksheet
-   * @param matrix 2D array data (row-major, index 0 is the first row)
-   */
-  async setDataMatrix(matrix) {
-    for (let r = 0; r < matrix.length; r++) {
-      for (let c = 0; c < matrix[r].length; c++) {
-        await this.cell(r, c).setValue(matrix[r][c]);
-      }
+    //#endregion
+    //#region Data Methods
+    /**
+     * 워크시트 데이터를 테이블(레코드 배열)로 반환한다.
+     * @param opt.headerRowIndex 헤더 행 인덱스 (기본값: 첫 번째 행)
+     * @param opt.checkEndColIndex 데이터 끝을 판단할 열 인덱스. 이 열이 비어있으면 데이터가 끝난 것으로 판단한다.
+     * @param opt.usableHeaderNameFn 사용 가능한 헤더를 필터링하는 함수
+     */
+    async getDataTable(opt) {
+        const result = [];
+        const headerMap = new Map();
+        const xml = await this._getWsData();
+        const range = xml.range;
+        const startRow = opt?.headerRowIndex ?? range.s.r;
+        for (let c = range.s.c; c <= range.e.c; c++) {
+            const headerName = await this.cell(startRow, c).getValue();
+            if (typeof headerName === "string") {
+                if (opt?.usableHeaderNameFn == null || opt.usableHeaderNameFn(headerName)) {
+                    if (headerMap.has(headerName)) {
+                        throw new Error(`중복된 헤더: "${headerName}" (열 ${headerMap.get(headerName)}과 열 ${c})`);
+                    }
+                    headerMap.set(headerName, c);
+                }
+            }
+        }
+        for (let r = startRow + 1; r <= range.e.r; r++) {
+            if (opt?.checkEndColIndex !== undefined &&
+                (await this.cell(r, opt.checkEndColIndex).getValue()) === undefined) {
+                break;
+            }
+            const record = {};
+            for (const header of headerMap.keys()) {
+                const c = headerMap.get(header);
+                record[header] = await this.cell(r, c).getValue();
+            }
+            result.push(record);
+        }
+        return result;
     }
-  }
-  /**
-   * Write record array to the worksheet
-   * @param records Record array. Headers are auto-generated in the first row, data follows in subsequent rows.
-   */
-  async setRecords(records) {
-    const headers = records.flatMap((item) => Object.keys(item)).distinct().filter((item) => !str.isNullOrEmpty(item));
-    for (let c = 0; c < headers.length; c++) {
-      await this.cell(0, c).setValue(headers[c]);
+    /**
+     * 2차원 배열 데이터를 워크시트에 쓰기
+     * @param matrix 2차원 배열 데이터 (행 우선, 인덱스 0이 첫 번째 행)
+     */
+    async setDataMatrix(matrix) {
+        for (let r = 0; r < matrix.length; r++) {
+            for (let c = 0; c < matrix[r].length; c++) {
+                await this.cell(r, c).setValue(matrix[r][c]);
+            }
+        }
     }
-    for (let r = 1; r < records.length + 1; r++) {
-      for (let c = 0; c < headers.length; c++) {
-        await this.cell(r, c).setValue(records[r - 1][headers[c]]);
-      }
+    /**
+     * 레코드 배열을 워크시트에 쓰기
+     * @param records 레코드 배열. 첫 번째 행에 헤더가 자동 생성되고, 이후 행에 데이터가 기록된다.
+     */
+    async setRecords(records) {
+        const headers = records
+            .flatMap((item) => Object.keys(item))
+            .distinct()
+            .filter((item) => !str.isNullOrEmpty(item));
+        for (let c = 0; c < headers.length; c++) {
+            await this.cell(0, c).setValue(headers[c]);
+        }
+        for (let r = 1; r < records.length + 1; r++) {
+            for (let c = 0; c < headers.length; c++) {
+                await this.cell(r, c).setValue(records[r - 1][headers[c]]);
+            }
+        }
     }
-  }
-  //#endregion
-  //#region View Methods
-  /** Set worksheet zoom scale (percent) */
-  async setZoom(percent) {
-    const wbXml = await this._getWbData();
-    wbXml.initializeView();
-    const wsXml = await this._getWsData();
-    wsXml.setZoom(percent);
-  }
-  /** Set freeze panes for rows/columns */
-  async freezeAt(point) {
-    const wbXml = await this._getWbData();
-    wbXml.initializeView();
-    const wsXml = await this._getWsData();
-    wsXml.freezeAt(point);
-  }
-  //#endregion
-  //#region Image Methods
-  /**
-   * Insert an image into the worksheet.
-   * @param opts.bytes Image binary data
-   * @param opts.ext Image extension (png, jpg, etc.)
-   * @param opts.from Image start position (0-based row/column index, rOff/cOff in EMU offset)
-   * @param opts.to Image end position (if omitted, inserted at from position with original size)
-   */
-  async addImage(opts) {
-    var _a;
-    const mimeType = mime.getType(opts.ext);
-    if (mimeType == null) {
-      throw new Error(`Cannot determine MIME type for extension '${opts.ext}'`);
+    //#endregion
+    //#region View Methods
+    /** 워크시트 확대/축소 비율 설정 (퍼센트) */
+    async setZoom(percent) {
+        const wbXml = await this._getWbData();
+        wbXml.initializeView();
+        const wsXml = await this._getWsData();
+        wsXml.setZoom(percent);
     }
-    let mediaIndex = 1;
-    while (await this._zipCache.get(`xl/media/image${mediaIndex}.${opts.ext}`) !== void 0) {
-      mediaIndex++;
+    /** 행/열 틀 고정 설정 */
+    async freezeAt(point) {
+        const wbXml = await this._getWbData();
+        wbXml.initializeView();
+        const wsXml = await this._getWsData();
+        wsXml.freezeAt(point);
     }
-    const mediaPath = `xl/media/image${mediaIndex}.${opts.ext}`;
-    this._zipCache.set(mediaPath, opts.bytes);
-    const typeXml = await this._zipCache.get("[Content_Types].xml");
-    typeXml.add(`/xl/media/image${mediaIndex}.${opts.ext}`, mimeType);
-    const wsXml = await this._getWsData();
-    const sheetRelsPath = `xl/worksheets/_rels/${this._targetFileName}.rels`;
-    let sheetRels = await this._zipCache.get(sheetRelsPath);
-    let drawingIndex;
-    let drawingPath;
-    let drawing;
-    let drawingRels;
-    if (sheetRels != null) {
-      const existingDrawingRel = (_a = sheetRels.data.Relationships.Relationship) == null ? void 0 : _a.find(
-        (r) => r.$.Type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"
-      );
-      if (existingDrawingRel != null) {
-        const match = existingDrawingRel.$.Target.match(/drawing(\d+)\.xml$/);
-        if (match != null) {
-          drawingIndex = parseInt(match[1], 10);
-          drawingPath = `xl/drawings/drawing${drawingIndex}.xml`;
-          drawing = await this._zipCache.get(drawingPath);
-          drawingRels = await this._zipCache.get(
-            `xl/drawings/_rels/drawing${drawingIndex}.xml.rels`
-          );
+    //#endregion
+    //#region Image Methods
+    /**
+     * 워크시트에 이미지를 삽입한다.
+     * @param opts.bytes 이미지 바이너리 데이터
+     * @param opts.ext 이미지 확장자 (png, jpg 등)
+     * @param opts.from 이미지 시작 위치 (0 기반 행/열 인덱스, rOff/cOff는 EMU 오프셋)
+     * @param opts.to 이미지 끝 위치 (생략 시 from 위치에 원본 크기로 삽입)
+     */
+    async addImage(opts) {
+        const mimeType = mime.getType(opts.ext);
+        if (mimeType == null) {
+            throw new Error(`확장자 '${opts.ext}'에 대한 MIME 타입을 결정할 수 없습니다`);
+        }
+        // 1. 미디어 파일명 결정 및 저장
+        let mediaIndex = 1;
+        while ((await this._zipCache.get(`xl/media/image${mediaIndex}.${opts.ext}`)) !== undefined) {
+            mediaIndex++;
+        }
+        const mediaPath = `xl/media/image${mediaIndex}.${opts.ext}`;
+        this._zipCache.set(mediaPath, opts.bytes);
+        // 2. [Content_Types].xml 갱신
+        const typeXml = (await this._zipCache.get("[Content_Types].xml"));
+        typeXml.add(`/xl/media/image${mediaIndex}.${opts.ext}`, mimeType);
+        // 3. 워크시트의 기존 drawing 확인
+        const wsXml = await this._getWsData();
+        const sheetRelsPath = `xl/worksheets/_rels/${this._targetFileName}.rels`;
+        let sheetRels = (await this._zipCache.get(sheetRelsPath));
+        // 기존 drawing 찾기
+        let drawingIndex;
+        let drawingPath;
+        let drawing;
+        let drawingRels;
+        if (sheetRels != null) {
+            const existingDrawingRel = sheetRels.data.Relationships.Relationship?.find((r) => r.$.Type ===
+                "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing");
+            if (existingDrawingRel != null) {
+                // 기존 drawing 경로에서 인덱스 추출
+                const match = existingDrawingRel.$.Target.match(/drawing(\d+)\.xml$/);
+                if (match != null) {
+                    drawingIndex = parseInt(match[1], 10);
+                    drawingPath = `xl/drawings/drawing${drawingIndex}.xml`;
+                    drawing = (await this._zipCache.get(drawingPath));
+                    drawingRels = (await this._zipCache.get(`xl/drawings/_rels/drawing${drawingIndex}.xml.rels`));
+                }
+            }
         }
-      }
+        // 4. 기존 drawing이 없으면 새로 생성
+        if (drawingIndex == null || drawingPath == null || drawing == null) {
+            drawingIndex = 1;
+            while ((await this._zipCache.get(`xl/drawings/drawing${drawingIndex}.xml`)) !== undefined) {
+                drawingIndex++;
+            }
+            drawingPath = `xl/drawings/drawing${drawingIndex}.xml`;
+            drawing = new ExcelXmlDrawing();
+            // [Content_Types].xml에 drawing 타입 추가
+            typeXml.add("/" + drawingPath, "application/vnd.openxmlformats-officedocument.drawing+xml");
+            // 워크시트 rels에 drawing 추가
+            sheetRels = sheetRels ?? new ExcelXmlRelationship();
+            const sheetRelNum = sheetRels.addAndGetId(`../drawings/drawing${drawingIndex}.xml`, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing");
+            const drawingRelIdOnWorksheet = `rId${sheetRelNum}`;
+            this._zipCache.set(sheetRelsPath, sheetRels);
+            // 워크시트 XML에 drawing 추가
+            wsXml.data.worksheet.$["xmlns:r"] =
+                wsXml.data.worksheet.$["xmlns:r"] ??
+                    "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+            wsXml.data.worksheet.drawing = wsXml.data.worksheet.drawing ?? [];
+            wsXml.data.worksheet.drawing.push({ $: { "r:id": drawingRelIdOnWorksheet } });
+            this._zipCache.set(`xl/worksheets/${this._targetFileName}`, wsXml);
+        }
+        // 5. drawing rels 준비 (없으면 생성)
+        drawingRels = drawingRels ?? new ExcelXmlRelationship();
+        const mediaFileName = mediaPath.slice(3);
+        const drawingTarget = `../${mediaFileName}`;
+        const relNum = drawingRels.addAndGetId(drawingTarget, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image");
+        this._zipCache.set(`xl/drawings/_rels/drawing${drawingIndex}.xml.rels`, drawingRels);
+        // 6. drawing에 이미지 추가
+        const blipRelId = `rId${relNum}`;
+        drawing.addPicture({
+            from: opts.from,
+            to: opts.to ?? { r: opts.from.r + 1, c: opts.from.c + 1 },
+            blipRelId: blipRelId,
+        });
+        this._zipCache.set(drawingPath, drawing);
+    }
+    //#endregion
+    //#region Private Methods
+    async _getWsData() {
+        return (await this._zipCache.get(`xl/worksheets/${this._targetFileName}`));
     }
-    if (drawingIndex == null || drawingPath == null || drawing == null) {
-      drawingIndex = 1;
-      while (await this._zipCache.get(`xl/drawings/drawing${drawingIndex}.xml`) !== void 0) {
-        drawingIndex++;
-      }
-      drawingPath = `xl/drawings/drawing${drawingIndex}.xml`;
-      drawing = new ExcelXmlDrawing();
-      typeXml.add("/" + drawingPath, "application/vnd.openxmlformats-officedocument.drawing+xml");
-      sheetRels = sheetRels ?? new ExcelXmlRelationship();
-      const sheetRelNum = sheetRels.addAndGetId(
-        `../drawings/drawing${drawingIndex}.xml`,
-        "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"
-      );
-      const drawingRelIdOnWorksheet = `rId${sheetRelNum}`;
-      this._zipCache.set(sheetRelsPath, sheetRels);
-      wsXml.data.worksheet.$["xmlns:r"] = wsXml.data.worksheet.$["xmlns:r"] ?? "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-      wsXml.data.worksheet.drawing = wsXml.data.worksheet.drawing ?? [];
-      wsXml.data.worksheet.drawing.push({ $: { "r:id": drawingRelIdOnWorksheet } });
-      this._zipCache.set(`xl/worksheets/${this._targetFileName}`, wsXml);
+    async _getWbData() {
+        return (await this._zipCache.get("xl/workbook.xml"));
     }
-    drawingRels = drawingRels ?? new ExcelXmlRelationship();
-    const mediaFileName = mediaPath.slice(3);
-    const drawingTarget = `../${mediaFileName}`;
-    const relNum = drawingRels.addAndGetId(
-      drawingTarget,
-      "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
-    );
-    this._zipCache.set(`xl/drawings/_rels/drawing${drawingIndex}.xml.rels`, drawingRels);
-    const blipRelId = `rId${relNum}`;
-    drawing.addPicture({
-      from: opts.from,
-      to: opts.to ?? { r: opts.from.r + 1, c: opts.from.c + 1 },
-      blipRelId
-    });
-    this._zipCache.set(drawingPath, drawing);
-  }
-  //#endregion
-  //#region Private Methods
-  async _getWsData() {
-    return await this._zipCache.get(`xl/worksheets/${this._targetFileName}`);
-  }
-  async _getWbData() {
-    return await this._zipCache.get("xl/workbook.xml");
-  }
-  //#endregion
 }
-export {
-  ExcelWorksheet
-};
-//# sourceMappingURL=excel-worksheet.js.map
+//# sourceMappingURL=excel-worksheet.js.map

package/dist/excel-worksheet.js.map

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

package/dist/excel-wrapper.d.ts

@@ -2,28 +2,28 @@ import type { Bytes } from "@simplysm/core-common";
 import { type z } from "zod";
 import { ExcelWorkbook } from "./excel-workbook";
 /**
- * Zod schema-based Excel wrapper
+ * Zod 스키마 기반 Excel 래퍼
  *
- * Infers type information from schema to provide type-safe read/write
+ * 스키마에서 타입 정보를 추론하여 타입 안전한 읽기/쓰기를 제공한다
  */
 export declare class ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>> {
     private readonly _schema;
     /**
-     * @param _schema Zod schema (defines record structure, use `.describe()` to specify Excel header names)
+     * @param _schema Zod 스키마 (레코드 구조를 정의하며, `.describe()`로 Excel 헤더 이름을 지정)
      */
     constructor(_schema: TSchema);
     /**
-     * Read Excel file into record array
+     * Excel 파일을 레코드 배열로 읽기
      */
     read(file: Bytes | Blob, wsNameOrIndex?: string | number, options?: {
         excludes?: (keyof z.infer<TSchema>)[];
     }): Promise<z.infer<TSchema>[]>;
     /**
-     * Record array to Excel workbook
+     * 레코드 배열을 Excel 워크북으로 변환
      *
      * @remarks
-     * The caller is responsible for managing the returned workbook's resources.
-     * Use `await using` or call `close()` after use.
+     * 반환된 워크북의 리소스 관리는 호출자의 책임이다.
+     * `await using`을 사용하거나 사용 후 `close()`를 호출해야 한다.
      *
      * @example
      * ```typescript