@simplysm/excel 14.0.50 → 14.0.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/excel",
-  "version": "14.0.50",
+  "version": "14.0.52",
   "description": "심플리즘 패키지 - 엑셀 (neutral)",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -14,8 +14,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "src",
-    "docs"
+    "src"
   ],
   "sideEffects": false,
   "devDependencies": {
@@ -24,6 +23,6 @@
   "dependencies": {
     "mime": "^4.1.0",
     "zod": "^4.3.6",
-    "@simplysm/core-common": "14.0.50"
+    "@simplysm/core-common": "14.0.52"
   }
 }

package/README.md

@@ -1,127 +0,0 @@
-# @simplysm/excel
-
-Excel 워크북(xlsx) 읽기/쓰기 라이브러리. DOM 의존성이 없어 Node.js와 브라우저 양쪽에서 동작하는 neutral 패키지다. Lazy Loading 아키텍처로 대용량 파일도 메모리 효율적으로 처리한다.
-
-## Installation
-
-```bash
-npm install @simplysm/excel
-```
-
-## API Overview
-
-### Core Classes
-
-| 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
-
-| Entry | Kind | Description |
-|-------|------|-------------|
-| [`ExcelWrapper`](./docs/wrapper/excel-wrapper.md) | class | Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기. 헤더 자동 생성, 유효성 검사, 필수 필드 강조 |
-
-### Utilities
-
-| Entry | Kind | Description |
-|-------|------|-------------|
-| [`ExcelUtils`](./docs/utilities/excel-utils.md) | class | 셀 주소 변환 (좌표↔문자열), 날짜↔숫자 변환, 숫자 형식 매핑 (정적 메서드) |
-
-### Types
-
-| 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
-
-### 새 Excel 파일 생성 및 저장
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-const wb = new ExcelWorkbook();
-try {
-  const ws = await wb.addWorksheet("Sheet1");
-  
-  // 헤더 행
-  await ws.cell(0, 0).setValue("이름");
-  await ws.cell(0, 1).setValue("나이");
-  
-  // 데이터 행
-  await ws.cell(1, 0).setValue("김철수");
-  await ws.cell(1, 1).setValue(30);
-  
-  const bytes = await wb.toBytes();
-  // 파일 저장 또는 전송
-} finally {
-  await wb.close();
-}
-```
-
-### 기존 Excel 파일 읽기
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-const bytes = /* 파일 바이트 배열 */;
-const wb = new ExcelWorkbook(bytes);
-try {
-  // 시트명 또는 인덱스(0 기반)로 조회
-  const ws = await wb.getWorksheet(0);
-  
-  // 개별 셀 읽기
-  const value = await ws.cell(0, 0).getValue();
-  
-  // 전체 데이터 테이블 읽기 (첫 행이 헤더)
-  const table = await ws.getDataTable();
-} finally {
-  await wb.close();
-}
-```
-
-### Zod 스키마 기반 타입 안전한 작업
-
-```typescript
-import { ExcelWrapper } from "@simplysm/excel";
-import { z } from "zod";
-
-const schema = z.object({
-  name: z.string().describe("이름"),
-  age: z.number().describe("나이"),
-  email: z.string().optional().describe("이메일"),
-});
-
-const wrapper = new ExcelWrapper(schema);
-
-// 레코드 배열을 Excel로 쓰기
-const records = [
-  { name: "김철수", age: 30, email: "kim@example.com" },
-  { name: "이영희", age: 28 },
-];
-const wb = await wrapper.write("사람", records);
-try {
-  const bytes = await wb.toBytes();
-} finally {
-  await wb.close();
-}
-
-// Excel 파일을 레코드 배열로 읽기 (유효성 검사 포함)
-const bytes = /* 파일 바이트 배열 */;
-const data = await wrapper.read(bytes, "사람");
-```

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

@@ -1,73 +0,0 @@
-# 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

@@ -1,36 +0,0 @@
-# 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

@@ -1,34 +0,0 @@
-# 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

@@ -1,59 +0,0 @@
-# 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

@@ -1,139 +0,0 @@
-# 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

@@ -1,33 +0,0 @@
-# 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

@@ -1,57 +0,0 @@
-# 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

@@ -1,28 +0,0 @@
-# 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

@@ -1,23 +0,0 @@
-# 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

@@ -1,29 +0,0 @@
-# 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 포함) |

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

@@ -1,39 +0,0 @@
-# ExcelXmlRelationshipData
-
-`*.rels` 파일 데이터 구조이다. 내부 구현에 사용된다.
-
-```typescript
-export interface ExcelXmlRelationshipData {
-  Relationships: {
-    $: { xmlns: string };
-    Relationship?: ExcelRelationshipData[];
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `Relationships.$` | `{ xmlns: string }` | 네임스페이스 |
-| `Relationships.Relationship` | `ExcelRelationshipData[] \| undefined` | 관계 항목 배열 |
-
-## Related Types
-
-### `ExcelRelationshipData`
-
-개별 Relationship 엔트리 데이터이다.
-
-```typescript
-export interface ExcelRelationshipData {
-  $: {
-    Id: string;
-    Target: string;
-    Type: string;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `$.Id` | `string` | 관계 ID (예: `"rId1"`) |
-| `$.Target` | `string` | 대상 파일 경로 |
-| `$.Type` | `string` | 관계 타입 URI |

package/docs/types/excel-xml-shared-string-data.md

@@ -1,42 +0,0 @@
-# ExcelXmlSharedStringData
-
-`sharedStrings.xml` 데이터 구조이다. 내부 구현에 사용된다.
-
-```typescript
-export interface ExcelXmlSharedStringData {
-  sst: {
-    $: { xmlns: string };
-    si?: ExcelXmlSharedStringDataSi[];
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `sst.$` | `{ xmlns: string }` | 네임스페이스 |
-| `sst.si` | `ExcelXmlSharedStringDataSi[] \| undefined` | 공유 문자열 항목 배열 |
-
-## Related Types
-
-### `ExcelXmlSharedStringDataSi`
-
-SharedString 개별 항목이다. discriminated union으로, `t` 키가 있으면 단순 텍스트, `r` 키가 있으면 서식 있는 텍스트(rich text)이다.
-
-```typescript
-export type ExcelXmlSharedStringDataSi =
-  | { t: ExcelXmlSharedStringDataText }
-  | { r: { t: ExcelXmlSharedStringDataText }[] };
-```
-
-| Variant | Discriminant | Description |
-|---------|-------------|-------------|
-| `{ t: ... }` | `t` 키 존재 | 단순 텍스트 |
-| `{ r: ... }` | `r` 키 존재 | 서식 있는 텍스트 (run 배열) |
-
-### `ExcelXmlSharedStringDataText`
-
-SharedString 텍스트 데이터이다. 단순 문자열 또는 공백 보존 속성이 있는 객체이다.
-
-```typescript
-export type ExcelXmlSharedStringDataText = [string | { $: { space?: "preserve" }; _?: string }];
-```

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

@@ -1,97 +0,0 @@
-# ExcelXmlStyleData
-
-`styles.xml` 데이터 구조이다. 내부 구현에 사용된다.
-
-```typescript
-export interface ExcelXmlStyleData {
-  styleSheet: {
-    $: { xmlns: string };
-    numFmts?: [{ $: { count: string }; numFmt?: { $: { numFmtId: string; formatCode: string } }[] }];
-    fonts: [{ $: { count: string }; font: {}[] }];
-    fills: [{ $: { count: string }; fill: ExcelXmlStyleDataFill[] }];
-    borders: [{ $: { count: string }; border: ExcelXmlStyleDataBorder[] }];
-    cellXfs: [{ $: { count: string }; xf: ExcelXmlStyleDataXf[] }];
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `styleSheet.numFmts` | `Array \| undefined` | 커스텀 숫자 형식 목록 |
-| `styleSheet.fonts` | `Array` | 폰트 목록 |
-| `styleSheet.fills` | `Array` | 채우기 스타일 목록 |
-| `styleSheet.borders` | `Array` | 테두리 스타일 목록 |
-| `styleSheet.cellXfs` | `Array` | 셀 서식(xf) 목록 |
-
-## Related Types
-
-### `ExcelXmlStyleDataXf`
-
-셀 서식(xf) 데이터이다.
-
-```typescript
-export interface ExcelXmlStyleDataXf {
-  $: {
-    numFmtId?: string;
-    fontId?: string;
-    fillId?: string;
-    borderId?: string;
-    xfId?: string;
-    applyNumberFormat?: string;
-    applyFont?: string;
-    applyAlignment?: string;
-    applyFill?: string;
-    applyBorder?: string;
-  };
-  alignment?: [{ $: { horizontal?: "center" | "left" | "right"; vertical?: "center" | "top" | "bottom" } }];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `$.numFmtId` | `string \| undefined` | 숫자 형식 ID |
-| `$.fontId` | `string \| undefined` | 폰트 ID |
-| `$.fillId` | `string \| undefined` | 채우기 ID |
-| `$.borderId` | `string \| undefined` | 테두리 ID |
-| `$.xfId` | `string \| undefined` | 부모 xf ID |
-| `$.applyNumberFormat` | `string \| undefined` | 숫자 형식 적용 여부 |
-| `$.applyFont` | `string \| undefined` | 폰트 적용 여부 |
-| `$.applyAlignment` | `string \| undefined` | 정렬 적용 여부 |
-| `$.applyFill` | `string \| undefined` | 채우기 적용 여부 |
-| `$.applyBorder` | `string \| undefined` | 테두리 적용 여부 |
-| `alignment` | `Array \| undefined` | 정렬 설정 (horizontal, vertical) |
-
-### `ExcelXmlStyleDataFill`
-
-채우기 스타일 데이터이다.
-
-```typescript
-export interface ExcelXmlStyleDataFill {
-  patternFill: [{ $: { patternType: "none" | "solid" | "gray125" }; fgColor?: [{ $: { rgb: string } }] }];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `patternFill[0].$.patternType` | `"none" \| "solid" \| "gray125"` | 패턴 유형 |
-| `patternFill[0].fgColor` | `[{ $: { rgb: string } }] \| undefined` | 전경색 (ARGB) |
-
-### `ExcelXmlStyleDataBorder`
-
-테두리 스타일 데이터이다. 각 방향은 선택적이며, `style`과 `color`를 가진다.
-
-```typescript
-export interface ExcelXmlStyleDataBorder {
-  top?: [{ $: { style: "thin" | "medium" }; color?: [{ $: { rgb: string } }] }];
-  left?: [{ $: { style: "thin" | "medium" }; color?: [{ $: { rgb: string } }] }];
-  right?: [{ $: { style: "thin" | "medium" }; color?: [{ $: { rgb: string } }] }];
-  bottom?: [{ $: { style: "thin" | "medium" }; color?: [{ $: { rgb: string } }] }];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `top` | `Array \| undefined` | 상단 테두리 (`"thin"` 또는 `"medium"`) |
-| `left` | `Array \| undefined` | 좌측 테두리 |
-| `right` | `Array \| undefined` | 우측 테두리 |
-| `bottom` | `Array \| undefined` | 하단 테두리 |

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

@@ -1,22 +0,0 @@
-# ExcelXmlWorkbookData
-
-`workbook.xml` 데이터 구조이다. 내부 구현에 사용된다.
-
-```typescript
-export interface ExcelXmlWorkbookData {
-  workbook: {
-    $: { "xmlns": string; "xmlns:r"?: string };
-    bookViews?: [{ workbookView: [{}] }];
-    sheets?: [{ sheet: { $: { "name": string; "sheetId": string; "r:id": string } }[] }];
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `workbook.$` | `object` | 네임스페이스 |
-| `workbook.bookViews` | `Array \| undefined` | 워크북 뷰 설정 |
-| `workbook.sheets` | `Array \| undefined` | 시트 목록 |
-| `workbook.sheets[0].sheet[].$.name` | `string` | 시트 이름 |
-| `workbook.sheets[0].sheet[].$.sheetId` | `string` | 시트 ID |
-| `workbook.sheets[0].sheet[].$["r:id"]` | `string` | 관계 ID |

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

@@ -1,68 +0,0 @@
-# ExcelXmlWorksheetData
-
-`worksheet*.xml` 데이터 구조이다. 내부 구현에 사용된다.
-
-```typescript
-export interface ExcelXmlWorksheetData {
-  worksheet: {
-    $: { "xmlns": string; "xmlns:r"?: string };
-    dimension?: [{ $: { ref: string } }];
-    sheetViews?: [{ sheetView: { $: { workbookViewId: string; zoomScale?: string }; pane?: [{ $: { xSplit?: string; ySplit?: string; topLeftCell?: string; activePane?: string; state?: string } }] }[] }];
-    sheetFormatPr?: [{ $: { defaultRowHeight: string } }];
-    cols?: [{ col: { $: { min: string; max: string; width?: string; bestFit?: string; customWidth?: string } }[] }];
-    sheetData: [{ row?: ExcelRowData[] }];
-    mergeCells?: [{ $: { count: string }; mergeCell: { $: { ref: string } }[] }];
-    drawing?: { $: { "r:id": string } }[];
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `worksheet.dimension` | `Array \| undefined` | 데이터 범위 (예: `"A1:C10"`) |
-| `worksheet.sheetViews` | `Array \| undefined` | 시트 뷰 설정 (줌, 틀 고정) |
-| `worksheet.sheetFormatPr` | `Array \| undefined` | 기본 행 높이 |
-| `worksheet.cols` | `Array \| undefined` | 열 설정 (너비 등) |
-| `worksheet.sheetData` | `Array` | 행 데이터 |
-| `worksheet.mergeCells` | `Array \| undefined` | 병합 셀 정보 |
-| `worksheet.drawing` | `Array \| undefined` | 드로잉 관계 참조 |
-
-## Related Types
-
-### `ExcelRowData`
-
-행 XML 데이터이다.
-
-```typescript
-export interface ExcelRowData {
-  $: { r: string };
-  c?: ExcelCellData[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `$.r` | `string` | 행 주소 (1 기반, 예: `"1"`, `"10"`) |
-| `c` | `ExcelCellData[] \| undefined` | 셀 데이터 배열 |
-
-### `ExcelCellData`
-
-셀 XML 데이터이다.
-
-```typescript
-export interface ExcelCellData {
-  $: { r: string; s?: string; t?: ExcelCellType };
-  v?: [string];
-  f?: [string];
-  is?: { t?: (string | { _?: string })[] }[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `$.r` | `string` | 셀 주소 (예: `"A1"`, `"B3"`) |
-| `$.s` | `string \| undefined` | 스타일 ID |
-| `$.t` | `ExcelCellType \| undefined` | 셀 타입 |
-| `v` | `[string] \| undefined` | 셀 값 |
-| `f` | `[string] \| undefined` | 수식 |
-| `is` | `Array \| undefined` | 인라인 문자열 데이터 |

package/docs/types/excel-xml.md

@@ -1,15 +0,0 @@
-# ExcelXml
-
-XML 처리 클래스가 구현하는 인터페이스이다. `xml/` 디렉터리의 내부 클래스들이 이를 구현한다. 외부에서 직접 사용하지 않는다.
-
-```typescript
-export interface ExcelXml {
-  readonly data: unknown;
-  cleanup(): void;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `data` | `unknown` | XML 파싱된 데이터 (read-only) |
-| `cleanup` | `() => void` | `ZipCache.toBytes()` 직전에 호출되어 직렬화 전 데이터를 정리한다 |

package/docs/utilities/excel-utils.md

@@ -1,93 +0,0 @@
-# ExcelUtils
-
-Excel 유틸리티 함수 모음. 셀 주소 변환, 날짜/숫자 변환, 숫자 형식 처리 정적 메서드를 제공한다.
-
-```typescript
-export class ExcelUtils {
-  // 주소 변환
-  static stringifyAddr(point: ExcelAddressPoint): string;
-  static stringifyRowAddr(r: number): string;
-  static stringifyColAddr(c: number): string;
-  static parseRowAddr(addr: string): number;
-  static parseColAddr(addr: string): number;
-  static parseCellAddr(addr: string): ExcelAddressPoint;
-  static parseRangeAddr(rangeAddr: string): ExcelAddressRangePoint;
-  static stringifyRangeAddr(point: ExcelAddressRangePoint): string;
-
-  // 날짜/숫자 변환
-  static convertTimeTickToNumber(tick: number): number;
-  static convertNumberToTimeTick(value: number): number;
-
-  // 숫자 형식 처리
-  static convertNumFmtCodeToName(numFmtCode: string): ExcelNumberFormat;
-  static convertNumFmtIdToName(numFmtId: number): ExcelNumberFormat;
-  static convertNumFmtNameToId(numFmtName: ExcelNumberFormat): number;
-}
-```
-
-## Members
-
-| Member | Kind | Type | Description |
-|--------|------|------|-------------|
-| `stringifyAddr` | static | `(point: ExcelAddressPoint) => string` | 셀 좌표를 "A1" 형식 문자열로 변환 |
-| `stringifyRowAddr` | static | `(r: number) => string` | 행 인덱스(0 기반)를 행 주소 문자열로 변환 |
-| `stringifyColAddr` | static | `(c: number) => string` | 열 인덱스(0 기반)를 열 주소 문자열로 변환. 범위: 0~16383 |
-| `parseRowAddr` | static | `(addr: string) => number` | 셀 주소에서 0 기반 행 인덱스 추출 |
-| `parseColAddr` | static | `(addr: string) => number` | 셀 주소에서 0 기반 열 인덱스 추출 |
-| `parseCellAddr` | static | `(addr: string) => ExcelAddressPoint` | 셀 주소를 좌표로 변환 |
-| `parseRangeAddr` | static | `(rangeAddr: string) => ExcelAddressRangePoint` | 범위 주소를 좌표로 변환 |
-| `stringifyRangeAddr` | static | `(point: ExcelAddressRangePoint) => string` | 범위 좌표를 주소 문자열로 변환. 시작=끝이면 단일 셀 주소 반환 |
-| `convertTimeTickToNumber` | static | `(tick: number) => number` | JavaScript 타임스탬프(ms)를 Excel 날짜 숫자로 변환 |
-| `convertNumberToTimeTick` | static | `(value: number) => number` | Excel 날짜 숫자를 JavaScript 타임스탬프(ms)로 변환 |
-| `convertNumFmtCodeToName` | static | `(numFmtCode: string) => ExcelNumberFormat` | 숫자 형식 코드를 형식 이름으로 변환 |
-| `convertNumFmtIdToName` | static | `(numFmtId: number) => ExcelNumberFormat` | Excel 내장 숫자 형식 ID를 형식 이름으로 변환 |
-| `convertNumFmtNameToId` | static | `(numFmtName: ExcelNumberFormat) => number` | 숫자 형식 이름을 형식 ID로 변환 |
-
-## Usage
-
-```typescript
-import { ExcelUtils } from "@simplysm/excel";
-
-// 주소 변환
-ExcelUtils.stringifyAddr({ r: 0, c: 0 });   // "A1"
-ExcelUtils.stringifyAddr({ r: 2, c: 3 });   // "D3"
-ExcelUtils.parseCellAddr("B3");             // { r: 2, c: 1 }
-ExcelUtils.parseRangeAddr("A1:C3");         // { s: { r: 0, c: 0 }, e: { r: 2, c: 2 } }
-ExcelUtils.stringifyRangeAddr({ s: { r: 0, c: 0 }, e: { r: 2, c: 2 } }); // "A1:C3"
-
-ExcelUtils.stringifyRowAddr(0);  // "1"
-ExcelUtils.stringifyColAddr(0);  // "A"
-ExcelUtils.stringifyColAddr(26); // "AA"
-ExcelUtils.parseRowAddr("A3");   // 2
-ExcelUtils.parseColAddr("B3");   // 1
-```
-
-## `convertNumFmtCodeToName` 변환 규칙
-
-| 형식 코드 패턴 | 반환값 |
-|----------------|--------|
-| `"General"` | `"number"` |
-| `yy`, `dd`, `mm`(날짜 문맥) 포함 + 시간(`h`, `ss`) 포함 | `"DateTime"` |
-| `yy`, `dd`, `mm`(날짜 문맥) 포함 | `"DateOnly"` |
-| `h`, `ss` 포함 | `"Time"` |
-| 숫자 패턴 (`0`, `#`, `.` 등) | `"number"` |
-
-## `convertNumFmtIdToName` 내장 형식 ID 범위
-
-| ID 범위 | 형식 |
-|---------|------|
-| 0~13, 37~40, 48 | `"number"` (숫자/일반/통화/퍼센트) |
-| 14~17, 27~31, 34~36, 50~58 | `"DateOnly"` (날짜, 로컬라이즈 포함) |
-| 22 | `"DateTime"` (날짜+시간) |
-| 18~21, 32~33, 45~47 | `"Time"` (시간) |
-| 49 | `"string"` (텍스트) |
-
-## `convertNumFmtNameToId` 매핑
-
-| 형식 이름 | ID |
-|-----------|-----|
-| `"number"` | 0 |
-| `"DateOnly"` | 14 |
-| `"DateTime"` | 22 |
-| `"Time"` | 18 |
-| `"string"` | 49 |

package/docs/wrapper/excel-wrapper.md

@@ -1,100 +0,0 @@
-# ExcelWrapper
-
-Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기 래퍼. 스키마에서 타입 정보를 추론하여 타입 안전한 읽기/쓰기를 제공한다.
-
-```typescript
-export class ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>> {
-  constructor(schema: TSchema);
-
-  async read(
-    file: Bytes | Blob,
-    wsNameOrIndex?: string | number,
-    options?: { excludes?: (keyof z.infer<TSchema>)[] },
-  ): Promise<z.infer<TSchema>[]>;
-
-  async write(
-    wsName: string,
-    records: Partial<z.infer<TSchema>>[],
-    options?: { excludes?: (keyof z.infer<TSchema>)[] },
-  ): Promise<ExcelWorkbook>;
-}
-```
-
-## Members
-
-| Member | Kind | Type | Description |
-|--------|------|------|-------------|
-| `constructor` | method | `(schema: TSchema) => ExcelWrapper<TSchema>` | Zod 스키마를 받아 인스턴스 생성. `.describe()`로 Excel 헤더 이름을 지정한다 |
-| `read` | method | `(file, wsNameOrIndex?, options?) => Promise<z.infer<TSchema>[]>` | Excel 파일을 레코드 배열로 읽기. 스키마 유효성 검사 수행 |
-| `write` | method | `(wsName, records, options?) => Promise<ExcelWorkbook>` | 레코드 배열을 Excel 워크북으로 변환. 반환된 워크북의 `close()`는 호출자 책임 |
-
-## Parameters
-
-### `read(file, wsNameOrIndex?, options?)`
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `file` | `Bytes \| Blob` | Excel 파일 데이터 |
-| `wsNameOrIndex` | `string \| number` | 워크시트 이름 또는 0 기반 인덱스 (기본값: `0`) |
-| `options.excludes` | `(keyof z.infer<TSchema>)[] \| undefined` | 읽기에서 제외할 필드 키 배열 |
-
-**타입 변환 규칙:**
-
-| 스키마 타입 | 변환 동작 |
-|------------|-----------|
-| `z.string()` | 문자열로 변환 (`String(rawValue)`) |
-| `z.number()` | 숫자로 파싱 (`num.parseFloat`) |
-| `z.boolean()` | `"1"`, `"true"` → `true`, `"0"`, `"false"` → `false` |
-| `z.optional()` / `z.nullable()` | 빈 셀을 `undefined`로 반환 |
-| `z.default(value)` | 빈 셀에 기본값 적용 |
-| `DateOnly` / `DateTime` / `Time` | `instanceof`로 직접 전달 |
-
-### `write(wsName, records, options?)`
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `wsName` | `string` | 워크시트 이름 |
-| `records` | `Partial<z.infer<TSchema>>[]` | 레코드 배열 |
-| `options.excludes` | `(keyof z.infer<TSchema>)[] \| undefined` | 쓰기에서 제외할 필드 키 배열 |
-
-**쓰기 동작:**
-
-- 첫 번째 행에 헤더 자동 생성 (스키마의 `.describe()` 값 사용)
-- 모든 셀에 테두리 스타일 자동 적용
-- 필수 비boolean 필드의 헤더에 노란색 배경(`00FFFF00`) 강조
-- 확대/축소 85%, 첫 번째 행 틀 고정 자동 설정
-- 내부에서 에러 발생 시 워크북이 자동으로 `close()`됨
-
-## Usage
-
-```typescript
-import { ExcelWrapper } from "@simplysm/excel";
-import { z } from "zod";
-
-const schema = z.object({
-  name: z.string().describe("이름"),
-  age: z.number().describe("나이"),
-  email: z.string().optional().describe("이메일"),
-  active: z.boolean().default(false).describe("활성"),
-});
-
-const wrapper = new ExcelWrapper(schema);
-
-// 쓰기 (시트명, 레코드 배열)
-const wb = await wrapper.write("사람", [
-  { name: "김철수", age: 30, email: "kim@example.com" },
-  { name: "이영희", age: 28 },
-]);
-try {
-  const bytes = await wb.toBytes();
-} finally {
-  await wb.close();
-}
-
-// 읽기 (시트명 또는 인덱스, 기본값: 0)
-const records = await wrapper.read(bytes, "사람");
-// z.infer<typeof schema>[] 타입으로 반환
-
-// excludes 옵션으로 특정 필드 제외
-const filtered = await wrapper.read(bytes, 0, { excludes: ["email"] });
-```