@cj-tech-master/excelts 3.0.1 → 3.1.0

package/dist/cjs/csv/csv-core.js

@@ -15,6 +15,7 @@ exports.isSyncValidate = isSyncValidate;
 exports.parseCsv = parseCsv;
 exports.formatCsv = formatCsv;
 exports.parseCsvStream = parseCsvStream;
+const csv_number_1 = require("./csv-number");
 // =============================================================================
 // Helper Functions
 // =============================================================================
@@ -376,7 +377,7 @@ function parseCsv(input, options = {}) {
  * Format data as a CSV string
  */
 function formatCsv(data, options = {}) {
-    const { delimiter = ",", quote: quoteOption = '"', escape: escapeOption, rowDelimiter = "\n", alwaysQuote = false, quoteColumns = false, quoteHeaders = false, headers, writeHeaders: writeHeadersOption, writeBOM = false, includeEndRowDelimiter = false, alwaysWriteHeaders = false, transform } = options;
+    const { delimiter = ",", quote: quoteOption = '"', escape: escapeOption, rowDelimiter = "\n", alwaysQuote = false, quoteColumns = false, quoteHeaders = false, headers, writeHeaders: writeHeadersOption, writeBOM = false, includeEndRowDelimiter = false, alwaysWriteHeaders = false, transform, decimalSeparator = "." } = options;
     // Determine if headers should be written (default: true when headers is provided)
     const shouldWriteHeaders = writeHeadersOption ?? true;
     // If quote is false or null, disable quoting entirely
@@ -403,7 +404,9 @@ function formatCsv(data, options = {}) {
         if (value === null || value === undefined) {
             return "";
         }
-        const str = String(value);
+        const str = typeof value === "number"
+            ? (0, csv_number_1.formatNumberForCsv)(value, decimalSeparator)
+            : String(value);
         // If quoting is disabled, return raw string
         if (!quoteEnabled) {
             return str;

package/dist/cjs/csv/csv-number.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatNumberForCsv = formatNumberForCsv;
+exports.parseNumberFromCsv = parseNumberFromCsv;
+function formatNumberForCsv(value, decimalSeparator) {
+    if (decimalSeparator !== ",") {
+        return String(value);
+    }
+    // Keep JS numeric string form but replace the decimal point.
+    // Use split/join for broad runtime compatibility.
+    return String(value).split(".").join(",");
+}
+function parseNumberFromCsv(value, decimalSeparator) {
+    if (decimalSeparator !== ",") {
+        return Number(value);
+    }
+    const trimmed = value.trim();
+    // Minimal locale support: treat a single comma as the decimal separator.
+    // Common EU CSV uses delimiter ';' and decimal ',' (e.g. 12,34).
+    if (/^-?\d+(,\d+)?([eE][+-]?\d+)?$/.test(trimmed)) {
+        return Number(trimmed.replace(",", "."));
+    }
+    return Number(value);
+}

package/dist/cjs/csv/csv-stream.js

@@ -12,6 +12,7 @@ exports.createCsvParserStream = createCsvParserStream;
 exports.createCsvFormatterStream = createCsvFormatterStream;
 const stream_1 = require("stream");
 const csv_core_1 = require("./csv-core");
+const csv_number_1 = require("./csv-number");
 /**
  * Transform stream that parses CSV data row by row
  *
@@ -441,6 +442,7 @@ class CsvFormatterStream extends stream_1.Transform {
         this.delimiter = options.delimiter ?? ",";
         this.rowDelimiter = options.rowDelimiter ?? "\n";
         this.alwaysQuote = options.alwaysQuote ?? false;
+        this.decimalSeparator = options.decimalSeparator ?? ".";
         // writeHeaders defaults to true when headers is provided
         this.shouldWriteHeaders = options.writeHeaders ?? true;
         if (Array.isArray(options.headers)) {
@@ -593,7 +595,7 @@ class CsvFormatterStream extends stream_1.Transform {
         if (value === null || value === undefined) {
             return "";
         }
-        const str = String(value);
+        const str = typeof value === "number" ? (0, csv_number_1.formatNumberForCsv)(value, this.decimalSeparator) : String(value);
         if (!this.quoteEnabled) {
             return str;
         }

package/dist/cjs/csv/csv.base.js

@@ -13,6 +13,7 @@ exports.parseCsvToWorksheet = parseCsvToWorksheet;
 exports.formatWorksheetToCsv = formatWorksheetToCsv;
 const datetime_1 = require("../utils/datetime");
 const csv_core_1 = require("./csv-core");
+const csv_number_1 = require("./csv-number");
 // Special Excel values mapping
 const SpecialValues = {
     true: true,
@@ -28,14 +29,15 @@ const SpecialValues = {
 /**
  * Create the default value mapper for CSV parsing
  */
-function createDefaultValueMapper(dateFormats) {
+function createDefaultValueMapper(dateFormats, parserOptions) {
     const dateParser = datetime_1.DateParser.create(dateFormats);
+    const decimalSeparator = parserOptions?.decimalSeparator ?? ".";
     return function mapValue(datum) {
         if (datum === "") {
             return null;
         }
         // Try to parse as number
-        const datumNumber = Number(datum);
+        const datumNumber = typeof datum === "string" ? (0, csv_number_1.parseNumberFromCsv)(datum, decimalSeparator) : Number(datum);
         if (!Number.isNaN(datumNumber) && datumNumber !== Infinity) {
             return datumNumber;
         }
@@ -95,12 +97,14 @@ function parseCsvToWorksheet(content, workbook, options = {}) {
         "YYYY-MM-DD[T]HH:mm:ss",
         "YYYY-MM-DD"
     ];
-    const map = options.map || createDefaultValueMapper(dateFormats);
+    // If using the default mapper, pass parserOptions for locale-aware number parsing.
+    // (Custom map overrides this behavior.)
+    const effectiveMap = options.map || createDefaultValueMapper(dateFormats, options.parserOptions);
     // Parse CSV
     const rows = (0, csv_core_1.parseCsv)(content, options.parserOptions);
     // Add rows to worksheet
     for (const row of rows) {
-        worksheet.addRow(row.map(map));
+        worksheet.addRow(row.map(effectiveMap));
     }
     return worksheet;
 }

package/dist/cjs/csv/csv.js

@@ -89,7 +89,7 @@ class CSV {
         const worksheet = this.workbook.addWorksheet(options?.sheetName);
         const dateFormats = options?.dateFormats ??
             ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || (0, csv_base_1.createDefaultValueMapper)(dateFormats);
+        const map = options?.map || (0, csv_base_1.createDefaultValueMapper)(dateFormats, options?.parserOptions);
         const parser = new csv_stream_1.CsvParserStream(options?.parserOptions);
         return new Promise((resolve, reject) => {
             stream.pipe(parser);
@@ -235,7 +235,7 @@ class CSV {
         const worksheet = this.workbook.addWorksheet(options?.sheetName);
         const dateFormats = options?.dateFormats ??
             ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || (0, csv_base_1.createDefaultValueMapper)(dateFormats);
+        const map = options?.map || (0, csv_base_1.createDefaultValueMapper)(dateFormats, options?.parserOptions);
         const parser = new csv_stream_1.CsvParserStream(options?.parserOptions);
         parser.on("data", (row) => {
             worksheet.addRow(row.map(map));

package/dist/cjs/doc/row.js

@@ -221,6 +221,29 @@ class Row {
             });
         }
     }
+    /**
+     * Get row values as a 0-based sparse array (column 1 => index 0).
+     *
+     * This is useful when you want to compare/stringify values without the
+     * leading separator produced by the 1-based sparse array returned by `values`.
+     */
+    getValues() {
+        const values = [];
+        this._cells.forEach(cell => {
+            if (cell && cell.type !== enums_1.Enums.ValueType.Null) {
+                values[cell.col - 1] = cell.value;
+            }
+        });
+        return values;
+    }
+    /**
+     * Convenience stringification for row values.
+     *
+     * Equivalent to `row.getValues().join(separator)`.
+     */
+    valuesToString(separator = ",") {
+        return this.getValues().join(separator);
+    }
     /**
      * Returns true if the row includes at least one cell with a value
      */

package/dist/esm/csv/csv-core.js

@@ -8,6 +8,7 @@
  *
  * @see https://tools.ietf.org/html/rfc4180
  */
+import { formatNumberForCsv } from "./csv-number.js";
 // =============================================================================
 // Helper Functions
 // =============================================================================
@@ -369,7 +370,7 @@ export function parseCsv(input, options = {}) {
  * Format data as a CSV string
  */
 export function formatCsv(data, options = {}) {
-    const { delimiter = ",", quote: quoteOption = '"', escape: escapeOption, rowDelimiter = "\n", alwaysQuote = false, quoteColumns = false, quoteHeaders = false, headers, writeHeaders: writeHeadersOption, writeBOM = false, includeEndRowDelimiter = false, alwaysWriteHeaders = false, transform } = options;
+    const { delimiter = ",", quote: quoteOption = '"', escape: escapeOption, rowDelimiter = "\n", alwaysQuote = false, quoteColumns = false, quoteHeaders = false, headers, writeHeaders: writeHeadersOption, writeBOM = false, includeEndRowDelimiter = false, alwaysWriteHeaders = false, transform, decimalSeparator = "." } = options;
     // Determine if headers should be written (default: true when headers is provided)
     const shouldWriteHeaders = writeHeadersOption ?? true;
     // If quote is false or null, disable quoting entirely
@@ -396,7 +397,9 @@ export function formatCsv(data, options = {}) {
         if (value === null || value === undefined) {
             return "";
         }
-        const str = String(value);
+        const str = typeof value === "number"
+            ? formatNumberForCsv(value, decimalSeparator)
+            : String(value);
         // If quoting is disabled, return raw string
         if (!quoteEnabled) {
             return str;

package/dist/esm/csv/csv-number.js

@@ -0,0 +1,20 @@
+export function formatNumberForCsv(value, decimalSeparator) {
+    if (decimalSeparator !== ",") {
+        return String(value);
+    }
+    // Keep JS numeric string form but replace the decimal point.
+    // Use split/join for broad runtime compatibility.
+    return String(value).split(".").join(",");
+}
+export function parseNumberFromCsv(value, decimalSeparator) {
+    if (decimalSeparator !== ",") {
+        return Number(value);
+    }
+    const trimmed = value.trim();
+    // Minimal locale support: treat a single comma as the decimal separator.
+    // Common EU CSV uses delimiter ';' and decimal ',' (e.g. 12,34).
+    if (/^-?\d+(,\d+)?([eE][+-]?\d+)?$/.test(trimmed)) {
+        return Number(trimmed.replace(",", "."));
+    }
+    return Number(value);
+}

package/dist/esm/csv/csv-stream.js

@@ -6,6 +6,7 @@
  */
 import { Transform } from "stream";
 import { isSyncTransform, isSyncValidate } from "./csv-core.js";
+import { formatNumberForCsv } from "./csv-number.js";
 /**
  * Transform stream that parses CSV data row by row
  *
@@ -434,6 +435,7 @@ export class CsvFormatterStream extends Transform {
         this.delimiter = options.delimiter ?? ",";
         this.rowDelimiter = options.rowDelimiter ?? "\n";
         this.alwaysQuote = options.alwaysQuote ?? false;
+        this.decimalSeparator = options.decimalSeparator ?? ".";
         // writeHeaders defaults to true when headers is provided
         this.shouldWriteHeaders = options.writeHeaders ?? true;
         if (Array.isArray(options.headers)) {
@@ -586,7 +588,7 @@ export class CsvFormatterStream extends Transform {
         if (value === null || value === undefined) {
             return "";
         }
-        const str = String(value);
+        const str = typeof value === "number" ? formatNumberForCsv(value, this.decimalSeparator) : String(value);
         if (!this.quoteEnabled) {
             return str;
         }

package/dist/esm/csv/csv.base.js

@@ -6,6 +6,7 @@
  */
 import { DateParser, DateFormatter } from "../utils/datetime.js";
 import { parseCsv, formatCsv } from "./csv-core.js";
+import { parseNumberFromCsv } from "./csv-number.js";
 // Special Excel values mapping
 const SpecialValues = {
     true: true,
@@ -21,14 +22,15 @@ const SpecialValues = {
 /**
  * Create the default value mapper for CSV parsing
  */
-export function createDefaultValueMapper(dateFormats) {
+export function createDefaultValueMapper(dateFormats, parserOptions) {
     const dateParser = DateParser.create(dateFormats);
+    const decimalSeparator = parserOptions?.decimalSeparator ?? ".";
     return function mapValue(datum) {
         if (datum === "") {
             return null;
         }
         // Try to parse as number
-        const datumNumber = Number(datum);
+        const datumNumber = typeof datum === "string" ? parseNumberFromCsv(datum, decimalSeparator) : Number(datum);
         if (!Number.isNaN(datumNumber) && datumNumber !== Infinity) {
             return datumNumber;
         }
@@ -88,12 +90,14 @@ export function parseCsvToWorksheet(content, workbook, options = {}) {
         "YYYY-MM-DD[T]HH:mm:ss",
         "YYYY-MM-DD"
     ];
-    const map = options.map || createDefaultValueMapper(dateFormats);
+    // If using the default mapper, pass parserOptions for locale-aware number parsing.
+    // (Custom map overrides this behavior.)
+    const effectiveMap = options.map || createDefaultValueMapper(dateFormats, options.parserOptions);
     // Parse CSV
     const rows = parseCsv(content, options.parserOptions);
     // Add rows to worksheet
     for (const row of rows) {
-        worksheet.addRow(row.map(map));
+        worksheet.addRow(row.map(effectiveMap));
     }
     return worksheet;
 }

package/dist/esm/csv/csv.js

@@ -51,7 +51,7 @@ class CSV {
         const worksheet = this.workbook.addWorksheet(options?.sheetName);
         const dateFormats = options?.dateFormats ??
             ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || createDefaultValueMapper(dateFormats);
+        const map = options?.map || createDefaultValueMapper(dateFormats, options?.parserOptions);
         const parser = new CsvParserStream(options?.parserOptions);
         return new Promise((resolve, reject) => {
             stream.pipe(parser);
@@ -197,7 +197,7 @@ class CSV {
         const worksheet = this.workbook.addWorksheet(options?.sheetName);
         const dateFormats = options?.dateFormats ??
             ["YYYY-MM-DD[T]HH:mm:ssZ", "YYYY-MM-DD[T]HH:mm:ss", "MM-DD-YYYY", "YYYY-MM-DD"];
-        const map = options?.map || createDefaultValueMapper(dateFormats);
+        const map = options?.map || createDefaultValueMapper(dateFormats, options?.parserOptions);
         const parser = new CsvParserStream(options?.parserOptions);
         parser.on("data", (row) => {
             worksheet.addRow(row.map(map));

package/dist/esm/doc/row.js

@@ -218,6 +218,29 @@ class Row {
             });
         }
     }
+    /**
+     * Get row values as a 0-based sparse array (column 1 => index 0).
+     *
+     * This is useful when you want to compare/stringify values without the
+     * leading separator produced by the 1-based sparse array returned by `values`.
+     */
+    getValues() {
+        const values = [];
+        this._cells.forEach(cell => {
+            if (cell && cell.type !== Enums.ValueType.Null) {
+                values[cell.col - 1] = cell.value;
+            }
+        });
+        return values;
+    }
+    /**
+     * Convenience stringification for row values.
+     *
+     * Equivalent to `row.getValues().join(separator)`.
+     */
+    valuesToString(separator = ",") {
+        return this.getValues().join(separator);
+    }
     /**
      * Returns true if the row includes at least one cell with a value
      */

package/dist/types/csv/csv-core.d.ts

@@ -58,6 +58,13 @@ export interface CsvParseOptions {
     renameHeaders?: boolean;
     /** Comment character - lines starting with this are ignored */
     comment?: string;
+    /**
+     * Decimal separator used when parsing numbers from CSV (default: ".").
+     *
+     * Note: core CSV parsing returns strings; this option is intended for higher-level
+     * consumers (e.g. the default value mapper in csv.base) that convert strings to numbers.
+     */
+    decimalSeparator?: "." | ",";
     /** Maximum number of data rows to parse (excluding header) */
     maxRows?: number;
     /** Number of lines to skip at the beginning (before header detection) */
@@ -129,6 +136,11 @@ export interface CsvFormatOptions {
     escape?: string | false | null;
     /** Row delimiter (default: "\n") */
     rowDelimiter?: string;
+    /**
+     * Decimal separator used when formatting numbers to CSV (default: ".").
+     * For European-style CSV, this is commonly "," (often together with delimiter ";").
+     */
+    decimalSeparator?: "." | ",";
     /** Always quote all fields (default: false, only quote when necessary) */
     alwaysQuote?: boolean;
     /** Quote specific columns by name or index */

package/dist/types/csv/csv-number.d.ts

@@ -0,0 +1,3 @@
+export type DecimalSeparator = "." | ",";
+export declare function formatNumberForCsv(value: number, decimalSeparator: DecimalSeparator): string;
+export declare function parseNumberFromCsv(value: string, decimalSeparator: DecimalSeparator): number;

package/dist/types/csv/csv-stream.d.ts

@@ -83,6 +83,7 @@ export declare class CsvFormatterStream extends Transform {
     private rowDelimiter;
     private quoteEnabled;
     private alwaysQuote;
+    private decimalSeparator;
     private headerWritten;
     private headers;
     private shouldWriteHeaders;

package/dist/types/csv/csv.base.d.ts

@@ -45,7 +45,7 @@ export interface CsvWriteOptions {
 /**
  * Create the default value mapper for CSV parsing
  */
-export declare function createDefaultValueMapper(dateFormats: readonly DateFormat[]): (datum: any) => any;
+export declare function createDefaultValueMapper(dateFormats: readonly DateFormat[], parserOptions?: Pick<CsvParseOptions, "decimalSeparator">): (datum: any) => any;
 /**
  * Create the default value mapper for CSV writing
  */

package/dist/types/doc/row.d.ts

@@ -74,6 +74,19 @@ declare class Row {
      * Set the values by contiguous or sparse array, or by key'd object literal
      */
     set values(value: RowValues);
+    /**
+     * Get row values as a 0-based sparse array (column 1 => index 0).
+     *
+     * This is useful when you want to compare/stringify values without the
+     * leading separator produced by the 1-based sparse array returned by `values`.
+     */
+    getValues(): CellValue[];
+    /**
+     * Convenience stringification for row values.
+     *
+     * Equivalent to `row.getValues().join(separator)`.
+     */
+    valuesToString(separator?: string): string;
     /**
      * Returns true if the row includes at least one cell with a value
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "publishConfig": {