@lexmata/micropdf 0.4.0 → 0.5.0

package/dist/enhanced.js

@@ -1,368 +1,958 @@
 /**
- * Enhanced - MicroPDF high-level convenience API
+ * Enhanced MicroPDF Functions (mp_* prefix)
  *
- * This module provides MicroPDF-specific high-level functions for common PDF operations.
- * These are convenience wrappers that simplify complex workflows and provide a more
- * user-friendly API for common tasks.
- *
- * The Enhanced API includes operations like:
- * - Adding blank pages
- * - Adding watermarks
- * - Drawing shapes (rectangles, circles, lines)
- * - Merging and splitting PDFs
- * - Optimizing and linearizing PDFs
- *
- * @module enhanced
- * @example
- * ```typescript
- * import { Enhanced, Document } from 'micropdf';
- *
- * const enhanced = new Enhanced();
- * const doc = Document.open('document.pdf');
- *
- * // Add a blank page
- * enhanced.addBlankPage(doc, 612, 792); // US Letter size
- *
- * // Add a watermark
- * enhanced.addWatermark(
- *   doc,
- *   'CONFIDENTIAL',
- *   { x: 300, y: 400 },
- *   12,
- *   0.3 // 30% opacity
- * );
- *
- * // Draw shapes
- * enhanced.drawRectangle(
- *   doc,
- *   0, // page index
- *   { x0: 100, y0: 100, x1: 200, y1: 200 },
- *   [255, 0, 0], // red
- *   0.5, // opacity
- *   2, // line width
- *   true // fill
- * );
- *
- * // Save
- * doc.save('output.pdf');
- * doc.close();
- * ```
- *
- * @example
- * ```typescript
- * // Merge multiple PDFs
- * const enhanced = new Enhanced();
- * enhanced.mergePdfs(
- *   ['doc1.pdf', 'doc2.pdf', 'doc3.pdf'],
- *   'merged.pdf'
- * );
- *
- * // Split a PDF
- * enhanced.splitPdf(
- *   'document.pdf',
- *   'output-dir',
- *   { startPage: 0, endPage: 10 }
- * );
- *
- * // Optimize a PDF
- * enhanced.optimizePdf('large.pdf', 'optimized.pdf');
- *
- * // Linearize for web viewing
- * enhanced.linearizePdf('document.pdf', 'web-optimized.pdf');
- * ```
+ * This module provides TypeScript bindings for all 120+ enhanced MicroPDF
+ * functions including:
+ * - Print Production (N-Up, Booklet, Poster)
+ * - Digital Signatures & Encryption
+ * - HTML to PDF Conversion
+ * - Document Composition (Platypus-like)
+ * - PDF Validation & Repair
  */
-import { getDefaultContext } from './context.js';
-import { Color } from './geometry.js';
 import { native } from './native.js';
+// ============================================================================
+// Type Definitions
+// ============================================================================
+/** Page size presets */
+export var PageSize;
+(function (PageSize) {
+    PageSize[PageSize["A4"] = 0] = "A4";
+    PageSize[PageSize["Letter"] = 1] = "Letter";
+    PageSize[PageSize["Legal"] = 2] = "Legal";
+    PageSize[PageSize["A3"] = 3] = "A3";
+    PageSize[PageSize["A5"] = 4] = "A5";
+    PageSize[PageSize["B4"] = 5] = "B4";
+    PageSize[PageSize["B5"] = 6] = "B5";
+    PageSize[PageSize["Executive"] = 7] = "Executive";
+    PageSize[PageSize["Ledger"] = 8] = "Ledger";
+    PageSize[PageSize["Tabloid"] = 9] = "Tabloid";
+})(PageSize || (PageSize = {}));
+/** Binding methods for booklet creation */
+export var BindingMethod;
+(function (BindingMethod) {
+    BindingMethod[BindingMethod["SaddleStitch"] = 0] = "SaddleStitch";
+    BindingMethod[BindingMethod["PerfectBinding"] = 1] = "PerfectBinding";
+    BindingMethod[BindingMethod["SideStitch"] = 2] = "SideStitch";
+    BindingMethod[BindingMethod["WireO"] = 3] = "WireO";
+    BindingMethod[BindingMethod["CaseBinding"] = 4] = "CaseBinding";
+})(BindingMethod || (BindingMethod = {}));
+/** Page box types */
+export var PageBoxType;
+(function (PageBoxType) {
+    PageBoxType[PageBoxType["MediaBox"] = 0] = "MediaBox";
+    PageBoxType[PageBoxType["CropBox"] = 1] = "CropBox";
+    PageBoxType[PageBoxType["BleedBox"] = 2] = "BleedBox";
+    PageBoxType[PageBoxType["TrimBox"] = 3] = "TrimBox";
+    PageBoxType[PageBoxType["ArtBox"] = 4] = "ArtBox";
+})(PageBoxType || (PageBoxType = {}));
+/** Unit types for measurements */
+export var Unit;
+(function (Unit) {
+    Unit[Unit["Points"] = 0] = "Points";
+    Unit[Unit["Millimeters"] = 1] = "Millimeters";
+    Unit[Unit["Inches"] = 2] = "Inches";
+    Unit[Unit["Centimeters"] = 3] = "Centimeters";
+})(Unit || (Unit = {}));
+/** Encryption algorithms */
+export var EncryptionAlgorithm;
+(function (EncryptionAlgorithm) {
+    EncryptionAlgorithm[EncryptionAlgorithm["RC4_40"] = 0] = "RC4_40";
+    EncryptionAlgorithm[EncryptionAlgorithm["RC4_128"] = 1] = "RC4_128";
+    EncryptionAlgorithm[EncryptionAlgorithm["AES_128"] = 2] = "AES_128";
+    EncryptionAlgorithm[EncryptionAlgorithm["AES_256"] = 3] = "AES_256";
+})(EncryptionAlgorithm || (EncryptionAlgorithm = {}));
+/** Document permissions */
+export var DocumentPermission;
+(function (DocumentPermission) {
+    DocumentPermission[DocumentPermission["Print"] = 4] = "Print";
+    DocumentPermission[DocumentPermission["ModifyContents"] = 8] = "ModifyContents";
+    DocumentPermission[DocumentPermission["Copy"] = 16] = "Copy";
+    DocumentPermission[DocumentPermission["ModifyAnnotations"] = 32] = "ModifyAnnotations";
+    DocumentPermission[DocumentPermission["FillForms"] = 256] = "FillForms";
+    DocumentPermission[DocumentPermission["ExtractForAccessibility"] = 512] = "ExtractForAccessibility";
+    DocumentPermission[DocumentPermission["Assemble"] = 1024] = "Assemble";
+    DocumentPermission[DocumentPermission["PrintHighQuality"] = 2048] = "PrintHighQuality";
+})(DocumentPermission || (DocumentPermission = {}));
+/** Text alignment */
+export var TextAlign;
+(function (TextAlign) {
+    TextAlign[TextAlign["Left"] = 0] = "Left";
+    TextAlign[TextAlign["Center"] = 1] = "Center";
+    TextAlign[TextAlign["Right"] = 2] = "Right";
+    TextAlign[TextAlign["Justify"] = 3] = "Justify";
+})(TextAlign || (TextAlign = {}));
+/** Validation modes */
+export var ValidationMode;
+(function (ValidationMode) {
+    ValidationMode[ValidationMode["Quick"] = 0] = "Quick";
+    ValidationMode[ValidationMode["Standard"] = 1] = "Standard";
+    ValidationMode[ValidationMode["Strict"] = 2] = "Strict";
+})(ValidationMode || (ValidationMode = {}));
+// ============================================================================
+// Print Production Functions
+// ============================================================================
 /**
- * Enhanced MicroPDF API for high-level PDF operations.
- *
- * Provides convenient methods for common PDF manipulation tasks that would
- * otherwise require multiple lower-level API calls.
- *
- * @class Enhanced
- * @example
- * ```typescript
- * const enhanced = new Enhanced();
- * const doc = Document.open('document.pdf');
- *
- * // Add a watermark to all pages
- * for (let i = 0; i < doc.pageCount; i++) {
- *   enhanced.addWatermark(
- *     doc,
- *     'DRAFT',
- *     { x: 300, y: 400 },
- *     48,
- *     0.2
- *   );
- * }
- *
- * doc.save('watermarked.pdf');
- * doc.close();
- * ```
- */
-export class Enhanced {
-    _ctx;
-    constructor(ctx) {
-        this._ctx = ctx || getDefaultContext();
-    }
-    /**
-     * Get the context
-     */
-    get context() {
-        return this._ctx;
-    }
-    // ============================================================================
-    // Page Operations
-    // ============================================================================
-    /**
-     * Add a blank page to a document using FFI
-     * @returns Page number of newly added page
-     * @throws Error when native bindings are not available
-     */
-    addBlankPage(_doc, width, height) {
-        // Get native handles (will be available when Document exposes them)
-        const ctx = this._ctx?._nativeCtx;
-        const nativeDoc = _doc?._doc;
-        if (!ctx || !nativeDoc) {
-            throw new Error('Adding blank page requires native FFI bindings (mp_add_blank_page)');
-        }
-        return native.npAddBlankPage(ctx, nativeDoc, width, height);
-    }
-    // ============================================================================
-    // Drawing Operations
-    // ============================================================================
-    /**
-     * Draw a line on a page using FFI
-     * @throws Error when native bindings are not available
-     */
-    drawLine(page, x0, y0, x1, y1, color, alpha = 1.0, lineWidth = 1.0) {
-        const ctx = this._ctx?._nativeCtx;
-        const nativePage = page?._page;
-        if (!ctx || !nativePage) {
-            throw new Error('Drawing line requires native FFI bindings (mp_draw_line)');
-        }
-        const c = Color.from(color);
-        const colorArray = [c.r, c.g, c.b];
-        native.npDrawLine(ctx, nativePage, x0, y0, x1, y1, colorArray, alpha, lineWidth);
-    }
-    /**
-     * Draw a rectangle on a page using FFI
-     * @throws Error when native bindings are not available
-     */
-    drawRectangle(page, x, y, width, height, color, alpha = 1.0, fill = false) {
-        const ctx = this._ctx?._nativeCtx;
-        const nativePage = page?._page;
-        if (!ctx || !nativePage) {
-            throw new Error('Drawing rectangle requires native FFI bindings (mp_draw_rectangle)');
-        }
-        const c = Color.from(color);
-        const colorArray = [c.r, c.g, c.b];
-        native.npDrawRectangle(ctx, nativePage, x, y, width, height, colorArray, alpha, fill);
-    }
-    /**
-     * Draw a circle on a page using FFI
-     * @throws Error when native bindings are not available
-     */
-    drawCircle(page, x, y, radius, color, alpha = 1.0, fill = false) {
-        const ctx = this._ctx?._nativeCtx;
-        const nativePage = page?._page;
-        if (!ctx || !nativePage) {
-            throw new Error('Drawing circle requires native FFI bindings (mp_draw_circle)');
-        }
-        const c = Color.from(color);
-        const colorArray = [c.r, c.g, c.b];
-        native.npDrawCircle(ctx, nativePage, x, y, radius, colorArray, alpha, fill);
-    }
-    // ============================================================================
-    // Watermark Operations
-    // ============================================================================
-    /**
-     * Add watermark to PDF using FFI
-     * @throws Error when native bindings are not available
-     */
-    async addWatermark(inputPath, _outputPath, text, _x = 100, _y = 100, fontSize = 48, opacity = 0.3) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('Watermark requires native FFI bindings (mp_add_watermark)');
-        }
-        // Open document
-        const doc = native.openDocumentFromPath(ctx, inputPath);
-        native.npAddWatermark(ctx, doc, text, fontSize, opacity);
-        native.dropDocument(ctx, doc);
-    }
-    // ============================================================================
-    // PDF Manipulation
-    // ============================================================================
-    /**
-     * Merge multiple PDFs into one using FFI
-     * @throws Error when native bindings are not available
-     */
-    async mergePDFs(inputPaths, outputPath) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('PDF merging requires native FFI bindings (mp_merge_pdfs)');
-        }
-        native.npMergePDFs(ctx, inputPaths, inputPaths.length, outputPath);
-    }
-    /**
-     * Split PDF into separate files using FFI
-     * @returns Array of output file paths
-     * @throws Error when native bindings are not available
-     */
-    async splitPDF(inputPath, outputDir) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('PDF splitting requires native FFI bindings (mp_split_pdf)');
-        }
-        return native.npSplitPDF(ctx, inputPath, outputDir);
-    }
-    /**
-     * Optimize PDF (compress, remove unused objects) using FFI
-     * @throws Error when native bindings are not available
-     */
-    async optimizePDF(path) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('PDF optimization requires native FFI bindings (mp_optimize_pdf)');
-        }
-        native.npOptimizePDF(ctx, path);
-    }
-    /**
-     * Linearize PDF for fast web viewing using FFI
-     * @throws Error when native bindings are not available
-     */
-    async linearizePDF(inputPath, outputPath) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('PDF linearization requires native FFI bindings (mp_linearize_pdf)');
-        }
-        native.npLinearizePDF(ctx, inputPath, outputPath);
-    }
-    /**
-     * Write document to PDF file using FFI
-     * @throws Error when native bindings are not available
-     */
-    async writePDF(doc, path) {
-        const ctx = this._ctx?._nativeCtx;
-        const nativeDoc = doc?._doc;
-        if (!ctx || !nativeDoc) {
-            throw new Error('Writing PDF requires native FFI bindings (pdf_save_document)');
-        }
-        native.saveDocument(ctx, nativeDoc, path);
-    }
-    /**
-     * Merge multiple PDF files into a single output file
-     *
-     * @param inputPaths Array of PDF file paths to merge (in order)
-     * @param outputPath Path where the merged PDF will be saved
-     * @returns Promise that resolves to the number of pages in the merged PDF
-     * @throws Error if any input file is invalid, not found, or merge fails
-     * @throws Error when native bindings are not available
-     *
-     * @example
-     * ```typescript
-     * import { Enhanced } from 'micropdf';
-     *
-     * const enhanced = new Enhanced();
-     * const pageCount = await enhanced.mergePDF(
-     *   ['document1.pdf', 'document2.pdf', 'document3.pdf'],
-     *   'merged.pdf'
-     * );
-     * console.log(`Merged ${pageCount} pages`);
-     * ```
-     *
-     * @example Large document handling
-     * ```typescript
-     * // Works with large documents (5000+ pages)
-     * const pageCount = await enhanced.mergePDF(
-     *   ['large_doc1.pdf', 'large_doc2.pdf'],
-     *   'combined.pdf'
-     * );
-     * ```
-     */
-    async mergePDF(inputPaths, outputPath) {
-        const ctx = this._ctx?._nativeCtx;
-        if (!ctx) {
-            throw new Error('Merging PDFs requires native FFI bindings (mp_merge_pdfs)');
-        }
-        if (!inputPaths || inputPaths.length === 0) {
-            throw new Error('At least one input PDF path is required');
-        }
-        if (!outputPath) {
-            throw new Error('Output path is required');
-        }
-        try {
-            const pageCount = native.npMergePDFs(ctx, inputPaths, inputPaths.length, outputPath);
-            if (pageCount < 0) {
-                throw new Error('PDF merge failed');
-            }
-            return pageCount;
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                throw new Error(`Failed to merge PDFs: ${error.message}`);
-            }
-            throw new Error('Failed to merge PDFs: Unknown error');
-        }
-    }
-    // ============================================================================
-    // Convenience Factory Methods
-    // ============================================================================
-    /**
-     * Create a new blank PDF document
-     * @param width Page width in points (default A4 width: 595)
-     * @param height Page height in points (default A4 height: 842)
-     * @throws Error This is a static method that requires instance context
-     */
-    static createBlankDocument(_width = 595, _height = 842) {
-        throw new Error('Document creation requires native FFI bindings (fz_new_document). ' +
-            'Use Document.fromBuffer() or Enhanced instance methods instead.');
-    }
-    /**
-     * Quick create PDF with text
-     * @throws Error This is a static method that requires instance context
-     */
-    static async createTextPDF(_text, _outputPath, _options) {
-        throw new Error('PDF text creation requires native FFI bindings (fz_new_document, fz_show_string). ' +
-            'Use Enhanced instance methods instead.');
-    }
-}
-/**
- * Global enhanced API instance
- */
-let globalEnhanced = null;
-/**
- * Get global enhanced API
- */
-export function getEnhanced() {
-    if (!globalEnhanced) {
-        globalEnhanced = new Enhanced();
-    }
-    return globalEnhanced;
-}
-/**
- * Convenience functions (use global instance)
- */
-export async function addWatermark(inputPath, outputPath, text, x, y, fontSize, opacity) {
-    return getEnhanced().addWatermark(inputPath, outputPath, text, x, y, fontSize, opacity);
-}
-export async function mergePDFs(inputPaths, outputPath) {
-    return getEnhanced().mergePDFs(inputPaths, outputPath);
-}
-export async function splitPDF(inputPath, outputDir) {
-    return getEnhanced().splitPDF(inputPath, outputDir);
-}
-export async function optimizePDF(path) {
-    return getEnhanced().optimizePDF(path);
-}
-export async function linearizePDF(inputPath, outputPath) {
-    return getEnhanced().linearizePDF(inputPath, outputPath);
-}
-export function createBlankDocument(width, height) {
-    return Enhanced.createBlankDocument(width, height);
-}
-export async function createTextPDF(text, outputPath, options) {
-    return Enhanced.createTextPDF(text, outputPath, options);
+ * Create a 2-up layout (2 pages per sheet)
+ */
+export function create2Up(inputPath, outputPath, pageSize = PageSize.A4) {
+    const result = native.mp_create_2up?.(inputPath, outputPath, pageSize);
+    if (result !== 0) {
+        throw new Error('Failed to create 2-up layout');
+    }
+}
+/**
+ * Create a 4-up layout (4 pages per sheet)
+ */
+export function create4Up(inputPath, outputPath, pageSize = PageSize.A4) {
+    const result = native.mp_create_4up?.(inputPath, outputPath, pageSize);
+    if (result !== 0) {
+        throw new Error('Failed to create 4-up layout');
+    }
+}
+/**
+ * Create a 9-up layout (9 pages per sheet)
+ */
+export function create9Up(inputPath, outputPath, pageSize = PageSize.A4) {
+    const result = native.mp_create_9up?.(inputPath, outputPath, pageSize);
+    if (result !== 0) {
+        throw new Error('Failed to create 9-up layout');
+    }
+}
+/**
+ * Create a custom N-up layout
+ */
+export function createNup(inputPath, outputPath, cols, rows, pageSize = PageSize.A4) {
+    const result = native.mp_create_nup?.(inputPath, outputPath, cols, rows, pageSize);
+    if (result !== 0) {
+        throw new Error('Failed to create N-up layout');
+    }
+}
+/**
+ * Create a booklet for printing
+ */
+export function createBooklet(inputPath, outputPath, bindingType = BindingMethod.SaddleStitch, pageSize = PageSize.A4, addBlanks = true) {
+    const result = native.mp_create_booklet?.(inputPath, outputPath, bindingType, pageSize, addBlanks ? 1 : 0);
+    if (result !== 0) {
+        throw new Error('Failed to create booklet');
+    }
+}
+/**
+ * Create a saddle-stitch booklet (simplified)
+ */
+export function createSaddleStitchBooklet(inputPath, outputPath) {
+    const result = native.mp_create_saddle_stitch_booklet?.(inputPath, outputPath);
+    if (result !== 0) {
+        throw new Error('Failed to create saddle-stitch booklet');
+    }
+}
+/**
+ * Create a poster by tiling pages
+ */
+export function createPoster(inputPath, outputPath, tileSize, overlapMm = 10, cutMarks = true) {
+    const result = native.mp_create_poster?.(inputPath, outputPath, tileSize, overlapMm, cutMarks ? 1 : 0);
+    if (result !== 0) {
+        throw new Error('Failed to create poster');
+    }
+}
+/**
+ * Get the number of tiles for a poster
+ */
+export function getPosterTileCount(pdfPath, tileSize, overlapMm = 10) {
+    return native.mp_poster_tile_count?.(pdfPath, tileSize, overlapMm) ?? 0;
+}
+// ============================================================================
+// Page Box Management
+// ============================================================================
+/**
+ * Create a page box manager for a PDF
+ */
+export function createPageBoxManager(pdfPath) {
+    const handle = native.mp_page_box_manager_create?.(pdfPath);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create page box manager');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a page box manager
+ */
+export function freePageBoxManager(manager) {
+    native.mp_page_box_manager_free?.(manager._handle);
+}
+/**
+ * Get the page count from a page box manager
+ */
+export function getPageBoxPageCount(manager) {
+    return native.mp_page_box_manager_page_count?.(manager._handle) ?? 0;
+}
+/**
+ * Get a page box
+ */
+export function getPageBox(manager, page, boxType) {
+    const rect = { llx: 0, lly: 0, urx: 0, ury: 0 };
+    const result = native.mp_page_box_get?.(manager._handle, page, boxType, rect);
+    if (result !== 0) {
+        throw new Error('Failed to get page box');
+    }
+    return rect;
+}
+/**
+ * Set a page box
+ */
+export function setPageBox(manager, page, boxType, rect) {
+    const result = native.mp_page_box_set?.(manager._handle, page, boxType, rect.llx, rect.lly, rect.urx, rect.ury);
+    if (result !== 0) {
+        throw new Error('Failed to set page box');
+    }
+}
+/**
+ * Add bleed to all pages
+ */
+export function addBleed(manager, bleed, unit = Unit.Points) {
+    const result = native.mp_page_box_add_bleed?.(manager._handle, bleed, unit);
+    if (result !== 0) {
+        throw new Error('Failed to add bleed');
+    }
+}
+/**
+ * Save page box changes
+ */
+export function savePageBox(manager, outputPath) {
+    const result = native.mp_page_box_save?.(manager._handle, outputPath);
+    if (result !== 0) {
+        throw new Error('Failed to save page boxes');
+    }
+}
+// ============================================================================
+// Encryption & Decryption
+// ============================================================================
+/**
+ * Check if a PDF is encrypted
+ */
+export function isEncrypted(pdfPath) {
+    return native.mp_is_encrypted?.(pdfPath) === 1;
+}
+/**
+ * Create encryption options
+ */
+export function createEncryptionOptions() {
+    const handle = native.mp_encryption_options_new?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create encryption options');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free encryption options
+ */
+export function freeEncryptionOptions(options) {
+    native.mp_encryption_options_drop?.(options._handle);
+}
+/**
+ * Set user password for encryption
+ */
+export function setUserPassword(options, password) {
+    native.mp_encryption_set_user_password?.(options._handle, password);
+}
+/**
+ * Set owner password for encryption
+ */
+export function setOwnerPassword(options, password) {
+    native.mp_encryption_set_owner_password?.(options._handle, password);
+}
+/**
+ * Set document permissions
+ */
+export function setPermissions(options, permissions) {
+    native.mp_encryption_set_permissions?.(options._handle, permissions);
+}
+/**
+ * Set encryption algorithm
+ */
+export function setAlgorithm(options, algorithm) {
+    native.mp_encryption_set_algorithm?.(options._handle, algorithm);
+}
+/**
+ * Encrypt a PDF
+ */
+export function encryptPdf(inputPath, outputPath, options) {
+    const result = native.mp_encrypt_pdf?.(inputPath, outputPath, options._handle);
+    if (result !== 0) {
+        throw new Error('Failed to encrypt PDF');
+    }
+}
+/**
+ * Decrypt a PDF
+ */
+export function decryptPdf(inputPath, outputPath, password) {
+    const result = native.mp_decrypt_pdf?.(inputPath, outputPath, password);
+    if (result !== 0) {
+        throw new Error('Failed to decrypt PDF');
+    }
+}
+// ============================================================================
+// Digital Signatures
+// ============================================================================
+/**
+ * Load a certificate from PEM files
+ */
+export function loadCertificatePem(certPath, keyPath, keyPassword) {
+    const handle = native.mp_certificate_load_pem?.(certPath, keyPath, keyPassword ?? null);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to load certificate from PEM');
+    }
+    return { _handle: handle };
+}
+/**
+ * Load a certificate from PKCS#12 file
+ */
+export function loadCertificatePkcs12(path, password) {
+    const handle = native.mp_certificate_load_pkcs12?.(path, password);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to load certificate from PKCS#12');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a certificate
+ */
+export function freeCertificate(cert) {
+    native.mp_certificate_drop?.(cert._handle);
+}
+/**
+ * Check if a certificate is valid
+ */
+export function isCertificateValid(cert) {
+    return native.mp_certificate_is_valid?.(cert._handle) === 1;
+}
+/**
+ * Get certificate subject
+ */
+export function getCertificateSubject(cert) {
+    return native.mp_certificate_get_subject?.(cert._handle) ?? '';
+}
+/**
+ * Get certificate issuer
+ */
+export function getCertificateIssuer(cert) {
+    return native.mp_certificate_get_issuer?.(cert._handle) ?? '';
+}
+/**
+ * Create a digital signature with appearance
+ */
+export function createSignature(inputPath, outputPath, cert, fieldName, page, x, y, width, height, reason, location) {
+    const result = native.mp_signature_create?.(inputPath, outputPath, cert._handle, fieldName, page, x, y, width, height, reason ?? null, location ?? null);
+    if (result !== 0) {
+        throw new Error('Failed to create signature');
+    }
+}
+/**
+ * Create an invisible digital signature
+ */
+export function createInvisibleSignature(inputPath, outputPath, cert, fieldName, reason, location) {
+    const result = native.mp_signature_create_invisible?.(inputPath, outputPath, cert._handle, fieldName, reason ?? null, location ?? null);
+    if (result !== 0) {
+        throw new Error('Failed to create invisible signature');
+    }
+}
+/**
+ * Verify a signature
+ */
+export function verifySignature(pdfPath, fieldName) {
+    const result = {
+        valid: false,
+        modifiedAfterSigning: false
+    };
+    const status = native.mp_signature_verify?.(pdfPath, fieldName, result);
+    if (status !== 0) {
+        throw new Error('Failed to verify signature');
+    }
+    return result;
+}
+/**
+ * Count signatures in a PDF
+ */
+export function countSignatures(pdfPath) {
+    return native.mp_signature_count?.(pdfPath) ?? 0;
+}
+// ============================================================================
+// HTML to PDF Conversion
+// ============================================================================
+/**
+ * Create HTML conversion options
+ */
+export function createHtmlOptions() {
+    const handle = native.mp_html_options_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create HTML options');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free HTML options
+ */
+export function freeHtmlOptions(options) {
+    native.mp_html_options_free?.(options._handle);
+}
+/**
+ * Set page size for HTML conversion
+ */
+export function setHtmlPageSize(options, pageSize) {
+    native.mp_html_options_set_page_size?.(options._handle, pageSize);
+}
+/**
+ * Set custom page size for HTML conversion
+ */
+export function setHtmlCustomPageSize(options, width, height) {
+    native.mp_html_options_set_page_size_custom?.(options._handle, width, height);
+}
+/**
+ * Set margins for HTML conversion
+ */
+export function setHtmlMargins(options, top, right, bottom, left) {
+    native.mp_html_options_set_margins?.(options._handle, top, right, bottom, left);
+}
+/**
+ * Set landscape mode for HTML conversion
+ */
+export function setHtmlLandscape(options, landscape) {
+    native.mp_html_options_set_landscape?.(options._handle, landscape ? 1 : 0);
+}
+/**
+ * Set scale for HTML conversion
+ */
+export function setHtmlScale(options, scale) {
+    native.mp_html_options_set_scale?.(options._handle, scale);
+}
+/**
+ * Set print background for HTML conversion
+ */
+export function setHtmlPrintBackground(options, enabled) {
+    native.mp_html_options_set_print_background?.(options._handle, enabled ? 1 : 0);
+}
+/**
+ * Set header HTML
+ */
+export function setHtmlHeader(options, html) {
+    native.mp_html_options_set_header?.(options._handle, html);
+}
+/**
+ * Set footer HTML
+ */
+export function setHtmlFooter(options, html) {
+    native.mp_html_options_set_footer?.(options._handle, html);
+}
+/**
+ * Enable/disable JavaScript
+ */
+export function setHtmlJavaScript(options, enabled) {
+    native.mp_html_options_set_javascript?.(options._handle, enabled ? 1 : 0);
+}
+/**
+ * Set base URL for relative paths
+ */
+export function setHtmlBaseUrl(options, url) {
+    native.mp_html_options_set_base_url?.(options._handle, url);
+}
+/**
+ * Set custom stylesheet
+ */
+export function setHtmlStylesheet(options, css) {
+    native.mp_html_options_set_stylesheet?.(options._handle, css);
+}
+/**
+ * Convert HTML string to PDF
+ */
+export function htmlToPdf(html, outputPath, options) {
+    const result = native.mp_html_to_pdf?.(html, outputPath, options?._handle ?? 0);
+    if (result !== 0) {
+        throw new Error('Failed to convert HTML to PDF');
+    }
+}
+/**
+ * Convert HTML file to PDF
+ */
+export function htmlFileToPdf(htmlPath, outputPath, options) {
+    const result = native.mp_html_file_to_pdf?.(htmlPath, outputPath, options?._handle ?? 0);
+    if (result !== 0) {
+        throw new Error('Failed to convert HTML file to PDF');
+    }
+}
+// ============================================================================
+// Document Composition (Platypus-like)
+// ============================================================================
+/**
+ * Create a document template
+ */
+export function createDocTemplate(filename) {
+    const handle = native.mp_doc_template_create?.(filename);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create document template');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a document template
+ */
+export function freeDocTemplate(template) {
+    native.mp_doc_template_free?.(template._handle);
+}
+/**
+ * Set page size for document template
+ */
+export function setDocTemplatePageSize(template, width, height) {
+    native.mp_doc_template_set_page_size?.(template._handle, width, height);
+}
+/**
+ * Set margins for document template
+ */
+export function setDocTemplateMargins(template, left, right, top, bottom) {
+    native.mp_doc_template_set_margins?.(template._handle, left, right, top, bottom);
+}
+/**
+ * Create a frame
+ */
+export function createFrame(id, x, y, width, height) {
+    const handle = native.mp_frame_create?.(id, x, y, width, height);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create frame');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a frame
+ */
+export function freeFrame(frame) {
+    native.mp_frame_free?.(frame._handle);
+}
+/**
+ * Get frame available width
+ */
+export function getFrameAvailableWidth(frame) {
+    return native.mp_frame_available_width?.(frame._handle) ?? 0;
+}
+/**
+ * Get frame available height
+ */
+export function getFrameAvailableHeight(frame) {
+    return native.mp_frame_available_height?.(frame._handle) ?? 0;
+}
+/**
+ * Create a paragraph
+ */
+export function createParagraph(text) {
+    const handle = native.mp_paragraph_create?.(text);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create paragraph');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a paragraph
+ */
+export function freeParagraph(paragraph) {
+    native.mp_paragraph_free?.(paragraph._handle);
+}
+/**
+ * Set paragraph font size
+ */
+export function setParagraphFontSize(paragraph, size) {
+    native.mp_paragraph_set_font_size?.(paragraph._handle, size);
+}
+/**
+ * Set paragraph leading
+ */
+export function setParagraphLeading(paragraph, leading) {
+    native.mp_paragraph_set_leading?.(paragraph._handle, leading);
+}
+/**
+ * Create a paragraph style
+ */
+export function createParagraphStyle(name) {
+    const handle = native.mp_paragraph_style_create?.(name);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create paragraph style');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a paragraph style
+ */
+export function freeParagraphStyle(style) {
+    native.mp_paragraph_style_free?.(style._handle);
+}
+/**
+ * Set paragraph style font size
+ */
+export function setParagraphStyleFontSize(style, size) {
+    native.mp_paragraph_style_set_font_size?.(style._handle, size);
+}
+/**
+ * Set paragraph style leading
+ */
+export function setParagraphStyleLeading(style, leading) {
+    native.mp_paragraph_style_set_leading?.(style._handle, leading);
+}
+/**
+ * Set paragraph style alignment
+ */
+export function setParagraphStyleAlignment(style, align) {
+    native.mp_paragraph_style_set_alignment?.(style._handle, align);
+}
+/**
+ * Create a spacer
+ */
+export function createSpacer(height) {
+    const handle = native.mp_spacer_create?.(height);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create spacer');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a spacer
+ */
+export function freeSpacer(spacer) {
+    native.mp_spacer_free?.(spacer._handle);
+}
+/**
+ * Create a horizontal rule
+ */
+export function createHorizontalRule() {
+    const handle = native.mp_hr_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create horizontal rule');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a horizontal rule
+ */
+export function freeHorizontalRule(hr) {
+    native.mp_hr_free?.(hr._handle);
+}
+/**
+ * Set horizontal rule thickness
+ */
+export function setHorizontalRuleThickness(hr, thickness) {
+    native.mp_hr_set_thickness?.(hr._handle, thickness);
+}
+/**
+ * Create an image flowable
+ */
+export function createImage(path) {
+    const handle = native.mp_image_create?.(path);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create image');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free an image
+ */
+export function freeImage(image) {
+    native.mp_image_free?.(image._handle);
+}
+/**
+ * Set image width
+ */
+export function setImageWidth(image, width) {
+    native.mp_image_set_width?.(image._handle, width);
+}
+/**
+ * Set image height
+ */
+export function setImageHeight(image, height) {
+    native.mp_image_set_height?.(image._handle, height);
+}
+/**
+ * Create a bullet list item
+ */
+export function createBulletListItem(text) {
+    const handle = native.mp_list_item_bullet?.(text);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create bullet list item');
+    }
+    return { _handle: handle };
+}
+/**
+ * Create a numbered list item
+ */
+export function createNumberedListItem(number, text) {
+    const handle = native.mp_list_item_numbered?.(number, text);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create numbered list item');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a list item
+ */
+export function freeListItem(item) {
+    native.mp_list_item_free?.(item._handle);
+}
+// ============================================================================
+// Tables
+// ============================================================================
+/**
+ * Create a table
+ */
+export function createTable(rows, cols) {
+    const handle = native.mp_table_create?.(rows, cols);
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create table');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a table
+ */
+export function freeTable(table) {
+    native.mp_table_free?.(table._handle);
+}
+/**
+ * Get table row count
+ */
+export function getTableRowCount(table) {
+    return native.mp_table_num_rows?.(table._handle) ?? 0;
+}
+/**
+ * Get table column count
+ */
+export function getTableColCount(table) {
+    return native.mp_table_num_cols?.(table._handle) ?? 0;
+}
+/**
+ * Create a table style
+ */
+export function createTableStyle() {
+    const handle = native.mp_table_style_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create table style');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a table style
+ */
+export function freeTableStyle(style) {
+    native.mp_table_style_free?.(style._handle);
+}
+/**
+ * Add grid to table style
+ */
+export function addTableGrid(style, weight, r, g, b) {
+    native.mp_table_style_add_grid?.(style._handle, weight, r, g, b);
+}
+/**
+ * Add background to table style
+ */
+export function addTableBackground(style, startCol, startRow, endCol, endRow, r, g, b) {
+    native.mp_table_style_add_background?.(style._handle, startCol, startRow, endCol, endRow, r, g, b);
+}
+// ============================================================================
+// Table of Contents
+// ============================================================================
+/**
+ * Create a table of contents
+ */
+export function createToc() {
+    const handle = native.mp_toc_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create table of contents');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a table of contents
+ */
+export function freeToc(toc) {
+    native.mp_toc_free?.(toc._handle);
+}
+/**
+ * Set TOC title
+ */
+export function setTocTitle(toc, title) {
+    native.mp_toc_set_title?.(toc._handle, title);
+}
+/**
+ * Add TOC entry
+ */
+export function addTocEntry(toc, title, level, page) {
+    native.mp_toc_add_entry?.(toc._handle, title, level, page);
+}
+/**
+ * Create a TOC builder
+ */
+export function createTocBuilder() {
+    const handle = native.mp_toc_builder_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create TOC builder');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a TOC builder
+ */
+export function freeTocBuilder(builder) {
+    native.mp_toc_builder_free?.(builder._handle);
+}
+/**
+ * Add heading to TOC builder
+ */
+export function addTocHeading(builder, title, level, page) {
+    native.mp_toc_builder_add_heading?.(builder._handle, title, level, page);
+}
+// ============================================================================
+// Story (Document Flow)
+// ============================================================================
+/**
+ * Create a story
+ */
+export function createStory() {
+    const handle = native.mp_story_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create story');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a story
+ */
+export function freeStory(story) {
+    native.mp_story_free?.(story._handle);
+}
+/**
+ * Get story length (number of flowables)
+ */
+export function getStoryLength(story) {
+    return native.mp_story_len?.(story._handle) ?? 0;
+}
+// ============================================================================
+// Stylesheets
+// ============================================================================
+/**
+ * Create a stylesheet
+ */
+export function createStyleSheet() {
+    const handle = native.mp_stylesheet_create?.();
+    if (!handle || handle === 0) {
+        throw new Error('Failed to create stylesheet');
+    }
+    return { _handle: handle };
+}
+/**
+ * Free a stylesheet
+ */
+export function freeStyleSheet(sheet) {
+    native.mp_stylesheet_free?.(sheet._handle);
+}
+/**
+ * Add style to stylesheet
+ */
+export function addStyleToSheet(sheet, style) {
+    native.mp_stylesheet_add_style?.(sheet._handle, style._handle);
+}
+// ============================================================================
+// PDF Validation & Repair
+// ============================================================================
+/**
+ * Validate a PDF
+ */
+export function validatePdf(pdfPath, mode = ValidationMode.Standard) {
+    const result = { valid: true, errors: [], warnings: [] };
+    const status = native.mp_validate_pdf?.(pdfPath, mode, result);
+    if (status !== 0) {
+        result.valid = false;
+    }
+    return result;
+}
+/**
+ * Quick validate a PDF (basic structure check)
+ */
+export function quickValidatePdf(pdfPath) {
+    return native.mp_quick_validate?.(pdfPath) === 0;
+}
+/**
+ * Repair a PDF
+ */
+export function repairPdf(inputPath, outputPath) {
+    const result = native.mp_repair_pdf?.(inputPath, outputPath);
+    if (result !== 0) {
+        throw new Error('Failed to repair PDF');
+    }
+}
+// ============================================================================
+// PDF Operations
+// ============================================================================
+/**
+ * Merge multiple PDFs
+ */
+export function mergePdfs(ctx, paths, outputPath) {
+    const result = native.npMergePDFs(ctx, paths, paths.length, outputPath);
+    if (result !== 0) {
+        throw new Error('Failed to merge PDFs');
+    }
+}
+/**
+ * Split a PDF into individual pages
+ */
+export function splitPdf(ctx, inputPath, outputDir) {
+    return native.npSplitPDF(ctx, inputPath, outputDir);
+}
+/**
+ * Optimize a PDF (compress, remove unused objects)
+ */
+export function optimizePdf(ctx, path) {
+    native.npOptimizePDF(ctx, path);
+}
+/**
+ * Linearize a PDF for fast web viewing
+ */
+export function linearizePdf(ctx, inputPath, outputPath) {
+    native.npLinearizePDF(ctx, inputPath, outputPath);
+}
+/**
+ * Add a blank page to a document
+ */
+export function addBlankPage(ctx, doc, width, height) {
+    return native.npAddBlankPage(ctx, doc, width, height);
+}
+/**
+ * Add a watermark to a document
+ */
+export function addWatermark(ctx, doc, text, fontSize, opacity) {
+    native.npAddWatermark(ctx, doc, text, fontSize, opacity);
+}
+/**
+ * Draw a line on a page
+ */
+export function drawLine(ctx, page, x0, y0, x1, y1, color, alpha, lineWidth) {
+    native.npDrawLine(ctx, page, x0, y0, x1, y1, color, alpha, lineWidth);
+}
+/**
+ * Draw a rectangle on a page
+ */
+export function drawRectangle(ctx, page, x, y, width, height, color, alpha, fill) {
+    native.npDrawRectangle(ctx, page, x, y, width, height, color, alpha, fill);
+}
+/**
+ * Draw a circle on a page
+ */
+export function drawCircle(ctx, page, x, y, radius, color, alpha, fill) {
+    native.npDrawCircle(ctx, page, x, y, radius, color, alpha, fill);
+}
+// ============================================================================
+// Memory Management
+// ============================================================================
+/**
+ * Free a string allocated by the native library
+ */
+export function freeString(s) {
+    native.mp_free_string?.(s);
 }
+// ============================================================================
+// Export all types and functions
+// ============================================================================
+export * from './native.js';
 //# sourceMappingURL=enhanced.js.map