@cj-tech-master/excelts 3.0.0 → 3.0.1-canary.20251230172852.9dca08f

package/dist/browser/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
- * @cj-tech-master/excelts v3.0.0
+ * @cj-tech-master/excelts v3.0.1-canary.20251230172852.9dca08f
  * 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() {
@@ -3002,7 +3023,7 @@ var ExcelTS = (function(exports) {
 		validate(worksheet, model, source);
 		const { rows, values } = model;
 		const columns = model.columns ?? [];
-		const cacheFields = makeCacheFields(source, [...rows, ...columns]);
+		const cacheFields = makeCacheFields(source, [...rows, ...columns], values);
 		const nameToIndex = cacheFields.reduce((result, cacheField, index) => {
 			result[cacheField.name] = index;
 			return result;
@@ -3037,9 +3058,10 @@ var ExcelTS = (function(exports) {
 		if (model.values.length < 1) throw new Error("Must have at least one value.");
 		if (model.values.length > 1 && columns.length > 0) throw new Error("It is currently not possible to have multiple values when columns are specified. Please either supply an empty array for columns or a single value.");
 	}
-	function makeCacheFields(source, fieldNamesWithSharedItems) {
+	function makeCacheFields(source, fieldNamesWithSharedItems, valueFieldNames) {
 		const names = source.getRow(1).values;
 		const sharedItemsFields = new Set(fieldNamesWithSharedItems);
+		const valueFields = new Set(valueFieldNames);
 		const aggregate = (columnIndex) => {
 			const columnValues = source.getColumn(columnIndex).values;
 			const uniqueValues = /* @__PURE__ */ new Set();
@@ -3074,7 +3096,7 @@ var ExcelTS = (function(exports) {
 				name,
 				sharedItems: aggregate(columnIndex)
 			});
-			else {
+			else if (valueFields.has(name)) {
 				const minMax = getMinMax(columnIndex);
 				result.push({
 					name,
@@ -3082,7 +3104,10 @@ var ExcelTS = (function(exports) {
 					minValue: minMax?.minValue,
 					maxValue: minMax?.maxValue
 				});
-			}
+			} else result.push({
+				name,
+				sharedItems: null
+			});
 		}
 		return result;
 	}
@@ -14683,9 +14708,25 @@ var ExcelTS = (function(exports) {
 		}
 		render() {
 			const escapedName = xmlEncode(this.name);
-			if (this.sharedItems === null) return `<cacheField name="${escapedName}" numFmtId="0">
-      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1" containsInteger="1"${this.minValue !== void 0 && this.maxValue !== void 0 ? ` minValue="${this.minValue}" maxValue="${this.maxValue}"` : ""} />
+			if (this.sharedItems === null) {
+				if (this.minValue === void 0 || this.maxValue === void 0) return `<cacheField name="${escapedName}" numFmtId="0">
+      <sharedItems />
+    </cacheField>`;
+				return `<cacheField name="${escapedName}" numFmtId="0">
+      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1" containsInteger="1" minValue="${this.minValue}" maxValue="${this.maxValue}" />
     </cacheField>`;
+			}
+			const allNumeric = this.sharedItems.length > 0 && this.sharedItems.every((item) => typeof item === "number" && Number.isFinite(item));
+			const allInteger = allNumeric && this.sharedItems.every((item) => Number.isInteger(item));
+			if (allNumeric) {
+				const minValue = Math.min(...this.sharedItems);
+				const maxValue = Math.max(...this.sharedItems);
+				return `<cacheField name="${escapedName}" numFmtId="0">
+      <sharedItems containsSemiMixedTypes="0" containsString="0" containsNumber="1"${allInteger ? " containsInteger=\"1\"" : ""} minValue="${minValue}" maxValue="${maxValue}" count="${this.sharedItems.length}">
+        ${this.sharedItems.map((item) => `<n v="${item}" />`).join("")}
+      </sharedItems>
+    </cacheField>`;
+			}
 			return `<cacheField name="${escapedName}" numFmtId="0">
       <sharedItems count="${this.sharedItems.length}">
         ${this.sharedItems.map((item) => `<s v="${xmlEncode(String(item))}" />`).join("")}
@@ -14739,16 +14780,13 @@ var ExcelTS = (function(exports) {
 					break;
 				case "sharedItems":
 					this.inSharedItems = true;
-					if (attributes.containsNumber === "1" || attributes.containsInteger === "1") {
-						if (this.model) {
-							this.model.containsNumber = attributes.containsNumber === "1";
-							this.model.containsInteger = attributes.containsInteger === "1";
-							if (attributes.minValue !== void 0) this.model.minValue = parseFloat(attributes.minValue);
-							if (attributes.maxValue !== void 0) this.model.maxValue = parseFloat(attributes.maxValue);
-							this.model.sharedItems = null;
-						}
-					} else if (this.model) {
+					if (this.model) {
+						this.model.containsNumber = attributes.containsNumber === "1";
+						this.model.containsInteger = attributes.containsInteger === "1";
+						if (attributes.minValue !== void 0) this.model.minValue = parseFloat(attributes.minValue);
+						if (attributes.maxValue !== void 0) this.model.maxValue = parseFloat(attributes.maxValue);
 						if (parseInt(attributes.count || "0", 10) > 0) this.model.sharedItems = [];
+						else this.model.sharedItems = null;
 					}
 					break;
 				case "s":
@@ -15412,13 +15450,14 @@ var ExcelTS = (function(exports) {
 		const colSet = new Set(pivotTable.columns);
 		const valueSet = new Set(pivotTable.values);
 		return pivotTable.cacheFields.map((cacheField, fieldIndex) => {
-			return renderPivotField(rowSet.has(fieldIndex) ? "row" : colSet.has(fieldIndex) ? "column" : valueSet.has(fieldIndex) ? "value" : null, cacheField.sharedItems);
+			return renderPivotField(rowSet.has(fieldIndex), colSet.has(fieldIndex), valueSet.has(fieldIndex), cacheField.sharedItems);
 		}).join("");
 	}
-	function renderPivotField(fieldType, sharedItems) {
-		if (fieldType === "row" || fieldType === "column") {
-			const axis = fieldType === "row" ? "axisRow" : "axisCol";
-			const axisAttributes = "compact=\"0\" outline=\"0\" showAll=\"0\"";
+	function renderPivotField(isRow, isCol, isValue, sharedItems) {
+		if (isRow || isCol) {
+			const axis = isRow ? "axisRow" : "axisCol";
+			let axisAttributes = "compact=\"0\" outline=\"0\" showAll=\"0\"";
+			if (isValue) axisAttributes = `dataField="1" ${axisAttributes}`;
 			const itemsXml = [...sharedItems.map((_item, index) => `<item x="${index}" />`), "<item t=\"default\" />"].join("\n              ");
 			return `
       <pivotField axis="${axis}" ${axisAttributes}>
@@ -15430,7 +15469,7 @@ var ExcelTS = (function(exports) {
 		}
 		return `
     <pivotField
-      ${fieldType === "value" ? "dataField=\"1\"" : ""}
+      ${isValue ? "dataField=\"1\"" : ""}
       compact="0" outline="0" showAll="0" defaultSubtotal="0"
     />
   `;