@cj-tech-master/excelts 8.1.2 → 9.0.0

package/dist/esm/modules/pdf/render/pdf-exporter.js

@@ -18,25 +18,37 @@ import { decodePng } from "./png-decoder.js";
 import { PdfError, PdfRenderError } from "../errors.js";
 import { PageSizes } from "../types.js";
 import { argbToPdfColor } from "./style-converter.js";
+import { yieldToEventLoop } from "../../../utils/utils.base.js";
 // =============================================================================
 // Public API
 // =============================================================================
 /**
  * Export a PdfWorkbook to PDF format.
+ * Yields to the event loop between each output page during layout and rendering.
  *
  * @param workbook - The workbook data to export
  * @param options - Export options controlling layout, pagination, and appearance
- * @returns PDF file as a Uint8Array
+ * @returns Promise of PDF file as a Uint8Array
  * @throws {PdfError} If the workbook has no sheets or export fails
  */
-export function exportPdf(workbook, options) {
+export async function exportPdf(workbook, options) {
+    const ctx = prepareExport(workbook, options);
+    for (const sheet of ctx.sheets) {
+        await layoutSheetInto(ctx, sheet, options);
+    }
+    return finishExport(ctx, workbook, options);
+}
+/**
+ * Shared setup: validate sheets, create font manager and writer,
+ * register embedded font.
+ */
+function prepareExport(workbook, options) {
     const sheets = selectSheets(workbook, options?.sheets);
     if (sheets.length === 0) {
         throw new PdfError("No sheets to export. The workbook is empty or no sheets matched.");
     }
     const fontManager = new FontManager();
     const writer = new PdfWriter();
-    // --- Step 0: Register embedded font if provided ---
     if (options?.font) {
         try {
             const ttf = parseTtf(options.font);
@@ -46,21 +58,37 @@ export function exportPdf(workbook, options) {
             throw new PdfRenderError("Failed to parse TrueType font", { cause: err });
         }
     }
-    // --- Step 1: Layout all sheets ---
-    const allPages = [];
-    for (const sheet of sheets) {
-        try {
-            const resolved = resolveOptions(options, sheet);
-            const pages = layoutSheet(sheet, resolved, fontManager);
-            allPages.push(...pages);
-        }
-        catch (err) {
-            throw new PdfRenderError(`Failed to layout sheet "${sheet.name}"`, { cause: err });
-        }
+    return { sheets, fontManager, writer, allPages: [] };
+}
+/**
+ * Layout a single sheet and append its pages to the context.
+ */
+async function layoutSheetInto(ctx, sheet, options) {
+    try {
+        const resolved = resolveOptions(options, sheet);
+        const pages = await layoutSheet(sheet, resolved, ctx.fontManager);
+        ctx.allPages.push(...pages);
+    }
+    catch (err) {
+        throw new PdfRenderError(`Failed to layout sheet "${sheet.name}"`, { cause: err });
     }
+}
+/**
+ * After layout: fix page numbers, track fonts, write resources,
+ * render pages, and build the final PDF binary.
+ */
+async function finishExport(ctx, workbook, options) {
+    const { allPages, fontManager, writer, sheets } = ctx;
     const documentOptions = resolveOptions(options, sheets[0]);
+    ensureAtLeastOnePage(allPages, documentOptions, sheets);
+    fixPageNumbers(allPages);
+    trackFontsForHeaders(allPages, fontManager);
+    const fontObjectMap = fontManager.writeFontResources(writer);
+    const { pageObjNums, sheetFirstPage, pagesTreeObjNum } = await renderAllPages(allPages, fontManager, writer, fontObjectMap);
+    return buildFinalPdf(writer, pageObjNums, pagesTreeObjNum, sheetFirstPage, documentOptions, workbook, options);
+}
+function ensureAtLeastOnePage(allPages, documentOptions, sheets) {
     if (allPages.length === 0) {
-        // Create at least one empty page
         allPages.push({
             pageNumber: 1,
             options: documentOptions,
@@ -74,15 +102,17 @@ export function exportPdf(workbook, options) {
             sheetRows: [],
             rowYPositions: [],
             rowHeights: [],
-            images: []
+            images: [],
+            scaleFactor: 1
         });
     }
-    // Fix page numbers (they may be off after combining multiple sheets)
+}
+function fixPageNumbers(allPages) {
     for (let i = 0; i < allPages.length; i++) {
         allPages[i].pageNumber = i + 1;
     }
-    const totalPages = allPages.length;
-    // --- Step 1.5: Track page header/footer text for font subsetting ---
+}
+function trackFontsForHeaders(allPages, fontManager) {
     if (fontManager.hasEmbeddedFont()) {
         for (const page of allPages) {
             if (page.options.showSheetNames) {
@@ -102,99 +132,102 @@ export function exportPdf(workbook, options) {
             }
         }
     }
-    // --- Step 2: Write font resources (builds subset from tracked code points) ---
-    const fontObjectMap = fontManager.writeFontResources(writer);
-    // --- Step 3: Render pages and build PDF structure ---
+}
+async function renderAllPages(allPages, fontManager, writer, fontObjectMap) {
     const pageObjNums = [];
-    const pagesTreeObjNum = writer.allocObject(); // Allocate early for forward ref
-    // Track first page per sheet for outline/bookmarks
-    const sheetFirstPage = new Map(); // sheetName → pageObjNum index
-    for (const page of allPages) {
-        try {
-            // Render the page content (text, fills, borders)
-            const { stream: contentStream, alphaValues } = renderPage(page, page.options, fontManager, totalPages);
-            // Handle images: create XObject Image entries and draw them
-            const imageXObjects = new Map(); // name → objNum
-            if (page.images.length > 0) {
-                for (let imgIdx = 0; imgIdx < page.images.length; imgIdx++) {
-                    const img = page.images[imgIdx];
-                    const imgName = `Im${imgIdx + 1}`;
-                    const imgObjNum = writeImageXObject(writer, img.data, img.format);
-                    imageXObjects.set(imgName, imgObjNum);
-                    // Draw the image in the content stream
-                    contentStream.drawImage(imgName, img.rect.x, img.rect.y, img.rect.width, img.rect.height);
-                }
-            }
-            // Add content stream object
-            const contentObjNum = writer.allocObject();
-            const contentDict = new PdfDict();
-            writer.addStreamObject(contentObjNum, contentDict, contentStream);
-            // Add resources dictionary object
-            const resourcesObjNum = writer.allocObject();
-            const fontDictStr = fontManager.buildFontDictString(fontObjectMap);
-            const resourcesDict = new PdfDict().set("Font", fontDictStr);
-            // Add XObject resources for images
-            if (imageXObjects.size > 0) {
-                const xobjParts = ["<<"];
-                for (const [name, objNum] of imageXObjects) {
-                    xobjParts.push(`/${name} ${pdfRef(objNum)}`);
-                }
-                xobjParts.push(">>");
-                resourcesDict.set("XObject", xobjParts.join("\n"));
+    const pagesTreeObjNum = writer.allocObject();
+    const sheetFirstPage = new Map();
+    const totalPages = allPages.length;
+    for (let i = 0; i < allPages.length; i++) {
+        renderSinglePage(allPages[i], fontManager, writer, fontObjectMap, totalPages, pageObjNums, pagesTreeObjNum, sheetFirstPage);
+        if (i < allPages.length - 1) {
+            await yieldToEventLoop();
+        }
+    }
+    return { pageObjNums, sheetFirstPage, pagesTreeObjNum };
+}
+function renderSinglePage(page, fontManager, writer, fontObjectMap, totalPages, pageObjNums, pagesTreeObjNum, sheetFirstPage) {
+    try {
+        const { stream: contentStream, alphaValues } = renderPage(page, page.options, fontManager, totalPages);
+        // Handle images: create XObject Image entries and draw them
+        const imageXObjects = new Map();
+        if (page.images.length > 0) {
+            for (let imgIdx = 0; imgIdx < page.images.length; imgIdx++) {
+                const img = page.images[imgIdx];
+                const imgName = `Im${imgIdx + 1}`;
+                const imgObjNum = writeImageXObject(writer, img.data, img.format);
+                imageXObjects.set(imgName, imgObjNum);
+                contentStream.drawImage(imgName, img.rect.x, img.rect.y, img.rect.width, img.rect.height);
             }
-            // Add ExtGState resources for transparency
-            if (alphaValues.size > 0) {
-                const gsParts = ["<<"];
-                for (const alpha of alphaValues) {
-                    const gsObjNum = writer.allocObject();
-                    const gsDict = new PdfDict()
-                        .set("Type", "/ExtGState")
-                        .set("ca", pdfNumber(alpha))
-                        .set("CA", pdfNumber(alpha));
-                    writer.addObject(gsObjNum, gsDict);
-                    gsParts.push(`/${alphaGsName(alpha)} ${pdfRef(gsObjNum)}`);
-                }
-                gsParts.push(">>");
-                resourcesDict.set("ExtGState", gsParts.join("\n"));
+        }
+        // Add content stream object
+        const contentObjNum = writer.allocObject();
+        const contentDict = new PdfDict();
+        writer.addStreamObject(contentObjNum, contentDict, contentStream);
+        // Add resources dictionary object
+        const resourcesObjNum = writer.allocObject();
+        const fontDictStr = fontManager.buildFontDictString(fontObjectMap);
+        const resourcesDict = new PdfDict().set("Font", fontDictStr);
+        if (imageXObjects.size > 0) {
+            const xobjParts = ["<<"];
+            for (const [name, objNum] of imageXObjects) {
+                xobjParts.push(`/${name} ${pdfRef(objNum)}`);
             }
-            writer.addObject(resourcesObjNum, resourcesDict);
-            // Create link annotations for hyperlinks
-            const annotRefs = [];
-            for (const cell of page.cells) {
-                if (cell.hyperlink) {
-                    const annotObjNum = writer.allocObject();
-                    const rect = `[${pdfNumber(cell.rect.x)} ${pdfNumber(cell.rect.y)} ${pdfNumber(cell.rect.x + cell.rect.width)} ${pdfNumber(cell.rect.y + cell.rect.height)}]`;
-                    const annotDict = new PdfDict()
-                        .set("Type", "/Annot")
-                        .set("Subtype", "/Link")
-                        .set("Rect", rect)
-                        .set("Border", "[0 0 0]")
-                        .set("A", `<< /Type /Action /S /URI /URI (${cell.hyperlink.replace(/[()\\]/g, "\\$&")}) >>`);
-                    writer.addObject(annotObjNum, annotDict);
-                    annotRefs.push(annotObjNum);
-                }
+            xobjParts.push(">>");
+            resourcesDict.set("XObject", xobjParts.join("\n"));
+        }
+        if (alphaValues.size > 0) {
+            const gsParts = ["<<"];
+            for (const alpha of alphaValues) {
+                const gsObjNum = writer.allocObject();
+                const gsDict = new PdfDict()
+                    .set("Type", "/ExtGState")
+                    .set("ca", pdfNumber(alpha))
+                    .set("CA", pdfNumber(alpha));
+                writer.addObject(gsObjNum, gsDict);
+                gsParts.push(`/${alphaGsName(alpha)} ${pdfRef(gsObjNum)}`);
             }
-            // Add page object
-            const pageObjNum = writer.addPage({
-                parentRef: pagesTreeObjNum,
-                width: page.width,
-                height: page.height,
-                contentsRef: contentObjNum,
-                resourcesRef: resourcesObjNum,
-                annotRefs: annotRefs.length > 0 ? annotRefs : undefined
-            });
-            pageObjNums.push(pageObjNum);
-            // Track first page of each sheet
-            if (!sheetFirstPage.has(page.sheetName)) {
-                sheetFirstPage.set(page.sheetName, pageObjNums.length - 1);
+            gsParts.push(">>");
+            resourcesDict.set("ExtGState", gsParts.join("\n"));
+        }
+        writer.addObject(resourcesObjNum, resourcesDict);
+        // Create link annotations for hyperlinks
+        const annotRefs = [];
+        for (const cell of page.cells) {
+            if (cell.hyperlink) {
+                const annotObjNum = writer.allocObject();
+                const rect = `[${pdfNumber(cell.rect.x)} ${pdfNumber(cell.rect.y)} ${pdfNumber(cell.rect.x + cell.rect.width)} ${pdfNumber(cell.rect.y + cell.rect.height)}]`;
+                const annotDict = new PdfDict()
+                    .set("Type", "/Annot")
+                    .set("Subtype", "/Link")
+                    .set("Rect", rect)
+                    .set("Border", "[0 0 0]")
+                    .set("A", `<< /Type /Action /S /URI /URI (${cell.hyperlink.replace(/[()\\]/g, "\\$&")}) >>`);
+                writer.addObject(annotObjNum, annotDict);
+                annotRefs.push(annotObjNum);
             }
         }
-        catch (err) {
-            throw new PdfRenderError(`Failed to render page ${page.pageNumber} of "${page.sheetName}"`, {
-                cause: err
-            });
+        // Add page object
+        const pageObjNum = writer.addPage({
+            parentRef: pagesTreeObjNum,
+            width: page.width,
+            height: page.height,
+            contentsRef: contentObjNum,
+            resourcesRef: resourcesObjNum,
+            annotRefs: annotRefs.length > 0 ? annotRefs : undefined
+        });
+        pageObjNums.push(pageObjNum);
+        if (!sheetFirstPage.has(page.sheetName)) {
+            sheetFirstPage.set(page.sheetName, pageObjNums.length - 1);
         }
     }
+    catch (err) {
+        throw new PdfRenderError(`Failed to render page ${page.pageNumber} of "${page.sheetName}"`, {
+            cause: err
+        });
+    }
+}
+function buildFinalPdf(writer, pageObjNums, pagesTreeObjNum, sheetFirstPage, documentOptions, workbook, options) {
     // --- Step 4: Build page tree ---
     const pagesKids = "[" + pageObjNums.map(n => pdfRef(n)).join(" ") + "]";
     const pagesDict = new PdfDict()
@@ -286,7 +319,14 @@ function resolveOptions(options, sheet) {
         orientation,
         margins,
         fitToPage: options?.fitToPage !== undefined ? options.fitToPage : true,
-        scale: Math.max(0.1, Math.min(3.0, options?.scale ?? (ps?.scale ? ps.scale / 100 : 1.0))),
+        scale: Math.max(0.1, Math.min(3.0, options?.scale ??
+            // When fitToPage is active (default), ignore sheet's pageSetup.scale
+            // to avoid double-scaling. Only apply sheet scale when fitToPage is off.
+            ((options?.fitToPage !== undefined ? options.fitToPage : true)
+                ? 1.0
+                : ps?.scale
+                    ? ps.scale / 100
+                    : 1.0))),
         showGridLines: options?.showGridLines ?? ps?.showGridLines ?? false,
         gridLineColor,
         repeatRows,

package/dist/esm/modules/pdf/render/style-converter.js

@@ -79,18 +79,18 @@ export function excelColorToPdf(color) {
  * These are the default Office theme colors.
  */
 function themeColorToPdf(themeIndex) {
-    // Default Office theme color palette
+    // Default Office 2019+ theme color palette (hex values verified)
     const themeColors = [
-        { r: 1, g: 1, b: 1 }, // 0: lt1 (white / window background)
-        { r: 0, g: 0, b: 0 }, // 1: dk1 (black / window text)
-        { r: 0.918, g: 0.929, b: 0.941 }, // 2: lt2 (light gray)
-        { r: 0.267, g: 0.278, b: 0.298 }, // 3: dk2 (dark gray)
-        { r: 0.263, g: 0.522, b: 0.839 }, // 4: accent1 (blue)
-        { r: 0.922, g: 0.494, b: 0.196 }, // 5: accent2 (orange)
-        { r: 0.624, g: 0.624, b: 0.624 }, // 6: accent3 (gray)
-        { r: 1, g: 0.753, b: 0 }, // 7: accent4 (gold)
-        { r: 0.314, g: 0.686, b: 0.886 }, // 8: accent5 (light blue)
-        { r: 0.439, g: 0.678, b: 0.278 } // 9: accent6 (green)
+        { r: 1, g: 1, b: 1 }, // 0: lt1 — #FFFFFF (white / window background)
+        { r: 0, g: 0, b: 0 }, // 1: dk1 — #000000 (black / window text)
+        { r: 0.906, g: 0.902, b: 0.902 }, // 2: lt2 — #E7E6E6
+        { r: 0.267, g: 0.329, b: 0.416 }, // 3: dk2 — #44546A
+        { r: 0.267, g: 0.447, b: 0.769 }, // 4: accent1 — #4472C4 (blue)
+        { r: 0.929, g: 0.49, b: 0.192 }, // 5: accent2 — #ED7D31 (orange)
+        { r: 0.647, g: 0.647, b: 0.647 }, // 6: accent3 — #A5A5A5 (gray)
+        { r: 1, g: 0.753, b: 0 }, // 7: accent4 — #FFC000 (gold)
+        { r: 0.357, g: 0.608, b: 0.835 }, // 8: accent5 — #5B9BD5 (light blue)
+        { r: 0.439, g: 0.678, b: 0.278 } // 9: accent6 — #70AD47 (green)
     ];
     if (themeIndex >= 0 && themeIndex < themeColors.length) {
         return themeColors[themeIndex];
@@ -182,33 +182,33 @@ export function excelFillToPdfColor(fill) {
 function borderStyleToLineWidth(style) {
     switch (style) {
         case "thin":
-            return 0.5;
+            return 0.25;
         case "medium":
-            return 1;
+            return 0.5;
         case "thick":
-            return 1.5;
+            return 1;
         case "double":
-            return 0.5;
-        case "hair":
             return 0.25;
+        case "hair":
+            return 0.1;
         case "dotted":
-            return 0.5;
+            return 0.25;
         case "dashed":
-            return 0.5;
+            return 0.25;
         case "dashDot":
-            return 0.5;
+            return 0.25;
         case "dashDotDot":
-            return 0.5;
+            return 0.25;
         case "slantDashDot":
-            return 0.5;
+            return 0.25;
         case "mediumDashed":
-            return 1;
+            return 0.5;
         case "mediumDashDot":
-            return 1;
+            return 0.5;
         case "mediumDashDotDot":
-            return 1;
-        default:
             return 0.5;
+        default:
+            return 0.25;
     }
 }
 /**
@@ -246,7 +246,8 @@ function convertBorder(border) {
     return {
         width: borderStyleToLineWidth(border.style),
         color: excelColorToPdf(border.color) ?? DEFAULT_COLORS.black,
-        dashPattern: borderStyleToDashPattern(border.style)
+        dashPattern: borderStyleToDashPattern(border.style),
+        isDouble: border.style === "double"
     };
 }
 /**

package/dist/esm/utils/utils.base.js

@@ -335,3 +335,13 @@ export function stringToUtf16Le(str) {
     }
     return bytes;
 }
+// =============================================================================
+// Async utilities
+// =============================================================================
+/**
+ * Yield to the event loop via a macrotask.
+ * Uses `setTimeout(0)` which works in both Node.js and browsers.
+ */
+export function yieldToEventLoop() {
+    return new Promise(resolve => setTimeout(resolve, 0));
+}