@simplysm/sd-claude 14.0.47 → 14.0.49

package/claude/references/sd-simplysm14/core-node/usage.md

@@ -1,259 +0,0 @@
-# @simplysm/core-node
-
-Node.js 전용 코어 유틸리티 패키지. 파일 시스템 조작, 자식 프로세스 실행, 경로 처리, 파일 감시, Worker thread 래퍼, consola 로깅 설정을 제공한다.
-
-## Installation
-
-```bash
-npm install @simplysm/core-node
-```
-
-## API Overview
-
-### File System (fsx)
-
-파일 시스템 작업을 위한 유틸리티 네임스페이스. 모든 함수는 동기/비동기 쌍으로 제공된다.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `exists` | function | 파일 또는 디렉토리가 존재하는지 확인 (비동기) |
-| `existsSync` | function | 파일 또는 디렉토리가 존재하는지 확인 (동기) |
-| `mkdir` | function | 디렉토리를 생성 (재귀적, 비동기) |
-| `mkdirSync` | function | 디렉토리를 생성 (재귀적, 동기) |
-| `rm` | function | 파일/디렉토리 삭제, 파일 잠금 시 최대 6회 재시도 (비동기) |
-| `rmSync` | function | 파일/디렉토리 삭제 (동기, 재시도 없음) |
-| `copy` | function | 파일/디렉토리 복사, 필터 옵션 지원 (비동기) |
-| `copySync` | function | 파일/디렉토리 복사, 필터 옵션 지원 (동기) |
-| `read` | function | 파일을 UTF-8 문자열로 읽음 (비동기) |
-| `readSync` | function | 파일을 UTF-8 문자열로 읽음 (동기) |
-| `readBytes` | function | 파일을 Uint8Array로 읽음 (비동기) |
-| `readBytesSync` | function | 파일을 Uint8Array로 읽음 (동기) |
-| `readJson` | function | JSON 파일 읽음 (비동기) |
-| `readJsonSync` | function | JSON 파일 읽음 (동기) |
-| `write` | function | 파일에 데이터 쓰기, 상위 디렉토리 자동 생성 (비동기) |
-| `writeSync` | function | 파일에 데이터 쓰기, 상위 디렉토리 자동 생성 (동기) |
-| `writeJson` | function | JSON 파일에 데이터 쓰기 (비동기) |
-| `writeJsonSync` | function | JSON 파일에 데이터 쓰기 (동기) |
-| `readdir` | function | 디렉토리 내용 읽기 (비동기) |
-| `readdirSync` | function | 디렉토리 내용 읽기 (동기) |
-| `stat` | function | 파일/디렉토리 정보 조회, 심볼릭 링크 따라감 (비동기) |
-| `statSync` | function | 파일/디렉토리 정보 조회, 심볼릭 링크 따라감 (동기) |
-| `lstat` | function | 파일/디렉토리 정보 조회, 심볼릭 링크 따라가지 않음 (비동기) |
-| `lstatSync` | function | 파일/디렉토리 정보 조회, 심볼릭 링크 따라가지 않음 (동기) |
-| `glob` | function | Glob 패턴으로 파일 검색 (비동기) |
-| `globSync` | function | Glob 패턴으로 파일 검색 (동기) |
-| `clearEmptyDirectory` | function | 빈 디렉토리 재귀적 삭제 |
-| `findAllParentChildPathsSync` | function | 부모 디렉토리에서 특정 파일 검색 (동기) |
-| `findAllParentChildPaths` | function | 부모 디렉토리에서 특정 파일 검색 (비동기) |
-
-→ See [docs/file-system.md](./docs/file-system.md) for details.
-
-### Child Process (cpx)
-
-자식 프로세스 실행 및 인코딩 감지.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `spawn` | function | 자식 프로세스 실행, Promise 기반, 실시간 제어 가능 |
-| `spawnSync` | function | 자식 프로세스 동기 실행 |
-| `getSystemEncoding` | function | 시스템 기본 인코딩 감지 |
-| `codePageToEncoding` | function | Windows 코드 페이지를 인코딩명으로 변환 |
-| `decodeBytes` | function | Uint8Array를 문자열로 디코딩 |
-| `resolveStdioPipe` | function | stdio 옵션에서 pipe 여부 판단 |
-| `resetEncodingCache` | function | 인코딩 캐시 초기화 |
-| `SpawnProcess` | class | spawn() 반환 타입, PromiseLike 구현 |
-| `SpawnResult` | interface | spawn/spawnSync 결과 타입 |
-
-→ See [docs/child-process.md](./docs/child-process.md) for details.
-
-### Path (pathx)
-
-경로 처리 및 PosixPath 브랜드 타입.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `posix` | function | 경로를 POSIX 스타일(슬래시)로 변환 |
-| `posixResolve` | function | 경로를 절대 경로로 resolve한 후 POSIX 스타일로 변환 |
-| `changeFileDirectory` | function | 파일의 디렉토리를 변경 |
-| `basenameWithoutExt` | function | 확장자를 제외한 파일명 반환 |
-| `isChildPath` | function | 자식 경로 여부 확인 |
-| `filterByTargets` | function | 대상 경로 목록에 기반한 파일 필터링 |
-| `PosixPath` | type | POSIX 스타일 경로 브랜드 타입 |
-
-→ See [docs/path.md](./docs/path.md) for details.
-
-### File Watching (FsWatcher)
-
-Chokidar 기반 파일 시스템 감시 클래스.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `FsWatcher` | class | 파일 시스템 감시, 이벤트 병합, 자동 복구 |
-| `FsWatcherEvent` | type | 감시 이벤트 타입: "add" \| "addDir" \| "change" \| "unlink" \| "unlinkDir" |
-| `FsWatcherChangeInfo` | interface | 파일 변경 정보 (event + path) |
-
-→ See [docs/file-watching.md](./docs/file-watching.md) for details.
-
-### Logging (consola)
-
-Consola 로깅 설정 및 reporter.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `setupConsola` | function | 환경별 자동 consola 구성 |
-| `withMaxLevel` | function | 로그 레벨 상한선을 설정한 reporter 래퍼 |
-| `PrettyReporter` | class | 터미널 출력용 consola reporter |
-| `createFileReporter` | function | 파일 기반 consola reporter 생성 |
-
-→ See [docs/logging.md](./docs/logging.md) for details.
-
-### Worker Threads
-
-타입 안전한 Worker thread 래퍼.
-
-| API | Type | Description |
-|-----|------|-------------|
-| `Worker` | class | Worker thread 프록시 생성 및 메서드 호출 |
-| `createWorker` | function | 워커 측에서 호출하는 워커 모듈 생성 함수 |
-| `WorkerModule` | interface | 워커 모듈의 타입 구조 |
-| `WorkerProxy` | type | Worker.create() 반환 프록시 타입 |
-| `WorkerRequest` | interface | 워커 요청 메시지 타입 |
-| `WorkerResponse` | type | 워커 응답 메시지 타입 |
-| `PromisifyMethods` | type | 메서드를 Promise 버전으로 변환하는 매핑 타입 |
-
-→ See [docs/worker-threads.md](./docs/worker-threads.md) for details.
-
-## Usage Examples
-
-### File System Operations
-
-```typescript
-import { fsx } from "@simplysm/core-node";
-
-// 파일 존재 확인
-const exists = await fsx.exists("/path/to/file.txt");
-
-// 파일 읽기/쓰기
-const content = await fsx.read("/path/to/file.txt");
-await fsx.write("/path/to/new-file.txt", "Hello, World!");
-
-// JSON 파일 읽기/쓰기
-const data = await fsx.readJson<{ name: string }>("/path/to/config.json");
-await fsx.writeJson("/path/to/config.json", { name: "test" });
-
-// 파일 복사 (필터 적용)
-await fsx.copy("/src/dir", "/dst/dir", (filePath) => {
-  return !filePath.includes("node_modules");
-});
-
-// Glob 검색
-const tsFiles = await fsx.glob("src/**/*.ts");
-```
-
-### Child Process Execution
-
-```typescript
-import { cpx } from "@simplysm/core-node";
-
-// 기본 실행
-const result = await cpx.spawn("npm", ["list"], { cwd: "/project" });
-console.log(result.stdout);
-
-// 실시간 출력
-await cpx.spawn("npm", ["run", "build"], { stdio: "inherit" });
-
-// 오류 무시
-const result = await cpx.spawn("cmd", ["nonexistent"], { reject: false });
-// result.exitCode가 0이 아니어도 throw되지 않음
-
-// 동기 실행
-const syncResult = cpx.spawnSync("node", ["--version"]);
-console.log(syncResult.stdout);
-```
-
-### Path Utilities
-
-```typescript
-import { pathx } from "@simplysm/core-node";
-
-// POSIX 경로 변환
-const posixPath = pathx.posix("C:\\Users\\test");
-console.log(posixPath); // "C:/Users/test"
-
-// 절대 경로 resolve + POSIX
-const absPath = pathx.posixResolve("./relative", "path");
-
-// 자식 경로 확인
-const isChild = pathx.isChildPath("/a/b/c", "/a/b"); // true
-
-// 경로 필터링
-const filtered = pathx.filterByTargets(
-  ["/proj/src/a.ts", "/proj/tests/b.ts"],
-  ["src"],
-  "/proj"
-);
-// ["/proj/src/a.ts"]
-```
-
-### File Watching
-
-```typescript
-import { FsWatcher } from "@simplysm/core-node";
-
-const watcher = await FsWatcher.watch(["src/**/*.ts"]);
-
-watcher.onChange({ delay: 300 }, (changes) => {
-  for (const { event, path } of changes) {
-    console.log(`${event}: ${path}`);
-  }
-});
-
-// 파일 감시 종료
-await watcher.close();
-```
-
-### Logging Setup
-
-```typescript
-import { setupConsola } from "@simplysm/core-node";
-
-// 환경별 자동 구성
-setupConsola();
-
-// CLI 모드 (프로덕션에서도 file + pretty reporter 사용)
-setupConsola({ cli: true });
-```
-
-### Worker Threads
-
-```typescript
-// worker.ts (워커 파일)
-import { createWorker } from "@simplysm/core-node";
-
-interface MyEvents {
-  progress: number;
-}
-
-const methods = {
-  add: (a: number, b: number) => a + b,
-  multiply: (a: number, b: number) => a * b,
-};
-
-const sender = createWorker<typeof methods, MyEvents>(methods);
-export default sender;
-
-// main.ts (메인 파일)
-import { Worker } from "@simplysm/core-node";
-import type * as MyWorker from "./worker";
-
-const worker = Worker.create<typeof MyWorker>("./worker.ts");
-
-const sum = await worker.add(10, 20); // 30
-const product = await worker.multiply(5, 6); // 30
-
-worker.on("progress", (value) => {
-  console.log(`Progress: ${value}%`);
-});
-
-await worker.terminate();
-```

package/claude/references/sd-simplysm14/excel/docs/core-classes.md

@@ -1,453 +0,0 @@
-# Core Classes
-
-## `ExcelWorkbook`
-
-Excel 워크북 처리 클래스. 내부적으로 ZIP 리소스를 관리하므로 사용 후 반드시 `try-finally` 블록에서 `close()`를 호출해야 한다.
-
-```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>;
-}
-```
-
-### Constructor
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `arg` | `Blob \| Bytes \| undefined` | 기존 Excel 파일 데이터. 생략하면 새 워크북을 생성한다 |
-
-### Methods
-
-#### `getWorksheetNames()`
-
-워크북의 모든 워크시트 이름을 배열로 반환한다.
-
-#### `addWorksheet(name)`
-
-새 워크시트를 생성하여 `ExcelWorksheet` 인스턴스를 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `name` | `string` | 워크시트 이름 |
-
-#### `getWorksheet(nameOrIndex)`
-
-이름 또는 0 기반 인덱스로 워크시트를 조회하여 반환한다. 찾을 수 없으면 에러를 던진다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `nameOrIndex` | `string \| number` | 워크시트 이름 또는 0 기반 인덱스 |
-
-#### `toBytes()`
-
-워크북을 `Bytes`(Uint8Array)로 내보낸다.
-
-#### `toBlob()`
-
-워크북을 `Blob`으로 내보낸다. MIME 타입은 `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`이다.
-
-#### `close()`
-
-ZIP 리더와 내부 캐시를 정리한다. 이미 닫힌 워크북에 대해 호출해도 안전하다 (no-op). 닫힌 워크북의 메서드를 호출하면 에러가 발생한다.
-
----
-
-## `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>;
-}
-```
-
-### Name Methods
-
-#### `getName()`
-
-워크시트 이름을 반환한다.
-
-#### `setName(newName)`
-
-워크시트 이름을 변경한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `newName` | `string` | 새 워크시트 이름 |
-
-### Cell Access Methods
-
-모든 좌표는 0 기반 인덱스이다.
-
-#### `row(r)`
-
-행 객체를 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `r` | `number` | 행 인덱스 (0 기반) |
-
-#### `cell(r, c)`
-
-셀 객체를 반환한다. 동일 좌표에 대해 항상 동일한 `ExcelCell` 인스턴스를 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `r` | `number` | 행 인덱스 (0 기반) |
-| `c` | `number` | 열 인덱스 (0 기반) |
-
-#### `col(c)`
-
-열 객체를 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `c` | `number` | 열 인덱스 (0 기반) |
-
-### Copy Methods
-
-#### `copyRowStyle(srcR, targetR)`
-
-원본 행의 스타일을 대상 행으로 복사한다. 데이터 범위 내의 모든 열에 대해 셀 스타일을 복사한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `srcR` | `number` | 원본 행 인덱스 (0 기반) |
-| `targetR` | `number` | 대상 행 인덱스 (0 기반) |
-
-#### `copyCellStyle(srcAddr, targetAddr)`
-
-원본 셀의 스타일을 대상 셀로 복사한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `srcAddr` | `ExcelAddressPoint` | 원본 셀 좌표 |
-| `targetAddr` | `ExcelAddressPoint` | 대상 셀 좌표 |
-
-#### `copyRow(srcR, targetR)`
-
-원본 행을 대상 행으로 복사한다 (덮어쓰기).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `srcR` | `number` | 원본 행 인덱스 (0 기반) |
-| `targetR` | `number` | 대상 행 인덱스 (0 기반) |
-
-#### `copyCell(srcAddr, targetAddr)`
-
-원본 셀을 대상 셀로 복사한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `srcAddr` | `ExcelAddressPoint` | 원본 셀 좌표 |
-| `targetAddr` | `ExcelAddressPoint` | 대상 셀 좌표 |
-
-#### `insertCopyRow(srcR, targetR)`
-
-원본 행을 대상 위치에 삽입 복사한다. 대상 위치 이하의 기존 행은 한 칸 아래로 밀린다. 병합 셀도 자동으로 이동/확장된다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `srcR` | `number` | 복사할 원본 행 인덱스 (0 기반) |
-| `targetR` | `number` | 삽입할 대상 행 인덱스 (0 기반) |
-
-**병합 셀 처리:**
-- 삽입 지점을 관통하는 다중행 병합은 자동으로 1행 확장됨
-- 원본 행의 단일행 병합만 대상 행에 복사됨
-
-### Range Methods
-
-#### `getRange()`
-
-워크시트의 데이터 범위를 `ExcelAddressRangePoint`로 반환한다.
-
-#### `getCells()`
-
-모든 셀을 2차원 배열(`ExcelCell[][]`)로 반환한다.
-
-### Data Methods
-
-#### `getDataTable(opt?)`
-
-워크시트 데이터를 테이블(레코드 배열)로 반환한다. 지정된 헤더 행(기본값: 첫 번째 행)을 기준으로 이하의 데이터를 읽는다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `opt.headerRowIndex` | `number \| undefined` | 헤더 행 인덱스 (기본값: 데이터 범위의 시작 행) |
-| `opt.checkEndColIndex` | `number \| undefined` | 데이터 끝을 판단할 열 인덱스. 이 열이 비어있는 행을 만나면 데이터가 끝난 것으로 판단한다 |
-| `opt.usableHeaderNameFn` | `(headerName: string) => boolean \| undefined` | 사용 가능한 헤더를 필터링하는 함수. 반환값이 `false`인 헤더는 제외된다 |
-
-**반환값:** `Record<string, ExcelValueType>[]` - 헤더를 키로 하는 레코드 배열
-
-#### `setDataMatrix(matrix)`
-
-2차원 배열 데이터를 워크시트에 쓴다. (0, 0) 위치부터 시작하여 데이터를 기록한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `matrix` | `ExcelValueType[][]` | 2차원 배열 데이터 (행 우선, `matrix[0]`이 첫 번째 행) |
-
-#### `setRecords(records)`
-
-레코드 배열을 워크시트에 쓴다. 첫 번째 행(r=0)에 헤더가 자동 생성되고, 이후 행(r=1...)에 데이터가 기록된다. 모든 레코드의 필드를 수집하여 헤더로 사용한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `records` | `Record<string, ExcelValueType>[]` | 레코드 배열 |
-
-### View Methods
-
-#### `setZoom(percent)`
-
-워크시트 확대/축소 비율을 설정한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `percent` | `number` | 확대/축소 퍼센트 |
-
-#### `freezeAt(point)`
-
-행/열 틀 고정을 설정한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `point.r` | `number \| undefined` | 고정할 행 인덱스 (0 기반) |
-| `point.c` | `number \| undefined` | 고정할 열 인덱스 (0 기반) |
-
-### Image Methods
-
-#### `addImage(opts)`
-
-워크시트에 이미지를 삽입한다. 같은 시트의 첫 이미지 호출 시 `drawing1.xml` 생성, 이후 이미지는 동일 drawing에 추가된다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `opts.bytes` | `Bytes` | 이미지 바이너리 데이터 |
-| `opts.ext` | `string` | 이미지 확장자 (예: `"png"`, `"jpg"`, `"gif"`) |
-| `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 }`이다 |
-
-**이미지 파일 관리:**
-- 이미지는 `xl/media/image1.ext`, `xl/media/image2.ext` 등으로 자동 관리됨
-- 기존 파일명과 중복되지 않도록 인덱스 자동 증가
-
----
-
-## `ExcelCell`
-
-Excel 셀을 나타내는 클래스. 값 읽기/쓰기, 수식, 스타일, 셀 병합 기능을 제공한다. 모든 메서드가 `async`인 이유는 셀 타입에 따라 필요한 XML만 선택적으로 로드하는 Lazy Loading 아키텍처 때문이다.
-
-```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>;
-}
-```
-
-### Properties
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `addr` | `ExcelAddressPoint` | 셀 주소 (0 기반 행/열 인덱스) |
-
-### Value Methods
-
-#### `setValue(val)`
-
-셀 값을 설정한다. `undefined`를 전달하면 셀이 삭제된다. `DateOnly`, `DateTime`, `Time` 인스턴스를 전달하면 내부적으로 Excel 날짜 숫자로 변환하고 적절한 numFmt를 설정한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `val` | `ExcelValueType` | 셀 값 (`number \| string \| DateOnly \| DateTime \| Time \| boolean \| undefined`) |
-
-#### `getValue()`
-
-셀 값을 반환한다. 셀 타입과 스타일에 따라 적절한 JavaScript 타입으로 변환한다. 비어있는 셀은 `undefined`를 반환한다.
-
-#### `setFormula(val)`
-
-셀에 수식을 설정한다. `undefined`를 전달하면 수식이 제거된다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `val` | `string \| undefined` | 수식 문자열 (예: `"SUM(A1:A10)"`) |
-
-#### `getFormula()`
-
-셀 수식을 반환한다. 수식이 없으면 `undefined`를 반환한다.
-
-### Merge Methods
-
-#### `merge(r, c)`
-
-현재 셀에서 지정된 끝 좌표까지 셀을 병합한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `r` | `number` | 병합 끝 행 인덱스 (0 기반) |
-| `c` | `number` | 병합 끝 열 인덱스 (0 기반) |
-
-### Style Methods
-
-#### `getStyleId()`
-
-셀의 스타일 ID를 반환한다. 스타일이 없으면 `undefined`를 반환한다.
-
-#### `setStyleId(styleId)`
-
-셀의 스타일 ID를 직접 설정한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `styleId` | `string \| undefined` | 스타일 ID |
-
-#### `setStyle(opts)`
-
-셀 스타일을 설정한다. 기존 스타일이 있으면 클론 후 병합한다.
-
-커스텀 Excel formatCode를 지정하려면 `numberFormatCode`를 사용한다:
-
-```typescript
-await cell.setStyle({ numberFormatCode: "0.000000" });  // 소수점 6자리
-await cell.setStyle({ numberFormatCode: "#,##0.00" });   // 천 단위 구분 + 2자리
-await cell.setStyle({ numberFormatCode: "0.00%" });      // 퍼센트
-```
-
-`numberFormat`(프리셋)과 `numberFormatCode`(커스텀)가 동시에 지정되면 `numberFormatCode`가 우선 적용된다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `opts` | `ExcelStyleOptions` | 스타일 옵션 (배경색, 테두리, 정렬, 숫자 형식) |
-
----
-
-## `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[]>;
-}
-```
-
-### Methods
-
-#### `cell(c)`
-
-지정된 열 인덱스의 셀을 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `c` | `number` | 열 인덱스 (0 기반) |
-
-#### `getCells()`
-
-행의 모든 셀을 배열로 반환한다. 데이터 범위 내의 모든 열에 대한 셀이 포함된다.
-
----
-
-## `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>;
-}
-```
-
-### Methods
-
-#### `cell(r)`
-
-지정된 행 인덱스의 셀을 반환한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `r` | `number` | 행 인덱스 (0 기반) |
-
-#### `getCells()`
-
-열의 모든 셀을 배열로 반환한다. 데이터 범위 내의 모든 행에 대한 셀이 포함된다.
-
-#### `setWidth(size)`
-
-열 너비를 설정한다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `size` | `number` | 열 너비 |