@cj-tech-master/excelts 3.0.1 → 3.1.0

package/dist/browser/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
- * @cj-tech-master/excelts v3.0.1
+ * @cj-tech-master/excelts v3.1.0
  * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
  * (c) 2025 cjnoname
  * Released under the MIT License
@@ -1675,6 +1675,27 @@ var ExcelTS = (function(exports) {
 			});
 		}
 		/**
+		* 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
 		*/
 		get hasValues() {
@@ -17094,9 +17115,32 @@ var ExcelTS = (function(exports) {
 		}
 	};
 
+//#endregion
+//#region src/csv/csv-number.ts
+	function formatNumberForCsv(value, decimalSeparator) {
+		if (decimalSeparator !== ",") return String(value);
+		return String(value).split(".").join(",");
+	}
+	function parseNumberFromCsv(value, decimalSeparator) {
+		if (decimalSeparator !== ",") return Number(value);
+		const trimmed = value.trim();
+		if (/^-?\d+(,\d+)?([eE][+-]?\d+)?$/.test(trimmed)) return Number(trimmed.replace(",", "."));
+		return Number(value);
+	}
+
 //#endregion
 //#region src/csv/csv-core.ts
 /**
+	* CSV Parser and Formatter - RFC 4180 compliant
+	*
+	* A lightweight, cross-platform CSV implementation that works in both
+	* Node.js and Browser environments with zero dependencies.
+	*
+	* High-performance RFC 4180 compliant CSV parser and formatter.
+	*
+	* @see https://tools.ietf.org/html/rfc4180
+	*/
+	/**
 	* Escape special regex characters
 	*/
 	function escapeRegex(str) {
@@ -17329,7 +17373,7 @@ var ExcelTS = (function(exports) {
 	* 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;
 		const shouldWriteHeaders = writeHeadersOption ?? true;
 		const quoteEnabled = quoteOption !== false && quoteOption !== null;
 		const quote = quoteEnabled ? String(quoteOption) : "";
@@ -17344,7 +17388,7 @@ var ExcelTS = (function(exports) {
 		};
 		const formatField = (value, index, header, isHeader = false) => {
 			if (value === null || value === void 0) return "";
-			const str = String(value);
+			const str = typeof value === "number" ? formatNumberForCsv(value, decimalSeparator) : String(value);
 			if (!quoteEnabled) return str;
 			const forceQuote = alwaysQuote || shouldQuoteColumn(index, header, isHeader);
 			const quoteRegex = /* @__PURE__ */ new RegExp(`[${escapeRegex(delimiter)}${escapeRegex(quote)}\r\n]`);
@@ -17412,11 +17456,12 @@ var ExcelTS = (function(exports) {
 	/**
 	* Create the default value mapper for CSV parsing
 	*/
-	function createDefaultValueMapper(dateFormats) {
+	function createDefaultValueMapper(dateFormats, parserOptions) {
 		const dateParser = DateParser.create(dateFormats);
+		const decimalSeparator = parserOptions?.decimalSeparator ?? ".";
 		return function mapValue(datum) {
 			if (datum === "") return null;
-			const datumNumber = Number(datum);
+			const datumNumber = typeof datum === "string" ? parseNumberFromCsv(datum, decimalSeparator) : Number(datum);
 			if (!Number.isNaN(datumNumber) && datumNumber !== Infinity) return datumNumber;
 			const date = dateParser.parse(datum);
 			if (date) return date;
@@ -17451,9 +17496,9 @@ var ExcelTS = (function(exports) {
 			"YYYY-MM-DD[T]HH:mm:ss",
 			"YYYY-MM-DD"
 		];
-		const map = options.map || createDefaultValueMapper(dateFormats);
+		const effectiveMap = options.map || createDefaultValueMapper(dateFormats, options.parserOptions);
 		const rows = parseCsv(content, options.parserOptions);
-		for (const row of rows) worksheet.addRow(row.map(map));
+		for (const row of rows) worksheet.addRow(row.map(effectiveMap));
 		return worksheet;
 	}
 	/**