@simplysm/excel 14.0.22 → 14.0.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/excel",
-  "version": "14.0.22",
+  "version": "14.0.24",
   "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.22"
+    "@simplysm/core-common": "14.0.24"
   }
 }

package/README.md

@@ -1,108 +0,0 @@
-# @simplysm/excel
-
-Excel file processing library -- read/write .xlsx files with cell styling, formulas, images, and Zod schema-based typed wrapper.
-
-Platform: neutral (Node.js and browser).
-
-## Installation
-
-```bash
-npm install @simplysm/excel
-```
-
-## API Overview
-
-| Category | Items | Documentation |
-|---|---|---|
-| Types | ExcelXmlContentTypeData, ExcelXmlRelationshipData, ExcelRelationshipData, ExcelXmlWorkbookData, ExcelXmlWorksheetData, ExcelRowData, ExcelCellData, ExcelXmlDrawingData, ExcelXmlSharedStringData, ExcelXmlSharedStringDataSi, ExcelXmlSharedStringDataText, ExcelXmlStyleData, ExcelXmlStyleDataXf, ExcelXmlStyleDataFill, ExcelXmlStyleDataBorder, ExcelValueType, ExcelNumberFormat, ExcelCellType, ExcelAddressPoint, ExcelAddressRangePoint, ExcelXml, ExcelBorderPosition, ExcelHorizontalAlign, ExcelVerticalAlign, ExcelStyleOptions | [docs/types.md](docs/types.md) |
-| Utils | ExcelUtils | [docs/utils.md](docs/utils.md) |
-| Core Classes | ExcelCell, ExcelRow, ExcelCol, ExcelWorksheet, ExcelWorkbook | [docs/core.md](docs/core.md) |
-| Wrapper | ExcelWrapper | [docs/wrapper.md](docs/wrapper.md) |
-
-## Quick Start
-
-### Read an existing Excel file
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-await using wb = new ExcelWorkbook(fileBytes);
-const ws = await wb.getWorksheet(0);
-
-// Read a single cell
-const value = await ws.cell(0, 0).getValue();
-
-// Read as data table (first row = headers)
-const records = await ws.getDataTable();
-// records: Record<string, ExcelValueType>[]
-```
-
-### Create a new Excel file
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-await using wb = new ExcelWorkbook();
-const ws = await wb.addWorksheet("Sheet1");
-
-await ws.cell(0, 0).setValue("Name");
-await ws.cell(0, 1).setValue("Age");
-await ws.cell(1, 0).setValue("Alice");
-await ws.cell(1, 1).setValue(30);
-
-// Apply styling
-await ws.cell(0, 0).setStyle({
-  background: "00FFFF00",
-  border: ["left", "right", "top", "bottom"],
-  horizontalAlign: "center",
-});
-
-const bytes = await wb.toBytes();
-```
-
-### Typed read/write with Zod schema
-
-```typescript
-import { z } from "zod";
-import { ExcelWrapper } from "@simplysm/excel";
-
-const schema = z.object({
-  name: z.string().describe("Name"),
-  age: z.number().describe("Age"),
-  active: z.boolean().describe("Active").default(false),
-});
-
-const wrapper = new ExcelWrapper(schema);
-
-// Read with type safety and validation
-const records = await wrapper.read(fileBytes);
-
-// Write with automatic header/style generation
-await using wb = await wrapper.write("Sheet1", records);
-const bytes = await wb.toBytes();
-```
-
-### Insert an image
-
-```typescript
-await ws.addImage({
-  bytes: imageBytes,
-  ext: "png",
-  from: { r: 1, c: 1 },
-  to: { r: 5, c: 3 },
-});
-```
-
-### Row operations
-
-```typescript
-// Copy a row (overwrite)
-await ws.copyRow(0, 5);
-
-// Insert-copy a row (shifts existing rows down)
-await ws.insertCopyRow(0, 3);
-
-// Freeze header row and set zoom
-await ws.freezeAt({ r: 0 });
-await ws.setZoom(85);
-```

package/docs/core.md

@@ -1,147 +0,0 @@
-# Core Classes
-
-Core classes for reading and writing Excel workbooks, worksheets, rows, columns, and cells.
-
-## ExcelCell
-
-Represents a single Excel cell. Provides value read/write, formula, style, and cell merge operations.
-
-All methods are `async` because XML data (SharedStrings, Styles) is loaded on-demand for memory efficiency with large files.
-
-### Properties
-
-| Property | Type | Description |
-|---|---|---|
-| `addr` | `readonly ExcelAddressPoint` | Cell address (0-based row/column index) |
-
-### Public Methods
-
-| Method | Signature | Description |
-|---|---|---|
-| `setValue` | `(val: ExcelValueType) => Promise<void>` | Set cell value. Pass `undefined` to delete the cell. Handles string, number, boolean, DateOnly, DateTime, and Time types. Date/time values automatically apply the corresponding number format. |
-| `getValue` | `() => Promise<ExcelValueType>` | Read cell value. Returns the typed value based on cell type and number format. SharedString references are resolved automatically. |
-| `setFormula` | `(val: string \| undefined) => Promise<void>` | Set cell formula. Pass `undefined` to remove the formula. |
-| `getFormula` | `() => Promise<string \| undefined>` | Get cell formula. |
-| `merge` | `(r: number, c: number) => Promise<void>` | Merge from this cell to the given end coordinate (0-based). Example: `cell(0,0).merge(2,2)` merges A1:C3. |
-| `getStyleId` | `() => Promise<string \| undefined>` | Get the raw style ID of the cell. |
-| `setStyleId` | `(styleId: string \| undefined) => Promise<void>` | Set the raw style ID of the cell. |
-| `setStyle` | `(opts: ExcelStyleOptions) => Promise<void>` | Set cell style (background, border, alignment, number format). |
-
-## ExcelRow
-
-Represents a row in an Excel worksheet. Provides cell access.
-
-### Public Methods
-
-| Method | Signature | Description |
-|---|---|---|
-| `cell` | `(c: number) => ExcelCell` | Get cell at column index (0-based). Cached per instance. |
-| `getCells` | `() => Promise<ExcelCell[]>` | Get all cells in the row (within the worksheet's data range). |
-
-## ExcelCol
-
-Represents a column in an Excel worksheet. Provides cell access and column width control.
-
-### Public Methods
-
-| Method | Signature | Description |
-|---|---|---|
-| `cell` | `(r: number) => ExcelCell` | Get cell at row index (0-based). Cached per instance. |
-| `getCells` | `() => Promise<ExcelCell[]>` | Get all cells in the column (within the worksheet's data range). |
-| `setWidth` | `(size: number) => Promise<void>` | Set column width. |
-
-## ExcelWorksheet
-
-Represents an Excel worksheet. Provides cell access, row/column copy, data table processing, image insertion, and view settings.
-
-### Public Methods
-
-#### Name
-
-| Method | Signature | Description |
-|---|---|---|
-| `getName` | `() => Promise<string>` | Get worksheet name. |
-| `setName` | `(newName: string) => Promise<void>` | Rename the worksheet. |
-
-#### Cell Access
-
-| Method | Signature | Description |
-|---|---|---|
-| `row` | `(r: number) => ExcelRow` | Get row object (0-based). Cached per instance. |
-| `cell` | `(r: number, c: number) => ExcelCell` | Get cell object (0-based row/column). |
-| `col` | `(c: number) => ExcelCol` | Get column object (0-based). Cached per instance. |
-
-#### Copy
-
-| Method | Signature | Description |
-|---|---|---|
-| `copyRowStyle` | `(srcR: number, targetR: number) => Promise<void>` | Copy styles from source row to target row (all columns in range). |
-| `copyCellStyle` | `(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint) => Promise<void>` | Copy style from source cell to target cell. |
-| `copyRow` | `(srcR: number, targetR: number) => Promise<void>` | Copy source row to target row (overwrite). |
-| `copyCell` | `(srcAddr: ExcelAddressPoint, targetAddr: ExcelAddressPoint) => Promise<void>` | Copy source cell to target cell. |
-| `insertCopyRow` | `(srcR: number, targetR: number) => Promise<void>` | Insert-copy source row at target position. Existing rows at and below target are shifted down by one. Merge cells spanning the insertion point are automatically extended. |
-
-#### Range & Data
-
-| Method | Signature | Description |
-|---|---|---|
-| `getRange` | `() => Promise<ExcelAddressRangePoint>` | Get the data range of the worksheet. |
-| `getCells` | `() => Promise<ExcelCell[][]>` | Get all cells as a 2D array. |
-| `getDataTable` | `(opt?: { headerRowIndex?: number; checkEndColIndex?: number; usableHeaderNameFn?: (headerName: string) => boolean }) => Promise<Record<string, ExcelValueType>[]>` | Read worksheet data as an array of records. First row (or `headerRowIndex`) is used as headers. `checkEndColIndex` stops reading when that column is empty. `usableHeaderNameFn` filters which headers to include. |
-| `setDataMatrix` | `(matrix: ExcelValueType[][]) => Promise<void>` | Write a 2D array to the worksheet (row-major, index 0 is first row). |
-| `setRecords` | `(records: Record<string, ExcelValueType>[]) => Promise<void>` | Write an array of records. Headers are auto-generated in the first row from record keys. |
-
-#### View
-
-| Method | Signature | Description |
-|---|---|---|
-| `setZoom` | `(percent: number) => Promise<void>` | Set zoom level (percent). |
-| `freezeAt` | `(point: { r?: number; c?: number }) => Promise<void>` | Freeze rows/columns at the given position. |
-
-#### Image
-
-| Method | Signature | Description |
-|---|---|---|
-| `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>` | Insert an image. `bytes` is the image binary data, `ext` is the file extension (e.g., "png"). `from`/`to` define the anchor coordinates (0-based). Offsets are in EMU. If `to` is omitted, the image spans one cell from `from`. |
-
-## ExcelWorkbook
-
-Excel workbook processing class. Manages ZIP resources internally. Supports `await using` for automatic resource cleanup.
-
-### Constructor
-
-```typescript
-constructor(arg?: Blob | Bytes)
-```
-
-- `arg`: Existing Excel file data (Blob or Uint8Array). Omit to create a new empty workbook.
-
-### Properties
-
-| Property | Type | Description |
-|---|---|---|
-| `zipCache` | `readonly ZipCache` | Internal ZIP cache (advanced usage). |
-
-### Public Methods
-
-#### Worksheet
-
-| Method | Signature | Description |
-|---|---|---|
-| `getWorksheetNames` | `() => Promise<string[]>` | Get all worksheet names. |
-| `addWorksheet` | `(name: string) => Promise<ExcelWorksheet>` | Create and return a new worksheet. |
-| `getWorksheet` | `(nameOrIndex: string \| number) => Promise<ExcelWorksheet>` | Get worksheet by name or 0-based index. Throws if not found. |
-
-#### Export
-
-| Method | Signature | Description |
-|---|---|---|
-| `toBytes` | `() => Promise<Bytes>` | Export workbook as byte array. |
-| `toBlob` | `() => Promise<Blob>` | Export workbook as Blob (MIME: `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`). |
-
-#### Lifecycle
-
-| Method | Signature | Description |
-|---|---|---|
-| `close` | `() => Promise<void>` | Release resources. Safe to call on already-closed workbooks (no-op). After calling, the instance cannot be used. |
-| `[Symbol.asyncDispose]` | `() => Promise<void>` | Async dispose support (`await using`). Calls `close()`. |

package/docs/types.md

@@ -1,265 +0,0 @@
-# Types
-
-Types and enums for Excel file processing.
-
-## XML Data Types
-
-Internal XML structure types used by the library to represent .xlsx file contents.
-
-### ExcelXmlContentTypeData
-
-Represents `[Content_Types].xml` in the .xlsx archive.
-
-| Field | Type | Description |
-|---|---|---|
-| `Types.$` | `{ xmlns: string }` | XML namespace |
-| `Types.Default` | `Array<{ $: { Extension: string; ContentType: string } }>` | Default content type mappings by file extension |
-| `Types.Override` | `Array<{ $: { PartName: string; ContentType: string } }>` | Override content type mappings by part name |
-
-### ExcelXmlRelationshipData
-
-Represents a `_rels/*.rels` relationship file.
-
-| Field | Type | Description |
-|---|---|---|
-| `Relationships.$` | `{ xmlns: string }` | XML namespace |
-| `Relationships.Relationship?` | `ExcelRelationshipData[]` | Array of relationship entries |
-
-### ExcelRelationshipData
-
-A single relationship entry.
-
-| Field | Type | Description |
-|---|---|---|
-| `$.Id` | `string` | Relationship ID (e.g., "rId1") |
-| `$.Target` | `string` | Target path |
-| `$.Type` | `string` | Relationship type URI |
-
-### ExcelXmlWorkbookData
-
-Represents `xl/workbook.xml`.
-
-| Field | Type | Description |
-|---|---|---|
-| `workbook.$` | `{ xmlns: string; "xmlns:r"?: string }` | XML namespaces |
-| `workbook.bookViews?` | `[{ workbookView: [{}] }]` | Workbook view settings |
-| `workbook.sheets?` | `[{ sheet: Array<{ $: { name: string; sheetId: string; "r:id": string } }> }]` | Sheet definitions |
-
-### ExcelXmlWorksheetData
-
-Represents `xl/worksheets/sheet*.xml`.
-
-| Field | Type | Description |
-|---|---|---|
-| `worksheet.$` | `{ xmlns: string; "xmlns:r"?: string }` | XML namespaces |
-| `worksheet.dimension?` | `[{ $: { ref: string } }]` | Used range reference (e.g., "A1:C10") |
-| `worksheet.sheetViews?` | See source | Sheet view settings (zoom, freeze panes) |
-| `worksheet.sheetFormatPr?` | `[{ $: { defaultRowHeight: string } }]` | Default row height |
-| `worksheet.cols?` | `[{ col: Array<{ $: { min: string; max: string; width?: string; bestFit?: string; customWidth?: string } }> }]` | Column width definitions |
-| `worksheet.sheetData` | `[{ row?: ExcelRowData[] }]` | Row data (required) |
-| `worksheet.mergeCells?` | `[{ $: { count: string }; mergeCell: Array<{ $: { ref: string } }> }]` | Merged cell ranges |
-| `worksheet.drawing?` | `Array<{ $: { "r:id": string } }>` | Drawing references |
-
-### ExcelRowData
-
-A single row in worksheet data.
-
-| Field | Type | Description |
-|---|---|---|
-| `$.r` | `string` | Row address (1-based, e.g., "1") |
-| `c?` | `ExcelCellData[]` | Cell data array |
-
-### ExcelCellData
-
-A single cell in row data.
-
-| Field | Type | Description |
-|---|---|---|
-| `$.r` | `string` | Cell address (e.g., "A1") |
-| `$.s?` | `string` | Style ID |
-| `$.t?` | `ExcelCellType` | Cell type |
-| `v?` | `[string]` | Cell value |
-| `f?` | `[string]` | Cell formula |
-| `is?` | `Array<{ t?: (string \| { _?: string })[] }>` | Inline string data |
-
-### ExcelXmlDrawingData
-
-Represents `xl/drawings/drawing*.xml`.
-
-| Field | Type | Description |
-|---|---|---|
-| `wsDr.$` | `{ xmlns: string; "xmlns:a"?: string; "xmlns:r"?: string }` | XML namespaces |
-| `wsDr.twoCellAnchor?` | Array | Two-cell anchor picture definitions (from/to coordinates, picture properties, blip fill) |
-
-### ExcelXmlSharedStringData
-
-Represents `xl/sharedStrings.xml`.
-
-| Field | Type | Description |
-|---|---|---|
-| `sst.$` | `{ xmlns: string }` | XML namespace |
-| `sst.si?` | `ExcelXmlSharedStringDataSi[]` | Shared string items |
-
-### ExcelXmlSharedStringDataSi
-
-```typescript
-type ExcelXmlSharedStringDataSi =
-  | { t: ExcelXmlSharedStringDataText }
-  | { r: { t: ExcelXmlSharedStringDataText }[] };
-```
-
-Either a plain text item (`t`) or a rich text item (`r`) with multiple runs.
-
-### ExcelXmlSharedStringDataText
-
-```typescript
-type ExcelXmlSharedStringDataText = [string | { $: { space?: "preserve" }; _?: string }];
-```
-
-A single-element tuple: either a plain string or an object with optional space-preservation attribute.
-
-### ExcelXmlStyleData
-
-Represents `xl/styles.xml`.
-
-| Field | Type | Description |
-|---|---|---|
-| `styleSheet.$` | `{ xmlns: string }` | XML namespace |
-| `styleSheet.numFmts?` | `[{ $: { count: string }; numFmt?: Array<{ $: { numFmtId: string; formatCode: string } }> }]` | Number format definitions |
-| `styleSheet.fonts` | `[{ $: { count: string }; font: {}[] }]` | Font definitions |
-| `styleSheet.fills` | `[{ $: { count: string }; fill: ExcelXmlStyleDataFill[] }]` | Fill definitions |
-| `styleSheet.borders` | `[{ $: { count: string }; border: ExcelXmlStyleDataBorder[] }]` | Border definitions |
-| `styleSheet.cellXfs` | `[{ $: { count: string }; xf: ExcelXmlStyleDataXf[] }]` | Cell format definitions |
-
-### ExcelXmlStyleDataXf
-
-| Field | Type | Description |
-|---|---|---|
-| `$.numFmtId?` | `string` | Number format ID |
-| `$.fontId?` | `string` | Font ID |
-| `$.fillId?` | `string` | Fill ID |
-| `$.borderId?` | `string` | Border ID |
-| `$.xfId?` | `string` | Parent xf ID |
-| `$.applyNumberFormat?` | `string` | Whether number format is applied |
-| `$.applyFont?` | `string` | Whether font is applied |
-| `$.applyAlignment?` | `string` | Whether alignment is applied |
-| `$.applyFill?` | `string` | Whether fill is applied |
-| `$.applyBorder?` | `string` | Whether border is applied |
-| `alignment?` | `[{ $: { horizontal?: "center" \| "left" \| "right"; vertical?: "center" \| "top" \| "bottom" } }]` | Alignment settings |
-
-### ExcelXmlStyleDataFill
-
-| Field | Type | Description |
-|---|---|---|
-| `patternFill` | `[{ $: { patternType: "none" \| "solid" \| "gray125" }; fgColor?: [{ $: { rgb: string } }] }]` | Pattern fill with optional foreground color (ARGB) |
-
-### ExcelXmlStyleDataBorder
-
-| Field | Type | Description |
-|---|---|---|
-| `top?` | `[{ $: { style: "thin" \| "medium" }; color?: [{ $: { rgb: string } }] }]` | Top border |
-| `left?` | `[{ $: { style: "thin" \| "medium" }; color?: [{ $: { rgb: string } }] }]` | Left border |
-| `right?` | `[{ $: { style: "thin" \| "medium" }; color?: [{ $: { rgb: string } }] }]` | Right border |
-| `bottom?` | `[{ $: { style: "thin" \| "medium" }; color?: [{ $: { rgb: string } }] }]` | Bottom border |
-
-## Value Types
-
-### ExcelValueType
-
-```typescript
-type ExcelValueType = number | string | DateOnly | DateTime | Time | boolean | undefined;
-```
-
-Union of all supported cell value types. `DateOnly`, `DateTime`, and `Time` are from `@simplysm/core-common`.
-
-### ExcelNumberFormat
-
-```typescript
-type ExcelNumberFormat = "number" | "string" | "DateOnly" | "DateTime" | "Time";
-```
-
-Named number format categories for cell formatting.
-
-### ExcelCellType
-
-```typescript
-type ExcelCellType = "s" | "b" | "str" | "n" | "inlineStr" | "e";
-```
-
-| Value | Description |
-|---|---|
-| `"s"` | Shared string |
-| `"b"` | Boolean |
-| `"str"` | Formula result string |
-| `"n"` | Number |
-| `"inlineStr"` | Inline string (rich text) |
-| `"e"` | Error |
-
-## Address Types
-
-### ExcelAddressPoint
-
-A cell coordinate (0-based).
-
-| Field | Type | Description |
-|---|---|---|
-| `r` | `number` | Row index (0-based) |
-| `c` | `number` | Column index (0-based) |
-
-### ExcelAddressRangePoint
-
-A rectangular cell range.
-
-| Field | Type | Description |
-|---|---|---|
-| `s` | `ExcelAddressPoint` | Start (top-left) coordinate |
-| `e` | `ExcelAddressPoint` | End (bottom-right) coordinate |
-
-## ExcelXml Interface
-
-```typescript
-interface ExcelXml {
-  readonly data: unknown;
-  cleanup(): void;
-}
-```
-
-Internal interface for XML document wrappers.
-
-| Member | Type | Description |
-|---|---|---|
-| `data` | `readonly unknown` | Raw XML data |
-| `cleanup()` | `void` | Release resources |
-
-## Style Types
-
-### ExcelBorderPosition
-
-```typescript
-type ExcelBorderPosition = "left" | "right" | "top" | "bottom";
-```
-
-### ExcelHorizontalAlign
-
-```typescript
-type ExcelHorizontalAlign = "center" | "left" | "right";
-```
-
-### ExcelVerticalAlign
-
-```typescript
-type ExcelVerticalAlign = "center" | "top" | "bottom";
-```
-
-### ExcelStyleOptions
-
-Cell style options.
-
-| Field | Type | Description |
-|---|---|---|
-| `background?` | `string` | Background color in ARGB format (e.g., `"00FF0000"` for red) |
-| `border?` | `ExcelBorderPosition[]` | Border positions to apply |
-| `horizontalAlign?` | `ExcelHorizontalAlign` | Horizontal alignment |
-| `verticalAlign?` | `ExcelVerticalAlign` | Vertical alignment |
-| `numberFormat?` | `ExcelNumberFormat` | Number format |
-

package/docs/utils.md

@@ -1,41 +0,0 @@
-# Utils
-
-## `ExcelUtils`
-
-Static utility class for Excel address conversion, date/number conversion, and number format handling.
-
-```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;
-}
-```
-
-### Methods
-
-| Method | Parameters | Returns | Description |
-|---|---|---|---|
-| `stringifyAddr` | `point: ExcelAddressPoint` | `string` | Convert coordinate to "A1" format string |
-| `stringifyRowAddr` | `r: number` | `string` | Convert row index (0-based) to row address (e.g. 0 -> "1") |
-| `stringifyColAddr` | `c: number` | `string` | Convert column index (0-based) to column address (e.g. 0 -> "A", 26 -> "AA"). Range: 0-16383 |
-| `parseRowAddr` | `addr: string` | `number` | Extract row index from cell address (e.g. "A3" -> 2) |
-| `parseColAddr` | `addr: string` | `number` | Extract column index from cell address (e.g. "B3" -> 1) |
-| `parseCellAddr` | `addr: string` | `ExcelAddressPoint` | Parse cell address to coordinate (e.g. "B3" -> `{r: 2, c: 1}`) |
-| `parseRangeAddr` | `rangeAddr: string` | `ExcelAddressRangePoint` | Parse range address to coordinates (e.g. "A1:C3" -> `{s: {r:0,c:0}, e: {r:2,c:2}}`) |
-| `stringifyRangeAddr` | `point: ExcelAddressRangePoint` | `string` | Convert range coordinates to address string |
-| `convertTimeTickToNumber` | `tick: number` | `number` | Convert JS timestamp (ms) to Excel date number (1900 date system) |
-| `convertNumberToTimeTick` | `value: number` | `number` | Convert Excel date number to JS timestamp (ms) |
-| `convertNumFmtCodeToName` | `numFmtCode: string` | `ExcelNumberFormat` | Convert number format code string to format name |
-| `convertNumFmtIdToName` | `numFmtId: number` | `ExcelNumberFormat` | Convert built-in number format ID to format name |
-| `convertNumFmtNameToId` | `numFmtName: ExcelNumberFormat` | `number` | Convert format name to built-in number format ID |

package/docs/wrapper.md

@@ -1,70 +0,0 @@
-# ExcelWrapper
-
-Zod schema-based typed Excel wrapper for type-safe reading and writing.
-
-## ExcelWrapper\<TSchema\>
-
-```typescript
-class ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>>
-```
-
-Generic class parameterized by a Zod object schema. The schema defines the record structure and uses `.describe()` to set Excel header names.
-
-### Constructor
-
-```typescript
-constructor(schema: TSchema)
-```
-
-| Parameter | Type | Description |
-|---|---|---|
-| `schema` | `TSchema` (extends `z.ZodObject`) | Zod schema defining the record structure. Use `.describe("Header Name")` on each field to set the Excel column header. |
-
-### Public Methods
-
-| Method | Signature | Description |
-|---|---|---|
-| `read` | `(file: Bytes \| Blob, wsNameOrIndex?: string \| number, options?: { excludes?: (keyof z.infer<TSchema>)[] }) => Promise<z.infer<TSchema>[]>` | Read an Excel file into a typed record array. Validates each row against the Zod schema. Throws on validation failure or when no data is found. Default worksheet: index 0. |
-| `write` | `(wsName: string, records: Partial<z.infer<TSchema>>[], options?: { excludes?: (keyof z.infer<TSchema>)[] }) => Promise<ExcelWorkbook>` | Convert records to an Excel workbook. Returns an `ExcelWorkbook` -- caller is responsible for resource management (`await using` or `close()`). Automatically: writes headers from schema descriptions, applies borders to all cells, highlights required field headers in yellow, sets 85% zoom, freezes the header row. |
-
-### Read Behavior
-
-- Maps Excel headers to schema fields using `.describe()` display names
-- Skips rows where all values are null/empty
-- Converts cell values to match schema types (string, number, boolean, DateOnly, DateTime, Time)
-- Boolean fields default to `false` when empty
-- Validates each row with `schema.safeParse()` and throws with detailed error messages on failure
-
-### Write Behavior
-
-- Header row uses schema field descriptions (falls back to field key)
-- Required non-boolean fields get yellow background highlight (`00FFFF00`)
-- All data cells get borders on all four sides
-- Sets zoom to 85% and freezes the header row
-
-### Usage Example
-
-```typescript
-import { z } from "zod";
-import { ExcelWrapper } from "@simplysm/excel";
-
-const schema = z.object({
-  name: z.string().describe("Name"),
-  age: z.number().describe("Age"),
-  active: z.boolean().describe("Active").default(false),
-  birthDate: z.instanceof(DateOnly).optional().describe("Birth Date"),
-});
-
-const wrapper = new ExcelWrapper(schema);
-
-// Read
-const records = await wrapper.read(fileBytes);
-// records: { name: string; age: number; active: boolean; birthDate?: DateOnly }[]
-
-// Write
-await using wb = await wrapper.write("Sheet1", [
-  { name: "Alice", age: 30, active: true },
-  { name: "Bob", age: 25 },
-]);
-const bytes = await wb.toBytes();
-```