@simplysm/excel 14.0.4 → 14.0.5

package/README.md

@@ -14,7 +14,8 @@ npm install @simplysm/excel
 
 | Category | Items | Documentation |
 |---|---|---|
-| Types & Utilities | 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, ExcelUtils | [docs/types.md](docs/types.md) |
+| 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) |
 

package/docs/types.md

@@ -1,6 +1,6 @@
-# Types & Utilities
+# Types
 
-Types, enums, and utility functions for Excel file processing.
+Types and enums for Excel file processing.
 
 ## XML Data Types
 
@@ -263,24 +263,3 @@ Cell style options.
 | `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/utils.md

@@ -0,0 +1,41 @@
+# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/excel",
-  "version": "14.0.4",
+  "version": "14.0.5",
   "description": "심플리즘 패키지 - 엑셀 (neutral)",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -24,6 +24,6 @@
   "dependencies": {
     "mime": "^4.1.0",
     "zod": "^4.3.6",
-    "@simplysm/core-common": "14.0.4"
+    "@simplysm/core-common": "14.0.5"
   }
 }