@cj-tech-master/excelts 8.1.2 → 9.0.0

package/dist/types/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/types/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/types/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/types/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>;

package/dist/types/modules/pdf/render/constants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared rendering constants used by both the layout engine and page renderer.
+ *
+ * Keeping these in one place ensures row-height computation and text rendering
+ * use exactly the same values, preventing clipped or overlapping content.
+ */
+/** Horizontal cell padding in points (left + right = 2 × CELL_PADDING_H). */
+export declare const CELL_PADDING_H = 3;
+/** Vertical cell padding in points (top + bottom = 2 × CELL_PADDING_V). */
+export declare const CELL_PADDING_V = 2;
+/**
+ * Line-height multiplier applied to the font size.
+ *
+ * Excel's default row height for an 11pt font is 15pt, which after removing
+ * vertical padding (2 × 2 = 4pt) leaves 11pt × 1.0 — but Excel also adds
+ * internal leading. A factor of 1.2 matches standard PDF/typographic practice
+ * and keeps text readable without inflating row heights.
+ */
+export declare const LINE_HEIGHT_FACTOR = 1.2;
+/** Width of one indent level in points (~3 characters at 11pt). */
+export declare const INDENT_WIDTH = 10;
+/**
+ * Excel column widths are measured in characters of the default font's digit width.
+ * For Calibri 11pt (the default), maxDigitWidth ≈ 7 pixels at 96 DPI.
+ * Excel adds 5 pixels of padding per column (4px text margin + 1px gridline).
+ * To convert to PDF points: (charWidth × 7 + 5) × (72/96).
+ */
+export declare const MAX_DIGIT_WIDTH_PX = 7;
+export declare const EXCEL_COLUMN_PADDING_PX = 5;
+export declare const PX_TO_PT: number;

package/dist/types/modules/pdf/render/layout-engine.d.ts

@@ -20,6 +20,7 @@ import type { PdfSheetData, ResolvedPdfOptions, LayoutPage } from "../types.js";
 import type { FontManager } from "../font/font-manager.js";
 /**
  * Compute the layout for a sheet across one or more PDF pages.
+ * Yields to the event loop between each output page.
  */
-export declare function layoutSheet(sheet: PdfSheetData, options: ResolvedPdfOptions, fontManager: FontManager): LayoutPage[];
+export declare function layoutSheet(sheet: PdfSheetData, options: ResolvedPdfOptions, fontManager: FontManager): Promise<LayoutPage[]>;
 export declare function paginateRows(rowHeights: number[], availableHeight: number, repeatRowCount: number, rowBreaks: Set<number>): number[][];

package/dist/types/modules/pdf/render/page-renderer.d.ts

@@ -30,11 +30,11 @@ export declare function renderPage(page: LayoutPage, options: ResolvedPdfOptions
  * E.g. alpha=0.504 → "GS5040", alpha=0.506 → "GS5060"
  */
 export declare function alphaGsName(alpha: number): string;
-export declare function computeTextStartY(verticalAlign: "top" | "middle" | "bottom", rect: PdfRect, totalTextHeight: number, ascent: number): number;
+export declare function computeTextStartY(verticalAlign: "top" | "middle" | "bottom", rect: PdfRect, totalTextHeight: number, ascent: number, padV?: number): number;
 export declare function computeTextX(align: "left" | "center" | "right", rect: {
     x: number;
     width: number;
-}, textWidth: number, indentPts?: number): number;
+}, textWidth: number, indentPts?: number, padH?: number): number;
 /**
  * Wrap text into lines that fit within the given width.
  * Uses a greedy word-wrap algorithm.

package/dist/types/modules/pdf/render/pdf-exporter.d.ts

@@ -10,10 +10,11 @@
 import { type PdfWorkbook, type PdfExportOptions } from "../types.js";
 /**
  * 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 declare function exportPdf(workbook: PdfWorkbook, options?: PdfExportOptions): Uint8Array;
+export declare function exportPdf(workbook: PdfWorkbook, options?: PdfExportOptions): Promise<Uint8Array>;

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

@@ -99,6 +99,8 @@ export interface PdfCellData {
 export interface PdfRowData {
     hidden?: boolean;
     height?: number;
+    /** Whether the height was explicitly set by the user (vs auto-calculated) */
+    customHeight?: boolean;
     /** Cells keyed by 1-based column number */
     cells: Map<number, PdfCellData>;
 }
@@ -432,6 +434,8 @@ export interface LayoutCell {
     indent: number;
     /** Text rotation in degrees (0-90 ccw, 91-180 cw) or "vertical" for stacked */
     textRotation: number | "vertical";
+    /** Extra width (in points) that text can overflow into adjacent empty cells */
+    textOverflowWidth: number;
 }
 /**
  * A single run within a rich text cell.
@@ -465,6 +469,8 @@ export interface LayoutBorder {
     color: PdfColor;
     /** Dash pattern (empty array = solid) */
     dashPattern: number[];
+    /** Whether this is a double-line border */
+    isDouble?: boolean;
 }
 /**
  * A single page of laid-out content.
@@ -496,6 +502,8 @@ export interface LayoutPage {
     rowHeights: number[];
     /** Images to render on this page */
     images: LayoutImage[];
+    /** Scale factor applied to this page (for fitToPage) */
+    scaleFactor: number;
 }
 /**
  * A positioned image on a PDF page.

package/dist/types/utils/utils.base.d.ts

@@ -78,3 +78,8 @@ export declare function uint8ArrayToBase64(bytes: Uint8Array): string;
  * Convert string to UTF-16LE Uint8Array (used for Excel password hashing)
  */
 export declare function stringToUtf16Le(str: string): Uint8Array;
+/**
+ * Yield to the event loop via a macrotask.
+ * Uses `setTimeout(0)` which works in both Node.js and browsers.
+ */
+export declare function yieldToEventLoop(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "8.1.2",
+  "version": "9.0.0",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "type": "module",
   "main": "./dist/cjs/index.js",