@cj-tech-master/excelts 6.2.0 → 7.0.0

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

@@ -1,7 +1,189 @@
 /**
  * Type definitions for the PDF module.
- * Covers export options, page layout, and internal rendering models.
+ * Covers input data models, export options, page layout, and internal rendering models.
+ *
+ * The input data models (PdfWorkbook, PdfSheetData, etc.) are fully independent of
+ * the Excel module, allowing the PDF engine to be used standalone.
  */
+/**
+ * Cell value type discriminator for the PDF engine.
+ */
+export declare const PdfCellType: {
+    readonly Empty: 0;
+    readonly String: 1;
+    readonly Number: 2;
+    readonly Boolean: 3;
+    readonly Date: 4;
+    readonly RichText: 5;
+    readonly Error: 6;
+    readonly Formula: 7;
+    readonly Hyperlink: 8;
+    readonly Merge: 9;
+};
+export type PdfCellTypeValue = (typeof PdfCellType)[keyof typeof PdfCellType];
+/** Color data used across the PDF input model. */
+export interface PdfColorData {
+    argb?: string;
+    theme?: number;
+    tint?: number;
+}
+/** Font style in the PDF input model. */
+export interface PdfFontStyle {
+    name?: string;
+    size?: number;
+    bold?: boolean;
+    italic?: boolean;
+    strike?: boolean;
+    underline?: boolean | string;
+    color?: PdfColorData;
+}
+/** Fill data in the PDF input model. */
+export interface PdfFillData {
+    type: "pattern" | "gradient";
+    pattern?: string;
+    fgColor?: PdfColorData;
+    stops?: Array<{
+        position?: number;
+        color: PdfColorData;
+    }>;
+}
+/** A single border edge in the PDF input model. */
+export interface PdfBorderSideData {
+    style?: string;
+    color?: PdfColorData;
+}
+/** Border data in the PDF input model. */
+export interface PdfBordersData {
+    top?: Partial<PdfBorderSideData>;
+    right?: Partial<PdfBorderSideData>;
+    bottom?: Partial<PdfBorderSideData>;
+    left?: Partial<PdfBorderSideData>;
+}
+/** Alignment data in the PDF input model. */
+export interface PdfAlignmentData {
+    horizontal?: string;
+    vertical?: string;
+    wrapText?: boolean;
+    indent?: number;
+    textRotation?: number;
+}
+/** Cell style in the PDF input model. */
+export interface PdfCellStyle {
+    font?: Partial<PdfFontStyle>;
+    numFmt?: string | {
+        formatCode: string;
+    };
+    fill?: PdfFillData;
+    border?: Partial<PdfBordersData>;
+    alignment?: Partial<PdfAlignmentData>;
+}
+/** A single run of rich text. */
+export interface PdfRichTextRunData {
+    text: string;
+    font?: Partial<PdfFontStyle>;
+}
+/** A cell in the PDF input model. */
+export interface PdfCellData {
+    type: PdfCellTypeValue;
+    value: unknown;
+    /** Pre-computed display text */
+    text: string;
+    style?: Partial<PdfCellStyle>;
+    hyperlink?: string;
+    /** Formula result (for formula cells) */
+    result?: unknown;
+    /** Column number (1-based) */
+    col: number;
+}
+/** A row in the PDF input model. */
+export interface PdfRowData {
+    hidden?: boolean;
+    height?: number;
+    /** Cells keyed by 1-based column number */
+    cells: Map<number, PdfCellData>;
+}
+/** A column in the PDF input model. */
+export interface PdfColumnData {
+    hidden?: boolean;
+    width?: number;
+}
+/** Page setup configuration. */
+export interface PdfPageSetupData {
+    orientation?: string;
+    paperSize?: number;
+    margins?: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    scale?: number;
+    printTitlesRow?: string;
+    showGridLines?: boolean;
+    printArea?: string;
+}
+/** An image embedded in a sheet. */
+export interface PdfSheetImage {
+    data: Uint8Array;
+    format: "jpeg" | "png";
+    range: {
+        tl: {
+            col: number;
+            row: number;
+            nativeCol?: number;
+            nativeRow?: number;
+            nativeColOff?: number;
+            nativeRowOff?: number;
+        };
+        br?: {
+            col: number;
+            row: number;
+            nativeCol?: number;
+            nativeRow?: number;
+            nativeColOff?: number;
+            nativeRowOff?: number;
+        };
+        ext?: {
+            width: number;
+            height: number;
+        };
+    };
+}
+/** A single sheet in the PDF input model. */
+export interface PdfSheetData {
+    name: string;
+    state?: "visible" | "hidden" | "veryHidden";
+    /** Data bounds (1-based) */
+    bounds: {
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+    };
+    /** Columns keyed by 1-based column number */
+    columns: Map<number, PdfColumnData>;
+    /** Rows keyed by 1-based row number */
+    rows: Map<number, PdfRowData>;
+    /** Merge ranges in "A1:B2" format */
+    merges?: string[];
+    pageSetup?: PdfPageSetupData;
+    /** Row numbers where manual page breaks occur */
+    rowBreaks?: number[];
+    /** Column numbers where manual page breaks occur */
+    colBreaks?: number[];
+    /** Embedded images */
+    images?: PdfSheetImage[];
+}
+/**
+ * A workbook data structure for PDF generation.
+ * This is a plain data object — not tied to the Excel module.
+ */
+export interface PdfWorkbook {
+    title?: string;
+    creator?: string;
+    subject?: string;
+    sheets: PdfSheetData[];
+}
 /**
  * Standard page sizes in PDF points (1 point = 1/72 inch).
  */
@@ -33,7 +215,7 @@ export interface PdfExportOptions {
      */
     pageSize?: PageSizeName | PdfPageSize;
     /**
-     * Page orientation. If not set, uses the worksheet's pageSetup.orientation.
+     * Page orientation. If not set, uses the sheet's pageSetup.orientation.
      * @default "portrait"
      */
     orientation?: PdfOrientation;
@@ -43,8 +225,8 @@ export interface PdfExportOptions {
      */
     margins?: Partial<PdfMargins>;
     /**
-     * Which worksheets to include. Accepts sheet names or 1-based positions.
-     * If omitted, all visible worksheets are included.
+     * Which sheets to include. Accepts sheet names or 1-based positions.
+     * If omitted, all visible sheets are included.
      */
     sheets?: (string | number)[];
     /**
@@ -120,7 +302,7 @@ export interface PdfExportOptions {
      * ```typescript
      * import { readFileSync } from "fs";
      * const font = readFileSync("NotoSansSC-Regular.ttf");
-     * exporter.export({ font });
+     * excelToPdf(workbook, { font });
      * ```
      */
     font?: Uint8Array;
@@ -129,7 +311,7 @@ export interface PdfExportOptions {
      *
      * @example
      * ```typescript
-     * exporter.export({
+     * excelToPdf(workbook, {
      *   encryption: {
      *     ownerPassword: "secret",
      *     userPassword: "open",
@@ -290,7 +472,7 @@ export interface LayoutBorder {
 export interface LayoutPage {
     /** Page number (1-based) */
     pageNumber: number;
-    /** Resolved rendering options for the worksheet that produced this page */
+    /** Resolved rendering options for the sheet that produced this page */
     options: ResolvedPdfOptions;
     /** Cells to render on this page */
     cells: LayoutCell[];
@@ -300,14 +482,14 @@ export interface LayoutPage {
     height: number;
     /** Sheet name for this page */
     sheetName: string;
-    /** Worksheet column numbers included on this page */
-    worksheetCols: number[];
+    /** Sheet column numbers included on this page */
+    sheetCols: number[];
     /** Column x-offsets (left edges) relative to page content area */
     columnOffsets: number[];
     /** Column widths in points */
     columnWidths: number[];
-    /** Worksheet row numbers included on this page */
-    worksheetRows: number[];
+    /** Sheet row numbers included on this page */
+    sheetRows: number[];
     /** Row y-offsets (top edges) in page coordinates (PDF bottom-left origin) */
     rowYPositions: number[];
     /** Row heights in points */

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

@@ -1,7 +1,28 @@
 /**
  * Type definitions for the PDF module.
- * Covers export options, page layout, and internal rendering models.
+ * Covers input data models, export options, page layout, and internal rendering models.
+ *
+ * The input data models (PdfWorkbook, PdfSheetData, etc.) are fully independent of
+ * the Excel module, allowing the PDF engine to be used standalone.
  */
+// =============================================================================
+// PDF Input Data Model (Excel-independent)
+// =============================================================================
+/**
+ * Cell value type discriminator for the PDF engine.
+ */
+export const PdfCellType = {
+    Empty: 0,
+    String: 1,
+    Number: 2,
+    Boolean: 3,
+    Date: 4,
+    RichText: 5,
+    Error: 6,
+    Formula: 7,
+    Hyperlink: 8,
+    Merge: 9
+};
 /**
  * Predefined page sizes.
  */

package/dist/cjs/index.js

@@ -17,7 +17,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PdfRenderError = exports.PdfError = exports.PageSizes = exports.exportPdf = exports.PdfExporter = exports.uint8ArrayToString = exports.stringToUint8Array = exports.toUint8Array = exports.concatUint8Arrays = exports.getRootCause = exports.getErrorChain = exports.errorToJSON = exports.toError = exports.BaseError = exports.getSupportedFormats = exports.DateFormatter = exports.DateParser = exports.xmlDecode = exports.xmlEncode = exports.uint8ArrayToBase64 = exports.base64ToUint8Array = exports.excelToDate = exports.dateToExcel = exports.encodeRange = exports.decodeRange = exports.encodeCell = exports.decodeCell = exports.encodeRow = exports.decodeRow = exports.encodeCol = exports.decodeCol = exports.DefinedNames = exports.createCsvFormatterStream = exports.createCsvParserStream = exports.CsvFormatterStream = exports.CsvParserStream = exports.WorksheetReader = exports.WorksheetWriter = exports.WorkbookReader = exports.WorkbookWriter = exports.FormCheckbox = exports.DataValidations = exports.Table = exports.Image = exports.Range = exports.Cell = exports.Column = exports.Row = exports.Worksheet = exports.Workbook = void 0;
+exports.PdfRenderError = exports.PdfError = exports.PageSizes = exports.excelToPdf = exports.pdf = exports.uint8ArrayToString = exports.stringToUint8Array = exports.toUint8Array = exports.concatUint8Arrays = exports.getRootCause = exports.getErrorChain = exports.errorToJSON = exports.toError = exports.BaseError = exports.getSupportedFormats = exports.DateFormatter = exports.DateParser = exports.xmlDecode = exports.xmlEncode = exports.uint8ArrayToBase64 = exports.base64ToUint8Array = exports.excelToDate = exports.dateToExcel = exports.encodeRange = exports.decodeRange = exports.encodeCell = exports.decodeCell = exports.encodeRow = exports.decodeRow = exports.encodeCol = exports.decodeCol = exports.DefinedNames = exports.createCsvFormatterStream = exports.createCsvParserStream = exports.CsvFormatterStream = exports.CsvParserStream = exports.WorksheetReader = exports.WorksheetWriter = exports.WorkbookReader = exports.WorkbookWriter = exports.FormCheckbox = exports.DataValidations = exports.Table = exports.Image = exports.Range = exports.Cell = exports.Column = exports.Row = exports.Worksheet = exports.Workbook = void 0;
 exports.MaxItemsExceededError = exports.ImageError = exports.TableError = exports.PivotTableError = exports.WorksheetNameError = exports.XmlParseError = exports.InvalidValueTypeError = exports.MergeConflictError = exports.RowOutOfBoundsError = exports.ColumnOutOfBoundsError = exports.InvalidAddressError = exports.ExcelStreamStateError = exports.ExcelNotSupportedError = exports.ExcelDownloadError = exports.ExcelFileError = exports.isExcelError = exports.ExcelError = exports.isPdfError = exports.PdfStructureError = exports.PdfFontError = void 0;
 var workbook_1 = require("./modules/excel/workbook.js");
 Object.defineProperty(exports, "Workbook", { enumerable: true, get: function () { return workbook_1.Workbook; } });
@@ -118,8 +118,8 @@ Object.defineProperty(exports, "uint8ArrayToString", { enumerable: true, get: fu
 // PDF Export
 // =============================================================================
 var index_1 = require("./modules/pdf/index.js");
-Object.defineProperty(exports, "PdfExporter", { enumerable: true, get: function () { return index_1.PdfExporter; } });
-Object.defineProperty(exports, "exportPdf", { enumerable: true, get: function () { return index_1.exportPdf; } });
+Object.defineProperty(exports, "pdf", { enumerable: true, get: function () { return index_1.pdf; } });
+Object.defineProperty(exports, "excelToPdf", { enumerable: true, get: function () { return index_1.excelToPdf; } });
 Object.defineProperty(exports, "PageSizes", { enumerable: true, get: function () { return index_1.PageSizes; } });
 Object.defineProperty(exports, "PdfError", { enumerable: true, get: function () { return index_1.PdfError; } });
 Object.defineProperty(exports, "PdfRenderError", { enumerable: true, get: function () { return index_1.PdfRenderError; } });