@simplysm/excel 13.0.100 → 14.0.4

package/dist/excel-worksheet.d.ts

@@ -6,8 +6,8 @@ import { ExcelRow } from "./excel-row";
 import type { ExcelAddressPoint, ExcelAddressRangePoint, ExcelValueType } from "./types";
 import type { ZipCache } from "./utils/zip-cache";
 /**
- * Class representing an Excel worksheet.
- * Provides cell access, row/column copying, data table processing, and image insertion.
+ * Excel 워크시트를 나타내는 클래스.
+ * 셀 접근, 행/열 복사, 데이터 테이블 처리, 이미지 삽입 기능을 제공한다.
  */
 export declare class ExcelWorksheet {
     private readonly _zipCache;
@@ -16,40 +16,40 @@ export declare class ExcelWorksheet {
     private readonly _rowMap;
     private readonly _colMap;
     constructor(_zipCache: ZipCache, _relId: number, _targetFileName: string);
-    /** Return worksheet name */
+    /** 워크시트 이름 반환 */
     getName(): Promise<string>;
-    /** Rename worksheet */
+    /** 워크시트 이름 변경 */
     setName(newName: string): Promise<void>;
-    /** Return row object (0-based) */
+    /** 행 객체 반환 (0 기반) */
     row(r: number): ExcelRow;
-    /** Return cell object (0-based row/column) */
+    /** 셀 객체 반환 (0 기반 행/열) */
     cell(r: number, c: number): ExcelCell;
-    /** Return column object (0-based) */
+    /** 열 객체 반환 (0 기반) */
     col(c: number): ExcelCol;
-    /** Copy style from source row to target row */
+    /** 원본 행에서 대상 행으로 스타일 복사 */
     copyRowStyle(srcR: number, targetR: number): Promise<void>;
-    /** Copy style from source cell to target cell */
+    /** 원본 셀에서 대상 셀로 스타일 복사 */
     copyCellStyle(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint): Promise<void>;
-    /** Copy source row to target row (overwrite) */
+    /** 원본 행을 대상 행으로 복사 (덮어쓰기) */
     copyRow(srcR: number, targetR: number): Promise<void>;
-    /** Copy source cell to target cell */
+    /** 원본 셀을 대상 셀로 복사 */
     copyCell(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint): Promise<void>;
     /**
-     * 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)
+     * 원본 행을 대상 위치에 삽입 복사한다.
+     * 대상 위치 이하의 기존 행은 한 칸 아래로 밀린다.
+     * @param srcR 복사할 원본 행 인덱스 (0 기반)
+     * @param targetR 삽입할 대상 행 인덱스 (0 기반)
      */
     insertCopyRow(srcR: number, targetR: number): Promise<void>;
-    /** Return data range of the worksheet */
+    /** 워크시트의 데이터 범위 반환 */
     getRange(): Promise<ExcelAddressRangePoint>;
-    /** Return all cells as a 2D array */
+    /** 모든 셀을 2차원 배열로 반환 */
     getCells(): Promise<ExcelCell[][]>;
     /**
-     * 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
+     * 워크시트 데이터를 테이블(레코드 배열)로 반환한다.
+     * @param opt.headerRowIndex 헤더 행 인덱스 (기본값: 첫 번째 행)
+     * @param opt.checkEndColIndex 데이터 끝을 판단할 열 인덱스. 이 열이 비어있으면 데이터가 끝난 것으로 판단한다.
+     * @param opt.usableHeaderNameFn 사용 가능한 헤더를 필터링하는 함수
      */
     getDataTable(opt?: {
         headerRowIndex?: number;
@@ -57,28 +57,28 @@ export declare class ExcelWorksheet {
         usableHeaderNameFn?: (headerName: string) => boolean;
     }): Promise<Record<string, ExcelValueType>[]>;
     /**
-     * Write 2D array data to the worksheet
-     * @param matrix 2D array data (row-major, index 0 is the first row)
+     * 2차원 배열 데이터를 워크시트에 쓰기
+     * @param matrix 2차원 배열 데이터 (행 우선, 인덱스 0이 첫 번째 행)
      */
     setDataMatrix(matrix: ExcelValueType[][]): Promise<void>;
     /**
-     * Write record array to the worksheet
-     * @param records Record array. Headers are auto-generated in the first row, data follows in subsequent rows.
+     * 레코드 배열을 워크시트에 쓰기
+     * @param records 레코드 배열. 첫 번째 행에 헤더가 자동 생성되고, 이후 행에 데이터가 기록된다.
      */
     setRecords(records: Record<string, ExcelValueType>[]): Promise<void>;
-    /** Set worksheet zoom scale (percent) */
+    /** 워크시트 확대/축소 비율 설정 (퍼센트) */
     setZoom(percent: number): Promise<void>;
-    /** Set freeze panes for rows/columns */
+    /** 행/열 틀 고정 설정 */
     freezeAt(point: {
         r?: number;
         c?: number;
     }): Promise<void>;
     /**
-     * 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)
+     * 워크시트에 이미지를 삽입한다.
+     * @param opts.bytes 이미지 바이너리 데이터
+     * @param opts.ext 이미지 확장자 (png, jpg 등)
+     * @param opts.from 이미지 시작 위치 (0 기반 행/열 인덱스, rOff/cOff는 EMU 오프셋)
+     * @param opts.to 이미지 끝 위치 (생략 시 from 위치에 원본 크기로 삽입)
      */
     addImage(opts: {
         bytes: Bytes;

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

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