@embedpdf/engines 2.4.0 → 2.5.0

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./lib/pdfium/index.cjs"),r=require("./lib/webworker/engine.cjs"),t=require("@embedpdf/models"),a=require("./direct-engine-Byh1BweU.cjs"),o=require("./lib/pdfium/web/worker-engine.cjs"),s=require("./browser-C6QEa8uk.cjs"),n=require("./pdf-engine-BXctylEz.cjs"),c="WebWorkerEngineRunner",i="Engine";exports.DEFAULT_PDFIUM_WASM_URL=e.DEFAULT_PDFIUM_WASM_URL,exports.FONT_CDN_URLS=e.FONT_CDN_URLS,exports.cdnFontConfig=e.cdnFontConfig,exports.createCdnFontConfig=e.createCdnFontConfig,exports.WebWorkerEngine=r.WebWorkerEngine,exports.WorkerTask=r.WorkerTask,Object.defineProperty(exports,"FontCharset",{enumerable:!0,get:()=>t.FontCharset}),exports.BitmapFormat=a.BitmapFormat,exports.FontFallbackManager=a.FontFallbackManager,exports.PdfiumErrorCode=a.PdfiumErrorCode,exports.PdfiumNative=a.PdfiumNative,exports.RenderFlag=a.RenderFlag,exports.computeFormDrawParams=a.computeFormDrawParams,exports.createNodeFontLoader=a.createNodeFontLoader,exports.createPdfiumDirectEngine=a.createPdfiumEngine,exports.isValidCustomKey=a.isValidCustomKey,exports.readArrayBuffer=a.readArrayBuffer,exports.readString=a.readString,exports.createPdfiumWorkerEngine=o.createPdfiumEngine,exports.ImageConverterError=s.ImageConverterError,exports.browserImageDataToBlobConverter=s.browserImageDataToBlobConverter,exports.createHybridImageConverter=s.createHybridImageConverter,exports.createWorkerPoolImageConverter=s.createWorkerPoolImageConverter,exports.PdfEngine=n.PdfEngine,exports.EngineRunner=class{constructor(e=new t.NoopLogger){this.logger=e,this.execute=async e=>{if(this.logger.debug(c,i,"runner start exeucte request"),!this.engine){const r={type:"reject",reason:{code:t.PdfErrorCode.NotReady,message:"engine has not started yet"}},a={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};return void this.respond(a)}const r=this.engine,{name:a,args:o}=e.data;if(!r[a]){const r={type:"reject",reason:{code:t.PdfErrorCode.NotSupport,message:`engine method ${a} is not supported yet`}},o={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};return void this.respond(o)}let s;switch(a){case"isSupport":s=r.isSupport(...o);break;case"destroy":s=r.destroy(...o);break;case"openDocumentUrl":s=r.openDocumentUrl(...o);break;case"openDocumentBuffer":s=r.openDocumentBuffer(...o);break;case"getDocPermissions":s=r.getDocPermissions(...o);break;case"getDocUserPermissions":s=r.getDocUserPermissions(...o);break;case"getMetadata":s=r.getMetadata(...o);break;case"setMetadata":s=r.setMetadata(...o);break;case"getBookmarks":s=r.getBookmarks(...o);break;case"setBookmarks":s=r.setBookmarks(...o);break;case"deleteBookmarks":s=r.deleteBookmarks(...o);break;case"getSignatures":s=r.getSignatures(...o);break;case"renderPage":s=r.renderPage(...o);break;case"renderPageRect":s=r.renderPageRect(...o);break;case"renderPageAnnotation":s=r.renderPageAnnotation(...o);break;case"renderThumbnail":s=r.renderThumbnail(...o);break;case"getAllAnnotations":s=r.getAllAnnotations(...o);break;case"getPageAnnotations":s=r.getPageAnnotations(...o);break;case"createPageAnnotation":s=r.createPageAnnotation(...o);break;case"updatePageAnnotation":s=r.updatePageAnnotation(...o);break;case"removePageAnnotation":s=r.removePageAnnotation(...o);break;case"getPageTextRects":s=r.getPageTextRects(...o);break;case"searchAllPages":s=r.searchAllPages(...o);break;case"closeDocument":s=r.closeDocument(...o);break;case"closeAllDocuments":s=r.closeAllDocuments(...o);break;case"saveAsCopy":s=r.saveAsCopy(...o);break;case"getAttachments":s=r.getAttachments(...o);break;case"addAttachment":s=r.addAttachment(...o);break;case"removeAttachment":s=r.removeAttachment(...o);break;case"readAttachmentContent":s=r.readAttachmentContent(...o);break;case"setFormFieldValue":s=r.setFormFieldValue(...o);break;case"flattenPage":s=r.flattenPage(...o);break;case"extractPages":s=r.extractPages(...o);break;case"extractText":s=r.extractText(...o);break;case"redactTextInRects":s=r.redactTextInRects(...o);break;case"applyRedaction":s=r.applyRedaction(...o);break;case"applyAllRedactions":s=r.applyAllRedactions(...o);break;case"flattenAnnotation":s=r.flattenAnnotation(...o);break;case"getTextSlices":s=r.getTextSlices(...o);break;case"getPageGlyphs":s=r.getPageGlyphs(...o);break;case"getPageGeometry":s=r.getPageGeometry(...o);break;case"merge":s=r.merge(...o);break;case"mergePages":s=r.mergePages(...o);break;case"preparePrintDocument":s=r.preparePrintDocument(...o);break;case"setDocumentEncryption":s=r.setDocumentEncryption(...o);break;case"removeEncryption":s=r.removeEncryption(...o);break;case"unlockOwnerPermissions":s=r.unlockOwnerPermissions(...o);break;case"isEncrypted":s=r.isEncrypted(...o);break;case"isOwnerUnlocked":s=r.isOwnerUnlocked(...o);break;default:const n={type:"reject",reason:{code:t.PdfErrorCode.NotSupport,message:`engine method ${a} is not supported`}},c={id:e.id,type:"ExecuteResponse",data:{type:"error",value:n}};return void this.respond(c)}s.onProgress(r=>{const t={id:e.id,type:"ExecuteProgress",data:r};this.respond(t)}),s.wait(r=>{const t={id:e.id,type:"ExecuteResponse",data:{type:"result",value:r}};this.respond(t)},r=>{const t={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};this.respond(t)})}}listen(){self.onmessage=e=>this.handle(e)}handle(e){this.logger.debug(c,i,"webworker receive message event: ",e.data);try{const r=e.data;if("ExecuteRequest"===r.type)this.execute(r)}catch(r){this.logger.info(c,i,"webworker met error when processing message event:",r)}}ready(){this.listen(),this.respond({id:"0",type:"ReadyResponse"}),this.logger.debug(c,i,"runner is ready")}respond(e){this.logger.debug(c,i,"runner respond: ",e),self.postMessage(e)}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./lib/pdfium/index.cjs"),r=require("./lib/webworker/engine.cjs"),t=require("@embedpdf/models"),a=require("./direct-engine-BtiOvMLP.cjs"),o=require("./lib/pdfium/web/worker-engine.cjs"),s=require("./browser-13mzox-R.cjs"),n=require("./pdf-engine-BmrecQLq.cjs"),c="WebWorkerEngineRunner",i="Engine";exports.DEFAULT_PDFIUM_WASM_URL=e.DEFAULT_PDFIUM_WASM_URL,exports.FONT_CDN_URLS=e.FONT_CDN_URLS,exports.cdnFontConfig=e.cdnFontConfig,exports.createCdnFontConfig=e.createCdnFontConfig,exports.WebWorkerEngine=r.WebWorkerEngine,exports.WorkerTask=r.WorkerTask,Object.defineProperty(exports,"FontCharset",{enumerable:!0,get:()=>t.FontCharset}),exports.BitmapFormat=a.BitmapFormat,exports.FontFallbackManager=a.FontFallbackManager,exports.PdfiumErrorCode=a.PdfiumErrorCode,exports.PdfiumNative=a.PdfiumNative,exports.RenderFlag=a.RenderFlag,exports.computeFormDrawParams=a.computeFormDrawParams,exports.createNodeFontLoader=a.createNodeFontLoader,exports.createPdfiumDirectEngine=a.createPdfiumEngine,exports.isValidCustomKey=a.isValidCustomKey,exports.readArrayBuffer=a.readArrayBuffer,exports.readString=a.readString,exports.createPdfiumWorkerEngine=o.createPdfiumEngine,exports.ImageConverterError=s.ImageConverterError,exports.browserImageDataToBlobConverter=s.browserImageDataToBlobConverter,exports.createHybridImageConverter=s.createHybridImageConverter,exports.createWorkerPoolImageConverter=s.createWorkerPoolImageConverter,exports.PdfEngine=n.PdfEngine,exports.EngineRunner=class{constructor(e=new t.NoopLogger){this.logger=e,this.execute=async e=>{if(this.logger.debug(c,i,"runner start exeucte request"),!this.engine){const r={type:"reject",reason:{code:t.PdfErrorCode.NotReady,message:"engine has not started yet"}},a={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};return void this.respond(a)}const r=this.engine,{name:a,args:o}=e.data;if(!r[a]){const r={type:"reject",reason:{code:t.PdfErrorCode.NotSupport,message:`engine method ${a} is not supported yet`}},o={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};return void this.respond(o)}let s;switch(a){case"isSupport":s=r.isSupport(...o);break;case"destroy":s=r.destroy(...o);break;case"openDocumentUrl":s=r.openDocumentUrl(...o);break;case"openDocumentBuffer":s=r.openDocumentBuffer(...o);break;case"getDocPermissions":s=r.getDocPermissions(...o);break;case"getDocUserPermissions":s=r.getDocUserPermissions(...o);break;case"getMetadata":s=r.getMetadata(...o);break;case"setMetadata":s=r.setMetadata(...o);break;case"getBookmarks":s=r.getBookmarks(...o);break;case"setBookmarks":s=r.setBookmarks(...o);break;case"deleteBookmarks":s=r.deleteBookmarks(...o);break;case"getSignatures":s=r.getSignatures(...o);break;case"renderPage":s=r.renderPage(...o);break;case"renderPageRect":s=r.renderPageRect(...o);break;case"renderPageAnnotation":s=r.renderPageAnnotation(...o);break;case"renderThumbnail":s=r.renderThumbnail(...o);break;case"getAllAnnotations":s=r.getAllAnnotations(...o);break;case"getPageAnnotations":s=r.getPageAnnotations(...o);break;case"createPageAnnotation":s=r.createPageAnnotation(...o);break;case"updatePageAnnotation":s=r.updatePageAnnotation(...o);break;case"removePageAnnotation":s=r.removePageAnnotation(...o);break;case"getPageTextRects":s=r.getPageTextRects(...o);break;case"searchAllPages":s=r.searchAllPages(...o);break;case"closeDocument":s=r.closeDocument(...o);break;case"closeAllDocuments":s=r.closeAllDocuments(...o);break;case"saveAsCopy":s=r.saveAsCopy(...o);break;case"getAttachments":s=r.getAttachments(...o);break;case"addAttachment":s=r.addAttachment(...o);break;case"removeAttachment":s=r.removeAttachment(...o);break;case"readAttachmentContent":s=r.readAttachmentContent(...o);break;case"setFormFieldValue":s=r.setFormFieldValue(...o);break;case"flattenPage":s=r.flattenPage(...o);break;case"extractPages":s=r.extractPages(...o);break;case"extractText":s=r.extractText(...o);break;case"redactTextInRects":s=r.redactTextInRects(...o);break;case"applyRedaction":s=r.applyRedaction(...o);break;case"applyAllRedactions":s=r.applyAllRedactions(...o);break;case"flattenAnnotation":s=r.flattenAnnotation(...o);break;case"getTextSlices":s=r.getTextSlices(...o);break;case"getPageGlyphs":s=r.getPageGlyphs(...o);break;case"getPageGeometry":s=r.getPageGeometry(...o);break;case"merge":s=r.merge(...o);break;case"mergePages":s=r.mergePages(...o);break;case"preparePrintDocument":s=r.preparePrintDocument(...o);break;case"setDocumentEncryption":s=r.setDocumentEncryption(...o);break;case"removeEncryption":s=r.removeEncryption(...o);break;case"unlockOwnerPermissions":s=r.unlockOwnerPermissions(...o);break;case"isEncrypted":s=r.isEncrypted(...o);break;case"isOwnerUnlocked":s=r.isOwnerUnlocked(...o);break;default:const n={type:"reject",reason:{code:t.PdfErrorCode.NotSupport,message:`engine method ${a} is not supported`}},c={id:e.id,type:"ExecuteResponse",data:{type:"error",value:n}};return void this.respond(c)}s.onProgress(r=>{const t={id:e.id,type:"ExecuteProgress",data:r};this.respond(t)}),s.wait(r=>{const t={id:e.id,type:"ExecuteResponse",data:{type:"result",value:r}};this.respond(t)},r=>{const t={id:e.id,type:"ExecuteResponse",data:{type:"error",value:r}};this.respond(t)})}}listen(){self.onmessage=e=>this.handle(e)}handle(e){this.logger.debug(c,i,"webworker receive message event: ",e.data);try{const r=e.data;if("ExecuteRequest"===r.type)this.execute(r)}catch(r){this.logger.info(c,i,"webworker met error when processing message event:",r)}}ready(){this.listen(),this.respond({id:"0",type:"ReadyResponse"}),this.logger.debug(c,i,"runner is ready")}respond(e){this.logger.debug(c,i,"runner respond: ",e),self.postMessage(e)}};
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -2,10 +2,10 @@ import { DEFAULT_PDFIUM_WASM_URL, FONT_CDN_URLS, cdnFontConfig, createCdnFontCon
 import { WebWorkerEngine, WorkerTask } from "./lib/webworker/engine.js";
 import { NoopLogger, PdfErrorCode } from "@embedpdf/models";
 import { FontCharset } from "@embedpdf/models";
-import { B, F, P, a, R, d, e, c, i, b, r } from "./direct-engine-6BoAmGsC.js";
+import { B, F, P, a, R, d, e, c, i, b, r } from "./direct-engine-D8HGqcIt.js";
 import { createPdfiumEngine } from "./lib/pdfium/web/worker-engine.js";
-import { I, b as b2, a as a2, c as c2 } from "./browser-awZxztMA.js";
-import { P as P2 } from "./pdf-engine-D_Dua_6w.js";
+import { I, b as b2, a as a2, c as c2 } from "./browser-qfUHZxQ6.js";
+import { P as P2 } from "./pdf-engine-aJNoNMbt.js";
 const LOG_SOURCE = "WebWorkerEngineRunner";
 const LOG_CATEGORY = "Engine";
 class EngineRunner {

package/dist/lib/converters/browser.d.ts

@@ -17,7 +17,7 @@ export declare const browserImageDataToBlobConverter: ImageDataConverter<Blob>;
  * This is the preferred approach for performance
  *
  * @param workerPool - Instance of ImageEncoderWorkerPool
- * @returns ImageDataConverter function
+ * @returns ImageDataConverter function with destroy() for cleanup
  */
 export declare function createWorkerPoolImageConverter(workerPool: ImageEncoderWorkerPool): ImageDataConverter<Blob>;
 /**
@@ -28,6 +28,6 @@ export declare function createWorkerPoolImageConverter(workerPool: ImageEncoderW
  * - Fallback: Main-thread Canvas for older browsers without OffscreenCanvas in workers
  *
  * @param workerPool - Instance of ImageEncoderWorkerPool
- * @returns ImageDataConverter function
+ * @returns ImageDataConverter function with destroy() for cleanup
  */
 export declare function createHybridImageConverter(workerPool: ImageEncoderWorkerPool): ImageDataConverter<Blob>;

package/dist/lib/converters/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../browser-C6QEa8uk.cjs");function r(e){const{buffer:r,byteOffset:t,byteLength:a}=e;if(r instanceof ArrayBuffer)return r.slice(t,t+a);const o=new ArrayBuffer(a);return new Uint8Array(o).set(new Uint8Array(r,t,a)),o}exports.ImageConverterError=e.ImageConverterError,exports.browserImageDataToBlobConverter=e.browserImageDataToBlobConverter,exports.createHybridImageConverter=e.createHybridImageConverter,exports.createWorkerPoolImageConverter=e.createWorkerPoolImageConverter,exports.createCustomImageDataToBlobConverter=function(e){return async(t,a="image/webp",o)=>{const n=t(),i=await e(n,a,o);return new Blob([r(i)],{type:a})}},exports.createCustomImageDataToBufferConverter=function(e){return async(r,t="image/webp",a)=>{const o=r();return await e(o,t,a)}},exports.createNodeCanvasImageDataToBlobConverter=function(e){return async(r,t="image/webp",a)=>{const o=r(),{width:n,height:i}=o,g=e(n,i);let s;switch(g.getContext("2d").putImageData(o,0,0),t){case"image/webp":s=g.toBuffer("image/webp");break;case"image/png":s=g.toBuffer("image/png");break;case"image/jpeg":s=g.toBuffer("image/jpeg");break;default:throw new Error(`Unsupported image type: ${t}`)}return s}},exports.createNodeImageDataToBufferConverter=function(e){return async(r,t="image/webp",a)=>{const o=r(),{width:n,height:i,data:g}=o;let s,u=e(Buffer.from(g),{raw:{width:n,height:i,channels:4}});switch(t){case"image/webp":s=await u.webp({quality:a}).toBuffer();break;case"image/png":s=await u.png().toBuffer();break;case"image/jpeg":s=await u.flatten({background:{r:255,g:255,b:255}}).jpeg({quality:a}).toBuffer();break;default:throw new Error(`Unsupported image type: ${t}`)}return s}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../browser-13mzox-R.cjs");function r(e){const{buffer:r,byteOffset:t,byteLength:a}=e;if(r instanceof ArrayBuffer)return r.slice(t,t+a);const o=new ArrayBuffer(a);return new Uint8Array(o).set(new Uint8Array(r,t,a)),o}exports.ImageConverterError=e.ImageConverterError,exports.browserImageDataToBlobConverter=e.browserImageDataToBlobConverter,exports.createHybridImageConverter=e.createHybridImageConverter,exports.createWorkerPoolImageConverter=e.createWorkerPoolImageConverter,exports.createCustomImageDataToBlobConverter=function(e){return async(t,a="image/webp",o)=>{const n=t(),i=await e(n,a,o);return new Blob([r(i)],{type:a})}},exports.createCustomImageDataToBufferConverter=function(e){return async(r,t="image/webp",a)=>{const o=r();return await e(o,t,a)}},exports.createNodeCanvasImageDataToBlobConverter=function(e){return async(r,t="image/webp",a)=>{const o=r(),{width:n,height:i}=o,g=e(n,i);let s;switch(g.getContext("2d").putImageData(o,0,0),t){case"image/webp":s=g.toBuffer("image/webp");break;case"image/png":s=g.toBuffer("image/png");break;case"image/jpeg":s=g.toBuffer("image/jpeg");break;default:throw new Error(`Unsupported image type: ${t}`)}return s}},exports.createNodeImageDataToBufferConverter=function(e){return async(r,t="image/webp",a)=>{const o=r(),{width:n,height:i,data:g}=o;let s,u=e(Buffer.from(g),{raw:{width:n,height:i,channels:4}});switch(t){case"image/webp":s=await u.webp({quality:a}).toBuffer();break;case"image/png":s=await u.png().toBuffer();break;case"image/jpeg":s=await u.flatten({background:{r:255,g:255,b:255}}).jpeg({quality:a}).toBuffer();break;default:throw new Error(`Unsupported image type: ${t}`)}return s}};
 //# sourceMappingURL=index.cjs.map

package/dist/lib/converters/index.js

@@ -1,4 +1,4 @@
-import { I, b, a, c } from "../../browser-awZxztMA.js";
+import { I, b, a, c } from "../../browser-qfUHZxQ6.js";
 function toArrayBuffer(view) {
   const { buffer, byteOffset, byteLength } = view;
   if (buffer instanceof ArrayBuffer) {

package/dist/lib/converters/types.d.ts

@@ -5,8 +5,18 @@ export type { ImageConversionTypes } from '@embedpdf/models';
  */
 export type LazyImageData = () => PdfImage;
 /**
- * Function type for converting ImageData to Blob or other format
+ * Callable interface for converting ImageData to Blob or other format.
  * In browser: uses OffscreenCanvas
  * In Node.js: can use Sharp or other image processing libraries
+ *
+ * The optional `destroy()` method allows converters with resources (like worker pools)
+ * to clean up when the engine is destroyed.
  */
-export type ImageDataConverter<T = Blob> = (getImageData: LazyImageData, imageType?: ImageConversionTypes, imageQuality?: number) => Promise<T>;
+export interface ImageDataConverter<T = Blob> {
+    (getImageData: LazyImageData, imageType?: ImageConversionTypes, imageQuality?: number): Promise<T>;
+    /**
+     * Optional cleanup method. Called when PdfEngine.destroy() is invoked.
+     * Converters with resources (e.g., worker pools) should implement this to release them.
+     */
+    destroy?: () => void;
+}

package/dist/lib/pdfium/cache.d.ts

@@ -5,6 +5,13 @@ export interface CacheConfig {
     pageTtl?: number;
     /** Maximum number of pages to keep in cache per document (default: 50) */
     maxPagesPerDocument?: number;
+    /**
+     * When true, pages are loaded with normalized rotation:
+     * - All coordinates (annotations, text, rendering) are in 0° space
+     * - The original rotation is preserved for reference
+     * @default false
+     */
+    normalizeRotation?: boolean;
 }
 export declare class PdfCache {
     private readonly pdfium;
@@ -13,7 +20,7 @@ export declare class PdfCache {
     private readonly config;
     constructor(pdfium: WrappedPdfiumModule, memoryManager: MemoryManager, config?: CacheConfig);
     /** Open (or re-use) a document */
-    setDocument(id: string, filePtr: number, docPtr: number): void;
+    setDocument(id: string, filePtr: number, docPtr: number, normalizeRotation?: boolean): void;
     /** Retrieve the DocumentContext for a given PdfDocumentObject */
     getContext(docId: string): DocumentContext | undefined;
     /** Close & fully release a document and all its pages */
@@ -34,6 +41,7 @@ export declare class DocumentContext {
     readonly docPtr: number;
     private readonly memoryManager;
     private readonly pageCache;
+    readonly normalizeRotation: boolean;
     constructor(filePtr: number, docPtr: number, pdfium: WrappedPdfiumModule, memoryManager: MemoryManager, config: Required<CacheConfig>);
     /** Main accessor for pages */
     acquirePage(pageIdx: number): PageContext;

package/dist/lib/pdfium/engine.d.ts

@@ -428,7 +428,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      *
      * @private
      */
-    addTextMarkupContent(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfHighlightAnnoObject | PdfUnderlineAnnoObject | PdfStrikeOutAnnoObject | PdfSquigglyAnnoObject): boolean;
+    addTextMarkupContent(doc: PdfDocumentObject, page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfHighlightAnnoObject | PdfUnderlineAnnoObject | PdfStrikeOutAnnoObject | PdfSquigglyAnnoObject): boolean;
     /**
      * Add content to redact annotation
      * @param page - page info
@@ -442,6 +442,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private addRedactContent;
     /**
      * Add contents to stamp annotation
+     * @param doc - pdf document object
      * @param docPtr - pointer to pdf document object
      * @param page - page info
      * @param pagePtr - pointer to page object
@@ -452,9 +453,10 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      *
      * @private
      */
-    addStampContent(docPtr: number, page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfStampAnnoObject, imageData?: ImageData): boolean;
+    addStampContent(doc: PdfDocumentObject, docPtr: number, page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfStampAnnoObject, imageData?: ImageData): boolean;
     /**
      * Add image object to annotation
+     * @param doc - pdf document object
      * @param docPtr - pointer to pdf document object
      * @param page - page info
      * @param pagePtr - pointer to page object
@@ -465,7 +467,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      *
      * @private
      */
-    addImageObject(docPtr: number, page: PdfPageObject, pagePtr: number, annotationPtr: number, rect: Rect, imageData: ImageData): boolean;
+    addImageObject(doc: PdfDocumentObject, docPtr: number, page: PdfPageObject, pagePtr: number, annotationPtr: number, rect: Rect, imageData: ImageData): boolean;
     /**
      * Save document to array buffer
      * @param docPtr - pointer to pdf document
@@ -622,6 +624,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Read page annotations
      *
+     * @param doc - pdf document object
      * @param ctx - document context
      * @param page - page info
      * @returns annotations on the pdf page
@@ -632,6 +635,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Read page annotations without loading the page (raw approach)
      *
+     * @param doc - pdf document object
      * @param ctx - document context
      * @param page - page info
      * @returns annotations on the pdf page
@@ -652,6 +656,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Read pdf annotation from pdf document
      *
+     * @param doc - pdf document object
      * @param docPtr - pointer to pdf document
      * @param page - page info
      * @param annotationPtr - pointer to pdf annotation
@@ -951,6 +956,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private setLineEndings;
     /**
      * Get the start and end points of a LINE / POLYLINE annot.
+     * @param doc - pdf document object
      * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
      * @param page - logical page info object (`PdfPageObject`)
      * @returns `{ start, end }` or `undefined` when PDFium can't read them
@@ -959,6 +965,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Set the two end‑points of a **Line** annotation
      * by writing a new /L array `[ x1 y1 x2 y2 ]`.
+     * @param doc - pdf document object
      * @param page - logical page info object (`PdfPageObject`)
      * @param annotPtr - pointer to the annotation whose line points are needed
      * @param start - start point
@@ -975,6 +982,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      * This preserves the true shape for rotated / skewed text, whereas callers
      * that only need axis-aligned boxes can collapse each quad themselves.
      *
+     * @param doc           - pdf document object
      * @param page          - logical page info object (`PdfPageObject`)
      * @param annotationPtr - pointer to the annotation whose quads are needed
      * @returns Array of `Rect` objects (`[]` if the annotation has no quads)
@@ -985,6 +993,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Set the quadrilaterals for a **Highlight / Underline / StrikeOut / Squiggly** markup annotation.
      *
+     * @param doc           - pdf document object
      * @param page          - logical page info object (`PdfPageObject`)
      * @param annotationPtr - pointer to the annotation whose quads are needed
      * @param rects         - array of `Rect` objects (`[]` if the annotation has no quads)
@@ -1034,6 +1043,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private allocFSQuadsBufferFromRects;
     /**
      * Read ink list from annotation
+     * @param doc - pdf document object
      * @param page  - logical page info object (`PdfPageObject`)
      * @param pagePtr - pointer to the page
      * @param annotationPtr - pointer to the annotation whose ink list is needed
@@ -1042,6 +1052,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private getInkList;
     /**
      * Add ink list to annotation
+     * @param doc - pdf document object
      * @param page  - logical page info object (`PdfPageObject`)
      * @param pagePtr - pointer to the page
      * @param annotationPtr - pointer to the annotation whose ink list is needed
@@ -1453,6 +1464,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private setAttachmentString;
     /**
      * Read vertices of pdf annotation
+     * @param doc - pdf document object
      * @param page  - pdf page infor
      * @param annotationPtr - pointer to pdf annotation
      * @returns vertices of pdf annotation
@@ -1463,6 +1475,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     /**
      * Sync the vertices of a polygon or polyline annotation.
      *
+     * @param doc - pdf document object
      * @param page  - pdf page infor
      * @param annotPtr - pointer to pdf annotation
      * @param vertices - the vertices to be set
@@ -1548,6 +1561,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private readPdfAttachment;
     /**
      * Convert coordinate of point from device coordinate to page coordinate
+     * @param doc - pdf document object
      * @param page  - pdf page infor
      * @param position - position of point
      * @returns converted position
@@ -1557,6 +1571,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private convertDevicePointToPagePoint;
     /**
      * Convert coordinate of point from page coordinate to device coordinate
+     * @param doc - pdf document object
      * @param page  - pdf page infor
      * @param position - position of point
      * @returns converted position
@@ -1566,6 +1581,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private convertPagePointToDevicePoint;
     /**
      * Convert coordinate of rectangle from page coordinate to device coordinate
+     * @param doc - pdf document object
      * @param page  - pdf page infor
      * @param pagePtr - pointer to pdf page object
      * @param pageRect - rectangle that needs to be converted
@@ -1604,6 +1620,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private setPageAnnoAppearanceStream;
     /**
      * Set the rect of specified annotation
+     * @param doc - pdf document object
      * @param page - page info that the annotation is belonged to
      * @param annotationPtr - pointer to annotation object
      * @param rect - target rectangle
@@ -1622,6 +1639,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
     private readPageAnnoRect;
     /**
      * Get highlight rects for a specific character range (for search highlighting)
+     * @param doc - pdf document object
      * @param page - pdf page info
      * @param pagePtr - pointer to pdf page
      * @param textPagePtr - pointer to pdf text page

package/dist/lib/pdfium/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../direct-engine-Byh1BweU.cjs"),t=require("../../browser-C6QEa8uk.cjs"),r=require("../../pdf-engine-BXctylEz.cjs"),n=require("@embedpdf/models"),o=require("@embedpdf/fonts-jp"),s=require("@embedpdf/fonts-kr"),a=require("@embedpdf/fonts-sc"),d=require("@embedpdf/fonts-tc"),i=require("@embedpdf/fonts-arabic"),f=require("@embedpdf/fonts-hebrew"),p=require("@embedpdf/fonts-latin"),m=require("./web/worker-engine.cjs");function c(e="latest"){return{jp:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-jp@${e}/fonts`,kr:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-kr@${e}/fonts`,sc:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-sc@${e}/fonts`,tc:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-tc@${e}/fonts`,arabic:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-arabic@${e}/fonts`,hebrew:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-hebrew@${e}/fonts`,latin:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-latin@${e}/fonts`}}function u(e,t){return e.map(e=>({url:`${t}/${e.file}`,weight:e.weight,italic:e.italic}))}function b(e){return{fonts:{[n.FontCharset.SHIFTJIS]:u(o.fonts,e.jp),[n.FontCharset.HANGEUL]:u(s.fonts,e.kr),[n.FontCharset.GB2312]:u(a.fonts,e.sc),[n.FontCharset.CHINESEBIG5]:u(d.fonts,e.tc),[n.FontCharset.ARABIC]:u(i.fonts,e.arabic),[n.FontCharset.HEBREW]:u(f.fonts,e.hebrew),[n.FontCharset.CYRILLIC]:u(p.fonts,e.latin),[n.FontCharset.GREEK]:u(p.fonts,e.latin),[n.FontCharset.VIETNAMESE]:u(p.fonts,e.latin)}}}const l=c("latest"),C=b(l);exports.BitmapFormat=e.BitmapFormat,exports.FontFallbackManager=e.FontFallbackManager,exports.PdfiumErrorCode=e.PdfiumErrorCode,exports.PdfiumNative=e.PdfiumNative,exports.RenderFlag=e.RenderFlag,exports.computeFormDrawParams=e.computeFormDrawParams,exports.createNodeFontLoader=e.createNodeFontLoader,exports.createPdfiumDirectEngine=e.createPdfiumEngine,exports.isValidCustomKey=e.isValidCustomKey,exports.readArrayBuffer=e.readArrayBuffer,exports.readString=e.readString,exports.ImageConverterError=t.ImageConverterError,exports.browserImageDataToBlobConverter=t.browserImageDataToBlobConverter,exports.createHybridImageConverter=t.createHybridImageConverter,exports.createWorkerPoolImageConverter=t.createWorkerPoolImageConverter,exports.PdfEngine=r.PdfEngine,Object.defineProperty(exports,"FontCharset",{enumerable:!0,get:()=>n.FontCharset}),exports.createPdfiumWorkerEngine=m.createPdfiumEngine,exports.DEFAULT_PDFIUM_WASM_URL="https://cdn.jsdelivr.net/npm/@embedpdf/pdfium@2.4.0/dist/pdfium.wasm",exports.FONT_CDN_URLS=l,exports.cdnFontConfig=C,exports.createCdnFontConfig=function(e="latest"){return b(c(e))};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../direct-engine-BtiOvMLP.cjs"),t=require("../../browser-13mzox-R.cjs"),r=require("../../pdf-engine-BmrecQLq.cjs"),n=require("@embedpdf/models"),o=require("@embedpdf/fonts-jp"),s=require("@embedpdf/fonts-kr"),a=require("@embedpdf/fonts-sc"),d=require("@embedpdf/fonts-tc"),i=require("@embedpdf/fonts-arabic"),f=require("@embedpdf/fonts-hebrew"),p=require("@embedpdf/fonts-latin"),m=require("./web/worker-engine.cjs");function c(e="latest"){return{jp:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-jp@${e}/fonts`,kr:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-kr@${e}/fonts`,sc:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-sc@${e}/fonts`,tc:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-tc@${e}/fonts`,arabic:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-arabic@${e}/fonts`,hebrew:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-hebrew@${e}/fonts`,latin:`https://cdn.jsdelivr.net/npm/@embedpdf/fonts-latin@${e}/fonts`}}function u(e,t){return e.map(e=>({url:`${t}/${e.file}`,weight:e.weight,italic:e.italic}))}function b(e){return{fonts:{[n.FontCharset.SHIFTJIS]:u(o.fonts,e.jp),[n.FontCharset.HANGEUL]:u(s.fonts,e.kr),[n.FontCharset.GB2312]:u(a.fonts,e.sc),[n.FontCharset.CHINESEBIG5]:u(d.fonts,e.tc),[n.FontCharset.ARABIC]:u(i.fonts,e.arabic),[n.FontCharset.HEBREW]:u(f.fonts,e.hebrew),[n.FontCharset.CYRILLIC]:u(p.fonts,e.latin),[n.FontCharset.GREEK]:u(p.fonts,e.latin),[n.FontCharset.VIETNAMESE]:u(p.fonts,e.latin)}}}const l=c("latest"),C=b(l);exports.BitmapFormat=e.BitmapFormat,exports.FontFallbackManager=e.FontFallbackManager,exports.PdfiumErrorCode=e.PdfiumErrorCode,exports.PdfiumNative=e.PdfiumNative,exports.RenderFlag=e.RenderFlag,exports.computeFormDrawParams=e.computeFormDrawParams,exports.createNodeFontLoader=e.createNodeFontLoader,exports.createPdfiumDirectEngine=e.createPdfiumEngine,exports.isValidCustomKey=e.isValidCustomKey,exports.readArrayBuffer=e.readArrayBuffer,exports.readString=e.readString,exports.ImageConverterError=t.ImageConverterError,exports.browserImageDataToBlobConverter=t.browserImageDataToBlobConverter,exports.createHybridImageConverter=t.createHybridImageConverter,exports.createWorkerPoolImageConverter=t.createWorkerPoolImageConverter,exports.PdfEngine=r.PdfEngine,Object.defineProperty(exports,"FontCharset",{enumerable:!0,get:()=>n.FontCharset}),exports.createPdfiumWorkerEngine=m.createPdfiumEngine,exports.DEFAULT_PDFIUM_WASM_URL="https://cdn.jsdelivr.net/npm/@embedpdf/pdfium@2.5.0/dist/pdfium.wasm",exports.FONT_CDN_URLS=l,exports.cdnFontConfig=C,exports.createCdnFontConfig=function(e="latest"){return b(c(e))};
 //# sourceMappingURL=index.cjs.map

package/dist/lib/pdfium/index.js

@@ -1,6 +1,6 @@
-import { B, F, P, a, R, d, e, c, i, b, r } from "../../direct-engine-6BoAmGsC.js";
-import { I, b as b2, a as a2, c as c2 } from "../../browser-awZxztMA.js";
-import { P as P2 } from "../../pdf-engine-D_Dua_6w.js";
+import { B, F, P, a, R, d, e, c, i, b, r } from "../../direct-engine-D8HGqcIt.js";
+import { I, b as b2, a as a2, c as c2 } from "../../browser-qfUHZxQ6.js";
+import { P as P2 } from "../../pdf-engine-aJNoNMbt.js";
 import { FontCharset } from "@embedpdf/models";
 import { FontCharset as FontCharset2 } from "@embedpdf/models";
 import { fonts as fonts$6 } from "@embedpdf/fonts-jp";
@@ -49,7 +49,7 @@ const cdnFontConfig = buildCdnFontConfig(FONT_CDN_URLS);
 function createCdnFontConfig(version = "latest") {
   return buildCdnFontConfig(buildCdnUrls(version));
 }
-const DEFAULT_PDFIUM_WASM_URL = "https://cdn.jsdelivr.net/npm/@embedpdf/pdfium@2.4.0/dist/pdfium.wasm";
+const DEFAULT_PDFIUM_WASM_URL = "https://cdn.jsdelivr.net/npm/@embedpdf/pdfium@2.5.0/dist/pdfium.wasm";
 export {
   B as BitmapFormat,
   DEFAULT_PDFIUM_WASM_URL,

package/dist/lib/pdfium/web/direct-engine.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),require("@embedpdf/pdfium");const e=require("../../../direct-engine-Byh1BweU.cjs");require("../../../pdf-engine-BXctylEz.cjs"),require("../../../browser-C6QEa8uk.cjs"),exports.createPdfiumEngine=e.createPdfiumEngine;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),require("@embedpdf/pdfium");const e=require("../../../direct-engine-BtiOvMLP.cjs");require("../../../pdf-engine-BmrecQLq.cjs"),require("../../../browser-13mzox-R.cjs"),exports.createPdfiumEngine=e.createPdfiumEngine;
 //# sourceMappingURL=direct-engine.cjs.map

package/dist/lib/pdfium/web/direct-engine.js

@@ -1,7 +1,7 @@
 import "@embedpdf/pdfium";
-import { c } from "../../../direct-engine-6BoAmGsC.js";
-import "../../../pdf-engine-D_Dua_6w.js";
-import "../../../browser-awZxztMA.js";
+import { c } from "../../../direct-engine-D8HGqcIt.js";
+import "../../../pdf-engine-aJNoNMbt.js";
+import "../../../browser-qfUHZxQ6.js";
 export {
   c as createPdfiumEngine
 };