@cj-tech-master/excelts 8.1.2 → 9.0.0

package/README.md

@@ -100,14 +100,14 @@ wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
 
 // PDF — generate from data, no Workbook needed
 import { pdf } from "@cj-tech-master/excelts/pdf";
-const pdfBytes = pdf([
+const pdfBytes = await pdf([
   ["Product", "Revenue"],
   ["Widget", 1000]
 ]);
 
 // PDF — read text, images, and metadata from any PDF
 import { readPdf } from "@cj-tech-master/excelts/pdf";
-const result = readPdf(pdfBytes);
+const result = await readPdf(pdfBytes);
 console.log(result.text); // extracted text
 console.log(result.metadata); // title, author, etc.
 

package/README_zh.md

@@ -100,14 +100,14 @@ wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
 
 // PDF — 直接从数据生成，无需 Workbook
 import { pdf } from "@cj-tech-master/excelts/pdf";
-const pdfBytes = pdf([
+const pdfBytes = await pdf([
   ["产品", "收入"],
   ["小工具", 1000]
 ]);
 
 // PDF — 读取任意 PDF 的文本、图片和元数据
 import { readPdf } from "@cj-tech-master/excelts/pdf";
-const result = readPdf(pdfBytes);
+const result = await readPdf(pdfBytes);
 console.log(result.text); // 提取的文本
 console.log(result.metadata); // 标题、作者等
 

package/dist/browser/modules/excel/cell.js

@@ -3,6 +3,7 @@ import { Enums } from "./enums.js";
 import { Note } from "./note.js";
 import { escapeHtml } from "./utils/under-dash.js";
 import { slideFormula } from "./utils/shared-formula.js";
+import { copyStyle } from "./utils/copy-style.js";
 import { ExcelError, InvalidValueTypeError } from "./errors.js";
 // Returns true if the value is a non-empty object (has at least one own key),
 // or any truthy non-object value. Returns false for undefined, null, false, 0,
@@ -87,27 +88,27 @@ class Cell {
         const font = (rowStyle && hasOwnKeys(rowStyle.font) && rowStyle.font) ||
             (colStyle && hasOwnKeys(colStyle.font) && colStyle.font);
         if (font) {
-            style.font = font;
+            style.font = structuredClone(font);
         }
         const alignment = (rowStyle && hasOwnKeys(rowStyle.alignment) && rowStyle.alignment) ||
             (colStyle && hasOwnKeys(colStyle.alignment) && colStyle.alignment);
         if (alignment) {
-            style.alignment = alignment;
+            style.alignment = structuredClone(alignment);
         }
         const border = (rowStyle && hasOwnKeys(rowStyle.border) && rowStyle.border) ||
             (colStyle && hasOwnKeys(colStyle.border) && colStyle.border);
         if (border) {
-            style.border = border;
+            style.border = structuredClone(border);
         }
         const fill = (rowStyle && hasOwnKeys(rowStyle.fill) && rowStyle.fill) ||
             (colStyle && hasOwnKeys(colStyle.fill) && colStyle.fill);
         if (fill) {
-            style.fill = fill;
+            style.fill = structuredClone(fill);
         }
         const protection = (rowStyle && hasOwnKeys(rowStyle.protection) && rowStyle.protection) ||
             (colStyle && hasOwnKeys(colStyle.protection) && colStyle.protection);
         if (protection) {
-            style.protection = protection;
+            style.protection = structuredClone(protection);
         }
         return style;
     }
@@ -151,7 +152,10 @@ class Cell {
         this._value.release();
         this._value = Value.create(Cell.Types.Merge, this, master);
         if (!ignoreStyle) {
-            this.style = master.style;
+            // Deep-copy so each cell has an independent style object.
+            // Without this, all cells in the merge share the same reference,
+            // and setting a property (e.g. border) on any cell mutates all of them.
+            this.style = copyStyle(master.style) ?? {};
         }
     }
     unmerge() {
@@ -318,7 +322,7 @@ class Cell {
             }
         }
         if (value.style) {
-            this.style = value.style;
+            this.style = copyStyle(value.style) ?? {};
         }
         else {
             this.style = {};

package/dist/browser/modules/excel/column.js

@@ -1,5 +1,6 @@
 import { colCache } from "./utils/col-cache.js";
 import { isEqual } from "./utils/under-dash.js";
+import { copyStyle } from "./utils/copy-style.js";
 import { Enums } from "./enums.js";
 const DEFAULT_COLUMN_WIDTH = 9;
 /**
@@ -48,7 +49,7 @@ class Column {
             this.width = value.width !== undefined ? value.width : DEFAULT_COLUMN_WIDTH;
             this.outlineLevel = value.outlineLevel;
             if (value.style) {
-                this.style = value.style;
+                this.style = copyStyle(value.style) ?? {};
             }
             else {
                 this.style = {};
@@ -259,7 +260,7 @@ class Column {
     set font(value) {
         this.style.font = value;
         this.eachCell(cell => {
-            cell.font = value;
+            cell.font = value ? structuredClone(value) : value;
         });
     }
     get alignment() {
@@ -268,7 +269,7 @@ class Column {
     set alignment(value) {
         this.style.alignment = value;
         this.eachCell(cell => {
-            cell.alignment = value;
+            cell.alignment = value ? structuredClone(value) : value;
         });
     }
     get protection() {
@@ -277,7 +278,7 @@ class Column {
     set protection(value) {
         this.style.protection = value;
         this.eachCell(cell => {
-            cell.protection = value;
+            cell.protection = value ? structuredClone(value) : value;
         });
     }
     get border() {
@@ -286,7 +287,7 @@ class Column {
     set border(value) {
         this.style.border = value;
         this.eachCell(cell => {
-            cell.border = value;
+            cell.border = value ? structuredClone(value) : value;
         });
     }
     get fill() {
@@ -295,7 +296,7 @@ class Column {
     set fill(value) {
         this.style.fill = value;
         this.eachCell(cell => {
-            cell.fill = value;
+            cell.fill = value ? structuredClone(value) : value;
         });
     }
     // =============================================================================

package/dist/browser/modules/excel/row.js

@@ -297,7 +297,11 @@ class Row {
         this.style[name] = value;
         this._cells.forEach(cell => {
             if (cell) {
-                cell.style[name] = value;
+                // Clone object values so each cell gets an independent copy.
+                // Without this, mutating a sub-property (e.g. cell.border.top = ...)
+                // would leak to every other cell that received the same reference.
+                cell.style[name] =
+                    typeof value === "object" && value !== null ? structuredClone(value) : value;
             }
         });
     }

package/dist/browser/modules/excel/stream/worksheet-reader.js

@@ -7,6 +7,7 @@ import { EventEmitter } from "../../../utils/event-emitter.js";
 import { SaxParser } from "../../xml/sax.js";
 import { ExcelStreamStateError } from "../errors.js";
 import { isDateFmt, excelToDate, decodeOoxmlEscape } from "../../../utils/utils.browser.js";
+import { copyStyle } from "../utils/copy-style.js";
 import { colCache } from "../utils/col-cache.js";
 import { Dimensions } from "../range.js";
 import { Row } from "../row.js";
@@ -178,7 +179,7 @@ class WorksheetReader extends EventEmitter {
                                 const styleId = parseInt(node.attributes.s, 10);
                                 const style = styles.getStyleModel(styleId);
                                 if (style) {
-                                    row.style = style;
+                                    row.style = copyStyle(style) ?? {};
                                 }
                             }
                         }
@@ -279,7 +280,7 @@ class WorksheetReader extends EventEmitter {
                             if (c.s !== undefined) {
                                 const style = styles.getStyleModel(c.s);
                                 if (style) {
-                                    cell.style = style;
+                                    cell.style = copyStyle(style) ?? {};
                                 }
                             }
                             if (c.f) {

package/dist/browser/modules/excel/utils/cell-format.js

@@ -513,6 +513,35 @@ function formatNumberPattern(val, fmt) {
     const decimalPlaces = decFmt.replace(/[^0#?]/g, "").length;
     // Round the value
     const roundedVal = roundTo(scaledVal, decimalPlaces);
+    // When value is zero and the format has no required '0' digit placeholders,
+    // '?' placeholders become spaces and '#' placeholders produce nothing.
+    // This handles accounting format zero sections like "-"?? → "- " (dash + spaces).
+    if (roundedVal === 0 && !intFmt.includes("0") && !decFmt.includes("0")) {
+        let result = "";
+        for (const ch of intFmt) {
+            if (ch === "?") {
+                result += " ";
+            }
+            else if (ch !== "#" && ch !== ",") {
+                // Preserve literal characters (already unquoted at this point)
+                result += ch;
+            }
+        }
+        if (decimalPlaces > 0) {
+            // Only emit the decimal point if the decimal format has '?' or '0' placeholders.
+            // Pure '#' decimal digits produce nothing for zero values.
+            const hasDecContent = /[0?]/.test(decFmt);
+            if (hasDecContent) {
+                result += ".";
+                for (const ch of decFmt) {
+                    if (ch === "?") {
+                        result += " ";
+                    }
+                }
+            }
+        }
+        return sign + result;
+    }
     // Split into integer and decimal parts
     const [intPart, decPart = ""] = roundedVal.toString().split(".");
     // Check if format has literal characters mixed with digit placeholders (like "0-0", "000-0000")
@@ -552,16 +581,49 @@ function formatNumberPattern(val, fmt) {
         if (intFmt.includes(",")) {
             formattedInt = commaify(intPart);
         }
-        // Pad integer with leading zeros if needed
+        // Pad integer with leading zeros/spaces if needed
+        // '0' placeholder → pad with "0", '?' placeholder → pad with " "
         const minIntDigits = (intFmt.match(/0/g) ?? []).length;
+        const totalIntSlots = (intFmt.match(/[0?]/g) ?? []).length;
         if (formattedInt.length < minIntDigits) {
             formattedInt = "0".repeat(minIntDigits - formattedInt.length) + formattedInt;
         }
+        if (formattedInt.length < totalIntSlots) {
+            formattedInt = " ".repeat(totalIntSlots - formattedInt.length) + formattedInt;
+        }
+        // '#' integer placeholder: suppress "0" when there are no required '0' or '?' digits
+        // and the integer value is zero (e.g. "#" format with value 0 → empty)
+        if (formattedInt === "0" && minIntDigits === 0 && totalIntSlots === 0) {
+            formattedInt = "";
+        }
     }
     // Format decimal part
     let formattedDec = "";
     if (decimalPlaces > 0) {
-        formattedDec = "." + (decPart + "0".repeat(decimalPlaces)).substring(0, decimalPlaces);
+        const rawDec = (decPart + "0".repeat(decimalPlaces)).substring(0, decimalPlaces);
+        // Process each decimal digit position according to its placeholder:
+        // '0' → always show digit, '?' → show digit or space, '#' → show digit or nothing (trim trailing)
+        const decChars = rawDec.split("");
+        // Walk from the end: '#' trailing zeros are removed, '?' trailing zeros become spaces
+        for (let i = decFmt.length - 1; i >= 0; i--) {
+            if (i >= decChars.length) {
+                continue;
+            }
+            if (decFmt[i] === "#" && decChars[i] === "0") {
+                decChars[i] = "";
+            }
+            else if (decFmt[i] === "?" && decChars[i] === "0") {
+                decChars[i] = " ";
+            }
+            else {
+                break; // stop at first non-zero or '0' placeholder
+            }
+        }
+        const decStr = decChars.join("");
+        // Only emit decimal point if there is content after it
+        if (decStr.length > 0) {
+            formattedDec = "." + decStr;
+        }
     }
     return sign + formattedInt + formattedDec;
 }

package/dist/browser/modules/pdf/excel-bridge.d.ts

@@ -11,7 +11,7 @@
  *
  * const workbook = new Workbook();
  * // ... build workbook ...
- * const pdf = excelToPdf(workbook);
+ * const pdf = await excelToPdf(workbook);
  * ```
  */
 import type { Workbook } from "../excel/workbook.js";
@@ -21,9 +21,10 @@ import { type PdfExportOptions } from "./types.js";
  *
  * This is a convenience function that converts the Workbook to the PDF module's
  * data model and then generates the PDF.
+ * Yields to the event loop between each output page during layout and rendering.
  *
  * @param workbook - An Excel Workbook instance
  * @param options  - PDF export options
- * @returns PDF file as a Uint8Array
+ * @returns Promise of PDF file as a Uint8Array
  */
-export declare function excelToPdf(workbook: Workbook, options?: PdfExportOptions): Uint8Array;
+export declare function excelToPdf(workbook: Workbook, options?: PdfExportOptions): Promise<Uint8Array>;

package/dist/browser/modules/pdf/excel-bridge.js

@@ -11,7 +11,7 @@
  *
  * const workbook = new Workbook();
  * // ... build workbook ...
- * const pdf = excelToPdf(workbook);
+ * const pdf = await excelToPdf(workbook);
  * ```
  */
 import { ValueType } from "../excel/enums.js";
@@ -27,12 +27,13 @@ import { PdfCellType } from "./types.js";
  *
  * This is a convenience function that converts the Workbook to the PDF module's
  * data model and then generates the PDF.
+ * Yields to the event loop between each output page during layout and rendering.
  *
  * @param workbook - An Excel Workbook instance
  * @param options  - PDF export options
- * @returns PDF file as a Uint8Array
+ * @returns Promise of PDF file as a Uint8Array
  */
-export function excelToPdf(workbook, options) {
+export async function excelToPdf(workbook, options) {
     const pdfWorkbook = excelWorkbookToPdf(workbook);
     return exportPdf(pdfWorkbook, options);
 }
@@ -81,12 +82,24 @@ function convertSheet(ws, workbook) {
                 continue;
             }
             const cells = new Map();
-            row.eachCell({ includeEmpty: false }, cell => {
-                cells.set(cell.col, convertCell(cell));
+            row.eachCell({ includeEmpty: true }, cell => {
+                const hasValue = cell.type !== ValueType.Null && cell.type !== ValueType.Merge;
+                const hasStyle = cell.style &&
+                    ((cell.style.border &&
+                        (cell.style.border.top ||
+                            cell.style.border.right ||
+                            cell.style.border.bottom ||
+                            cell.style.border.left)) ||
+                        cell.style.fill ||
+                        cell.style.font);
+                if (hasValue || hasStyle) {
+                    cells.set(cell.col, convertCell(cell));
+                }
             });
             rows.set(r, {
                 hidden: row.hidden || undefined,
                 height: row.height ?? undefined,
+                customHeight: row.customHeight || undefined,
                 cells
             });
         }

package/dist/browser/modules/pdf/index.d.ts

@@ -7,7 +7,7 @@
  * ```typescript
  * import { pdf } from "excelts/pdf";
  *
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Product", "Revenue"],
  *   ["Widget", 1000],
  *   ["Gadget", 2500]
@@ -22,14 +22,14 @@
  * const workbook = new Workbook();
  * const sheet = workbook.addWorksheet("Sales");
  * sheet.addRow(["Product", "Revenue"]);
- * const bytes = excelToPdf(workbook);
+ * const bytes = await excelToPdf(workbook);
  * ```
  *
  * @example Read PDF — extract text, images, and metadata:
  * ```typescript
  * import { readPdf } from "excelts/pdf";
  *
- * const result = readPdf(pdfBytes);
+ * const result = await readPdf(pdfBytes);
  * console.log(result.text);               // All text
  * console.log(result.pages[0].text);      // Page 1 text
  * console.log(result.pages[0].images);    // Page 1 images

package/dist/browser/modules/pdf/index.js

@@ -7,7 +7,7 @@
  * ```typescript
  * import { pdf } from "excelts/pdf";
  *
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Product", "Revenue"],
  *   ["Widget", 1000],
  *   ["Gadget", 2500]
@@ -22,14 +22,14 @@
  * const workbook = new Workbook();
  * const sheet = workbook.addWorksheet("Sales");
  * sheet.addRow(["Product", "Revenue"]);
- * const bytes = excelToPdf(workbook);
+ * const bytes = await excelToPdf(workbook);
  * ```
  *
  * @example Read PDF — extract text, images, and metadata:
  * ```typescript
  * import { readPdf } from "excelts/pdf";
  *
- * const result = readPdf(pdfBytes);
+ * const result = await readPdf(pdfBytes);
  * console.log(result.text);               // All text
  * console.log(result.pages[0].text);      // Page 1 text
  * console.log(result.pages[0].images);    // Page 1 images

package/dist/browser/modules/pdf/pdf.d.ts

@@ -8,7 +8,7 @@
  * ```typescript
  * import { pdf } from "@cj-tech-master/excelts/pdf";
  *
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Product", "Revenue"],
  *   ["Widget", 1000],
  *   ["Gadget", 2500]
@@ -17,7 +17,7 @@
  *
  * @example With options:
  * ```typescript
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Name", "Score"],
  *   ["Alice", 95],
  *   ["Bob", 87]
@@ -26,7 +26,7 @@
  *
  * @example Multiple sheets:
  * ```typescript
- * const bytes = pdf({
+ * const bytes = await pdf({
  *   sheets: [
  *     { name: "Sales", data: [["Product", "Revenue"], ["Widget", 1000]] },
  *     { name: "Costs", data: [["Item", "Amount"], ["Rent", 500]] }
@@ -36,7 +36,7 @@
  *
  * @example With column widths and styles:
  * ```typescript
- * const bytes = pdf({
+ * const bytes = await pdf({
  *   name: "Report",
  *   columns: [{ width: 25 }, { width: 15 }],
  *   data: [
@@ -113,9 +113,10 @@ export type PdfInput = PdfRow[] | PdfSheet | PdfBook;
  * Generate a PDF.
  *
  * Accepts anything from a plain 2D array to a multi-sheet workbook.
+ * Yields to the event loop between each output page during layout and rendering.
  *
  * @param input   - 2D array, sheet object, or workbook object
  * @param options - PDF export options (page size, margins, etc.)
- * @returns PDF file as Uint8Array
+ * @returns Promise of PDF file as Uint8Array
  */
-export declare function pdf(input: PdfInput, options?: PdfExportOptions): Uint8Array;
+export declare function pdf(input: PdfInput, options?: PdfExportOptions): Promise<Uint8Array>;

package/dist/browser/modules/pdf/pdf.js

@@ -8,7 +8,7 @@
  * ```typescript
  * import { pdf } from "@cj-tech-master/excelts/pdf";
  *
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Product", "Revenue"],
  *   ["Widget", 1000],
  *   ["Gadget", 2500]
@@ -17,7 +17,7 @@
  *
  * @example With options:
  * ```typescript
- * const bytes = pdf([
+ * const bytes = await pdf([
  *   ["Name", "Score"],
  *   ["Alice", 95],
  *   ["Bob", 87]
@@ -26,7 +26,7 @@
  *
  * @example Multiple sheets:
  * ```typescript
- * const bytes = pdf({
+ * const bytes = await pdf({
  *   sheets: [
  *     { name: "Sales", data: [["Product", "Revenue"], ["Widget", 1000]] },
  *     { name: "Costs", data: [["Item", "Amount"], ["Rent", 500]] }
@@ -36,7 +36,7 @@
  *
  * @example With column widths and styles:
  * ```typescript
- * const bytes = pdf({
+ * const bytes = await pdf({
  *   name: "Report",
  *   columns: [{ width: 25 }, { width: 15 }],
  *   data: [
@@ -55,12 +55,13 @@ import { exportPdf } from "./render/pdf-exporter.js";
  * Generate a PDF.
  *
  * Accepts anything from a plain 2D array to a multi-sheet workbook.
+ * Yields to the event loop between each output page during layout and rendering.
  *
  * @param input   - 2D array, sheet object, or workbook object
  * @param options - PDF export options (page size, margins, etc.)
- * @returns PDF file as Uint8Array
+ * @returns Promise of PDF file as Uint8Array
  */
-export function pdf(input, options) {
+export async function pdf(input, options) {
     const workbook = normalizeInput(input);
     return exportPdf(workbook, options);
 }

package/dist/browser/modules/pdf/reader/pdf-reader.d.ts

@@ -16,18 +16,18 @@
  * - Cross-reference tables and streams (PDF 1.5+)
  * - Incremental updates and xref recovery
  *
- * @example Basic text extraction:
+ * @example Text extraction:
  * ```typescript
  * import { readPdf } from "excelts/pdf";
  *
- * const pdf = readPdf(pdfBytes);
+ * const pdf = await readPdf(pdfBytes);
  * console.log(pdf.text);           // All text from all pages
  * console.log(pdf.pages[0].text);  // Text from page 1
  * ```
  *
  * @example Image extraction:
  * ```typescript
- * const pdf = readPdf(pdfBytes);
+ * const pdf = await readPdf(pdfBytes);
  * for (const image of pdf.pages[0].images) {
  *   console.log(image.format, image.width, image.height);
  *   fs.writeFileSync(`image.${image.format}`, image.data);
@@ -36,7 +36,7 @@
  *
  * @example Metadata:
  * ```typescript
- * const pdf = readPdf(pdfBytes);
+ * const pdf = await readPdf(pdfBytes);
  * console.log(pdf.metadata.title);
  * console.log(pdf.metadata.author);
  * console.log(pdf.metadata.pageCount);
@@ -44,7 +44,7 @@
  *
  * @example Encrypted PDF:
  * ```typescript
- * const pdf = readPdf(pdfBytes, { password: "secret" });
+ * const pdf = await readPdf(pdfBytes, { password: "secret" });
  * ```
  */
 import type { TextLine } from "./text-reconstruction.js";
@@ -133,11 +133,12 @@ export interface ReadPdfResult {
 }
 /**
  * Read a PDF file and extract text, images, and metadata.
+ * Yields to the event loop between pages to avoid blocking.
  *
  * @param data - Raw PDF file bytes
  * @param options - Extraction options
- * @returns Extracted content
+ * @returns Promise of extracted content
  * @throws {PdfStructureError} If the PDF structure is invalid
  * @throws {PdfError} If decryption fails (wrong password)
  */
-export declare function readPdf(data: Uint8Array, options?: ReadPdfOptions): ReadPdfResult;
+export declare function readPdf(data: Uint8Array, options?: ReadPdfOptions): Promise<ReadPdfResult>;