@simplysm/excel 14.0.48 → 14.0.50

package/README.md

@@ -12,63 +12,41 @@ npm install @simplysm/excel
 
 ### Core Classes
 
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelWorkbook` | class | Excel 워크북 진입점. 워크시트 생성/조회, 바이트 내보내기, ZIP 리소스 관리 |
-| `ExcelWorksheet` | class | 워크시트. 셀/행/열 접근, 행/셀 복사, 데이터 테이블 읽기, 이미지 삽입, 시트명 변경 |
-| `ExcelCell` | class | 개별 셀. 값/수식 읽기/쓰기, 스타일 설정, 셀 병합 |
-| `ExcelRow` | class | 워크시트 행. 셀 접근, 행 전체 셀 조회 |
-| `ExcelCol` | class | 워크시트 열. 셀 접근, 열 너비 설정 |
-
-→ See [docs/core-classes.md](./docs/core-classes.md) for details.
+| Entry | Kind | Description |
+|-------|------|-------------|
+| [`ExcelWorkbook`](./docs/core-classes/excel-workbook.md) | class | Excel 워크북 진입점. 워크시트 생성/조회, 바이트 내보내기, ZIP 리소스 관리 |
+| [`ExcelWorksheet`](./docs/core-classes/excel-worksheet.md) | class | 워크시트. 셀/행/열 접근, 행/셀 복사, 데이터 테이블 읽기, 이미지 삽입, 시트명 변경 |
+| [`ExcelCell`](./docs/core-classes/excel-cell.md) | class | 개별 셀. 값/수식 읽기/쓰기, 스타일 설정, 셀 병합 |
+| [`ExcelRow`](./docs/core-classes/excel-row.md) | class | 워크시트 행. 셀 접근, 행 전체 셀 조회 |
+| [`ExcelCol`](./docs/core-classes/excel-col.md) | class | 워크시트 열. 셀 접근, 열 너비 설정 |
 
 ### Wrapper
 
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelWrapper` | class | Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기. 헤더 자동 생성, 유효성 검사, 필수 필드 강조 |
-
-→ See [docs/wrapper.md](./docs/wrapper.md) for details.
+| Entry | Kind | Description |
+|-------|------|-------------|
+| [`ExcelWrapper`](./docs/wrapper/excel-wrapper.md) | class | Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기. 헤더 자동 생성, 유효성 검사, 필수 필드 강조 |
 
 ### Utilities
 
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelUtils` | class | 셀 주소 변환 (좌표↔문자열), 날짜↔숫자 변환, 숫자 형식 매핑 (정적 메서드) |
-
-→ See [docs/utilities.md](./docs/utilities.md) for details.
+| Entry | Kind | Description |
+|-------|------|-------------|
+| [`ExcelUtils`](./docs/utilities/excel-utils.md) | class | 셀 주소 변환 (좌표↔문자열), 날짜↔숫자 변환, 숫자 형식 매핑 (정적 메서드) |
 
 ### Types
 
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelValueType` | type | 셀 값 타입: number, string, DateOnly, DateTime, Time, boolean, undefined |
-| `ExcelNumberFormat` | type | 숫자 형식 이름: "number", "string", "DateOnly", "DateTime", "Time" |
-| `ExcelCellType` | type | 셀 타입: "s"(공유문자열), "b"(boolean), "str"(수식문자열), "n"(숫자), "inlineStr", "e"(에러) |
-| `ExcelAddressPoint` | interface | 셀 좌표 (0 기반 r, c) |
-| `ExcelAddressRangePoint` | interface | 셀 범위 좌표 (시작점 s, 끝점 e) |
-| `ExcelStyleOptions` | interface | 셀 스타일 옵션 (배경색, 테두리, 정렬, 숫자 형식) |
-| `ExcelBorderPosition` | type | 테두리 위치: "left", "right", "top", "bottom" |
-| `ExcelHorizontalAlign` | type | 가로 정렬: "left", "center", "right" |
-| `ExcelVerticalAlign` | type | 세로 정렬: "top", "center", "bottom" |
-| `ExcelXml` | interface | XML 처리 클래스가 구현하는 인터페이스 (내부용) |
-| `ExcelXmlContentTypeData` | interface | `[Content_Types].xml` 데이터 구조 (내부용) |
-| `ExcelXmlRelationshipData` | interface | `*.rels` 파일 데이터 구조 (내부용) |
-| `ExcelRelationshipData` | interface | 개별 Relationship 엔트리 데이터 (내부용) |
-| `ExcelXmlWorkbookData` | interface | `workbook.xml` 데이터 구조 (내부용) |
-| `ExcelXmlWorksheetData` | interface | `worksheet*.xml` 데이터 구조 (내부용) |
-| `ExcelRowData` | interface | 행 XML 데이터 (내부용) |
-| `ExcelCellData` | interface | 셀 XML 데이터 (내부용) |
-| `ExcelXmlDrawingData` | interface | `drawing*.xml` 데이터 구조 (내부용) |
-| `ExcelXmlSharedStringData` | interface | `sharedStrings.xml` 데이터 구조 (내부용) |
-| `ExcelXmlSharedStringDataSi` | type | SharedString 개별 항목 (단순 텍스트 or rich text) |
-| `ExcelXmlSharedStringDataText` | type | SharedString 텍스트 데이터 (내부용) |
-| `ExcelXmlStyleData` | interface | `styles.xml` 데이터 구조 (내부용) |
-| `ExcelXmlStyleDataXf` | interface | 셀 서식(xf) 데이터 (내부용) |
-| `ExcelXmlStyleDataFill` | interface | 채우기 스타일 데이터 (내부용) |
-| `ExcelXmlStyleDataBorder` | interface | 테두리 스타일 데이터 (내부용) |
-
-→ See [docs/types.md](./docs/types.md) for details.
+| Entry | Kind | Description |
+|-------|------|-------------|
+| [`ExcelValueType`](./docs/types/excel-value-type.md) | type | 셀 값 타입: number, string, DateOnly, DateTime, Time, boolean, undefined. `ExcelCellType` 포함 |
+| [`ExcelAddressPoint`](./docs/types/excel-address-point.md) | interface | 셀 좌표 (0 기반 r, c). `ExcelAddressRangePoint` 포함 |
+| [`ExcelStyleOptions`](./docs/types/excel-style-options.md) | interface | 셀 스타일 옵션 (배경색, 테두리, 정렬, 숫자 형식). `ExcelNumberFormat`, `ExcelBorderPosition`, `ExcelHorizontalAlign`, `ExcelVerticalAlign` 포함 |
+| [`ExcelXml`](./docs/types/excel-xml.md) | interface | XML 처리 클래스가 구현하는 인터페이스 (내부용) |
+| [`ExcelXmlContentTypeData`](./docs/types/excel-xml-content-type-data.md) | interface | `[Content_Types].xml` 데이터 구조 (내부용) |
+| [`ExcelXmlRelationshipData`](./docs/types/excel-xml-relationship-data.md) | interface | `*.rels` 파일 데이터 구조 (내부용). `ExcelRelationshipData` 포함 |
+| [`ExcelXmlWorkbookData`](./docs/types/excel-xml-workbook-data.md) | interface | `workbook.xml` 데이터 구조 (내부용) |
+| [`ExcelXmlWorksheetData`](./docs/types/excel-xml-worksheet-data.md) | interface | `worksheet*.xml` 데이터 구조 (내부용). `ExcelRowData`, `ExcelCellData` 포함 |
+| [`ExcelXmlDrawingData`](./docs/types/excel-xml-drawing-data.md) | interface | `drawing*.xml` 데이터 구조 (내부용) |
+| [`ExcelXmlSharedStringData`](./docs/types/excel-xml-shared-string-data.md) | interface | `sharedStrings.xml` 데이터 구조 (내부용). `ExcelXmlSharedStringDataSi`, `ExcelXmlSharedStringDataText` 포함 |
+| [`ExcelXmlStyleData`](./docs/types/excel-xml-style-data.md) | interface | `styles.xml` 데이터 구조 (내부용). `ExcelXmlStyleDataXf`, `ExcelXmlStyleDataFill`, `ExcelXmlStyleDataBorder` 포함 |
 
 ## Usage Examples
 

package/dist/xml/excel-xml-workbook.js

@@ -96,8 +96,8 @@ export class ExcelXmlWorkbook {
         return (this.data.workbook.sheets?.[0].sheet ?? []).single((item) => num.parseInt(item.$["r:id"]) === id);
     }
     _getReplacedName(name) {
-        //-- 잘못된 시트 이름 문자를 "_"로 대체
-        return name.replace(/[:\\/?*\[\]']/g, "_");
+        //-- 잘못된 시트 이름 문자 제거. 전부 제거되어 빈 문자열이 되면 "Sheet" 사용.
+        return name.replace(/[:\\/?*\[\]']/g, "") || "Sheet";
     }
 }
 //# sourceMappingURL=excel-xml-workbook.js.map

package/dist/xml/excel-xml-workbook.js.map

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

package/docs/core-classes/excel-cell.md

@@ -0,0 +1,73 @@
+# ExcelCell
+
+Excel 셀을 나타내는 클래스. 값 읽기/쓰기, 수식, 스타일, 셀 병합 기능을 제공한다.
+
+모든 메서드가 `async`인 이유는 셀 타입에 따라 필요한 XML만 선택적으로 로드하는 Lazy Loading 아키텍처 때문이다. 문자열 셀은 `sharedStrings.xml`을 로드하고, 숫자 셀은 로드하지 않는다.
+
+```typescript
+export class ExcelCell {
+  readonly addr: ExcelAddressPoint;
+
+  constructor(zipCache: ZipCache, targetFileName: string, r: number, c: number);
+
+  // Value
+  async setValue(val: ExcelValueType): Promise<void>;
+  async getValue(): Promise<ExcelValueType>;
+  async setFormula(val: string | undefined): Promise<void>;
+  async getFormula(): Promise<string | undefined>;
+
+  // Merge
+  async merge(r: number, c: number): Promise<void>;
+
+  // Style
+  async getStyleId(): Promise<string | undefined>;
+  async setStyleId(styleId: string | undefined): Promise<void>;
+  async setStyle(opts: ExcelStyleOptions): Promise<void>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `addr` | property | `ExcelAddressPoint` | 셀 주소 (0 기반 행/열 인덱스, read-only) |
+| `setValue` | method | `(val: ExcelValueType) => Promise<void>` | 셀 값 설정. `undefined` 전달 시 셀 삭제. `DateOnly`/`DateTime`/`Time`은 Excel 날짜 숫자로 변환하고 numFmt 설정 |
+| `getValue` | method | `() => Promise<ExcelValueType>` | 셀 값 반환. 비어있는 셀은 `undefined` 반환. 셀 타입과 스타일에 따라 적절한 JS 타입으로 변환 |
+| `setFormula` | method | `(val: string \| undefined) => Promise<void>` | 셀 수식 설정. `undefined` 전달 시 수식 제거 |
+| `getFormula` | method | `() => Promise<string \| undefined>` | 셀 수식 반환. 수식 없으면 `undefined` 반환 |
+| `merge` | method | `(r: number, c: number) => Promise<void>` | 현재 셀에서 지정된 끝 좌표까지 셀 병합 |
+| `getStyleId` | method | `() => Promise<string \| undefined>` | 셀의 스타일 ID 반환. 스타일 없으면 `undefined` 반환 |
+| `setStyleId` | method | `(styleId: string \| undefined) => Promise<void>` | 셀의 스타일 ID 직접 설정 |
+| `setStyle` | method | `(opts: ExcelStyleOptions) => Promise<void>` | 셀 스타일 설정. 기존 스타일이 있으면 클론 후 병합 |
+
+## Usage
+
+```typescript
+// 값 설정/읽기
+await ws.cell(0, 0).setValue("텍스트");
+await ws.cell(0, 1).setValue(42);
+await ws.cell(0, 2).setValue(new DateOnly(2024, 6, 15));
+await ws.cell(0, 3).setValue(true);
+await ws.cell(0, 4).setValue(undefined); // 셀 삭제
+
+const val = await ws.cell(0, 0).getValue(); // "텍스트"
+
+// 수식
+await ws.cell(1, 0).setFormula("SUM(A1:A10)");
+const formula = await ws.cell(1, 0).getFormula(); // "SUM(A1:A10)"
+
+// 셀 병합 (A1:C3 병합)
+await ws.cell(0, 0).merge(2, 2);
+
+// 스타일
+await ws.cell(0, 0).setStyle({
+  background: "00FFFF00",                    // 노란색 배경
+  border: ["left", "right", "top", "bottom"],
+  horizontalAlign: "center",
+  verticalAlign: "center",
+  numberFormat: "number",
+});
+
+// 커스텀 formatCode
+await ws.cell(0, 0).setStyle({ numberFormatCode: "0.000000" });
+```

package/docs/core-classes/excel-col.md

@@ -0,0 +1,36 @@
+# ExcelCol
+
+Excel 워크시트의 열을 나타내는 클래스. 셀 접근 및 열 너비 설정 기능을 제공한다.
+
+```typescript
+export class ExcelCol {
+  constructor(zipCache: ZipCache, targetFileName: string, c: number, cellFactory: (r: number) => ExcelCell);
+
+  cell(r: number): ExcelCell;
+  async getCells(): Promise<ExcelCell[]>;
+  async setWidth(size: number): Promise<void>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `cell` | method | `(r: number) => ExcelCell` | 지정된 행 인덱스의 셀 반환 (0 기반) |
+| `getCells` | method | `() => Promise<ExcelCell[]>` | 열의 모든 셀 반환. 데이터 범위 내의 모든 행에 대한 셀이 포함된다 |
+| `setWidth` | method | `(size: number) => Promise<void>` | 열 너비 설정 |
+
+## Usage
+
+```typescript
+const col = ws.col(1); // B열
+
+// 특정 셀 접근
+const cell = col.cell(0); // B1 셀
+
+// 열의 모든 셀
+const cells = await col.getCells();
+
+// 열 너비 설정
+await ws.col(0).setWidth(20);
+```

package/docs/core-classes/excel-row.md

@@ -0,0 +1,34 @@
+# ExcelRow
+
+Excel 워크시트의 행을 나타내는 클래스. 셀 접근 기능을 제공한다.
+
+```typescript
+export class ExcelRow {
+  constructor(zipCache: ZipCache, targetFileName: string, r: number, cellFactory: (c: number) => ExcelCell);
+
+  cell(c: number): ExcelCell;
+  async getCells(): Promise<ExcelCell[]>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `cell` | method | `(c: number) => ExcelCell` | 지정된 열 인덱스의 셀 반환 (0 기반) |
+| `getCells` | method | `() => Promise<ExcelCell[]>` | 행의 모든 셀 반환. 데이터 범위 내의 모든 열에 대한 셀이 포함된다 |
+
+## Usage
+
+```typescript
+const row = ws.row(0);
+
+// 특정 셀 접근
+const cell = row.cell(2); // C열 셀
+
+// 행의 모든 셀
+const cells = await row.getCells();
+for (const cell of cells) {
+  const val = await cell.getValue();
+}
+```

package/docs/core-classes/excel-workbook.md

@@ -0,0 +1,59 @@
+# ExcelWorkbook
+
+Excel 워크북 처리 클래스. 내부적으로 ZIP 리소스를 관리하므로 사용 후 반드시 `try-finally` 블록에서 `close()`를 호출해야 한다.
+
+대용량 Excel 파일의 메모리 효율을 위해 Lazy Loading 아키텍처를 채택한다. ZIP 내부의 XML은 접근 시점에만 읽고 파싱한다.
+
+```typescript
+export class ExcelWorkbook {
+  readonly zipCache: ZipCache;
+
+  constructor(arg?: Blob | Bytes);
+
+  async getWorksheetNames(): Promise<string[]>;
+  async addWorksheet(name: string): Promise<ExcelWorksheet>;
+  async getWorksheet(nameOrIndex: string | number): Promise<ExcelWorksheet>;
+  async toBytes(): Promise<Bytes>;
+  async toBlob(): Promise<Blob>;
+  async close(): Promise<void>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `zipCache` | property | `ZipCache` | ZIP 캐시 인스턴스 (read-only) |
+| `constructor` | method | `(arg?: Blob \| Bytes) => ExcelWorkbook` | `arg` 생략 시 새 워크북 생성, 전달 시 기존 파일 읽기 |
+| `getWorksheetNames` | method | `() => Promise<string[]>` | 워크북의 모든 워크시트 이름 반환 |
+| `addWorksheet` | method | `(name: string) => Promise<ExcelWorksheet>` | 새 워크시트 생성하여 반환 |
+| `getWorksheet` | method | `(nameOrIndex: string \| number) => Promise<ExcelWorksheet>` | 이름 또는 0 기반 인덱스로 워크시트 조회. 찾을 수 없으면 에러 발생 |
+| `toBytes` | method | `() => Promise<Bytes>` | 워크북을 `Bytes`(Uint8Array)로 내보내기 |
+| `toBlob` | method | `() => Promise<Blob>` | 워크북을 `Blob`으로 내보내기. MIME 타입: `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` |
+| `close` | method | `() => Promise<void>` | ZIP 리더와 내부 캐시 정리. 이미 닫힌 워크북에 대해 호출해도 안전하다 (no-op). 닫힌 후 메서드 호출 시 에러 발생 |
+
+## Usage
+
+```typescript
+import { ExcelWorkbook } from "@simplysm/excel";
+
+// 신규 생성
+const wb = new ExcelWorkbook();
+try {
+  const ws = await wb.addWorksheet("Sheet1");
+  await ws.cell(0, 0).setValue("값");
+  const bytes = await wb.toBytes();
+} finally {
+  await wb.close();
+}
+
+// 기존 파일 읽기 (Uint8Array 또는 Blob)
+const wb2 = new ExcelWorkbook(bytes);
+try {
+  const ws = await wb2.getWorksheet(0);       // 0 기반 인덱스
+  const ws2 = await wb2.getWorksheet("Sheet1"); // 시트명으로도 조회 가능
+  const names = await wb2.getWorksheetNames();
+} finally {
+  await wb2.close();
+}
+```

package/docs/core-classes/excel-worksheet.md

@@ -0,0 +1,139 @@
+# ExcelWorksheet
+
+Excel 워크시트를 나타내는 클래스. 셀 접근, 행/열 복사, 데이터 테이블 처리, 이미지 삽입, 뷰 설정 기능을 제공한다.
+
+```typescript
+export class ExcelWorksheet {
+  constructor(zipCache: ZipCache, relId: number, targetFileName: string);
+
+  // Name
+  async getName(): Promise<string>;
+  async setName(newName: string): Promise<void>;
+
+  // Cell Access (0 기반)
+  row(r: number): ExcelRow;
+  cell(r: number, c: number): ExcelCell;
+  col(c: number): ExcelCol;
+
+  // Copy
+  async copyRowStyle(srcR: number, targetR: number): Promise<void>;
+  async copyCellStyle(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint): Promise<void>;
+  async copyRow(srcR: number, targetR: number): Promise<void>;
+  async copyCell(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint): Promise<void>;
+  async insertCopyRow(srcR: number, targetR: number): Promise<void>;
+
+  // Range
+  async getRange(): Promise<ExcelAddressRangePoint>;
+  async getCells(): Promise<ExcelCell[][]>;
+
+  // Data
+  async getDataTable(opt?: {
+    headerRowIndex?: number;
+    checkEndColIndex?: number;
+    usableHeaderNameFn?: (headerName: string) => boolean;
+  }): Promise<Record<string, ExcelValueType>[]>;
+  async setDataMatrix(matrix: ExcelValueType[][]): Promise<void>;
+  async setRecords(records: Record<string, ExcelValueType>[]): Promise<void>;
+
+  // View
+  async setZoom(percent: number): Promise<void>;
+  async freezeAt(point: { r?: number; c?: number }): Promise<void>;
+
+  // Image
+  async addImage(opts: {
+    bytes: Bytes;
+    ext: string;
+    from: { r: number; c: number; rOff?: number | string; cOff?: number | string };
+    to?: { r: number; c: number; rOff?: number | string; cOff?: number | string };
+  }): Promise<void>;
+}
+```
+
+## Members
+
+| Member | Kind | Type | Description |
+|--------|------|------|-------------|
+| `getName` | method | `() => Promise<string>` | 워크시트 이름 반환 |
+| `setName` | method | `(newName: string) => Promise<void>` | 워크시트 이름 변경 |
+| `row` | method | `(r: number) => ExcelRow` | 행 객체 반환 (0 기반) |
+| `cell` | method | `(r: number, c: number) => ExcelCell` | 셀 객체 반환 (0 기반). 동일 좌표에 대해 항상 동일한 인스턴스 반환 |
+| `col` | method | `(c: number) => ExcelCol` | 열 객체 반환 (0 기반) |
+| `copyRowStyle` | method | `(srcR: number, targetR: number) => Promise<void>` | 원본 행의 스타일을 대상 행으로 복사. 데이터 범위 내 모든 열에 적용 |
+| `copyCellStyle` | method | `(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint) => Promise<void>` | 원본 셀의 스타일을 대상 셀로 복사 |
+| `copyRow` | method | `(srcR: number, targetR: number) => Promise<void>` | 원본 행을 대상 행으로 복사 (덮어쓰기) |
+| `copyCell` | method | `(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint) => Promise<void>` | 원본 셀을 대상 셀로 복사 |
+| `insertCopyRow` | method | `(srcR: number, targetR: number) => Promise<void>` | 원본 행을 대상 위치에 삽입 복사. 대상 이하 행은 한 칸 아래로 이동. 병합 셀 자동 처리 |
+| `getRange` | method | `() => Promise<ExcelAddressRangePoint>` | 워크시트의 데이터 범위 반환 |
+| `getCells` | method | `() => Promise<ExcelCell[][]>` | 모든 셀을 2차원 배열로 반환 |
+| `getDataTable` | method | `(opt?) => Promise<Record<string, ExcelValueType>[]>` | 워크시트 데이터를 테이블(레코드 배열)로 반환 |
+| `setDataMatrix` | method | `(matrix: ExcelValueType[][]) => Promise<void>` | 2차원 배열 데이터를 워크시트에 쓰기 |
+| `setRecords` | method | `(records: Record<string, ExcelValueType>[]) => Promise<void>` | 레코드 배열을 워크시트에 쓰기. 첫 행에 헤더 자동 생성 |
+| `setZoom` | method | `(percent: number) => Promise<void>` | 워크시트 확대/축소 비율 설정 (퍼센트) |
+| `freezeAt` | method | `(point: { r?: number; c?: number }) => Promise<void>` | 행/열 틀 고정 설정 |
+| `addImage` | method | `(opts) => Promise<void>` | 워크시트에 이미지 삽입 |
+
+## `getDataTable` Options
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `opt.headerRowIndex` | `number \| undefined` | 헤더 행 인덱스 (기본값: 데이터 범위의 시작 행) |
+| `opt.checkEndColIndex` | `number \| undefined` | 데이터 끝을 판단할 열 인덱스. 이 열이 비어있는 행을 만나면 읽기를 중단한다 |
+| `opt.usableHeaderNameFn` | `((headerName: string) => boolean) \| undefined` | 헤더 필터 함수. `false` 반환 시 해당 헤더 제외 |
+
+## `addImage` Options
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `opts.bytes` | `Bytes` | 이미지 바이너리 데이터 |
+| `opts.ext` | `string` | 이미지 확장자 (예: `"png"`, `"jpg"`) |
+| `opts.from` | `{ r: number; c: number; rOff?: number \| string; cOff?: number \| string }` | 이미지 시작 위치. `r`/`c`는 0 기반 인덱스, `rOff`/`cOff`는 선택적 EMU 오프셋 |
+| `opts.to` | `{ r: number; c: number; rOff?: number \| string; cOff?: number \| string } \| undefined` | 이미지 끝 위치. 생략 시 기본값은 `{ r: from.r + 1, c: from.c + 1 }` |
+
+## Usage
+
+```typescript
+// getDataTable
+const table = await ws.getDataTable();
+// [{ "이름": "김철수", "나이": 30 }, ...]
+
+// 특정 행부터 시작하는 경우
+const table2 = await ws.getDataTable({ headerRowIndex: 1 });
+
+// 헤더 필터링
+const table3 = await ws.getDataTable({
+  usableHeaderNameFn: (name) => !name.startsWith("_"),
+});
+
+// 2차원 배열 쓰기
+await ws.setDataMatrix([
+  ["이름", "나이"],
+  ["김철수", 30],
+]);
+
+// 레코드 배열 쓰기 (헤더 자동 생성)
+await ws.setRecords([
+  { name: "김철수", age: 30 },
+]);
+
+// 행 복사 (스타일 포함)
+await ws.copyRow(0, 5);
+
+// 삽입 복사 (기존 행 이동)
+await ws.insertCopyRow(0, 3);
+
+// 틀 고정 (2행부터 고정)
+await ws.freezeAt({ r: 1, c: 0 });
+
+// 이미지 삽입
+await ws.addImage({
+  bytes: imageBytes,
+  ext: "png",
+  from: { r: 1, c: 1 },
+  to: { r: 5, c: 4 },
+});
+```
+
+## `insertCopyRow` 병합 셀 처리
+
+- 삽입 지점을 관통하는 다중행 병합은 자동으로 1행 확장됨
+- 원본 행의 단일행 병합만 대상 행에 복사됨

package/docs/types/excel-address-point.md

@@ -0,0 +1,33 @@
+# ExcelAddressPoint
+
+셀 좌표를 나타내는 인터페이스이다. 모든 좌표는 0 기반이다.
+
+```typescript
+export interface ExcelAddressPoint {
+  r: number;
+  c: number;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `r` | `number` | 행 인덱스 (0 기반) |
+| `c` | `number` | 열 인덱스 (0 기반) |
+
+## Related Types
+
+### `ExcelAddressRangePoint`
+
+셀 범위 좌표를 나타내는 인터페이스이다.
+
+```typescript
+export interface ExcelAddressRangePoint {
+  s: ExcelAddressPoint;
+  e: ExcelAddressPoint;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `s` | `ExcelAddressPoint` | 시작 좌표 |
+| `e` | `ExcelAddressPoint` | 끝 좌표 |

package/docs/types/excel-style-options.md

@@ -0,0 +1,57 @@
+# ExcelStyleOptions
+
+셀 스타일 옵션 인터페이스이다. [`ExcelCell.setStyle()`](../core-classes/excel-cell.md)에서 사용한다.
+
+```typescript
+export interface ExcelStyleOptions {
+  background?: string;
+  border?: ExcelBorderPosition[];
+  horizontalAlign?: ExcelHorizontalAlign;
+  verticalAlign?: ExcelVerticalAlign;
+  numberFormat?: ExcelNumberFormat;
+  numberFormatCode?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `background` | `string \| undefined` | 배경색 (ARGB 형식, 8자리 16진수. 예: `"00FF0000"` = 빨강. alpha는 반전 값) |
+| `border` | `ExcelBorderPosition[] \| undefined` | 테두리 위치 배열 |
+| `horizontalAlign` | `ExcelHorizontalAlign \| undefined` | 가로 정렬 |
+| `verticalAlign` | `ExcelVerticalAlign \| undefined` | 세로 정렬 |
+| `numberFormat` | `ExcelNumberFormat \| undefined` | 숫자 형식 프리셋 |
+| `numberFormatCode` | `string \| undefined` | 커스텀 Excel formatCode 문자열 (예: `"0.000000"`, `"#,##0.00"`, `"0.00%"`). `numberFormat`과 동시 지정 시 이 필드가 우선 적용된다 |
+
+## Related Types
+
+### `ExcelNumberFormat`
+
+숫자 형식 이름이다. `ExcelStyleOptions.numberFormat`과 [`ExcelUtils`](../utilities/excel-utils.md)의 변환 메서드에서 사용한다.
+
+```typescript
+export type ExcelNumberFormat = "number" | "string" | "DateOnly" | "DateTime" | "Time";
+```
+
+### `ExcelBorderPosition`
+
+테두리 위치를 나타내는 타입이다.
+
+```typescript
+export type ExcelBorderPosition = "left" | "right" | "top" | "bottom";
+```
+
+### `ExcelHorizontalAlign`
+
+가로 정렬을 나타내는 타입이다.
+
+```typescript
+export type ExcelHorizontalAlign = "center" | "left" | "right";
+```
+
+### `ExcelVerticalAlign`
+
+세로 정렬을 나타내는 타입이다.
+
+```typescript
+export type ExcelVerticalAlign = "center" | "top" | "bottom";
+```

package/docs/types/excel-value-type.md

@@ -0,0 +1,28 @@
+# ExcelValueType
+
+셀에 저장할 수 있는 값의 타입이다.
+
+```typescript
+export type ExcelValueType = number | string | DateOnly | DateTime | Time | boolean | undefined;
+```
+
+`DateOnly`, `DateTime`, `Time`은 `@simplysm/core-common` 패키지에서 가져온다.
+
+## Related Types
+
+### `ExcelCellType`
+
+Excel 셀 타입이다. XML의 `t` 속성에 대응한다.
+
+```typescript
+export type ExcelCellType = "s" | "b" | "str" | "n" | "inlineStr" | "e";
+```
+
+| Value | Description |
+|-------|-------------|
+| `"s"` | 공유 문자열 (SharedString) |
+| `"b"` | boolean |
+| `"str"` | 수식 결과 문자열 |
+| `"n"` | 숫자 |
+| `"inlineStr"` | 인라인 문자열 (서식 있는 텍스트) |
+| `"e"` | 에러 |

package/docs/types/excel-xml-content-type-data.md

@@ -0,0 +1,23 @@
+# ExcelXmlContentTypeData
+
+`[Content_Types].xml` 데이터 구조이다. 내부 구현에 사용된다.
+
+```typescript
+export interface ExcelXmlContentTypeData {
+  Types: {
+    $: { xmlns: string };
+    Default: { $: { Extension: string; ContentType: string } }[];
+    Override: { $: { PartName: string; ContentType: string } }[];
+  };
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `Types.$` | `{ xmlns: string }` | 네임스페이스 |
+| `Types.Default` | `Array` | 확장자별 기본 콘텐트 타입 |
+| `Types.Default[].$.Extension` | `string` | 파일 확장자 |
+| `Types.Default[].$.ContentType` | `string` | MIME 타입 |
+| `Types.Override` | `Array` | 파일별 오버라이드 콘텐트 타입 |
+| `Types.Override[].$.PartName` | `string` | 파일 경로 |
+| `Types.Override[].$.ContentType` | `string` | MIME 타입 |

package/docs/types/excel-xml-drawing-data.md

@@ -0,0 +1,29 @@
+# ExcelXmlDrawingData
+
+`drawing*.xml` 데이터 구조이다. 이미지 앵커 정보를 포함한다. 내부 구현에 사용된다.
+
+```typescript
+export interface ExcelXmlDrawingData {
+  wsDr: {
+    $: { "xmlns": string; "xmlns:a"?: string; "xmlns:r"?: string };
+    twoCellAnchor?: {
+      from?: { col: string[]; colOff?: string[]; row: string[]; rowOff?: string[] }[];
+      to?: { col: string[]; colOff?: string[]; row: string[]; rowOff?: string[] }[];
+      pic?: {
+        nvPicPr?: { cNvPr?: { $: { id: string; name: string; descr?: string } }[]; cNvPicPr?: Array<{ "a:picLocks"?: Array<{ $: { noChangeAspect?: string } }> }> }[];
+        blipFill?: { "a:blip"?: Array<{ $: { "r:embed": string } }>; "a:stretch"?: Array<{ "a:fillRect": unknown[] }> }[];
+        spPr?: { "a:xfrm"?: Array<{ "a:off"?: Array<{ $: { x: string; y: string } }>; "a:ext"?: Array<{ $: { cx: string; cy: string } }> }>; "a:prstGeom"?: Array<{ "$": { prst: string }; "a:avLst": unknown[] }> }[];
+      }[];
+      clientData?: unknown[];
+    }[];
+  };
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `wsDr.$` | `object` | 네임스페이스 |
+| `wsDr.twoCellAnchor` | `Array \| undefined` | 두 셀 사이에 앵커된 이미지 목록 |
+| `twoCellAnchor.from` | `Array \| undefined` | 시작 위치 (행/열/오프셋) |
+| `twoCellAnchor.to` | `Array \| undefined` | 끝 위치 (행/열/오프셋) |
+| `twoCellAnchor.pic` | `Array \| undefined` | 이미지 정보 (blip 관계 ID 포함) |