@simplysm/excel 13.0.100 → 14.0.4

package/docs/types.md

@@ -1,297 +1,286 @@
-# Types
+# Types & Utilities
 
-All type exports from the excel package.
+Types, enums, and utility functions for Excel file processing.
 
-```typescript
-import type {
-  ExcelValueType,
-  ExcelNumberFormat,
-  ExcelCellType,
-  ExcelAddressPoint,
-  ExcelAddressRangePoint,
-  ExcelStyleOptions,
-  ExcelBorderPosition,
-  ExcelHorizontalAlign,
-  ExcelVerticalAlign,
-  ExcelXml,
-  // XML data types (internal)
-  ExcelXmlContentTypeData,
-  ExcelXmlRelationshipData,
-  ExcelXmlWorkbookData,
-  ExcelXmlWorksheetData,
-  ExcelRowData,
-  ExcelCellData,
-  ExcelXmlDrawingData,
-  ExcelXmlSharedStringData,
-  ExcelXmlSharedStringDataSi,
-  ExcelXmlSharedStringDataText,
-  ExcelXmlStyleData,
-  ExcelXmlStyleDataXf,
-  ExcelXmlStyleDataFill,
-  ExcelXmlStyleDataBorder,
-} from "@simplysm/excel";
-```
+## XML Data Types
 
-## Value Types
+Internal XML structure types used by the library to represent .xlsx file contents.
 
-### `ExcelValueType`
+### ExcelXmlContentTypeData
 
-Union of supported cell value types.
+Represents `[Content_Types].xml` in the .xlsx archive.
 
-```typescript
-type ExcelValueType = number | string | DateOnly | DateTime | Time | boolean | undefined;
-```
+| 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 |
 
-### `ExcelNumberFormat`
+### ExcelXmlRelationshipData
 
-Number format name.
+Represents a `_rels/*.rels` relationship file.
 
-```typescript
-type ExcelNumberFormat = "number" | "string" | "DateOnly" | "DateTime" | "Time";
-```
+| Field | Type | Description |
+|---|---|---|
+| `Relationships.$` | `{ xmlns: string }` | XML namespace |
+| `Relationships.Relationship?` | `ExcelRelationshipData[]` | Array of relationship entries |
 
-### `ExcelCellType`
+### ExcelRelationshipData
 
-Excel cell type identifier.
+A single relationship entry.
 
-```typescript
-type ExcelCellType = "s" | "b" | "str" | "n" | "inlineStr" | "e";
-```
+| Field | Type | Description |
+|---|---|---|
+| `$.Id` | `string` | Relationship ID (e.g., "rId1") |
+| `$.Target` | `string` | Target path |
+| `$.Type` | `string` | Relationship type URI |
 
-- `s` -- shared string (SharedString)
-- `b` -- boolean
-- `str` -- formula result string
-- `n` -- number
-- `inlineStr` -- inline string (rich text)
-- `e` -- error
+### ExcelXmlWorkbookData
 
-## Address Types
+Represents `xl/workbook.xml`.
 
-### `ExcelAddressPoint`
+| 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 |
 
-Cell coordinate (0-based).
+### ExcelXmlWorksheetData
 
-```typescript
-interface ExcelAddressPoint {
-  r: number;
-  c: number;
-}
-```
+Represents `xl/worksheets/sheet*.xml`.
 
-### `ExcelAddressRangePoint`
+| 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 |
 
-Range of cell coordinates (start and end).
+### ExcelRowData
 
-```typescript
-interface ExcelAddressRangePoint {
-  s: ExcelAddressPoint;
-  e: ExcelAddressPoint;
-}
-```
+A single row in worksheet data.
 
-## Style Types
+| Field | Type | Description |
+|---|---|---|
+| `$.r` | `string` | Row address (1-based, e.g., "1") |
+| `c?` | `ExcelCellData[]` | Cell data array |
 
-### `ExcelBorderPosition`
+### ExcelCellData
 
-```typescript
-type ExcelBorderPosition = "left" | "right" | "top" | "bottom";
-```
+A single cell in row data.
 
-### `ExcelHorizontalAlign`
+| 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 |
 
-```typescript
-type ExcelHorizontalAlign = "center" | "left" | "right";
-```
+### ExcelXmlDrawingData
 
-### `ExcelVerticalAlign`
+Represents `xl/drawings/drawing*.xml`.
 
-```typescript
-type ExcelVerticalAlign = "center" | "top" | "bottom";
-```
+| 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) |
 
-### `ExcelStyleOptions`
+### ExcelXmlSharedStringData
 
-Cell style options.
+Represents `xl/sharedStrings.xml`.
 
-```typescript
-interface ExcelStyleOptions {
-  /** Background color (ARGB format, e.g. "00FF0000") */
-  background?: string;
-  /** Border positions */
-  border?: ExcelBorderPosition[];
-  /** Horizontal alignment */
-  horizontalAlign?: ExcelHorizontalAlign;
-  /** Vertical alignment */
-  verticalAlign?: ExcelVerticalAlign;
-  /** Number format */
-  numberFormat?: ExcelNumberFormat;
-}
-```
+| Field | Type | Description |
+|---|---|---|
+| `sst.$` | `{ xmlns: string }` | XML namespace |
+| `sst.si?` | `ExcelXmlSharedStringDataSi[]` | Shared string items |
+
+### ExcelXmlSharedStringDataSi
 
-**Example:**
 ```typescript
-await cell.setStyle({
-  background: "00FF0000",
-  border: ["left", "right", "top", "bottom"],
-  horizontalAlign: "center",
-  verticalAlign: "center",
-  numberFormat: "number",
-});
+type ExcelXmlSharedStringDataSi =
+  | { t: ExcelXmlSharedStringDataText }
+  | { r: { t: ExcelXmlSharedStringDataText }[] };
 ```
 
-## Excel XML Interface
+Either a plain text item (`t`) or a rich text item (`r`) with multiple runs.
 
-### `ExcelXml`
+### ExcelXmlSharedStringDataText
 
 ```typescript
-interface ExcelXml {
-  readonly data: unknown;
-  cleanup(): void;
-}
+type ExcelXmlSharedStringDataText = [string | { $: { space?: "preserve" }; _?: string }];
 ```
 
-## XML Data Types
+A single-element tuple: either a plain string or an object with optional space-preservation attribute.
 
-These types represent the internal XML structure of `.xlsx` files. They are used internally by the library but exported for advanced use cases.
+### ExcelXmlStyleData
 
-### `ExcelXmlContentTypeData`
+Represents `xl/styles.xml`.
 
-Content type definitions (`[Content_Types].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 |
 
-```typescript
-interface ExcelXmlContentTypeData {
-  Types: {
-    $: { xmlns: string };
-    Default: { $: { Extension: string; ContentType: string } }[];
-    Override: { $: { PartName: string; ContentType: string } }[];
-  };
-}
-```
+### ExcelXmlStyleDataXf
 
-### `ExcelXmlRelationshipData`
+| 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 |
 
-Relationship definitions (`.rels` files).
+### ExcelXmlStyleDataFill
 
-```typescript
-interface ExcelXmlRelationshipData {
-  Relationships: {
-    $: { xmlns: string };
-    Relationship?: ExcelRelationshipData[];
-  };
-}
-```
+| Field | Type | Description |
+|---|---|---|
+| `patternFill` | `[{ $: { patternType: "none" \| "solid" \| "gray125" }; fgColor?: [{ $: { rgb: string } }] }]` | Pattern fill with optional foreground color (ARGB) |
 
-### `ExcelXmlWorkbookData`
+### ExcelXmlStyleDataBorder
 
-Workbook XML data.
+| 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
-interface ExcelXmlWorkbookData {
-  workbook: {
-    $: { "xmlns": string; "xmlns:r"?: string };
-    bookViews?: [{ workbookView: [{}] }];
-    sheets?: [{ sheet: { $: { "name": string; "sheetId": string; "r:id": string } }[] }];
-  };
-}
+type ExcelValueType = number | string | DateOnly | DateTime | Time | boolean | undefined;
 ```
 
-### `ExcelXmlWorksheetData`
+Union of all supported cell value types. `DateOnly`, `DateTime`, and `Time` are from `@simplysm/core-common`.
 
-Worksheet XML data. Contains sheet data, dimensions, views, columns, merge cells, and drawing references.
-
-### `ExcelRowData`
+### ExcelNumberFormat
 
 ```typescript
-interface ExcelRowData {
-  $: { r: string }; // row address (1-based)
-  c?: ExcelCellData[];
-}
+type ExcelNumberFormat = "number" | "string" | "DateOnly" | "DateTime" | "Time";
 ```
 
-### `ExcelCellData`
+Named number format categories for cell formatting.
+
+### ExcelCellType
 
 ```typescript
-interface ExcelCellData {
-  $: {
-    r: string;          // cell address (e.g. "A1")
-    s?: string;         // styleId
-    t?: ExcelCellType;  // type
-  };
-  v?: [string];          // value
-  f?: [string];          // formula
-  is?: { t?: (string | { _?: string })[] }[];  // inline string
-}
+type ExcelCellType = "s" | "b" | "str" | "n" | "inlineStr" | "e";
 ```
 
-### `ExcelXmlDrawingData`
+| Value | Description |
+|---|---|
+| `"s"` | Shared string |
+| `"b"` | Boolean |
+| `"str"` | Formula result string |
+| `"n"` | Number |
+| `"inlineStr"` | Inline string (rich text) |
+| `"e"` | Error |
 
-Drawing XML data (embedded images).
+## Address Types
 
-### `ExcelXmlSharedStringData`
+### ExcelAddressPoint
 
-Shared strings table.
+A cell coordinate (0-based).
 
-```typescript
-interface ExcelXmlSharedStringData {
-  sst: {
-    $: { xmlns: string };
-    si?: ExcelXmlSharedStringDataSi[];
-  };
-}
-```
+| Field | Type | Description |
+|---|---|---|
+| `r` | `number` | Row index (0-based) |
+| `c` | `number` | Column index (0-based) |
 
-### `ExcelXmlSharedStringDataSi`
+### ExcelAddressRangePoint
 
-```typescript
-type ExcelXmlSharedStringDataSi =
-  | { t: ExcelXmlSharedStringDataText }
-  | { r: { t: ExcelXmlSharedStringDataText }[] };
-```
+A rectangular cell range.
+
+| Field | Type | Description |
+|---|---|---|
+| `s` | `ExcelAddressPoint` | Start (top-left) coordinate |
+| `e` | `ExcelAddressPoint` | End (bottom-right) coordinate |
 
-### `ExcelXmlSharedStringDataText`
+## ExcelXml Interface
 
 ```typescript
-type ExcelXmlSharedStringDataText = [
-  string | { $: { space?: "preserve" }; _?: string },
-];
+interface ExcelXml {
+  readonly data: unknown;
+  cleanup(): void;
+}
 ```
 
-### `ExcelXmlStyleData`
+Internal interface for XML document wrappers.
 
-Style definitions (styles.xml). Contains number formats, fonts, fills, borders, and cell formats.
+| Member | Type | Description |
+|---|---|---|
+| `data` | `readonly unknown` | Raw XML data |
+| `cleanup()` | `void` | Release resources |
 
-### `ExcelXmlStyleDataXf`
+## Style Types
 
-Cell format definition.
+### ExcelBorderPosition
 
 ```typescript
-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" } }];
-}
+type ExcelBorderPosition = "left" | "right" | "top" | "bottom";
 ```
 
-### `ExcelXmlStyleDataFill`
+### ExcelHorizontalAlign
+
+```typescript
+type ExcelHorizontalAlign = "center" | "left" | "right";
+```
 
-Fill style definition.
+### ExcelVerticalAlign
 
 ```typescript
-interface ExcelXmlStyleDataFill {
-  patternFill: [{ $: { patternType: "none" | "solid" | "gray125" }; fgColor?: [{ $: { rgb: string } }] }];
-}
+type ExcelVerticalAlign = "center" | "top" | "bottom";
 ```
 
-### `ExcelXmlStyleDataBorder`
+### ExcelStyleOptions
+
+Cell style options.
 
-Border style definition. Each side (`top`, `left`, `right`, `bottom`) has `style` (`"thin"` | `"medium"`) and optional `color`.
+| 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 |
+
+## ExcelUtils
+
+Static utility class for cell address conversion, date/number conversion, and number format handling.
+
+### Static Methods
+
+| Method | Signature | Description |
+|---|---|---|
+| `stringifyAddr` | `(point: ExcelAddressPoint) => string` | Convert cell coordinate to "A1" format string |
+| `stringifyRowAddr` | `(r: number) => string` | Convert 0-based row index to row address (e.g., 0 -> "1") |
+| `stringifyColAddr` | `(c: number) => string` | Convert 0-based column index to column address (e.g., 0 -> "A", 26 -> "AA") |
+| `parseRowAddr` | `(addr: string) => number` | Extract 0-based row index from cell address (e.g., "A3" -> 2) |
+| `parseColAddr` | `(addr: string) => number` | Extract 0-based 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 (e.g., "A1:C3" -> `{s: {r:0,c:0}, e: {r:2,c:2}}`) |
+| `stringifyRangeAddr` | `(point: ExcelAddressRangePoint) => string` | Convert range coordinate to address string |
+| `convertTimeTickToNumber` | `(tick: number) => number` | Convert JS timestamp (ms) to Excel date number |
+| `convertNumberToTimeTick` | `(value: number) => number` | Convert Excel date number to JS timestamp (ms) |
+| `convertNumFmtCodeToName` | `(numFmtCode: string) => ExcelNumberFormat` | Convert number format code 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 format ID |

package/docs/wrapper.md

@@ -1,12 +1,14 @@
 # ExcelWrapper
 
-Zod schema-based Excel wrapper. Infers type information from schema to provide type-safe read/write.
+Zod schema-based typed Excel wrapper for type-safe reading and writing.
+
+## ExcelWrapper\<TSchema\>
 
 ```typescript
-import { ExcelWrapper } from "@simplysm/excel";
+class ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>>
 ```
 
-## Class: `ExcelWrapper<TSchema>`
+Generic class parameterized by a Zod object schema. The schema defines the record structure and uses `.describe()` to set Excel header names.
 
 ### Constructor
 
@@ -14,61 +16,33 @@ import { ExcelWrapper } from "@simplysm/excel";
 constructor(schema: TSchema)
 ```
 
-- `schema` -- Zod object schema. Defines the record structure. Use `.describe()` on fields to specify Excel header names.
+| 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. |
 
-### `read`
+### Public Methods
 
-Read Excel file into record array.
+| 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. |
 
-```typescript
-async read(
-  file: Bytes | Blob,
-  wsNameOrIndex?: string | number,
-  options?: { excludes?: (keyof z.infer<TSchema>)[] },
-): Promise<z.infer<TSchema>[]>;
-```
+### Read Behavior
 
-**Parameters:**
-- `file` -- Excel file data (Uint8Array or Blob)
-- `wsNameOrIndex` -- Worksheet name or index (default: `0`)
-- `options.excludes` -- Field keys to exclude from reading
+- 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
 
-Values are automatically converted based on the Zod schema type:
-- `ZodString` -- converts to string
-- `ZodNumber` -- converts to number
-- `ZodBoolean` -- converts to boolean (`"1"`, `"true"` -> `true`)
-- `DateOnly`, `DateTime`, `Time` -- preserved as-is from Excel
+### Write Behavior
 
-Each row is validated against the Zod schema. Rows where all values are empty are skipped.
+- 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
 
-### `write`
-
-Record array to Excel workbook.
-
-The caller is responsible for managing the returned workbook's resources. Use `await using` or call `close()` after use.
-
-```typescript
-async write(
-  wsName: string,
-  records: Partial<z.infer<TSchema>>[],
-  options?: { excludes?: (keyof z.infer<TSchema>)[] },
-): Promise<ExcelWorkbook>;
-```
-
-**Parameters:**
-- `wsName` -- Worksheet name
-- `records` -- Record array to write
-- `options.excludes` -- Field keys to exclude from writing
-
-**Behavior:**
-- Headers are written in the first row using `.describe()` names (or field keys if no description)
-- Data rows follow from row index 1
-- All cells get border styling (`left`, `right`, `top`, `bottom`)
-- Required field headers (non-optional, non-nullable, non-default, non-boolean) are highlighted in yellow (`00FFFF00`)
-- Zoom is set to 85%
-- First row is frozen
-
-## Example
+### Usage Example
 
 ```typescript
 import { z } from "zod";
@@ -77,24 +51,20 @@ import { ExcelWrapper } from "@simplysm/excel";
 const schema = z.object({
   name: z.string().describe("Name"),
   age: z.number().describe("Age"),
-  email: z.string().optional().describe("Email"),
-  active: z.boolean().default(false).describe("Active"),
+  active: z.boolean().describe("Active").default(false),
+  birthDate: z.instanceof(DateOnly).optional().describe("Birth Date"),
 });
 
 const wrapper = new ExcelWrapper(schema);
 
-// Read Excel file
+// Read
 const records = await wrapper.read(fileBytes);
-// records: { name: string; age: number; email?: string; active: boolean }[]
+// records: { name: string; age: number; active: boolean; birthDate?: DateOnly }[]
 
-// Write to Excel
-await using wb = await wrapper.write("Users", [
-  { name: "Alice", age: 30, email: "alice@example.com" },
+// Write
+await using wb = await wrapper.write("Sheet1", [
+  { name: "Alice", age: 30, active: true },
   { name: "Bob", age: 25 },
 ]);
 const bytes = await wb.toBytes();
-
-// Exclude specific fields
-const records2 = await wrapper.read(fileBytes, 0, { excludes: ["email"] });
-await using wb2 = await wrapper.write("Users", records2, { excludes: ["email"] });
 ```

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/excel",
-  "version": "13.0.100",
-  "description": "Excel file processing library",
-  "author": "simplysm",
+  "version": "14.0.4",
+  "description": "심플리즘 패키지 - 엑셀 (neutral)",
+  "author": "심플리즘",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -14,14 +14,16 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "docs",
     "src",
-    "tests"
+    "docs"
   ],
   "sideEffects": false,
+  "devDependencies": {
+    "@types/node": "^20.19.37"
+  },
   "dependencies": {
     "mime": "^4.1.0",
     "zod": "^4.3.6",
-    "@simplysm/core-common": "13.0.100"
+    "@simplysm/core-common": "14.0.4"
   }
 }