@embedpdf/engines 2.4.1 → 2.6.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-DnHo6z8a.cjs"),o=require("./lib/pdfium/web/worker-engine.cjs"),s=require("./browser-13mzox-R.cjs"),n=require("./pdf-engine-B4lt8-5f.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-DITdlET4.cjs"),o=require("./browser-13mzox-R.cjs"),s=require("./pdf-engine-BmrecQLq.cjs"),n=require("./lib/pdfium/web/worker-engine.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.ImageConverterError=o.ImageConverterError,exports.browserImageDataToBlobConverter=o.browserImageDataToBlobConverter,exports.createHybridImageConverter=o.createHybridImageConverter,exports.createWorkerPoolImageConverter=o.createWorkerPoolImageConverter,exports.PdfEngine=s.PdfEngine,exports.createPdfiumWorkerEngine=n.createPdfiumEngine,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-5RWKENek.js";
+import { B, F, P, a, R, c, b, d, i, r, e } from "./direct-engine-CvfzIn2D.js";
+import { I, b as b2, c as c2, a as a2 } from "./browser-BISJ9naB.js";
+import { P as P2 } from "./pdf-engine-aJNoNMbt.js";
 import { createPdfiumEngine } from "./lib/pdfium/web/worker-engine.js";
-import { I, b as b2, a as a2, c as c2 } from "./browser-qfUHZxQ6.js";
-import { P as P2 } from "./pdf-engine-CVXuu1xQ.js";
 const LOG_SOURCE = "WebWorkerEngineRunner";
 const LOG_CATEGORY = "Engine";
 class EngineRunner {
@@ -329,15 +329,15 @@ export {
   WorkerTask,
   b2 as browserImageDataToBlobConverter,
   cdnFontConfig,
-  d as computeFormDrawParams,
+  c as computeFormDrawParams,
   createCdnFontConfig,
-  a2 as createHybridImageConverter,
-  e as createNodeFontLoader,
-  c as createPdfiumDirectEngine,
+  c2 as createHybridImageConverter,
+  b as createNodeFontLoader,
+  d as createPdfiumDirectEngine,
   createPdfiumEngine as createPdfiumWorkerEngine,
-  c2 as createWorkerPoolImageConverter,
+  a2 as createWorkerPoolImageConverter,
   i as isValidCustomKey,
-  b as readArrayBuffer,
-  r as readString
+  r as readArrayBuffer,
+  e as readString
 };
 //# sourceMappingURL=index.js.map

package/dist/lib/converters/index.js

@@ -1,4 +1,4 @@
-import { I, b, a, c } from "../../browser-qfUHZxQ6.js";
+import { I, b, c, a } from "../../browser-BISJ9naB.js";
 function toArrayBuffer(view) {
   const { buffer, byteOffset, byteLength } = view;
   if (buffer instanceof ArrayBuffer) {
@@ -83,9 +83,9 @@ export {
   b as browserImageDataToBlobConverter,
   createCustomImageDataToBlobConverter,
   createCustomImageDataToBufferConverter,
-  a as createHybridImageConverter,
+  c as createHybridImageConverter,
   createNodeCanvasImageDataToBlobConverter,
   createNodeImageDataToBufferConverter,
-  c as createWorkerPoolImageConverter
+  a as createWorkerPoolImageConverter
 };
 //# sourceMappingURL=index.js.map

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

@@ -418,7 +418,7 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      *
      * @private
      */
-    addShapeContent(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfCircleAnnoObject | PdfSquareAnnoObject): boolean;
+    addShapeContent(doc: PdfDocumentObject, page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfCircleAnnoObject | PdfSquareAnnoObject): boolean;
     /**
      * Add highlight content to annotation
      * @param page - page info
@@ -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
@@ -661,6 +666,12 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      * @private
      */
     private readPageAnnotation;
+    /**
+     * On load, if a vertex-type annotation has rotation metadata in EPDFCustom,
+     * reverse-rotate the PDF's physically rotated vertices by -rotation to recover
+     * the unrotated vertices for runtime editing.
+     */
+    private reverseRotateAnnotationOnLoad;
     /**
      * Return the colour stored directly in the annotation dictionary's `/C` entry.
      *
@@ -715,6 +726,61 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      * @private
      */
     private setAnnotationOpacity;
+    /**
+     * Get the rotation angle (in degrees) from the annotation's /Rotate entry.
+     * Returns 0 if no rotation is set or on error.
+     *
+     * @param annotationPtr - pointer to the annotation
+     * @returns rotation in degrees (0 if not set)
+     */
+    private getAnnotationRotation;
+    /**
+     * Set the rotation angle (in degrees) on the annotation's /Rotate entry.
+     * A value of 0 removes the /Rotate key.
+     *
+     * @param annotationPtr - pointer to the annotation
+     * @param rotation - rotation in degrees (clockwise)
+     * @returns true on success
+     */
+    private setAnnotationRotation;
+    /**
+     * Get the EmbedPDF extended rotation (in degrees) from the annotation's
+     * /EPDFRotate entry. Returns 0 if not set or on error.
+     *
+     * @param annotationPtr - pointer to the annotation
+     * @returns rotation in degrees (0 if not set)
+     */
+    private getAnnotExtendedRotation;
+    /**
+     * Set the EmbedPDF extended rotation (in degrees) on the annotation's
+     * /EPDFRotate entry. A value of 0 removes the key.
+     *
+     * @param annotationPtr - pointer to the annotation
+     * @param rotation - rotation in degrees
+     * @returns true on success
+     */
+    private setAnnotExtendedRotation;
+    /**
+     * Read the EmbedPDF unrotated rect from the annotation's /EPDFUnrotatedRect
+     * entry. Returns the raw page-space rect (same format as `readPageAnnoRect`)
+     * or null if not set.
+     *
+     * @param annotationPtr - pointer to the annotation
+     * @returns raw `{ left, top, right, bottom }` in page coords, or null
+     */
+    private readAnnotUnrotatedRect;
+    /**
+     * Write the EmbedPDF unrotated rect (/EPDFUnrotatedRect) for an annotation.
+     * Accepts a device-space `Rect` and converts to page coordinates internally,
+     * following the same pattern as `setPageAnnoRect`.
+     *
+     * @param doc  - pdf document object
+     * @param page - pdf page object
+     * @param annotPtr - pointer to the annotation
+     * @param rect - device-space rect to store as the unrotated rect
+     * @returns true on success
+     */
+    private setAnnotUnrotatedRect;
     /**
      * Fetch the `/Q` text-alignment value from a **FreeText** annotation.
      *
@@ -951,6 +1017,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 +1026,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 +1043,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 +1054,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 +1104,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 +1113,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
@@ -1337,6 +1409,18 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      * @returns `true` on success
      */
     private setInReplyToId;
+    /**
+     * Rotate a point around a center by the given angle in degrees.
+     * Used to rotate vertices for PDF storage.
+     */
+    private rotatePointForSave;
+    /**
+     * Prepare an annotation for saving to PDF.
+     * For vertex types (ink, line, polygon, polyline) with rotation,
+     * physically rotates the vertices by +rotation so that other PDF viewers
+     * see the correct visual result. Our viewer reverse-rotates on load.
+     */
+    private prepareAnnotationForSave;
     /**
      * Apply all base annotation properties from PdfAnnotationObjectBase.
      * The setInReplyToId and setReplyType functions handle clearing when undefined.
@@ -1351,6 +1435,8 @@ export declare class PdfiumNative implements IPdfiumExecutor {
      * Read all base annotation properties from PdfAnnotationObjectBase.
      * Returns an object that can be spread into the annotation return value.
      *
+     * @param doc - pdf document object
+     * @param page - pdf page object
      * @param annotationPtr - pointer to annotation object
      * @returns object with base annotation properties
      */
@@ -1453,6 +1539,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 +1550,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 +1636,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 +1646,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 +1656,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 +1695,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 +1714,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-DnHo6z8a.cjs"),t=require("../../browser-13mzox-R.cjs"),r=require("../../pdf-engine-B4lt8-5f.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.1/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-DITdlET4.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.6.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-5RWKENek.js";
-import { I, b as b2, a as a2, c as c2 } from "../../browser-qfUHZxQ6.js";
-import { P as P2 } from "../../pdf-engine-CVXuu1xQ.js";
+import { B, F, P, a, R, c, b, d, i, r, e } from "../../direct-engine-CvfzIn2D.js";
+import { I, b as b2, c as c2, a as a2 } from "../../browser-BISJ9naB.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.1/dist/pdfium.wasm";
+const DEFAULT_PDFIUM_WASM_URL = "https://cdn.jsdelivr.net/npm/@embedpdf/pdfium@2.6.0/dist/pdfium.wasm";
 export {
   B as BitmapFormat,
   DEFAULT_PDFIUM_WASM_URL,
@@ -63,15 +63,15 @@ export {
   R as RenderFlag,
   b2 as browserImageDataToBlobConverter,
   cdnFontConfig,
-  d as computeFormDrawParams,
+  c as computeFormDrawParams,
   createCdnFontConfig,
-  a2 as createHybridImageConverter,
-  e as createNodeFontLoader,
-  c as createPdfiumDirectEngine,
+  c2 as createHybridImageConverter,
+  b as createNodeFontLoader,
+  d as createPdfiumDirectEngine,
   createPdfiumEngine as createPdfiumWorkerEngine,
-  c2 as createWorkerPoolImageConverter,
+  a2 as createWorkerPoolImageConverter,
   i as isValidCustomKey,
-  b as readArrayBuffer,
-  r as readString
+  r as readArrayBuffer,
+  e as readString
 };
 //# sourceMappingURL=index.js.map

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-DnHo6z8a.cjs");require("../../../pdf-engine-B4lt8-5f.cjs"),require("../../../browser-13mzox-R.cjs"),exports.createPdfiumEngine=e.createPdfiumEngine;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),require("@embedpdf/pdfium");const e=require("../../../direct-engine-DITdlET4.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,8 +1,8 @@
 import "@embedpdf/pdfium";
-import { c } from "../../../direct-engine-5RWKENek.js";
-import "../../../pdf-engine-CVXuu1xQ.js";
-import "../../../browser-qfUHZxQ6.js";
+import { d } from "../../../direct-engine-CvfzIn2D.js";
+import "../../../pdf-engine-aJNoNMbt.js";
+import "../../../browser-BISJ9naB.js";
 export {
-  c as createPdfiumEngine
+  d as createPdfiumEngine
 };
 //# sourceMappingURL=direct-engine.js.map