@cj-tech-master/excelts 1.1.0 → 1.4.0

package/dist/types/utils/cell-format.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Excel Cell Format Parser
+ * A simplified implementation for formatting cell values according to Excel numFmt patterns
+ * Supports: General, percentages, decimals, thousands separators, dates, currencies,
+ * scientific notation, fractions, elapsed time, and more
+ */
+/**
+ * Get format string from numFmtId
+ * Handles default mappings for certain format IDs
+ */
+export declare function getFormat(numFmtId: number): string;
+/**
+ * Check if format is "General"
+ */
+declare function isGeneral(fmt: string): boolean;
+/**
+ * Check if format is a date format
+ */
+declare function isDateFormat(fmt: string): boolean;
+/**
+ * Main format function - formats a value according to Excel numFmt
+ * @param fmt The Excel number format string (e.g., "0.00%", "#,##0", "yyyy-mm-dd")
+ * @param val The value to format
+ */
+export declare function format(fmt: string, val: number | string | boolean): string;
+export declare const cellFormat: {
+    format: typeof format;
+    getFormat: typeof getFormat;
+    isDateFormat: typeof isDateFormat;
+    isGeneral: typeof isGeneral;
+};
+export {};

package/dist/types/utils/{extra-utils.d.ts → sheet-utils.d.ts}

@@ -1,7 +1,6 @@
 /**
  * Utility functions for ExcelTS
  * Provides convenient helper functions for common spreadsheet operations
- * compatible with xlsx library's utils API but built on excelts native types
  */
 import { Workbook } from "../doc/workbook.js";
 import type { Worksheet } from "../doc/worksheet.js";
@@ -30,44 +29,44 @@ export interface Range {
 export type JSONRow = Record<string, CellValue>;
 /**
  * Decode column string to 0-indexed number
- * @example decode_col("A") => 0, decode_col("Z") => 25, decode_col("AA") => 26
+ * @example decodeCol("A") => 0, decodeCol("Z") => 25, decodeCol("AA") => 26
  */
-export declare function decode_col(colstr: string): number;
+export declare function decodeCol(colstr: string): number;
 /**
  * Encode 0-indexed column number to string
- * @example encode_col(0) => "A", encode_col(25) => "Z", encode_col(26) => "AA"
+ * @example encodeCol(0) => "A", encodeCol(25) => "Z", encodeCol(26) => "AA"
  */
-export declare function encode_col(col: number): string;
+export declare function encodeCol(col: number): string;
 /**
  * Decode row string to 0-indexed number
- * @example decode_row("1") => 0, decode_row("10") => 9
+ * @example decodeRow("1") => 0, decodeRow("10") => 9
  */
-export declare function decode_row(rowstr: string): number;
+export declare function decodeRow(rowstr: string): number;
 /**
  * Encode 0-indexed row number to string
- * @example encode_row(0) => "1", encode_row(9) => "10"
+ * @example encodeRow(0) => "1", encodeRow(9) => "10"
  */
-export declare function encode_row(row: number): string;
+export declare function encodeRow(row: number): string;
 /**
  * Decode cell address string to CellAddress object
- * @example decode_cell("A1") => {c: 0, r: 0}, decode_cell("B2") => {c: 1, r: 1}
+ * @example decodeCell("A1") => {c: 0, r: 0}, decodeCell("B2") => {c: 1, r: 1}
  */
-export declare function decode_cell(cstr: string): CellAddress;
+export declare function decodeCell(cstr: string): CellAddress;
 /**
  * Encode CellAddress object to cell address string
- * @example encode_cell({c: 0, r: 0}) => "A1", encode_cell({c: 1, r: 1}) => "B2"
+ * @example encodeCell({c: 0, r: 0}) => "A1", encodeCell({c: 1, r: 1}) => "B2"
  */
-export declare function encode_cell(cell: CellAddress): string;
+export declare function encodeCell(cell: CellAddress): string;
 /**
  * Decode range string to Range object
- * @example decode_range("A1:B2") => {s: {c: 0, r: 0}, e: {c: 1, r: 1}}
+ * @example decodeRange("A1:B2") => {s: {c: 0, r: 0}, e: {c: 1, r: 1}}
  */
-export declare function decode_range(range: string): Range;
+export declare function decodeRange(range: string): Range;
 /**
  * Encode Range object to range string
  */
-export declare function encode_range(range: Range): string;
-export declare function encode_range(start: CellAddress, end: CellAddress): string;
+export declare function encodeRange(range: Range): string;
+export declare function encodeRange(start: CellAddress, end: CellAddress): string;
 /** Origin can be cell address string, cell object, row number, or -1 to append */
 export type Origin = string | CellAddress | number;
 export interface JSON2SheetOpts {
@@ -89,13 +88,13 @@ export interface SheetAddJSONOpts extends JSON2SheetOpts {
 /**
  * Create a worksheet from an array of objects (xlsx compatible)
  * @example
- * const ws = json_to_sheet([{name: "Alice", age: 30}, {name: "Bob", age: 25}])
+ * const ws = jsonToSheet([{name: "Alice", age: 30}, {name: "Bob", age: 25}])
  */
-export declare function json_to_sheet(data: JSONRow[], opts?: JSON2SheetOpts): Worksheet;
+export declare function jsonToSheet(data: JSONRow[], opts?: JSON2SheetOpts): Worksheet;
 /**
  * Add data from an array of objects to an existing worksheet (xlsx compatible)
  */
-export declare function sheet_add_json(worksheet: Worksheet, data: JSONRow[], opts?: SheetAddJSONOpts): Worksheet;
+export declare function sheetAddJson(worksheet: Worksheet, data: JSONRow[], opts?: SheetAddJSONOpts): Worksheet;
 export interface Sheet2JSONOpts {
     /**
      * Control output format:
@@ -112,7 +111,7 @@ export interface Sheet2JSONOpts {
      * - undefined: Use worksheet range
      */
     range?: number | string;
-    /** Use raw values (true) or formatted strings (false). Default: true */
+    /** Use raw values (true, default) or formatted text strings with trim (false) */
     raw?: boolean;
     /** Default value for empty cells */
     defval?: CellValue;
@@ -123,18 +122,18 @@ export interface Sheet2JSONOpts {
  * Convert worksheet to JSON array (xlsx compatible)
  * @example
  * // Default: array of objects with first row as headers
- * const data = sheet_to_json(worksheet)
+ * const data = sheetToJson(worksheet)
  * // => [{name: "Alice", age: 30}, {name: "Bob", age: 25}]
  *
  * // Array of arrays
- * const aoa = sheet_to_json(worksheet, { header: 1 })
+ * const aoa = sheetToJson(worksheet, { header: 1 })
  * // => [["name", "age"], ["Alice", 30], ["Bob", 25]]
  *
  * // Column letters as keys
- * const cols = sheet_to_json(worksheet, { header: "A" })
+ * const cols = sheetToJson(worksheet, { header: "A" })
  * // => [{A: "name", B: "age"}, {A: "Alice", B: 30}]
  */
-export declare function sheet_to_json<T = JSONRow>(worksheet: Worksheet, opts?: Sheet2JSONOpts): T[];
+export declare function sheetToJson<T = JSONRow>(worksheet: Worksheet, opts?: Sheet2JSONOpts): T[];
 export interface Sheet2CSVOpts {
     /** Field separator (default: ",") */
     FS?: string;
@@ -148,19 +147,19 @@ export interface Sheet2CSVOpts {
 /**
  * Convert worksheet to CSV string
  */
-export declare function sheet_to_csv(worksheet: Worksheet, opts?: Sheet2CSVOpts): string;
+export declare function sheetToCsv(worksheet: Worksheet, opts?: Sheet2CSVOpts): string;
 /**
  * Create a new workbook
  */
-export declare function book_new(): Workbook;
+export declare function bookNew(): Workbook;
 /**
  * Append worksheet to workbook (xlsx compatible)
  * @example
- * const wb = book_new();
- * const ws = json_to_sheet([{a: 1, b: 2}]);
- * book_append_sheet(wb, ws, "Sheet1");
+ * const wb = bookNew();
+ * const ws = jsonToSheet([{a: 1, b: 2}]);
+ * bookAppendSheet(wb, ws, "Sheet1");
  */
-export declare function book_append_sheet(workbook: Workbook, worksheet: Worksheet, name?: string): void;
+export declare function bookAppendSheet(workbook: Workbook, worksheet: Worksheet, name?: string): void;
 export interface AOA2SheetOpts {
     /** Use specified cell as starting point */
     origin?: Origin;
@@ -172,33 +171,33 @@ export interface AOA2SheetOpts {
 /**
  * Create a worksheet from an array of arrays (xlsx compatible)
  * @example
- * const ws = aoa_to_sheet([["Name", "Age"], ["Alice", 30], ["Bob", 25]])
+ * const ws = aoaToSheet([["Name", "Age"], ["Alice", 30], ["Bob", 25]])
  */
-export declare function aoa_to_sheet(data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
+export declare function aoaToSheet(data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
 /**
  * Add data from an array of arrays to an existing worksheet (xlsx compatible)
  */
-export declare function sheet_add_aoa(worksheet: Worksheet, data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
+export declare function sheetAddAoa(worksheet: Worksheet, data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
 /**
  * Convert worksheet to array of arrays
  */
-export declare function sheet_to_aoa(worksheet: Worksheet): CellValue[][];
+export declare function sheetToAoa(worksheet: Worksheet): CellValue[][];
 export declare const utils: {
-    decode_col: typeof decode_col;
-    encode_col: typeof encode_col;
-    decode_row: typeof decode_row;
-    encode_row: typeof encode_row;
-    decode_cell: typeof decode_cell;
-    encode_cell: typeof encode_cell;
-    decode_range: typeof decode_range;
-    encode_range: typeof encode_range;
-    json_to_sheet: typeof json_to_sheet;
-    sheet_add_json: typeof sheet_add_json;
-    sheet_to_json: typeof sheet_to_json;
-    sheet_to_csv: typeof sheet_to_csv;
-    aoa_to_sheet: typeof aoa_to_sheet;
-    sheet_add_aoa: typeof sheet_add_aoa;
-    sheet_to_aoa: typeof sheet_to_aoa;
-    book_new: typeof book_new;
-    book_append_sheet: typeof book_append_sheet;
+    decodeCol: typeof decodeCol;
+    encodeCol: typeof encodeCol;
+    decodeRow: typeof decodeRow;
+    encodeRow: typeof encodeRow;
+    decodeCell: typeof decodeCell;
+    encodeCell: typeof encodeCell;
+    decodeRange: typeof decodeRange;
+    encodeRange: typeof encodeRange;
+    jsonToSheet: typeof jsonToSheet;
+    sheetAddJson: typeof sheetAddJson;
+    sheetToJson: typeof sheetToJson;
+    sheetToCsv: typeof sheetToCsv;
+    aoaToSheet: typeof aoaToSheet;
+    sheetAddAoa: typeof sheetAddAoa;
+    sheetToAoa: typeof sheetToAoa;
+    bookNew: typeof bookNew;
+    bookAppendSheet: typeof bookAppendSheet;
 };

package/dist/types/utils/utils.d.ts

@@ -1,6 +1,5 @@
 export declare function delay(ms: number): Promise<void>;
 export declare function nop(): void;
-export declare function promiseImmediate<T>(value: T): Promise<T>;
 export declare const inherits: <T extends new (...args: any[]) => any, S extends new (...args: any[]) => any>(cls: T, superCtor: S, statics?: any, prototype?: any) => void;
 interface PathInfo {
     path: string;
@@ -23,7 +22,6 @@ export declare function objectFromProps<T = any>(props: string[], value?: T | nu
 /** @deprecated Import functions directly instead of using the utils object */
 export declare const utils: {
     nop: typeof nop;
-    promiseImmediate: typeof promiseImmediate;
     inherits: <T extends new (...args: any[]) => any, S extends new (...args: any[]) => any>(cls: T, superCtor: S, statics?: any, prototype?: any) => void;
     dateToExcel: typeof dateToExcel;
     excelToDate: typeof excelToDate;
@@ -42,4 +40,9 @@ export declare const utils: {
     toSortedArray: typeof toSortedArray;
     objectFromProps: typeof objectFromProps;
 };
+/**
+ * Convert a Buffer or ArrayBuffer to a UTF-8 string
+ * Works in both Node.js and browser environments
+ */
+export declare function bufferToString(chunk: Buffer | ArrayBuffer | string): string;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "1.1.0",
+  "version": "1.4.0",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "private": false,
   "publishConfig": {
@@ -33,8 +33,8 @@
   "browserslist": [
     "chrome >= 85",
     "edge >= 85",
-    "firefox >= 79",
-    "safari >= 14",
+    "firefox >= 113",
+    "safari >= 16.4",
     "opera >= 71"
   ],
   "exports": {
@@ -101,7 +101,6 @@
     "dayjs": "^1.11.19",
     "fast-csv": "^5.0.5",
     "fflate": "^0.8.2",
-    "node-stdlib-browser": "^1.3.1",
     "saxes": "^6.0.0",
     "uuid": "^13.0.0"
   },
@@ -111,7 +110,7 @@
     "@types/node": "^24.10.1",
     "@typescript-eslint/eslint-plugin": "^8.48.1",
     "@typescript-eslint/parser": "^8.48.1",
-    "@typescript/native-preview": "^7.0.0-dev.20251203.1",
+    "@typescript/native-preview": "^7.0.0-dev.20251208.1",
     "@vitest/browser": "^4.0.15",
     "@vitest/browser-playwright": "^4.0.15",
     "@vitest/ui": "^4.0.15",
@@ -126,6 +125,7 @@
     "express": "^5.2.1",
     "fast-xml-parser": "^5.3.2",
     "husky": "^9.1.7",
+    "node-stdlib-browser": "^1.3.1",
     "nodemon": "^3.1.11",
     "oxlint": "^1.31.0",
     "playwright": "^1.57.0",

package/dist/cjs/utils/browser-buffer-decode.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bufferToString = bufferToString;
-const textDecoder = typeof TextDecoder === "undefined" ? null : new TextDecoder("utf-8");
-function bufferToString(chunk) {
-    if (typeof chunk === "string") {
-        return chunk;
-    }
-    if (textDecoder) {
-        return textDecoder.decode(chunk);
-    }
-    return String.fromCharCode(...new Uint8Array(chunk));
-}

package/dist/cjs/utils/browser-buffer-encode.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringToBuffer = stringToBuffer;
-const textEncoder = typeof TextEncoder === "undefined" ? null : new TextEncoder();
-function stringToBuffer(str) {
-    if (typeof str !== "string") {
-        return str;
-    }
-    if (textEncoder) {
-        return Buffer.from(textEncoder.encode(str).buffer);
-    }
-    return Buffer.from(str);
-}

package/dist/cjs/utils/browser.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBrowser = void 0;
-exports.isBrowser = typeof window !== "undefined" &&
-    typeof document !== "undefined" &&
-    typeof navigator !== "undefined";

package/dist/esm/utils/browser-buffer-decode.js

@@ -1,11 +0,0 @@
-const textDecoder = typeof TextDecoder === "undefined" ? null : new TextDecoder("utf-8");
-function bufferToString(chunk) {
-    if (typeof chunk === "string") {
-        return chunk;
-    }
-    if (textDecoder) {
-        return textDecoder.decode(chunk);
-    }
-    return String.fromCharCode(...new Uint8Array(chunk));
-}
-export { bufferToString };

package/dist/esm/utils/browser-buffer-encode.js

@@ -1,11 +0,0 @@
-const textEncoder = typeof TextEncoder === "undefined" ? null : new TextEncoder();
-function stringToBuffer(str) {
-    if (typeof str !== "string") {
-        return str;
-    }
-    if (textEncoder) {
-        return Buffer.from(textEncoder.encode(str).buffer);
-    }
-    return Buffer.from(str);
-}
-export { stringToBuffer };

package/dist/esm/utils/browser.js

@@ -1,3 +0,0 @@
-export const isBrowser = typeof window !== "undefined" &&
-    typeof document !== "undefined" &&
-    typeof navigator !== "undefined";

package/dist/types/utils/browser-buffer-decode.d.ts

@@ -1,2 +0,0 @@
-declare function bufferToString(chunk: Buffer<ArrayBuffer> | string): string;
-export { bufferToString };

package/dist/types/utils/browser-buffer-encode.d.ts

@@ -1,2 +0,0 @@
-declare function stringToBuffer(str: string | Buffer<ArrayBuffer>): Buffer<ArrayBuffer>;
-export { stringToBuffer };

package/dist/types/utils/browser.d.ts

@@ -1 +0,0 @@
-export declare const isBrowser: boolean;