@simplysm/sd-claude 14.0.50 → 14.0.52

package/claude/references/sd-simplysm-v14/excel/core-classes/excel-worksheet.md

@@ -0,0 +1,147 @@
+# ExcelWorksheet
+
+Excel 워크시트를 나타내는 클래스. 셀 접근, 행/열 복사, 데이터 테이블 처리, 이미지 삽입, 뷰 설정 기능을 제공한다.
+
+## When to use
+
+- ✅ 시트 내 셀/행/열을 접근하거나, 행 복사, 데이터 테이블 읽기/쓰기, 이미지 삽입이 필요할 때
+- ✅ `ExcelWorkbook.getWorksheet()` 또는 `ExcelWorkbook.addWorksheet()`로 얻은 인스턴스를 통해 사용
+- ❌ 타입 안전한 스키마 기반 읽기/쓰기가 필요하면 [`ExcelWrapper`](../wrapper/excel-wrapper.md) -- 내부적으로 `ExcelWorksheet`를 사용한다
+
+## Signature
+
+```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/claude/references/sd-simplysm-v14/excel/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/claude/references/sd-simplysm-v14/excel/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/claude/references/sd-simplysm-v14/excel/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/claude/references/sd-simplysm-v14/excel/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/claude/references/sd-simplysm-v14/excel/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 포함) |

package/claude/references/sd-simplysm-v14/excel/types/excel-xml-relationship-data.md

@@ -0,0 +1,39 @@
+# 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/claude/references/sd-simplysm-v14/excel/types/excel-xml-shared-string-data.md

@@ -0,0 +1,42 @@
+# 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/claude/references/sd-simplysm-v14/excel/types/excel-xml-style-data.md

@@ -0,0 +1,97 @@
+# 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/claude/references/sd-simplysm-v14/excel/types/excel-xml-workbook-data.md

@@ -0,0 +1,22 @@
+# 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/claude/references/sd-simplysm-v14/excel/types/excel-xml-worksheet-data.md

@@ -0,0 +1,68 @@
+# 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/claude/references/sd-simplysm-v14/excel/types/excel-xml.md

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