@justybase/spreadsheet-tasks 3.0.0 → 3.1.0

package/dist/cjs/index.js

@@ -57,6 +57,7 @@ __export(index_exports, {
   convertXlsbToXlsx: () => convertXlsbToXlsx,
   convertXlsxToXlsb: () => convertXlsxToXlsb,
   defaultColWidth: () => defaultColWidth,
+  escapeXlsxText: () => escapeXlsxText,
   escapeXmlText: () => escapeXmlText,
   getFormat: () => getFormat,
   initColWidths: () => initColWidths,
@@ -67,6 +68,7 @@ __export(index_exports, {
   sanitizeSheetName: () => sanitizeSheetName,
   trimTrailingEmptyRows: () => trimTrailingEmptyRows,
   unescapeXml: () => unescapeXml,
+  unescapeXmlText: () => unescapeXmlText,
   unwrapCell: () => unwrapCell,
   updateColWidthsFromRows: () => updateColWidthsFromRows
 });
@@ -322,6 +324,16 @@ function defaultColWidth(width, floor = false) {
   }
   return 10;
 }
+function cellRefAttr(col, prevCol, colRef, rowNum) {
+  return col === prevCol + 1 ? "" : ` r="${colRef}${rowNum}"`;
+}
+var DEFAULT_COMPRESSION_LEVEL = 6;
+function assertCompressionLevel(level) {
+  if (!Number.isInteger(level) || level < 0 || level > 9) {
+    throw new RangeError(`compressionLevel must be an integer from 0 to 9, got ${level}`);
+  }
+  return level;
+}
 
 // src/ExcelReaderAbstract.ts
 var ExcelReaderAbstract = class {
@@ -619,10 +631,10 @@ function stripInvalidControlChars(str) {
   return out;
 }
 function escapeXmlText(str) {
-  if (!/&|<|>|"|'/.test(str) && !hasInvalidControlChars(str)) {
+  if (!/[&<>"'\r]/.test(str) && !hasInvalidControlChars(str)) {
     return str;
   }
-  let out = str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+  let out = str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;").replace(/\r/g, "&#13;");
   if (hasInvalidControlChars(out)) {
     out = stripInvalidControlChars(out);
   }
@@ -659,6 +671,14 @@ function unescapeXml(str) {
     }
   });
 }
+function escapeXlsxText(str) {
+  return escapeXmlText(str.replace(/_x([0-9A-Fa-f]{4})_/g, "_x005F_x$1_"));
+}
+function unescapeXmlText(str) {
+  if (!str) return str;
+  const text = unescapeXml(str.indexOf("\r") === -1 ? str : str.replace(/\r\n?/g, "\n"));
+  return text.indexOf("_x") === -1 ? text : text.replace(/_x([0-9A-Fa-f]{4})_/g, (_match, hex) => String.fromCharCode(parseInt(hex, 16)));
+}
 function parseTagAttributes(tag) {
   const attrs = {};
   const re = /([A-Za-z_][\w.:-]*)\s*=\s*("([^"]*)"|'([^']*)')/g;
@@ -725,7 +745,7 @@ function parseSharedStringsXml(xml) {
     while ((textMatch = textRegex.exec(content)) !== null) {
       value += textMatch[1];
     }
-    result.push(unescapeXml(value));
+    result.push(unescapeXmlText(value));
   }
   return result;
 }
@@ -1410,7 +1430,7 @@ var XlsxReader = class extends ExcelReaderAbstract {
       }
       let finalVal = null;
       if (inlineVals !== null) {
-        finalVal = unescapeXml(inlineVals.join(""));
+        finalVal = unescapeXmlText(inlineVals.join(""));
       } else if (val !== null) {
         if (type === "s") {
           const idx = parseInt(val, 10);
@@ -1418,13 +1438,13 @@ var XlsxReader = class extends ExcelReaderAbstract {
         } else if (type === "b") {
           finalVal = val === "1" || val === "true";
         } else if (type === "inlineStr") {
-          finalVal = unescapeXml(val);
+          finalVal = unescapeXmlText(val);
         } else if (type === "str") {
-          finalVal = unescapeXml(val);
+          finalVal = unescapeXmlText(val);
         } else if (type === "e") {
           finalVal = unescapeXml(val);
         } else if (type === "d") {
-          finalVal = parseIsoDateUtc(val) ?? unescapeXml(val);
+          finalVal = parseIsoDateUtc(val) ?? unescapeXmlText(val);
         } else if (type === "n" || type === "") {
           finalVal = parseFloat(val);
           if (styleIndex > 0 && this.xfIdToNumFmtId) {
@@ -1531,7 +1551,11 @@ var XlsbWriter = class _XlsbWriter {
   /**
    * @param filePath Destination `.xlsb` path on disk.
    */
-  constructor(filePath) {
+  /**
+   * @param filePath Destination `.xlsb` path on disk.
+   * @param options.compressionLevel Deflate level 0-9 (default 6).
+   */
+  constructor(filePath, options = {}) {
     this._outputError = null;
     this._finalized = false;
     this.sheetCount = 0;
@@ -1544,6 +1568,7 @@ var XlsbWriter = class _XlsbWriter {
     this._nextXfIdx = 4;
     this._stFmtRecords = /* @__PURE__ */ new Map();
     this.stream = new StreamingSheetState();
+    const compressionLevel = assertCompressionLevel(options.compressionLevel ?? DEFAULT_COMPRESSION_LEVEL);
     this._targetPath = path2.resolve(filePath);
     fs.mkdirSync(path2.dirname(this._targetPath), { recursive: true });
     this._tempPath = path2.join(
@@ -1554,7 +1579,7 @@ var XlsbWriter = class _XlsbWriter {
     this.output.on("error", (err) => {
       this._outputError = err;
     });
-    this.archive = (0, import_archiver.default)("zip");
+    this.archive = (0, import_archiver.default)("zip", { zlib: { level: compressionLevel } });
     this.archive.on("error", (err) => {
       this._outputError = err;
     });
@@ -4004,7 +4029,11 @@ var XlsxWriter = class {
   /**
    * @param filePath Destination `.xlsx` path on disk.
    */
-  constructor(filePath) {
+  /**
+   * @param filePath Destination `.xlsx` path on disk.
+   * @param options.compressionLevel Deflate level 0-9 (default 6).
+   */
+  constructor(filePath, options = {}) {
     this._outputError = null;
     this._finalized = false;
     this.sheetCount = 0;
@@ -4020,6 +4049,7 @@ var XlsxWriter = class {
     this._nextXfIndex = 4;
     this.stream = new StreamingSheetState();
     this.currentColLetters = [];
+    const compressionLevel = assertCompressionLevel(options.compressionLevel ?? DEFAULT_COMPRESSION_LEVEL);
     this._targetPath = path3.resolve(filePath);
     fs2.mkdirSync(path3.dirname(this._targetPath), { recursive: true });
     this._tempPath = path3.join(
@@ -4030,7 +4060,7 @@ var XlsxWriter = class {
     this.output.on("error", (err) => {
       this._outputError = err;
     });
-    this.archive = (0, import_archiver2.default)("zip");
+    this.archive = (0, import_archiver2.default)("zip", { zlib: { level: compressionLevel } });
     this.archive.on("error", (err) => {
       this._outputError = err;
     });
@@ -4075,7 +4105,7 @@ var XlsxWriter = class {
   _needsEscape(str) {
     for (let i = 0; i < str.length; i++) {
       const c = str.charCodeAt(i);
-      if (c === 38 || c === 60 || c === 62 || c === 34 || c === 39 || c >= 0 && c <= 8 || c === 11 || c === 12 || c >= 14 && c <= 31) {
+      if (c === 38 || c === 60 || c === 62 || c === 34 || c === 39 || c === 13 || c >= 0 && c <= 8 || c === 11 || c === 12 || c >= 14 && c <= 31) {
         return true;
       }
     }
@@ -4083,8 +4113,9 @@ var XlsxWriter = class {
   }
   _escape(str) {
     if (typeof str !== "string") return str;
+    str = str.replace(/_x([0-9A-Fa-f]{4})_/g, "_x005F_x$1_");
     if (!this._needsEscape(str)) return str;
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, "");
+    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;").replace(/\r/g, "&#13;").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, "");
   }
   /**
    * Start streaming a sheet. Call `writeRow` for each row, then `endSheet`.
@@ -4137,7 +4168,7 @@ var XlsxWriter = class {
       this.stream.rowNum++;
       bigBuf.writeString(`<row r="${this.stream.rowNum}">`);
       for (let c = 0; c < headers.length; c++) {
-        this._writeStringCell(bigBuf, headers[c], colLetters[c], this.stream.rowNum, 3);
+        this._writeStringCell(bigBuf, headers[c], "", 3);
       }
       bigBuf.writeString("</row>");
     }
@@ -4153,6 +4184,7 @@ var XlsxWriter = class {
     this.stream.rowNum++;
     assertRowCount(this.stream.rowNum);
     bigBuf.writeString(`<row r="${this.stream.rowNum}">`);
+    let prevCol = -1;
     for (let c = 0; c < row.length; c++) {
       const raw = row[c];
       if (raw === null || raw === void 0) continue;
@@ -4160,27 +4192,28 @@ var XlsxWriter = class {
       const val = fmtString !== null ? unwrapCell(raw) : raw;
       const xfIdx = fmtString !== null ? this._registerFormat(fmtString) : -1;
       const styleAttr = xfIdx >= 0 ? ` s="${xfIdx}"` : "";
-      const colRef = this.currentColLetters[c];
+      const ref = cellRefAttr(c, prevCol, this.currentColLetters[c], this.stream.rowNum);
+      prevCol = c;
       if (typeof val === "number") {
         if (Number.isFinite(val)) {
-          bigBuf.writeString(`<c r="${colRef}${this.stream.rowNum}"${styleAttr}><v>${val}</v></c>`);
+          bigBuf.writeString(`<c${ref}${styleAttr}><v>${val}</v></c>`);
         } else {
-          this._writeStringCell(bigBuf, val.toString(), colRef, this.stream.rowNum, xfIdx >= 0 ? xfIdx : void 0);
+          this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
         }
       } else if (typeof val === "bigint") {
-        this._writeStringCell(bigBuf, val.toString(), colRef, this.stream.rowNum, xfIdx >= 0 ? xfIdx : void 0);
+        this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
       } else if (typeof val === "boolean") {
-        bigBuf.writeString(`<c r="${colRef}${this.stream.rowNum}" t="b"${styleAttr}><v>${val ? 1 : 0}</v></c>`);
+        bigBuf.writeString(`<c${ref} t="b"${styleAttr}><v>${val ? 1 : 0}</v></c>`);
       } else if (val instanceof Date) {
         const oaDate = this._toOADate(val);
         if (Number.isFinite(oaDate)) {
           const finalStyle = xfIdx >= 0 ? xfIdx : 1;
-          bigBuf.writeString(`<c r="${colRef}${this.stream.rowNum}" s="${finalStyle}"><v>${oaDate}</v></c>`);
+          bigBuf.writeString(`<c${ref} s="${finalStyle}"><v>${oaDate}</v></c>`);
         } else {
-          this._writeStringCell(bigBuf, val.toString(), colRef, this.stream.rowNum, xfIdx >= 0 ? xfIdx : void 0);
+          this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
         }
       } else if (val !== null && val !== void 0) {
-        this._writeStringCell(bigBuf, val.toString(), colRef, this.stream.rowNum, xfIdx >= 0 ? xfIdx : void 0);
+        this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
       }
     }
     bigBuf.writeString("</row>");
@@ -4266,7 +4299,7 @@ var XlsxWriter = class {
       rowNum++;
       bigBuf.writeString(`<row r="${rowNum}">`);
       for (let c = 0; c < headers.length; c++) {
-        this._writeStringCell(bigBuf, headers[c], colLetters[c], rowNum, 3);
+        this._writeStringCell(bigBuf, headers[c], "", 3);
       }
       bigBuf.writeString("</row>");
     }
@@ -4274,6 +4307,7 @@ var XlsxWriter = class {
       rowNum++;
       bigBuf.writeString(`<row r="${rowNum}">`);
       const row = rows[r];
+      let prevCol = -1;
       for (let c = 0; c < row.length; c++) {
         const raw = row[c];
         if (raw === null || raw === void 0) continue;
@@ -4281,27 +4315,28 @@ var XlsxWriter = class {
         const val = fmtString !== null ? unwrapCell(raw) : raw;
         const xfIdx = fmtString !== null ? this._registerFormat(fmtString) : -1;
         const styleAttr = xfIdx >= 0 ? ` s="${xfIdx}"` : "";
-        const colRef = colLetters[c];
+        const ref = cellRefAttr(c, prevCol, colLetters[c], rowNum);
+        prevCol = c;
         if (typeof val === "number") {
           if (Number.isFinite(val)) {
-            bigBuf.writeString(`<c r="${colRef}${rowNum}"${styleAttr}><v>${val}</v></c>`);
+            bigBuf.writeString(`<c${ref}${styleAttr}><v>${val}</v></c>`);
           } else {
-            this._writeStringCell(bigBuf, val.toString(), colRef, rowNum, xfIdx >= 0 ? xfIdx : void 0);
+            this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
           }
         } else if (typeof val === "bigint") {
-          this._writeStringCell(bigBuf, val.toString(), colRef, rowNum, xfIdx >= 0 ? xfIdx : void 0);
+          this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
         } else if (typeof val === "boolean") {
-          bigBuf.writeString(`<c r="${colRef}${rowNum}" t="b"${styleAttr}><v>${val ? 1 : 0}</v></c>`);
+          bigBuf.writeString(`<c${ref} t="b"${styleAttr}><v>${val ? 1 : 0}</v></c>`);
         } else if (val instanceof Date) {
           const oaDate = this._toOADate(val);
           if (Number.isFinite(oaDate)) {
             const finalStyle = xfIdx >= 0 ? xfIdx : 1;
-            bigBuf.writeString(`<c r="${colRef}${rowNum}" s="${finalStyle}"><v>${oaDate}</v></c>`);
+            bigBuf.writeString(`<c${ref} s="${finalStyle}"><v>${oaDate}</v></c>`);
           } else {
-            this._writeStringCell(bigBuf, val.toString(), colRef, rowNum, xfIdx >= 0 ? xfIdx : void 0);
+            this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
           }
         } else if (val !== null && val !== void 0) {
-          this._writeStringCell(bigBuf, val.toString(), colRef, rowNum, xfIdx >= 0 ? xfIdx : void 0);
+          this._writeStringCell(bigBuf, val.toString(), ref, xfIdx >= 0 ? xfIdx : void 0);
         }
       }
       bigBuf.writeString("</row>");
@@ -4320,7 +4355,8 @@ var XlsxWriter = class {
       name: this.sheetList[this.sheetCount - 1].pathInArchive
     });
   }
-  _writeStringCell(bigBuf, val, colRef, rowNum, styleOverride) {
+  /** `ref` is the cell's `r` attribute from `cellRefAttr`, or '' when omitted. */
+  _writeStringCell(bigBuf, val, ref, styleOverride) {
     assertCellTextLength(val);
     let index = this.sstMap.get(val);
     if (index === void 0) {
@@ -4330,7 +4366,7 @@ var XlsxWriter = class {
     }
     this.sstCntAll++;
     const styleAttr = styleOverride !== void 0 ? ` s="${styleOverride}"` : "";
-    bigBuf.writeString(`<c r="${colRef}${rowNum}" t="s"${styleAttr}><v>${index}</v></c>`);
+    bigBuf.writeString(`<c${ref} t="s"${styleAttr}><v>${index}</v></c>`);
   }
   _registerFormat(fmtString) {
     if (this._formatXfMap.has(fmtString)) {
@@ -4738,7 +4774,7 @@ async function writeAdmZipStreaming(zip, stagedParts, destinationPath) {
       } catch {
       }
     });
-    archive = (0, import_archiver3.default)("zip");
+    archive = (0, import_archiver3.default)("zip", { zlib: { level: DEFAULT_COMPRESSION_LEVEL } });
     archive.on("error", (err) => {
       outputError = err;
     });
@@ -5247,7 +5283,7 @@ var XlsxUpdater = class _XlsxUpdater {
       throw new Error("XlsxUpdater: sharedStrings.xml has no closing sst element.");
     }
     const appended = this.sharedStringsPending.map((txt) => {
-      const clean = escapeXmlText(txt);
+      const clean = escapeXlsxText(txt);
       const preserve = clean.length > 0 && (clean[0] === " " || clean[clean.length - 1] === " " || /[\t\n\r]/.test(clean));
       const tAttr = preserve ? ' xml:space="preserve"' : "";
       return `<${prefix}si><${prefix}t${tAttr}>${clean}</${prefix}t></${prefix}si>`;
@@ -5270,14 +5306,25 @@ var XlsxUpdater = class _XlsxUpdater {
     const sdEnd = sheetXml.indexOf("</sheetData>", sdStart);
     if (sdEnd === -1) return { dataStyles: /* @__PURE__ */ new Map(), headerStyles };
     const region = sheetXml.substring(sdStart, sdEnd);
-    const cellRe = /<c\b[^>]*>/g;
+    const cellRe = /<row\b[^>]*>|<c\b[^>]*>/g;
     let m;
+    let row = 0;
+    let nextCol = 0;
     while ((m = cellRe.exec(region)) !== null) {
       const tag = m[0];
+      if (tag.startsWith("<row")) {
+        const rowAttr = /\br="(\d+)"/.exec(tag);
+        row = rowAttr ? parseInt(rowAttr[1], 10) : row + 1;
+        nextCol = 0;
+        continue;
+      }
       const rMatch = /r="([A-Z]+)(\d+)"/.exec(tag);
-      if (!rMatch) continue;
-      const col = columnLetterToIndex(rMatch[1]);
-      const row = parseInt(rMatch[2], 10);
+      let col = nextCol;
+      if (rMatch) {
+        col = columnLetterToIndex(rMatch[1]);
+        row = parseInt(rMatch[2], 10);
+      }
+      nextCol = col + 1;
       const sMatch = /s="(\d+)"/.exec(tag);
       if (!sMatch) continue;
       const s = parseInt(sMatch[1], 10);
@@ -5398,7 +5445,7 @@ var XlsxUpdater = class _XlsxUpdater {
     const colRef = columnIndexToLetter(col);
     const styleAttr = style > 0 ? ` s="${style}"` : "";
     if (this.sharedStringsXml === null) {
-      const clean = escapeXmlText(text);
+      const clean = escapeXlsxText(text);
       const preserve = clean.length > 0 && (clean[0] === " " || clean[clean.length - 1] === " " || /[\t\n\r]/.test(clean));
       const tAttr = preserve ? ' xml:space="preserve"' : "";
       return `<c r="${colRef}${rowNum}" t="inlineStr"${styleAttr}><is><t${tAttr}>${clean}</t></is></c>`;
@@ -6938,6 +6985,7 @@ function convertXlsxToXlsb(inputPath, outputPath, options) {
   convertXlsbToXlsx,
   convertXlsxToXlsb,
   defaultColWidth,
+  escapeXlsxText,
   escapeXmlText,
   getFormat,
   initColWidths,
@@ -6948,6 +6996,7 @@ function convertXlsxToXlsb(inputPath, outputPath, options) {
   sanitizeSheetName,
   trimTrailingEmptyRows,
   unescapeXml,
+  unescapeXmlText,
   unwrapCell,
   updateColWidthsFromRows
 });